diff options
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc')
91 files changed, 11142 insertions, 9487 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/Makefile.guide b/macros/latex/contrib/koma-script/source-doc/Makefile.guide index 453e0286d2..0956492f51 100644 --- a/macros/latex/contrib/koma-script/source-doc/Makefile.guide +++ b/macros/latex/contrib/koma-script/source-doc/Makefile.guide @@ -1,6 +1,6 @@ # ====================================================================== # Makefile.guide -# Copyright (c) Markus Kohm, 2002-2018 +# Copyright (c) Markus Kohm, 2002-2019 # # 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-2018 +# Copyright (c) Markus Kohm, 2002-2019 # # Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, # Version 1.3c, verteilt und/oder veraendert werden. @@ -290,7 +290,9 @@ $(PLENGTH_DTX_RESULT): $(PLENGTH_DTX) $(PLENGTH_PDF): $(PLENGTH_DTX_RESULT) $(MPOST) $(addsuffix .mp,$(basename $@)) $(MPTOPDF) $(addsuffix .mp,$(basename $@)) - $(MV) $(addsuffix .pdf,$(basename $@)-1) $@ + @if [ -r $(addsuffix .pdf,$(basename $@)-1)];\ + then $(MV) $(addsuffix .pdf,$(basename $@)-1) $@;\ + fi $(PDF_EPS): $(PDF_EPS_SRC) $(EPSTOPDF) $(addsuffix .eps,$(basename $@)) diff --git a/macros/latex/contrib/koma-script/source-doc/bin/genhtmlidx.pl b/macros/latex/contrib/koma-script/source-doc/bin/genhtmlidx.pl index da8837f895..a101681f5b 100755 --- a/macros/latex/contrib/koma-script/source-doc/bin/genhtmlidx.pl +++ b/macros/latex/contrib/koma-script/source-doc/bin/genhtmlidx.pl @@ -4,7 +4,7 @@ eval 'exec perl -S $0 ${1+"$@"}' # ====================================================================== # genhtmlidx.pl -# Copyright (c) Markus Kohm, 2002-2016 +# Copyright (c) Markus Kohm, 2002-2019 # # 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-2016 +# Copyright (c) Markus Kohm, 2002-2019 # # Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, # Version 1.3c, verteilt und/oder veraendert werden. @@ -63,6 +63,7 @@ my @floatstyle; my @fontelement; my @file; my @length; +my @dohook; my $baselink; my $htmlhead; @@ -122,6 +123,8 @@ while ( $auxfile=shift ) { push @file,$entry; } elsif ( "$2" eq "length" ) { push @length,$entry; + } elsif ( "$2" eq "dohook" ) { + push @dohook,$entry; } else { print STDERR "Unknown type $2!\n"; } @@ -143,8 +146,8 @@ sub process { my $lastlink=""; my $pageprefix=""; if ( @entries > 0 ) { - print "<h2><a name=\"$group\">$titles{$group}</a></h2>\n"; - print "<ul>\n"; + print " <h2><a name=\"$group\">$titles{$group}</a></h2>\n"; + print " <ul>\n"; map { $_ =~ /^([^.]+)\.([^.]+)\.([^.]+)\.([^.]+)$/; if ( $entry ne $1 ) { @@ -153,7 +156,7 @@ sub process { $lastpage=""; $lastlink=""; $pageprefix=""; - print "<li><a name=\"$4.$entry\"></a><a href=\"\#$4.$entry\">$prefix$entry</a> --> "; + print " <li><a name=\"$4.$entry\"></a><a href=\"\#$4.$entry\">$prefix$entry</a> → "; } if ( ( $lastlink ne "$3.$4.$1" ) || ( $lastpage ne "$2" ) ) { print "$pageprefix<a href=\"$baselink\#desc:$3.$4.$1\">$2</a>"; @@ -163,25 +166,26 @@ sub process { } } @entries; print "</li>\n" if ( $entry ne "" ); - print "</ul>\n"; + print " </ul>\n"; } } print $htmlhead; -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 ); -print "<li><a href=\"#counter\">$titles{counter}</a></li>" if ( @counter ); -print "<li><a href=\"#floatstyle\">$titles{floatstyle}</a></li>" if ( @floatstyle ); -#print "<li><a href=\"#fontelement\">$titles{fontelement}</a></li>" if ( @fontelement ); -#print "<li><a href=\"#file\">$titles{file}</a></li>" if ( @fontelement ); -print "</ul>\n"; +print " <ul>\n"; +print " <li><a href=\"#option\">$titles{option}</a></li>\n" if ( @option ); +print " <li><a href=\"#macro\">$titles{macro}</a></li>\n" if ( @macro ); +print " <li><a href=\"#environment\">$titles{environment}</a></li>\n" if ( @environment ); +print " <li><a href=\"#length\">$titles{length}</a></li>\n" if ( @length ); +print " <li><a href=\"#plength\">$titles{plength}</a></li>\n" if ( @plength ); +print " <li><a href=\"#variable\">$titles{variable}</a></li>\n" if ( @variable ); +print " <li><a href=\"#pagestyle\">$titles{pagestyle}</a></li>\n" if ( @pagestyle ); +print " <li><a href=\"#counter\">$titles{counter}</a></li>\n" if ( @counter ); +print " <li><a href=\"#floatstyle\">$titles{floatstyle}</a></li>\n" if ( @floatstyle ); +#print " <li><a href=\"#fontelement\">$titles{fontelement}</a></li>\n" if ( @fontelement ); +#print " <li><a href=\"#file\">$titles{file}</a></li>\n" if ( @file ); +#print " <li><a href=\"#dohook\">$titles{dohook}</a></li>\n" if ( @dohook ); +print " </ul>\n"; process "option","",\@option; process "macro","\\",\@macro; @@ -193,5 +197,9 @@ process "pagestyle","",\@pagestyle; process "counter","",\@counter; process "floatstyle","",\@floatstyle; #process "fontelement","",\@fontelement; +print STDERR "Ignoring index: $titles{fontelement}\n" if ( @fontelement ); #process "file","",\@file; +print STDERR "Ignoring index: $titles{files}\n" if ( @file ); +#process "dohook","",\@dohook; +print STDERR "Ignoring index: $titles{dohook}\n" if ( @dohook ); print $htmlend; diff --git a/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex b/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex index 75b9b8f392..deb207aa32 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex @@ -1,6 +1,6 @@ % ====================================================================== % adrconvnote.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % adrconvnote.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,13 +46,13 @@ % ====================================================================== \KOMAProvidesFile{adrconvnote.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: adrconv)] \translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-01-29 +% Date of the translated German file: 2019-10-10 \chapter{Creating Address Files from an Address Database}% \labelbase{addrconv}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex b/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex index bed043d8d3..e1f7d4471c 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-compatibility.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-compatibility.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{common-compatibility.tex} - [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-30 +% Date of the translated German file: 2019-10-10 \section{Compatibility with Earlier Versions of \KOMAScript} \seclabel{compatibilityOptions} diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex b/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex index 5dff550ac7..682ca39163 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-dictum.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-dictum.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-dictum.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-29 +% Date of the translated German file: 2019-10-10 \section{Dicta} \seclabel{dictum}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex b/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex index 383c9236c5..e693714e39 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-draftmode.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-draftmode.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-draftmode.tex} - [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-30 +% Date of the translated German file: 2019-10-10 \section{Draft Mode} \seclabel{draft}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex b/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex index 843f9482f2..ed37da5934 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-fontsize.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-fontsize.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{common-fontsize.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: fontsize)] \translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2017-12-13 +% Date of the translated German file: 2019-10-09 \section{Choosing the Document Font Size} \seclabel{fontOptions}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex b/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex index c08b203b29..3eb44965c1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-footnotes.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-footnotes.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{common-footnotes.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: Footnotes)] \translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-29 +% Date of the translated German file: 2019-10-10 \section{Footnotes} \seclabel{footnotes}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex b/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex index 8f9fcbb946..2e39697578 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-headfootheight.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % 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-headfootheight.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ============================================================================ \KOMAProvidesFile{common-headfootheight.tex} - [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraph: Head and Foot Height)] \translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} -% Date of the translated German file: 2018-01-16 +% Date of the translated German file: 2019-10-10 \section{Header and Footer Height} \seclabel{height} diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex b/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex index 36f9fb4ae4..0f1fe6a0d6 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-interleafpage.tex -% Copyright (c) Markus Kohm, 2001-2017 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-interleafpage.tex -% Copyright (c) Markus Kohm, 2001-2017 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-interleafpage.tex}% - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: Interleaf Pages)] \translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2017-12-07 +% Date of the translated German file: 2019-10-09 \section{Interleaf Pages} \seclabel{emptypage}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex b/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex index 79a0a697fd..9b18e0551e 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-lists.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-lists.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-lists.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-02-06 +% Date of the translated German file: 2019-10-10 \section{Lists} \seclabel{lists}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex index 05e2bdd1f3..22669838cb 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{common-marginpar.tex} - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-01-29 +% Date of the translated German file: 2019-10-10 \section{Marginal Notes} \seclabel{marginNotes}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex b/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex index 04ff2b91ac..8617a74e52 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-oddorevenpage.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-oddorevenpage.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-oddorevenpage.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraph: Detection of Odd and Even Pages)] \translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-30 +% Date of the translated German file: 2019-10-10 \section{Detecting Odd and Even Pages} \seclabel{oddOrEven}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-options.tex b/macros/latex/contrib/koma-script/source-doc/english/common-options.tex index fff22502bb..b8c4d5fb70 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-options.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-options.tex @@ -50,7 +50,7 @@ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-10-23 +% Date of the translated German file: 2019-10-09 \section{Early or Late Selection of Options} \seclabel{options} @@ -140,18 +140,14 @@ described in \cite{latex:usrguide} or any introduction to \LaTeX, for example \par }{} -% Umbruchoptimierung!!! -\IfThisCommonLabelBase{typearea}{Setting the options with - \Macro{documentclass} has one\textnote{Attention!} major disadvantage: % -}{% - Note that \Macro{documentclass} has one drawback when using the option - interface described bellow\textnote{Attention!}: % -}% -unlike the interface described below, the options in \Macro{documentclass} are -not robust. So commands, lengths, counters, and such constructs may break -inside the optional argument of this command. For example, with many -non-\KOMAScript{} classes, using a \LaTeX{} length in the value of an option -results in an error% +% The alternative text for wrapping optimization was redundant and, as +% it's not required for the English version, has been deleted. +Setting the options with \Macro{documentclass} has one\textnote{Attention!} +major disadvantage: unlike the interface described below, the options in +\Macro{documentclass} are not robust. So commands, lengths, counters, and +similar constructs may break inside the optional argument of this command. +For example, with many non-\KOMAScript{} classes, using a \LaTeX{} length +in the value of an option results in an error% \IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2}{ before the value is passed to a \KOMAScript{} package and it can take control of the option execution}{}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex b/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex index 3a3933167d..3814320ed6 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-pagestylemanipulation.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % 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-pagestylemanipulation.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -51,7 +51,7 @@ Setting up defined page styles)] \translator{Markus Kohm\and Jana Schubert\and Karl Hagen} -% Date version of the translated file: 2018-02-05 +% Date version of the translated file: 2019-10-09 \section{Manipulating Page Styles} \seclabel{pagestyle.content} @@ -1031,7 +1031,6 @@ %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 %%% ispell-local-dictionary: "en_GB" %%% TeX-master: "../guide.tex" %%% TeX-PDF-mode: t diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex b/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex index 647d09dde3..4f6ca3c703 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-parmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-parmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-parmarkup.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraph: Paragraph Markup)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-31 +% Date of the translated German file: 2019-10-10 \section{Marking Paragraphs} \seclabel{parmarkup}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex b/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex index 49cbe456ed..61e26626b1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{common-textmarkup.tex} - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-07-20 +% Date of the translated German file: 2019-10-09 \section{Text Markup} \seclabel{textmarkup}% @@ -782,13 +782,13 @@ size and the baseline skip.% \IfThisCommonLabelBase{scrjura}{% \par% However, the misuse of the font settings is strongly discouraged (see - \autoref{sec:maincls-experts.experts}, + \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist})!% }{% \par% However, you should not take these commands as legitimizing the insertion of arbitrary commands in an element's font setting. To do so can lead - quickly to errors (see \autoref{sec:maincls-experts.experts}, + quickly to errors (see \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).% }% }% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex b/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex index e061743806..3baf017cb6 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-titles.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-titles.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,13 +46,13 @@ % ====================================================================== \KOMAProvidesFile{common-titles.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-30 +% Date of the translated German file: 2019-10-10 \section{Document Titles} \seclabel{titlepage}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex b/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex index 30b89d0331..587513ee0d 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-typearea.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-typearea.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{common-typearea.tex} - [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: typearea)] \translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-02-01 +% Date of the translated German file: 2019-10-10 \section{Page Layout} \seclabel{typearea} diff --git a/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex b/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex index edebaee2b9..6e16884217 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex @@ -1,6 +1,6 @@ % ====================================================================== % guide-english.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,7 +46,7 @@ % ====================================================================== % \KOMAProvidesFile{guide-english.tex} - [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $ + [$Date: 2019-02-20 12:41:53 +0100 (Wed, 20 Feb 2019) $ KOMA-Script guide language dependencies] % % \section{Extra Packages} @@ -303,7 +303,7 @@ % \begin{macro}{\GuideVariable} % \begin{macro}{\GuideVariableIndexCategory} % \begin{macro}{\GuideVariableIndexCategoryExpanded} -% The termo ``variable''. +% The term ``variable''. % \begin{macrocode} \newcommand*{\GuideVariable}{variable} \newcommand*{\GuideVariableIndexCategory}{variables} @@ -313,6 +313,19 @@ % \end{macro} % \end{macro} % +% \begin{macro}{\GuideHook} +% \begin{macro}{\GuideHookIndexCategory} +% \begin{macro}{\GuideHookIndexCategoryEpanded} +% The term ``hook''. +% \begin{macrocode} +\newcommand*{\GuideHook}{hook} +\newcommand*{\GuideHookIndexCategory}{hooks} +\let\GuideHookIndexCategoryExpanded\GuideHookIndexCategory +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% % \begin{macro}{\GuideAnd} % The ``and'' at a list of two. % \begin{macrocode} @@ -351,6 +364,8 @@ % \begin{macro}{\GuidefilIndexShort} % \begin{macro}{\GuideoptIndex} % \begin{macro}{\GuideoptIndexShort} +% \begin{macro}{\GuidehokIndex} +% \begin{macro}{\GuidehokIndexShort} % The titles and short titles of each single index. \newcommand*{\GuidegenIndex}{General Index}% \newcommand*{\GuidecmdIndex}{Index of Commands, Environments, and Variables}% @@ -364,6 +379,10 @@ \newcommand*{\GuidefilIndexShort}{Index of Files, etc.}% \newcommand*{\GuideoptIndex}{Index of Class and Package Options}% \newcommand*{\GuideoptIndexShort}{Index of Options}% +\newcommand*{\GuidehokIndex}{Index of Do-Hooks} +\let\GuidehokIndexShort\GuidehokIndex +% \end{macro} +% \end{macro} % \end{macro} % \end{macro} % \end{macro} diff --git a/macros/latex/contrib/koma-script/source-doc/english/htmlsetup b/macros/latex/contrib/koma-script/source-doc/english/htmlsetup index 8c30c6ed56..7364ac8bce 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/htmlsetup +++ b/macros/latex/contrib/koma-script/source-doc/english/htmlsetup @@ -1,6 +1,6 @@ # ====================================================================== # htmlsetup -# Copyright (c) Markus Kohm, 2002-2013 +# Copyright (c) Markus Kohm, 2002-2019 # # 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-2013 +# Copyright (c) Markus Kohm, 2002-2019 # # Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, # Version 1.3c, verteilt und/oder veraendert werden. @@ -39,18 +39,17 @@ $baselink="scrguien.pdf"; $htmlhead="<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.0//EN\"> <html> <head><title>Index</title> -<meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\"> + <meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\"> </head> <body> -<h1>Index of the KOMA-Script Guide</h1> -<p>This is an index of the elements defined at KOMA-Script. This index is related to the <a href=\"scrguien.pdf\">KOMA-Script guide</a>. To improve the survey this index has serveral functional sections:</p> + <h1>Index of the KOMA-Script Guide</h1> + <p>This is an index of the elements defined at KOMA-Script. This index is related to the <a href=\"scrguien.pdf\">KOMA-Script guide</a>. To improve the survey this index has serveral functional sections:</p> "; -$htmlend="<p> -<a href=\"http://validator.w3.org/check?uri=referer\"><img +$htmlend=" <p><a href=\"http://validator.w3.org/check?uri=referer\"><img src=\"http://www.w3.org/Icons/valid-html40\" -alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a> -</p> -</body></html>"; +alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a></p> +</body> +</html>"; %titles=( "option" => "Options", "macro" => "Commands", "environment" => "Environments", @@ -60,6 +59,7 @@ alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a> "pagestyle" => "Page Styles", "counter" => "Counter", "floatstyle" => "Styles for the float Package", - "fontelement" => "Elements (Font May Be Changed)" ); + "fontelement" => "Elements (Font May Be Changed)", + "dohook" => "Do-Hooks for Low-Level Manipulation" ); # end of file diff --git a/macros/latex/contrib/koma-script/source-doc/english/introduction.tex b/macros/latex/contrib/koma-script/source-doc/english/introduction.tex index 9331720287..610cef80df 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/introduction.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/introduction.tex @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{introduction.tex} - [$Date: 2019-01-15 08:39:58 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide introduction] \translator{Kevin Pfeiffer\and Gernot Hassenpflug\and Krickette Murabayashi\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-10 \chapter{Introduction} \labelbase{introduction} diff --git a/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex b/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex index 6503afae06..0a7bdcb757 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex @@ -1,6 +1,6 @@ % ====================================================================== % japanlco.tex -% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2018 +% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,7 +40,7 @@ % % ---------------------------------------------------------------------- % -% Kapitel ueber japanische Papierformate, Umschläge und Briefe +% Kapitel ueber japanische Papierformate, Umschlaege und Briefe % Verwaltet von Gernot Hassenplug (mit Unterstuetzung von Markus Kohm) % % ====================================================================== @@ -50,7 +50,7 @@ % \KOMAProvidesFile{japanlco.tex} - [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (appendix: japanlco)] \appendix @@ -596,6 +596,5 @@ fit the required envelope. %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 %%% TeX-master: t %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/english/preface.tex b/macros/latex/contrib/koma-script/source-doc/english/preface.tex index 873f303987..3c83ac1ff1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/preface.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/preface.tex @@ -1,6 +1,6 @@ % ====================================================================== % preface.tex -% Copyright (c) Markus Kohm, 2008-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -36,11 +36,11 @@ % ====================================================================== \KOMAProvidesFile{preface.tex} - [$Date: 2018-03-28 11:44:09 +0200 (Wed, 28 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ Preface to version 3.25] \translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-03-12 +% Date of the translated German file: 2019-10-10 \addchap{Preface to \KOMAScript~3.25} diff --git a/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex b/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex index ac5ef90a5e..50543b2b4b 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex @@ -1,6 +1,6 @@ % ====================================================================== % scraddr.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{scraddr.tex} - [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scraddr)] \translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-10 \chapter{Accessing Address Files with \Package{scraddr}}% \labelbase{scraddr}% diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex index 80ed5b2b03..2b7fadda1a 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{scrbase.tex} - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script package scrbase] \translator{Markus Kohm\and Melvin Hendrix\and Karl Hagen} -% Date of the translated German file: 2018-08-27 +% Date of the translated German file: 2019-10-09 \chapter{Basic Functions in the \Package{scrbase} Package} \labelbase{scrbase} @@ -85,7 +85,7 @@ The options provided by \Package{scrbase} also use \Package{keyval} syntax: \PName{key}\texttt{=}\PName{value}. -\section{Keys as Attributes of Families and their Members} +\section{Keys as Attributes of Families and Their Members} \seclabel{keyvalue} As already mentioned in \autoref{sec:scrbase.loadit}, \Package{scrbase} uses @@ -238,8 +238,8 @@ predefined states should be sufficient. If the key is used later, one of the permitted values, or no value, must be used. In the second case, the default \PName{true} value will be used. - The definitions for the other packages are similar. Only ``\texttt{salami}'' - has to be replaced by the respective names. + The definitions for the other packages are nearly identical. Only the string + ``\texttt{salami}'' has to be replaced. \end{Example} % \EndIndexGroup @@ -373,9 +373,10 @@ If\ChangedAt{v3.20}{\Package{scrbase}} you call \Macro{FamilyExecuteOptions} with an unknown option inside the \PName{options list}, you will get an error. An exception to this rule occurs when the \PName{member} has an option called \Option{@else@}. In this case, the \Option{@else@} option will be used instead -of the unknown option. \KOMAScript{} itself uses this feature, for example -inside the definition of sectioning commands, to evaluate the style option -before all other attributes. +of the unknown one. The value passed to the \Option{@else@} option is the +unknown option with the value specified in the call. \KOMAScript{} itself uses +this feature, for example inside the definition of sectioning commands, +to evaluate the style option before all other attributes. You can also use this command inside the code executed when processing the option.% @@ -451,9 +452,17 @@ members returns an error through \DescRef{\LabelBase.cmd.FamilyKeyState}. ensures that its own \Option{coldcuts} option has already been redefined. This avoids endless recursion. \end{Example} -% + +Like\ChangedAt{v3.27}{\Package{scrbase}} +\DescRef{\LabelBase.cmd.FamilyExecuteOptions}, \Macro{FamilyOptions} offers +special handling for an option named +\Option{@else@}\important{\Option{@else@}}. If a family member has such an +option, it will be executed whenever an option in the \PName{option list} is +unrecognized by the member. If the family itself defines an option +\Option{@else@}, it will only be called if neither the family nor any of its +members were able to fully process the given option by executing +\DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}.% \EndIndexGroup -\vskip-\ht\strutbox% Umbruchkorrektur wegen Beispiel am Ende \begin{Declaration} @@ -499,7 +508,9 @@ described for \DescRef{\LabelBase.cmd.FamilyOptions}. {ingredient}{onions,gherkins} \end{lstcode} \end{Example} -% + +An\ChangedAt{v3.27}{\Package{scrbase}} \Option{@else@} option is processed +in the same manner as with \DescRef{\LabelBase.cmd.FamilyOptions}.% \EndIndexGroup @@ -615,8 +626,24 @@ message about an unknown value assignment is printed if necessary (see also \Macro{ifx} at this point. Fully expanding tests like \Macro{ifstr} should be avoided here. Depending on the current status and the comparison status, they can lead to different error messages as well as incorrect results. -\end{Example} -% +\end{Example}% +\EndIndexGroup + +\begin{Declaration} + \Macro{FamilyInverseBoolKey}\OParameter{member}\Parameter{family} + \Parameter{key}\Parameter{switch name} + \Macro{FamilySetInverseBool}\Parameter{family} + \Parameter{key}\Parameter{switch name} + \Parameter{value} +\end{Declaration} +These\ChangedAt{v3.27}{\Package{scrbase}} two commands differ from +\DescRef{\LabelBase.cmd.FamilyBoolKey} and +\DescRef{\LabelBase.cmd.FamilySetBool}, respectively, only in that the +logic is inverted. This means that the values \PValue{true}, \PValue{yes}, and +\PValue{on} set the boolean switch given by \PName{switch name} to +\Macro{iffalse} and therefore deactivate it. The values \PValue{false}, +\PValue{no}, and \PValue{off} set the boolean switch to \Macro{iftrue} and +therefore activate it.% \EndIndexGroup @@ -763,13 +790,13 @@ is called applies.% \OParameter{default}\Parameter{macro} \Macro{FamilySetLengthMacro}\Parameter{family} \Parameter{key}\Parameter{macro} - \Parameter{value}% + \Parameter{value} \Macro{FamilyUseLengthMacroKey}\OParameter{member}\Parameter{family} \Parameter{key} \OParameter{default}\Parameter{macro} \Macro{FamilySetUseLengthMacro}\Parameter{family} \Parameter{key}\Parameter{macro} - \Parameter{value}% + \Parameter{value} \end{Declaration} With\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey}, you can define a \PName{key} that represents a \PName{length}. It does not matter @@ -1313,6 +1340,67 @@ corresponding internal command.% \EndIndexGroup +\begin{Declaration} + \Macro{IfActiveMkBoth}\Parameter{then code}\Parameter{else code} +\end{Declaration} +The\ChangedAt{v3.27}{\Package{scrbase}} \LaTeX{} kernel uses +\DescRef{scrlayer.cmd.@mkboth}\important{\Macro{@mkboth}}\IndexCmd{@mkboth} to +distinguish between automatic and manual running heads. Usually, it sets both +marks with automatic running heads. With manual running heads, it does not set +any mark. To determine whether automatic running heads are active, many +packages compare \DescRef{scrlayer.cmd.@mkboth} with either +\DescRef{maincls.cmd.markboth}\IndexCmd{markboth} or \Macro{@gobbletwo}. But +this does not account for all cases in which \DescRef{scrlayer.cmd.@mkboth} +may be redefined. Therefore \Macro{IfActiveMkBoth} tests if +\DescRef{scrlayer.cmd.@mkboth} would actually set a mark, even when +\Macro{marks} appears in the definition of \DescRef{scrlayer.cmd.@mkboth}. If +such an active \DescRef{scrlayer.cmd.@mkboth} is detected, the +\PName{then code} is executed. In all other cases, the \PName{else code} is +used.% +\begin{Example} + For example, suppose you want to set the right mark if and only if + automatic running heads are used, e.\,g., the pagestyle + \PageStyle{headings}\IndexPagestyle{headings}. For a first attempt, + you might use: +\begin{lstcode} + \ifx\@mkboth\markboth \markright{running head}\fi +\end{lstcode} + Later you discover that some package does not use the usual +\begin{lstcode} + \let\@mkboth\markboth +\end{lstcode} + but +\begin{lstcode} + \renewcommand{\@mkboth}{\markboth} +\end{lstcode} + to activate automatic running heads. Because of this, your comparison always + fails and never calls \DescRef{maincls.cmd.markright}. To solve this, you + try the following change: +\begin{lstcode} + \ifx\@mkboth\@gobbletwo\else \markright{running head}\fi +\end{lstcode} + Unfortunately, now \DescRef{maincls.cmd.markright} is also called for + manual running heads, because someone has defined +\begin{lstcode} + \renewcommand{\@mkboth}[2]{% + \typeout{DEBUG: ignoring running head setting}% + } +\end{lstcode} + for this case. + + Fortunately, both problems are easy to solve with \Package{scrbase}: +\begin{lstcode} + \IfActiveMKBoth{\markright{Kolumnentitel}}{} +\end{lstcode}% +\end{Example} +By the way, an even simpler solution for the problem in the example +would be to use \DescRef{scrlayer.cmd.@mkright} from package +\hyperref[cha:scrlayer]{\Package{scrlayer}} (see +\autoref{sec:scrlayer.pagestyle.content}, +\DescPageRef{scrlayer.cmd.@mkright}).% +\EndIndexGroup + + \section{Defining Language-Dependent Terms} \seclabel{languageSupport} \BeginIndexGroup @@ -1628,10 +1716,9 @@ correctly. Sometimes additional operators would be useful. \Macro{XdivY}\Parameter{dividend}\Parameter{divisor}% \Macro{XmodY}\Parameter{dividend}\Parameter{divisor}% \end{Declaration}% -The command\ChangedAt{v3.05a}{\Package{scrbase}} -\Macro{XdivY} returns the value of the integer quotient, with command -\Macro{XmodY} giving the value of the remainder. This type of of division is -defined by the equation +The\ChangedAt{v3.05a}{\Package{scrbase}} \Macro{XdivY} command returns the +value of the integer quotient, with the \Macro{XmodY} command giving the value +of the remainder. This type of of division is defined by the equation \[ \textit{dividend} = \textit{divisor} \cdot \textit{integer quotient} + \textit{remainder} @@ -1645,9 +1732,236 @@ using \Macro{numexpr}. To output the value as an Arabic number, you must prefix it with \Macro{the}.% % \EndIndexGroup + + +\section[{General Mechanism for Multi-Level Hooks}] +{General Mechanism for Multi-Level + Hooks\ChangedAt[2019/01]{v3.27}{\Package{scrbase}}} +\seclabel{hooks} + +\BeginIndexGroup +\BeginIndex{}{Hooks} +The \LaTeX{} kernel provides a few \emph{hooks} in the processing of +a document where additional code can be inserted. Class and package authors +should be very familiar with \Macro{AtBeginDocument} and +\Macro{AtEndDocument}. \KOMAScript{} offers similar features in some places, +for example to hook code into the execution of +\hyperref[sec:maincls.structure]{sectioning commands}. Over the years, there +have been two problems: +\begin{itemize} + \item There are never enough hooks. + \item There is some code that should only be executed once, as if it almost + drops off the hook, as well as code that must be executed each time the + hook is encountered, thus remaining permanently on the hook. +\end{itemize} +Usually, to define a single hook you must define a command that collects the +code for each hook. This code is then stored in another internal macro, which +must be inserted at the point where the collected code is executed. The more +hooks you insert, the more such commands there are. To allow for both +single-use code and permanent code may even require two hooks, and therefore +twice the number of commands to be defined. + +The example of sectioning commands shows that the first problem can sometimes +be exacerbated by having only a single point for code execution. One package +author may need only one way to execute the same code for all sectioning +commands. Another package author would prefer to execute different code for +certain sectioning commands only. Meeting both these demands would require a +general hook as well as a hook for each sectioning command. These requirements +are doubled again because of the second problem. + +\KOMAScript{} therefore offers a generalized hook mechanism in +\Package{scrbase} that provides multi-level hooks for both single-use and +persistent code. These hooks are named \emph{do-hooks} because of their +implementation. From this also comes the names of the instructions by which +they are controlled. + +\begin{Declaration} + \Macro{ExecuteDoHook}\Parameter{specifier} +\end{Declaration} +Hooks\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} are implemented with this +command. The \PName{specifier} determines the name or names of the hook. The +\PName{specifier} is always completely expanded for analysis. + +The \PName{specifier} generally consists of strings separated by forward +slashes (``/''). Initially, \Macro{ExecuteDoHook} divides the string at the +first slash. The first part is the name. The remainder (without the slash) is +the argument. Then the code for the hook with this name is executed. Next the +first part of the remaining string is divided again from the remainder, +combined with a slash after the name to form a new name, and the code with +this name is executed. This process continues until the code for the hook with +the name \PName{specifier} has been executed and the argument is empty. + +In the simplest case, the \PName{specifier} consists of a single name. In this +case, the persistent code is executed first, with an empty argument, for +exactly one hook specified by this name. + +At each stage of execution, single-use code is also executed after the hook's +persistent code, and then the single-use code is globally removed from the +hook. + +\begin{Example} + By inserting \DescRef{\LabelBase.cmd.ExecuteDoHook}% + \PParameter{heading/begingroup/\PName{name}} into the execution of each + sectioning command defined with + \DescRef{maincls-experts.cmd.DeclareSectionCommand}, the \KOMAScript{} + classes ultimately have six hooks inserted at that code-point, executed in + this order: + \begin{enumerate} + \item \PValue{heading} with the argument \PValue{begingroup/}\PName{name} + for persistent code, + \item \PValue{heading} with the argument \PValue{begingroup/}\PName{name} + for single-use code, + \item \PValue{heading/begingroup} with the argument \PName{name} for + persistent code, + \item \PValue{heading/begingroup} with the argument \PName{name} for + single-use code, + \item \PValue{heading/begingroup/}\PName{name} with an empty argument for + persistent code, + \item \PValue{heading/begingroup/}\PName{name} with an empty argument for + single-use code. + \end{enumerate} + The \PName{name} is the name of section level specified in + \DescRef{maincls-experts.cmd.DeclareSectionCommand}, + \DescRef{maincls-experts.cmd.DeclareNewSectionCommand} or + \DescRef{maincls-experts.cmd.ProvideSectionCommand}, or the sectioning + command specified by it, for example \PValue{chapter} or + \PValue{subparagraph}. Looking at the list above, and considering that there + are various sectioning commands, it becomes clear that the \PValue{heading} + and \PValue{heading/begingroup} hooks will be called multiple times for each + sectioning command.% +\end{Example}% % \EndIndexGroup +\begin{Declaration} + \Macro{AddtoDoHook}\Parameter{name}\Parameter{command} + \Macro{AddtoOneTimeDoHook}\Parameter{name}\Parameter{command} +\end{Declaration} +\Macro{AddtoDoHook}\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} appends +persistent code to the hook named \PName{name}. The code to be added is the +\PName{command}, to which the argument mentioned in the description of +\DescRef{\LabelBase.cmd.ExecuteDoHook} is appended as a parameter. +\begin{Example} + Suppose you want to count how many times the \Macro{section} command is + executed. This would be simple, continuing the previous example: +\begin{lstcode} + \newcounter{sectionCounter} + \AddtoDoHook{heading/begingroup/section} + {\stepcounter{sectionCounter}} +\end{lstcode} + However, in reality, \Macro{stepcounter}\PParameter{sectionCounter}% + \PParameter{} would be executed. Remember that an argument is always appended + as a parameter. In the case of the hook named + \PValue{heading/begingroup/section}, this argument is empty. Since an empty + parameter becomes an empty group here, it is better to consume this empty + parameter: +\begin{lstcode} + \newcommand*{\stepcountergobble}[2]{% + \stepcounter{#1}% + } + \AddtoDoHook{heading/begingroup/section} + {\stepcountergobble{sectionCounter}} +\end{lstcode} + Here, the appended, empty parameter of \Macro{stepcountergobble} is read but + not used. + + If instead of \Macro{section}, you want to count all sectioning commands, you + only need to change the hook name: +\begin{lstcode} + \AddtoDoHook{heading/begingroup} + {\stepcountergobble{sectionCounter}} +\end{lstcode} + By the way, the appended parameter is not empty in this case but contains the + name of the sectioning level or sectioning command. If you wanted to count + the sectioning commands individually, you could just use this: +\begin{lstcode} + \newcommand*{\stepCounter}[1]{% + \stepcounter{#1Counter}% + } + \AddtoDoHook{heading/begingroup} + {\stepCounter} +\end{lstcode} + Of course, you must also define the counters \Counter{partCounter}, + \Counter{chapterCounter} down to \Counter{subparagraphCounter}. +\end{Example} + +The \Macro{AddtoOneTimeDoHook} command works similarly but adds the +\PName{command} to the single-use code. This code will be globally removed +after the first execution.% +\EndIndexGroup + +\begin{Declaration} + \Macro{ForDoHook}\Parameter{specification}\Parameter{command} +\end{Declaration} +While\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} +\DescRef{\LabelBase.cmd.ExecuteDoHook} executes the commands previously stored +with \DescRef{\LabelBase.cmd.AddtoDoHook} or +\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} for the hook given by the +\PName{specifier}, this macro executes the \PName{command} immediately. There +are two parameters added to the \PName{command}. The first is the hook's name; +the second, the hook's argument. + +This command is a byproduct of the implementation of +\DescRef{\LabelBase.cmd.ExecuteDoHook}. Normally, neither end users nor package +authors should need this command.% +\EndIndexGroup + +\begin{Declaration} + \Macro{SplitDoHook}\Parameter{specifier}\Parameter{head macro} + \Parameter{remainder macro} +\end{Declaration} +As\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} can be seen from the preceding +explanations, the parameter of a \PName{command} added with +\DescRef{\LabelBase.cmd.AddtoDoHook} or +\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} can also be a multi-part +\PName{specifier}. You can use \Macro{SplitDoHook} to divide a +\PName{specifier} into the front element and the remainder. The +\PName{head macro} will be set to the front element. The \PName{remainder +macro} will be set to the rest. If there is no remainder left, the +\PName{remainder macro} is set to empty. If the \PName{specifier} was already +empty, a warning is issued and both the \PName{head macro} and the +\PName{remainder macro} are set to empty. + +\begin{Example} + If you want to increase a counter at the start of a group in which a heading + is issued but decrease it at the end, you can do this with two hooks: +\begin{lstcode} + \AddtoDoHook{heading/begingroup} + {\stepCounter} + \newcommand*{\restepCounter}[1]{% + \addtocounter{#1Counter}{-1}% + } + \AddtoDoHook{heading/endgroup} + {\restepCounter} +\end{lstcode} + But you could also use a single hook and split its parameters: +\begin{lstcode} + \newcommand*{\changeCounter}[1]{% + \SplitDoHook{#1}{\Group}{\Level}% + \ifstr{\Group}{begingroup}{% + \stepcounter{\Level Counter}% + }{% + \ifstr{\Group}{endgroup}{% + \addtocounter{\Level Counter}{-1}% + }{}% + }% + } + \AddtoDoHook{heading} + {\changeCounter} +\end{lstcode} + As you can see, the first solution is much simpler. In addition, it would + be easy to overlook including the empty group for the second false-case in + the second example. That would be fatal, however, as there make be other + hooks with named \PValue{heading} but with different arguments. +\end{Example} + +Strictly speaking, this command is a byproduct of the implementation of +\DescRef{\LabelBase.cmd.ForDoHook}.% +\EndIndexGroup +% +\EndIndexGroup +\EndIndexGroup + \endinput %%% Local Variables: diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex index 1629f29923..247aaf6f02 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex @@ -48,13 +48,13 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex} - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-09 16:34:25 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] \translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-10-14 +% Date of the translated German file: 2019-10-09 \chapter[{Additional Information about the Main Classes and \Package{scrextend}}]{Additional Information about the Main Classes @@ -62,7 +62,8 @@ \Class{scrreprt}, and \Class{scrartcl} as well as the Package \Package{scrextend}} \labelbase{maincls-experts} -\BeginIndexGroup + +\BeginIndexGroup% \BeginIndex{Class}{scrartcl}% \BeginIndex{Class}{scrbook}% \BeginIndex{Class}{scrreprt}% @@ -74,12 +75,14 @@ are also available in \Package{scrextend}. \iffree{Some parts of the chapter should not be a problem because the}{The} average user, who only wants to use the classes, will seldom need this information. Some of this information is addressed to users with non-standard requirements or who want to write -their own classes based on a \KOMAScript{} class. Other parts describe -features that exist only for the sake of compatibility with the standard -classes or earlier versions of \KOMAScript{}. Portions that describe features -that exist only for reasons of compatibility with earlier versions of -\KOMAScript{} are printed in sans serif font. You should not use them any -longer. +their own classes based on a \KOMAScript{} class. Because such descriptions +are not addressed to beginners, they are condensed and require deeper +knowledge of \LaTeX. Other parts describe features that exist only for the +sake of compatibility with the standard classes or earlier versions of +\KOMAScript{}.\iffree{}{ + Portions that describe features that exist only for reasons of compatibility + with earlier versions of \KOMAScript{} are printed in sans serif font. You + should not use them any longer.} \LoadNonFree{scrbookreportarticle-experts}{0} @@ -95,15 +98,14 @@ longer. \LoadNonFree{scrbookreportarticle-experts}{2} -\section{Expert Commands} -\seclabel{experts} - -This sections describes commands that are of little or no interest to the -average user. These commands offer additional features for experts. Because -the information is addressed to experts, it is condensed. +\section{Detection of \KOMAScript{} Classes} +\seclabel{identify} -% \subsection{Identification} -% \seclabel{identification} +Package authors sometimes need to detect a \KOMAScript{} class. Mostly this is +of little or no interest to the average user. To identify the version of +\KOMAScript{} that is being used, refer to +\DescRef{scrbase.cmd.KOMAScriptVersion} in \autoref{sec:scrbase.identify}, +\DescPageRef{scrbase.cmd.KOMAScriptVersion}. \begin{Declaration} \Macro{KOMAClassName}% @@ -122,8 +124,14 @@ the \KOMAScript{} label using this name.% % \EndIndexGroup -% \subsection{Entries to the Table of Contents} -% \seclabel{toc} +\section{Entries to the Table of Contents} +\seclabel{toc} + +\KOMAScript{} classes provide advanced methods for generating and +manipulating entries in the table of contents. Some of these are based on +the \Package{tocbasic} package (see \autoref{sec:tocbasic.tocstyle} starting +on \autopageref{sec:tocbasic.tocstyle}). Other are implemented directly in the +classes. \begin{Declaration} \Macro{addtocentrydefault}\Parameter{level}\Parameter{number}% @@ -236,9 +244,12 @@ rather than attempting to set the attribute for specific entry levels.% \EndIndexGroup -% \subsection{Font Settings} -% \seclabel{fonts} +\section{Font Settings} +\seclabel{fonts} +\KOMAScript{} classes not only provide an extended selection of basic font +sizes, but they also let you define, manipulate, and apply elements with +their own font settings. \begin{Declaration} \Macro{@fontsizefilebase}% @@ -387,8 +398,14 @@ undefined elements as well as for elements defined with \PName{else code}.% \EndIndexGroup -% \subsubsection{Paragraph Indention or Gap} -% \seclabel{parskip} +\section{Paragraph Indention or Gap} +\seclabel{parskip} + +Because the \KOMAScript{} classes offer extended features for setting the +paragraph indention or gap, direct changes of the standard lengths +\Length{parskip}\IndexLength{parskip}, \Length{parindent}\IndexLength{parskip} +and \Length{parfillskip}\IndexLength{parskip} are not only unnecessary but +mostly inadvisable. \begin{Declaration} \Macro{setparsizes}\Parameter{indent}\Parameter{distance} @@ -428,13 +445,17 @@ disables this recalculation.% % \EndIndexGroup -% \subsection{Counters} -% \seclabel{counter} +\section{Counters} +\seclabel{counter} \LoadNonFree{scrbookreportarticle-experts}{3} -% \subsubsection{Sections} -% \seclabel{sections} +\section{Sections} +\seclabel{sections} + +The \KOMAScript{} classes provide a wide range of options for modifying +sectioning levels and their corresponding headings. You can even define new +levels. \begin{Declaration} \Macro{DeclareSectionCommand}\OParameter{attributes}\Parameter{name}% @@ -526,9 +547,9 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or the value of \PName{counter name}, the value of the counter of this heading is reset to 0. In addition, \Macro{the\PName{counter name}} is prefixed with a dot when this counter is output.\\ + \PValue{counterwithout}% \ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - \PValue{counterwithout} & \PName{counter name} & Cancels a prior \PValue{counterwithin} setting. Therefore it makes sense only if you redefine an existing sectioning command.\\ @@ -1128,8 +1149,21 @@ the \PName{list of names}. For all other sectioning command in the \PName{list of names}, the values of \PValue{level} and \PValue{toclevel} are successively increased by the value of \PValue{increaselevel}. If the \PValue{increaselevel} attribute is used without assigning a value, 1 is -assumed. -% +assumed.% +\EndIndexGroup + + +\begin{Declaration} + \Macro{IfSectionCommandStyleIs}\Parameter{name}\Parameter{style} + \Parameter{then code}\Parameter{else code} +\end{Declaration} +In\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +rare cases, it is useful to be able to test whether a sectioning command +belongs to a specific \PName{style}. If \KOMAScript{} has defined the +sectioning command \Macro{\PName{name}} using the given \PName{style}, the +\PName{then code} will be used. Otherwise the \PName{else code} will be +executed. An error is reported if \Macro{\PName{name}} is undefined or if it +is not a \KOMAScript{} sectioning command.% \EndIndexGroup @@ -1533,6 +1567,87 @@ same style \PValue{section}.% \begin{Declaration} +\DoHook{heading/preinit/\PName{name}}% +\DoHook{heading/postinit/\PName{name}}% +\DoHook{heading/branch/star/\PName{name}}% +\DoHook{heading/branch/nostar/\PName{name}}% +\DoHook{heading/begingroup/\PName{name}}% +\DoHook{heading/endgroup/\PName{name}}% +\end{Declaration} +\BeginIndex{}{hooks}% +In\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} addition to all their attributes, +\DescRef{\LabelBase.cmd.DeclareSectionCommand}, +\DescRef{\LabelBase.cmd.DeclareNewSectionCommand}, +\DescRef{\LabelBase.cmd.ProvideSectionCommand} and +\DescRef{\LabelBase.cmd.RedeclareSectionCommand} provide several hooks in +sectioning commands that can be manipulated using +\DescRef{scrbase.cmd.AddtoDoHook}. For information about the functionality of +these \emph{do-hooks} see \autoref{sec:scrbase.hooks}, +\autopageref{sec:scrbase.hooks}. The last element of the specifier is the +\PName{name} of the sectioning command, as it is for the declaration commands +mentioned above. + +It is important\important{Attention!} to avoid adding code to these hooks that +would affect the page breaking or the position of the heading. Therefore only +advanced users should use these hooks. In case of doubt, refer to the class's +source code for information about exactly when a hook is executed. These hooks +serve as a fallback before you indeed would need to resort to redefining +a section command without using \KOMAScript{} features. + +The\textnote{\DoHHook{\dits/preinit/\dots}} hook +\DoHook{heading/preinit/\PName{name}} is executed immediately before the +sectioning command is initialised. At this point, no settings have been +initialised. Even the paragraph that precedes the heading is not +necessarily finished yet. + +The\textnote{\DoHook{\dots/postinit/\dots}} hook +\DoHook{heading/postinit/\PName{name}} is executed somewhat later. At this +point, some settings have been initialised and the previous paragraph has +already ended. + +Only\textnote{\DoHook{\dots/branch/\dots}} one of the hooks +\DoHook{heading/branch/nostar/\PName{name}} or +\DoHook{heading/branch/star/\PName{name}} is executed, after determining +whether the starred or normal variant of the section command is used. At this +point, the vertical gap above the heading has already been inserted. + +The\textnote{\DoHook{\dots/begingroup/\dots}} hook +\DoHook{heading/begingroup/\PName{name}} is executed at the beginning of +the group used to process the heading. This is also the last opportunity to +intervene before the heading is printed. + +Similarly\textnote{\DoHook{\dots/begingroup/\dots}}, the hook +\DoHook{heading/begingroup/\PName{name}} will be executed at the end of the +group used to process the heading. Currently this is the last hook inside +a section command. + +Note\textnote{\DescRef{maincls.cmd.minisec}} that +\DescRef{maincls.cmd.minisec} is not a real sectioning command and therefore +these hooks are not available for it.% +\EndIndexGroup + +\begin{Declaration} + \Macro{IfUseNumber}\Parameter{then code}\Parameter{else code} +\end{Declaration} +Strictly\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} speaking, this is an internal command. It is defined +inside sectioning commands only between the \DoHook{\dots/begingroup/\dots} +and \DoHook{\dots/endroup/\dots} hooks. In this case, the +\Parameter{then code} is executed if the sectioning heading uses the non-star +variant and should be numbered according to the value of +\DescRef{maincls.counter.secnumdepth}. If the heading should not be numbered +because the sectioning command uses the star variant or because of the value +of \DescRef{maincls.counter.secnumdepth}, the \PName{else code} is executed. +Headings in the \PValue{chapter} style also take into account whether +the headings appears in the main matter. + +If you use the command outside a sectioning command, the result is +unspecified. In this case, it will usually result in an error message and +execute neither the \PName{then code} nor the \PName{else code}.% +\EndIndexGroup + +\begin{Declaration} \Macro{SecDef}\Parameter{star command}\Parameter{command}% \Macro{scr@startsection}\Parameter{name}\Parameter{level}\Parameter{indent}% \Parameter{beforeskip}\Parameter{afterskip}% @@ -1544,65 +1659,77 @@ same style \PValue{section}.% \Parameter{style commands}% \PValue{*}\Parameter{heading}% \labelsuffix% - \Macro{At@startsection}\Parameter{code}% - \Macro{Before@ssect}\Parameter{code}% - \Macro{Before@sect}\Parameter{code} \end{Declaration} As\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} already explained in \autoref{sec:maincls.structure} in the description of the sectioning commands beginning with \DescPageRef{maincls.cmd.chapter}, \KOMAScript{} provides additional features for the optional argument of those commands. To achieve this, it was necessary -to replace some \LaTeX{} kernel commands, especially -\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} and -\Macro{@startsection}\IndexCmd{@startsection}% -\important{\Macro{@startsection}}. The meaning of the parameters of these -commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}. - -However, these commands are often completely redefined by other packages in a -way that clashes with the functionality of \KOMAScript. So \KOMAScript{} not -only changes the definition of these commands but also defines the additional, -alternative commands \Macro{SecDef} and \Macro{scr@startsection}. Package -authors can use these commands as they would use the corresponding \LaTeX{} -kernel commands and therefore gain access to the additional features of -\KOMAScript. However, these commands should not be redefined, as they may +to replace some \LaTeX{} kernel commands: +\begin{itemize} +\item Instead of + \Macro{@startsection}\IndexCmd{@startsection}\important{\Macro{@startsection}} + \KOMAScript{} uses \Macro{scr@startsection}. However, the definition of + \Macro{@startsection} is checked. If the implementation differs from the + expected one, a warning is issued, several features of \KOMAScript{} + are deactivated, and \Macro{scr@startsection} uses a copy of + \Macro{@startsection} while \Macro{@startsection} is redefined to use + \Macro{scr@startsection}. +\item Instead of \Macro{@dblarg}\IndexCmd{@dblarg}\important{\Macro{@dblarg}} + \KOMAScript{} uses an internal command to define sectioning commands. +\item Instead of \Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}}, + \KOMAScript{} uses \Macro{SecDef} to change \Macro{@dblarg} as + mentioned above. If the implementation of \Macro{secdef} differs from the + expected one, a warning is issued. +\item \Macro{@sect}\IndexCmd{@sect}\important{\Macro{@sect}} is redefined to + implement various extensions of \KOMAScript. +\item \Macro{@ssect}\IndexCmd{@ssect}\important{\Macro{@ssect}} is redefined + to implement various extensions of \KOMAScript. +\item \Macro{@xsect}\IndexCmd{@xsect}\important{\Macro{@xsect}} is redefined + to implement various extensions of \KOMAScript. +\end{itemize} +In future versions of \KOMAScript{}, consideration is being given to avoid +changing the \LaTeX{} kernel commands mentioned above and to replace them +completely with custom, internal commands. Loading truly incompatible +sectioning packages would automatically disable \KOMAScript{} extensions +and transfer the responsibility for the sectioning commands entirely +to these packages. On the other hand, extra effort would be required +to maintain compatibility with other packages. + +Package authors can use these commands as they would use the corresponding +\LaTeX{} kernel commands and therefore gain access to the additional features +of \KOMAScript. However, these commands should not be redefined, as they may changed at any time, and then this redefinition could compromise -\KOMAScript{}'s functionality. - -\KOMAScript{} itself uses \Macro{SecDef} and \Macro{scr@startsection} instead -of \Macro{secdef} and \Macro{@startsection}, for example to define sectioning -commands with \DescRef{\LabelBase.cmd.DeclareSectionCommand}. So later -redefinitions of \Macro{secdef} or \Macro{@startsection} will not influence -the sectioning commands of \KOMAScript. - -As an alternative to redefining such commands, \KOMAScript{} offers the -possibility to add additional \PName{code} at several points in -\KOMAScript{}'s own replacements. The \PName{code} of all calls to -\Macro{At@startsection}\important{\Macro{At@startsection}\\ - \Macro{Before@sect}\\ - \Macro{Before@sect}}, \Macro{Before@sect} and \Macro{Before@sect} is -collected separately for each command. There is no provision for removing -\PName{code} once it has been inserted. - -The \PName{code} of the \Macro{At@startsection}% - \important{\Macro{At@startsection}\\ - \Macro{scr@startsection}} macro is used in the \Macro{scr@startsection} -command immediately after evaluating \PName{beforeskip} and calculating the -resulting \Length{@tempskipa} but before adding the vertical skip itself. So -you can still change the value of \Length{@tempskipa}. - -The \PName{code} of \Macro{Before@sect} or \Macro{Before@ssect} is executed -within \Macro{scr@startsection} just before calling \Macro{@sect} or -\Macro{@ssect}, respectively. At this point, the vertical skip of -\Length{@tempskipa} has already been added using \Macro{addvspace}. - -These three commands, \Macro{At@startsection}, \Macro{Before@sect}, and -\Macro{Before@ssect}, are designed as an interface for package authors and -released for them to use.% -% +\KOMAScript{}'s functionality. The meaning of the parameters for these +commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}. +As\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} an alternative to redefining such commands, \KOMAScript{} +offers the hooks described previously.% \EndIndexGroup -% \subsection{Appendix} +\begin{Explain} + \begin{Declaration} + \Macro{At@startsection}\Parameter{code} + \Macro{Before@ssect}\Parameter{code} + \Macro{Before@sect}\Parameter{code} + \end{Declaration} + Until\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} \KOMAScript~v3.26b, these commands were available as an + alternative to redefine \DescRef{\LabelBase.cmd.scr@startsection} or + \DescRef{\LabelBase.cmd.SecDef}. Since\textnote{outdated \KOMAScript{} + command} \KOMAScript~v3.27, these commands are deprecated. + + Internally \Macro{At@startsection} is now implemented with the + \DescRef{\LabelBase.dohook.heading/postinit} hook. \Macro{Before@ssect} is + implemented with \DescRef{\LabelBase.dohook.heading/branch/star}, and + \Macro{Before@sect} uses + \DescRef{\LabelBase.dohook.heading/branch/nostar}. The \PName{code} is added + using \DescRef{scrbase.cmd.AddtoDoHook}. There are no provisions to remove + this code once it has been added.% + \EndIndexGroup +\end{Explain} + +% \section{Appendix} % \seclabel{appendix} @@ -1671,8 +1798,12 @@ realising it. \EndIndexGroup -% \subsection{Literaturverzeichnis} -% \seclabel{bibliography} +\section{Bibliography} +\seclabel{bibliography} + +The information in this section is less important if you use packages like +\Package{biblatex}. In that case, the extensive features of such packages +will supersede the extensions of the \KOMAScript{} classes described here. \begin{Declaration} \Macro{newbibstyle}\OParameter{parent style}\Parameter{name}%^^A diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex index b20b18726b..881f61b7a1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex @@ -46,13 +46,13 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle.tex} - [$Date: 2019-01-14 14:29:39 +0100 (Mon, 14 Jan 2019) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)] \translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} -% Date of the translated German file: 2019-01-14 +% Date of the translated German file: 2019-10-09 \chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl}} @@ -279,7 +279,7 @@ tables and figures, after the table of contents (see \DescRef{maincls-experts.cmd.DeclareNewSectionCommand}, \DescRef{maincls-experts.cmd.RedeclareSectionCommand}, and \DescRef{maincls-experts.cmd.ProvideSectionCommand} can also affect the - table of contents. See \autoref{sec:maincls-experts.experts}, + table of contents. See \autoref{sec:maincls-experts.sections}, \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.% \else% In addition to the options documented in this section, the @@ -299,7 +299,7 @@ tables and figures, after the table of contents (see \IndexCmd{DeclareNewSectionCommand} and \DescRef{maincls-experts.cmd.RedeclareSectionCommand}% \IndexCmd{RedeclareSectionCommand} documented in - \autoref{sec:maincls-experts.experts}, + \autoref{sec:maincls-experts.sections}, \DescPageRef{maincls-experts.cmd.DeclareSectionCommand} can also affect the table of contents.% \fi @@ -1002,9 +1002,10 @@ You can redefine the page styles with the \Macro{renewcommand} macro. example. Of course, you can also use a user-defined page style. Suppose you have defined your own page style for initial chapter pages with - the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see \autoref{cha:scrlayer}) - or the \hyperref[cha:scrlayer-scrpage-experts]{\Package{scrlayer-scrpage}} - package (see \autoref{cha:scrlayer-scrpage-experts}). You have given this + the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see + \autoref{sec:scrlayer.pagestyles}) or the + \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} package (see + \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}). You have given this page style the fitting name of \PValue{chapter}. To actually use this style, you must redefine \Macro{chapterpagestyle} in this way: \begin{lstcode} @@ -1414,7 +1415,7 @@ You can find additional settings for chapter headings in the explanation for \DescRef{maincls-experts.cmd.RedeclareSectionCommand} and the commands \DescRef{maincls-experts.cmd.chapterlineswithprefixformat} and \DescRef{maincls-experts.cmd.chapterlinesformat} in -\autoref{sec:maincls-experts.experts}, \autoref{part:forExperts}.% +\autoref{sec:maincls-experts.sections}, \autoref{part:forExperts}.% \EndIndexGroup @@ -1782,25 +1783,28 @@ extended interpretation of the optional argument \PName{short version}, which is not active by default. The \ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} extended interpretation of the optional argument -checks to see if there is an equals sign in \PName{short version}. If so, -the optional argument will be interpreted as an \PName{option list}. + \Class{scrartcl}} extended interpretation of the optional argument checks to +see if there is an equals sign in \PName{short version}. If so, the optional +argument will be interpreted as an \PName{option list}. Three options\,---\,\OptionVName{head}{running head}\important{\Option{head}\\ \Option{tocentry}\\ - \Option{reference}}, \OptionVName{tocentry}{table of contents entry}, and + \Option{reference}\\ + \Option{nonumber}}, \OptionVName{tocentry}{table of contents entry}, \OptionVName{reference}{reference title}% -\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -\,---\,are supported with this format. To use commas or equals signs -within the values of those options, you must enclose them in braces. +\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}, +and \OptionVName{nonumber}{simple switch}\ChangedAt{v3.27}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}}\,---\,are supported with this +format. To use commas or equals signs within the values of those options, you +must enclose them in braces. Please\textnote{Attention!} note that this mechanism only works as long as \KOMAScript{} controls the sectioning commands. If you use package that redefines the \KOMAScript{}'s or the internal \LaTeX{} kernel's sectioning commands, \KOMAScript{} can no longer provide this extended mechanism. This -also applies to a \KOMAScript{} that is always active: sectioning commands -with no heading text\textnote{empty headings} do not create entries in the -table of contents. If you really want an entry with empty heading text, you -can use an invisible entry like \lstinline|\mbox{}|. +also applies to a \KOMAScript{} extension that is always active: sectioning +commands with no heading text\textnote{empty headings} do not create entries +in the table of contents. If you really want an entry with empty heading text, +you can use an invisible entry like \lstinline|\mbox{}|. \begin{Example} Suppose you have a document with very long chapter headings. These headings @@ -1888,6 +1892,18 @@ option, or setting the title of a table-of-contents entry with the performance is poor compared to the other two, and it is not fully compatible with \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}. +You can deactivate the numbering using +\OptionValue{nonumber}{true}\important{\Option{nonumber}}% +\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +in the extended optional argument. In contrast to the +\hyperref[desc:maincls.cmd.part*]{starred versions of the sectioning commands} +explained below, the titles will still be added to the table of contents and, +if applicable, used for the running head. For \Macro{part}, \Macro{chapter}, +and \Macro{section}, using \OptionValue{nonumber}{true} this essentially +corresponds to the \DescRef{\LabelBase.cmd.addpart}, +\DescRef{\LabelBase.cmd.addchap}, and \DescRef{\LabelBase.cmd.addsec} +commands, which are explained on \DescPageRef{\LabelBase.cmd.addpart}. + The part-level title\important{\Macro{part}} (\Macro{part}) differs from other sectioning levels by being numbered independently. This means that the chapter level (in \Class{scrbook} or \Class{scrreprt}), or the section level (in @@ -2160,7 +2176,10 @@ similar to the standard commands \DescRef{\LabelBase.cmd.part}\IndexCmd{part}% \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} and \DescRef{\LabelBase.cmd.section}\IndexCmd{section} except that they are unnumbered. They thus produce both a running head and an entry in the table of -contents. +contents which take into account the \DescRef{\LabelBase.option.headings}% +\important{\DescRef{\LabelBase.option.headings}} option settings, especially +the handling of the optional argument. However, enabling or disabling the +\Option{nonumber} switch will have no effect. The starred variants \Macro{addchap*} and \Macro{addsec*} are similar to the standard commands \DescRef{\LabelBase.cmd.chapter*} and @@ -2553,7 +2572,7 @@ as well as \DescRef{maincls-experts.cmd.sectionlinesformat}\IndexCmd{sectionlinesformat} and its \DescRef{maincls-experts.cmd.sectioncatchphraseformat}% \IndexCmd{sectioncatchphraseformat} format in -\autoref{sec:maincls-experts.experts}, starting from +\autoref{sec:maincls-experts.sections}, starting from \DescPageRef{maincls-experts.cmd.partlineswithprefixformat}.% \EndIndexGroup @@ -2837,7 +2856,7 @@ heading will not be moved down. You are therefore responsible for ensuring that the \PName{preamble} is not too large and that the space above the heading is sufficient. See also the \Option{beforeskip} setting for \DescRef{maincls-experts.cmd.RedeclareSectionCommand} in -\autoref{sec:maincls-experts.experts}, +\autoref{sec:maincls-experts.sections}, \autoref{tab:maincls-experts.declarechapterstyle.keys}, \autopageref{tab:maincls-experts.declarechapterstyle.keys}. % @@ -4355,7 +4374,7 @@ modern and open kind of bibliography. The name comes from the fact that the bibliography entries appear more structured. They are less compact and seem more relaxed or open. Information about defining new bibliography styles can be found in the description of the \DescRef{maincls-experts.cmd.newbibstyle} -command in \autoref{sec:maincls-experts.experts}, +command in \autoref{sec:maincls-experts.bibliography}, \DescPageRef{maincls-experts.cmd.newbibstyle}. In addition to the formatting style, you can select one more feature using diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex b/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex index 7acd9f2bf7..e5cd194493 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrdatetime.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ============================================================================ \KOMAProvidesFile{scrdatetime.tex} - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrdate, scrtime)] \translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-10 \chapter{The Day of the Week with \Package{scrdate}} \labelbase{scrdate} diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex b/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex index 5504ee4b0d..28ba228390 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrextend.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{scrextend.tex} - [$Date: 2018-04-09 10:14:11 +0200 (Mon, 09 Apr 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script package scrextend] \translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-01-24 +% Date of the translated German file: 2019-10-10 \chapter[{\KOMAScript{} Features for Other Classes with \Package{scrextend}}] {Using Basic Features of the \KOMAScript{} Classes in Other Classes with the diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex index a7dfac605c..5a7fc200a1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrhack.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,12 @@ % ============================================================================ \KOMAProvidesFile{scrhack.tex} - [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrhack)] \translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-09 + \chapter{Improving Third-Party Packages with \Package{scrhack}} \labelbase{scrhack} @@ -213,7 +214,7 @@ package also uses \Package{lscape}, so \Package{scrhack} affects the functioning of this package too.% -\section{Special Case \Package{nomencl}} +\section{Special Case for \Package{nomencl}} \label{sec:nomencl} The\ChangedAt{v3.23}{\Package{scrhack}} hack for the @@ -251,6 +252,47 @@ The\textnote{Achtung!} setting of the option when \Package{nomencl} is loaded is crucial! Later changes to the option with \DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions} have no influence and will lead to a corresponding warning.% + + +\section{Special Case for Section Headings} +\seclabel{sections} + +Various\ChangedAt{v3.27}{\Package{scrhack}} packages assume that the +sectioning commands are defined in a specific way, corresponding to the +definitions in the standard classes. But for some classes this is not the +case. For example, the \KOMAScript{} classes use a completely different +implementation to provide many additional features. But this can cause +problems for packages that depend on the definition of the standard classes. +As of version~3.27, \Package{scrhack} offers the option to force the +sectioning commands \DescRef{maincls.cmd.part}\IndexCmd{part}, +\DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, +\DescRef{maincls.cmd.section}\IndexCmd{section}, +\DescRef{maincls.cmd.subsection}\IndexCmd{subsection}, +\DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection}, +\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph}, and +\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} to be compatible +with those in the standard classes. When \DescRef{maincls.cmd.chapter} is +defined, the definitions are based on those in \Class{book}. When +\DescRef{maincls.cmd.chapter} is undefined, the definitions of +\Class{article} are used. + +If you are using a \KOMAScript{} class, several features of these classes are +also deactivated as side effect. For example, the commands to define or +modify sectioning commands described in +\autoref{sec:maincls-experts.sections} or option +\DescRef{maincls.option.headings} are no longer available, and commands like +\DescRef{maincls.cmd.partformat} have different defaults. + +Because this hack has the potential to do more harm than good, it issues +several warnings. Also it is not activated simply by loading the +\Package{scrhack} package. If you want to use it, you must explicitly activate +it with the \Option{standardsections}\IndexOption[indexmain]{standardsections} +option when you load the package. Late activation or deactivation is not +supported. + +Since there are often less invasive solutions to fix the problem of package +incompatibilities, using this hack is not recommended. It is provided only as +a last resort for emergencies.% \EndIndexGroup \endinput diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex b/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex index fb782ca3dc..34d9d0d4a8 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{scrjura.tex}% - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 09:25:44 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrjura)] \translator{Alexander Willand\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-07-20 +% Date of the translated German file: 2019-10-09 \chapter{Support for the Law Office with \Package{scrjura}} \labelbase{scrjura} @@ -84,6 +84,14 @@ has to be loaded after \Package{scrjura} as usual. The headings of clauses can also be added automatically to the table of contents, if desired. +% TODO: Fix new translation +Therefore\ChangedAt{v3.27}{\Package{scrjura}} the package uses +\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry} +(see \autoref{sec:tocbasic.tocstyle}, +\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) to define an \PName{entry + level} named \PValue{cpar}. +% :ODOT + \begin{Declaration} \OptionVName{juratotoc}{simple switch}% @@ -94,9 +102,9 @@ Clauses\Index{clause} are shown in the table of contents only if their \DescRef{maincls.counter.tocdepth}% \important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} counter (see \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). By -default, the \PName{level number} is 10000, which is also used if the option -is switched off with the \PName{simple -switch}\important{\OptionValue{juratotoc}{false}} (see +default, the \PName{level number} is \Length{maxdimen}, which is also used if +the option is switched off with the \PName{simple + switch}\important{\OptionValue{juratotoc}{false}} (see \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}). Because the \DescRef{maincls.counter.tocdepth} counter usually has a one-digit value, clause entries are therefore not normally displayed in the table of contents. @@ -105,7 +113,15 @@ If you switch on the option using the \PName{simple switch}% \important{\OptionValue{juratotoc}{true}}, the \PName{level number} 2 is used so that clauses are shown in the table of contents on the same level as subsections. For the default setting of \DescRef{maincls.counter.tocdepth}, -clauses are then shown in all \KOMAScript{} classes.% +clauses are then shown in all \KOMAScript{} classes. + +% TODO: Fix new translation +Internally\ChangedAt{v3.27}{\Package{scrjura}} usage of this option results in +a call of +\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry} +with the \PName{style} \PValue{default} and a corresponding value of +\Option{level} in the \PName{option list}.% +% :ODOT \EndIndexGroup @@ -116,7 +132,15 @@ clauses are then shown in all \KOMAScript{} classes.% These two options can be used to determine the indentation for the clause entries in the table of contents as well as the space reserved for the numbers there. The defaults are the same as for subsection entries in -\Class{scrartcl}.% +\Class{scrartcl}. + +% TODO: Fix new translation +Internally\ChangedAt{v3.27}{\Package{scrjura}} usage of these options results +in calls of +\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry} +with the \PName{style} \PValue{default} and \OptionVName{indent}{indent} +respectively \OptionVName{numwidth}{number width} in the \PName{option list}.% +% :ODOT \EndIndexGroup @@ -188,7 +212,7 @@ other environments declared with \end{Declaration} These are the most important commands inside of a contract. Without using any additional \PName{options}, \Macro{Clause} creates the heading of a clause, -which consists of the sign »\S«, followed by its number. In contrast, +which consists of the sign ``\S'', followed by its number. In contrast, \Macro{SubClause} creates the heading of a clause with the last number used by \Macro{Clause} and adds a lower-case letter. \Macro{SubClause} is mainly intended for cases where an act or a contract is amended and not only are @@ -747,10 +771,10 @@ You can find examples of results of the basic commands in \toprule Command & Example output \\ \midrule - \DescRef{\LabelBase.cmd.refL}\Parameter{label} & § 1 paragraph 1 sentence 1 \\ - \DescRef{\LabelBase.cmd.refS}\Parameter{label} & § 1 par. 1 sent. 1 \\ - \DescRef{\LabelBase.cmd.refN}\Parameter{label} & § 1 I 1. \\ - \DescRef{\LabelBase.cmd.refClause}\Parameter{label} & § 1 \\ + \DescRef{\LabelBase.cmd.refL}\Parameter{label} & \S{} 1 paragraph 1 sentence 1 \\ + \DescRef{\LabelBase.cmd.refS}\Parameter{label} & \S{} 1 par. 1 sent. 1 \\ + \DescRef{\LabelBase.cmd.refN}\Parameter{label} & \S{} 1 I 1. \\ + \DescRef{\LabelBase.cmd.refClause}\Parameter{label} & \S{} 1 \\ \DescRef{\LabelBase.cmd.refClauseN}\Parameter{label} & 1 \\ \DescRef{\LabelBase.cmd.refParL}\Parameter{label} & paragraph 1 \\ \DescRef{\LabelBase.cmd.refParS}\Parameter{label} & par. 1 \\ @@ -817,7 +841,7 @@ supported \PName{options}. \PName{commands} used as its default setting. If the element was previously defined as an alias (see \DescRef{maincls-experts.cmd.aliaskomafont} in - \autoref{sec:maincls-experts.experts}, + \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.aliaskomafont}), it will become an independent element instead. If it has already been defined as an independent element, \DescRef{\LabelBase.cmd.setkomafont} is used to set @@ -1158,7 +1182,6 @@ detailed user feedback.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 %%% ispell-local-dictionary: "en_GB" %%% TeX-PDF-mode: t %%% TeX-master: "guide.tex" diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex index 47cc29a8aa..20651e4003 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-notecolumn.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-notecolumn.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -51,7 +51,7 @@ \translator{Markus Kohm\and Arndt Schubert\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-09 \chapter{Note Columns with \Package{scrlayer-notecolumn}} \labelbase{scrlayer-notecolumn} @@ -482,7 +482,29 @@ commands mentioned in the example above does not occur with the starred variant\important{\Macro{makenote*}}. It uses \Macro{detokenize} to prevent the expansion of commands. But this also means that you should not use commands in the \PName{note} that change their definition within the -document.% +document. + +Unfortunately, both commands have two other known +limitations\textnote{Attention!}. The first issue is related to colours using +\Package{color}\IndexPackage{color} or \Package{xcolor}\IndexPackage{xcolor} +within the note columns. To make such colour changes possible each note column +requires its own colour management using so-called \emph{colour stacks}. +Because the package was designed only as a \emph{proof of concept} and because +\XeTeX{} does not support multiple colour stacks, \XeTeX{} colour switching is +restricted to the attributes of the font element +\FontElement{notecolumn.\PName{note column name}}, a limitation which +eliminates the time and effort required to implement custom colour management. + +The second issue is of a more conceptual nature. The content of the auxiliary +file that contains the note-column information is read while processing the +page header. This has consequences in particular if the read occurs while +an environment like \Environment{verbatim} is active. In this case, the +\Macro{catcode} settings of this environment would be active while reading the +auxiliary file. This will inevitably lead to errors in processing and output. +To attenuate this risk, the \Macro{catcodes} of the characters from +\Macro{dospecials}\IndexCmd{dospecials} are stored during +\Macro{begin}\PParameter{document} and explicitly restored when reading from +the auxiliary file.% \EndIndexGroup @@ -696,7 +718,6 @@ changed from blue to grey.} %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 %%% ispell-local-dictionary: "en_GB" %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex index c9cdc98c8a..b5684a766e 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage-experts.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-scrpage-experts.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -44,11 +44,11 @@ % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage-experts.tex}% - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlayer-scrpage-experts)] \translator{Markus Kohm\and Karl Hagen} -% Date version of the translated file: 2018-01-31 +% Date version of the translated file: 2019-10-09 \chapter[{Additional Features of \Package{scrlayer-scrpage}}] {Additional Features\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} with diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex index d3c50bfef0..cffeeffd9b 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-scrpage.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -44,11 +44,11 @@ % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage.tex}% - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlayer-scrpage)] \translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} -% Date version of the translated file: 2018-02-13 +% Date version of the translated file: 2019-10-09 \chapter[{Headers and Footers with \Package{scrlayer-scrpage}}] {Headers\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} and diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex index 5488fe2cb0..e56824c156 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,12 @@ % ============================================================================ \KOMAProvidesFile{scrlayer.tex} - [$Date: 2018-12-15 15:01:34 +0100 (Sat, 15 Dec 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter:scrlayer)] \translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-12-15 +% Date of the translated German file: 2019-10-09 \chapter[{Defining Layers and Page Styles with \Package{scrlayer}}] {Defining\ChangedAt{v3.12}{\Package{scrlayer}} Layers and Page Styles with @@ -606,6 +606,16 @@ be changed. Applying either command to a previously undefined \PName{layer \begin{Declaration} + \Macro{ModifyLayers}\OParameter{option list}\Parameter{layer list} +\end{Declaration} +This\ChangedAt{v3.26}{\Package{scrlayer}} command executes +\DescRef{\LabelBase.cmd.ModifyLayer} with the given \PName{option list} for +all layers of the comma-separated layer list. Therefore the option can be used +to change attributes of several layers simultaneously.% +\EndIndexGroup + + +\begin{Declaration} \Macro{layerhalign}% \Macro{layervalign}% \Macro{layerxoffset}% @@ -860,16 +870,14 @@ first time. Therefore, when defining an end-user interface, you may find it useful to set the current page style to a default with an implicit \DescRef{maincls.cmd.pagestyle} statement. -% Todo: New translation by Markus Kohm (please fix it!) -For page-style aliases activated using \DescRef{maincls.cmd.pagestyle} -\Macro{currentpagestyle} does not show the alternative name but the name of +If \DescRef{maincls.cmd.pagestyle} activates an alias page style, +\Macro{currentpagestyle} shows not the alternative name but the name of the real page style. You\ChangedAt{v3.16}{\Package{scrlayer}} can get the alternative name using \Macro{toplevelpagestyle}. However, it is not -recommended to define page styles, that have different results depending on +recommended to define page styles that produce different results depending on \Macro{toplevelpagestyle}, e.\,g., using \DescRef{scrbase.cmd.ifstr}. If you -would activate such a page style using \DescRef{maincls.cmd.thispagestyle} you -could get the wrong result.% -% End of new translation. +were to activate such a page style using \DescRef{maincls.cmd.thispagestyle} +you could get the wrong result.% \EndIndexGroup diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex index a01a4a0035..1796a163c4 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlfile.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ============================================================================ \KOMAProvidesFile{scrlfile.tex} - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlfile)] \translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-02-15 +% Date of the translated German file: 2019-10-10 \chapter{Controlling Package Dependencies with \Package{scrlfile}} \labelbase{scrlfile} diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex index ffb397b6d2..722183a7bd 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex @@ -46,14 +46,14 @@ % ============================================================================ \KOMAProvidesFile{scrlttr2-experts.tex} - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ 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\and Karl Hagen} -% Date of the translated German file: 2018-07-20 +% Date of the translated German file: 2019-10-09 \chapter{Additional Information about the \Class{scrlttr2} Class and the \Package{scrletter} Package} @@ -400,6 +400,22 @@ exists for package authors.% \begin{Declaration} + \Macro{Ifplength}\Parameter{pseudo-length}% + \Parameter{then-code}\Parameter{else-code} +\end{Declaration} +This\ChangedAt{v3.27}{\Class{scrlttr2}\and \Class{scrletter}} command can be +used to determine whether a \PName{pseudo-length} has been defined. The +\PName{then-code} is executed if the \PName{pseudo-length} is defined and not +\Macro{relax}. Otherwise the \PName{else-code} is executed. + +% Note: In the English manual this information is not \iffree{}{...}! +\BeginIndex{Cmd}{if@plength}% +For reasons of consistency only, the internal command \Macro{if@plength}, +with the identical meaning, exists for the use of package authors.% +\EndIndexGroup + + +\begin{Declaration} \Macro{setplength}% \OParameter{factor}\Parameter{pseudo-length}\Parameter{value}% \Macro{addtoplength}% @@ -1280,6 +1296,36 @@ it is robust enough to be used as the argument of example.% % \EndIndexGroup + + +\begin{Declaration} + \Macro{foreachkomavar}\Parameter{list of variables}\Parameter{command} + \Macro{foreachnonemptykomavar}\Parameter{list of variables}\Parameter{command} + \Macro{foreachemptykomavar}\Parameter{list of variables}\Parameter{command} + \Macro{foreachkomavarifempty}\Parameter{list of variables} + \Parameter{then-code}\Parameter{else-code} +\end{Declaration} +The\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} +\Macro{foreachkomavar} command executes the specified \PName{command} for each +variable in the comma-separated \PName{list of variables}. The name of each +variable is added as parameter to the \PName{command}.% + +The \Macro{foreachnonemptykomavar} command does the same but only for those +variables that are not empty in sense of +\DescRef{\LabelBase.cmd.ifkomavarempty}. Empty variables in the \PName{list of + variables} are ignored. + +By contrast, the \Macro{foreachemptykomavar} command executes the +\PName{command} only for variables that are empty in sense of +\DescRef{\LabelBase.cmd.ifkomavarempty}. Accordingly, non-empty variables are +ignored. + +The \Macro{foreachkomavarifempty} command is a kind of combination of the two +previously described commands. It executes the \PName{then-command} only for +those variables in the \PName{list of variables} that are empty, and the +\PName{else-command} for the non empty variables. As with \PName{command}, the +name of each variable is added as a parameter in both cases.% +\EndIndexGroup % \EndIndexGroup diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex index e63f59c2ab..81923f666c 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex @@ -46,14 +46,14 @@ % ============================================================================ \KOMAProvidesFile{scrlttr2.tex}% - [$Date: 2019-01-15 08:39:58 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 10:25:29 +0200 (Thu, 10 Oct 2019) $ 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\and Karl Hagen} -% Date of the translated German file: 2018-04-26 +% Date of the translated German file: 2019-10-10 \chapter{Letters with the \Class{scrlttr2} Class or the \Package{scrletter} Package} @@ -483,9 +483,10 @@ printing. Since letters are not usually bound, each page of a letter will be viewed on its own. This is also true even if both the letter is printed on both sides of the paper. Vertical adjustment usually does not matter for letters either. If you nevertheless need it, or want to understand what it is, -please refer to the commands \Macro{raggedbottom} and \Macro{flushbottom} -explained in \autoref{sec:maincls.typearea} on -\DescPageRef{maincls.cmd.flushbottom}.% +please refer to the commands +\DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} and +\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} explained in +\autoref{sec:maincls.typearea} on \DescPageRef{maincls.cmd.flushbottom}.% % \EndIndexGroup @@ -663,7 +664,12 @@ for the standard letter class. description of the \DescRef{\LabelBase.cmd.opening} command on \DescPageRef{\LabelBase.cmd.opening}. \end{Example} -% + +Letters\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} are always +printed in single-column mode and without vertical adjustment. You can use +\DescRef{maincls.cmd.flushbottom}, explained in \autoref{sec:maincls.typearea} +on \DescPageRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom}, together with +\DescRef{\LabelBase.cmd.AtBeginLetter} to force a vertical adjustment.% \EndIndexGroup @@ -1300,7 +1306,7 @@ definitely set the variables for return address (see \EndIndexGroup \begin{Declaration} - \OptionVName{symbolicnames}{simple switch}% + \OptionVName{symbolicnames}{value}% \OptionVName{fromphone}{simple switch}% \OptionVName{frommobilephone}{simple switch}% \OptionVName{fromfax}{simple switch}% @@ -1318,12 +1324,13 @@ definitely set the variables for return address (see \Variable{urlseparator}% \end{Declaration} \BeginIndex{}{letterhead}% -\BeginIndex{}{letter>header} -You can use the five options \Option{fromphone}, \Option{frommobilephone}\ChangedAt{v3.12}{\Class{scrlttr2}}, \Option{fromfax}, +\BeginIndex{}{letter>header}% +You can use the five options \Option{fromphone}, +\Option{frommobilephone}\ChangedAt{v3.12}{\Class{scrlttr2}}, \Option{fromfax}, \Option{fromemail}, and \Option{fromurl} to specify whether to include the phone number\Index{telephone}\Index{phone}, mobile\ChangedAt{v3.12}{\Class{scrlttr2}} phone number\Index{mobile -phone}\Index{cell phone}\Index{cellphone}, fax number\Index{fax}, e-mail + phone}\Index{cell phone}\Index{cellphone}, fax number\Index{fax}, e-mail address\Index{e-mail}, or URL should be as part of the sender's information. You can assign any standard value for simple switches from \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to these @@ -1338,18 +1345,24 @@ You can\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}} change the defaults for describing the variables all at once with the \Option{symbolicnames} option. This option understands the values for simple switches found in \autoref{tab:truefalseswitch}, -\autopageref{tab:truefalseswitch}. Activating the option replaces the -descriptions from the language-dependant labels of +\autopageref{tab:truefalseswitch}. +Activating\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} the +option corresponds to \PName{value} \PValue{marvosym} and replaces the +descriptions from the language-dependent labels of \DescRef{scrlttr2-experts.cmd.emailname}, \DescRef{scrlttr2-experts.cmd.faxname}, \DescRef{scrlttr2-experts.cmd.mobilephonename}, and \DescRef{scrlttr2-experts.cmd.phonename} with symbols from the \Package{marvosym}\IndexPackage{marvosym} package. At the same time, the colon is omitted when defining the separators. In this case, both the description -and the content of the URL separator will be empty. Note\textnote{Attention!} -that you have to load the \Package{marvosym} package on your own if you activate -\Option{symbolicnames} for the first time after -\Macro{begin}\PParameter{document}. +and the content of the URL separator will be empty. With +\OptionValue{symbolicnames}{fontawesome} or +\OptionValue{symbolicnames}{awesome}, symbols of package +\Package{fontawesome}\IndexPackage{fontawesome} are used. In this case there +is also a symbol for the URL. Note\textnote{Attention!} that you may need to +load the \Package{marvosym} or \Package{fontawesome} package in your document +preamble if you activate the option for the corresponding package for the +first time after \Macro{begin}\PParameter{document}. \begin{table} \centering diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex b/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex index 78253e34e0..a2ae601c86 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrwfile.tex -% Copyright (c) Markus Kohm, 2010-2018 +% Copyright (c) Markus Kohm, 2010-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrwfile.tex -% Copyright (c) Markus Kohm, 2010-2018 +% Copyright (c) Markus Kohm, 2010-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,10 +46,10 @@ % ============================================================================ \KOMAProvidesFile{scrwfile.tex}% - [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrwfile)] -% Date of the translated German file: 2018-02-15 +% Date of the translated German file: 2019-10-10 \translator{Markus Kohm\and Jana Schubert\and Karl Hagen} diff --git a/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex b/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex index 36681ff609..bd34f48969 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex @@ -1,6 +1,6 @@ % ====================================================================== % tocbasic.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,10 +46,10 @@ % ====================================================================== \KOMAProvidesFile{tocbasic.tex} - [$Date: 2018-08-31 09:11:20 +0200 (Fri, 31 Aug 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (package tocbasic)] -% Date of the translated German file: 2018-08-31 +% Date of the translated German file: 2019-10-09 \translator{Markus Kohm\and Arndt Schubert\and Karl Hagen} @@ -83,26 +83,26 @@ contents but also for the already mentioned lists of figures and tables. \label{sec:tocbasic.basics} The basic commands are primarily used to handle a list of all known file -extensions\textnote{file extension, content lists} that -represent a table or list of contents. We call these auxiliary -files\Index{auxiliary file}\footnote{The term \emph{auxiliary file} here - refers not to the main \File{aux} file but to the other internal files used - indirectly via the \File{aux} file, e.\,g. the \File{toc} file, the - \File{lof} file, or the \File{lot} file.} TOC files\textnote{TOC - file}\Index[indexmain]{TOC file} regardless of the file extension that is -actually used. Entries to such files are typically written using +extensions\textnote{file extension, content lists} that represent a table or +list of contents. We call these auxiliary files\Index{auxiliary + file}\footnote{The term \emph{auxiliary file} here refers not to the main + \File{aux} file but to the other internal files used indirectly via the + \File{aux} file, e.\,g. the \File{toc} file, the \File{lof} file, or the + \File{lot} file.} TOC files\textnote{TOC file}\Index[indexmain]{TOC file} +regardless of the file extension that is actually used. Entries to such files +are typically written using \Macro{addtocontents}\important{\Macro{addtocontents}, -\DescRef{\LabelBase.cmd.addxcontentsline}}, or + \DescRef{\LabelBase.cmd.addxcontentsline}}, or \DescRef{\LabelBase.cmd.addxcontentsline}. There are also commands to perform actions on all of these file extensions. Additionally, there are commands to set or unset features for the file associated with a given extension. Typically an file extension also has an owner\textnote{file owner}. This owner -may be a class or package, or an identifier that the author of the class or -package using \Package{tocbasic} has chosen independently. For example, -\KOMAScript{} uses the owner \texttt{float} for the \File{lof} and \File{lot} -file extensions that are associated with the list of figures and list of -tables, respectively. For the table of contents, \KOMAScript{} uses the file -name of the class. +may be a class or package, or an identifier of a category that the author of +the class or package using \Package{tocbasic} has chosen independently. For +example, \KOMAScript{} uses the category \texttt{float} as owner for the +\File{lof} and \File{lot} file extensions that are associated with the list of +figures and list of tables, respectively. For the table of contents, +\KOMAScript{} uses the file name of the class. \begin{Declaration} \Macro{ifattoclist}\Parameter{extension}\Parameter{then code}% @@ -198,8 +198,8 @@ brackets. An empty argument would also result in an empty owner. \end{Example} You can specify any \PName{owner} you want, but it must be unique. For example, if you were the author of the \Package{float} package, you could -specify ``\PValue{float}'' instead of ``\PValue{float.sty}'' as the -\PName{owner}. In this case, the \KOMAScript{} +specify the category ``\PValue{float}'' instead of ``\PValue{float.sty}'' as +the \PName{owner}. In this case, the \KOMAScript{} options\important{\DescRef{maincls.option.listof}}% \IndexOption{listof~=\PName{setting}} for the list of figures and the list of tables would also affect your content lists because these lists are already @@ -383,7 +383,7 @@ If so, it will be used for the entry, passing the \PName{section number} as an optional argument and \PName{text} as a mandatory argument. You can find an example of such a command provided by the \KOMAScript{} classes in \DescRef{maincls-experts.cmd.addparttocentry} (see -\autoref{sec:maincls-experts.experts}, +\autoref{sec:maincls-experts.toc}, \DescPageRef{maincls-experts.cmd.addparttocentry}). If the corresponding command is undefined, the internal command \DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} is used instead. This takes @@ -623,7 +623,12 @@ to define your own title for the content list with the given file \PName{extension}. The \PName{definition} of the title can use a single parameter, \PValue{\#1}. When the command is called inside \DescRef{\LabelBase.cmd.listoftoc} or \DescRef{\LabelBase.cmd.listofeachtoc}, -that \PValue{\#1} will be replaced by the title of this content list.% +that \PValue{\#1} will be replaced by the title of this content list. + +Obviously, the \PName{definition} is also responsible for the interpretation +of additional features related to the title. This is especially true +for the features \PValue{leveldown}, \PValue{numbered} and \PValue{totoc}, +that are be explained next.% \EndIndexGroup @@ -636,7 +641,7 @@ You can use these two commands to set and clear features for a TOC file list} is a comma-separated list of features. The \Package{tocbasic} package recognizes following features: \begin{description} -\item[\texttt{leveldown}] means that the content list's heading is created not +\item[\PValue{leveldown}] means that the content list's heading is created not with the highest sectioning level below \DescRef{maincls.cmd.part}\,---\,\DescRef{maincls.cmd.chapter} if available, \DescRef{maincls.cmd.section} otherwise\,---\,but with a heading of the next @@ -648,7 +653,7 @@ recognizes following features: important{\OptionValueRef{maincls}{listof}{leveldown}}% \IndexOption{listof~=\textKValue{leveldown}} option for all file extensions with the owner \PValue{float}. -\item[\texttt{nobabel}] prevents using the language-switching features of +\item[\PValue{nobabel}] prevents using the language-switching features of \Package{babel}\IndexPackage{babel} for the TOC file associated with the this file \PName{extension}. This feature should be used only for content lists that are created in a fixed language, which means that changes of the @@ -660,14 +665,20 @@ recognizes following features: Note\textnote{Attention!} that you must set this feature before you add a file extension to the list of known extensions. Changing the feature afterwards will have no effect. -\item[\texttt{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}} +\item[\PValue{noindent}]\ChangedAt{v3.27}{\Package{tocbasic}}% + causes all content-list entry styles provided by \KOMAScript{} to ignore + the \PValue{indent} attribute (see + \autoref{tab:tocbasic.tocstyle.attributes}, + \autopageref{tab:tocbasic.tocstyle.attributes.indent}) and instead to + deactivate the indentation.% +\item[\PValue{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}} the insertion of a final \Length{parskip} before switched off paragraph spacing for content lists. In general, this will cause documents that use spacing between paragraphs to have less vertical space between the list heading and first entry than between normal headings and normal text. Normally, therefore, you will obtain a more uniform formatting without this feature. -\item[\texttt{noprotrusion}] prevents\ChangedAt{v3.10}{\Package{tocbasic}} +\item[\PValue{noprotrusion}] prevents\ChangedAt{v3.10}{\Package{tocbasic}} character protrusion, which allows optical margin alignment, from being disabled in the content lists. By default, character protrusion is disabled when the \Package{microtype}\IndexPackage{microtype} package, or another @@ -676,7 +687,7 @@ recognizes following features: must set this feature. Note\textnote{Attention!}, however, that character protrusion in content lists often results in incorrect results. This is a known issue with character protrusion. -\item[\texttt{numbered}] means that the heading for the content list should +\item[\PValue{numbered}] means that the heading for the content list should be numbered and included in the table of contents. This feature is evaluated by the internal heading command. However, if a user-defined heading command has been created with \DescRef{\LabelBase.cmd.deftocheading}, the person @@ -686,7 +697,7 @@ recognizes following features: \important{\OptionValueRef{maincls}{listof}{numbered}}% \IndexOption{listof~=\textKValue{numbered}} option for all file extensions with the owner \PValue{float}. -\item[\texttt{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}% +\item[\PValue{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}% means that any entries made using \DescRef{\LabelBase.cmd.addxcontentsline} or \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile}, where the optional argument for the number is missing or empty, will be provided with @@ -714,7 +725,7 @@ recognizes following features: \OptionValueRef{maincls}{toc}{nonumberline}% \important{\OptionValueRef{maincls}{toc}{nonumberline}}% \IndexOption{toc~=\textKValue{nonumberline}}. -\item[\texttt{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}% +\item[\PValue{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}% means that this content list will automatically use \LaTeX's internal one-column mode with \Macro{onecolumn}\IndexCmd{onecolumn}. However\textnote{Attention!}, this applies only if this content list does @@ -728,7 +739,7 @@ recognizes following features: these classes. The multicolumn mode of the \Package{multicol}\IndexPackage{multicol} package is expressly unaffected by this option. -\item[\texttt{totoc}] means that the title of content list should be included +\item[\PValue{totoc}] means that the title of content list should be included in the table of contents. This feature will be evaluated by the internal heading command. However, if an user-defined heading command has been created with \DescRef{\LabelBase.cmd.deftocheading}, the person defining @@ -740,7 +751,7 @@ recognizes following features: \end{description} The \KOMAScript{} classes recognize an additional feature: \begin{description} -\item[\texttt{chapteratlist}] ensures that an optional subdivision is added +\item[\PValue{chapteratlist}] ensures that an optional subdivision is added to the content list for each new chapter. By default, this subdivision is a vertical space. See \DescRef{maincls.option.listof}% \IndexOption{listof}\important{\DescRef{maincls.option.listof}} in @@ -804,7 +815,7 @@ you define your own heading command using \BeginIndex{}{table of contents>entry}% \Index{list of contents|\see{table of contents}} -Since\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} version~3.20, the +Since\ChangedAt{v3.20}{\Package{tocbasic}} version~3.20, the \Package{tocbasic} package has been able not only to configure the tables or lists of contents and their auxiliary files but also to influence their entries. To do so, you can define new styles or you can use and configure one @@ -839,7 +850,7 @@ later in this section}) observe \Counter{tocdepth}.% \Macro{numberline}\Parameter{entry number}% \Macro{usetocbasicnumberline}\OParameter{code} \end{Declaration} -Although\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel +Although\ChangedAt{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel already defines a \Macro{numberline} command, the definition is not sufficient for \Package{tocbasic}. Therefore \Package{tocbasic} defines its own commands and sets \Macro{numberline} as needed using \Macro{usetocbasicnumberline} for @@ -1016,18 +1027,19 @@ Currently, \Package{tocbasic} defines the following entry styles: \PValue{section} and \PValue{subsection} using this style, but add extra \PName{initial code} to the clones to change their defaults. - The style supports 16\important{\PValue{level}, \PValue{beforeskip}, + The style supports 18\important{\PValue{level}, \PValue{beforeskip}, \PValue{breakafternumber}, \PValue{dynnumwidth}, \PValue{entryformat}, \PValue{entrynumberformat}, \PValue{indent}, \PValue{linefill}, \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel}, \PValue{onstartlowerlevel}, \PValue{onstartsamelevel}, \PValue{pagenumberbox}, \PValue{pagenumberformat}, - \PValue{raggedentrytext}, \PValue{raggedpagenumber}} additional attributes - in addition to the default \PValue{level} attribute. The defaults of all - these attributes depend on the name of the \PName{entry level} and - correspond to the results of the standard classes. So after loading - \Package{tocbasic}, you can change the style of the entries in the table of - contents of the standard classes into \PValue{tocline} using + \PValue{pagenumberwidth}, \PValue{raggedentrytext}, + \PValue{raggedpagenumber}, \PValue{rightindent}} additional attributes in + addition to the default \PValue{level} attribute. The defaults of all these + attributes depend on the name of the \PName{entry level} and correspond to + the results of the standard classes. So after loading \Package{tocbasic}, + you can change the style of the entries in the table of contents of the + standard classes into \PValue{tocline} using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} without this leading directly to major changes in their appearance. Thus you can precisely change only those attributes that are necessary for the desired changes. The same @@ -1190,6 +1202,20 @@ Currently, \Package{tocbasic} defines the following entry styles: \PValue{tocline} style} \label{fig:tocbasic.tocline} \end{figure} +\item[\PValue{toctext}]\ChangedAt{v3.27}{\Package{tocbasic}}% + is a special feature. While all other styles produce one paragraph per + entry, this one produces one paragraph for all successive entries of this + style. With 13\important{\PValue{afterpar}, \PValue{entryformat}, + \PValue{entrynumberformat}, \PValue{indent}, \PValue{numsep}, + \PValue{onendentry}, \PValue{onendlastentry}, \PValue{onstartentry}, + \PValue{onstartfirstentry}, \PValue{pagenumberformat}, + \PValue{prepagenumber}, \PValue{raggedright}, \PValue{rightindent}} + attributes in addition to the default \PValue{level} attribute, there are + almost as many options as for \PValue{tocline}. However, this style + depends on the fact that an unfinished paragraph will be concluded at the + beginning of the entry for all other styles, as well as at the end of the + current content list. So it should never be combined with entries or content + lists that are generated outside of \Package{tocbasic}. \item[\PValue{undottedtocline}] is similar to the style used by the standard \Class{book} and \Class{report} classes for the \PValue{chapter} entry level, or by \Class{article} for the \PValue{section} entry level in the @@ -1246,11 +1272,27 @@ Currently, \Package{tocbasic} defines the following entry styles: \end{description} You can find an explanation of the attributes of all styles that \Package{tocbasic} defines in \autoref{tab:tocbasic.tocstyle.attributes}. +In\ChangedAt{v3.27}{\Package{tocbasic}} addition to the usual assignment with +\Option{\PName{key}=\PName{value}}, both commands understand an assignment in +the form \Option{\PName{key}:=\PName{entry level}} for all options of the +\KOMAScript{} styles. In this case, the current setting of \PName{key} for the +\PName{entry level} will be copied. For example, you can copy the current +indent of the \PValue{figure} level using \OptionValue{indent:}{figure}. For +options that expect a length or integer value, you can also use +\Option{\PName{key}+=\PName{value}} to add\PName{value} to the current setting +of the \PName{key}. To subtract simply, you can use a negative \PName{value}. +For example, with \OptionValue{indent+}{1cm} you can increase the indent by +1\Unit{cm}. + If\ChangedAt{v3.21}{\Package{tocbasic}} you use these attributes as options to \DescRef{\LabelBase.cmd.DeclareNewTOC} (see \DescPageRef{\LabelBase.cmd.DeclareNewTOC}), you must prefix the names of the -attribute by \PValue{tocentry}, e\,g. \PValue{level} becomes -\Option{tocentrylevel}. If\ChangedAt{v3.20}{\Package{tocbasic}} use +attributes with \PValue{tocentry}, e\,g., \PValue{level} becomes +\Option{tocentrylevel}. The copy operation with \Option{:=} described above is +also available here. However, addition with \Option{+=} is not currently +supported. + +If\ChangedAt{v3.20}{\Package{tocbasic}} you use these attributes as options for \DescRef{maincls-experts.cmd.DeclareSectionCommand}% \IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}% @@ -1258,6 +1300,8 @@ these attributes as options for \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) and similar commands, you must prefix the names of the attributes with \PValue{toc}, e\,g. \PValue{level} becomes \Option{toclevel}. +At this time, neither the copy operation with \Option{:=} nor the +addition operation with \Option{+=} is supported. Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \Macro{l@\PName{entry level}}. @@ -1269,6 +1313,13 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command }{% Attributes of the TOC-entry styles (\emph{continued})% }% + \entry{\OptionVName{afterpar}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The specified \PName{code} will be executed after the end of the paragraph + in which an entry with the \PValue{toctext} style is printed. If several + entries have such settings, their code will be executed in the order of + the entries.% + }% \entry{\OptionVName{beforeskip}{length}}{% The vertical distance inserted before an entry of this level in the \PValue{tocline} style (see \autoref{fig:tocbasic.tocline}). The distance @@ -1342,12 +1393,19 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \IndexOption{toc~=\textKValue{numberline}} option, the unnumbered entries will execute the \PName{command} as well.% }% - \entry{\OptionVName{indent}{length}}{% - The horizontal distance of the entry from the left margin (see + \entry{% + \OptionVName{indent}{length}% + {\phantomsection\label{tab:tocbasic.tocstyle.attributes.indent}}% + }{% + For\ChangedAt{v3.27}{\Package{tocbasic}} the \PValue{toctext} style, the + \PName{length} is the horizontal distance of the paragraph from the left + margin. If different entries within the paragraph have different settings, + the last one is used. For the remaining styles, the \PName{length} is the + horizontal distance of the entry from the left margin (see \autoref{fig:tocbasic.dottedtocline} and \autoref{fig:tocbasic.tocline}). - - For the \PValue{tocline} style, all entry levels whose names start with - ``\texttt{sub}'' are initialised with the + + For the styles \PValue{tocline} and \PValue{toctext}, all entry levels + whose names start with ``\texttt{sub}'' are initialised with the \PValue{indent}+\PValue{numwidth} of the entry level of the same name without this prefix. For the \PValue{dottedtocline}, \PValue{undottedtocline}, and \PValue{tocline} styles, the initial values @@ -1355,7 +1413,11 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \PValue{figure} and \PValue{table} are compatible with the standard classes. All other levels do not have an initial value. Therefore you have to set an explicit value for such levels when they are defined first - time.% + time. + + If the \PValue{noindent} attribute is set for a content list via + \DescRef{\LabelBase.cmd.setuptoc}, the entries of all styles provided by + \KOMAScript{} enforce the value 0\Unit{pt} to deactivate the indent.% }% \entry{\OptionVName{level}{integer}}{% The numerical value of the \PName{entry level}. Only those entries whose @@ -1367,15 +1429,15 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command This attribute is mandatory for all styles and will be defined automatically when the style is declared. - For the \PValue{tocline} style, all entry levels whose name starts with - ``\texttt{sub}'' are initialised with the value of the entry level of the - same name without this prefix plus one. For the \PValue{dottedtocline}, - \PValue{largetocline}, \PValue{tocline}, and \PValue{undottedtocline} - styles, the entry levels from \PValue{part} to \PValue{subparagraph}, as - well as \PValue{figure} and \PValue{table}, are initialised to be - compatible with the standard classes. For all other levels, the - initialisation is done with the value of \Macro{\PName{entry - level}numdepth}, if this is defined.% + For the \PValue{tocline} and \PValue{toctext} styles, all entry levels + whose name starts with ``\texttt{sub}'' are initialised with the value of + the entry level of the same name without this prefix plus one. For the + \PValue{dottedtocline}, \PValue{largetocline}, \PValue{tocline}, + \PValue{toctext}, and \PValue{undottedtocline} styles, the entry levels + from \PValue{part} to \PValue{subparagraph}, as well as \PValue{figure} + and \PValue{table}, are initialised to be compatible with the standard + classes. For all other levels, the initialisation is done with the value + of \Macro{\PName{entry level}numdepth}, if this is defined.% }% \entry{\OptionVName{linefill}{code}}{% With the \PValue{tocline} style, you can change what is used to fill the @@ -1395,9 +1457,14 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \entry{\OptionVName{numsep}{length}}{% The \PValue{tocline} style tries to ensure a minimum distance of \PName{length} between the entry number and the entry text. If - \PValue{dynnumwidth} is active, it will correct the number width to achieve - this. Otherwise it simply throws a warning, if the condition is not met. + \PValue{dynnumwidth} is active, it will correct the number width to + achieve this. Otherwise it simply throws a warning if the condition is not + met. + The\ChangedAt{v3.27}{\Package{tocbasic}} \PValue{toctext} style, on the + other hand, always adds a horizontal space of width \PName{length} after + the number of the entry. + The initial \PName{length} is 0.4\Unit{em}.% }% \entry{\OptionVName{numwidth}{length}}{% @@ -1419,6 +1486,37 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command you must set \PValue{numwidth} explicitly when the entry level is first used.% }% + \entry{\OptionVName{onendentry}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PName{code} is executed immediately after an entry with the + \PValue{toctext} style, if this entry is not the last one of the + paragraph. The user must ensure that the \PName{code} does not result in + the paragraph ending. + + Note: In reality the \PName{code} is not executed at the end of the entry + but before the next entry with style \PValue{toctext}.% + }% + \entry{\OptionVName{onendlastentry}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PName{code} is executed immediately before the end of the paragraph + with an entry in the \PValue{toctext} style, as long as this entry is the + last one in the paragraph. The user must ensure that the \PName{code} does + not result in the paragraph ending.% + }% + \entry{\OptionVName{onstartentry}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PName{code} is executed immediately before an entry with the + \PValue{toctext} style, unless it is the first one in the paragraph. The + user must ensure that the \PName{code} does not result in the paragraph + ending.% + }% + \entry{\OptionVName{onstartfirstentry}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PName{code} is executed immediately before an entry with the + \PValue{toctext} style if this entry is the first one of the paragraph. The + user must ensure that the \PName{code} does not result in the paragraph + ending.% + }% \entry{\OptionVName{onstarthigherlevel}{code}}{% The \PValue{tocline} style can execute \PName{code} at the start of an entry, depending on whether the previous entry had numerical level greater @@ -1482,6 +1580,23 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command all other levels prints the argument in \Macro{normalfont}\Macro{normalcolor}.% }% + \entry{\OptionVName{pagenumberwidth}{length}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + You can use this attribute to locally change the width of the default box + for the page number of an entry with the style \PValue{tocline} from + \Macro{@pnumwidth} to the specified \PName{length}. Note that if you + change the default page number box with the \Option{pagenumberbox} + attribute, the specified \PName{length} will no longer be used + automatically.% + }% + \entry{\OptionVName{prepagenumber}{code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PValue{toctext} style executes the \PName{code} between the text and + the page number of the entry. Usually this is used to add a horizontal + space or separator between text and page number.% + + The default is a non-breaking space using \Macro{nonbreakspace}.% + }% \entry{\OptionVName{raggedentrytext}{switch}}{% The\ChangedAt{v3.21}{\Package{tocbasic}} \PName{switch} is one of the values for simple switches from \autoref{tab:truefalseswitch}, @@ -1508,16 +1623,26 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \DescRef{\LabelBase.cmd.TOCLineLeaderFill} for the \PValue{linefill} attribute.% }% + \entry{\OptionVName{raggedright}{switch}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + The \PName{switch} is one of the values for simple switches from + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the + switch is active for any entry with the \PValue{toctext} style inside the + same paragraph, the whole paragraph is printed ragged right. + }% + \entry{\OptionVName{rightindent}{length}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + You can use this attribute to locally change the right indent for the text + of an entry with the \PValue{tocline} style from \Macro{@tocrmarg} to the + specified \PName{length}.% + }% \end{desclist} -% New translation by Markus Kohm (please fix it!): -\Macro{DeclareTOCStyleEntries}\ChangedAt{v3.26}{\Package{tocbasic}} uses -\Macro{DeclareTOCStyleEntry} to define not only one \PName{entry level} but -several entry levels. Each of the entry levels, given by the comma-separated -\PName{entry level list}, is defined with the same \PName{style} and the -settings of the given \PName{option list}.% -% End of new translation. -% +While \Macro{DeclareTOCStyleEntry} defines only one \PName{entry level}, +\Macro{DeclareTOCStyleEntries}\ChangedAt{v3.26}{\Package{tocbasic}} can define +an entire list of \PName{entry level}s in one command. Each entry level in the +comma-separated \PName{entry-level list} is defined with the same \PName{style} +and settings of the given \PName{option list}.% \EndIndexGroup @@ -1558,7 +1683,7 @@ settings of the given \PName{option list}.% \Parameter{description}% %\OParameter{initial code}% \end{Declaration} -\Macro{DeclareTOCEntryStyle}\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} is +\Macro{DeclareTOCEntryStyle}\ChangedAt{v3.20}{\Package{tocbasic}} is one of the most complex commands in \KOMAScript. It is therefore explicitly intended for \LaTeX{} developers and not for ordinary \LaTeX{} users. It lets you define new a \PName{style} for content-list entries. Usually, entries to @@ -1592,20 +1717,33 @@ automatically. The value of the \Option{level} can be queried within the \important{\Macro{\PName{entry level}tocdepth}}, for example, to compare it with the \DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth} counter. -To define options for the attributes of the -\PName{style} inside the \PName{initial code}, you can use the commands \Macro{DefineTOCEntryBooleanOption}, -\Macro{DefineTOCEntryCommandOption}, \Macro{DefineTOCEntryIfOption}, -\Macro{DefineTOCEntryLengthOption}, and \Macro{DefineTOCEntryNumberOption}. -These commands each define an \PName{option} that, when called, -defines a macro named \Macro{\PName{prefix}\PName{entry - level}\PName{postfix}} set to the given value or to the -\PName{default value} of the option. The -\Macro{DefineTOCEntryIfOption} command is a somewhat special case. It defines \Macro{\PName{prefix}\PName{entry - level}\PName{postfix}} as a command with two arguments. If the value passed to -the option is one of the activation (true) values from \autoref{tab:truefalseswitch}, -\autopageref{tab:truefalseswitch}, the command expands to the first -argument. If the value to the option is a deactivation (false) value, the command -expands to the second argument. +To define options for the attributes of the \PName{style} inside the +\PName{initial code}, you can use the commands +\Macro{DefineTOCEntryBooleanOption}, \Macro{DefineTOCEntryCommandOption}, +\Macro{DefineTOCEntryIfOption}, \Macro{DefineTOCEntryLengthOption}, and +\Macro{DefineTOCEntryNumberOption}. These commands each define an +\PName{option} that, when called, defines a macro named +\Macro{\PName{prefix}\PName{entry level}\PName{postfix}} set to the given +value or to the \PName{default value} of the option. The +\Macro{DefineTOCEntryIfOption} command is a somewhat special case. It defines +\Macro{\PName{prefix}\PName{entry level}\PName{postfix}} as a command with two +arguments. If the value passed to the option is one of the activation (true) +values from \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}, +the command expands to the first argument. If the value to the option is a +deactivation (false) value, the command expands to the second argument. + +In\ChangedAt{v3.27}{\Package{tocbasic}} addition to the usual options of the +form \Option{\PName{key}=\PName{value}}, the five +\Macro{DefineTOCEntry\dots Option} commands automatically define options of +the form \Option{\PName{key}:=\PName{entry level}}. These copy the value of +another \PName{entry level} if the value is stored in a macro with the same +\PName{prefix} and \PName{postfix}. For the styles predefined by +\Package{tocbasic}, this is the case for all options of the same name +independent of the name of the style. The commands +\Macro{DefineTOCEntryLengthOption} and \Macro{DefineTOCEntryNumberOption} also +define options of the form \Option{\PName{key}:=\PName{value}}, which are used +to add the new \PName{value} to the value already stored in +\Macro{\PName{prefix}\PName{entry level}\PName{postfix}}. The \PName{description} should be a brief message that describes the sense of the option with some keywords. The \Package{tocbasic} package uses this text @@ -1662,7 +1800,7 @@ mentioned here only for the sake of completeness.% \begin{Declaration} \Macro{CloneTOCEntryStyle}\Parameter{style}\Parameter{new style}% \end{Declaration} -With\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} this command you can clone +With\ChangedAt{v3.20}{\Package{tocbasic}} this command you can clone an existing \PName{style}. It defines a \PName{new style} with the same attributes and settings as the existing \PName{style}. The package itself uses \Macro{CloneTOCEntryStyle} to declare the \PValue{default} style as a clone of @@ -1683,7 +1821,7 @@ of \PValue{section}, and \Class{scrartcl} declares it as a clone of \Macro{TOCEntryStyleStartInitCode}\Parameter{style}% \Parameter{initial code} \end{Declaration} -Every\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} TOC-entry style has an +Every\ChangedAt{v3.20}{\Package{tocbasic}} TOC-entry style has an initialisation code. This is used whenever a \PName{style} is assigned to an TOC entry using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}. This \PName{initial code} should not have global side effects, because it is also @@ -1718,7 +1856,7 @@ to define \PValue{section} as a modified clone of \PValue{tocline}.% \Macro{LastTOCLevelWasSame}% \Macro{LastTOCLevelWasLower} \end{Declaration} -At\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the beginning of entries +At\ChangedAt{v3.20}{\Package{tocbasic}} the beginning of entries using the \PValue{tocline} style, \Package{tocbasic} executes one of these three commands depending on \Macro{lastpenalty}. \Macro{LastTOCLevelWasHigher} and \Macro{LastTOCLevelWasSame} used in vertical mode add @@ -1736,7 +1874,7 @@ behaviour of single entry levels using the \PValue{onstartlowerlevel}, \begin{Declaration} \Macro{TOCLineLeaderFill}\OParameter{leader} \end{Declaration} -This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command is intended to be +This\ChangedAt{v3.20}{\Package{tocbasic}} command is intended to be used as a value for the \Option{linefill} option of the \PName{tocline} TOC-entry style. It creates a connection between the end of the entry text and the entry's page number. You can specify the \PName{leader}, which is repeated @@ -1925,7 +2063,7 @@ run.% \Macro{tocbasic@DependOnPenaltyAndTOCLevel}\Parameter{entry level}% \Macro{tocbasic@SetPenaltyByTOCLevel}\Parameter{entry level} \end{Declaration} -The\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} \PValue{tocline} +The\ChangedAt{v3.20}{\Package{tocbasic}} \PValue{tocline} content-list style (see \autoref{sec:tocbasic.tocstyle}) sets a \Macro{penalty} at the end of each entry via \Macro{tocbasic@SetPenaltyByTOCLevel} so that no page break can occur after an @@ -2126,15 +2264,15 @@ cannot be set using \DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions}! You can find an overview of all available options in \autoref{tab:tocbasic.DeclareNewTOC-options}. -If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} the \Option{tocentrystyle} +If\ChangedAt{v3.20}{\Package{tocbasic}} the \Option{tocentrystyle} option is not used, the \PValue{default} style will be used if required. For information about this style, see \autoref{sec:tocbasic.tocstyle}. If you do not want to define a command for entries to the content list, you can use an empty argument, i.\,e. \OptionValue{tocentrystyle}{} or \OptionValue{tocentrystyle}{\PParameter{}}. -Depending\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% -\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} on the style of the entries to +Depending\ChangedAt{v3.20}{\Package{tocbasic}}% +\ChangedAt{v3.21}{\Package{tocbasic}} on the style of the entries to the content list, you can set all valid attributes of the selected style as part of the \PName{options}. To do so, you must add the prefix \PValue{tocentry} to the names of the attributes given in @@ -2167,6 +2305,10 @@ the styles.% The \PName{commands} will be executed at the end of the floating or non-floating environment.% }% + \entry{\OptionVName{category}{string}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + This option can be used as a synonym for \OptionVName{owner}{string}.% + }% \entry{\OptionVName{counterwithin}{\LaTeX{} counter}}{% If you define a new floating or non-floating environment, a new counter \Counter{\PName{type}} will be created as well (see option @@ -2201,8 +2343,8 @@ the styles.% before.% }% \entry{\OptionVName{hang}{length}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% This option has been deprecated since \KOMAScript~3.20. Instead, the amount of the hanging indent of entries to the content list\index{content list>entry} depends on attributes of the TOC-entry style given by the @@ -2214,8 +2356,8 @@ the styles.% example, use \OptionValue{tocentrynumwidth}{2.3em}.% }% \entry{\OptionVName{indent}{length}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% This option has been deprecated since \KOMAScript~3.20. Instead, the amount that entries to the content list\index{content list>entry} are indented depends on attributes of the TOC-entry style given by the @@ -2227,8 +2369,8 @@ the styles.% use \OptionValue{tocentrynumwidth}{1.5em}.% }% \entry{\OptionVName{level}{number}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% This option has been deprecated since \KOMAScript~3.20. Instead, the level of the entries to the content list\index{content list>entry} depends on attributes of the TOC-entry style given by the \Option{tocentrystyle} @@ -2289,7 +2431,7 @@ the styles.% \autopageref{sec:tocbasic.tocstyle}.% }% \entry{\OptionVName{tocentry\PName{style-option}}{value}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.20}{\Package{tocbasic}}% Additional options depending on the \PName{TOC-entry style} given by \Option{tocentrystyle}. See \autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle} for additional information about diff --git a/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex index da2679cc7d..b72bd75cc5 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % typearea-experts.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,11 @@ % ====================================================================== \KOMAProvidesFile{typearea-experts.tex} - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: typearea)] \translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen} -% Date of the translated German file: 2018-01-31 +% Date of the translated German file: 2019-10-10 \chapter{Additional Information about the \Package{typearea} package} \labelbase{typearea-experts} diff --git a/macros/latex/contrib/koma-script/source-doc/english/typearea.tex b/macros/latex/contrib/koma-script/source-doc/english/typearea.tex index 1985498be3..6ae976a096 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/typearea.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/typearea.tex @@ -46,12 +46,12 @@ % ====================================================================== \KOMAProvidesFile{typearea.tex}% - [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: typearea)] \translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen} -% Date of the translated German file: 2018-01-31 +% Date of the translated German file: 2019-10-10 \chapter{Calculating the Page Layout with \Package{typearea}} \labelbase{typearea} diff --git a/macros/latex/contrib/koma-script/source-doc/guide.bib b/macros/latex/contrib/koma-script/source-doc/guide.bib index 03e8e4eec4..966d945a4a 100644 --- a/macros/latex/contrib/koma-script/source-doc/guide.bib +++ b/macros/latex/contrib/koma-script/source-doc/guide.bib @@ -45,7 +45,7 @@ language= {ngerman}, author = {Markus Kohm}, title = {Moderne Briefe mit {\KOMAScript}}, - journal = {Die {\TeX}nische Komödie}, + journal = {Die {\TeX}nische Komödie}, volume = {2}, year = 2003, pages = {32--51}, @@ -57,7 +57,7 @@ author = {Markus Kohm}, title = {{\KOMAScript} -- Eine Alternative zu den Standardklassen?}, - journal = {Die {\TeX}nische Komödie}, + journal = {Die {\TeX}nische Komödie}, year = 1996, volume = {2}, pages = {14--33}, @@ -68,7 +68,7 @@ language= {ngerman}, author = {Markus Kohm}, title = {Satzspiegelkonstruktionen im Vergleich}, - journal = {Die {\TeX}nische Komödie}, + journal = {Die {\TeX}nische Komödie}, volume = {4}, year = 2002, pages = {28--48}, @@ -89,7 +89,7 @@ language= {ngerman}, author = {Hans Peter Willberg and Friedrich Forssman}, title = {Erste Hilfe in Typografie}, - subtitle = {Ratgeber für Gestaltung mit Schrift}, + subtitle = {Ratgeber für Gestaltung mit Schrift}, publisher = {Verlag Hermann Schmidt}, year = 2000, address = {Mainz} @@ -98,8 +98,8 @@ @Book{ JTsch87, language= {ngerman}, author = {Jan Tschichold}, - title = {Ausgewählte Aufsätze über Fragen der Gestalt des Buches und der Typographie}, - publisher = {Birkhäuser Verlag}, + title = {Ausgewählte Aufsätze über Fragen der Gestalt des Buches und der Typographie}, + publisher = {Birkhäuser Verlag}, year = 1987, address = {Basel}, edition = 2 @@ -119,7 +119,7 @@ language= {ngerman}, author = {Kohm, Markus}, title = {{\KOMAScript}}, - subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}}, + subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}}, year = 2018, edition = 6, publisher={Lehmanns Media}, @@ -133,7 +133,7 @@ language= {ngerman}, author = {Kohm, Markus}, title = {{\KOMAScript}}, - subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}}, + subtitle= {Eine Sammlung von Klassen und Paketen für {\LaTeXe}}, year = 2018, edition = 6, publisher={Lehmanns Media}, @@ -181,7 +181,7 @@ author = {Indra Kupferschmid}, editor = {}, title = {Buchstaben kommen selten allein: Ein typografisches Werkstattbuch}, - publisher = {Universitätsverlag Weimar}, + publisher = {Universitätsverlag Weimar}, year = {2000}, note = {{ISBN} 3-86068-140-0} } @@ -189,7 +189,7 @@ @InCollection{ JTschMass, language= {ngerman}, author = {Jan Tschichold}, - title = {Willkürfreie Maßverhältnisse der Buchseite und des Satzspiegels}, + title = {Willkürfreie Maßverhältnisse der Buchseite und des Satzspiegels}, booktitle = {Schriften 1925-1974}, year = 1992, publisher = {Brinkmann \& Bose}, @@ -198,7 +198,7 @@ @InCollection{ zeitung, language = {ngerman}, - author = {Martin Z. Schröder}, + author = {Martin Z. Schröder}, title = {Die Anmut des Unscheinbaren}, booktitle = {Berliner Zeitung}, year = 1998, @@ -262,7 +262,7 @@ @Manual{ l2kurz, language = {ngerman}, - author = {Marco Daniel and Patrick Gundlach and 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 = 2012, month = jul, @@ -283,7 +283,7 @@ Schlegl}, @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}, + author = {Johannes Braams and David Carlisle and Alan Jeffrey and Leslie Lamport and Frank Mittelbach and Chris Rowley and Rainer Schöpf}, title = {The {\LaTeX2e} Source}, year = 2005, month = 12 @@ -668,7 +668,7 @@ Schlegl}, @Misc{ package:ragged2e, language = {english}, - author = {Martin Schröder}, + author = {Martin Schröder}, title = {The {\Package{Ragged2e}} package}, year = 2009, month = jun, @@ -786,7 +786,7 @@ Schlegl}, @Misc{ https://komascript.de/comment/5070, language= {ngerman}, author= {Markus Kohm}, - title= {{\OptionValue{chapteratlists}{entry}} automatisch nur für Kapitel mit Einträgen}, + title= {{\OptionValue{chapteratlists}{entry}} automatisch nur für Kapitel mit Einträgen}, year= 2015, month= jul, url= {https://komascript.de/comment/5070#comment-5070}, @@ -812,11 +812,11 @@ Schlegl}, @Misc{ www:blaettery, language = {ngerman}, - author = {Jürgen F. Schopp}, + author = {Jürgen F. Schopp}, address = {mailto: \url{jurgen.schapp@uta.fi}}, - title = {Blätter (und Tipps) zur Typografie}, - institution = {Institut für Sprach- und Translationswissenschaften}, - organization = {Universität Tampere, Finnland}, + title = {Blätter (und Tipps) zur Typografie}, + institution = {Institut für Sprach- und Translationswissenschaften}, + organization = {Universität Tampere, Finnland}, year = 2002, month = sep, edition = {2}, diff --git a/macros/latex/contrib/koma-script/source-doc/linkalias.tex b/macros/latex/contrib/koma-script/source-doc/linkalias.tex index 0f1720cfab..e545e6a5a1 100644 --- a/macros/latex/contrib/koma-script/source-doc/linkalias.tex +++ b/macros/latex/contrib/koma-script/source-doc/linkalias.tex @@ -1,6 +1,6 @@ % ====================================================================== % linkalias.tex -% Copyright (c) Markus Kohm, 2008-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % linkalias.tex -% Copyright (c) Markus Kohm, 2008-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -39,7 +39,7 @@ % \KOMAProvidesFile{linkalias.tex} - [$Date: 2018-07-18 13:58:44 +0200 (Wed, 18 Jul 2018) $ + [$Date: 2019-10-09 17:46:01 +0200 (Wed, 09 Oct 2019) $ link aliases for the free version] \makeatletter @@ -83,9 +83,6 @@ \lalias[\Macro{rightmark}] {desc:maincls-experts.cmd.rightmark} {sec:maincls-experts.addInfos} -\lalias[\Macro{the}] - {desc:maincls-experts.cmd.the} - {sec:maincls-experts.experts} \lalias[\Option{parskip}] {desc:maincls-experts.option.parskip} {sec:maincls-experts.addInfos} @@ -113,6 +110,12 @@ \lalias[\Macro{the\PName{Zähler}}] {desc:maincls-experts.cmd.the/Zaehler/} {sec:maincls-experts.addInfos} +\lalias[\Macro{the\PName{Zähler}}] + {desc:maincls-experts.cmd.the/Zähler/} + {sec:maincls-experts.addInfos} +\lalias[\Macro{the\PName{Zähler}}] + {desc:maincls-experts.cmd.the/Z"ahler/} + {sec:maincls-experts.addInfos} \lalias[\Macro{the\PName{Counter}}] {desc:maincls-experts.cmd.the/Counter/} {sec:maincls-experts.addInfos} diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/adrconvnote.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/adrconvnote.tex index ddec394b53..7748638243 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/adrconvnote.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/adrconvnote.tex @@ -1,6 +1,6 @@ % ====================================================================== % adrconvnote.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % adrconvnote.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über adrconv in der KOMA-Script-Anleitung -% Verwaltet von Jens-Uwe Morawski (mit Unterstützung von Markus Kohm) +% Kapitel über adrconv in der KOMA-Script-Anleitung +% Verwaltet von Jens-Uwe Morawski (mit Unterstützung von Markus Kohm) % % ====================================================================== \KOMAProvidesFile{adrconvnote.tex} - [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: adrconv)] \chapter{Adressdateien aus Adressdatenbanken}% @@ -55,13 +55,13 @@ \index{Adressdatenbank}% \IndexPackage{addrconv} -In früheren Versionen von \KOMAScript{} war das Paket +In früheren Versionen von \KOMAScript{} war das Paket \Package{addrconv} ein fester Bestandteil des \KOMAScript{}-Systems. -Die hauptsächliche Verflechtung mit \KOMAScript{} +Die hauptsächliche Verflechtung mit \KOMAScript{} bestand darin, dass mit Hilfe dieses Pakets aus Adressdatenbanken im \BibTeX-Format Adressdateien -für die \KOMAScript-Briefklasse oder für das +für die \KOMAScript-Briefklasse oder für das \Package{scraddr}-Paket erstellt werden konnten. \begin{lstlisting}[morekeywords={@address}] @@ -78,23 +78,23 @@ für die \KOMAScript-Briefklasse oder für das } \end{lstlisting} -Aus Einträgen wie dem oben stehenden können mit Hilfe +Aus Einträgen wie dem oben stehenden können mit Hilfe von \BibTeX{} und verschiedenen \BibTeX-Stilen die Adressdateien erstellt werden. -Weiterhin gibt es spezielle \LaTeX-Dateien, die es ermöglichen, +Weiterhin gibt es spezielle \LaTeX-Dateien, die es ermöglichen, aus den Adressdateien Telefon- und Adressverzeichnisse zu erstellen. -Das Paket \Package{addrconv} war aber eigentlich ein eigenständiger Teil, der -auch noch über die Belange von \KOMAScript{} hinaus Möglichkeiten bietet. +Das Paket \Package{addrconv} war aber eigentlich ein eigenständiger Teil, der +auch noch über die Belange von \KOMAScript{} hinaus Möglichkeiten bietet. Deshalb ist \Package{addrconv} bereits seit einiger Zeit nicht mehr in -\KOMAScript{} enthalten. Das Paket \Package{adrconv}, nur ein »\Package{d}«, -ersetzt \Package{addrconv} vollständig. Es muss, falls nicht bereits in Ihrer +\KOMAScript{} enthalten. Das Paket \Package{adrconv}, nur ein »\Package{d}«, +ersetzt \Package{addrconv} vollständig. Es muss, falls nicht bereits in Ihrer \TeX-Distribution enthalten, von \cite{package:adrconv} separat bezogen und installiert werden. %%% Local Variables: %%% mode: latex -%%% coding: latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/authorpart.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/authorpart.tex index c0207de5f9..9313b9c145 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/authorpart.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/authorpart.tex @@ -1,6 +1,6 @@ % ====================================================================== % authorpart.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % authorpart.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,7 +40,7 @@ % % ---------------------------------------------------------------------- % -% Erster Teil: KOMA-Script für Autoren +% Erster Teil: KOMA-Script für Autoren % Verwaltet von Markus Kohm % % ====================================================================== @@ -51,33 +51,33 @@ \vspace*{2\baselineskip}% \setlength{\parindent}{1em}% - \noindent In diesem Teil sind die Informationen für die Autoren von - Artikeln, Berichten, Büchern und Briefen zu finden. Dabei wird davon - ausgegangen, dass der normale Anwender sich weniger dafür interessiert, wie + \noindent In diesem Teil sind die Informationen für die Autoren von + Artikeln, Berichten, Büchern und Briefen zu finden. Dabei wird davon + ausgegangen, dass der normale Anwender sich weniger dafür interessiert, wie in \KOMAScript{} die Dinge implementiert sind und wo die Schwierigkeiten - dabei liegen. Auch ist es für den normalen Anwender wenig interessant, + dabei liegen. Auch ist es für den normalen Anwender wenig interessant, welche obsoleten Optionen und Anweisungen noch enthalten sind. Er will wissen, wie er aktuell etwas erreichen kann. Eventuell ist er noch an typografischen Hintergrundinformationen interessiert. - Die wenigen Passagen, die weiterführende Informationen und Begründungen - enthalten und deshalb für ungeduldige Leser weniger von Interesse sind, - wurden in diesem Teil in serifenloser Schrift gesetzt und können bei Bedarf - übersprungen werden. Wer hingegen noch mehr Informationen zu Hintergründen + Die wenigen Passagen, die weiterführende Informationen und Begründungen + enthalten und deshalb für ungeduldige Leser weniger von Interesse sind, + wurden in diesem Teil in serifenloser Schrift gesetzt und können bei Bedarf + übersprungen werden. Wer hingegen noch mehr Informationen zu Hintergründen der Implementierung, Nebenwirkungen bei Verwendung anderer Pakete und zu obsoleten Optionen oder Anweisungen sucht, sei auf \autoref{part:forExperts} ab \autopageref{part:forExperts} - verwiesen. Darüber hinaus beschäftigt sich jener Teil von \KOMAScript{} auch - mit all den Möglichkeiten, die speziell für Autoren von Paketen und Klassen + verwiesen. Darüber hinaus beschäftigt sich jener Teil von \KOMAScript{} auch + mit all den Möglichkeiten, die speziell für Autoren von Paketen und Klassen geschaffen wurden. } -\part{\KOMAScript{} für Autoren\label{part:forAuthors}} +\part{\KOMAScript{} für Autoren\label{part:forAuthors}} \endinput %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "guide.tex" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-compatibility.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-compatibility.tex index f52b3e00e0..76920fa6d7 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-compatibility.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-compatibility.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-compatibility.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-compatibility.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,57 +40,57 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-compatibility.tex} - [$Date: 2018-01-30 09:32:50 +0100 (Tue, 30 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] -\section{Kompatibilität zu früheren Versionen von \KOMAScript} +\section{Kompatibilität zu früheren Versionen von \KOMAScript} \seclabel{compatibilityOptions} \BeginIndexGroup -\BeginIndex{}{Kompatibilität} +\BeginIndex{}{Kompatibilität} \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} geschrieben wurde.\IfThisCommonLabelBase{scrlttr2}{ Allerdings existiert diese - Möglichkeit bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} bereits seit - Version~2.9t, während \Package{scrletter} sie nicht bietet, sondern + Möglichkeit bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} bereits seit + Version~2.9t, während \Package{scrletter} sie nicht bietet, sondern sozusagen immer von \OptionValue{version}{last} ausgeht.}{} Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} bereits gelesen - und verstanden haben, können Sie in + und verstanden haben, können Sie in \autoref{sec:\ThisCommonLabelBase.compatibilityOptions.next} auf \autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next} fortfahren.% } \IfThisCommonLabelBaseOneOf{typearea,maincls,scrlttr2,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 führen aber Verbesserungen + 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 führen aber Verbesserungen und Korrekturen \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{an der - Klasse}{am Paket} zu Änderungen im Verhalten, inbesondere beim - Umbruch. Dies ist jedoch manchmal eher unerwünscht.% + Klasse}{am Paket} zu Änderungen im Verhalten, inbesondere beim + Umbruch. Dies ist jedoch manchmal eher unerwünscht.% }{% % \IfThisCommonLabelBase{scrextend}{% -% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen am Paket -% zu Änderungen im Verhalten, inbesondere beim Umbruch, führen. Dies ist -% jedoch nicht immer erwünscht.% +% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen am Paket +% zu Änderungen im Verhalten, inbesondere beim Umbruch, führen. Dies ist +% jedoch nicht immer erwünscht.% % 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.% +% 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.% % }{% \ThisCommonLabelBaseFailure % \IfThisCommonLabelBase{scrlttr2}{% -% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen an der -% Klasse zu Änderungen im Verhalten, inbesondere beim Umbruch, -% führen. Dies ist jedoch nicht immer erwünscht.% +% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen an der +% Klasse zu Änderungen im Verhalten, inbesondere beim Umbruch, +% führen. Dies ist jedoch nicht immer erwünscht.% % }{}% % }% }% @@ -116,12 +116,12 @@ }% }% }% -die Wahl, ob eine Quelldatei, soweit irgend möglich, auch zukünftig bei einem -\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob er jeweils +die Wahl, ob eine Quelldatei, soweit irgend möglich, auch zukünftig bei einem +\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob er jeweils entsprechend der Anpassungen der neusten Version\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ der Klasse}{} zu setzen -ist. Zu welcher Version Kompatibilität herzustellen ist, wird dabei über die -Option \Option{version} festgelegt. Kompatibilität zur ältesten unterstützten +ist. Zu welcher Version Kompatibilität herzustellen ist, wird dabei über die +Option \Option{version} festgelegt. Kompatibilität zur ältesten unterstützten \KOMAScript-Version kann mit \OptionValue{version}{first}\important{\OptionValue{version}{first}} oder \OptionValue{version}{2.9} oder \OptionValue{version}{2.9t} erreicht @@ -130,8 +130,8 @@ Warnung ausgegeben und sicherheitshalber \OptionValue{version}{first} angenommen. Mit \OptionValue{version}{last}\important{\OptionValue{version}{last}}% -\textnote{Voreinstellung} kann die jeweils neuste Version ausgewählt -werden. In diesem Fall wird also auf rückwirkende Kompatibilität +\textnote{Voreinstellung} kann die jeweils neuste Version ausgewählt +werden. In diesem Fall wird also auf rückwirkende Kompatibilität verzichtet. Wird die Option ohne Wertangabe verwendet, so wird ebenfalls \PValue{last} angenommen. \ChangedAt{v3.01a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}\and @@ -143,32 +143,32 @@ obsolete Option verwendet wird. Bei\textnote{Achtung!} der Verwendung einer obsoleten Option von \KOMAScript~2 setzt \KOMAScript~3 automatisch \OptionValue{version}{first}. In der dabei ausgegebenen Warnung wird - erklärt, wie man diese Kompatibilitätsumschaltung verhindern + erklärt, wie man diese Kompatibilitätsumschaltung verhindern kann. Alternativ kann man auch nach der obsoleten Option selbst eine - abweichende Einstellung für Option \Option{version} wählen.% + abweichende Einstellung für Option \Option{version} wählen.% } -Die Frage der Kompatibilität betrifft in erster Linie Fragen des -Umbruchs. Neue Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind -auch dann verfügbar, wenn man per Option die Kompatibilität zu einer älteren -Version ausgewählt hat. Die Option hat keine Auswirkungen auf -Umbruchänderungen, die bei Verwendung einer neueren Version durch Beseitigung +Die Frage der Kompatibilität betrifft in erster Linie Fragen des +Umbruchs. Neue Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind +auch dann verfügbar, wenn man per Option die Kompatibilität zu einer älteren +Version ausgewählt hat. Die Option hat keine Auswirkungen auf +Umbruchänderungen, die bei Verwendung einer neueren Version durch Beseitigung eindeutiger Fehler entstehen. Wer\textnote{Tipp!} auch im Fehlerfall -unbedingte Umbruchkompatibilität benötigt, sollte stattdessen mit dem Dokument +unbedingte Umbruchkompatibilität benötigt, sollte stattdessen mit dem Dokument auch die verwendete \KOMAScript-Version archivieren. \IfThisCommonLabelBase{scrlttr2}{\begin{Example} - Die Beispielbriefe dieses Kapitels sollen alle Möglichkeiten nutzen, die in - der neusten Version von \KOMAScript{} zur Verfügung stehen. Dazu muss beim - Laden der Klasse die Kompatibilität entsprechend gesetzt werden:% + Die Beispielbriefe dieses Kapitels sollen alle Möglichkeiten nutzen, die in + der neusten Version von \KOMAScript{} zur Verfügung stehen. Dazu muss beim + Laden der Klasse die Kompatibilität entsprechend gesetzt werden:% \lstinputcode[xleftmargin=1em,lastline=1]{letter-0.tex}% \iftrue% Umbruchkorrektur Hier wurde einfach mit dem symbolischen Wert \PValue{last} die neuste - Version gewählt.% + Version gewählt.% \else% Um nicht bei jeder neuen Version eine neue Versionsnummer angeben zu - müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last} - gewählt.% + müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last} + gewählt.% \fi \end{Example}}{} @@ -179,11 +179,11 @@ dem Laden % \IfThisCommonLabelBase{scrextend}{\Package{scrextend}}{% \InternalCommonFileUsageError }% }% -} nicht mehr verändert werden kann. Das Setzen mit +} nicht mehr verändert werden kann. Das Setzen mit \DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} oder \DescRef{\ThisCommonLabelBase.cmd.KOMAoption} ist % Umbruchkorrektur!!!! -\IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2,typearea}{für diese Option }{}% +\IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2,typearea}{für diese Option }{}% daher nicht vorgesehen.% % \EndIndexGroup @@ -196,6 +196,6 @@ daher nicht vorgesehen.% %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-dictum.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-dictum.tex index 22299b0e5d..85915257c7 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-dictum.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-dictum.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-dictum.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-dictum.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-dictum.tex} - [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] @@ -60,7 +60,7 @@ \BeginIndex{}{Redewendung}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.dictum} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.dictum} geschrieben wurde. % \IfThisCommonLabelBase{scrextend}{% Allerdings werden von \Package{scrextend} die Anweisungen @@ -72,18 +72,18 @@ \fi% }{}% Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.dictum} bereits - gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf + gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf \autopageref{sec:\ThisCommonLabelBase.dictum.next} mit \autoref{sec:\ThisCommonLabelBase.dictum.next} fortfahren.% } \IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturvarianten - Ein häufiger anzutreffendes Element ist eine Redewendung oder Zitat, das - rechtsbündig unter oder über einer Überschrift gesetzt wird. Dabei werden + Ein häufiger anzutreffendes Element ist eine Redewendung oder Zitat, das + rechtsbündig unter oder über einer Ãœberschrift gesetzt wird. Dabei werden der Spruch selbst und der Quellennachweis in der Regel speziell formatiert.% }{% - Ein häufiger anzutreffendes Element sind Zitate oder eine Redewendungen, die - mit Quellenangabe und eigener Formatierung unter oder über einer Überschrift + Ein häufiger anzutreffendes Element sind Zitate oder eine Redewendungen, die + mit Quellenangabe und eigener Formatierung unter oder über einer Ãœberschrift gesetzt werden.% } @@ -98,7 +98,7 @@ \end{Declaration}% Ein solcher Spruch kann mit Hilfe der Anweisung \Macro{dictum} gesetzt werden. \IfThisCommonLabelBase{maincls}{% - Bei\textnote{Tipp!} \KOMAScript-Klassen wird für Kapitel oder Teile + Bei\textnote{Tipp!} \KOMAScript-Klassen wird für Kapitel oder Teile empfohlen, \Macro{dictum} als obligatorisches Argument der Anweisung \DescRef{maincls.cmd.setchapterpreamble} beziehungsweise \DescRef{maincls.cmd.setpartpreamble} (siehe @@ -110,13 +110,13 @@ Der Spruch wird\IfThisCommonLabelBase{scrextend}{ hierzu}{} zusammen mit einem optional anzugebenden \PName{Urheber} in einer \Macro{parbox}\IndexCmd{parbox} (siehe \cite{latex:usrguide}) der Breite \Macro{dictumwidth}\important{\Macro{dictumwidth}} gesetzt. Dabei ist -\Macro{dictumwidth} keine Länge, die mit \Macro{setlength} gesetzt wird. Es +\Macro{dictumwidth} keine Länge, die mit \Macro{setlength} gesetzt wird. Es handelt sich um ein Makro, das mit \Macro{renewcommand} umdefiniert werden kann. Vordefiniert ist \PValue{0.3333\Length{textwidth}}, also ein Drittel der jeweiligen Textbreite. Die Box selbst wird mit der Anweisung \Macro{raggeddictum}\important{\Macro{raggeddictum}} ausgerichtet. Voreingestellt ist dabei -\Macro{raggedleft}\IndexCmd{raggedleft}, also rechtsbündig. +\Macro{raggedleft}\IndexCmd{raggedleft}, also rechtsbündig. \Macro{raggeddictum} kann mit \IfThisCommonLabelBase{scrextend}{% Umbruchoptimierung }{Hilfe von }\Macro{renewcommand} umdefiniert werden. @@ -124,18 +124,18 @@ ausgerichtet. Voreingestellt ist dabei Innerhalb der Box wird der \PName{Spruch} mit \Macro{raggeddictumtext}\important{\Macro{raggeddictumtext}} angeordnet. Voreingestellt ist hier \Macro{raggedright}\IndexCmd{raggedright}, -also linksbündig. Eine Umdefinierung ist auch hier mit \Macro{renewcommand} -möglich. % +also linksbündig. Eine Umdefinierung ist auch hier mit \Macro{renewcommand} +möglich. % \BeginIndexGroup \BeginIndex{FontElement}{dictum}\LabelFontElement{dictum}% \LabelFontElement{dictumtext}% -Die Ausgabe erfolgt in der für Element +Die Ausgabe erfolgt in der für Element \FontElement{dictum}\important{\FontElement{dictum}} eingestellten Schriftart, die mit den Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) geändert werden kann. Die +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) geändert werden kann. Die Voreinstellung entnehmen Sie bitte \autoref{tab:\ThisCommonFirstLabelBase.dictumfont}% \IfThisCommonFirstRun{.% @@ -145,10 +145,10 @@ Voreinstellung entnehmen Sie bitte \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside} - [{Schriftvoreinstellungen für die Elemente des + [{Schriftvoreinstellungen für die Elemente des Spruchs}] {\label{tab:\ThisCommonLabelBase.dictumfont}\hspace{0pt plus 1ex}% - Voreinstel\-lungen der Schrift für die Elemente des Spruchs} + Voreinstel\-lungen der Schrift für die Elemente des Spruchs} [l] \begin{tabular}[t]{ll} \toprule @@ -167,7 +167,7 @@ Voreinstellung entnehmen Sie bitte }% \EndIndexGroup -Ist ein \PName{Urheber} angegeben, so wird dieser mit einer Linie über die +Ist ein \PName{Urheber} angegeben, so wird dieser mit einer Linie über die gesamte Breite der \Macro{parbox} vom \PName{Spruch} abgetrennt. Diese% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and @@ -185,7 +185,7 @@ handelt sich dabei um ein vertikales Objekt, das mit vordefiniert ist. Mit \Macro{raggeddictumauthor}\important{\Macro{raggeddictumauthor}} wird die -Ausrichtung für die Linie und den Urheber vorgenommen. Voreingestellt ist +Ausrichtung für die Linie und den Urheber vorgenommen. Voreingestellt ist \Macro{raggedleft}. Auch diese Anweisung kann mit \Macro{renewcommand} umdefiniert werden. Die Ausgabe erfolgt in der Form, die mit \Macro{dictumauthorformat}\important{\Macro{dictumauthorformat}} festgelegt @@ -197,18 +197,18 @@ Voreinstellung ist \Macro{dictumauthorformat} mit definiert. Der \PName{Urheber} wird also in runde Klammern gesetzt. % \BeginIndexGroup \BeginIndex{FontElement}{dictumauthor}\LabelFontElement{dictumauthor}% -Für das Element +Für das Element \FontElement{dictumauthor}\important{\FontElement{dictumauthor}} kann dabei eine Abweichung der Schrift von der des Elementes \FontElement{dictum}% \IndexFontElement{dictum}% \important{\FontElement{dictum}} definiert werden. Die Voreinstellung entnehmen Sie bitte -\autoref{tab:maincls.dictumfont}. Eine Änderung ist mit Hilfe der Anweisungen +\autoref{tab:maincls.dictumfont}. Eine Änderung ist mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) möglich.% +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) möglich.% \EndIndexGroup \IfThisCommonLabelBase{maincls}{% @@ -220,31 +220,31 @@ werden. Die Voreinstellung entnehmen Sie bitte beachten:\textnote{Achtung!} Die horizontale Anordnung erfolgt immer mit \Macro{raggeddictum}. Das optionale Argument zur horizontalen Anordnung, das die beiden Anweisungen vorsehen, bleibt daher ohne - Wirkung. \Length{textwidth} ist nicht die Breite des gesamten Textkörpers, + Wirkung. \Length{textwidth} ist nicht die Breite des gesamten Textkörpers, sondern wie bei \Environment{minipage} die aktuelle Textbreite. Ist also die Breite \Macro{dictumwidth} als \PValue{.5\Length{textwidth}} definiert und bei \DescRef{maincls.cmd.setchapterpreamble} wird als optionales Argument - für die Breite ebenfalls \PValue{.5\Length{textwidth}} angegeben, so erfolgt + für die Breite ebenfalls \PValue{.5\Length{textwidth}} angegeben, so erfolgt die Ausgabe in einer Box, deren Breite ein Viertel der Breite des - Textkörpers ist. Es wird empfohlen\textnote{Tipp!}, bei Verwendung von + Textkörpers ist. Es wird empfohlen\textnote{Tipp!}, bei Verwendung von \Macro{dictum} auf die optionale Angabe einer Breite bei \DescRef{maincls.cmd.setchapterpreamble} oder \DescRef{maincls.cmd.setpartpreamble} zu verzichten. - Sollen\textnote{Tipp!} mehrere schlaue Sprüche untereinander gesetzt werden, - so sollten diese durch einen zusätzlichen Abstand vertikal voneinander + Sollen\textnote{Tipp!} mehrere schlaue Sprüche untereinander gesetzt werden, + so sollten diese durch einen zusätzlichen Abstand vertikal voneinander abgesetzt werden. Ein solcher kann leicht mit der Anweisung \Macro{bigskip}\IndexCmd{bigskip} gesetzt werden.% \iftrue% }{\csname iffalse\endcsname} \begin{Example} - Sie schreiben ein Kapitel über die moderne Ehe. Dabei wollen Sie in der - Präambel zur Kapitelüberschrift einen schlauen Spruch setzen. Dieser soll - unter der Überschrift erscheinen. Also schreiben Sie: + Sie schreiben ein Kapitel über die moderne Ehe. Dabei wollen Sie in der + Präambel zur Kapitelüberschrift einen schlauen Spruch setzen. Dieser soll + unter der Ãœberschrift erscheinen. Also schreiben Sie: \begin{lstcode} \setchapterpreamble[u]{% - \dictum[Schiller]{Drum prüfe, + \dictum[Schiller]{Drum prüfe, wer sich ewig bindet \dots}} \chapter{Die moderne Ehe} \end{lstcode} @@ -253,11 +253,11 @@ werden. Die Voreinstellung entnehmen Sie bitte {\usekomafont{disposition}\usekomafont{chapter}\Large 17\enskip Die moderne Ehe\raggedright\par} \vspace{\baselineskip} - \dictum[Schiller]{Drum prüfe, wer sich ewig bindet~\dots} + \dictum[Schiller]{Drum prüfe, wer sich ewig bindet~\dots} \end{ShowOutput} Wenn Sie wollen, dass nicht ein Drittel, sondern nur ein Viertel der - verfügbaren Textbreite für den Spruch verwendet wird, so definieren Sie + verfügbaren Textbreite für den Spruch verwendet wird, so definieren Sie \Macro{dictumwidth} wie folgt um: \begin{lstcode} \renewcommand*{\dictumwidth}{.25\textwidth} @@ -279,6 +279,6 @@ werden. Die Voreinstellung entnehmen Sie bitte %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-draftmode.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-draftmode.tex index 77287f36cf..88e5c9d2b2 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-draftmode.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-draftmode.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-draftmode.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-draftmode.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-draftmode.tex} - [$Date: 2018-01-30 13:37:05 +0100 (Tue, 30 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: draft)] \section{Entwurfsmodus} @@ -55,23 +55,23 @@ \BeginIndex{}{Entwurf}% \IfThisCommonFirstRun{}{% - \IfThisCommonLabelBase{scrlttr2}{Für - \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}}{Es} gilt sinngemäß, was in + \IfThisCommonLabelBase{scrlttr2}{Für + \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}}{Es} gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.draft} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.draft} bereits gelesen und - verstanden haben, können Sie nach dem Ende dieses Abschnitts auf + verstanden haben, können Sie nach dem Ende dieses Abschnitts auf \autopageref{sec:\ThisCommonLabelBase.draft.next} mit \autoref{sec:\ThisCommonLabelBase.draft.next} fortfahren.\IfThisCommonLabelBase{scrlttr2}{ Das Paket \Package{scrletter} - bietet selbst keinen Entwurfsmodus, sondern verlässt sich diesbezüglich + bietet selbst keinen Entwurfsmodus, sondern verlässt sich diesbezüglich auf die verwendete Klasse.}{}% } Viele Klassen und viele Pakete kennen neben dem normalen Satzmodus auch einen Entwurfsmodus. Die Unterschiede zwischen diesen beiden sind so -vielfältig wie die Klassen und Pakete, die diese Unterscheidung anbieten.% +vielfältig wie die Klassen und Pakete, die diese Unterscheidung anbieten.% \IfThisCommonLabelBase{scrextend}{% Umbruchkorrekturtext - \ So führt der Entwurfsmodus einiger Pakete auch zu Änderungen der Ausgabe, + \ So führt der Entwurfsmodus einiger Pakete auch zu Änderungen der Ausgabe, die sich auf den Umbruch des Dokuments auswirken. Das ist bei \Package{scrextend} jedoch nicht der Fall.% }{} @@ -89,14 +89,14 @@ Mit Option \Option{draft}\IfThisCommonLabelBase{maincls}{% }{}% } wird zwischen Dokumenten im Entwurfsstadium und fertigen Dokumenten\Index{Endfassung} unterschieden. Als \PName{Ein-Aus-Wert} kann -einer der Standardwerte für einfache Schalter aus +einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Bei Aktivierung der Option\important{\OptionValue{draft}{true}} werden -im Falle überlanger Zeilen am Zeilenende kleine, schwarze Kästchen -ausgegeben. Diese Kästchen erleichtern dem ungeübten Auge, Absätze ausfindig -zu machen, die manueller Nachbearbeitung bedürfen. Demgegenüber erscheinen in +im Falle überlanger Zeilen am Zeilenende kleine, schwarze Kästchen +ausgegeben. Diese Kästchen erleichtern dem ungeübten Auge, Absätze ausfindig +zu machen, die manueller Nachbearbeitung bedürfen. Demgegenüber erscheinen in der Standardeinstellung \OptionValue{draft}{false} keine solchen -Kästchen. Solche Zeilen verschwinden übrigens häufig durch Verwendung des +Kästchen. Solche Zeilen verschwinden übrigens häufig durch Verwendung des Pakets \Package{microtype}\IndexPackage{microtype}\important{\Package{microtype}} \cite{package:microtype}. @@ -112,9 +112,9 @@ Da\IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.25}{\Package{scrextend}}% }{}% }% -} Option \Option{draft} bei verschiedenen Paketen zu allerlei unerwünschten -Effekten führen kann, bietet \KOMAScript{} die Möglichkeit, die Markierung für -überlange Zeilen auch über Option +} Option \Option{draft} bei verschiedenen Paketen zu allerlei unerwünschten +Effekten führen kann, bietet \KOMAScript{} die Möglichkeit, die Markierung für +überlange Zeilen auch über Option \Option{overfullrule}\important{\OptionValue{overfullrule}{true}} zu steuern. Auch hier gilt, dass bei aktivierter Option die Markierung angezeigt wird. @@ -125,6 +125,6 @@ wird. %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-fontsize.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-fontsize.tex index 325e6c4f0e..9d07ef553d 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-fontsize.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-fontsize.tex @@ -40,139 +40,139 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-fontsize.tex} - [$Date: 2017-12-13 10:05:13 +0100 (Wed, 13 Dec 2017) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (common paragraphs: fontsize)] -\section{Wahl der Schriftgröße für das Dokument} +\section{Wahl der Schriftgröße für das Dokument} \seclabel{fontOptions} \BeginIndexGroup -\BeginIndex{}{Schrift>Groesse=Größe} +\BeginIndex{}{Schrift>Groesse=Größe} \IfThisCommonFirstRun{% - Die Grundschrift und deren Größe sind zentrale Elemente der Gestaltung eines - Dokuments. Wie in \autoref{cha:typearea} ausgeführt wurde, hängt die - Auf"|teilung zwischen Satzspiegel und Rändern wesentlich davon ab. Die - Grundschrift ist dabei die Schrift, die für die Masse des Textes eines + Die Grundschrift und deren Größe sind zentrale Elemente der Gestaltung eines + Dokuments. Wie in \autoref{cha:typearea} ausgeführt wurde, hängt die + Auf"|teilung zwischen Satzspiegel und Rändern wesentlich davon ab. Die + Grundschrift ist dabei die Schrift, die für die Masse des Textes eines Dokuments verwendet wird. Alle davon abweichenden Einstellungen, sei es in - der Form, der Dicke, der Neigung oder der Größe, stehen in einer Beziehung + der Form, der Dicke, der Neigung oder der Größe, stehen in einer Beziehung zur Grundschrift.% }{% - \IfThisCommonLabelBase{scrlttr2}{Für \Class{scrlttr2}\OnlyAt{scrlttr2}}{Es} - gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.fontOptions} + \IfThisCommonLabelBase{scrlttr2}{Für \Class{scrlttr2}\OnlyAt{scrlttr2}}{Es} + gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.fontOptions} geschrieben wurde. \IfThisCommonLabelBase{scrlttr2}{Paket - \Package{scrletter} bietet selbst hingegen keine Schriftgrößenauswahl, - sondern verlässt sich diesbezüglich vollständig auf die verwendete + \Package{scrletter} bietet selbst hingegen keine Schriftgrößenauswahl, + sondern verlässt sich diesbezüglich vollständig auf die verwendete Klasse.}{} Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.fontOptions} bereits gelesen und - verstanden haben, können Sie \IfThisCommonLabelBase{scrlttr2}{beim Beispiel + verstanden haben, können Sie \IfThisCommonLabelBase{scrlttr2}{beim Beispiel am Ende dieses Abschnitts auf \autopageref{sec:\ThisCommonLabelBase.fontOptions.end} fortfahren. Wenn - Sie dagegen \Package{scrletter} verwenden, können Sie auch }{}% + Sie dagegen \Package{scrletter} verwenden, können Sie auch }{}% direkt zu \autoref{sec:\ThisCommonLabelBase.fontOptions.next} auf \autopageref{sec:\ThisCommonLabelBase.fontOptions.next} springen.% } \begin{Declaration} - \OptionVName{fontsize}{Größe} + \OptionVName{fontsize}{Größe} \end{Declaration} -Während\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{% +Während\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{% \textnote{\KOMAScript{} vs. Standardklassen}} von den Standardklassen und -den meisten anderen Klassen nur eine sehr beschränkte Anzahl an Schriftgrößen -unterstützt wird, bietet +den meisten anderen Klassen nur eine sehr beschränkte Anzahl an Schriftgrößen +unterstützt wird, bietet \IfThisCommonLabelBase{scrlttr2}{\Class{scrlttr2}}{\KOMAScript} die -Möglichkeit, jede beliebige \PName{Größe} für die Grundschrift -anzugeben. Dabei kann als Einheit für die \PName{Größe} auch jede bekannte -\TeX-Einheit verwendet werden. Wird die \PName{Größe} ohne Einheit angegeben, +Möglichkeit, jede beliebige \PName{Größe} für die Grundschrift +anzugeben. Dabei kann als Einheit für die \PName{Größe} auch jede bekannte +\TeX-Einheit verwendet werden. Wird die \PName{Größe} ohne Einheit angegeben, so wird \PValue{pt} als Einheit angenommen. \iffree{}{Das genaue Verfahren, - nach dem die Schriftgröße dann eingestellt wird, ist für Experten und + nach dem die Schriftgröße dann eingestellt wird, ist für Experten und interessierte Anwender in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.option.fontsize} dokumentiert.} Wird die Option innerhalb des Dokuments gesetzt, so werden ab diesem Punkt die -Grundschriftgröße und die davon abhängigen Schriftgrößen der Befehle +Grundschriftgröße und die davon abhängigen Schriftgrößen der Befehle \Macro{tiny}, \Macro{scriptsize}, \Macro{footnotesize}, \Macro{small}, \Macro{normalsize}, \Macro{large}, \Macro{Large}, \Macro{LARGE}, \Macro{huge} -und \Macro{Huge} geändert. Das kann beispielsweise dann nützlich sein, wenn % +und \Macro{Huge} geändert. Das kann beispielsweise dann nützlich sein, wenn % \IfThisCommonLabelBase{scrlttr2}{ein weiterer Brief }{der Anhang }% -insgesamt in einer kleineren Schriftgröße gesetzt werden soll. +insgesamt in einer kleineren Schriftgröße gesetzt werden soll. Es wird darauf\textnote{Achtung!} hingewiesen, dass bei Verwendung nach \IfThisCommonLabelBase{scrextend}{einem eventuellen Laden von \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}% \important{\hyperref[cha:typearea]{\Package{typearea}}}}{dem Laden der - Klasse} die Auf"|teilung zwischen Satzspiegel und Rändern nicht automatisch + Klasse} die Auf"|teilung zwischen Satzspiegel und Rändern nicht automatisch neu berechnet wird (siehe \DescRef{typearea.cmd.recalctypearea}\IndexCmd{recalctypearea}, \autoref{sec:typearea.typearea}, \DescPageRef{typearea.cmd.recalctypearea}). Wird diese Neuberechnung jedoch -vorgenommen, so erfolgt sie auf Basis der jeweils gültigen -Grundschriftgröße. Die Auswirkungen des Wechsels der Grundschriftgröße auf -zusätzlich geladene Pakete oder die verwendete Klasse sind von diesen Paketen -und der Klasse abhängig. % +vorgenommen, so erfolgt sie auf Basis der jeweils gültigen +Grundschriftgröße. Die Auswirkungen des Wechsels der Grundschriftgröße auf +zusätzlich geladene Pakete oder die verwendete Klasse sind von diesen Paketen +und der Klasse abhängig. % \IfThisCommonLabelBase{maincls}{% - Es können also Fehler auf"|treten, die nicht als Fehler von \KOMAScript{} + Es können also Fehler auf"|treten, die nicht als Fehler von \KOMAScript{} angesehen werden, und auch die \KOMAScript-Klassen selbst passen nicht alle - Längen an eine nach dem Laden der Klasse vorgenommene Änderung der - Grundschriftgröße an.% + Längen an eine nach dem Laden der Klasse vorgenommene Änderung der + Grundschriftgröße an.% }{% \IfThisCommonLabelBase{scrlttr2}{% - Dabei sind Fehler möglich, die nicht als Fehler von \KOMAScript{} + Dabei sind Fehler möglich, die nicht als Fehler von \KOMAScript{} betrachtet werden, und auch die Klasse \Class{scrlttr2} selbst passt nicht - alle Längen an eine nach dem Laden der Klasse vorgenommene Änderung der - Grundschriftgröße an.% + alle Längen an eine nach dem Laden der Klasse vorgenommene Änderung der + Grundschriftgröße an.% }{% - Es können also Fehler auf"|treten, die nicht als Fehler von \KOMAScript{} + Es können also Fehler auf"|treten, die nicht als Fehler von \KOMAScript{} angesehen werden.% }% }% -Diese\textnote{Achtung!} Option sollte keinesfalls als Ersatz für +Diese\textnote{Achtung!} Option sollte keinesfalls als Ersatz für \Macro{fontsize} (siehe \cite{latex:fntguide}) missverstanden werden. Sie -sollte auch nicht anstelle einer der von der Grundschrift abhängigen -Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden! +sollte auch nicht anstelle einer der von der Grundschrift abhängigen +Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden! \IfThisCommonLabelBase{scrlttr2}{% Bei \Class{scrlttr2} ist \OptionValue{fontsize}{12pt} voreingestellt. \begin{Example} \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}% Angenommen, bei dem Verein aus dem Beispielbrief handelt es sich um die - \emph{»Freunde ungesunder Schriftgrößen«}, weshalb er in 14\Unit{pt} statt - in 12\Unit{pt} gesetzt werden soll. Dies kann durch eine kleine Änderung + \emph{»Freunde ungesunder Schriftgrößen«}, weshalb er in 14\Unit{pt} statt + in 12\Unit{pt} gesetzt werden soll. Dies kann durch eine kleine Änderung der ersten Zeile erreicht werden:% \lstinputcode[xleftmargin=1em]{letter-6}% - Alternativ könnte die Option auch als optionales Argument von + Alternativ könnte die Option auch als optionales Argument von \DescRef{\LabelBase.env.letter} gesetzt werden: \lstinputcode[xleftmargin=1em]{letter-5}% - Da bei dieser späten Änderung der Schriftgröße der Satzspiegel nicht - geändert wird, unterscheiden sich die beiden Ergebnisse in + Da bei dieser späten Änderung der Schriftgröße der Satzspiegel nicht + geändert wird, unterscheiden sich die beiden Ergebnisse in \autoref{fig:scrlttr2.letter-5-6}. \begin{figure} \centering % \setcapindent{0pt} % \begin{captionbeside}[{Beispiel: Brief mit Anschrift, Anrede, Text, -% Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer +% Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer % Schrift}]{Ergebnis eines kleinen Briefes mit Anschrift, Anrede, Text, -% Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer -% Schrift (Datum und Faltmarken entstammen den Voreinstellungen für -% DIN-Briefe); links wurde die Schriftgröße als optionales Argument von +% Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer +% Schrift (Datum und Faltmarken entstammen den Voreinstellungen für +% DIN-Briefe); links wurde die Schriftgröße als optionales Argument von % \DescRef{\LabelBase.env.letter} gesetzt, rechts als optionales Argument von % \Macro{documentclass}}[l] \frame{\includegraphics[width=.4\textwidth]{letter-5}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-6}} % \end{captionbeside} \caption[{Beispiel: Brief mit Anschrift, Anrede, Text, - Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund - großer Schrift}] + Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund + großer Schrift}] {Ergebnis eines kleinen Briefes mit Anschrift, Anrede, Text, - Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer - Schrift (Datum und Faltmarken entstammen den Voreinstellungen für - DIN-Briefe); links wurde die Schriftgröße als optionales Argument von + Grußfloskel, Postskriptum, Anlagen, Verteiler und ungesund großer + Schrift (Datum und Faltmarken entstammen den Voreinstellungen für + DIN-Briefe); links wurde die Schriftgröße als optionales Argument von \DescRef{\LabelBase.env.letter} gesetzt, rechts als optionales Argument von \DescRef{\LabelBase.cmd.documentclass}} \label{fig:scrlttr2.letter-5-6} @@ -184,7 +184,7 @@ Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden! \phantomsection\label{sec:\ThisCommonLabelBase.fontOptions.end}% Voreingestellt ist bei \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} \OptionValue{fontsize}{11pt}.\textnote{\KOMAScript{} - vs. Standardklassen} Demgegenüber ist übrigens bei den Standardklassen + vs. Standardklassen} Demgegenüber ist übrigens bei den Standardklassen \Option{10pt} voreingestellt. Dies ist bei einem Wechsel von den Standardklassen zu den \KOMAScript-Klassen\iffree{}{ oder bei Verwendung von Option \DescRef{maincls-experts.option.emulatestandardclasses}% @@ -197,6 +197,6 @@ Schriftgrößenanweisungen, \Macro{tiny} bis \Macro{Huge}, verwendet werden! %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-footnotes.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-footnotes.tex index 0b0335d39c..4300665762 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-footnotes.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-footnotes.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-footnotes.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-footnotes.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,29 +40,29 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-footnotes.tex}% - [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] -\section{Fußnoten} +\section{Fußnoten} \seclabel{footnotes}% \BeginIndexGroup -\BeginIndex{}{Fussnoten=Fußnoten}% +\BeginIndex{}{Fussnoten=Fußnoten}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.footnotes} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.footnotes} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.footnotes} bereits gelesen und - verstanden haben, können Sie auf + verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.footnotes.next} mit \autopageref{sec:\ThisCommonLabelBase.footnotes.next} fortfahren.% \IfThisCommonLabelBase{scrlttr2}{ % - Wird keine \KOMAScript-Klasse verwendet, stützt sich + Wird keine \KOMAScript-Klasse verwendet, stützt sich \Package{scrletter}\OnlyAt{\Package{scrletter}} auf das Paket \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}% \important{\hyperref[cha:scrextend]{\Package{scrextend}}}. Siehe daher bei @@ -73,7 +73,7 @@ \ Beachten Sie insbesondere, dass in diesem Fall einige \KOMAScript-typische Erweiterungen in der Voreinstellung\textnote{Voreinstellung} nicht aktiv sind. Stattdessen - gelten in der Voreinstellung die Fußnotenmöglichkeiten der verwendeten + gelten in der Voreinstellung die Fußnotenmöglichkeiten der verwendeten Klasse oder des \LaTeX-Kerns.% \fi% }{}% @@ -81,39 +81,39 @@ \IfThisCommonLabelBase{maincls}{% Im\textnote{\KOMAScript{} vs. Standardklassen} Unterschied zu den - Standardklassen bietet \KOMAScript{} die Möglichkeit, die Form von Fußnoten - in vielfältiger Weise zu konfigurieren.% + Standardklassen bietet \KOMAScript{} die Möglichkeit, die Form von Fußnoten + in vielfältiger Weise zu konfigurieren.% }{% \IfThisCommonLabelBase{scrlttr2}{% - Die Anweisungen zum Setzen von Fußnoten sind in jeder \LaTeX-Einführung, + Die Anweisungen zum Setzen von Fußnoten sind in jeder \LaTeX-Einführung, beispielsweise \cite{l2kurz}, zu finden. \KOMAScript{}\textnote{\KOMAScript{} vs. Standardklassen} bietet - darüber hinaus aber auch noch die Möglichkeit, die Form der Fußnoten zu - verändern. % + darüber hinaus aber auch noch die Möglichkeit, die Form der Fußnoten zu + verändern. % \iffalse % Umbruchoptimierung - Ob Fußnoten bei Briefen überhaupt zulässig sind, hängt sehr stark von + Ob Fußnoten bei Briefen überhaupt zulässig sind, hängt sehr stark von der Art des Briefs und dessen Layout ab. So sind beispielsweise optische - Kollisionen mit dem Fuß des Briefbogens oder Verwechslungen mit der - Auf"|listung von Verteilern oder ähnlichen typischen Elementen von + Kollisionen mit dem Fuß des Briefbogens oder Verwechslungen mit der + Auf"|listung von Verteilern oder ähnlichen typischen Elementen von Briefen zu vermeiden. Dies liegt in der Verantwortung des Anwenders.% - Da Fußnoten in Briefen eher selten verwendet werden, wurde auf Beispiele - in diesem Abschnitt verzichtet. Sollten Sie Beispiele benötigen, können + Da Fußnoten in Briefen eher selten verwendet werden, wurde auf Beispiele + in diesem Abschnitt verzichtet. Sollten Sie Beispiele benötigen, können Sie solche in \autoref{sec:\ThisCommonFirstLabelBase.footnotes} ab \autopageref{sec:\ThisCommonFirstLabelBase.footnotes} finden.% \fi% }{% \IfThisCommonLabelBase{scrextend}{% - Die Fußnoten-Möglichkeiten der \KOMAScript-Klassen werden von + Die Fußnoten-Möglichkeiten der \KOMAScript-Klassen werden von \Package{scrextend} ebenfalls bereitgestellt. In der Voreinstellung wird - die Formatierung der Fußnoten jedoch der verwendeten Klasse - überlassen. Dies ändert sich, sobald die Anweisung + die Formatierung der Fußnoten jedoch der verwendeten Klasse + überlassen. Dies ändert sich, sobald die Anweisung \DescRef{\ThisCommonLabelBase.cmd.deffootnote} verwendet wird, die auf - \DescPageRef{\ThisCommonLabelBase.cmd.deffootnote} näher erläutert + \DescPageRef{\ThisCommonLabelBase.cmd.deffootnote} näher erläutert wird. - Die Einstellmöglichkeiten für die Trennlinie über den Fußnoten werden + Die Einstellmöglichkeiten für die Trennlinie über den Fußnoten werden hingegen von \Package{scrextend} nicht bereitgestellt.% }{\InternalCommonFileUsageError}% }% @@ -124,8 +124,8 @@ \OptionVName{footnotes}{Einstellung} \Macro{multfootsep} \end{Declaration} -\IfThisCommonLabelBase{scrextend}{Bei vielen Klassen werden Fußnoten }{% - Fußnoten % +\IfThisCommonLabelBase{scrextend}{Bei vielen Klassen werden Fußnoten }{% + Fußnoten % \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% @@ -139,13 +139,13 @@ im Text in der Voreinstellung\textnote{Voreinstellung} mit kleinen, hochgestellten Ziffern markiert. Werden in der Voreinstellung\important{\OptionValue{footnotes}{nomultiple}} -\OptionValue{footnotes}{nomultiple} zu einer Textstelle mehrere Fußnoten +\OptionValue{footnotes}{nomultiple} zu einer Textstelle mehrere Fußnoten hintereinander gesetzt, so entsteht der Eindruck, dass es sich nicht um zwei -einzelne Fußnoten, sondern um eine einzige Fußnote mit hoher Nummer handele. +einzelne Fußnoten, sondern um eine einzige Fußnote mit hoher Nummer handele. Mit\important{\OptionValue{footnotes}{multiple}} \OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} werden -Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit einem +Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit einem Trennzeichen aneinander gereiht. Das in \Macro{multfootsep}\important{\Macro{multfootsep}} definierte Trennzeichen ist als @@ -158,36 +158,36 @@ werden. Der gesamte Mechanismus ist kompatibel zu \Package{footmisc}\IndexPackage{footmisc}\important{\Package{footmisc}}, Version~5.3d bis 5.5b (siehe \cite{package:footmisc}) implementiert. Er wirkt -sich sowohl auf Fußnotenmarkierungen aus, die mit +sich sowohl auf Fußnotenmarkierungen aus, die mit \DescRef{\ThisCommonLabelBase.cmd.footnote}\IndexCmd{footnote} gesetzt wurden, als auch auf solche, die direkt mit \DescRef{\ThisCommonLabelBase.cmd.footnotemark}\IndexCmd{footnotemark} ausgegeben werden. -Es ist jederzeit möglich, mit \DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} +Es ist jederzeit möglich, mit \DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} oder \DescRef{\ThisCommonLabelBase.cmd.KOMAoption} auf die Voreinstellung -\OptionValue{footnotes}{nomultiple} zurückzuschalten. Bei Problemen mit -anderen Paketen, die Einfluss auf die Fußnoten nehmen, sollte die Option +\OptionValue{footnotes}{nomultiple} zurückzuschalten. Bei Problemen mit +anderen Paketen, die Einfluss auf die Fußnoten nehmen, sollte die Option jedoch nicht verwendet und die Einstellung auch nicht innerhalb des Dokuments umgeschaltet werden. -Eine Zusammenfassung möglicher Werte für die \PName{Einstellung} von +Eine Zusammenfassung möglicher Werte für die \PName{Einstellung} von \Option{footnotes} bietet \autoref{tab:\ThisCommonFirstLabelBase.footnotes}% \IfThisCommonFirstRun{% . \begin{table} - \caption[{Mögliche Werte für Option \Option{footnotes}}]{Mögliche Werte für - Option \Option{footnotes} zur Einstellung der Fußnoten} + \caption[{Mögliche Werte für Option \Option{footnotes}}]{Mögliche Werte für + Option \Option{footnotes} zur Einstellung der Fußnoten} \label{tab:\ThisCommonLabelBase.footnotes} \begin{desctabular} \pventry{multiple}{% - Unmittelbar aufeinander folgende Fußnotenmarkierungen werden durch + Unmittelbar aufeinander folgende Fußnotenmarkierungen werden durch \DescRef{\ThisCommonLabelBase.cmd.multfootsep}\IndexCmd{multfootsep} voneinander getrennt ausgegeben.% \IndexOption{footnotes~=\textKValue{multiple}}}% \pventry{nomultiple}{% - Unmittelbar aufeinander folgende Fußnotenmarkierungen werden auch + Unmittelbar aufeinander folgende Fußnotenmarkierungen werden auch unmittelbar aufeinander folgend ausgegeben.% \IndexOption{footnotes~=\textKValue{nomultiple}}}% \end{desctabular} @@ -205,13 +205,13 @@ Eine Zusammenfassung möglicher Werte für die \PName{Einstellung} von \Macro{footnotetext}\OParameter{Nummer}\Parameter{Text} \Macro{multiplefootnoteseparator} \end{Declaration}% -Fußnoten werden bei {\KOMAScript} genau wie bei den Standardklassen mit der +Fußnoten werden bei {\KOMAScript} genau wie bei den Standardklassen mit der Anweisung \Macro{footnote} oder den paarweise zu verwendenden Anweisungen \Macro{footnotemark} und \Macro{footnotetext} erzeugt. Genau wie bei den -Standardklassen ist es möglich, dass innerhalb einer Fußnote ein -Seiten"-umbruch erfolgt. Dies geschieht in der Regel dann, wenn die zugehörige -Fußnotenmarkierung so weit unten auf der Seite gesetzt wird, dass keine andere -Wahl bleibt, als die Fußnote auf die nächste Seite zu umbrechen. Im +Standardklassen ist es möglich, dass innerhalb einer Fußnote ein +Seiten"-umbruch erfolgt. Dies geschieht in der Regel dann, wenn die zugehörige +Fußnotenmarkierung so weit unten auf der Seite gesetzt wird, dass keine andere +Wahl bleibt, als die Fußnote auf die nächste Seite zu umbrechen. Im Unterschied\textnote{\KOMAScript{} vs. Standardklassen}% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and @@ -221,62 +221,62 @@ Unterschied\textnote{\KOMAScript{} vs. Standardklassen}% \ChangedAt{v3.00}{\Class{scrlttr2}}% }{}% } % -zu den Standardklassen bietet \KOMAScript{} aber zusätzlich die Möglichkeit, -Fußnoten, die unmittelbar aufeinander folgen, automatisch zu erkennen und +zu den Standardklassen bietet \KOMAScript{} aber zusätzlich die Möglichkeit, +Fußnoten, die unmittelbar aufeinander folgen, automatisch zu erkennen und durch ein Trennzeichen auseinander zu -rücken. Siehe\important{\DescRef{\ThisCommonLabelBase.option.footnotes}} hierzu +rücken. Siehe\important{\DescRef{\ThisCommonLabelBase.option.footnotes}} hierzu die zuvor dokumentierte Option \DescRef{\ThisCommonLabelBase.option.footnotes}. -Will man dieses Trennzeichen stattdessen von Hand setzen, so erhält man es +Will man dieses Trennzeichen stattdessen von Hand setzen, so erhält man es durch Aufruf von \Macro{multiplefootnoteseparator}. Diese Anweisung sollten Anwender jedoch nicht umdefinieren, da sie neben dem Trennzeichen auch die -Formatierung des Trennzeichen, beispielsweise die Wahl der Schriftgröße und -das Hochstellen, enthält. Das Trennzeichen selbst ist in der zuvor erklärten +Formatierung des Trennzeichen, beispielsweise die Wahl der Schriftgröße und +das Hochstellen, enthält. Das Trennzeichen selbst ist in der zuvor erklärten Anweisung \DescRef{\ThisCommonLabelBase.cmd.multfootsep}% \important{\DescRef{\ThisCommonLabelBase.cmd.multfootsep}}% \IndexCmd{multfootsep} gespeichert. \IfThisCommonFirstRun{\iftrue}{% - Beispiele und ergänzende Hinweise sind + Beispiele und ergänzende Hinweise sind \autoref{sec:\ThisCommonFirstLabelBase.footnotes} ab \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.footnote} zu entnehmen.% \csname iffalse\endcsname }% \begin{Example} \phantomsection\xmpllabel{cmd.footnote}% - Angenommen, Sie wollen zu einem Wort zwei Fußnoten setzen. Im ersten - Ansatz schreiben Sie dafür + Angenommen, Sie wollen zu einem Wort zwei Fußnoten setzen. Im ersten + Ansatz schreiben Sie dafür \begin{lstcode} - Wort\footnote{Fußnote 1}\footnote{Fußnote 2}. + Wort\footnote{Fußnote 1}\footnote{Fußnote 2}. \end{lstcode} - Nehmen wir weiter an, dass die Fußnoten mit 1 und 2 nummeriert werden. Da - die beiden Fußnotennummern direkt aufeinander folgen, entsteht jedoch der - Eindruck, dass das Wort nur eine Fußnote mit der Nummer 12 besitzt. Sie - könnten dies nun dadurch ändern, dass Sie mit + Nehmen wir weiter an, dass die Fußnoten mit 1 und 2 nummeriert werden. Da + die beiden Fußnotennummern direkt aufeinander folgen, entsteht jedoch der + Eindruck, dass das Wort nur eine Fußnote mit der Nummer 12 besitzt. Sie + könnten dies nun dadurch ändern, dass Sie mit \begin{lstcode} \KOMAoptions{footnotes=multiple} \end{lstcode} - die automatische Erkennung von Fußnotenhäufungen aktivieren. Stattdessen - können Sie aber auch + die automatische Erkennung von Fußnotenhäufungen aktivieren. Stattdessen + können Sie aber auch \begin{lstcode} - Wort\footnote{Fußnote 1}% + Wort\footnote{Fußnote 1}% \multiplefootnoteseparator - \footnote{Fußnote 2} + \footnote{Fußnote 2} \end{lstcode} verwenden. Das sollte auch dann noch funktionieren, wenn die automatische - Erkennung aus irgendwelchen Gründen versagt oder nicht verwendet werden + Erkennung aus irgendwelchen Gründen versagt oder nicht verwendet werden kann. - Nehmen wir nun an, Sie wollen außerdem, dass die Fußnotennummern + Nehmen wir nun an, Sie wollen außerdem, dass die Fußnotennummern nicht nur durch ein Komma, sondern durch ein Komma, gefolgt von einem Leerzeichen getrennt werden sollen. In diesem Fall schreiben Sie \begin{lstcode} \renewcommand*{\multfootsep}{,\nobreakspace} \end{lstcode} - in Ihre Dokumentpräambel. \Macro{nobreakspace}\IndexCmd{nobreakspace} wurde - hier anstelle eines normalen Leerzeichens gewählt, damit innerhalb der - Reihung der Fußnotenzeichen kein Absatz- oder Seitenumbruch erfolgen kann. + in Ihre Dokumentpräambel. \Macro{nobreakspace}\IndexCmd{nobreakspace} wurde + hier anstelle eines normalen Leerzeichens gewählt, damit innerhalb der + Reihung der Fußnotenzeichen kein Absatz- oder Seitenumbruch erfolgen kann. \end{Example}% \fi% % @@ -295,24 +295,24 @@ Manchmal% \ChangedAt{v3.00}{\Class{scrlttr2}}% }{}% } % -hat man in einem Dokument eine Fußnote, zu der es im Text mehrere Verweise -geben soll. Die ungünstige Lösung dafür wäre die Verwendung von -\DescRef{\ThisCommonLabelBase.cmd.footnotemark} unter Angabe der gewünschten -Nummer. Ungünstig an dieser Lösung ist, dass man die Nummer kennen muss und -sich diese jederzeit ändern kann. \KOMAScript{} bietet deshalb die -Möglichkeit, den -\Macro{label}-Mechanismus\IndexCmd{label}\important{\Macro{label}} auch für -Verweise auf Fußnoten zu verwenden. Man setzt dabei in der entsprechenden -Fußnote eine \Macro{label}-Anweisung und kann dann mit \Macro{footref} alle -weiteren Fußnotenmarken für diese Fußnote im Text setzen. +hat man in einem Dokument eine Fußnote, zu der es im Text mehrere Verweise +geben soll. Die ungünstige Lösung dafür wäre die Verwendung von +\DescRef{\ThisCommonLabelBase.cmd.footnotemark} unter Angabe der gewünschten +Nummer. Ungünstig an dieser Lösung ist, dass man die Nummer kennen muss und +sich diese jederzeit ändern kann. \KOMAScript{} bietet deshalb die +Möglichkeit, den +\Macro{label}-Mechanismus\IndexCmd{label}\important{\Macro{label}} auch für +Verweise auf Fußnoten zu verwenden. Man setzt dabei in der entsprechenden +Fußnote eine \Macro{label}-Anweisung und kann dann mit \Macro{footref} alle +weiteren Fußnotenmarken für diese Fußnote im Text setzen. \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}% - % Umbruchkorrektur über diverse Varianten!!! + % Umbruchkorrektur über diverse Varianten!!! \begin{Example} \phantomsection \xmpllabel{cmd.footref}% Sie schreiben einen Text, in dem sie bei jedem Auf"|treten eines - Markennamens eine Fußnote setzen müssen, die darauf hinweist, dass es sich - um einen geschützten Markennamen handelt. Sie schreiben beispielsweise:% + Markennamens eine Fußnote setzen müssen, die darauf hinweist, dass es sich + um einen geschützten Markennamen handelt. Sie schreiben beispielsweise:% \IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname}% \begin{lstcode} Die Firma SplischSplasch\footnote{Bei diesem @@ -323,7 +323,7 @@ weiteren Fußnotenmarken für diese Fußnote im Text setzen. auch noch die verbesserte Version SplischPlatsch\footref{refnote} her. \end{lstcode} - Es wird dann dreimal eine Marke auf dieselbe Fußnote gesetzt, einmal mit + Es wird dann dreimal eine Marke auf dieselbe Fußnote gesetzt, einmal mit \DescRef{\ThisCommonLabelBase.cmd.footnote} direkt und zweimal mit \Macro{footref}. \else\iftrue @@ -336,7 +336,7 @@ weiteren Fußnotenmarken für diese Fußnote im Text setzen. auch noch die verbesserte Version SplischPlatsch\footref{refnote} her. \end{lstcode} - Es wird dann dreimal eine Marke auf dieselbe Fußnote gesetzt, einmal + Es wird dann dreimal eine Marke auf dieselbe Fußnote gesetzt, einmal mit \DescRef{\ThisCommonLabelBase.cmd.footnote} direkt und zweimal mit \Macro{footref}. \else @@ -352,16 +352,16 @@ weiteren Fußnotenmarken für diese Fußnote im Text setzen. beliebte SplischSplaschPlumps\footref{refnote} her. \end{lstcode} - Es wird dann vier Mal eine Marke auf dieselbe Fußnote gesetzt, einmal + Es wird dann vier Mal eine Marke auf dieselbe Fußnote gesetzt, einmal mit \DescRef{\ThisCommonLabelBase.cmd.footnote} direkt und drei Mal mit \Macro{footref}. \fi% \fi \end{Example} \fi -Da die Fußnotenmarken mit Hilfe des \Macro{label}-Mechanismus gesetzt werden, -werden nach Änderungen, die sich auf die Fußnotennummerierung auswirken, -gegebenenfalls zwei \LaTeX-Durchläufe benötigt, bis die mit \Macro{footref} +Da die Fußnotenmarken mit Hilfe des \Macro{label}-Mechanismus gesetzt werden, +werden nach Änderungen, die sich auf die Fußnotennummerierung auswirken, +gegebenenfalls zwei \LaTeX-Durchläufe benötigt, bis die mit \Macro{footref} gesetzten Marken korrekt sind.% \IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\par% Ein Beispiel zur Verwendung von \Macro{footref} finden Sie in @@ -372,7 +372,7 @@ gesetzten Marken korrekt sind.% \par Es\textnote{Achtung!} sei darauf hingewiesen, dass die Anweisung genau wie \Macro{ref}\IndexCmd{ref} oder \Macro{pageref}\IndexCmd{pageref} zerbrechlich - ist und deshalb in beweglichen Argumenten wie Überschriften + ist und deshalb in beweglichen Argumenten wie Ãœberschriften \Macro{protect}\IndexCmd{protect} davor gestellt werden sollte.% }% \EndIndexGroup @@ -386,18 +386,18 @@ gesetzten Marken korrekt sind.% \end{Declaration}% \IfThisCommonLabelBase{maincls}{Die \KOMAScript-Klassen setzen}{\KOMAScript{} setzt}\textnote{\KOMAScript{} vs. Standardklassen} -Fußnoten etwas anders als die Standardklassen. -Die Fußnotenmarkierung im Text, also die Referenzierung der Fußnote, erfolgt +Fußnoten etwas anders als die Standardklassen. +Die Fußnotenmarkierung im Text, also die Referenzierung der Fußnote, erfolgt wie bei den Standardklassen durch kleine hochgestellte Zahlen. Genauso werden -die Markierungen auch in der Fußnote selbst wiedergegeben. Sie werden dabei -rechtsbündig in einem Feld der Breite \PName{Markenbreite} gesetzt. Die erste -Zeile der Fußnote schließt direkt an das Feld der Markierung an. +die Markierungen auch in der Fußnote selbst wiedergegeben. Sie werden dabei +rechtsbündig in einem Feld der Breite \PName{Markenbreite} gesetzt. Die erste +Zeile der Fußnote schließt direkt an das Feld der Markierung an. Alle weiteren Zeilen werden um den Betrag von \PName{Einzug} eingezogen ausgegeben. Wird der optionale Parameter \PName{Markenbreite} nicht angegeben, -dann entspricht er dem Wert von \PName{Einzug}. Sollte die Fußnote aus -mehreren Absätzen bestehen, dann wird die erste Zeile eines Absatzes -zusätzlich mit dem Einzug der Größe \PName{Absatzeinzug} versehen. +dann entspricht er dem Wert von \PName{Einzug}. Sollte die Fußnote aus +mehreren Absätzen bestehen, dann wird die erste Zeile eines Absatzes +zusätzlich mit dem Einzug der Größe \PName{Absatzeinzug} versehen. \autoref{fig:\ThisCommonFirstLabelBase.deffootnote} % \IfThisCommonFirstRun{}{auf @@ -421,15 +421,15 @@ Definition: \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname Dabei wird mit Hilfe von \DescRef{\ThisCommonLabelBase.cmd.textsuperscript} sowohl die Hochstellung als auch die Wahl einer kleineren Schrift erreicht. Die Anweisung \Macro{thefootnotemark} liefert die aktuelle -Fußnotenmarke ohne jegliche Formatierung.% +Fußnotenmarke ohne jegliche Formatierung.% \IfThisCommonLabelBase{scrextend}{ % - Das Paket \Package{scrextend} überlässt hingegen in der Voreinstellung das - Setzen der Fußnoten der verwendeten Klasse. Das Laden des Pakets allein - sollte daher noch zu keinerlei Änderungen bei der Formatierung der Fußnoten - oder der Fußnotenmarken führen. Zur Übernahme der Voreinstellungen der + Das Paket \Package{scrextend} überlässt hingegen in der Voreinstellung das + Setzen der Fußnoten der verwendeten Klasse. Das Laden des Pakets allein + sollte daher noch zu keinerlei Änderungen bei der Formatierung der Fußnoten + oder der Fußnotenmarken führen. Zur Ãœbernahme der Voreinstellungen der \KOMAScript-Klassen muss man vielmehr obige Einstellung selbst - vornehmen. Dazu können obige Code-Zeilen beispielsweise unmittelbar nach dem - Laden von \Package{scrextend} eingefügt werden.% + vornehmen. Dazu können obige Code-Zeilen beispielsweise unmittelbar nach dem + Laden von \Package{scrextend} eingefügt werden.% }{}% \IfThisCommonLabelBase{maincls}{% @@ -437,10 +437,10 @@ Fußnotenmarke ohne jegliche Formatierung.% % \centering \KOMAoption{captions}{bottombeside} \setcapindent{0pt}% - \begin{captionbeside}[{Parameter für die Darstellung der - Fußnoten}]% + \begin{captionbeside}[{Parameter für die Darstellung der + Fußnoten}]% {\label{fig:\ThisCommonLabelBase.deffootnote}\hspace{0pt plus 1ex}% - \mbox{Parameter} für die Darstellung der Fußnoten}% + \mbox{Parameter} für die Darstellung der Fußnoten}% [l] \setlength{\unitlength}{1.02mm} \begin{picture}(95,22) @@ -461,9 +461,9 @@ Fußnotenmarke ohne jegliche Formatierung.% \put(0,16.5){\framebox(14.5,4.5){\mbox{}}} % description of paragraphs \put(45,16){\makebox(0,0)[l]{% - \small\textsf{erster Absatz einer Fußnote}}} + \small\textsf{erster Absatz einer Fußnote}}} \put(45,5){\makebox(0,0)[l]{% - \small\textsf{folgender Absatz einer Fußnote}}} + \small\textsf{folgender Absatz einer Fußnote}}} % help lines \thicklines \multiput(0,0)(0,3){7}{\line(0,1){2}} @@ -495,7 +495,7 @@ Auf% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -}{} die Fußnote einschließlich der Markierung findet außerdem die für das +}{} die Fußnote einschließlich der Markierung findet außerdem die für das Element \FontElement{footnote}\important{\FontElement{footnote}} eingestellte Schriftart Anwendung. Die % Umbruchkorrekturvarianten %\IfThisCommonLabelBase{maincls}{davon abweichende }{}% @@ -504,7 +504,7 @@ Schriftart der Markierung kann % mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element \FontElement{footnotelabel}\important{\FontElement{footnotelabel}} davon abweichend eingestellt werden. Siehe hierzu auch \autoref{tab:\ThisCommonFirstLabelBase.fontelements}, @@ -512,17 +512,17 @@ abweichend eingestellt werden. Siehe hierzu auch jeweils keine Umschaltung der Schrift.% \IfThisCommonLabelBase{scrextend}{ % Die Elemente finden bei scrextend jedoch nur dann Anwendung, wenn die - Fußnoten mit diesem Paket gesetzt werden, also \Macro{deffootnote} verwendet + Fußnoten mit diesem Paket gesetzt werden, also \Macro{deffootnote} verwendet wurde.% -}{} Bitte\textnote{Achtung!} missbrauchen Sie das Element nicht für andere -Zwecke, beispielsweise zur Verwendung von Flattersatz in den Fußnoten (siehe +}{} Bitte\textnote{Achtung!} missbrauchen Sie das Element nicht für andere +Zwecke, beispielsweise zur Verwendung von Flattersatz in den Fußnoten (siehe dazu auch \DescRef{\LabelBase.cmd.raggedfootnote}, \DescPageRef{\LabelBase.cmd.raggedfootnote}). \BeginIndex{FontElement}{footnotereference}% \LabelFontElement{footnotereference}% -Die Fußnotenmarkierung im Text wird getrennt von der Markierung vor der -Fußnote definiert. Dies geschieht mit der Anweisung +Die Fußnotenmarkierung im Text wird getrennt von der Markierung vor der +Fußnote definiert. Dies geschieht mit der Anweisung \Macro{deffootnotemark}. Voreingestellt ist hier: \begin{lstcode} \deffootnotemark{\textsuperscript{\thefootnotemark}} @@ -531,16 +531,16 @@ Dabei findet% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -}{} die Schriftart für das Element +}{} die Schriftart für das Element \FontElement{footnotereference}\IndexFontElement{footnotereference}% \important{\FontElement{footnotereference}} Anwendung (siehe % \autoref{tab:\ThisCommonLabelBase.fontelements}, \autopageref{tab:\ThisCommonLabelBase.fontelements}). Die Markierungen im Text -und in der Fußnote selbst sind also identisch. Die Schriftart kann mit den +und in der Fußnote selbst sind also identisch. Die Schriftart kann mit den Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) jedoch geändert werden% +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) jedoch geändert werden% \IfThisCommonLabelBase{scrextend}{, sobald die Anweisung \DescRef{\ThisCommonLabelBase.cmd.deffootnotemark} verwendet wird}{}. @@ -548,20 +548,20 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \begin{Example} \phantomsection \xmpllabel{cmd.deffootnote}% - Relativ\textnote{Tipp!} häufig wird gewünscht, dass die Markierung in der - Fußnote selbst weder hochgestellt noch kleiner gesetzt wird. Dabei soll - sie aber nicht direkt am Text kleben, sondern geringfügig davor + Relativ\textnote{Tipp!} häufig wird gewünscht, dass die Markierung in der + Fußnote selbst weder hochgestellt noch kleiner gesetzt wird. Dabei soll + sie aber nicht direkt am Text kleben, sondern geringfügig davor stehen. Dies kann zum einen wie folgt erreicht werden: \begin{lstcode} \deffootnote{1em}{1em}{\thefootnotemark\ } \end{lstcode} - Die Fußnotenmarkierung und das folgende Leerzeichen wird also rechtsbündig + Die Fußnotenmarkierung und das folgende Leerzeichen wird also rechtsbündig in eine Box der Breite 1\Unit{em} gesetzt. Die folgenden Zeilen der - Fußnote werden gegenüber dem linken Rand ebenfalls um 1\Unit{em} + Fußnote werden gegenüber dem linken Rand ebenfalls um 1\Unit{em} eingezogen. - Eine\textnote{Tipp!} weitere, oft gefragte Formatierung sind linksbündige - Fußnotenmarkierungen in der Fußnote. Diese können mit folgender Definition + Eine\textnote{Tipp!} weitere, oft gefragte Formatierung sind linksbündige + Fußnotenmarkierungen in der Fußnote. Diese können mit folgender Definition erhalten werden: \begin{lstcode} \deffootnote{1.5em}{1em}{% @@ -569,21 +569,21 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und } \end{lstcode} - Sollen jedoch die Fußnoten insgesamt lediglich in einer anderen + Sollen jedoch die Fußnoten insgesamt lediglich in einer anderen Schriftart, beispielsweise serifenlos gesetzt werden, so ist dies ganz einfach mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, - \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) zu lösen: + \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) zu lösen: \begin{lstcode} \setkomafont{footnote}{\sffamily} \end{lstcode}% \end{Example}% \IfThisCommonLabelBase{scrextend}{}{% - Wie die Beispiele zeigen, ermöglicht {\KOMAScript} mit dieser einfachen - Benutzerschnittstelle eine große Vielfalt unterschiedlicher - Fußnotenformatierungen.% + Wie die Beispiele zeigen, ermöglicht {\KOMAScript} mit dieser einfachen + Benutzerschnittstelle eine große Vielfalt unterschiedlicher + Fußnotenformatierungen.% }% \fi% \IfThisCommonFirstRun{}{% @@ -597,9 +597,9 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname} \begin{Declaration} - \Macro{setfootnoterule}\OParameter{Höhe}\Parameter{Länge}% + \Macro{setfootnoterule}\OParameter{Höhe}\Parameter{Länge}% \end{Declaration}% -Üblicherweise% +Ãœblicherweise% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% @@ -612,15 +612,15 @@ Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und }{}% }% } % -wird zwischen dem Textbereich und dem Fußnotenapparat eine Trennlinie gesetzt, -die jedoch normalerweise nicht über die gesamte Breite des Satzspiegels -geht. Mit Hilfe dieser Anweisung kann die genaue Länge und die Höhe oder Dicke -der Linie bestimmt werden. Dabei werden \PName{Höhe} und \PName{Länge} erst -beim Setzen der Linie selbst abhängig von \Macro{normalsize} ausgewertet. Der -optionale Parameter \PName{Höhe} kann komplett entfallen und wird dann nicht -geändert. Ist das Argument \PName{Höhe} oder \PName{Länge} leer, so wird die -jeweilige Größe ebenfalls nicht geändert. Es gibt sowohl beim Setzen als auch -bei Verwendung der Größen für unplausible Werte eine Warnung. +wird zwischen dem Textbereich und dem Fußnotenapparat eine Trennlinie gesetzt, +die jedoch normalerweise nicht über die gesamte Breite des Satzspiegels +geht. Mit Hilfe dieser Anweisung kann die genaue Länge und die Höhe oder Dicke +der Linie bestimmt werden. Dabei werden \PName{Höhe} und \PName{Länge} erst +beim Setzen der Linie selbst abhängig von \Macro{normalsize} ausgewertet. Der +optionale Parameter \PName{Höhe} kann komplett entfallen und wird dann nicht +geändert. Ist das Argument \PName{Höhe} oder \PName{Länge} leer, so wird die +jeweilige Größe ebenfalls nicht geändert. Es gibt sowohl beim Setzen als auch +bei Verwendung der Größen für unplausible Werte eine Warnung. \BeginIndexGroup \BeginIndex{FontElement}{footnoterule}\LabelFontElement{footnoterule}% @@ -637,14 +637,14 @@ Die Farbe% }{}% }% } % -der Linie kann über das Element +der Linie kann über das Element \FontElement{footnoterule}\important{\FontElement{footnoterule}} mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) eingestellt -werden. Voreingestellt ist hierbei keinerlei Änderung von Schrift oder -Farbe. Um die Farbe ändern zu können, muss außerdem ein Farbpaket wie +werden. Voreingestellt ist hierbei keinerlei Änderung von Schrift oder +Farbe. Um die Farbe ändern zu können, muss außerdem ein Farbpaket wie \Package{xcolor}\IndexPackage{xcolor}\important{\Package{xcolor}} geladen sein.% \EndIndexGroup @@ -667,17 +667,17 @@ In% }{}% }% } % -der Voreinstellung werden die Fußnoten bei \KOMAScript{} genau wie bei den +der Voreinstellung werden die Fußnoten bei \KOMAScript{} genau wie bei den Standardklassen im Blocksatz gesetzt. Es\textnote{\KOMAScript{} - vs. Standardklassen} ist aber auch möglich die Formatierung abweichend vom -restlichen Dokument zu ändern. Dazu ist \Macro{raggedfootnote} -umzudefinieren. Gültige Definitionen wären + vs. Standardklassen} ist aber auch möglich die Formatierung abweichend vom +restlichen Dokument zu ändern. Dazu ist \Macro{raggedfootnote} +umzudefinieren. Gültige Definitionen wären \Macro{raggedright}\IndexCmd{raggedright}, \Macro{raggedleft}\IndexCmd{raggedleft}, \Macro{centering}\IndexCmd{centering}, \Macro{relax}\IndexCmd{relax} oder entsprechend der Voreinstellung eine leere Definition. Auch die Ausrichtungsbefehle des Pakets \Package{ragged2e}\IndexPackage{ragged2e} sind -zulässig (siehe \cite{package:ragged2e}). +zulässig (siehe \cite{package:ragged2e}). \IfThisCommonLabelBase{scrextend}{% Ein passendes Beispiel ist in \autoref{sec:\ThisCommonFirstLabelBase.footnotes}, @@ -686,13 +686,13 @@ zulässig (siehe \cite{package:ragged2e}). }{\csname iftrue\endcsname}% \begin{Example} \phantomsection\xmpllabel{cmd.raggedfootnote}% - Angenommen Sie verwenden Fußnoten ausschließlich, um Hinweise auf sehr lange + Angenommen Sie verwenden Fußnoten ausschließlich, um Hinweise auf sehr lange Links anzugeben, deren Umbruch im Blocksatz zu schlechten Ergebnissen - führen. Dann könnten Sie in der Dokumentpräambel mit + führen. Dann könnten Sie in der Dokumentpräambel mit \begin{lstcode} \let\raggedfootnote\raggedright \end{lstcode} - für die Fußnoten einfach auf linksbündigen Flattersatz umschalten. + für die Fußnoten einfach auf linksbündigen Flattersatz umschalten. \end{Example}% \fi \EndIndexGroup @@ -703,11 +703,11 @@ zulässig (siehe \cite{package:ragged2e}). %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: -% LocalWords: Fußnotennummern Fußnotenmarkierung Satzspiegels -% LocalWords: Standardklassen Fußnotenformatierungen Dokumentpräambel -% LocalWords: Fußnotenmöglichkeiten +% LocalWords: Fußnotennummern Fußnotenmarkierung Satzspiegels +% LocalWords: Standardklassen Fußnotenformatierungen Dokumentpräambel +% LocalWords: Fußnotenmöglichkeiten diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-headfootheight.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-headfootheight.tex index 75c18a8250..0c51854945 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-headfootheight.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-headfootheight.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-headfootheight.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % 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-headfootheight.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,56 +40,56 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{common-headfootheight.tex} - [$Date: 2018-01-16 11:41:41 +0100 (Tue, 16 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraph: Head and Foot Height)] -\section{Höhe von Kopf und Fuß} +\section{Höhe von Kopf und Fuß} \seclabel{height} \BeginIndexGroup -\BeginIndex{}{Kopf>Hoehe=Höhe}% -\BeginIndex{}{Fuss=Fuß>Hoehe=Höhe}% +\BeginIndex{}{Kopf>Hoehe=Höhe}% +\BeginIndex{}{Fuss=Fuß>Hoehe=Höhe}% \IfThisCommonLabelBase{scrlayer-scrpage}{% \begin{Explain}% - Vermutlich, weil der Fuß bei den Standardklassen kaum besetzt ist und + 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 + 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 + 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. + 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.% + \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}% }{% - \iffree{Der }{}Kopf und \iffree{der }{}Fuß einer Seite sind zentrale + \iffree{Der }{}Kopf und \iffree{der }{}Fuß einer Seite sind zentrale Elemente nicht nur des Seitenstils. \iffree{Auch eine Ebene kann bei der - Definition über entsprechende Optionen genau darauf beschränkt werden + Definition über entsprechende Optionen genau darauf beschränkt werden (siehe \autoref{tab:scrlayer.layerkeys} ab - \autopageref{tab:scrlayer.layerkeys}). }{}Deshalb muss die Höhe beider + \autopageref{tab:scrlayer.layerkeys}). }{}Deshalb muss die Höhe beider Elemente bekannt sein.% } \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.height} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.height} - bereits gelesen und verstanden haben, können Sie auf + bereits gelesen und verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.height.next} mit \autoref{sec:\ThisCommonLabelBase.height.next} fortfahren.% } @@ -102,57 +102,57 @@ \OptionVName{autoenlargeheadfoot}{Ein-Aus-Wert}% }{}% \end{Declaration} -Das Paket \Package{scrlayer} führt als neue Länge \Length{footheight} analog -zur Höhe \Length{headheight}\IfThisCommonLabelBase{scrlayer-scrpage}{}{ des +Das Paket \Package{scrlayer} führt als neue Länge \Length{footheight} analog +zur Höhe \Length{headheight}\IfThisCommonLabelBase{scrlayer-scrpage}{}{ des \LaTeX-Kerns} ein. Gleichzeitig interpretiert \Package{scrlayer\IfThisCommonLabelBase{scrlayer-scrpage}{-scrpage}{}} \Length{footskip} so, dass es den Abstand der letzten Grundlinie des -Textbereichs von der ersten Standard-Grundlinie des Fußes darstellt. Das Paket +Textbereichs von der ersten Standard-Grundlinie des Fußes darstellt. Das Paket \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}% \important{\hyperref[cha:typearea]{\Package{typearea}}} betrachtet dies in -gleicher Weise, so dass die dortigen Optionen zum Setzen der Höhe des Fußes +gleicher Weise, so dass die dortigen Optionen zum Setzen der Höhe des Fußes (siehe die Optionen \DescRef{typearea.option.footheight} und \DescRef{typearea.option.footlines} in \autoref{sec:typearea.typearea}, -\DescPageRef{typearea.option.footheight}) und zur Berücksichtigung des Fußes +\DescPageRef{typearea.option.footheight}) und zur Berücksichtigung des Fußes bei der Berechnung des Satzspiegels (siehe Option \DescRef{typearea.option.footinclude} in demselben Abschnitt, -\DescPageRef{typearea.option.footinclude}) sehr gut zum Setzen der Werte für -\Package{scrlayer} verwendet werden können und auch das gewünschte Ergebnis +\DescPageRef{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 \hyperref[cha:typearea]{\Package{typearea}}% \important{\hyperref[cha:typearea]{\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} Einstellmöglichkeiten.% +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} Einstellmöglichkeiten.% \IfThisCommonLabelBase{scrlayer-scrpage}{\par% - Wurde der Kopf oder der Fuß für den tatsächlich verwendeten Inhalt zu klein - gewählt, so versucht \Package{scrlayer-scrpage} in der - Voreinstellung\textnote{Voreinstellung} die Längen selbst entsprechend + Wurde der Kopf oder der Fuß für den tatsächlich verwendeten Inhalt zu klein + gewählt, so versucht \Package{scrlayer-scrpage} in der + Voreinstellung\textnote{Voreinstellung} 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. Über + 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. Ãœber Option\ChangedAt{v3.25}{\Package{scrlayer-scrpage}} - \Option{autoenlargeheadfoot} kann dieses Verhalten jedoch geändert - werden. Die Option versteht die Werte für einfache Schalter aus + \Option{autoenlargeheadfoot} kann dieses Verhalten jedoch geändert + werden. Die Option versteht die Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. In der Voreinstellung ist die Option aktiviert. Wird sie deaktiviert, so werden - Kopf und Fuß nicht mehr automatisch vergrößert, sondern nur noch eine - Warnung mit Hinweisen für passende Einstellungen ausgegeben.% + Kopf und Fuß nicht mehr automatisch vergrößert, sondern nur noch eine + Warnung mit Hinweisen für passende Einstellungen ausgegeben.% }{% \IfThisCommonLabelBase{scrlayer}{\par% - Wurde der Kopf oder Fuß für den tatsächlich verwendeten Inhalt zu klein - gewählt, so toleriert \Package{scrlayer} dies in der Regel ohne + Wurde der Kopf oder Fuß für den tatsächlich verwendeten Inhalt zu klein + gewählt, so toleriert \Package{scrlayer} dies in der Regel ohne Fehlermeldung oder Warnung. Der Kopf dehnt sich dann entsprechend seiner - Höhe in der Regel weiter nach oben, der Fuß entsprechend weiter nach unten - aus. Informationen darüber erhält man jedoch nicht automatisch. Pakete wie + Höhe in der Regel weiter nach oben, der Fuß entsprechend weiter nach unten + aus. Informationen darüber erhält man jedoch nicht automatisch. Pakete wie \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}% \IndexPackage{scrlayer-scrpage}, die auf \Package{scrlayer} aufbauen, enthalten dagegen gegebenenfalls eigene Tests, die auch zu eigenen - Aktionen führen können (siehe \DescRef{scrlayer-scrpage.length.headheight} + Aktionen führen können (siehe \DescRef{scrlayer-scrpage.length.headheight} und \DescRef{scrlayer-scrpage.length.footheight} auf \DescPageRef{scrlayer-scrpage.length.headheight}).% }{}% @@ -164,13 +164,13 @@ auch das Paket \Package{geometry} Einstellmöglichkeiten.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "scrguide.tex" %%% TeX-PDF-mode: t %%% End: % LocalWords: Seitenstilen Ebenenmodell scrpage headings myheadings plain -% LocalWords: empty scrlayer Seitenstil Rückgriffe Gliederungsnummern +% LocalWords: empty scrlayer Seitenstil Rückgriffe Gliederungsnummern % LocalWords: Standardklassen Seitenstile konsistenteren Befehlssatzes -% LocalWords: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift +% LocalWords: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-interleafpage.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-interleafpage.tex index 4e4803e936..df1e03f172 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-interleafpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-interleafpage.tex @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-interleafpage.tex} - [$Date: 2017-12-07 11:43:47 +0100 (Thu, 07 Dec 2017) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (common paragraphs)] \section{Vakatseiten} @@ -56,34 +56,34 @@ \BeginIndex{}{Seiten>Stil}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.emptypage} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.emptypage} - bereits gelesen und verstanden haben, können Sie auf + bereits gelesen und verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.emptypage.next} mit \autoref{sec:\ThisCommonLabelBase.emptypage.next} fortfahren.% } Vakatseiten sind Seiten, die beim Satz eines Dokuments absichtlich leer bleiben. Bei \LaTeX{} werden sie jedoch in der Voreinstellung mit dem aktuell -gültigen Seitenstil gesetzt. \KOMAScript{} bietet hier diverse Erweiterungen. +gültigen Seitenstil gesetzt. \KOMAScript{} bietet hier diverse Erweiterungen. -Vakatseiten findet man hauptsächlich in Büchern. Da es bei Büchern üblich ist, +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 vorherige Kapitel ebenfalls auf einer rechten Seite endet, eine leere linke -Seite eingefügt werden. Aus dieser Erklärung ergibt sich auch, dass +Seite eingefügt werden. Aus dieser Erklärung ergibt sich auch, dass 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.% + Die leeren Rückseiten im einseitigen Druck werden eher nicht als Vakatseiten + bezeichnet, obwohl sie auf Druckbögen im Ergebnis als solche erscheinen.% \fi% \IfThisCommonLabelBase{scrlttr2}{% - Vakatseiten sind bei Briefen eher unüblich. Das liegt nicht zuletzt daran, + Vakatseiten sind bei Briefen eher unüblich. Das liegt nicht zuletzt daran, dass wahrhaft doppelseitige Briefe recht selten sind, da Briefe - normalerweise nicht gebunden werden. Trotzdem unterstützt \KOMAScript{} auch - für den Fall von doppelseitigen Briefen Einstellungen für + normalerweise nicht gebunden werden. Trotzdem unterstützt \KOMAScript{} auch + für den Fall von doppelseitigen Briefen Einstellungen für Vakatseiten. Da die hier vorgestellten Anweisungen aber in Briefen kaum Verwendung finden, finden Sie hier keine Beispiele. Bei Bedarf orientieren Sie sich bitte an den Beispielen in \autoref{sec:maincls.emptypage} ab @@ -106,15 +106,15 @@ Mit Hilfe dieser Option% kann man den \PName{Seitenstil} der Vakatseite bestimmen, die bei Bedarf von den Anweisungen \DescRef{\LabelBase.cmd.cleardoublepage}, \DescRef{\LabelBase.cmd.cleardoubleoddpage} oder -\DescRef{\LabelBase.cmd.cleardoubleevenpage} eingefügt wird, um bis zur -gewünschten Seite zu umbrechen. Als \PName{Seitenstil} sind dabei alle bereits +\DescRef{\LabelBase.cmd.cleardoubleevenpage} eingefügt wird, um bis zur +gewünschten Seite zu umbrechen. Als \PName{Seitenstil} sind dabei alle bereits definierten Seitenstile (siehe \autoref{sec:\ThisCommonLabelBase.pagestyle} ab \autopageref{sec:\ThisCommonLabelBase.pagestyle} und \autoref{cha:scrlayer-scrpage} ab \autopageref{cha:scrlayer-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% +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% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% @@ -127,7 +127,7 @@ werden in der Voreinstellung\textnote{Voreinstellung} entsprechend der typografischen Gepflogenheiten Vakatseiten mit dem Seitenstil \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% \DescRef{\ThisCommonLabelBase.pagestyle.empty}}\IndexPagestyle{empty} -erzeugt, wenn man nicht Kompatibilität zu früheren \KOMAScript-Versionen +erzeugt, wenn man nicht Kompatibilität zu früheren \KOMAScript-Versionen eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}% \important{\OptionValueRef{\LabelBase}{version}{2.98c}}, \autoref{sec:\ThisCommonLabelBase.compatibilityOptions}, @@ -142,7 +142,7 @@ eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}% \begin{lstcode} \KOMAoptions{cleardoublepage=plain} \end{lstcode} - Näheres zum Seitenstil \IfThisCommonLabelBase{scrextend}{% + Näheres zum Seitenstil \IfThisCommonLabelBase{scrextend}{% \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}} ist in \IfThisCommonLabelBase{scrextend}{% @@ -154,7 +154,7 @@ eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}% \end{Example} \else \IfThisCommonLabelBase{scrextend}{% - Ein Beispiel für die Bestimmung des Seitenstils von Vakatseiten finden Sie + Ein Beispiel für die Bestimmung des Seitenstils von Vakatseiten finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.emptypage}, \PageRefxmpl{\ThisCommonFirstLabelBase.option.cleardoublepage}.% \iffalse% Umbruchvariante ohne Beispiel @@ -168,7 +168,7 @@ eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}% \begin{lstcode} \KOMAoptions{cleardoublepage=plain} \end{lstcode} - Näheres zum Seitenstil \DescRef{maincls.pagestyle.plain} ist in + Näheres zum Seitenstil \DescRef{maincls.pagestyle.plain} ist in \autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.pagestyle.plain} zu finden. @@ -197,9 +197,9 @@ eingestellt hat (siehe Option \DescRef{\ThisCommonLabelBase.option.version}% \Macro{cleardoubleevenstandardpage} \end{Declaration}% Im\textnote{Standardklassen} \LaTeX-Kern existiert die Anweisung -\Macro{clearpage}, die dafür sorgt, dass alle noch nicht ausgegebenen -Gleitumgebungen ausgegeben werden und anschließend eine neue Seite begonnen -wird. Außerdem existiert die Anweisung \Macro{cleardoublepage}, die wie +\Macro{clearpage}, die dafür sorgt, dass alle noch nicht ausgegebenen +Gleitumgebungen ausgegeben werden und anschließend eine neue Seite begonnen +wird. Außerdem existiert die Anweisung \Macro{cleardoublepage}, die wie \Macro{clearpage} arbeitet, durch die aber im doppelseitigen Layout (siehe Option \DescRef{typearea.option.twoside} in \autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.twoside}) eine neue rechte Seite begonnen @@ -216,16 +216,16 @@ Bei {\KOMAScript}\textnote{\KOMAScript} arbeitet \ChangedAt{v3.00}{\Class{scrlttr2}}% }{}% } % -genau in der soeben für die Standardklassen beschriebenen Art und Weise. Die +genau in der soeben für die Standardklassen beschriebenen Art und Weise. Die Anweisung \Macro{cleardoubleoddplainpage}% \important{\IfThisCommonLabelBase{scrextend}{% \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}} -ändert demgegenüber den Seitenstil der leeren linken Seite zusätzlich auf +ändert demgegenüber den Seitenstil der leeren linken Seite zusätzlich auf \IfThisCommonLabelBase{scrextend}{% \DescRef{maincls.pagestyle.plain}}{\DescRef{\LabelBase.pagestyle.plain}}% \IndexPagestyle{plain}, um den \IfThisCommonLabelBase{scrlttr2}{Seitenkopf}{Kolumnentitel} zu -unterdrücken. Analog dazu wird bei der Anweisung +unterdrücken. Analog dazu wird bei der Anweisung \Macro{cleardoubleoddemptypage}% \important{% \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% @@ -233,26 +233,26 @@ unterdrücken. Analog dazu wird bei der Anweisung \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% \DescRef{\LabelBase.pagestyle.empty}}\IndexPagestyle{empty} verwendet, um sowohl \IfThisCommonLabelBase{scrlttr2}{Seitenkopf als auch - Seitenfuß}{Kolumnentitel als auch Seitenzahl} auf der leeren linken Seite zu -unterdrücken. Die Seite ist damit vollständig leer. Will man für die + Seitenfuß}{Kolumnentitel als auch Seitenzahl} auf der leeren linken Seite zu +unterdrücken. Die Seite ist damit vollständig leer. Will man für die Vakatseite einen eigenen \PName{Seitenstil} vorgeben, so ist dieser als Argument von \Macro{cleardoubleoddpageusingstyle} anzugeben. Dabei kann jeder bereits definierte Seitenstil (siehe auch \autoref{cha:scrlayer-scrpage}) verwendet werden. \IfThisCommonLabelBase{scrlttr2}{}{% - Manchmal\textnote{ungerade Vakatseiten} möchte man nicht, dass Kapitel mit + Manchmal\textnote{ungerade Vakatseiten} möchte man nicht, dass Kapitel mit neuen rechten Seiten, sondern links auf einer Doppelseite beginnen. Dies widerspricht zwar dem klassischen Buchdruck, kann jedoch seine Berechtigung haben, wenn die Doppelseite am Kapitelanfang einen ganz speziellen Inhalt hat. Bei \KOMAScript{} ist deshalb die Anweisung - \Macro{cleardoubleevenstandardpage} als Äquivalent zur Anweisung + \Macro{cleardoubleevenstandardpage} als Äquivalent zur Anweisung \Macro{cleardoubleoddstandardpage} definiert, jedoch mit dem Unterschied, - dass die nächste Seite eine linke Seite ist. Entsprechendes gilt für die + dass die nächste Seite eine linke Seite ist. Entsprechendes gilt für die Anweisungen \Macro{cleardoubleevenplainpage}, \Macro{cleardoubleevenemptypage}% \IfThisCommonLabelBase{maincls}{% Umbruchoptimierungsalternative - \ und für die ein Argument erwartende Anweisung}{,} + \ und für die ein Argument erwartende Anweisung}{,} \Macro{cleardoubleevenpageusingstyle}.% } @@ -261,11 +261,11 @@ Die Arbeitsweise der Anweisungen \Macro{cleardoublestandardpage}, Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} % \IfThisCommonLabelBase{maincls}{% ist ebenso wie die Standard-Anweisung \Macro{cleardoublepage} von der in - \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.open} erklärten + \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.open} erklärten Option \DescRef{maincls.option.open}% - \IndexOption{open}\important{\DescRef{maincls.option.open}} abhängig und - entspricht je nach Einstellung einer der in den vorherigen Absätzen - erläuterten Anweisungen. + \IndexOption{open}\important{\DescRef{maincls.option.open}} abhängig und + entspricht je nach Einstellung einer der in den vorherigen Absätzen + erläuterten Anweisungen. }{% entspricht \IfThisCommonLabelBase{scrlttr2}{bei der Klasse @@ -273,42 +273,42 @@ Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} % \IfThisCommonLabelBase{scrextend}{beim Paket \Package{scrextend}}{% \InternalCommonFileUsageError}% } ebenso wie die Standard-Anweisung \Macro{cleardoublepage} den - entsprechenden, zuvor erklärten Anweisungen% + entsprechenden, zuvor erklärten Anweisungen% \IfThisCommonLabelBase{scrlttr2}{. % - Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der - Vollständigkeit definiert. Näheres zu diesen ist bei Bedarf + Die übrigen Anweisungen sind bei \Class{scrlttr2} nur aus Gründen der + Vollständigkeit definiert. Näheres zu diesen ist bei Bedarf \autoref{sec:maincls.emptypage}, \DescPageRef{maincls.cmd.cleardoublepage} zu entnehmen% }{% - \ für den Umbruch zur nächsten ungeraden Seite% + \ für den Umbruch zur nächsten ungeraden Seite% }.% }% \IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{\iffalse}{\csname iftrue\endcsname} \begin{Example} \phantomsection\xmpllabel{cmd.cleardoublepage}% - Angenommen, Sie wollen innerhalb eines Dokuments als nächstes eine - Doppelseite setzen, bei der auf der linken Seite eine Abbildung in Größe + Angenommen, Sie wollen innerhalb eines Dokuments als nächstes eine + Doppelseite setzen, bei der auf der linken Seite eine Abbildung in Größe des Satzspiegels platziert wird und rechts ein neues Kapitel beginnt. Falls das vorherige Kapitel mit einer linken Seite endet, muss - also eine Vakatseite eingefügt werden. Diese soll komplett leer - sein. Ebenso soll die linke Bildseite weder Kopf noch Fußzeile + also eine Vakatseite eingefügt werden. Diese soll komplett leer + sein. Ebenso soll die linke Bildseite weder Kopf noch Fußzeile besitzen. \iffalse% Umbruchkorrekturtext - Zunächst wird mit + Zunächst wird mit \begin{lstcode} \KOMAoptions{cleardoublepage=empty} \end{lstcode} - dafür gesorgt, dass Vakatseiten mit dem Seitenstil + dafür gesorgt, dass Vakatseiten mit dem Seitenstil \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% - \DescRef{\LabelBase.pagestyle.empty}}, also ohne Kopf- und Fußzeile + \DescRef{\LabelBase.pagestyle.empty}}, also ohne Kopf- und Fußzeile gesetzt - werden. Diese Einstellung können Sie bereits in der Dokumentpräambel - vornehmen. Die Optionen können alternativ auch als optionale Argumente von + werden. Diese Einstellung können Sie bereits in der Dokumentpräambel + vornehmen. Die Optionen können alternativ auch als optionale Argumente von \DescRef{\ThisCommonLabelBase.cmd.documentclass} angegeben werden. \fi - An der gewünschten Stelle + An der gewünschten Stelle % \IfThisCommonLabelBase{scrextend}{}{im Dokument }% Umbruchoptimierung!!! schreiben Sie daher:% mit dem Umbruchkorrekturtext oben statt daher nun: \begin{lstcode} @@ -318,28 +318,28 @@ Argument erwartenden Anweisung \Macro{cleardoublepageusingstyle} % height=\textheight,% keepaspectratio]% {bild} - \chapter{Kapitelüberschrift} + \chapter{Kapitelüberschrift} \end{lstcode} - Die erste Zeile wechselt auf die nächste linke Seite und fügt zu diesem + Die erste Zeile wechselt auf die nächste linke Seite und fügt zu diesem Zweck bei Bedarf eine komplett leere rechte Seite ein. Die zweite Zeile - sorgt dafür, dass diese linke Seite ebenfalls mit dem Seitenstil + sorgt dafür, dass diese linke Seite ebenfalls mit dem Seitenstil \IfThisCommonLabelBase{scrextend}{\DescRef{maincls.pagestyle.empty}}{% \DescRef{\LabelBase.pagestyle.empty}} gesetzt wird. Die dritte bis - sechste Zeile lädt die Bilddatei mit dem Namen \File{bild} und bringt sie - auf die gewünschte Größe, ohne sie dabei zu verzerren. Hierfür wird das - Paket \Package{graphicx}\IndexPackage{graphicx} benötigt (siehe - \cite{package:graphics}). Die letzte Zeile beginnt auf der nächsten -- + sechste Zeile lädt die Bilddatei mit dem Namen \File{bild} und bringt sie + auf die gewünschte Größe, ohne sie dabei zu verzerren. Hierfür wird das + Paket \Package{graphicx}\IndexPackage{graphicx} benötigt (siehe + \cite{package:graphics}). Die letzte Zeile beginnt auf der nächsten -- dann rechten -- Seite ein neues Kapitel. \end{Example}% \fi -Im doppelseitigen Satz führt \Macro{cleardoubleoddpage} immer zur nächsten -linken Seite, \Macro{cleardoubleevenpage} zur nächsten -rechten Seite. Eine gegebenenfalls einzufügenden Vakatseite wird mit dem -über Option \DescRef{\LabelBase.option.cleardoublepage} festgelegten +Im doppelseitigen Satz führt \Macro{cleardoubleoddpage} immer zur nächsten +linken Seite, \Macro{cleardoubleevenpage} zur nächsten +rechten Seite. Eine gegebenenfalls einzufügenden Vakatseite wird mit dem +über Option \DescRef{\LabelBase.option.cleardoublepage} festgelegten Seitenstil ausgegeben.% \IfThisCommonLabelBase{scrextend}{\par% - Ein Beispiel für die Verwendung von \Macro{cleardoubleevenemptypage} finden + Ein Beispiel für die Verwendung von \Macro{cleardoubleevenemptypage} finden Sie in \autoref{sec:maincls.emptypage}, \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.cleardoublepage}.% }{}% @@ -351,11 +351,11 @@ Seitenstil ausgegeben.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: -% LocalWords: Gleitumgebungen Seitenkopf Kolumnentitel Seitenfuß Bilddatei -% LocalWords: Satzspiegels Bildseite Dokumentpräambel Vakatseiten +% LocalWords: Gleitumgebungen Seitenkopf Kolumnentitel Seitenfuß Bilddatei +% LocalWords: Satzspiegels Bildseite Dokumentpräambel Vakatseiten % LocalWords: Vakatseite diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-lists.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-lists.tex index c907a664b7..723b115d24 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-lists.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-lists.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-lists.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-lists.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-lists.tex}% - [$Date: 2018-02-06 09:20:05 +0100 (Tue, 06 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \section{Listen} @@ -55,16 +55,16 @@ \BeginIndex{}{Listen}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.lists} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.lists} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.lists} bereits gelesen und verstanden - haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.lists.next} mit + haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.lists.next} mit \autoref{sec:\ThisCommonLabelBase.lists.next} fortfahren.% \IfThisCommonLabelBaseOneOf{scrextend,scrlttr2}{ % \IfThisCommonLabelBase{scrlttr2}{% Das Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} definiert - selbst keine Listenumgebungen, sondern überlässt diese der verwendeten - Klasse. Ist dies keine \KOMAScript-Klasse, so lädt es + selbst keine Listenumgebungen, sondern überlässt diese der verwendeten + Klasse. Ist dies keine \KOMAScript-Klasse, so lädt es \hyperref[cha:scrextend]{\Package{scrextend}}\IndexPackage{scrextend}% \important{\hyperref[cha:scrextend]{\Package{scrextend}}}.% }{} % @@ -73,28 +73,28 @@ \DescRef{\ThisCommonLabelBase.env.addmargin} und \DescRef{\ThisCommonLabelBase.env.addmargin*} definiert. Alle anderen Listenumgebungen bleiben der Verantwortung % und Kontrolle - der verwendeten Klasse überlassen.% + der verwendeten Klasse überlassen.% }{}% } \IfThisCommonLabelBase{scrextend}{}{% {\LaTeX} und die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} - bieten verschiedene Umgebungen für Listen. All diese Umgebungen bietet - {\KOMAScript} selbstverständlich auch, teilweise jedoch mit leichten - Abwandlungen oder Erweiterungen. Grundsätzlich gilt, dass Listen -- auch + bieten verschiedene Umgebungen für Listen. All diese Umgebungen bietet + {\KOMAScript} selbstverständlich auch, teilweise jedoch mit leichten + Abwandlungen oder Erweiterungen. Grundsätzlich gilt, dass Listen -- auch unterschiedlicher Art -- bis zu einer Tiefe von vier Listen geschachtelt - werden können. Eine tiefere Schachtelung wäre auch aus typografischen - Gründen kaum sinnvoll, da genau genommen schon mehr als drei Ebenen nicht - mehr überblickt werden können. Ich empfehle\textnote{Tipp!} in solchen - Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.% + werden können. Eine tiefere Schachtelung wäre auch aus typografischen + Gründen kaum sinnvoll, da genau genommen schon mehr als drei Ebenen nicht + mehr überblickt werden können. Ich empfehle\textnote{Tipp!} in solchen + Fällen, die eine große Liste in mehrere kleinere Listen aufzuteilen.% } \IfThisCommonFirstRun{}{% - Da Listen zu den Standardelementen von \LaTeX{} gehören, wurde in diesem + Da Listen zu den Standardelementen von \LaTeX{} gehören, wurde in diesem Abschnitt auf Beispiele verzichtet. Sie finden solche in \autoref{sec:\ThisCommonFirstLabelBase.lists} ab \autopageref{sec:\ThisCommonFirstLabelBase.lists} oder in jeder - \LaTeX-Einführung.% + \LaTeX-Einführung.% } @@ -116,21 +116,21 @@ \Environment{itemize}-Liste. % \iffalse % Umbruchoptimierungstext Die Benutzer einer unbeliebten Textverarbeitung nennen diese Form der Liste - auch gerne \emph{Bulletpoints}. Vermutlich können sie sich nicht vorstellen, + auch gerne \emph{Bulletpoints}. Vermutlich können sie sich nicht vorstellen, dass je nach Ebene auch ein anderes Zeichen als ein fetter Punkt zur Einleitung eines Stichpunkts verwendet werden kann. % \fi% - Bei den \KOMAScript-Klassen werden je nach Ebene folgende Aufzählungszeichen - zur Einleitung eines Listenelements verwendet: »{\labelitemi}«, - »{\labelitemii}«, »{\labelitemiii}« und »{\labelitemiv}«. Die Definition der - Zeichen für die einzelnen Ebenen sind in den Makros \Macro{labelitemi}, + Bei den \KOMAScript-Klassen werden je nach Ebene folgende Aufzählungszeichen + zur Einleitung eines Listenelements verwendet: »{\labelitemi}«, + »{\labelitemii}«, »{\labelitemiii}« und »{\labelitemiv}«. Die Definition der + Zeichen für die einzelnen Ebenen sind in den Makros \Macro{labelitemi}, \Macro{labelitemii}, \Macro{labelitemiii} und \Macro{labelitemiv} - abgelegt. Sie können diese leicht mit \Macro{renewcommand} umdefinieren. Die + abgelegt. Sie können diese leicht mit \Macro{renewcommand} umdefinieren. Die einzelnen Stichpunkte werden mit \Macro{item} eingeleitet.% \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname} \begin{Example} \phantomsection\xmpllabel{env.itemize}% - Sie haben eine einfache Aufzählung, die in mehreren Ebenen geschachtelt + Sie haben eine einfache Aufzählung, die in mehreren Ebenen geschachtelt ist. Sie schreiben beispielsweise: \begin{lstcode} \minisec{Die Fahrzeuge im Spiel} @@ -142,29 +142,29 @@ \begin{itemize} \item einmotorig \begin{itemize} - \item{düsengetrieben} + \item{düsengetrieben} \item{propellergetrieben} \end{itemize} \item zweimotorig \begin{itemize} - \item{düsengetrieben} + \item{düsengetrieben} \item{propellergetrieben} \end{itemize} \end{itemize} - \item Drehflügler + \item Drehflügler \end{itemize} - \item Motorräder + \item Motorräder \item Automobile \begin{itemize} \item Rennwagen \item Personenwagen \item Lastwagen \end{itemize} - \item Fahrräder + \item Fahrräder \end{itemize} \end{itemize} \end{lstcode} - Anschließend erhalten Sie: + Anschließend erhalten Sie: \begin{ShowOutput}[\baselineskip] \minisec{Die Fahrzeuge im Spiel} \begin{itemize} @@ -176,18 +176,18 @@ \begin{itemize} \item einmotorig \begin{itemize} - \item{düsengetrieben} + \item{düsengetrieben} \item{propellergetrieben} \end{itemize} \item zweimotorig \begin{itemize} - \item{düsengetrieben} + \item{düsengetrieben} \item{propellergetrieben} \end{itemize} \end{itemize} - \item Drehflügler + \item Drehflügler \end{itemize} - \item Motorräder + \item Motorräder % \begin{itemize} % \item historisch korrekt % \item futurisch nicht real @@ -198,7 +198,7 @@ \item Personenwagen \item Lastwagen \end{itemize} - \item Fahrräder + \item Fahrräder \end{itemize} \end{ShowOutput} \end{Example}% @@ -224,27 +224,27 @@ \Macro{labelenumiv} \end{Declaration}% \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Die nummerierte - Liste\textnote{nummerierte Liste} ist ebenfalls sehr häufig zu finden und + Liste\textnote{nummerierte Liste} ist ebenfalls sehr häufig zu finden und bereits vom {\LaTeX}-Kern vorgesehen. Die Nummerierung\Index{Nummerierung} erfolgt je nach Ebene in unterschiedlicher Art: mit arabischen Zahlen, mit - Kleinbuchstaben, mit kleinen römischen Zahlen und mit Großbuchstaben. Die - Art der Nummerierung wird dabei über die Makros \Macro{theenumi} bis + Kleinbuchstaben, mit kleinen römischen Zahlen und mit Großbuchstaben. Die + Art der Nummerierung wird dabei über die Makros \Macro{theenumi} bis \Macro{theenumiv} festgelegt. Das Format der Ausgabe wird von den Makros \Macro{labelenumi} bis \Macro{labelenumiv} bestimmt. Dabei folgt auf den Wert der zweiten Ebene, der in Kleinbuchstaben ausgegeben wird, eine runde - Klammer, während die Werte aller anderen Ebenen von einem Punkt gefolgt + Klammer, während die Werte aller anderen Ebenen von einem Punkt gefolgt werden. Die einzelnen Stichpunkte werden wieder mit \Macro{item} eingeleitet.% \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname} \begin{Example} \phantomsection\xmpllabel{env.enumerate}% - Verkürzen wir das vorherige Beispiel und verwenden statt der + Verkürzen wir das vorherige Beispiel und verwenden statt der \DescRef{\ThisCommonLabelBase.env.itemize}- eine \Environment{enumerate}-Umgebung: - % Übernehmen wir das Beispiel der + % Ãœbernehmen wir das Beispiel der % \DescRef{\LabelBase.env.itemize}-Umgebung, % wobei wir jede \DescRef{\LabelBase.env.itemize}-Umgebung durch eine - % \Environment{enumerate}-Umgebung ersetzen. Das Ergebnis wäre dann: + % \Environment{enumerate}-Umgebung ersetzen. Das Ergebnis wäre dann: \begin{ShowOutput}[\baselineskip] \minisec{Die Fahrzeuge im Spiel} \begin{enumerate} @@ -256,14 +256,14 @@ \begin{enumerate} \item einmotorig \begin{enumerate} - \item{düsengetrieben}\label{xmp:maincls.jets} + \item{düsengetrieben}\label{xmp:maincls.jets} \item{propellergetrieben} \end{enumerate} \item mehrmotorig \end{enumerate} - % \item Drehflügler + % \item Drehflügler \end{enumerate} - \item Motorräder + \item Motorräder \begin{enumerate} \item historisch korrekt \item futurisch nicht real @@ -274,14 +274,14 @@ % \item Personenwagen % \item Lastwagen % \end{enumerate} - % \item Fahrräder + % \item Fahrräder \end{enumerate} \end{ShowOutput} - Innerhalb der Aufzählung können ganz normal mit \Macro{label} Marken + Innerhalb der Aufzählung können ganz normal mit \Macro{label} Marken gesetzt werden, auf die dann mit \Macro{ref} zugegriffen werden - kann. So wurde oben hinter den düsengetriebenen, einmotorigen - Flugzeugen mit »\Macro{label}\PParameter{bsp:duesen}« ein Label - gesetzt. Der \Macro{ref}-Wert ist dann »\ref{xmp:maincls.jets}«. + kann. So wurde oben hinter den düsengetriebenen, einmotorigen + Flugzeugen mit »\Macro{label}\PParameter{bsp:duesen}« ein Label + gesetzt. Der \Macro{ref}-Wert ist dann »\ref{xmp:maincls.jets}«. \end{Example}% \fi % @@ -303,15 +303,15 @@ \BeginIndex{FontElement}{descriptionlabel}% \LabelFontElement{descriptionlabel}% Die Schriftart\Index{Schrift>Art}\ChangedAt{v2.8p}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}}, die für die Hervorhebung des - Stichworts verwendet wird, kann außerdem bei den \KOMAScript-Klassen mit + \Class{scrreprt}\and \Class{scrartcl}}, die für die Hervorhebung des + Stichworts verwendet wird, kann außerdem bei den \KOMAScript-Klassen mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, - \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element + \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element \FontElement{descriptionlabel}\important{\FontElement{descriptionlabel}} (siehe \autoref{tab:\ThisCommonLabelBase.fontelements}, - \autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. In der + \autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. In der Voreinstellung wird \Macro{sffamily}""\Macro{bfseries} verwendet.% \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname} \begin{Example} @@ -324,17 +324,17 @@ \end{lstcode} definieren Sie daher die Schrift entsprechend um. - Ein Beispiel für die Ausgabe einer Stichwortliste ist eine Aufzählung + Ein Beispiel für die Ausgabe einer Stichwortliste ist eine Aufzählung der Seitenstile. Der Quelltext dazu lautet beispielsweise: \begin{lstcode} \begin{description} \item[empty] ist der Seitenstil, bei dem Kopf- - und Fußzeile vollständig leer bleiben. + und Fußzeile vollständig leer bleiben. \item[plain] ist der Seitenstil, bei dem keinerlei Kolumnentitel verwendet wird. - \item[headings] ist der Seitenstil für + \item[headings] ist der Seitenstil für automatische Kolumnentitel. - \item[myheadings] ist der Seitenstil für + \item[myheadings] ist der Seitenstil für manuelle Kolumnentitel. \end{description} \end{lstcode} @@ -342,12 +342,12 @@ \begin{ShowOutput} \begin{description} \item[empty] ist der Seitenstil, bei dem Kopf- und - Fußzeile vollständig leer bleiben. + Fußzeile vollständig leer bleiben. \item[plain] ist der Seitenstil, bei dem keinerlei Kolumnentitel verwendet wird. - \item[headings] ist der Seitenstil für automatische + \item[headings] ist der Seitenstil für automatische Kolumnentitel. - \item[myheadings] ist der Seitenstil für manuelle + \item[myheadings] ist der Seitenstil für manuelle Kolumnentitel. \end{description} \end{ShowOutput} @@ -359,7 +359,7 @@ \begin{Declaration} \begin{Environment}{labeling}\OParameter{Trennzeichen} - \Parameter{längstes Schlüsselwort} + \Parameter{längstes Schlüsselwort} \labelsuffix[labeling] \begin{Body} \Macro{item}\OParameter{Stichwort} \dots @@ -384,8 +384,8 @@ vorhanden: die \Environment{labeling}-Umgebung. Im Unterschied \DescRef{\ThisCommonFirstLabelBase.env.description}% }{% \DescRef{\ThisCommonLabelBase.env.description}% -} kann bei \Environment{labeling} ein Muster angegeben werden, dessen Länge -die Einrücktiefe bei allen Stichpunkten ergibt. Darüber hinaus kann zwischen +} kann bei \Environment{labeling} ein Muster angegeben werden, dessen Länge +die Einrücktiefe bei allen Stichpunkten ergibt. Darüber hinaus kann zwischen Stichpunkt und Beschreibungstext ein optionales \PName{Trennzeichen} festgelegt werden. % \BeginIndexGroup @@ -405,23 +405,23 @@ Die Schriftart\Index{Schrift>Art}% }{\InternalCommonFileUsageError}% }% }% -, die für die Hervorhebung des Schlüsselworts verwendet wird, kann mit Hilfe +, die für die Hervorhebung des Schlüsselworts verwendet wird, kann mit Hilfe der Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) für das Element \FontElement{labelinglabel}\IndexFontElement{labelinglabel} (siehe \autoref{tab:\ThisCommonLabelBase.fontelements}, -\autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. Für die +\autopageref{tab:\ThisCommonLabelBase.fontelements}) geändert werden. Für die davon abweichende Schriftart der Trennzeichen ist das Element \FontElement{labelingseparator}\IndexFontElement{labelingseparator} (siehe ebenfalls \autoref{tab:\ThisCommonLabelBase.fontelements}, -\autopageref{tab:\ThisCommonLabelBase.fontelements}) zuständig. +\autopageref{tab:\ThisCommonLabelBase.fontelements}) zuständig. \IfThisCommonFirstRun{\iftrue}{\par\csname iffalse\endcsname} \begin{Example} \phantomsection\xmpllabel{env.labeling}% \IfThisCommonLabelBase{scrextend}{% - Eine einfache Liste könnte beispielsweise wie folgt definiert werden:% + Eine einfache Liste könnte beispielsweise wie folgt definiert werden:% }{% Wir schreiben das Beispiel der \DescRef{\ThisCommonLabelBase.env.description}-Umgebung etwas um:% @@ -431,14 +431,14 @@ ebenfalls \autoref{tab:\ThisCommonLabelBase.fontelements}, \setkomafont{labelingseparator}{\normalfont} \begin{labeling}[~--]{myheadings} \item[empty] - Seitenstil für leere Seiten ohne Kopf und Fuß + Seitenstil für leere Seiten ohne Kopf und Fuß \item[plain] - Seitenstil für Kapitelanfänge ganz ohne + Seitenstil für Kapitelanfänge ganz ohne Kolumnentitel \item[headings] - Seitenstil für automatische Kolumnentitel + Seitenstil für automatische Kolumnentitel \item[myheadings] - Seitenstil für manuelle Kolumnentitel + Seitenstil für manuelle Kolumnentitel \end{labeling} \end{lstcode} Als Ergebnis erhalten wir dann: @@ -447,28 +447,28 @@ ebenfalls \autoref{tab:\ThisCommonLabelBase.fontelements}, \setkomafont{labelingseparator}{\normalfont} \begin{labeling}[~--]{myheadings} \item[empty] - Seitenstil für leere Seiten ohne Kopf und Fuß + Seitenstil für leere Seiten ohne Kopf und Fuß \item[plain] - Seitenstil für Kapitelanfänge ganz ohne + Seitenstil für Kapitelanfänge ganz ohne Kolumnentitel \item[headings] - Seitenstil für automatische Kolumnentitel + Seitenstil für automatische Kolumnentitel \item[myheadings] - Seitenstil für manuelle Kolumnentitel + Seitenstil für manuelle Kolumnentitel \end{labeling} \end{ShowOutput} Wie in diesem Beispiel zu sehen ist, kann eine eventuell geforderte Schriftumschaltung in bei \KOMAScript{} gewohnter Weise erreicht - werden. Da sich die Schriftumschaltung für das Schlüsselwort aber auch auf + werden. Da sich die Schriftumschaltung für das Schlüsselwort aber auch auf die Trennzeichen auswirkt, kann es eventuell erforderlich sein, die - Schriftumschaltung dafür explizit aufzuheben. + Schriftumschaltung dafür explizit aufzuheben. \end{Example} \fi \EndIndexGroup -Gedacht war die Umgebung ursprünglich für Strukturen wie »Voraussetzung, -Aussage, Beweis« oder »Gegeben, Gesucht, Lösung«, wie man sie in -Vorlesungsskripten häufiger findet. Inzwischen findet die Umgebung aber ganz -unterschiedliche Anwendungen. So wurde die Umgebung für Beispiele in dieser +Gedacht war die Umgebung ursprünglich für Strukturen wie »Voraussetzung, +Aussage, Beweis« oder »Gegeben, Gesucht, Lösung«, wie man sie in +Vorlesungsskripten häufiger findet. Inzwischen findet die Umgebung aber ganz +unterschiedliche Anwendungen. So wurde die Umgebung für Beispiele in dieser Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \EndIndexGroup @@ -481,15 +481,15 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \Environment{verse}-Umgebung\textnote{Versform} wird normalerweise nicht als Listenumgebung wahrgenommen, da hier nicht mit \Macro{item} gearbeitet wird. Stattdessen wird wie innerhalb der \Environment{flushleft}-Umgebung - mit festen Zeilenumbrüchen gearbeitet. Intern handelt es sich jedoch sowohl + mit festen Zeilenumbrüchen gearbeitet. Intern handelt es sich jedoch sowohl bei den Standardklassen als auch bei {\KOMAScript} durchaus um eine Listenumgebung. - Die \Environment{verse}-Umgebung findet hauptsächlich für + Die \Environment{verse}-Umgebung findet hauptsächlich für Gedichte\Index{Gedichte} Anwendung. Dabei werden die Zeilen links und rechts eingezogen. Einzelne Verse werden mit einem festen Zeilenumbruch, also mit \verb|\\|\IndexCmd{\textbackslash} beendet. Strophen werden ganz normal als - Absatz gesetzt, also durch eine Leerzeile getrennt. Häufig findet + Absatz gesetzt, also durch eine Leerzeile getrennt. Häufig findet stattdessen auch \Macro{medskip}\IndexCmd{medskip} oder \Macro{bigskip}\IndexCmd{bigskip} Verwendung. Will man verhindern, dass am Ende eines Verses ein Seitenumbruch\textnote{Seitenumbruch} erfolgt, so @@ -501,9 +501,9 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% Als Beispiel ein kurzes Gedicht von Wilhelm Busch: \begin{lstcode} \begin{verse} - Wenn einer, der mit Mühe kaum\\* + Wenn einer, der mit Mühe kaum\\* Gekrochen ist auf einen Baum,\\* - Schon meint, dass er ein Vogel wär,\\* + Schon meint, dass er ein Vogel wär,\\* So irrt sich der. \end{verse} \end{lstcode} @@ -511,9 +511,9 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \begin{ShowOutput} \iffree{}{\vskip-.8\baselineskip}% Umbruchkorrektur \begin{verse} - Wenn einer, der mit Mühe kaum\\* + Wenn einer, der mit Mühe kaum\\* Gekrochen ist auf einen Baum,\\* - Schon meint, dass er ein Vogel wär,\\* + Schon meint, dass er ein Vogel wär,\\* So irrt sich der. \end{verse} \end{ShowOutput} @@ -523,7 +523,7 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% Der Philosoph wie der Hausbesitzer hat immer Reparaturen.\\* \bigskip - Wer dir sagt, er hätte noch nie gelogen, + Wer dir sagt, er hätte noch nie gelogen, dem traue nicht, mein Sohn. \end{verse} \end{lstcode} @@ -533,49 +533,49 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \begin{verse} Der Philosoph wie der Hausbesitzer hat immer Reparaturen.\\ \bigskip - Wer dir sagt, er hätte noch nie gelogen, dem traue nicht, mein + Wer dir sagt, er hätte noch nie gelogen, dem traue nicht, mein Sohn. \end{verse} \end{ShowOutput} kann mit \verb|\\*| allerdings nicht verhindert werden, dass am Zeilenumbruch auch ein Seitenumbruch erfolgt. Um dies zu erreichen, - müsste innerhalb der ersten Zeile zusätzlich ein - \Macro{nopagebreak}\IndexCmd{nopagebreak} eingefügt werden: + müsste innerhalb der ersten Zeile zusätzlich ein + \Macro{nopagebreak}\IndexCmd{nopagebreak} eingefügt werden: \begin{lstcode} \begin{verse} Der Philosoph wie der Hausbesitzer\nopagebreak{} hat immer Reparaturen.\\ \bigskip - Wer dir sagt, er hätte noch nie\nopagebreak{} + Wer dir sagt, er hätte noch nie\nopagebreak{} gelogen, dem traue nicht, mein Sohn. \end{verse} \end{lstcode} \iftrue% Umbruchkorrekturtext - Hier noch zwei Sprüche, die man immer bedenken sollte, wenn man mit - scheinbar seltsamen Fragen zu {\LaTeX} oder den dazugehörigen Antworten + Hier noch zwei Sprüche, die man immer bedenken sollte, wenn man mit + scheinbar seltsamen Fragen zu {\LaTeX} oder den dazugehörigen Antworten konfrontiert ist: \begin{lstcode} \begin{verse} - Wir mögen's keinem gerne gönnen,\\* - Dass er was kann, was wir nicht können.\\ + Wir mögen's keinem gerne gönnen,\\* + Dass er was kann, was wir nicht können.\\ \bigskip Wie klein ist das, was einer ist,\\* - Wenn man's mit seinem Dünkel misst. + Wenn man's mit seinem Dünkel misst. \end{verse} \end{lstcode} \begin{ShowOutput} \iffree{}{\vskip-.8\baselineskip}% Umbruchkorrektur \begin{verse} - Wir mögen's keinem gerne gönnen,\\* - Dass er was kann, was wir nicht können.\\ + Wir mögen's keinem gerne gönnen,\\* + Dass er was kann, was wir nicht können.\\ \bigskip Wie klein ist das, was einer ist,\\* - Wenn man's mit seinem Dünkel misst. + Wenn man's mit seinem Dünkel misst. \end{verse} \end{ShowOutput} \fi - In diesen Beispielen wurde übrigens jeweils \Macro{bigskip} verwendet, - um zwei Sprüche voneinander zu trennen. + In diesen Beispielen wurde übrigens jeweils \Macro{bigskip} verwendet, + um zwei Sprüche voneinander zu trennen. \end{Example}% \fi % @@ -590,8 +590,8 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% intern ebenfalls eine Listenumgebung\textnote{Blockzitat mit Absatzabstand} und sowohl bei den Standardklassen als auch bei {\KOMAScript} zu finden. Der Inhalt der Umgebung wird im Blocksatz mit - beidseitigem Einzug gesetzt. Die Umgebung wird häufig verwendet, um - längere Zitate\Index{Zitat} abzusetzen. Dabei werden Absätze innerhalb der + beidseitigem Einzug gesetzt. Die Umgebung wird häufig verwendet, um + längere Zitate\Index{Zitat} abzusetzen. Dabei werden Absätze innerhalb der Umgebung durch einen vertikalen Abstand gekennzeichnet.% \EndIndexGroup @@ -600,12 +600,12 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \end{Declaration}% \IfThisCommonLabelBase{scrlttr2}{\OnlyAt{\Class{scrlttr2}}}{}Diese Umgebung\textnote{Blockzitat mit Absatzeinzug} ist mit - \DescRef{\ThisCommonLabelBase.env.quote} vergleichbar. Während bei - \DescRef{\ThisCommonLabelBase.env.quote} Absätze durch vertikalen Abstand + \DescRef{\ThisCommonLabelBase.env.quote} vergleichbar. Während bei + \DescRef{\ThisCommonLabelBase.env.quote} Absätze durch vertikalen Abstand gekennzeichnet werden, wird bei \Environment{quotation} mit horizontalem - Einzug der ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den + Einzug der ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den ersten Absatz einer \Environment{quotation}-Umgebung. Wollen Sie dort den - Einzug verhindern, müssen Sie die + Einzug verhindern, müssen Sie die \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.% \else \begin{Declaration} @@ -616,18 +616,18 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% Umgebungen\textnote{Blockzitate} sind intern ebenfalls Listenumgebungen und sowohl bei den Standardklassen als auch bei {\KOMAScript} zu finden. Beide Umgebungen setzen Blocksatz, der rechts und links eingezogen - ist. Verwendet werden die Umgebungen häufig, um längere + ist. Verwendet werden die Umgebungen häufig, um längere Zitate\Index{Zitat} abzusetzen. Der Unterschied zwischen beiden liegt in - der Art und Weise, wie Absätze abgesetzt werden. Während bei - \Environment{quote} Absätze durch vertikalen Abstand gekennzeichnet + der Art und Weise, wie Absätze abgesetzt werden. Während bei + \Environment{quote} Absätze durch vertikalen Abstand gekennzeichnet werden, wird bei \Environment{quotation} mit horizontalem Einzug der - ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den ersten + ersten Zeile eines Absatzes gearbeitet. Dies gilt auch für den ersten Absatz einer \Environment{quotation}-Umgebung% Umbruchkorrektur \IfThisCommonLabelBase{maincls}{% - , außer es wird \Macro{noindent}\IndexCmd{noindent} vorangestellt.% + , außer es wird \Macro{noindent}\IndexCmd{noindent} vorangestellt.% }{% \IfThisCommonLabelBase{scrlttr2}{% - . Wollen Sie dort den Einzug verhindern, müssen Sie die + . Wollen Sie dort den Einzug verhindern, müssen Sie die \Macro{noindent}-Anweisung\IndexCmd{noindent} voranstellen.% }{\InternalCommonFileUsageError}% }% @@ -640,53 +640,53 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% \begin{lstcode} \documentclass[paper=a5,pagesize]{scrartcl} \usepackage{selinput} - \SelectInputMappings{adieresis={ä},germandbls={ß}} + \SelectInputMappings{adieresis={ä},germandbls={ß}} \usepackage[ngerman]{babel} \begin{document} - Ein kleines Beispiel für eine Anekdote, die sich + Ein kleines Beispiel für eine Anekdote, die sich einst in Schwaben zugetragen haben soll: \begin{quotation} - Es klingelt an der Tür eines Pfarrhauses in - Stuttgart. Als die Haushälterin öffnet, steht - ein unrasierter Mann in reichlich schäbigem - Mantel vor der Tür und hält seine Strickmütze + Es klingelt an der Tür eines Pfarrhauses in + Stuttgart. Als die Haushälterin öffnet, steht + ein unrasierter Mann in reichlich schäbigem + Mantel vor der Tür und hält seine Strickmütze in der Hand. - "`Gute Frau,"' verkündet der Mann in gequältem + "`Gute Frau,"' verkündet der Mann in gequältem Ton, doch bestem Hochdeutsch, "`ich habe seit drei Tagen nichts mehr gegessen."' - Die Frau schüttelt mitleidig den Kopf und - entgegnet im Brustton vollster Überzeugung: + Die Frau schüttelt mitleidig den Kopf und + entgegnet im Brustton vollster Ãœberzeugung: "`Guda Moh, Sie missat sich halt zwinga!"' \end{quotation} \end{document} \end{lstcode} - Das Ergebnis könnte dann so aussehen: + Das Ergebnis könnte dann so aussehen: \begin{ShowOutput} \iftrue% Umbruchkorrekturtext - Ein kleines Beispiel für eine Anekdote, die sich einst + Ein kleines Beispiel für eine Anekdote, die sich einst in Schwaben zugetragen haben soll: \fi \begin{quotation} - Es klingelt an der Tür eines Pfarrhauses in - Stuttgart. Als die Haushälterin öffnet, steht ein - unrasierter Mann in reichlich schäbigem - Mantel vor der Tür und hält seine Strickmütze in + Es klingelt an der Tür eines Pfarrhauses in + Stuttgart. Als die Haushälterin öffnet, steht ein + unrasierter Mann in reichlich schäbigem + Mantel vor der Tür und hält seine Strickmütze in der Hand. - "`Gute Frau,"' verkündet der Mann in gequältem Ton, + "`Gute Frau,"' verkündet der Mann in gequältem Ton, doch bestem Hochdeutsch, \iffalse% Umbruchkorrekturtext - während er verlegen von einem Bein auf das andere wechselt, + während er verlegen von einem Bein auf das andere wechselt, \fi "`ich habe seit drei Tagen nichts mehr gegessen."' - Die Frau schüttelt mitleidig den Kopf und entgegnet - im Brustton vollster Überzeugung: + Die Frau schüttelt mitleidig den Kopf und entgegnet + im Brustton vollster Ãœberzeugung: "`Guda Moh, Sie missat sich halt zwinga!"' \end{quotation} @@ -696,23 +696,23 @@ Anleitung mit Hilfe der \Environment{labeling}-Umgebung definiert.% noch mit einer \DescRef{\LabelBase.env.quote}-Umgebung gezeigt:% \begin{ShowOutput} \iftrue% Umbruchkorrekturtext - Ein kleines Beispiel für eine Anekdote, die sich einst + Ein kleines Beispiel für eine Anekdote, die sich einst in Schwaben zugetragen haben soll: \fi \begin{quote}\setlength{\parskip}{4pt plus 2pt minus 2pt} - Es klingelt an der Tür eines Pfarrhauses in Stuttgart. Als die - Haushälterin öffnet, steht ein unrasierter Mann in reichlich - schäbigem Mantel vor der Tür und hält seine Strickmütze in der Hand. + Es klingelt an der Tür eines Pfarrhauses in Stuttgart. Als die + Haushälterin öffnet, steht ein unrasierter Mann in reichlich + schäbigem Mantel vor der Tür und hält seine Strickmütze in der Hand. - "`Gute Frau,"' verkündet der Mann in gequältem Ton, doch bestem + "`Gute Frau,"' verkündet der Mann in gequältem Ton, doch bestem Hochdeutsch, \iffalse% Umbruchkorrekturtext - während er verlegen von einem Bein auf das andere wechselt, + während er verlegen von einem Bein auf das andere wechselt, \fi "`ich habe seit drei Tagen nichts mehr gegessen."' - Die Frau schüttelt mitleidig den Kopf und entgegnet im Brustton - vollster Überzeugung: + Die Frau schüttelt mitleidig den Kopf und entgegnet im Brustton + vollster Ãœberzeugung: "`Guda Moh, Sie missat sich halt zwinga!"' \end{quote} @@ -741,11 +741,11 @@ Wie bei % } % handelt\textnote{allgemeine Einzugsumgebung} es sich bei \Environment{addmargin} um eine Umgebung, die den Rand\Index{Rand} -verändert. Im Unterschied zu den beiden erstgenannten Umgebungen kann der -Anwender jedoch bei \Environment{addmargin} wählen, um welchen Wert der Rand -verändert werden soll. Des Weiteren verändert die Umgebung den Absatzeinzug -und den Absatzabstand nicht. Es wird auch kein zusätzlicher vertikaler Abstand -vor und nach der Umgebung eingefügt. +verändert. Im Unterschied zu den beiden erstgenannten Umgebungen kann der +Anwender jedoch bei \Environment{addmargin} wählen, um welchen Wert der Rand +verändert werden soll. Des Weiteren verändert die Umgebung den Absatzeinzug +und den Absatzabstand nicht. Es wird auch kein zusätzlicher vertikaler Abstand +vor und nach der Umgebung eingefügt. Ist nur das obligatorische Argument \PName{Einzug} angegeben, so wird der Inhalt der Umgebung rechts und links um diesen Wert eingezogen. Ist das @@ -758,9 +758,9 @@ wobei der Unterschied auch nur dann auf"|tritt, wenn das optionale Argument \PName{innerer Einzug} verwendet wird. Dabei wird dann der Wert von \PName{innerer Einzug} zum inneren Randanteil der Seite addiert. Dies ist bei rechten Seiten der linke Rand der Seite, bei linken Seiten jedoch der rechte -Rand der Seite. \PName{Einzug} gilt dann für den jeweils anderen Rand. +Rand der Seite. \PName{Einzug} gilt dann für den jeweils anderen Rand. -Bei beiden Varianten der Umgebung sind für alle Parameter auch negative Werte +Bei beiden Varianten der Umgebung sind für alle Parameter auch negative Werte erlaubt. % Umbruchkorrektur \IfThisCommonLabelBase{scrextend}{% Die Umgebung ragt dann entsprechend in den Rand hinein.% @@ -772,8 +772,8 @@ erlaubt. % Umbruchkorrektur \phantomsection\xmpllabel{env.addmargin}% Angenommen, Sie schreiben eine Anleitung mit kurzen Quellcode-Beispielen. Um diese sehr stark hervorzuheben, sollen sie mit - horizontalen Linien vom Text abgesetzt und leicht in den äußeren Rand - verschoben werden. Sie definieren sich dafür zunächst eine Umgebung: + horizontalen Linien vom Text abgesetzt und leicht in den äußeren Rand + verschoben werden. Sie definieren sich dafür zunächst eine Umgebung: \begin{lstcode} \newenvironment{QuellcodeRahmen}{% \begin{addmargin*}[1em]{-1em}% @@ -810,20 +810,20 @@ erlaubt. % Umbruchkorrektur } \end{lstcode} \end{QuellcodeRahmen} - Nicht zwingend schön, aber es zeigt den Nutzen. + Nicht zwingend schön, aber es zeigt den Nutzen. \end{ShowOutput} - Das optionale Argument der \Environment{addmargin*}-Umgebung sorgt dafür, - dass der innere Rand um den Wert 1\Unit{em} vergrößert wird. Dafür wird - der äußere Rand um den negativen Wert vergrößert, also in Wirklichkeit um + Das optionale Argument der \Environment{addmargin*}-Umgebung sorgt dafür, + dass der innere Rand um den Wert 1\Unit{em} vergrößert wird. Dafür wird + der äußere Rand um den negativen Wert vergrößert, also in Wirklichkeit um 1\Unit{em} verkleinert. Dies resultiert in einer Verschiebung um - 1\Unit{em} nach außen. Selbstverständlich kann statt \PValue{1em} auch - eine Länge, beispielsweise \PValue{2\Macro{parindent}}, verwendet werden. + 1\Unit{em} nach außen. Selbstverständlich kann statt \PValue{1em} auch + eine Länge, beispielsweise \PValue{2\Macro{parindent}}, verwendet werden. \end{Example} \fi% -Ob eine Seite eine linke oder eine rechte Seite ist, kann übrigens beim ersten -\LaTeX-Durchlauf nicht zuverlässig festgestellt werden. Siehe dazu die -Erklärungen zu den Anweisungen +Ob eine Seite eine linke oder eine rechte Seite ist, kann übrigens beim ersten +\LaTeX-Durchlauf nicht zuverlässig festgestellt werden. Siehe dazu die +Erklärungen zu den Anweisungen \DescRef{\ThisCommonLabelBase.cmd.ifthispageodd} (\autoref{sec:\ThisCommonLabelBase.oddOrEven}, \DescPageRef{\ThisCommonLabelBase.cmd.ifthispageodd}) und @@ -834,8 +834,8 @@ Erklärungen zu den Anweisungen \IfThisCommonLabelBase{scrlttr2}{}{% \begin{Explain} Im Zusammenspiel von % Umgebungen wie - Listen mit Absätzen ergeben sich für - Laien häufiger Fragen. Daher widmet sich die weiterführende Erklärung zu + Listen mit Absätzen ergeben sich für + Laien häufiger Fragen. Daher widmet sich die weiterführende Erklärung zu Option \DescRef{maincls-experts.option.parskip} in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.option.parskip} auch diesem @@ -851,6 +851,6 @@ Erklärungen zu den Anweisungen %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-marginpar.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-marginpar.tex index ee80633693..17d51db46b 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-marginpar.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-marginpar.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-marginpar.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-marginpar.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-marginpar.tex} - [$Date: 2018-01-29 14:12:59 +0100 (Mon, 29 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] @@ -58,19 +58,19 @@ \BeginIndex{}{Randnotizen}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} bereits gelesen - und verstanden haben, können Sie auf + und verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.marginNotes.next} mit \autoref{sec:\ThisCommonLabelBase.marginNotes.next} fortfahren.% } -Außer dem eigentlichen Textbereich, der normalerweise den Satzspiegel -ausfüllt, existiert in Dokumenten noch die sogenannte Marginalienspalte. In -dieser können Randnotizen gesetzt werden. % +Außer dem eigentlichen Textbereich, der normalerweise den Satzspiegel +ausfüllt, existiert in Dokumenten noch die sogenannte Marginalienspalte. In +dieser können Randnotizen gesetzt werden. % \IfThisCommonLabelBase{scrlttr2}{% - Bei Briefen sind Randnotizen allerdings eher unüblich und sollten äußerst + Bei Briefen sind Randnotizen allerdings eher unüblich und sollten äußerst sparsam eingesetzt werden.% }{% In diesem \iffree{Dokument}{Buch} wird davon ebenfalls Gebrauch gemacht.% @@ -81,20 +81,20 @@ dieser können Randnotizen gesetzt werden. % \Macro{marginpar}\OParameter{Randnotiz links}\Parameter{Randnotiz} \Macro{marginline}\Parameter{Randnotiz} \end{Declaration}% -Für Randnotizen\Index[indexmain]{Randnotizen} ist bei {\LaTeX} normalerweise +Für Randnotizen\Index[indexmain]{Randnotizen} ist bei {\LaTeX} normalerweise Anweisung \Macro{marginpar} vorgesehen. Die \PName{Randnotiz} wird dabei im -äußeren Rand gesetzt. Bei einseitigen Dokumenten wird der rechte Rand +äußeren Rand gesetzt. Bei einseitigen Dokumenten wird der rechte Rand verwendet. Zwar kann bei \Macro{marginpar} optional eine abweichende Randnotiz angegeben werden, falls die Randnotiz im linken Rand landet, jedoch werden Randnotizen immer im Blocksatz ausgegeben. Die Erfahrung zeigt, dass bei -Randnotizen statt des Blocksatzes oft je nach Rand linksbündiger oder -rechtsbündiger Flattersatz zu bevorzugen ist. {\KOMAScript} bietet hierfür +Randnotizen statt des Blocksatzes oft je nach Rand linksbündiger oder +rechtsbündiger Flattersatz zu bevorzugen ist. {\KOMAScript} bietet hierfür die Anweisung \Macro{marginline}. \IfThisCommonFirstRun{% \iftrue% }{% - Ein ausführliches Beispiel hierzu finden Sie in + Ein ausführliches Beispiel hierzu finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.marginNotes}, \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.marginline}.% \csname iffalse\endcsname% @@ -109,27 +109,27 @@ die Anweisung \Macro{marginline}. \end{lstcode} erreicht werden.% \iftrue % Umbruchkorrekturtext - \footnote{Tatsächlich wurde nicht \Macro{texttt}, - sondern eine semantische Auszeichnung verwendet. Um nicht unnötig + \footnote{Tatsächlich wurde nicht \Macro{texttt}, + sondern eine semantische Auszeichnung verwendet. Um nicht unnötig zu verwirren, wurde diese im Beispiel ersetzt.}% \fi - Statt der Anweisung \Macro{marginline} wäre auch die Verwendung von - \Macro{marginpar} möglich gewesen. Tatsächlich wird bei obiger Verwendung + Statt der Anweisung \Macro{marginline} wäre auch die Verwendung von + \Macro{marginpar} möglich gewesen. Tatsächlich wird bei obiger Verwendung von \Macro{marginline} intern nichts anders gemacht als: \begin{lstcode} \marginpar[\raggedleft\texttt{scrartcl}] {\raggedright\texttt{scrartcl}} \end{lstcode} - Damit ist \Macro{marginline} also nur eine abkürzende Schreibweise.% + Damit ist \Macro{marginline} also nur eine abkürzende Schreibweise.% \end{Example}% \fi -Für\textnote{Achtung!} Experten sind in +Für\textnote{Achtung!} Experten sind in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.cmd.marginpar} Probleme bei der Verwendung von -\Macro{marginpar} dokumentiert. Diese gelten ebenso für \Macro{marginline}. -Darüber hinaus wird in \autoref{cha:scrlayer-notecolumn} ein Paket +\Macro{marginpar} dokumentiert. Diese gelten ebenso für \Macro{marginline}. +Darüber hinaus wird in \autoref{cha:scrlayer-notecolumn} ein Paket vorgestellt, mit dem sich auch Notizspalten mit eigenem Seitenumbruch realisieren lassen.% \iftrue% Umbruchkorrektur @@ -147,7 +147,7 @@ realisieren lassen.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-oddorevenpage.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-oddorevenpage.tex index 71dc74663e..702f5b9a36 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-oddorevenpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-oddorevenpage.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-oddorevenpage.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-oddorevenpage.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-oddorevenpage.tex} - [$Date: 2018-01-30 09:32:50 +0100 (Tue, 30 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \section{Erkennung von rechten und linken Seiten} @@ -56,10 +56,10 @@ \BeginIndex{}{Seiten>ungerade}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.oddOrEven} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.oddOrEven} - bereits gelesen und verstanden haben, können Sie in + bereits gelesen und verstanden haben, können Sie in \autoref{sec:\ThisCommonLabelBase.oddOrEven.next} auf \autopageref{sec:\ThisCommonLabelBase.oddOrEven.next} fortfahren.% } @@ -76,17 +76,17 @@ rechte Seite immer eine ungerade Nummer. % % Umbruchkorrekturtext \iftrue% Bei einseitigen Dokumenten existiert die Unterscheidung zwischen linken - und rechten Seiten nicht. Dennoch gibt es natürlich auch bei einseitigen + und rechten Seiten nicht. Dennoch gibt es natürlich auch bei einseitigen Dokumenten sowohl Seiten mit gerader als auch Seiten mit ungerader Nummer.% \fi% }{% \IfThisCommonLabelBase{scrlttr2}{% In der Regel werden Briefe einseitig gesetzt. Sollen Briefe mit - einseitigem Layout jedoch auf Vorder- und Rückseite gedruckt oder - ausnahmsweise tatsächlich doppelseitige Briefe erstellt werden, kann unter - Umständen das Wissen, ob man sich auf einer Vorder- oder einer Rückseite - befindet, nützlich sein.% + einseitigem Layout jedoch auf Vorder- und Rückseite gedruckt oder + ausnahmsweise tatsächlich doppelseitige Briefe erstellt werden, kann unter + Umständen das Wissen, ob man sich auf einer Vorder- oder einer Rückseite + befindet, nützlich sein.% }{}% } @@ -96,12 +96,12 @@ rechte Seite immer eine ungerade Nummer. % Will man bei \KOMAScript{} feststellen, ob ein Text auf einer geraden oder einer ungeraden Seite ausgegeben wird, so verwendet man die Anweisung \Macro{ifthispageodd}. Dabei wird das Argument \PName{Dann-Teil} nur dann -ausgeführt, wenn man sich aktuell auf einer ungeraden Seite +ausgeführt, wenn man sich aktuell auf einer ungeraden Seite befindet. Anderenfalls kommt das Argument \PName{Sonst-Teil} zur Anwendung. \begin{Example} Angenommen, Sie wollen einfach nur ausgeben, ob ein Text auf einer geraden - oder ungeraden Seite ausgegeben wird. Sie könnten dann beispielsweise mit + oder ungeraden Seite ausgegeben wird. Sie könnten dann beispielsweise mit der Eingabe \begin{lstcode} Dies ist eine Seite mit @@ -117,13 +117,13 @@ befindet. Anderenfalls kommt das Argument \PName{Sonst-Teil} zur Anwendung. \end{Example} Da die Anweisung \Macro{ifthispageodd} mit einem Mechanismus arbeitet, der -einem Label und einer Referenz darauf sehr ähnlich ist, werden nach jeder -Textänderung mindestens zwei \LaTeX-Durchläufe benötigt. Erst dann ist die -Entscheidung korrekt. Im ersten Durchlauf wird für die +einem Label und einer Referenz darauf sehr ähnlich ist, werden nach jeder +Textänderung mindestens zwei \LaTeX-Durchläufe benötigt. Erst dann ist die +Entscheidung korrekt. Im ersten Durchlauf wird für die Entscheidung eine Heuristik verwendet. -Näheres zur Problematik der Erkennung von linken und rechten Seiten oder -geraden und ungeraden Seitennummern ist für Experten in +Näheres zur Problematik der Erkennung von linken und rechten Seiten oder +geraden und ungeraden Seitennummern ist für Experten in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.cmd.ifthispageodd} zu finden.% % @@ -134,6 +134,6 @@ geraden und ungeraden Seitennummern ist für Experten in %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-options.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-options.tex index 433dfb2e67..17a009d2f3 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-options.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-options.tex @@ -40,16 +40,16 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-options.tex} - [$Date: 2018-10-23 08:59:49 +0200 (Tue, 23 Oct 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (common paragraphs)] -\section{Frühe oder späte Optionenwahl} +\section{Frühe oder späte Optionenwahl} \seclabel{options} \BeginIndexGroup \BeginIndex{}{Optionen}% @@ -83,22 +83,22 @@ % Umbruchvarianten: \IfThisCommonLabelBase{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 + braucht aber beim Studium des gesamten von \KOMAScript{} natürlich nur in einem gelesen werden.% }{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 + Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen diesen + Abschnitt nur in einem der Kapitel zu lesen und können ihn \IfThisCommonLabelBase{maincls}{bei den weiteren Kapitel - überspringen.}{beim weiteren Studium der Anleitung dann überspringen.}% + überspringen.}{beim weiteren Studium der Anleitung dann überspringen.}% }% }{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.options} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.options} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.options} bereits gelesen und - verstanden haben, können Sie auf + verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.options.next} mit \autoref{sec:\ThisCommonLabelBase.options.next} fortfahren.% } @@ -112,40 +112,40 @@ \end{Declaration} Bei \LaTeX{} ist vorgesehen, dass Anwender Klassenoptionen\textnote{Klassenoptionen} in Form einer durch Komma getrennten -Liste einfacher Schlüsselwörter als optionales Argument von -\Macro{documentclass} angeben. Außer an die Klasse werden diese Optionen auch +Liste einfacher Schlüsselwörter als optionales Argument von +\Macro{documentclass} angeben. Außer an die Klasse werden diese Optionen auch an alle Pakete\textnote{globale Optionen} weitergereicht, die diese Optionen verstehen. Ebenso ist vorgesehen, dass Anwender Paketoptionen\textnote{Paketoptionen} in Form einer durch Komma getrennten -Liste einfacher Schlüsselwörter als optionales Argument von \Macro{usepackage} +Liste einfacher Schlüsselwörter als optionales Argument von \Macro{usepackage} angeben. \KOMAScript{} erweitert\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}\and \Package{typearea}} den -Mechanismus der Optionen für +Mechanismus der Optionen für \IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{die \KOMAScript-Klassen und -}einige Pakete um weitere Möglichkeiten. So haben die meisten Optionen bei -\KOMAScript{} zusätzlich einen Wert. Eine Option hat also nicht unbedingt nur +}einige Pakete um weitere Möglichkeiten. So haben die meisten Optionen bei +\KOMAScript{} zusätzlich einen Wert. Eine Option hat also nicht unbedingt nur die Form \PName{Option}, sondern kann auch die Form \PName{Option}\texttt{=}\PName{Wert}% \important{\PName{Option}\texttt{=}\PName{Wert}} haben. Bis auf diesen Unterschied arbeiten \Macro{documentclass} und \Macro{usepackage} bei -\KOMAScript{} wie in \cite{latex:usrguide} oder jeder \LaTeX-Einführung, +\KOMAScript{} wie in \cite{latex:usrguide} oder jeder \LaTeX-Einführung, beispielsweise \cite{l2kurz}, beschrieben.% % \iffree{}{\IfThisCommonLabelBase{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 + besitzt diese Erweiterung übrigens nicht. Es versteht daher nur einfache Optionen ohne Wertzuweisung.\par}{}}% \IfThisCommonLabelBaseNotOneOf{% scrjura,scrhack,scrlayer,scrlayer-scrpage,scrlayer-notecolumn,scrextend% }{% Bei Verwendung einer \KOMAScript-Klasse\textnote{Achtung!} sollten im - Übrigen beim 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 + Ãœbrigen beim 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.% - \IfThisCommonLabelBase{scrlttr2}{ Überhaupt ist es bei Verwendung einer + \IfThisCommonLabelBase{scrlttr2}{ Ãœberhaupt ist es bei Verwendung einer \KOMAScript-Klasse nicht notwendig, eines dieser Pakete auch noch explizit zu laden.}{}% \par @@ -153,20 +153,20 @@ beispielsweise \cite{l2kurz}, beschrieben.% % Umbruchoptimierung!!! \IfThisCommonLabelBase{typearea}{Das Setzen der Optionen mit - \Macro{documentclass} hat übrigens einen\textnote{Achtung!} entscheidenden + \Macro{documentclass} hat übrigens einen\textnote{Achtung!} entscheidenden Nachteil: % }{% - Gegenüber der nachfolgend vorgestellten Schnittstelle zu Einstellungen von + Gegenüber der nachfolgend vorgestellten Schnittstelle zu Einstellungen von Optionen hat \Macro{documentclass} 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 dieser +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 dieser Anweisung bei vielen Nicht-\KOMAScript-Klassen zu einer Fehlermeldung% \IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2}{, noch bevor der Wert an ein - \KOMAScript-Paket übergeben wird, es also die Kontrolle darüber übernehmen - könnte}{}% -. Wertzuweisungen mit \LaTeX-Längen oder \LaTeX-Zählern sollten daher nie per + \KOMAScript-Paket ü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}, sondern mit den nachfolgend dokumentierten Anweisungen \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} vorgenommen werden. \EndIndexGroup @@ -179,22 +179,22 @@ vorgenommen werden. \EndIndexGroup \KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}\and \Package{typearea}} bietet bei den meisten \IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{Klassen- und }Paketoptionen -auch die Möglichkeit, den Wert der Optionen noch nach dem Laden +auch die Möglichkeit, den Wert der Optionen noch nach dem Laden \IfThisCommonLabelBaseOneOf{scrextend,scrjura}{}{der Klasse beziehungsweise -}des Pakets zu ändern. Mit der Anweisung \Macro{KOMAoptions} kann man wie bei +}des Pakets zu ändern. Mit der Anweisung \Macro{KOMAoptions} kann man wie bei \DescRef{\ThisCommonLabelBase.cmd.documentclass} oder \DescRef{\ThisCommonLabelBase.cmd.usepackage} die Werte einer Reihe von -Optionen ändern. Jede Option der \PName{Optionenliste} hat dabei die Form +Optionen ändern. Jede Option der \PName{Optionenliste} hat dabei die Form \PName{Option}\texttt{=}\PName{Wert}% \important{\PName{Option}\texttt{=}\PName{Wert},\dots}. -Einige Optionen besitzen auch einen Säumniswert (engl. \emph{default - value}). Versäumt man die Angabe eines Wertes, verwendet man die Option also -einfach in der Form \PName{Option}, so wird automatisch dieser Säumniswert +Einige Optionen besitzen auch einen Säumniswert (engl. \emph{default + value}). Versäumt man die Angabe eines Wertes, verwendet man die Option also +einfach in der Form \PName{Option}, so wird automatisch dieser Säumniswert angenommen. -Manche Optionen können gleichzeitig mehrere Werte besitzen. Für solche -Optionen besteht die Möglichkeit, mit \Macro{KOMAoption} der einen +Manche Optionen können gleichzeitig mehrere Werte besitzen. Für solche +Optionen besteht die Möglichkeit, mit \Macro{KOMAoption} der einen \PName{Option} nacheinander eine Reihe von Werten zuzuweisen. Die einzelnen Werte sind dabei in der \PName{Werteliste}\important{\PName{Wert},\dots} durch Komma @@ -204,11 +204,11 @@ 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 + \KOMAScript{} bedient sich für die Realisierung dieser Möglichkeit der Anweisungen \DescRef{scrbase.cmd.FamilyOptions} und - \DescRef{scrbase.cmd.FamilyOption} mit der Familie »\PValue{KOMA}«. + \DescRef{scrbase.cmd.FamilyOption} mit der Familie »\PValue{KOMA}«. \IfThisCommonLabelBaseOneOf{typearea}{% Umbruchkorrektur - Näheres zu diesen Anweisungen finden fortgeschrittene Anwender in + Näheres zu diesen Anweisungen finden fortgeschrittene Anwender in \autoref{sec:scrbase.keyvalue} ab \DescPageRef{scrbase.cmd.FamilyOptions}. }{% Siehe dazu \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue}, @@ -219,7 +219,7 @@ enthalten, so ist der \PName{Wert} in geschweifte Klammern zu setzen. Mit \Macro{KOMAoptions} oder \Macro{KOMAoption} gesetzte Optionen erreichen \IfThisCommonLabelBase{scrextend}{}{sowohl die \KOMAScript-Klasse als }auch alle bereits geladenen \KOMAScript-Pakete, die diese Optionen kennen. Ist eine -Option oder ein Wert insgesamt unbekannt, so wird die Option einschließlich +Option oder ein Wert insgesamt unbekannt, so wird die Option einschließlich des Wertes von \hyperref[cha:scrbase]{\Package{scrbase}}\IndexPackage{scrbase}% \important{\hyperref[cha:scrbase]{\Package{scrbase}}} als fehlerhaft @@ -229,8 +229,8 @@ gemeldet.% \iffree{}{\IfThisCommonLabelBase{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 + 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.}{}}% \fi% \EndIndexGroup @@ -243,6 +243,6 @@ gemeldet.% %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-pagestylemanipulation.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-pagestylemanipulation.tex index f4814b7283..f4ba72ed71 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-pagestylemanipulation.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-pagestylemanipulation.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-pagestylemanipulation.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % 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-pagestylemanipulation.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapitels in der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{common-pagestylemanipulation.tex} - [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraph: Setting up defined page styles)] @@ -57,35 +57,35 @@ \IfThisCommonLabelBase{scrlayer}{% Obwohl \Package{scrlayer} selbst keine konkreten Seitenstile mit Inhalt - definiert -- die erwähnten Seitenstile + definiert -- die erwähnten Seitenstile \DescRef{\LabelBase.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.% + zunächst ohne Ebenen, also leer definiert --, stellt es einige Optionen und + Befehle zur Beeinflussung von Inhalten zur Verfügung.% }{% \IfThisCommonLabelBase{scrlayer-scrpage}{% - In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} wurde erklärt, wie + In \autoref{sec:scrlayer-scrpage.predefined.pagestyles} wurde erklärt, wie die Seitenstile \DescRef{\LabelBase.pagestyle.scrheadings} und \DescRef{\LabelBase.pagestyle.plain.scrheadings} grundlegend vordefiniert - sind und wie diese Vorbelegung grundsätzlich geändert werden kann. Es + 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 + 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 \hyperref[cha:scrlayer]{\Package{scrlayer}}% \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} sind, werden sie nachfolgend - erläutert, da diese grundlegenden Eigenschaften von + erläutert, da diese grundlegenden Eigenschaften von \hyperref[cha:scrlayer]{\Package{scrlayer}} einen wichtigen Teil der - Möglichkeiten von \IfThisCommonLabelBase{scrlayer-scrpage}{% + Möglichkeiten von \IfThisCommonLabelBase{scrlayer-scrpage}{% \Package{scrlayer-scrpage}% }{% \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% } ausmachen.% }{% \IfThisCommonLabelBase{scrlayer-scrpage-experts}{% - Dieser Abschnitt ist als Ergänzung zu + 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.% + Dinge, die sich dem Anfänger nicht unbedingt sofort erschließen.% }{\InternalCommonFileUsageError}% }% } @@ -101,37 +101,37 @@ \end{Declaration} \IfThisCommonLabelBase{scrlayer-scrpage}{% \begin{Explain} - Bei den Standardklassen und auch bei den \KOMAScript-Klassen fällt die + 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 + gearbeitet werden soll, über die Wahl des entsprechenden + Seitenstils. Wie bereits in \autoref{sec:maincls.pagestyle} erklärt, + erhält man bei Wahl von \DescRef{maincls.pagestyle.headings}\IndexPagestyle{headings}% \important{\DescRef{maincls.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. + 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 \hyperref[cha:maincls]{\Class{scrartcl}} wird für + \Class{article} oder \hyperref[cha:maincls]{\Class{scrartcl}} wird für den lebenden Kolumnentitel\textnote{lebende Kolumnentitel} im - einseitigen Modus die Abschnittsüberschrift, also das obligatorische + einseitigen Modus die Abschnittsüberschrift, also das obligatorische oder das optionale Argument von \DescRef{maincls.cmd.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 + 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 + 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. + 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 + 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 + Kapitelüberschrift als linke Marke und die Abschnittsüberschrift als rechte Marke gesetzt. Verwendet man hingegen als Seitenstil @@ -140,18 +140,18 @@ \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 + durch die Ãœberschriften gesetzt. Man kann sie dann nur manuell\important{% \DescRef{\ThisCommonLabelBase.cmd.markright}\\ \DescRef{\ThisCommonLabelBase.cmd.markboth}} - über die später in diesem Abschnitt dokumentierten Anweisungen + über die später in diesem Abschnitt dokumentierten Anweisungen \DescRef{\ThisCommonLabelBase.cmd.markright} und - \DescRef{\ThisCommonLabelBase.cmd.markboth} befüllen. + \DescRef{\ThisCommonLabelBase.cmd.markboth} befüllen. \end{Explain}\par% }{% \IfThisCommonLabelBase{scrlayer}{% Bei den meisten Klassen bestimmt die Wahl des Seitenstils, meist - \PageStyle{headings} und \PageStyle{myheadings}, darüber, ob die + \PageStyle{headings} und \PageStyle{myheadings}, darüber, ob die Kolumnentitel automatisch oder manuell erzeugt werden. % }{\InternalCommonFileUsageError}% }% @@ -160,38 +160,38 @@ \hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer} aufgehoben. Statt die Unterscheidung zwischen automatischen\textnote{lebende und manuelle Kolumnentitel} und manuellen - Kolumnentiteln über den Seitenstil vorzunehmen, gibt es die beiden + 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 + 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 + 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 + 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. Es ist zu beachten\textnote{Achtung!}, dass nicht alle Klassen Kolumnentitel - für alle Ebenen ermöglichen. So setzen die + für alle Ebenen ermöglichen. So setzen die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} beispielsweise - nie Kolumnentitel für \DescRef{maincls.cmd.part}. Die \KOMAScript-Klassen - unterstützen hingegen alle Ebenen. + nie Kolumnentitel für \DescRef{maincls.cmd.part}. Die \KOMAScript-Klassen + unterstützen hingegen alle Ebenen. 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.% + aufhebt, während die Stern-Version \Macro{automark*} lediglich die Aktionen + für die angegebenen Gliederungsebenen ändert.% \IfThisCommonLabelBase{scrlayer-scrpage}{}{ Man kann so auch relativ - komplexe Fälle abdecken.}% Umbruchoptimierung + komplexe Fälle abdecken.}% Umbruchoptimierung \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{\csname iffalse\endcsname}% \iffalse% Umbruchkorrekturtext @@ -200,17 +200,17 @@ \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.% + vollständig auf die Verwendung von \Package{scrpage2} übertragbar.% }% \fi % \begin{Example} \phantomsection\xmpllabel{mark}% - Angenommen Sie wollen, dass wie üblich auf den linken Seiten eines - Buches die Kapitelüberschriften als automatische Kolumnentitel verwendet + 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 + Abschnittsüberschriften. Allerdings soll auf rechte Seiten so lange + ebenfalls die Kapitelüberschrift verwendet werden, bis der erste Abschnitt auf"|taucht. Dazu wird zuerst \IfThisCommonLabelBase{scrlayer-scrpage}{% \Package{scrlayer-scrpage}% @@ -223,20 +223,20 @@ \usepackage{scrlayer-scrpage} \pagestyle{scrheadings} \end{lstcode} - Als nächstes wird dafür gesorgt, dass die Kapitelüberschriften sowohl + 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 + 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. + \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} @@ -249,19 +249,19 @@ \end{document} \end{lstcode} Dabei ist das Paket \Package{lipsum}\IndexPackage{lipsum} mit seiner - Anweisung \Macro{lipsum}\IndexCmd{lipsum} sehr nützlich. + 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 + Kapitelanfangsseite wie üblich ohne Kolumnentitel ist, da sie automatisch im \PageStyle{plain}-Seitenstil \DescRef{\LabelBase.pagestyle.plain.scrheadings} gesetzt wird (siehe dazu Anweisung \DescRef{maincls.cmd.chapterpagestyle} auf \DescPageRef{maincls.cmd.chapterpagestyle}). 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.% + 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} \fi @@ -270,7 +270,7 @@ \OptionVName{autooneside}{Ein-Aus-Wert} \Option{manualmark} \end{Declaration} - Außer mit den zuvor erklärten Befehlen kann auch direkt mit den beiden + Außer mit den zuvor erklärten Befehlen kann auch direkt mit den beiden Optionen \Option{manualmark}\important{\Option{manualmark}\\\Option{automark}} und \Option{automark} zwischen automatischen und manuellen Kolumnentiteln hin- @@ -293,17 +293,17 @@ \IfThisCommonLabelBase{scrlayer-scrpage}{% Im einseitigen Modus\textnote{einseitiger Satz} will man in der Regel, - dass nur die höheren Ebenen den Kolumnentitel vorgeben.% + dass nur die höheren Ebenen den Kolumnentitel vorgeben.% }{% 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 + 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 + 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.% @@ -312,10 +312,10 @@ \begin{Example} \phantomsection\xmpllabel{mark.oneside}% 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, + ä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 + Abschnittsüberschrift verwendet werden. Dazu wird das Beispiel wie folgt abgewandelt: \begin{lstcode} \documentclass{scrreprt} @@ -330,22 +330,22 @@ \lipsum[21-40] \end{document} \end{lstcode} - Wie zu sehen ist, wird in diesem Fall keine ergänzende - \DescRef{\LabelBase.cmd.automark*}-Anweisung benötigt. Sie sollten zum + Wie zu sehen ist, wird in diesem Fall keine ergänzende + \DescRef{\LabelBase.cmd.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} \fi - Das\textnote{Achtung!} Laden des Pakets selbst hat übrigens noch keine + 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 \DescRef{\LabelBase.cmd.automark} oder \DescRef{\LabelBase.cmd.manualmark} - schafft hier klare Verhältnisse.% + schafft hier klare Verhältnisse.% \IfThisCommonLabelBase{scrlayer-scrpage}{\par% - Bei Bedarf finden Sie weitere Hintergründe und Beispiele zur Verwendung + Bei Bedarf finden Sie weitere Hintergründe und Beispiele zur Verwendung dieser Befehle und Optionen mit dem auf \Package{scrlayer} basierenden Paket \IfThisCommonLabelBase{scrlayer-scrpage}{% \Package{scrlayer-scrpage}% @@ -362,17 +362,17 @@ \begin{Declaration} \OptionVName{draft}{Ein-Aus-Wert} \end{Declaration} - Die \KOMAScript-Option versteht die Standardwerte für einfache Schalter, die + 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 - \IfThisCommonLabelBase{scrlayer}{für die Entwurfsphase}{\unskip} alle - Elemente der Seitenstile zusätzlich mit - Maßlinien\Index{Masslinien=Maßlinien} - versehen. \IfThisCommonLabelBase{scrlayer}{\unskip}{Dies kann während der - Entwurfsphase manchmal nützlich sein.}% + \IfThisCommonLabelBase{scrlayer}{für die Entwurfsphase}{\unskip} alle + Elemente der Seitenstile zusätzlich mit + Maßlinien\Index{Masslinien=Maßlinien} + versehen. \IfThisCommonLabelBase{scrlayer}{\unskip}{Dies kann während der + Entwurfsphase manchmal nützlich sein.}% \IfThisCommonLabelBase{scrlayer-scrpage}{ % - 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, + 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 \DescRef{\LabelBase.cmd.usepackage} beim Laden des Pakets angibt.% }{}% @@ -383,19 +383,19 @@ \Macro{MakeMarkcase}\Parameter{Text} \end{Declaration} Die automatischen, nicht jedoch die manuellen Kolumnentitel verwenden - \Macro{MakeMarkcase} für ihre Ausgabe. Ist die Anweisung beim Laden von + \Macro{MakeMarkcase} für ihre Ausgabe. Ist die Anweisung beim Laden von \IfThisCommonLabelBase{scrlayer}{% \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% } nicht\textnote{bedingte Voreinstellung} definiert, so wird sie in der Voreinstellung derart definiert, dass sie ihr Argument \PName{Text} - unverändert ausgibt. Diese Voreinstellung kann jedoch entweder durch + unverändert ausgibt. Diese Voreinstellung kann jedoch entweder durch Umdefinierung von \Macro{MakeMarkcase} oder durch die nachfolgend dokumentierte Option \DescRef{\LabelBase.option.markcase}% \IndexOption{markcase}\important{\DescRef{\LabelBase.option.markcase}} - geändert werden. Je nach Einstellung wird das Argument dann beispielsweise - in Groß- oder Kleinbuchstaben umgewandelt. + geändert werden. Je nach Einstellung wird das Argument dann beispielsweise + in Groß- oder Kleinbuchstaben umgewandelt. % \EndIndexGroup @@ -403,64 +403,64 @@ \begin{Declaration} \OptionVName{markcase}{Wert} \end{Declaration} - Wie bereits früher erläutert, kann man bei + Wie bereits früher erläutert, kann man bei \IfThisCommonLabelBase{scrlayer}{% \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } zwischen manuellen und automatischen Kolumnentiteln wählen. Bei den - automatischen Kolumnentiteln werden dabei die entsprechenden Marken über die + } 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 + Typografie des deutschsprachigen Raums üblich, die Kolumnentitel in + Großbuchstaben zu setzen. Die Standardklassen machen genau dies in der Voreinstellung. Das Paket \IfThisCommonLabelBase{scrlayer}{% \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } unterstützt das optional ebenfalls. Hierzu gibt man als Option + } 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 + \IndexOption[indexmain]{markcase~=upper} an. Im Endeffekt führt das zu einer Umdefinierung von \DescRef{\ThisCommonLabelBase.cmd.MakeMarkcase}% \IndexCmd[indexmain]{MakeMarkcase}. \IfThisCommonLabelBase{scrlayer}{% - Aufgrund der mangelnden typografischen Qualität der primitiven Umwandlung - in Großbuchstaben (siehe die Erklärung zu + Aufgrund der mangelnden typografischen Qualität der primitiven Umwandlung + in Großbuchstaben (siehe die Erklärung zu \DescRef{scrlayer-scrpage.option.markcase} in \autoref{sec:scrlayer-scrpage.pagestyle.content} auf \autopageref{expl:scrlayer-scrpage.MakeUppercase}) empfiehlt der \KOMAScript-Autor den Verzicht auf Versalsatz.% }{% Leider\phantomsection\label{expl:\ThisCommonLabelBase.MakeUppercase} - führt die von \LaTeX{} für Versalsatz\Index{Versalsatz} vorgesehene + führt die von \LaTeX{} für Versalsatz\Index{Versalsatz} vorgesehene Anweisung \Macro{MakeUppercase}\IndexCmd{MakeUppercase} zu keinem guten Ergebnis, da weder gesperrt noch ausgeglichen wird. Dies liegt teilweise - sicher daran, dass für typografisch korrekten Versalsatz eine + sicher daran, dass für typografisch korrekten Versalsatz eine Glyphenanalyse notwendig ist, um die konkrete Form der Buchstaben\iffree{ - und ihrer Kombinationen}{} in den Ausgleich der Sperrung einfließen zu - lassen. Der \KOMAScript-Autor empfiehlt daher, auf Versalsatz für die + 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 + \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 + 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. + \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 + Alle für \Option{markcase} möglichen Werte sind noch einmal in \autoref{tab:scrlayer-scrpage.markcase}% \IfThisCommonLabelBase{scrlayer-scrpage}{}{, \autopageref{tab:scrlayer-scrpage.markcase}} zusammengefasst.% \IfThisCommonLabelBase{scrlayer-scrpage}{% \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 + \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:\ThisCommonLabelBase.markcase}% \begin{desctabular} @@ -472,20 +472,20 @@ \pventry{upper}{\IndexOption[indexmain]{markcase~=upper}% definiert \DescRef{\LabelBase.cmd.MakeMarkcase} so um, dass automatische Kolumnentitel mit Hilfe von \Macro{MakeUppercase} in - Großbuchstaben gewandelt werden (Versalsatz).% + Großbuchstaben gewandelt werden (Versalsatz).% }% \pventry{used}{\IndexOption[indexmain]{markcase~=used}% - definiert \DescRef{\LabelBase.cmd.MakeMarkcase} so um, dass für - automatische Kolumnentitel keine automatische Veränderung der - Groß-/Kleinschreibung durchgeführt wird.% + definiert \DescRef{\LabelBase.cmd.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[indexmain]{markcase~=noupper}% definiert nicht nur \DescRef{\LabelBase.cmd.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 + 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} @@ -501,15 +501,15 @@ \Macro{pagemark} \end{Declaration} Will man von den vordefinierten Seitenstilen abweichen, so muss man in der - Regel auch selbst entscheiden können, wo die Marken gesetzt werden + 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 + entsprechenden Inhalt ersetzt wird. Für einige Feinheiten dabei sei auch + auf die weiterführenden Erklärungen zu \DescRef{maincls-experts.cmd.rightmark} in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.cmd.rightmark} verwiesen. @@ -527,11 +527,11 @@ genommen nichts mit den Marken von \TeX{} zu tun. Sie dient dazu, eine formatierte Seitenzahl zu platzieren. \BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}% - Bei ihrer Ausgabe wird dann auch die Schrifteinstellung für das Element + Bei ihrer Ausgabe wird dann auch die Schrifteinstellung für das Element \FontElement{pagenumber}\important{\FontElement{pagenumber}} verwendet. Diese kann mit Hilfe der Anweisungen \DescRef{maincls.cmd.setkomafont} und \DescRef{maincls.cmd.addtokomafont} - verändert werden (siehe auch \autoref{sec:maincls.textmarkup}, + verändert werden (siehe auch \autoref{sec:maincls.textmarkup}, \DescPageRef{maincls.cmd.setkomafont}).% \EndIndex{FontElement}{pagenumber}% \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{% @@ -555,7 +555,7 @@ 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: + vollständige Minimalbeispiel liefert genau dies: \begin{lstcode} \documentclass{scrreprt} \usepackage{blindtext} @@ -570,43 +570,43 @@ \end{document} \end{lstcode} Das Paket \Package{blindtext}\IndexPackage{blindtext} mit seiner - Anweisung \Macro{blinddocument}\IndexCmd{blinddocument} wird hier für + Anweisung \Macro{blinddocument}\IndexCmd{blinddocument} wird hier für die komfortable Erzeugung eines Beispieldokumentinhalts verwendet. Mit den Anweisungen \DescRef{scrlayer-scrpage.cmd.ihead}\IndexCmd{ihead} und \DescRef{scrlayer-scrpage.cmd.ohead*}\IndexCmd{ohead*} werden die - gewünschten Marken platziert. Dabei wird die + gewünschten Marken platziert. Dabei wird die Seitenzahl\iffalse-Marke\fi{} durch die Sternform \DescRef{scrlayer-scrpage.cmd.ohead*} % \iffalse% Umbruchvarianten nicht nur auf den mit \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings} - gesetzten Seiten, sondern auch für den auf Kapitelanfangsseiten + gesetzten Seiten, sondern auch für den auf Kapitelanfangsseiten automatisch verwendeten \PageStyle{plain}-Seitenstil % \else% - auch für den auf Kapitelanfangsseiten verwendeten Seitenstil % + auch für den auf Kapitelanfangsseiten verwendeten Seitenstil % \fi% \DescRef{\LabelBase.pagestyle.plain.scrheadings}% \IndexPagestyle{plain.scrheadings} konfiguriert.% Da die Seitenstile bereits mit Marken in der Mitte von Kopf oder - Fuß vordefiniert sind, werden diese beiden Elemente mit + Fuß vordefiniert sind, werden diese beiden Elemente mit \DescRef{scrlayer-scrpage.cmd.chead} und - \DescRef{scrlayer-scrpage.cmd.cfoot} gelöscht. Hierzu werden leere - Argumente verwendet. Alternativ dazu hätte man auch + \DescRef{scrlayer-scrpage.cmd.cfoot} gelöscht. Hierzu werden leere + Argumente verwendet. Alternativ dazu hätte man auch \DescRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles} \IndexCmd{clearpairofpagestyles} - \emph{vor} \DescRef{scrlayer-scrpage.cmd.ihead} verwenden können. Diese + \emph{vor} \DescRef{scrlayer-scrpage.cmd.ihead} verwenden können. Diese Anweisung wird jedoch erst in \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs} auf \DescPageRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles} - erklärt werden. + erklärt werden. \end{Example}% Bitte beachten Sie, dass das leere optionale Argument bei \DescRef{scrlayer-scrpage.cmd.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.% + selbst ausprobieren und dabei den Fuß der ersten Seite beobachten.% \fi \IfThisCommonLabelBase{scrlayer-scrpage}{% Umbruchvarianten @@ -616,17 +616,17 @@ \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}} weitere Marken-Anweisungen.% }{% - Sollten die hier vorgestellten Möglichkeiten für Marken einmal nicht - ausreichen, so sind für fortgeschrittene Anwender ab + Sollten die hier vorgestellten Möglichkeiten für Marken einmal nicht + ausreichen, so sind für fortgeschrittene Anwender ab \IfThisCommonLabelBase{scrlayer-scrpage}{% \DescPageRef{scrlayer-scrpage-experts.cmd.righttopmark}}{% \DescPageRef{\ThisCommonLabelBase.cmd.righttopmark}} weitere Anweisungen dokumentiert.% }% \iffalse% Umbruchkorrektur - \ Beispielsweise ist für lexikonartige Dokumente das dort erklärte + \ Beispielsweise ist für lexikonartige Dokumente das dort erklärte \DescRef{scrlayer-scrpage-experts.cmd.leftfirstmark} und - \DescRef{scrlayer-scrpage-experts.cmd.rightbotmark} recht nützlich.% + \DescRef{scrlayer-scrpage-experts.cmd.rightbotmark} recht nützlich.% \fi \EndIndexGroup @@ -644,10 +644,10 @@ \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } intern üblicherweise verwendet, um die Gliederungsnummern der + } intern üblicherweise verwendet, um die Gliederungsnummern der automatischen Kolumnentitel zu formatieren. Dabei wird auch der \DescRef{maincls.cmd.autodot}-Mechanismus der \KOMAScript-Klassen - unterstützt. Bei Bedarf können diese Anweisungen umdefiniert werden, um eine + unterstützt. Bei Bedarf können diese Anweisungen umdefiniert werden, um eine andere Formatierung der Nummern zu erreichen.% \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{% \ Siehe dazu gegebenenfalls das Beispiel in @@ -661,7 +661,7 @@ Wollen Sie auf Abschnittsebene Kolumnentitel ohne Gliederungsnummer, geht das beispielsweise so: \else - Angenommen, Sie wollen, dass Abschnittsüberschriften im Kolumnentitel + Angenommen, Sie wollen, dass Abschnittsüberschriften im Kolumnentitel ohne Gliederungsnummer gesetzt werden, \iffree{so}{dann} ist das ganz einfach \iffree{mit:}{so zu erreichen:} \fi @@ -687,8 +687,8 @@ 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. + wird stattdessen automatisch über den aktuellen Zählerstand ermittelt, falls + mit nummerierten Ãœberschriften gearbeitet wird. Allerdings\textnote{Achtung!} verwenden nicht alle Klassen in allen Gliederungsebenen eine solche Anweisung. % @@ -698,15 +698,15 @@ }{% So wird beispielsweise \Macro{partmark} von den Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} nie - aufgerufen, während die \KOMAScript-Klassen selbstverständlich auch - \Macro{partmark} unterstützen.% + aufgerufen, während die \KOMAScript-Klassen selbstverständlich auch + \Macro{partmark} unterstützen.% } Falls diese Anweisungen vom Anwender umdefiniert werden, sollte er\textnote{Achtung!} unbedingt darauf achten, vor dem Setzen der Nummer - ebenfalls über \DescRef{maincls.counter.secnumdepth} zu prüfen, ob die + ebenfalls über \DescRef{maincls.counter.secnumdepth} zu prüfen, ob die Nummern auszugeben sind. Dies gilt auch, wenn der Anwender - \DescRef{maincls.counter.secnumdepth} selbst nicht verändert, weil Pakete + \DescRef{maincls.counter.secnumdepth} selbst nicht verändert, weil Pakete und Klassen sich eventuell auf die Wirkung von \DescRef{maincls.counter.secnumdepth} verlassen! @@ -714,9 +714,9 @@ \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } definiert diese Anweisungen außerdem bei jedem Aufruf von + } definiert diese Anweisungen außerdem bei jedem Aufruf von \DescRef{scrlayer.cmd.automark} oder \DescRef{scrlayer.cmd.manualmark} oder - den entsprechenden Optionen teilweise neu, um so die gewünschten + den entsprechenden Optionen teilweise neu, um so die gewünschten automatischen oder manuellen Kolumnentitel zu erreichen.% \EndIndexGroup @@ -726,16 +726,16 @@ \Macro{markright}\Parameter{rechte Marke} \Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke} \end{Declaration} - Unabhängig davon, ob gerade mit manuellen oder automatischen Kolumnentiteln + 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 + 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 \DescRef{maincls-experts.cmd.rightmark} in + auf der entsprechenden Seite gesetzte Marke ausgibt. Näheres dazu ist den + weiterführenden Erklärungen zu \DescRef{maincls-experts.cmd.rightmark} in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.cmd.rightmark} oder zu \DescRef{scrlayer.cmd.rightfirstmark}\IfThisCommonLabelBase{scrlayer}{}{ in @@ -743,16 +743,16 @@ \DescPageRef{scrlayer.cmd.rightfirstmark} zu entnehmen. Wird mit manuellen Kolumnentiteln\Index{Kolumnentitel>manuell} gearbeitet, - so bleiben die Marken gültig, bis sie durch erneute Verwendung der + 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 + 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.% + Auch im Zusammenhang mit den Sternvarianten der Gliederungsbefehle können + diese Anweisungen nützlich sein.% \IfThisCommonLabelBase{scrlayer-scrpage}{\iftrue}{% - \ Ausführliche Beispiele für die Verwendung von \Macro{markboth} mit dem + \ Ausführliche Beispiele für die Verwendung von \Macro{markboth} mit dem von \IfThisCommonLabelBase{scrlayer-scrpage}{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% }{% @@ -768,7 +768,7 @@ \begin{Example} \phantomsection\xmpllabel{cmd.markboth}% Angenommen, Sie schreiben noch vor dem Inhaltsverzeichnis ein Vorwort - über mehrere Seiten, das jedoch im Inhaltsverzeichnis nicht auf"|tauchen + über mehrere Seiten, das jedoch im Inhaltsverzeichnis nicht auf"|tauchen soll. Da Sie aber Trennlinien im Kopf verwenden, soll der Kolumnentitel das Vorwort dennoch zeigen: \begin{lstcode} @@ -784,10 +784,10 @@ \blinddocument \end{document} \end{lstcode} - Zunächst erscheint das Ergebnis wunschgemäß. Vielleicht erst 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: + Zunächst erscheint das Ergebnis wunschgemäß. Vielleicht erst 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[automark]{scrlayer-scrpage} @@ -812,7 +812,7 @@ \Index{Inhaltsverzeichnis}\IndexCmd{tableofcontents}% \important{\DescRef{maincls.cmd.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 + das Vorwort als Kolumnentitel nun »\texttt{CONTENTS}« trägt. Das liegt an einer Eigenart von \DescRef{maincls.cmd.chapter*}% \IndexCmd{chapter*}\important{\DescRef{maincls.cmd.chapter*}} (siehe auch in \autoref{sec:maincls.structure} auf @@ -846,28 +846,28 @@ Diese Anweisung wird in der Voreinstellung zur Formatierung aller Gliederungsnummern in automatischen Kolumnentiteln unterhalb der Unterabschnitte und bei Klassen ohne \DescRef{maincls.cmd.chapter} - zusätzlich auch für die Ebene der Abschnitte und Unterabschnitte verwendet, + 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 + eine Anweisung verwendet, die bereits vom \LaTeX-Kern für Klassen und Pakete bereitgestellt und von \KOMAScript{} etwas modifiziert 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}). + 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.% + 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.% \IfThisCommonLabelBase{scrlayer-scrpage-experts}{\iftrue}{% \par % - Ein ausführliches Beispiel für das Zusammenspiel der Anweisung + Ein ausführliches Beispiel für das Zusammenspiel der Anweisung \Macro{GenericMarkFormat} mit den auf - \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} erklärten Anweisungen + \DescPageRef{\ThisCommonLabelBase.cmd.chaptermark} erklärten Anweisungen \DescRef{\ThisCommonLabelBase.cmd.sectionmarkformat} und \DescRef{\ThisCommonLabelBase.cmd.subsectionmarkformat} beziehungsweise \DescRef{\ThisCommonLabelBase.cmd.chaptermarkformat} bei Verwendung des @@ -886,7 +886,7 @@ \phantomsection \xmpllabel{cmd.GenericMarkFormat}% Angenommen, Sie wollen, dass bei allen Gliederungsnummern im - Kolumnentitel eines Artikels die Nummer als weiße Schrift auf einem + Kolumnentitel eines Artikels die Nummer als weiße Schrift auf einem schwarzen Kasten ausgegeben wird. Da bei Artikeln mit \Class{article} die Anweisungen \DescRef{scrlayer.cmd.sectionmarkformat}% \IndexCmd{sectionmarkformat}% @@ -899,7 +899,7 @@ }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% } mit Hilfe von - \Macro{GenericMarkFormat} definiert werden, genügt dafür die + \Macro{GenericMarkFormat} definiert werden, genügt dafür die entsprechende Umdefinierung dieser einen Anweisung: \begin{lstcode}[moretexcs={colorbox,textcolor}] \documentclass{article} @@ -919,29 +919,29 @@ \blinddocument \end{document} \end{lstcode} - Für die Farbumschaltungen werden Anweisungen des Pakets - \Package{xcolor}\IndexPackage{xcolor} verwendet. Näheres dazu ist der + 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. + 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 + 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 + 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 würden, die gar - nicht definiert sind. Alternativ könnte man \Macro{numberbox} auch mit + \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 würden, 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 + Standardklassen \Class{book} oder \Class{report} erreichen, so müsste + man übrigens zusätzlich \DescRef{scrlayer.cmd.sectionmarkformat}% \IndexCmd{sectionmarkformat}% \important{\DescRef{scrlayer.cmd.sectionmarkformat}} und -- @@ -991,22 +991,22 @@ \Macro{leftbotmark} \Macro{leftfirstmark} \end{Declaration} - \LaTeX\ChangedAt{v3.16}{\Package{scrlayer}} verwendet für die Seitenstile + \LaTeX\ChangedAt{v3.16}{\Package{scrlayer}} verwendet für die Seitenstile normalerweise eine zweiteilige \TeX-Marke. Im Kolumnentitel kann auf den linken Teil der Marke mit \DescRef{scrlayer.cmd.leftmark}% \important{\DescRef{scrlayer.cmd.leftmark}}\IndexCmd{leftmark} zugegriffen - werden, während der rechte Teil der Marke über + werden, während der rechte Teil der Marke über \DescRef{scrlayer.cmd.rightmark}% - \important{\DescRef{scrlayer.cmd.rightmark}}\IndexCmd{rightmark} verfügbar - ist. Tatsächlich ist es wohl auch so gedacht, dass - \DescRef{scrlayer.cmd.leftmark} für linke Seiten und - \DescRef{scrlayer.cmd.rightmark} für rechte Seiten im doppelseitigen Druck + \important{\DescRef{scrlayer.cmd.rightmark}}\IndexCmd{rightmark} verfügbar + ist. Tatsächlich ist es wohl auch so gedacht, dass + \DescRef{scrlayer.cmd.leftmark} für linke Seiten und + \DescRef{scrlayer.cmd.rightmark} für rechte Seiten im doppelseitigen Druck verwendet wird. Im einseitigen Layout setzen die Gliederungsbefehle der Standardklassen den linken Teil der Marke hingegen gar nicht erst. - \TeX{} selbst kennt drei Möglichkeiten, auf eine Marke zuzugreifen. Die + \TeX{} selbst kennt drei Möglichkeiten, auf eine Marke zuzugreifen. Die \Macro{botmark}\IndexCmd{botmark}\important{\Macro{botmark}} ist die auf der - zuletzt zusammengestellten Seite zuletzt gültige Marke. Das entspricht der + zuletzt zusammengestellten Seite zuletzt gültige Marke. Das entspricht der zuletzt gesetzten Marke der Seite. Wurde auf der Seite keine Marke gesetzt, so entspricht es der zuletzt gesetzten Marke auf den bereits ausgegebenen Seiten. Die \LaTeX-Anweisung \DescRef{scrlayer.cmd.leftmark} verwendet genau @@ -1033,7 +1033,7 @@ \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } die Möglichkeit mit \Macro{lefttopmark}\important{\Macro{lefttopmark}} auf + } die Möglichkeit mit \Macro{lefttopmark}\important{\Macro{lefttopmark}} auf den linken Teil dieser Marke und mit \Macro{righttopmark}\important{\Macro{righttopmark}} auf den rechten Teil zuzugreifen. @@ -1041,39 +1041,39 @@ Es\textnote{Achtung!} ist zu beachten, dass der linke und rechte Teil der Marke immer nur gemeinsam gesetzt werden kann. Selbst wenn man mit \DescRef{scrlayer.cmd.markright}\IndexCmd{markright} nur den rechten Teil - verändert, wird der linke Teil (unverändert) mit gesetzt. Entsprechend - setzen im doppelseitigen Layout die höheren Gliederungsebenen beim + verändert, wird der linke Teil (unverändert) mit gesetzt. Entsprechend + setzen im doppelseitigen Layout die höheren Gliederungsebenen beim Seitenstil \PageStyle{headings}\important{\PageStyle{headings}}\IndexPagestyle{headings} immer beide Teile. Beispielsweise verwendet \DescRef{scrlayer.cmd.chaptermark} dann \DescRef{scrlayer.cmd.markboth} mit einem leeren rechten Argument. Das ist auch der Grund, warum \DescRef{scrlayer.cmd.rightmark} beziehungsweise - \Macro{rightfirstmark} auf der Seite einer Kapitelüberschrift immer einen - leeren Wert zurück gibt, selbst wenn danach beispielsweise über - \DescRef{scrlayer.cmd.sectionmark} oder indirekt über + \Macro{rightfirstmark} auf der Seite einer Kapitelüberschrift immer einen + leeren Wert zurück gibt, selbst wenn danach beispielsweise über + \DescRef{scrlayer.cmd.sectionmark} oder indirekt über \DescRef{maincls.cmd.section} ein neuer rechter Teil \IfThisCommonLabelBase{scrlayer-scrpage}{der Marke}{\unskip} gesetzt wurde. Bitte\textnote{Achtung!} beachten Sie, dass die Verwendung einer der hier - erklärten Anweisungen zur Ausgabe des linken oder rechten Teils der Marke - innerhalb einer Seite zu unerwarteten Ergebnissen führen kann. Sie sind - wirklich nur zur Verwendung im Kopf oder Fuß eines Seitenstils + erklärten Anweisungen zur Ausgabe des linken oder rechten Teils der Marke + innerhalb einer Seite zu unerwarteten Ergebnissen führen kann. Sie sind + wirklich nur zur Verwendung im Kopf oder Fuß eines Seitenstils gedacht. Daher sollten sie bei \IfThisCommonLabelBase{scrlayer}{% \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% } immer Teil des Inhalts einer Ebene sein. Dagegen spielt es keine Rolle, ob sie auf den Hintergrund - oder den Vordergrund beschränkt werden, da alle Ebenen erst nach der + oder den Vordergrund beschränkt werden, da alle Ebenen erst nach der Zusammenstellung der aktuellen Seite ausgegeben werden. - Näheres zum Mark-Mechanismus \iffree{von \TeX{}}{\unskip} ist beispielsweise + Näheres zum Mark-Mechanismus \iffree{von \TeX{}}{\unskip} ist beispielsweise \cite[Kapitel~23]{knuth:texbook} zu entnehmen. Das Thema ist dort als absolutes Expertenwissen markiert.\IfThisCommonLabelBase{scrlayer}{ % Umbruchkorrektur - Sollte Sie obige Erklärung also eher + Sollte Sie obige Erklärung also eher verwirrt haben, machen Sie sich bitte nichts daraus.}{}% \EndIndexGroup @@ -1089,21 +1089,21 @@ \DescRef{scrlayer.option.automark} und Anweisung \DescRef{scrlayer.cmd.automark} auf \DescPageRef{scrlayer.cmd.automark}) aktiviert sind. Bei - den Standardklassen geht dies ausschließlich über \Macro{@mkboth}. Diese + den Standardklassen geht dies ausschließlich über \Macro{@mkboth}. Diese Anweisung entspricht entweder \Macro{@gobbletwo}, einer Anweisung, die ihre beiden Argumente vernichtet, oder \DescRef{scrlayer.cmd.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 + \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 + Marke} setzen, ohne die jeweils andere Marke zu verändern, so fehlen entsprechende Anweisungen. Das Paket \IfThisCommonLabelBase{scrlayer}{% \Package{scrlayer}% }{% \hyperref[cha:scrlayer]{\Package{scrlayer}}% - } selbst benötigt entsprechende Anweisungen beispielsweise im Rahmen der + } 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 @@ -1113,18 +1113,18 @@ }{% \hyperref[cha:scrlayer]{\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 + 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 die passende der vier - Anweisungen zurückgreifen, wenn sie linke oder rechte Marken setzen und - dies auf den Fall beschränken wollen, dass mit automatischen Kolumnentiteln + Klassen- und Paketautoren können ebenfalls auf die passende der vier + Anweisungen zurückgreifen, wenn sie linke oder rechte Marken setzen und + dies auf den Fall beschränken wollen, dass mit automatischen Kolumnentiteln gearbeitet wird.% \EndIndexGroup \fi \IfThisCommonLabelBase{scrlayer}{% - Zu weiteren Möglichkeiten zur Beeinflussung der Inhalte von Seitenstilen + Zu weiteren Möglichkeiten zur Beeinflussung der Inhalte von Seitenstilen siehe auch \autoref{sec:scrlayer-scrpage.pagestyle.content}, \autopageref{sec:scrlayer-scrpage.pagestyle.content}.% }{}% @@ -1133,19 +1133,19 @@ %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% 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: 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: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift +% LocalWords: Maßlinien Entwurfsphase Unterabschnittsüberschrift Versalsatz +% LocalWords: Abschnittsüberschrift Kapitelüberschrift Glyphenanalyse % LocalWords: Hilfsanweisung content Expertenwissen Gliederungsebenen -% LocalWords: Gliederungsüberschriften Kapitelüberschriften Kolumnentitel -% LocalWords: Abschnittsüberschriften Gliederungsnummer Kapitelanfangsseite +% LocalWords: Gliederungsüberschriften Kapitelüberschriften Kolumnentitel +% LocalWords: Abschnittsüberschriften Gliederungsnummer Kapitelanfangsseite % LocalWords: Kolumnentiteln Abschnittsebene Paketautoren diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-parmarkup.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-parmarkup.tex index 951953fb82..1a9aabce11 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-parmarkup.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-parmarkup.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-parmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-parmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-parmarkup.tex} - [$Date: 2018-01-31 13:56:21 +0100 (Wed, 31 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] \section{Absatzauszeichnung} @@ -56,56 +56,56 @@ \IfThisCommonLabelBase{maincls}{% Die\textnote{Absatzeinzug vs. Absatzabstand} Standardklassen setzen - Absätze\Index[indexmain]{Absatz} normalerweise mit Absatzeinzug und ohne + Absätze\Index[indexmain]{Absatz} normalerweise mit Absatzeinzug und ohne Absatzabstand. Bei Verwendung eines normalen Satzspiegels, wie ihn \Package{typearea} bietet, ist dies die vorteilhafteste - Absatzauszeichnung. Würde man ohne Einzug und Abstand arbeiten, hätte der - Leser als Anhaltspunkt nur die Länge der letzten Zeile. Im Extremfall kann + Absatzauszeichnung. Würde man ohne Einzug und Abstand arbeiten, hätte der + Leser als Anhaltspunkt nur die Länge der letzten Zeile. Im Extremfall kann es sehr schwer sein zu erkennen, ob eine Zeile voll ist oder nicht. Des Weiteren stellt der Typograf fest, dass die Auszeichnung des Absatzendes am - Anfang der nächsten Zeile leicht vergessen ist. Demgegenüber ist eine - Auszeichnung am Absatzanfang einprägsamer. Der Absatzabstand hat den + Anfang der nächsten Zeile leicht vergessen ist. Demgegenüber ist eine + Auszeichnung am Absatzanfang einprägsamer. Der Absatzabstand hat den Nachteil, dass er in verschiedenem Zusammenhang leicht verloren geht. So - wäre nach einer abgesetzten Formel nicht mehr festzustellen, ob der Absatz - fortgesetzt wird oder ein neuer beginnt. Auch am Seitenanfang müsste - zurückgeblättert werden, um feststellen zu können, ob mit der Seite auch ein + wäre nach einer abgesetzten Formel nicht mehr festzustellen, ob der Absatz + fortgesetzt wird oder ein neuer beginnt. Auch am Seitenanfang müsste + zurückgeblättert werden, um feststellen zu können, ob mit der Seite auch ein neuer Absatz beginnt. All diese Probleme sind beim Absatzeinzug nicht gegeben. Eine Kombination von Absatzeinzug und Absatzabstand ist wegen der - übertriebenen Redundanz abzulehnen. Der Einzug\Index[indexmain]{Einzug} + übertriebenen Redundanz abzulehnen. Der Einzug\Index[indexmain]{Einzug} alleine ist deutlich genug. Der einzige Nachteil des Absatzeinzugs liegt in - der Verkürzung der Zeile. Damit gewinnt der + der Verkürzung der Zeile. Damit gewinnt der Absatzabstand\Index{Absatz>Abstand} bei ohnehin kurzen Zeilen, etwa im Zeitungssatz, seine Berechtigung.% }{% \IfThisCommonLabelBase{scrlttr2}{% In der Einleitung zu \autoref{sec:maincls.parmarkup} ab \autopageref{sec:maincls.parmarkup} wird dargelegt, warum der Absatzeinzug - gegenüber dem Absatzabstand vorzuziehen ist. Die Elemente, auf die sich + gegenüber dem Absatzabstand vorzuziehen ist. Die Elemente, auf die sich diese Argumente beziehen, beispielsweise Abbildungen, Tabellen, Listen, abgesetzte Formeln und auch neue Seiten, sind in Standardbriefen eher - selten. Auch sind Briefe normalerweise nicht so umfänglich, dass ein nicht + selten. Auch sind Briefe normalerweise nicht so umfänglich, dass ein nicht erkannter Absatz sich schwerwiegend auf die Lesbarkeit auswirkt. Die - Argumente sind daher bei Standardbriefen eher schwach. Dies dürfte ein - Grund dafür sein, dass der Absatzabstand bei Briefen eher gebräuchlich - ist. Es bleiben damit für Standardbriefe im Wesentlichen zwei Vorteile des + Argumente sind daher bei Standardbriefen eher schwach. Dies dürfte ein + Grund dafür sein, dass der Absatzabstand bei Briefen eher gebräuchlich + ist. Es bleiben damit für Standardbriefe im Wesentlichen zwei Vorteile des Absatzeinzugs. Zum einen hebt sich ein solcher Brief aus der Masse hervor - und zum anderen durchbricht man damit nicht nur für Briefe das + und zum anderen durchbricht man damit nicht nur für Briefe das einheitliche Erscheinungsbild aller Dokumente aus einer Quelle, die so genannte \emph{Corporate Identity}.% }{\InternalCommonFileUsageError}% } % \IfThisCommonFirstRun{}{% - Über diese Überlegungen hinaus gilt sinngemäß, was in + Ãœber diese Ãœberlegungen hinaus gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.parmarkup} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.parmarkup} bereits - gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf + gelesen und verstanden haben, können Sie nach dem Ende dieses Abschnitts auf \autopageref{sec:\ThisCommonLabelBase.parmarkup.next} mit \autoref{sec:\ThisCommonLabelBase.parmarkup.next} fortfahren.% \IfThisCommonLabelBase{scrlttr2}{ % Dies gilt ebenso, wenn Sie nicht mit Klasse \Class{scrlttr2}\OnlyAt{scrlttr2}, sondern mit Paket \Package{scrletter} - arbeiten. Das Paket bietet keine eigenen Einstellungen für die - Absatzauszeichnung, sondern verlässt sich dabei ganz auf die verwendete + arbeiten. Das Paket bietet keine eigenen Einstellungen für die + Absatzauszeichnung, sondern verlässt sich dabei ganz auf die verwendete Klasse.% }{}% } @@ -121,19 +121,19 @@ \Class{scrreprt}\and \Class{scrartcl}} % }{% \IfThisCommonLabelBase{scrlttr2}{% - Bei Briefen findet man häufiger ein Layout mit Absatzabstand anstelle des + Bei Briefen findet man häufiger ein Layout mit Absatzabstand anstelle des voreingestellten Absatzeinzugs. Die \KOMAScript-Klasse \Class{scrlttr2}\OnlyAt{scrlttr2} bietet mit der Option \Option{parskip} % }{\InternalCommonFileUsageError}% }% -eine Reihe von Möglichkeiten, um dies zu erreichen. Die \PName{Methode} setzt +eine Reihe von Möglichkeiten, um dies zu erreichen. Die \PName{Methode} setzt sich dabei aus zwei Teilen zusammen. Der erste Teil ist entweder \PValue{full}\important{\OptionValue{parskip}{full}\\ - \OptionValue{parskip}{half}} oder \PValue{half}, wobei \PValue{full} für -einen Absatzabstand von einer Zeile und \PValue{half} für einen Absatzabstand + \OptionValue{parskip}{half}} oder \PValue{half}, wobei \PValue{full} für +einen Absatzabstand von einer Zeile und \PValue{half} für einen Absatzabstand von einer halben Zeile steht. Der zweite Teil ist eines der Zeichen -»\PValue{*}«, »\PValue{+}«, »\PValue{-}« und kann auch entfallen. Lässt man +»\PValue{*}«, »\PValue{+}«, »\PValue{-}« und kann auch entfallen. Lässt man das Zeichen\important{\OptionVName{parskip}{Abstand}} weg, so wird in der letzten Zeile des Absatzes am Ende mindestens ein Geviert, das ist 1\Unit{em}, frei gelassen. Mit dem @@ -142,10 +142,10 @@ Zeilenende mindestens ein Drittel und mit dem Stern\important{\OptionValue{parskip}{\PName{Abstand}*}} mindestens ein Viertel einer normalen Zeile frei gelassen. Mit der Minus-Variante\important{\OptionValue{parskip}{\PName{Abstand}-}} werden keine -Vorkehrungen für die letzte Zeile eines Absatzes getroffen. +Vorkehrungen für die letzte Zeile eines Absatzes getroffen. -Die Einstellung kann jederzeit geändert werden. Wird sie innerhalb des -Dokuments geändert, so wird implizit die Anweisung +Die Einstellung kann jederzeit geändert werden. Wird sie innerhalb des +Dokuments geändert, so wird implizit die Anweisung \Macro{selectfont}\IndexCmd{selectfont}% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and @@ -157,20 +157,20 @@ Dokuments geändert, so wird implizit die Anweisung \InternalComonFileUsageError% }% } % -ausgeführt. Änderungen der Absatzauszeichnung innerhalb eines Absatzes +ausgeführt. Änderungen der Absatzauszeichnung innerhalb eines Absatzes werden erst am Ende des Absatzes sichtbar. -Neben den sich so ergebenden acht Kombinationen ist es noch möglich, als -\PName{Methode} die Werte für einfache Schalter aus +Neben den sich so ergebenden acht Kombinationen ist es noch möglich, als +\PName{Methode} die Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} zu verwenden. Das Einschalten der Option\important{\Option{parskip}\\\OptionValue{parskip}{true}} entspricht -dabei \PValue{full} ohne angehängtes Zeichen für den Freiraum der letzten +dabei \PValue{full} ohne angehängtes Zeichen für den Freiraum der letzten Absatzzeile, also mit mindestens einem Geviert Freiraum am Ende des Absatzes. Das Ausschalten\important{\OptionValue{parskip}{false}} der Option schaltet hingegen wieder auf Absatzeinzug von einem Geviert um. Dabei darf die -letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Überblick -über alle möglichen Werte für \PName{Methode} bietet +letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Ãœberblick +über alle möglichen Werte für \PName{Methode} bietet \autoref{tab:\ThisCommonFirstLabelBase.parskip}% \IfThisCommonFirstRun{.% \begin{desclist} @@ -180,55 +180,55 @@ letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Überblick % \begin{table} \desccaption % \caption - [{Mögliche Werte für Option \Option{parskip}}]{% - Mögliche Werte für Option \Option{parskip} zur Auswahl der Kennzeichnung - von Absätzen\label{tab:\ThisCommonFirstLabelBase.parskip}% + [{Mögliche Werte für Option \Option{parskip}}]{% + Mögliche Werte für Option \Option{parskip} zur Auswahl der Kennzeichnung + von Absätzen\label{tab:\ThisCommonFirstLabelBase.parskip}% }% {% - Mögliche Werte für Option \Option{parskip} (\emph{Fortsetzung})% + Mögliche Werte für Option \Option{parskip} (\emph{Fortsetzung})% }% % \begin{desctabular} \entry{\PValue{false}, \PValue{off}, \PValue{no}% \IndexOption{parskip~=\textKValue{false}}}{% - Absätze werden durch einen Einzug der ersten Zeilen von einem Geviert + Absätze werden durch einen Einzug der ersten Zeilen von einem Geviert (1\Unit{em}) gekennzeichnet. Der erste Absatz eines Abschnitts wird nicht eingezogen.}% \entry{\PValue{full}, \PValue{true}, \PValue{on}, \PValue{yes}% \IndexOption{parskip~=\textKValue{full}}% }{% - Absätze werden durch einen vertikalen Abstand von einer Zeile + Absätze werden durch einen vertikalen Abstand von einer Zeile gekennzeichnet, Absatzenden durch einen Leerraum von mind. einem Geviert (1\Unit{em}) der Grundschrift am Ende der letzten Zeile.}% \pventry{full-}{% - Absätze werden durch einen vertikalen Abstand von einer Zeile + Absätze werden durch einen vertikalen Abstand von einer Zeile gekennzeichnet. Absatzenden werden nicht gekennzeichnet.\IndexOption{parskip~=\textKValue{full-}}}% \pventry{full+}{% - \looseness=-1 Absätze werden durch einen vertikalen Abstand von einer + \looseness=-1 Absätze werden durch einen vertikalen Abstand von einer Zeile gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem Drittel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=\textKValue{full+}}}% \pventry{full*}{% - Absätze werden durch einen vertikalen Abstand von einer Zeile + Absätze werden durch einen vertikalen Abstand von einer Zeile gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem Viertel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=\textKValue{full*}}}% \pventry{half}{% - Absätze werden durch einen vertikalen Abstand von einer halben Zeile + Absätze werden durch einen vertikalen Abstand von einer halben Zeile gekennzeichnet. Absatzenden durch einen Leerraum von mind. einem Geviert (1\Unit{em}) der normalen Schrift am Ende gekennzeichnet.\IndexOption{parskip~=\textKValue{half}}}% \pventry{half-}{% - Absätze werden durch einen vertikalen Abstand von einer halben Zeile + Absätze werden durch einen vertikalen Abstand von einer halben Zeile gekennzeichnet. Absatzenden werden nicht gekennzeichnet.\IndexOption{parskip~=half-}}% \pventry{half+}{% - Absätze werden durch einen vertikalen Abstand von einer halben Zeile + Absätze werden durch einen vertikalen Abstand von einer halben Zeile gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem Drittel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=\textKValue{half+}}}% \pventry{half*}{% - Absätze werden durch einen vertikalen Abstand von einer Zeile + Absätze werden durch einen vertikalen Abstand von einer Zeile gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem Viertel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=\textKValue{half*}}}% @@ -240,9 +240,9 @@ letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Überblick }{% \IfThisCommonLabelBase{scrlttr2}{\ChangedAt{v3.08}{\Class{scrlttr2}}}{}% }% - wird auch dann kein Abstand zwischen Absätzen eingefügt, wenn für den + wird auch dann kein Abstand zwischen Absätzen eingefügt, wenn für den vertikalen Ausgleich der Einstellung - \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} zusätzlicher + \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} zusätzlicher vertikaler Abstand verteilt werden muss.\IndexOption{parskip~=\textKValue{never}}}% % \end{desctabular} @@ -250,14 +250,14 @@ letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen Überblick \end{desclist}% }{ auf \autopageref{tab:\ThisCommonFirstLabelBase.parskip}.} -Wird\textnote{Achtung!} ein Absatzabstand verwendet, so verändert sich auch +Wird\textnote{Achtung!} ein Absatzabstand verwendet, so verändert sich auch der Abstand vor, nach und innerhalb von Listenumgebungen. Dadurch wird -verhindert, dass diese Umgebungen oder Absätze innerhalb dieser Umgebungen -stärker vom Text abgesetzt werden als die Absätze des normalen Textes +verhindert, dass diese Umgebungen oder Absätze innerhalb dieser Umgebungen +stärker vom Text abgesetzt werden als die Absätze des normalen Textes voneinander.% \IfThisCommonLabelBase{maincls}{ % Inhalts"~, Abbildungs"~ und Tabellenverzeichnis werden immer ohne - zusätzlichen Absatzabstand gesetzt.% + zusätzlichen Absatzabstand gesetzt.% }{% \iffalse% \ Verschiedene Elemente des Briefbogens werden immer ohne Absatzabstand @@ -276,6 +276,6 @@ einen Absatzeinzug von 1\Unit{em}.% %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-textmarkup.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-textmarkup.tex index 25d7649217..158b932b05 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-textmarkup.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-textmarkup.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-textmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-textmarkup.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-textmarkup.tex} - [$Date: 2018-07-20 09:52:01 +0200 (Fri, 20 Jul 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (common paragraphs)] \section{Textauszeichnungen} @@ -56,36 +56,36 @@ \BeginIndex{}{Schrift>Art}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.textmarkup} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.textmarkup} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.textmarkup} bereits gelesen und - verstanden haben, können Sie + verstanden haben, können Sie \IfThisCommonLabelBaseOneOf{scrextend,scrjura,scrlayer-notecolumn}{}{% sich auf \autoref{tab:\ThisCommonLabelBase.fontelements}, - \autopageref{tab:\ThisCommonLabelBase.fontelements} beschränken und + \autopageref{tab:\ThisCommonLabelBase.fontelements} beschränken und ansonsten }% auf \autopageref{sec:\ThisCommonLabelBase.textmarkup.next} mit \autoref{sec:\ThisCommonLabelBase.textmarkup.next} fortfahren.% - \IfThisCommonLabelBase{scrextend}{\ Für diesen Fall sei jedoch darauf - hingewiesen\textnote{Einschränkung} dass von \Package{scrextend} aus + \IfThisCommonLabelBase{scrextend}{\ Für diesen Fall sei jedoch darauf + hingewiesen\textnote{Einschränkung} dass von \Package{scrextend} aus \autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements} - nur die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten - und die \DescRef{maincls.env.labeling}-Umgebung unterstützt werden. Das + nur die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten + und die \DescRef{maincls.env.labeling}-Umgebung unterstützt werden. Das Element \DescRef{maincls.fontelement.disposition} ist zwar auch vorhanden, - wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel + wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel verwendet.% }{}% } % Umbruchkorrektur \IfThisCommonLabelBase{scrlayer-scrpage}{}{% - \LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur + \LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur Textauszeichnung. % \IfThisCommonLabelBaseOneOf{scrlttr2}{}{% - Neben der Wahl der Schriftart gehören dazu auch Befehle zur Wahl einer - Textgröße oder der Textausrichtung. % + 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}, +Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz}, \cite{latex:usrguide} und \cite{latex:fntguide} zu entnehmen.}% \IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura,scrlayer-notecolumn}{% @@ -98,20 +98,20 @@ Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz}, \end{Declaration} Im \LaTeX-Kern ist bereits die Anweisung \Macro{textsuperscript}\IndexCmd{textsuperscript} definiert, mit der - \PName{Text} höher gestellt werden kann. Eine + \PName{Text} höher gestellt werden kann. Eine entsprechende Anweisung, um Text tief\Index{Tiefstellung} statt hoch\Index{Hochstellung} zu stellen, bietet \LaTeX{}\textnote{\LaTeX~2015/01/01} erst seit Version - 2015/01/01. Für ältere \LaTeX-Versionen definiert \KOMAScript{} daher + 2015/01/01. Für ältere \LaTeX-Versionen definiert \KOMAScript{} daher \Macro{textsubscript}. % \ifthiscommonfirst \begin{Example} \phantomsection \xmpllabel{cmd.textsubscript}% - Sie schreiben einen Text über den menschlichen Stoffwechsel. Darin + Sie schreiben einen Text über den menschlichen Stoffwechsel. Darin kommen hin und wieder einfache chemische Summenformeln vor. Dabei sind einzelne Ziffern tief zu stellen. Im Sinne des logischen Markups - definieren Sie zunächst in der Dokumentpräambel oder einem eigenen + definieren Sie zunächst in der Dokumentpräambel oder einem eigenen Paket: \begin{lstcode} \newcommand*{\Molek}[2]{#1\textsubscript{#2}} @@ -135,9 +135,9 @@ Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz}, den Stoffwechsel sehr nachteilig aus. \end{ShowOutput} - Etwas später entscheiden Sie, dass Summenformeln grundsätzlich + Etwas später entscheiden Sie, dass Summenformeln grundsätzlich serifenlos geschrieben werden sollen. Nun zeigt sich, wie gut die - Entscheidung für konsequentes logisches Markup war. Sie müssen nur die + Entscheidung für konsequentes logisches Markup war. Sie müssen nur die \Macro{Molek}-Anweisung umdefinieren: \begin{lstcode} \newcommand*{\Molek}[2]{% @@ -145,7 +145,7 @@ Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz}, } \end{lstcode} \renewcommand*{\Molek}[2]{\textsf{#1\textsubscript{#2}}}% - Schon ändert sich die Ausgabe im gesamten Dokument: + Schon ändert sich die Ausgabe im gesamten Dokument: \begin{ShowOutput} Die Zelle bezieht ihr Energie unter anderem aus der Reaktion von \Molek C6\Molek H{12}\Molek O6 und \Molek O2 zu \Molek H2\Molek @@ -153,8 +153,8 @@ Näheres zu den normalerweise definierten Möglichkeiten ist \cite{l2kurz}, auf den Stoffwechsel sehr nachteilig aus. \end{ShowOutput} \end{Example} - \iffalse % vielleicht in einer späteren Auf-lage - Für Experten ist in \autoref{sec:experts.knowhow}, + \iffalse % vielleicht in einer späteren Auf-lage + Für Experten ist in \autoref{sec:experts.knowhow}, \DescPageRef{experts.macroargs} dokumentiert, warum das Beispiel funktioniert, obwohl teilweise die Argumente von \Macro{Molek} nicht in geschweifte Klammern gesetzt wurden.% @@ -178,36 +178,36 @@ Mit% \ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% }{} Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} ist es -möglich, die \PName{Befehle} festzulegen, mit denen die Schrift eines -bestimmten \PName{Element}s umgeschaltet wird. Theoretisch könnten als -\PName{Befehle} alle möglichen Anweisungen einschließlich Textausgaben +möglich, die \PName{Befehle} festzulegen, mit denen die Schrift eines +bestimmten \PName{Element}s umgeschaltet wird. Theoretisch könnten als +\PName{Befehle} alle möglichen Anweisungen einschließlich Textausgaben verwendet werden. Sie\textnote{Achtung!} sollten sich jedoch unbedingt auf -solche Anweisungen beschränken, mit denen wirklich nur Schriftattribute +solche Anweisungen beschränken, mit denen wirklich nur Schriftattribute umgeschaltet werden. In der Regel werden dies Befehle wie \Macro{rmfamily}, \Macro{sffamily}, \Macro{ttfamily}, \Macro{upshape}, \Macro{itshape}, \Macro{slshape}, \Macro{scshape}, \Macro{mdseries}, \Macro{bfseries}, \Macro{normalfont} oder einer der Befehle \Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large}, \Macro{large}, \Macro{normalsize}, \Macro{small}, \Macro{footnotesize}, \Macro{scriptsize} und \Macro{tiny} -sein. Die Erklärung zu diesen Befehlen entnehmen Sie bitte \cite{l2kurz}, +sein. Die Erklärung zu diesen Befehlen 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 +\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. +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.% +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} +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 +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.% \IfThisCommonLabelBase{scrlayer-notecolumn}{}{% \ Namen und Bedeutung der einzelnen Elemente @@ -221,11 +221,11 @@ zu den jeweiligen Elementen.% }% aufgelistet.% \IfThisCommonLabelBase{scrextend}{ % - Allerdings werden davon in \Package{scrextend} nur\textnote{Einschränkung} - die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten und + Allerdings werden davon in \Package{scrextend} nur\textnote{Einschränkung} + die Elemente für den Dokumenttitel, den schlauen Spruch, die Fußnoten und die \DescRef{maincls.env.labeling}-Umgebung behandelt. Das Element - \DescRef{maincls.fontelement.disposition} ist zwar auch verfügbar, wird - jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel + \DescRef{maincls.fontelement.disposition} ist zwar auch verfügbar, wird + jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel verwendet.% }{% \IfThisCommonLabelBase{scrlayer-scrpage}{ % @@ -244,18 +244,18 @@ zu den jeweiligen Elementen.% \IfThisCommonLabelBaseOneOf{scrlttr2,scrextend}{% Umbruchvarianten Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf die - für das angegebene \PName{Element} umgeschaltet werden.% + für das angegebene \PName{Element} umgeschaltet werden.% }{% Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf - diejenige umgeschaltet werden, die für das angegebene \PName{Element} + diejenige umgeschaltet werden, die für das angegebene \PName{Element} definiert ist.% } \IfThisCommonLabelBase{maincls}{\iftrue}{\csname iffalse\endcsname} \begin{Example} \phantomsection\xmpllabel{cmd.setkomafont}% - Angenommen, für das Element + Angenommen, für das Element \DescRef{\ThisCommonLabelBase.fontelement.captionlabel} soll dieselbe - Schriftart wie für + Schriftart wie für \DescRef{\ThisCommonLabelBase.fontelement.descriptionlabel} verwendet werden. Das erreichen Sie einfach mit: \begin{lstcode} @@ -271,11 +271,11 @@ zu den jeweiligen Elementen.% \desccaption{% Elemente, deren Schrift bei \Class{scrbook}, \Class{scrreprt} oder \Class{scrartcl} mit \Macro{setkomafont} und \Macro{addtokomafont} - verändert werden kann% + verändert werden kann% \label{tab:maincls.fontelements}% \label{tab:scrextend.fontelements}% }{% - Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})% + Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})% }% \feentry{author}{% \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and @@ -285,15 +285,15 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.cmd.author} (siehe \autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.author})}% \feentry{caption}{Text einer Abbildungs- oder Tabellenunter- oder - "~überschrift (siehe \autoref{sec:maincls.floats}, + "~überschrift (siehe \autoref{sec:maincls.floats}, \DescPageRef{maincls.cmd.caption})}% \feentry{captionlabel}{% - Label einer Abbildungs- oder Tabellenunter- oder "~überschrift; + Label einer Abbildungs- oder Tabellenunter- oder "~überschrift; Anwendung erfolgt nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.caption} (siehe \autoref{sec:maincls.floats}, \DescPageRef{maincls.cmd.caption})}% \feentry{chapter}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.chapter} (siehe + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.chapter} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.chapter})}% \feentry{chapterentry}{% Inhaltsverzeichniseintrag der Ebene @@ -301,7 +301,7 @@ zu den jeweiligen Elementen.% \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% \feentry{chapterentrydots}{% \ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}% - Optionale Verbindungspunkte in Inhaltsverzeichniseinträgen der Ebene + Optionale Verbindungspunkte in Inhaltsverzeichniseinträgen der Ebene \DescRef{\ThisCommonLabelBase.cmd.chapter} abweichend vom Element \DescRef{\ThisCommonLabelBase.fontelement.chapterentrypagenumber} (siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% @@ -343,29 +343,29 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.fontelement.dictum} (siehe \autoref{sec:maincls.dictum}, \DescPageRef{maincls.cmd.dictum})}% \feentry{dictumtext}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.dictum}}% \feentry{disposition}{% - alle Gliederungsüberschriften, also die Argumente von + alle Gliederungsüberschriften, also die Argumente von \DescRef{\ThisCommonLabelBase.cmd.part} bis \DescRef{\ThisCommonLabelBase.cmd.subparagraph} und - \DescRef{\ThisCommonLabelBase.cmd.minisec} sowie die Überschrift der + \DescRef{\ThisCommonLabelBase.cmd.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}, + Marke und Text einer Fußnote (siehe \autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}% \feentry{footnotelabel}{% - Marke einer Fußnote; Anwendung erfolgt nach dem Element + Marke einer Fußnote; Anwendung erfolgt nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.footnote} (siehe \autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}% \feentry{footnotereference}{% - Referenzierung der Fußnotenmarke im Text (siehe + Referenzierung der Fußnotenmarke im Text (siehe \autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.footnote})}% \feentry{footnoterule}{% Linie\ChangedAt{v3.07}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} über dem Fußnotenapparat (siehe + \Class{scrartcl}} über dem Fußnotenapparat (siehe \autoref{sec:maincls.footnotes}, \DescPageRef{maincls.cmd.setfootnoterule})}% \feentry{labelinglabel}{% @@ -383,7 +383,7 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.fontelement.labelinglabel} (siehe \autoref{sec:maincls.lists}, \DescPageRef{maincls.env.labeling})}% \feentry{minisec}{% - mit \DescRef{\ThisCommonLabelBase.cmd.minisec} gesetzte Überschrift + mit \DescRef{\ThisCommonLabelBase.cmd.minisec} gesetzte Ãœberschrift (siehe \autoref{sec:maincls.structure} ab \DescPageRef{maincls.cmd.minisec})}% \feentry{pagefoot}{% @@ -391,24 +391,24 @@ zu den jeweiligen Elementen.% ist (siehe \autoref{cha:scrlayer-scrpage}, \DescPageRef{scrlayer-scrpage.fontelement.pagefoot})}% \feentry{pagehead}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}}% \feentry{pageheadfoot}{% - Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten + 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 + Seitenzahl im Kopf oder Fuß der Seite (siehe \autoref{sec:maincls.pagestyle})}% \feentry{pagination}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.pagenumber}}% \feentry{paragraph}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.paragraph} + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.paragraph} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.paragraph})}% \feentry{part}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.part}, jedoch + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.part}, jedoch ohne die Zeile mit der Nummer des Teils (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.part})}% \feentry{partentry}{% @@ -421,7 +421,7 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.fontelement.partentry} (siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% \feentry{partnumber}{% - Zeile mit der Nummer des Teils in Überschrift der Ebene + Zeile mit der Nummer des Teils in Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.part} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.part})}% \feentry{publishers}{% @@ -432,28 +432,28 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.cmd.publishers} (siehe \autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.publishers})}% \feentry{section}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.section} (siehe + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.section} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.section})}% \feentry{sectionentry}{% Inhaltsverzeichniseintrag der Ebene \DescRef{\ThisCommonLabelBase.cmd.section} (nur bei \Class{scrartcl} - verfügbar, siehe \autoref{sec:maincls.toc}, + verfügbar, siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% \feentry{sectionentrydots}{% \ChangedAt{v3.15}{\Class{scrartcl}}% - Optionale Verbindungspunkte in Inhaltsverzeichniseinträgen der Ebene + Optionale Verbindungspunkte in Inhaltsverzeichniseinträgen der Ebene \DescRef{\ThisCommonLabelBase.cmd.section} abweichend vom Element \DescRef{\ThisCommonLabelBase.fontelement.sectionentrypagenumber} (nur - bei \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, + bei \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% \feentry{sectionentrypagenumber}{% Seitenzahl des Inhaltsverzeichniseintrags der Ebene \DescRef{\ThisCommonLabelBase.cmd.section} abweichend vom Element \DescRef{\ThisCommonLabelBase.fontelement.sectionentry} (nur bei - \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, + \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.cmd.tableofcontents})}% \feentry{sectioning}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.disposition}}% \feentry{subject}{% Typisierung des Dokuments, also das Argument von @@ -461,15 +461,15 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.cmd.maketitle} (siehe \autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.subject})}% \feentry{subparagraph}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subparagraph} + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subparagraph} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.subparagraph})}% \feentry{subsection}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subsection} + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subsection} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.subsection})}% \feentry{subsubsection}{% - Überschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subsubsection} + Ãœberschrift der Ebene \DescRef{\ThisCommonLabelBase.cmd.subsubsection} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.subsubsection})}% \feentry{subtitle}{% @@ -480,13 +480,13 @@ zu den jeweiligen Elementen.% \feentry{title}{% Haupttitel des Dokuments, also das Argument von \DescRef{\ThisCommonLabelBase.cmd.title} bei Verwendung von - \DescRef{\ThisCommonLabelBase.cmd.maketitle} (bezüglich der Größe des - Haupttitels siehe die ergänzenden Bemerkungen im Text von + \DescRef{\ThisCommonLabelBase.cmd.maketitle} (bezüglich der Größe des + Haupttitels siehe die ergänzenden Bemerkungen im Text von \autoref{sec:maincls.titlepage} ab \DescPageRef{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 + Kopf über dem Haupttitel des Dokuments, also das Argument von \DescRef{\ThisCommonLabelBase.cmd.titlehead} mit \DescRef{\ThisCommonLabelBase.cmd.maketitle} (siehe \autoref{sec:maincls.titlepage}, \DescPageRef{maincls.cmd.titlehead})}% @@ -501,8 +501,8 @@ zu den jeweiligen Elementen.% \color{red}% } \end{lstcode} - Für die Anweisung \Macro{color}\PParameter{red} wird das Paket - \Package{color} oder \Package{xcolor} benötigt. Die zusätzliche Angabe + Für die Anweisung \Macro{color}\PParameter{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 @@ -512,7 +512,7 @@ zu den jeweiligen Elementen.% \end{Example} \else \IfThisCommonLabelBase{scrlttr2}{% - Ein allgemeines Beispiel für die Anwendung sowohl von + Ein allgemeines Beispiel für die Anwendung sowohl von \Macro{setkomafont} als auch \Macro{usekomafont} finden Sie in \autoref{sec:maincls.textmarkup}, \PageRefxmpl{maincls.cmd.setkomafont}. @@ -521,15 +521,15 @@ zu den jeweiligen Elementen.% \desccaption{% Elemente, deren Schrift bei der Klasse \Class{scrlttr2} oder dem Paket \Package{scrletter} mit \Macro{setkomafont} und - \Macro{addtokomafont} verändert werden + \Macro{addtokomafont} verändert werden kann\label{tab:scrlttr2.fontelements}% }{% - Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})% + Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})% }% \feentry{addressee}{Name und Anschrift im Anschriftfenster (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield})}% - \feentry{backaddress}{Rücksendeadresse für einen Fensterbriefumschlag + \feentry{backaddress}{Rücksendeadresse für einen Fensterbriefumschlag (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.backaddress})}% \feentry{descriptionlabel}{Label, also das optionale Argument von @@ -537,23 +537,23 @@ zu den jeweiligen Elementen.% \DescRef{\ThisCommonLabelBase.env.description}-Umgebung (\autoref{sec:scrlttr2.lists}, \DescPageRef{scrlttr2.env.description})}% - \feentry{foldmark}{Faltmarke auf dem Briefpapier; ermöglicht Änderung + \feentry{foldmark}{Faltmarke auf dem Briefpapier; ermöglicht Änderung der Linienfarbe (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks})}% \feentry{footnote}{% - Marke und Text einer Fußnote (\autoref{sec:scrlttr2.footnotes}, + Marke und Text einer Fußnote (\autoref{sec:scrlttr2.footnotes}, \DescPageRef{scrlttr2.cmd.footnote})}% \feentry{footnotelabel}{% - Marke einer Fußnote; Anwendung erfolgt nach dem Element + Marke einer Fußnote; Anwendung erfolgt nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.footnote} (\autoref{sec:scrlttr2.footnotes}, \DescPageRef{scrlttr2.cmd.footnote})}% \feentry{footnotereference}{% - Referenzierung der Fußnotenmarke im Text + Referenzierung der Fußnotenmarke im Text (\autoref{sec:scrlttr2.footnotes}, \DescPageRef{scrlttr2.cmd.footnote})}% \feentry{footnoterule}{% - Linie\ChangedAt{v3.07}{\Class{scrlttr2}} über dem Fußnotenapparat + Linie\ChangedAt{v3.07}{\Class{scrlttr2}} über dem Fußnotenapparat (\autoref{sec:scrlttr2.footnotes}, \DescPageRef{scrlttr2.cmd.setfootnoterule})}% \feentry{fromaddress}{Absenderadresse im Briefkopf @@ -562,8 +562,8 @@ zu den jeweiligen Elementen.% \feentry{fromname}{Name des Absenders im Briefkopf abweichend von \PValue{fromaddress} (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.fromname})}% - \feentry{fromrule}{Linie im Absender im Briefkopf; gedacht für - Farbänderungen (\autoref{sec:scrlttr2.firstpage}, + \feentry{fromrule}{Linie im Absender im Briefkopf; gedacht für + Farbänderungen (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.fromrule})}% \feentry{labelinglabel}{% Label, also das optionale Argument der @@ -582,37 +582,37 @@ zu den jeweiligen Elementen.% \feentry{pagefoot}{% wird nach dem Element \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot} - für den mit Variable + für den mit Variable \DescRef{scrlttr2.variable.nextfoot}\IndexVariable{nextfoot} - definierten Seitenfuß verwendet oder wenn das Paket + definierten Seitenfuß verwendet oder wenn das Paket \Package{scrlayer-scrpage} geladen ist (\autoref{cha:scrlayer-scrpage}, \DescPageRef{scrlayer-scrpage.fontelement.pagefoot})}% \feentry{pagehead}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.pageheadfoot}}% \feentry{pageheadfoot}{% - Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten + Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten Seitenstilen (\autoref{sec:maincls.pagestyle}, \DescPageRef{\ThisCommonLabelBase.fontelement.pageheadfoot})}% \feentry{pagenumber}{% - Seitenzahl im Kopf oder Fuß der Seite + Seitenzahl im Kopf oder Fuß der Seite (\autoref{sec:maincls.pagestyle}, \DescPageRef{\ThisCommonLabelBase.fontelement.pagenumber})}% \feentry{pagination}{% - alternative Bezeichnung für + alternative Bezeichnung für \DescRef{\ThisCommonLabelBase.fontelement.pagenumber}}% \feentry{placeanddate}{% \ChangedAt{v3.12}{\Class{scrlttr2}}% - Ort und Datum, falls statt einer Geschäftszeile nur eine Datumszeile + Ort und Datum, falls statt einer Geschäftszeile nur eine Datumszeile verwendet wird (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.placeseparator})}% \feentry{refname}{% - Bezeichnung der Felder in der Geschäftszeile + Bezeichnung der Felder in der Geschäftszeile (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.yourref})}% \feentry{refvalue}{% - Werte der Felder in der Geschäftszeile + Werte der Felder in der Geschäftszeile (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.yourref})}% \feentry{specialmail}{Versandart im Anschriftfenster @@ -620,39 +620,39 @@ zu den jeweiligen Elementen.% \DescPageRef{scrlttr2.variable.specialmail})}% \feentry{lettersubject}{% \ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}% - Betreff in der Brieferöffnung (\autoref{sec:scrlttr2.firstpage}, + Betreff in der Brieferöffnung (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.subject})}% \feentry{lettertitle}{% \ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}% - Titel in der Brieferöffnung (\autoref{sec:scrlttr2.firstpage}, + Titel in der Brieferöffnung (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.title})}% \feentry{toaddress}{Abweichung vom Element - \DescRef{\ThisCommonLabelBase.fontelement.addressee} für die - Anschrift (ohne Name) des Empfängers im Anschriftfeld + \DescRef{\ThisCommonLabelBase.fontelement.addressee} für die + Anschrift (ohne Name) des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.toaddress})}% \feentry{toname}{Abweichung vom Element - \DescRef{\ThisCommonLabelBase.fontelement.addressee} für den Namen - des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage}, + \DescRef{\ThisCommonLabelBase.fontelement.addressee} für den Namen + des Empfängers im Anschriftfeld (\autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.variable.toname})}% \end{desclist} }{% \IfThisCommonLabelBase{scrlayer-scrpage}{% \begin{desclist} \desccaption[{Elemente, deren Schrift bei \Package{scrlayer-scrpage} - mit \Macro{setkomafont} und \Macro{addtokomafont} verändert werden - kann, einschließlich der jeweiligen Voreinstellung}]% + mit \Macro{setkomafont} und \Macro{addtokomafont} verändert werden + kann, einschließlich der jeweiligen Voreinstellung}]% {Elemente, deren Schrift bei \Package{scrlayer-scrpage} mit - \Macro{setkomafont} und \Macro{addtokomafont} verändert werden - kann, einschließlich der jeweiligen Voreinstellung, falls die + \Macro{setkomafont} und \Macro{addtokomafont} verändert werden + kann, einschließlich der jeweiligen 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 + {Elemente, deren Schrift verändert werden kann (\emph{Fortsetzung})}% \feentry{footbotline}{% - Linie unter dem Fuß eines mit \Package{scrlayer-scrpage} + Linie unter dem Fuß eines mit \Package{scrlayer-scrpage} definierten Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.fontelement.footbotline}). Das @@ -662,11 +662,11 @@ zu den jeweiligen Elementen.% \IndexFontElement{pageheadfoot} und \DescRef{\ThisCommonLabelBase.fontelement.pagefoot}% \IndexFontElement{pagefoot} angewandt. Es wird empfohlen, dieses - Element lediglich für Farbänderungen zu verwenden.\par + Element lediglich für Farbänderungen zu verwenden.\par \mbox{Voreinstellung: \emph{leer}}% }% \feentry{footsepline}{% - Linie über dem Fuß eines mit \Package{scrlayer-scrpage} + Linie über dem Fuß eines mit \Package{scrlayer-scrpage} definierten Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.fontelement.footsepline}). Das @@ -676,7 +676,7 @@ zu den jeweiligen Elementen.% \IndexFontElement{pageheadfoot} und \DescRef{\ThisCommonLabelBase.fontelement.pagefoot}% \IndexFontElement{pagefoot} angewandt. Es wird empfohlen, dieses - Element lediglich für Farbänderungen zu verwenden.\par + Element lediglich für Farbänderungen zu verwenden.\par \mbox{Voreinstellung: \emph{leer}}% }% \feentry{headsepline}{% @@ -690,11 +690,11 @@ zu den jeweiligen Elementen.% \IndexFontElement{pageheadfoot} und \DescRef{scrlayer-scrpage.fontelement.pagehead}% \IndexFontElement{pagehead} angewandt. Es wird empfohlen, dieses - Element lediglich für Farbänderungen zu verwenden.\par + Element lediglich für Farbänderungen zu verwenden.\par \mbox{Voreinstellung: \emph{leer}}% }% \feentry{headtopline}{% - Linie über dem Kopf eines mit \Package{scrlayer-scrpage} + Linie über dem Kopf eines mit \Package{scrlayer-scrpage} definierten Seitenstils (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.fontelement.headtopline}). Das @@ -704,11 +704,11 @@ zu den jeweiligen Elementen.% \IndexFontElement{pageheadfoot} und \DescRef{scrlayer-scrpage.fontelement.pagehead}% \IndexFontElement{pagehead} angewandt. Es wird empfohlen, dieses - Element lediglich für Farbänderungen zu verwenden.\par + Element lediglich für Farbänderungen zu verwenden.\par \mbox{Voreinstellung: \emph{leer}}% }% \feentry{pagefoot}{% - Inhalt eines Fußes eines mit \Package{scrlayer-scrpage} + Inhalt eines Fußes eines mit \Package{scrlayer-scrpage} definierten Seitenstils (siehe \autoref{sec:scrlayer-scrpage.predefined.pagestyles}, \DescPageRef{scrlayer-scrpage.fontelement.pagefoot}). Das Element @@ -728,7 +728,7 @@ zu den jeweiligen Elementen.% \mbox{Voreinstellung: \emph{leer}}% }% \feentry{pageheadfoot}{% - Inhalt eines Kopfes oder Fußes eines mit + Inhalt eines Kopfes oder Fußes eines mit \Package{scrlayer-scrpage} definierten Seitenstils (siehe \autoref{sec:scrlayer-scrpage.predefined.pagestyles}, \DescPageRef{scrlayer-scrpage.fontelement.pageheadfoot}). Das @@ -743,9 +743,9 @@ zu den jeweiligen Elementen.% \autoref{sec:scrlayer-scrpage.predefined.pagestyles}, \DescPageRef{scrlayer-scrpage.fontelement.pagenumber}). Bei einer etwaigen Umdefinierung von - \DescRef{\ThisCommonLabelBase.cmd.pagemark} ist dafür zu sorgen, + \DescRef{\ThisCommonLabelBase.cmd.pagemark} ist dafür zu sorgen, dass die Umdefinierung auch ein - \Macro{usekomafont}\PParameter{pagenumber} enthält!\par + \Macro{usekomafont}\PParameter{pagenumber} enthält!\par \mbox{Voreinstellung: \Macro{normalfont}}% }% \end{desclist} @@ -753,20 +753,20 @@ zu den jeweiligen Elementen.% \IfThisCommonLabelBase{scrjura}{% \begin{table} \caption{Elemente, deren Schrift bei \Package{scrjura} mit - \Macro{setkomafont} und \Macro{addtokomafont} verändert werden - kann, einschließlich der jeweiligen Voreinstellung}% + \Macro{setkomafont} und \Macro{addtokomafont} verändert werden + kann, einschließlich der jeweiligen Voreinstellung}% \label{tab:scrjura.fontelements}% \begin{desctabular} \feentry{Clause}{% - Alias für \FontElement{\PName{Umgebungsname}.Clause} + Alias für \FontElement{\PName{Umgebungsname}.Clause} innerhalb einer Vertragsumgebung, beispielsweise \FontElement{contract.Clause} innerhalb von \DescRef{\ThisCommonLabelBase.env.contract}; ist kein entsprechendes Element definiert, so wird auf - \FontElement{contract.Clause} zurückgegriffen% + \FontElement{contract.Clause} zurückgegriffen% }% \feentry{contract.Clause}{% - Überschrift eines Paragraphen innerhalb von + Ãœberschrift eines Paragraphen innerhalb von \DescRef{\ThisCommonLabelBase.env.contract} (siehe \autoref{sec:\ThisCommonLabelBase.contract}, \DescPageRef{\ThisCommonLabelBase.fontelement.contract.Clause}); @@ -776,12 +776,12 @@ zu den jeweiligen Elementen.% }% \entry{\DescRef{\ThisCommonLabelBase.fontelement./Name/.Clause}}{% \IndexFontElement[indexmain]{\PName{Name}.Clause}% - Überschrift eines Paragraphen innerhalb einer Umgebung + Ãœberschrift eines Paragraphen innerhalb einer Umgebung \PName{Name}, die mit \DescRef{\ThisCommonLabelBase.cmd.DeclareNewJuraEnvironment} definiert wurde, soweit bei der Definition mit \Option{ClauseFont} eine Einstellung vorgenommen wurde oder - das Element nachträglich definiert wurde (siehe + das Element nachträglich definiert wurde (siehe \autoref{sec:\ThisCommonLabelBase.newenv}, \DescPageRef{\ThisCommonLabelBase.fontelement./Name/.Clause}); \par @@ -826,33 +826,33 @@ zu den jeweiligen Elementen.% 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 +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 \DescRef{\ThisCommonLabelBase.cmd.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 +\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.% +Mit den übrigen Anweisungen können auch einzelne Schriftattribute +übernommen werden. Dabei übernimmt \Macro{usesizeofkomafont} sowohl die +Schriftgröße als auch den Grundlinienabstand.% % \IfThisCommonLabelBase{scrextend}{% Umbruchvariante! }{% \IfThisCommonLabelBase{scrjura}{% \par% Vor dem Missbrauch der Schrifteinstellungen wird dennoch dringend gewarnt - (siehe \autoref{sec:maincls-experts.experts}, + (siehe \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist})!% }{% \par% - Diese Befehle sollten jedoch nicht als Legitimation dafür verstanden + Diese Befehle sollten jedoch nicht als Legitimation dafür verstanden werden, in die Schrifteinstellungen der Elemente beliebige Anweisungen - einzufügen. Das kann nämlich sehr schnell zu Fehlern führen (siehe - \autoref{sec:maincls-experts.experts}, + einzufügen. Das kann nämlich sehr schnell zu Fehlern führen (siehe + \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).% }% }% @@ -863,6 +863,6 @@ Schriftgröße als auch den Grundlinienabstand.% %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-titles.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-titles.tex index 2086df85c4..af55da723d 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-titles.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-titles.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-titles.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-titles.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-titles.tex} - [$Date: 2018-01-30 13:37:05 +0100 (Tue, 30 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs)] @@ -59,22 +59,22 @@ \BeginIndex{}{Titel}% \IfThisCommonFirstRun{}{% - Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} + Es gilt sinngemäß, was in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} geschrieben wurde. Falls Sie also \autoref{sec:\ThisCommonFirstLabelBase.titlepage} bereits gelesen und - verstanden haben, können Sie auf + verstanden haben, können Sie auf \autopageref{sec:\ThisCommonLabelBase.titlepage.next} mit \autoref{sec:\ThisCommonLabelBase.titlepage.next} fortfahren.% }% \IfThisCommonLabelBase{scrextend}{\iftrue}{\csname iffalse\endcsname}% - \ Die\textnote{Achtung!} Möglichkeiten von \Package{scrextend} zum - Dokumenttitel gehören jedoch zu den optionalen, erweiterten Möglichkeiten - und stehen daher nur zur Verfügung, wenn beim Laden des Pakets - \OptionValueRef{\ThisCommonLabelBase}{extendedfeature}{title} gewählt + \ Die\textnote{Achtung!} Möglichkeiten von \Package{scrextend} zum + Dokumenttitel gehören jedoch zu den optionalen, erweiterten Möglichkeiten + und stehen daher nur zur Verfügung, wenn beim Laden des Pakets + \OptionValueRef{\ThisCommonLabelBase}{extendedfeature}{title} gewählt wurde (siehe \autoref{sec:\ThisCommonLabelBase.optionalFeatures}, \DescPageRef{\ThisCommonLabelBase.option.extendedfeature}). - Darüber hinaus kann \Package{scrextend} nicht mit einer \KOMAScript-Klasse + Darüber hinaus kann \Package{scrextend} nicht mit einer \KOMAScript-Klasse zusammen verwendet werden. In allen Beispielen aus \autoref{sec:maincls.titlepage} muss daher bei Verwendung von \Package{scrextend} @@ -90,11 +90,11 @@ durch \fi Bei Dokumenten wird zwischen zwei Arten von Titeln -\IfThisCommonLabelBase{scrextend}{}{für das gesamte Dokument +\IfThisCommonLabelBase{scrextend}{}{für das gesamte Dokument }unterschieden. Zum einen gibt es die Titelseiten. Hierbei steht der -Dokumenttitel zusammen mit einigen zusätzlichen Informationen wie dem Autor +Dokumenttitel zusammen mit einigen zusätzlichen Informationen wie dem Autor auf einer eigenen Seite. Neben der Haupttitelseite kann es weitere -Titelseiten, etwa Schmutztitel, Verlagsinformationen, Widmung oder ähnliche, +Titelseiten, etwa Schmutztitel, Verlagsinformationen, Widmung oder ähnliche, geben. Zum anderen gibt es den Titelkopf. Dabei erscheint der Titel lediglich am Anfang einer neuen \IfThisCommonLabelBase{scrextend}{}{-- in der Regel der ersten -- }Seite. Unterhalb dieser Titelzeilen\Index{Titel>Zeilen} wird @@ -115,29 +115,29 @@ Mit dieser Option% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -}{} wird ausgewählt, ob für die mit +}{} wird ausgewählt, ob für die mit \DescRef{\ThisCommonLabelBase.cmd.maketitle} (siehe \DescPageRef{\ThisCommonLabelBase.cmd.maketitle}) gesetzte Titelei eigene Seiten\Index{Titel>Seite} verwendet werden oder stattdessen die Titelei von \DescRef{\ThisCommonLabelBase.cmd.maketitle} als Titelkopf\Index{Titel>Kopf} -gesetzt wird. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für +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}} \IfThisCommonLabelBase{scrextend}{}{oder \Option{titlepage} }wird die Titelei -in Form von Titelseiten ausgewählt. Die Anweisung +in Form von Titelseiten ausgewählt. Die Anweisung \DescRef{\ThisCommonLabelBase.cmd.maketitle} verwendet \IfThisCommonLabelBase{scrextend}{dabei }{}\DescRef{\ThisCommonLabelBase.env.titlepage}-Umgebungen zum Setzen dieser -Seiten, die somit normalerweise weder Seitenkopf noch Seitenfuß erhalten. Bei -{\KOMAScript} wurde die Titelei gegenüber den Standardklassen stark -erweitert. Die zusätzlichen Elemente finden sie auf den nachfolgenden Seiten. +Seiten, die somit normalerweise weder Seitenkopf noch Seitenfuß erhalten. Bei +{\KOMAScript} wurde die Titelei gegenüber den Standardklassen stark +erweitert. Die zusätzlichen Elemente finden sie auf den nachfolgenden Seiten. -Demgegenüber wird mit +Demgegenüber wird mit \important{\OptionValue{titlepage}{false}}\OptionValue{titlepage}{false} erreicht, dass ein Titelkopf (engl.: \emph{in-page title}) gesetzt wird. Das -heißt, die Titelei wird lediglich speziell hervorgehoben. Auf der Seite mit +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. @@ -149,28 +149,28 @@ Mit% \IfThisCommonLabelBase{scrextend}{% \ChangedAt{v3.12}{\Package{scrextend}}% }{\InternalCommonFileUseError}% -} der dritten Möglichkeit, \OptionValue{titlepage}{firstiscover}% +} 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 +Titelseiten aktiviert. Es wird auch dafür gesorgt, dass die erste von \DescRef{\LabelBase.cmd.maketitle}\IndexCmd{maketitle} ausgegebene Titelseite, also entweder der Schmutztitel oder der Haupttitel, als -Umschlagseite\Index{Umschlag} ausgegeben wird. Jede andere Einstellung für die +Umschlagseite\Index{Umschlag} ausgegeben wird. Jede andere Einstellung für die Option \Option{titlepage} hebt diese Einstellung wieder auf. Die -Ränder\important{\Macro{coverpage\dots margin}} dieser Umschlagseite werden -über \Macro{coverpagetopmargin} (oberer Rand), \Macro{coverpageleftmargin} -(linker Rand), \Macro{coverpagerightmargin} (rechter Rand) und natürlich +Ränder\important{\Macro{coverpage\dots margin}} dieser Umschlagseite werden +über \Macro{coverpagetopmargin} (oberer Rand), \Macro{coverpageleftmargin} +(linker Rand), \Macro{coverpagerightmargin} (rechter Rand) und natürlich \Macro{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. +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. \IfThisCommonLabelBase{maincls}{% Bei den Klassen \Class{scrbook} und \Class{scrreprt} sind Titelseiten - voreingestellt. Demgegenüber verwendet \Class{scrartcl} in der + voreingestellt. Demgegenüber verwendet \Class{scrartcl} in der Voreinstellung einen Titelkopf.% }{% \IfThisCommonLabelBase{scrextend}{% - Die Voreinstellung ist von der verwendeten Klasse abhängig und wird von + Die Voreinstellung ist von der verwendeten Klasse abhängig und wird von \Package{scrextend} kompatibel zu den Standardklassen erkannt. Setzt eine Klasse keine entsprechende Voreinstellung, so ist der Titelkopf voreingestellt.% @@ -184,21 +184,21 @@ sind von den Längen \Length{topmargin}\IndexLength{topmargin} und \begin{Environment}{titlepage}\end{Environment} \end{Declaration}% \BeginIndex{Env}{titlepage}% -Grundsätzlich werden bei den Standardklassen und bei {\KOMAScript} alle +Grundsätzlich werden bei den Standardklassen und bei {\KOMAScript} alle Titelseiten in einer speziellen Umgebung, der \Environment{titlepage}-Umgebung, gesetzt. Diese Umgebung startet immer mit einer neuen Seite -- im zweiseitigen Layout sogar mit einer neuen rechten -Seite~-- im einspaltigen Modus. Für eine Seite wird der Seitenstil mit +Seite~-- im einspaltigen Modus. Für eine Seite wird der Seitenstil mit \DescRef{maincls.cmd.thispagestyle}% \PParameter{\DescRef{maincls.pagestyle.empty}} -geändert, so dass weder Seitenzahl noch Kolumnentitel ausgegeben werden. Am +geändert, so dass weder Seitenzahl noch Kolumnentitel ausgegeben werden. Am Ende der Umgebung wird die Seite automatisch beendet. Sollten Sie nicht das automatische Layout der Titelei, wie es das nachfolgend beschriebene -\DescRef{\ThisCommonLabelBase.cmd.maketitle} bietet, verwenden können, ist zu +\DescRef{\ThisCommonLabelBase.cmd.maketitle} bietet, verwenden können, ist zu empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen. \IfThisCommonFirstRun{\iftrue}{% - Ein Beispiel für eine einfache Titelseite mit \Environment{titlepage} finden + Ein Beispiel für eine einfache Titelseite mit \Environment{titlepage} finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, \PageRefxmpl{\ThisCommonFirstLabelBase.env.titlepage}.% \csname iffalse\endcsname% @@ -206,8 +206,8 @@ empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen. \begin{Example} \phantomsection\xmpllabel{env.titlepage}% Angenommen, Sie wollen eine Titelseite, auf der lediglich oben links - möglichst groß und fett das Wort »Me« steht -- kein Autor, kein Datum, - nichts weiter. Folgendes Dokument ermöglicht das: + möglichst groß und fett das Wort »Me« steht -- kein Autor, kein Datum, + nichts weiter. Folgendes Dokument ermöglicht das: \begin{lstcode} \documentclass{scrbook} \begin{document} @@ -224,30 +224,30 @@ empfehlen, eine eigene Titelei mit Hilfe dieser Umgebung zu entwerfen. \begin{Declaration} \Macro{maketitle}\OParameter{Seitenzahl} \end{Declaration}% -Während\textnote{\KOMAScript{} vs. Standardklassen} bei den Standardklassen +Während\textnote{\KOMAScript{} vs. Standardklassen} bei den Standardklassen nur maximal eine Titelseite mit den \IfThisCommonLabelBase{scrextend}{}{drei -}Angaben Titel, Autor und Datum existiert, können bei {\KOMAScript} mit +}Angaben Titel, Autor und Datum existiert, können bei {\KOMAScript} mit \Macro{maketitle} bis zu sechs Titelseiten gesetzt werden. Im Gegensatz zu -den Standardklassen kennt \Macro{maketitle} bei {\KOMAScript} außerdem noch +den Standardklassen kennt \Macro{maketitle} bei {\KOMAScript} außerdem noch ein optionales nummerisches Argument. Findet es Verwendung, so wird die Nummer als Seitenzahl der ersten Titelseite benutzt. Diese Seitenzahl wird -jedoch nicht ausgegeben, sondern beeinflusst lediglich die Zählung. Sie -sollten hier unbedingt eine ungerade Zahl wählen, da sonst die gesamte Zählung -durcheinander gerät. Meiner Auf"|fassung nach gibt es nur zwei sinnvolle -Anwendungen für das optionale Argument. Zum einen könnte man dem +jedoch nicht ausgegeben, sondern beeinflusst lediglich die Zählung. Sie +sollten hier unbedingt eine ungerade Zahl wählen, da sonst die gesamte Zählung +durcheinander gerät. Meiner Auf"|fassung nach gibt es nur zwei sinnvolle +Anwendungen für das optionale Argument. Zum einen könnte man dem Schmutztitel\Index[indexmain]{Schmutztitel} die logische Seitenzahl -1 -geben, um so die Seitenzählung erst ab der Haupttitelseite mit 1 zu -beginnen. Zum anderen könnte man mit einer höheren Seitenzahl beginnen, -beispielsweise 3, 5 oder 7, um so weitere Titelseiten zu berücksichtigen, die -erst vom Verlag hinzugefügt werden. Wird ein Titelkopf verwendet, wird das -optionale Argument ignoriert. Dafür kann der Seitenstil einer solchen Titelei +geben, um so die Seitenzählung erst ab der Haupttitelseite mit 1 zu +beginnen. Zum anderen könnte man mit einer höheren Seitenzahl beginnen, +beispielsweise 3, 5 oder 7, um so weitere Titelseiten zu berücksichtigen, die +erst vom Verlag hinzugefügt werden. Wird ein Titelkopf verwendet, wird das +optionale Argument ignoriert. Dafür kann der Seitenstil einer solchen Titelei durch Umdefinierung des Makros \DescRef{\ThisCommonLabelBase.cmd.titlepagestyle}% \important{\DescRef{\ThisCommonLabelBase.cmd.titlepagestyle}} (siehe \autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle}) -verändert werden. +verändert werden. -Die folgenden Anweisungen führen nicht unmittelbar zum Setzen der Titelei. Das +Die folgenden Anweisungen führen nicht unmittelbar zum Setzen der Titelei. Das Setzen der Titelei erfolgt immer mit \Macro{maketitle}. Es sei an dieser Stelle auch darauf hingewiesen, dass \Macro{maketitle} nicht innerhalb einer \DescRef{\ThisCommonLabelBase.env.titlepage}-Umgebung zu verwenden @@ -255,11 +255,11 @@ ist. Wie\textnote{Achtung!} in den Beispielen angegeben, sollte man nur entweder \Macro{maketitle} oder \DescRef{\ThisCommonLabelBase.env.titlepage} verwenden. -Mit den nachfolgend erklärten Anweisungen werden lediglich die Inhalte der -Titelei festgelegt. Sie müssen daher auch unbedingt vor \Macro{maketitle} +Mit den nachfolgend erklärten Anweisungen werden lediglich die Inhalte der +Titelei festgelegt. Sie müssen daher auch unbedingt vor \Macro{maketitle} verwendet werden. Es ist jedoch nicht notwendig und bei Verwendung des \Package{babel}-Pakets\IndexPackage{babel} (siehe \cite{package:babel}) auch -nicht empfehlenswert, diese Anweisungen in der Dokumentpräambel vor +nicht empfehlenswert, diese Anweisungen in der Dokumentpräambel vor \Macro{begin}\PParameter{document} zu verwenden. Beispieldokumente finden Sie \IfThisCommonFirstRun{bei den weiteren Befehlen dieses Abschnitts}{in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} ab @@ -271,19 +271,19 @@ nicht empfehlenswert, diese Anweisungen in der Dokumentpräambel vor \Macro{frontispiece}\Parameter{Frontispiz} \end{Declaration}% \begin{Explain}% - Früher war der Buchblock oftmals nicht durch einen Buchdeckel vor - Verschmutzung geschützt. Diese Aufgabe übernahm dann die erste Seite des + Früher war der Buchblock oftmals nicht durch einen Buchdeckel vor + Verschmutzung geschützt. Diese Aufgabe übernahm dann die erste Seite des Buches, die meist einen Kurztitel, eben den \emph{Schmutztitel}, trug. Auch heute noch wird diese Extraseite vor dem eigentlichen Haupttitel gerne - verwendet und enthält dann Verlagsangaben, Buchreihennummer und ähnliche + verwendet und enthält dann Verlagsangaben, Buchreihennummer und ähnliche Angaben. \end{Explain} -Bei {\KOMAScript} ist es möglich, vor der eigentlichen Titelseite eine weitere +Bei {\KOMAScript} ist es möglich, vor der eigentlichen Titelseite eine weitere Seite zu setzen. Als \PName{Schmutztitel}\Index{Schmutztitel} kann dabei -beliebiger Text -- auch mehrere Absätze -- gesetzt werden. Der Inhalt von -\PName{Schmutztitel} wird von {\KOMAScript} ohne zusätzliche Beeinflussung der -Formatierung ausgegeben. Dadurch ist dessen Gestaltung völlig dem Anwender -überlassen. Die Rückseite% +beliebiger Text -- auch mehrere Absätze -- gesetzt werden. Der Inhalt von +\PName{Schmutztitel} wird von {\KOMAScript} ohne zusätzliche Beeinflussung der +Formatierung ausgegeben. Dadurch ist dessen Gestaltung völlig dem Anwender +überlassen. Die Rückseite% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.25}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}% }{% @@ -292,20 +292,20 @@ Formatierung ausgegeben. Dadurch ist dessen Gestaltung völlig dem Anwender }{\ThisCommonLabelBaseFailure}% } des Schmutztitels ist das \PName{Frontispiz}. Der Schmutztitel -ergibt auch dann eine eigene Titelseite, wenn mit Titelköpfen gearbeitet +ergibt auch dann eine eigene Titelseite, wenn mit Titelköpfen gearbeitet wird. Die Ausgabe des mit \Macro{extratitle} definierten Schmutztitels erfolgt als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}. \IfThisCommonFirstRun{\iftrue}{% - Ein Beispiel für eine einfache Titelseite mit Schmutztitel und Haupttitel + Ein Beispiel für eine einfache Titelseite mit Schmutztitel und Haupttitel finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.titlepage}, \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.extratitle}.% \csname iffalse\endcsname% }% \begin{Example} \phantomsection\xmpllabel{cmd.extratitle}% - Kommen wir auf das Beispiel von oben zurück und gehen davon aus, dass das - spartanische »Me« nur den Schmutztitel darstellt. Nach dem Schmutztitel + Kommen wir auf das Beispiel von oben zurück und gehen davon aus, dass das + spartanische »Me« nur den Schmutztitel darstellt. Nach dem Schmutztitel soll noch der Haupttitel folgen. Dann kann wie folgt verfahren werden: \begin{lstcode} \documentclass{scrbook} @@ -315,7 +315,7 @@ als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}. \maketitle \end{document} \end{lstcode} - Sie können den Schmutztitel aber auch horizontal zentriert und etwas + Sie können den Schmutztitel aber auch horizontal zentriert und etwas tiefer setzen: \begin{lstcode} \documentclass{scrbook} @@ -328,8 +328,8 @@ als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}. \end{lstcode} Die\textnote{Achtung!} Anweisung \DescRef{\ThisCommonLabelBase.cmd.title} ist beim Setzen der Titelei mit Hilfe von - \DescRef{\ThisCommonLabelBase.cmd.maketitle} grundsätzlich notwendig, - damit die Beispiele fehlerfrei sind. Sie wird nachfolgend erklärt. + \DescRef{\ThisCommonLabelBase.cmd.maketitle} grundsätzlich notwendig, + damit die Beispiele fehlerfrei sind. Sie wird nachfolgend erklärt. \end{Example} \fi% \EndIndexGroup @@ -344,20 +344,20 @@ als Bestandteil der Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle}. \Macro{date}\Parameter{Datum} \Macro{publishers}\Parameter{Verlag} \Macro{and} - \Macro{thanks}\Parameter{Fußnote} + \Macro{thanks}\Parameter{Fußnote} \end{Declaration}% -Für den Inhalt der Haupttitelseite stehen sieben Elemente zur Verfügung. Die +Für den Inhalt der Haupttitelseite stehen sieben Elemente zur Verfügung. Die Ausgabe der Haupttitelseite erfolgt als Bestandteil der Titelei mit -\DescRef{\ThisCommonLabelBase.cmd.maketitle}, während die hier aufgeführten +\DescRef{\ThisCommonLabelBase.cmd.maketitle}, während die hier aufgeführten Anweisungen lediglich der Definition der entsprechenden Elemente dienen. \BeginIndexGroup\BeginIndex{FontElement}{titlehead}% \LabelFontElement{titlehead}% 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 +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. Für die Ausgabe wird die +gestaltet werden. Für die Ausgabe wird die Schrift\important{\FontElement{titlehead}} des gleichnamigen Elements verwendet (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}, \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).% @@ -365,18 +365,18 @@ verwendet (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}, \BeginIndexGroup\BeginIndex{FontElement}{subject}\LabelFontElement{subject}% Die\important{\Macro{subject}} -\PName{Typisierung}\Index[indexmain]{Typisierung} wird unmittelbar über dem +\PName{Typisierung}\Index[indexmain]{Typisierung} wird unmittelbar über dem \PName{Titel} in der Schrift\important{\FontElement{subject}} des gleichnamigen Elements ausgegeben.% \EndIndexGroup \BeginIndexGroup\BeginIndex{FontElement}{title}\LabelFontElement{title}% -Der\important{\Macro{title}} \PName{Titel} wird in einer sehr großen Schrift +Der\important{\Macro{title}} \PName{Titel} wird in einer sehr großen Schrift gesetzt. Dabei\IfThisCommonLabelBase{maincls}{% \ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}}{} finden \IfThisCommonLabelBase{scrextend}{}{abgesehen - von der Größe }% Umbruchkorrektur -Schriftumschaltungen für das Element + von der Größe }% Umbruchkorrektur +Schriftumschaltungen für das Element \FontElement{title}\IndexFontElement[indexmain]{title}% \important{\FontElement{title}} Anwendung (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}, @@ -415,39 +415,39 @@ Elements (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}, \BeginIndexGroup\BeginIndex{FontElement}{publishers}% \LabelFontElement{publishers}% -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 +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 +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 Ausgabe erfolgt in der +vorhandenen Fußnoten ausgegeben wird. Die Ausgabe erfolgt in der Schrift\important{\FontElement{publishers}} des gleichnamigen Elements (siehe \autoref{tab:\ThisCommonFirstLabelBase.mainTitle}, \autopageref{tab:\ThisCommonFirstLabelBase.mainTitle}).% \EndIndexGroup -Fußnoten\important{\Macro{thanks}}\Index{Fussnoten=Fußnoten} werden auf der +Fußnoten\important{\Macro{thanks}}\Index{Fussnoten=Fußnoten} werden auf der Titelseite nicht mit \DescRef{\ThisCommonLabelBase.cmd.footnote}, sondern mit -der Anweisung \Macro{thanks} erzeugt. Sie dienen in der Regel für Anmerkungen -bei den Autoren. Als Fußnotenzeichen werden dabei Symbole statt Zahlen +der Anweisung \Macro{thanks} erzeugt. Sie dienen in der Regel für Anmerkungen +bei den Autoren. Als Fußnotenzeichen werden dabei Symbole statt Zahlen verwendet. Es\textnote{Achtung!} ist zu beachten, dass \Macro{thanks} -innerhalb des Arguments einer der übrigen Anweisungen, beispielsweise im +innerhalb des Arguments einer der übrigen Anweisungen, beispielsweise im Argument \PName{Autor} der Anweisung \Macro{author}, zu verwenden ist. % \IfThisCommonLabelBase{scrextend}{% - Damit die Schrifteinstellung für das Element + Damit die Schrifteinstellung für das Element \DescRef{\ThisCommonLabelBase.fontelement.footnote} beim Paket \Package{scrextend} Beachtung findet muss allerdings nicht nur die - Titelerweiterung aktiviert sein, es muss auch dafür gesorgt sein, dass die - Fußnoten mit diesem Paket gesetzt werden (siehe Einleitung von + Titelerweiterung aktiviert sein, es muss auch dafür gesorgt sein, dass die + Fußnoten mit diesem Paket gesetzt werden (siehe Einleitung von \autoref{sec:\ThisCommonLabelBase.footnotes}, \autopageref{sec:\ThisCommonLabelBase.footnotes}). Trifft dies nicht zu, so - wird die Schrift verwendet, die von der Klasse oder anderen für die Fußnoten + wird die Schrift verwendet, die von der Klasse oder anderen für die Fußnoten verwendeten Paketen vorgegeben ist.% }{}% -Für% +Für% \IfThisCommonLabelBase{maincls}{% \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% @@ -473,9 +473,9 @@ zu entnehmen.% \setcapindent{0pt}% % \addtokomafont{caption}{\raggedright}% \begin{captionbeside} - [{Schriftvoreinstellungen für die Elemente des Titels}] + [{Schriftvoreinstellungen für die Elemente des Titels}] {\label{tab:\ThisCommonLabelBase.titlefonts}% - \hspace{0pt plus 1ex}Voreinstellungen der Schrift für die Elemente des Titels} + \hspace{0pt plus 1ex}Voreinstellungen der Schrift für die Elemente des Titels} [l] \begin{tabular}[t]{ll} \toprule @@ -501,7 +501,7 @@ zu entnehmen.% \end{table}% }{}% -Bis auf den \PName{Kopf} und eventuelle Fußnoten werden alle Ausgaben +Bis auf den \PName{Kopf} und eventuelle Fußnoten werden alle Ausgaben horizontal zentriert. % \iffree{% \IfThisCommonLabelBase{scrextend}{Die Formatierungen der einzelnen @@ -526,7 +526,7 @@ horizontal zentriert. % % \caption \begin{captionbeside}[Der Haupttitel]{% \hspace{0pt plus 1ex}% - Schrift\-größe und + Schrift\-größe und Ausrichtung der Elemente der Haupttitelseite bei Verwendung von \DescRef{\LabelBase.cmd.maketitle}} [l] @@ -553,7 +553,7 @@ horizontal zentriert. % }{} \IfThisCommonFirstRun{\iftrue}{% - Ein Beispiel mit allen von \KOMAScript{} angebotenen Elementen für die + Ein Beispiel mit allen von \KOMAScript{} angebotenen Elementen für die Haupttitelseite finden Sie in \autoref{sec:\ThisCommonFirstLabelBase.titlepage} auf \PageRefxmpl{\ThisCommonFirstLabelBase.maintitle}.% @@ -562,11 +562,11 @@ horizontal zentriert. % \begin{Example} \phantomsection\xmpllabel{maintitle}% Nehmen wir nun einmal an, Sie schreiben eine Diplomarbeit. Dabei sei - vorgegeben, dass die Titelseite oben linksbündig das Institut - einschließlich Adresse und rechtsbündig das Semester wiedergibt. Wie - üblich ist ein Titel einschließlich Autor und Abgabedatum zu setzen. - Außerdem soll der Betreuer angegeben und zu erkennen sein, dass es - sich um eine Diplomarbeit handelt. Sie könnten das wie folgt + vorgegeben, dass die Titelseite oben linksbündig das Institut + einschließlich Adresse und rechtsbündig das Semester wiedergibt. Wie + üblich ist ein Titel einschließlich Autor und Abgabedatum zu setzen. + Außerdem soll der Betreuer angegeben und zu erkennen sein, dass es + sich um eine Diplomarbeit handelt. Sie könnten das wie folgt erreichen: \begin{lstcode} \documentclass{scrbook} @@ -592,30 +592,30 @@ horizontal zentriert. % \fi \begin{Explain} - Ein häufiges Missverständnis betrifft die Bedeutung der - Haupttitelseite. Irrtümlich wird oft angenommen, es handle sich dabei um den + Ein häufiges Missverständnis betrifft die Bedeutung der + Haupttitelseite. Irrtümlich wird oft angenommen, es handle sich dabei um den 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, + 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 sogenannten Buchblocks. Genau diese Titelseiten werden mit \DescRef{\ThisCommonLabelBase.cmd.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, das man in einem getrennten Dokument erstellt. Schließlich hat er oft - eine sehr individuelle Gestalt. Es spricht auch nichts dagegen, hierfür ein + gesamten Dokuments gehorcht. Ãœberhaupt ist ein Buchdeckel, das \emph{Cover}, + 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 + 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 \DescRef{\ThisCommonLabelBase.cmd.maketitle} ausgegebene Titelseite - alternativ aber auch als Umschlagseite formatieren lassen. Dabei ändern sich - nur die für diese Seite verwendeten Ränder (siehe Option + alternativ aber auch als Umschlagseite formatieren lassen. Dabei ändern sich + nur die für diese Seite verwendeten Ränder (siehe Option \OptionValueRef{\ThisCommonLabelBase}{titlepage}{firstiscover}% \IndexOption{titlepage~=\textKValue{firstiscover}} auf \DescPageRef{\ThisCommonLabelBase.option.titlepage}). @@ -625,21 +625,21 @@ horizontal zentriert. % \begin{Declaration} - \Macro{uppertitleback}\Parameter{Titelrückseitenkopf} - \Macro{lowertitleback}\Parameter{Titelrückseitenfuß} + \Macro{uppertitleback}\Parameter{Titelrückseitenkopf} + \Macro{lowertitleback}\Parameter{Titelrückseitenfuß} \end{Declaration}% Im\textnote{\KOMAScript{} vs. Standardklassen} doppelseitigen Druck bleibt bei -den Standardklassen die Rückseite des Blatts mit der Titelseite leer. Bei -{\KOMAScript} lässt sich die Rückseite der Haupttitelseite hingegen für +den Standardklassen die Rückseite des Blatts mit der Titelseite leer. Bei +{\KOMAScript} lässt sich die Rückseite der Haupttitelseite hingegen für weitere Angaben nutzen. Dabei wird zwischen genau zwei Elementen unterschieden, die der Anwender frei gestalten kann: dem -\PName{Titelrückseitenkopf}\Index{Titel>Rueckseite=Rückseite} und dem -\PName{Titelrückseitenfuß}. Dabei kann der Kopf bis zum Fuß reichen und +\PName{Titelrückseitenkopf}\Index{Titel>Rueckseite=Rückseite} und dem +\PName{Titelrückseitenfuß}. Dabei kann der Kopf bis zum Fuß reichen und umgekehrt. \iffree{Nimmt man diese Anleitung als Beispiel, so wurde der Haftungsausschluss mit Hilfe von \Macro{uppertitleback} - gesetzt.}{Beispielsweise hätte man die Verlagsinformationen zu diesem Buch + gesetzt.}{Beispielsweise hätte man die Verlagsinformationen zu diesem Buch wahlweise mit \Macro{uppertitleback} oder \Macro{lowertitleback} setzen - können.}% + können.}% % \EndIndexGroup @@ -648,7 +648,7 @@ umgekehrt. \iffree{Nimmt man diese Anleitung als Beispiel, so wurde der \Macro{dedication}\Parameter{Widmung} \end{Declaration}% {\KOMAScript} bietet eine eigene Widmungsseite. Diese Widmung\Index{Widmung} -wird zentriert und in der Voreinstellung mit etwas größerer +wird zentriert und in der Voreinstellung mit etwas größerer Schrift\textnote{Schrift} gesetzt. \BeginIndexGroup\BeginIndex{FontElement}{dedication}% \LabelFontElement{dedication} @@ -660,17 +660,17 @@ Die% \IfThisCommonLabelBase{scrextend}{% \ChangedAt{v3.12}{\Package{scrextend}}% }{\InternalCommonFileUseError}% -}\important{\FontElement{dedication}} genaue Schrifteinstellung für das +}\important{\FontElement{dedication}} genaue Schrifteinstellung für das Element \FontElement{dedication}, die \autoref{tab:\ThisCommonFirstLabelBase.titlefonts}, \autopageref{tab:\ThisCommonFirstLabelBase.titlefonts} zu entnehmen ist, kann -über die Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und +über die Anweisungen \DescRef{\ThisCommonLabelBase.cmd.setkomafont} und \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (siehe \autoref{sec:\ThisCommonLabelBase.textmarkup}, -\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) verändert werden.% +\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) verändert werden.% \EndIndexGroup -Die Rückseite ist grundsätzlich leer. Die Widmungsseite wird zusammen mit der +Die Rückseite ist grundsätzlich leer. Die Widmungsseite wird zusammen mit der restlichen Titelei mit \DescRef{\ThisCommonLabelBase.cmd.maketitle} ausgegeben und muss daher vor dieser Anweisung definiert sein. @@ -683,7 +683,7 @@ und muss daher vor dieser Anweisung definiert sein. \begin{Example} \phantomsection\xmpllabel{fulltitle} Nehmen wir dieses Mal an, dass Sie einen Gedichtband schreiben, den - Sie Ihrer Partnerin oder Ihrem Partner widmen wollen. Das könnte wie folgt + Sie Ihrer Partnerin oder Ihrem Partner widmen wollen. Das könnte wie folgt aussehen: \begin{lstcode} \documentclass{scrbook} @@ -718,6 +718,6 @@ und muss daher vor dieser Anweisung definiert sein. %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/common-typearea.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/common-typearea.tex index 87b1c4e29e..b3fa31fc35 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/common-typearea.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/common-typearea.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-typearea.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-typearea.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{common-typearea.tex} - [$Date: 2018-02-01 12:55:46 +0100 (Thu, 01 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (common paragraphs: typearea)] @@ -55,16 +55,16 @@ \BeginIndexGroup \BeginIndex{}{Seiten>Aufteilung=Auf\/teilung} -Eine Dokumentseite besteht aus unterschiedlichen Teilen, wie den Rändern, dem -Kopf, dem Fuß, dem Textbereich, einer Marginalienspalte und den Abständen +Eine Dokumentseite besteht aus unterschiedlichen Teilen, wie den Rändern, dem +Kopf, dem Fuß, dem Textbereich, einer Marginalienspalte und den Abständen zwischen diesen Elementen. \KOMAScript{} unterscheidet dabei auch noch zwischen der Gesamtseite oder dem Papier und der sichtbaren Seite. Ohne -Zweifel gehört die Auf"|teilung der Seite in diese unterschiedlichen Teile zu -den Grundfähigkeiten einer +Zweifel gehört die Auf"|teilung der Seite in diese unterschiedlichen Teile zu +den Grundfähigkeiten einer Klasse\IfThisCommonLabelBase{scrlttr2}{\OnlyAt{scrlttr2}}{}. Bei \KOMAScript{} wird diese Arbeit an das Paket \Package{typearea} delegiert. Dieses Paket kann auch zusammen mit anderen Klassen verwendet werden. Die \KOMAScript-Klassen -laden \Package{typearea} jedoch selbstständig. Es ist daher weder notwendig +laden \Package{typearea} jedoch selbstständig. Es ist daher weder notwendig noch sinnvoll, das Paket bei Verwendung einer \KOMAScript-Klasse auch noch explizit per \Macro{usepackage} zu laden. Siehe hierzu auch \autoref{sec:\ThisCommonLabelBase.options}, ab @@ -74,8 +74,8 @@ Einige Einstellungen der \KOMAScript{}-Klassen haben Auswirkungen auf die Seitenauf"|teilung und umgekehrt. Diese Auswirkungen werden bei den entsprechenden Einstellungen dokumentiert. -Für die weitere Erklärung zur Wahl des Papierformats, der Auf"|teilung der Seite -in Ränder und Satzspiegel und die Wahl von ein- oder zweispaltigem Satz sei +Für die weitere Erklärung zur Wahl des Papierformats, der Auf"|teilung der Seite +in Ränder und Satzspiegel und die Wahl von ein- oder zweispaltigem Satz sei auf die Anleitung des Pakets \Package{typearea} verwiesen. Diese ist in \autoref{cha:typearea} ab \autopageref{cha:typearea} zu finden. @@ -83,6 +83,6 @@ auf die Anleitung des Pakets \Package{typearea} verwiesen. Diese ist in %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/expertpart.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/expertpart.tex index 30b3608c14..2492207cfc 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/expertpart.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/expertpart.tex @@ -1,6 +1,6 @@ % ====================================================================== % expertpart.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,7 +40,7 @@ % % ---------------------------------------------------------------------- % -% Erster Teil: KOMA-Script für Autoren +% Erster Teil: KOMA-Script für Autoren % Verwaltet von Markus Kohm % % ====================================================================== @@ -51,27 +51,27 @@ \vspace*{2\baselineskip}% \setlength{\parindent}{1em}% - \noindent In diesem Teil sind die Informationen für die Autoren von + \noindent In diesem Teil sind die Informationen für die Autoren von \LaTeX-Paketen und "~Klassen zu finden. Dies betrifft nicht nur - Anweisungen, die bei der Implementierung neuer Pakete und Klassen nützlich + Anweisungen, die bei der Implementierung neuer Pakete und Klassen nützlich sind, sondern auch Schnittstellen, die weitere Eingriffe in \KOMAScript{} - erlauben. Darüber hinaus sind in diesem Teil auch obsolete Optionen und - Anweisungen ebenso wie Hintergründe zur Implementierung von \KOMAScript{} zu + erlauben. Darüber hinaus sind in diesem Teil auch obsolete Optionen und + Anweisungen ebenso wie Hintergründe zur Implementierung von \KOMAScript{} zu finden. - Dieser Teil ist als Ergänzung zu den Informationen für Autoren von - Artikeln, Berichten, Büchern und Briefen in \autoref{part:forAuthors} - gedacht. Nähere Informationen und Beispiele für diese Anwender sind + Dieser Teil ist als Ergänzung zu den Informationen für Autoren von + Artikeln, Berichten, Büchern und Briefen in \autoref{part:forAuthors} + gedacht. Nähere Informationen und Beispiele für diese Anwender sind jenem Teil zu entnehmen. } -\part{\KOMAScript{} für fortgeschrittene Anwender +\part{\KOMAScript{} für fortgeschrittene Anwender und Experten\label{part:forExperts}} \endinput %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "guide.tex" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/guide-ngerman.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/guide-ngerman.tex index 504ee20268..777b4f1686 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/guide-ngerman.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/guide-ngerman.tex @@ -1,6 +1,6 @@ % ====================================================================== % guide-ngerman.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,7 +46,7 @@ % ====================================================================== % \KOMAProvidesFile{guide-ngerman.tex} - [$Date: 2018-04-13 07:41:27 +0200 (Fri, 13 Apr 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide language dependencies] % % \section{Title} @@ -87,7 +87,7 @@ Umbruchs\par\medskip% Diese Anleitung ist als Bestandteil von \KOMAScript{} frei im Sinne der \LaTeX{} Project Public License Version 1.3c. Eine f\"ur \KOMAScript{} g\"ultige - deutsche \"Ubersetzung liegt \KOMAScript{} in der Datei »\texttt{lppl-de.txt}« + deutsche \"Ubersetzung liegt \KOMAScript{} in der Datei »\texttt{lppl-de.txt}« bei. Diese Anleitung --~auch in gedruckter Form~-- darf nur zusammen mit den \"ubrigen Bestandteilen von \KOMAScript{} weitergegeben und verteilt werden. Eine Verteilung der Anleitung unabh\"angig von den \"ubrigen Bestandteilen von @@ -312,6 +312,19 @@ % \end{macro} % \end{macro} % +% \begin{macro}{\GuideHook} +% \begin{macro}{\GuideHookIndexCategory} +% \begin{macro}{\GuideHookIndexCategoryEpanded} +% The term ``hook''. +% \begin{macrocode} +\newcommand*{\GuideHook}{Haken} +\newcommand*{\GuideHookIndexCategory}{Haken} +\let\GuideHookIndexCategoryExpanded\GuideHookIndexCategory +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% % \begin{macro}{\GuideAnd} % The ``and'' at a list of two. % \begin{macrocode} @@ -350,6 +363,8 @@ % \begin{macro}{\GuidefilIndexShort} % \begin{macro}{\GuideoptIndex} % \begin{macro}{\GuideoptIndexShort} +% \begin{macro}{\GuidehokIndex} +% \begin{macro}{\GuidehokIndexShort} % The titles and short titles of each single index. \newcommand*{\GuidegenIndex}{Allgemeiner Index} \newcommand*{\GuidecmdIndex}{Befehle, Umgebungen und @@ -365,6 +380,10 @@ \newcommand*{\GuideoptIndex}{Klassen- und Paketoptionen} \newcommand*{\GuideoptIndexShort}{Index der Optionen} +\newcommand*{\GuidehokIndex}{Haken (\emph{do-hooks})} +\newcommand*{\GuidehokIndexShort}{Index der Haken} +% \end{macro} +% \end{macro} % \end{macro} % \end{macro} % \end{macro} @@ -400,8 +419,8 @@ % \begin{macro}{\GuideIndexSeeAlsos} % These are all see also index entries. \newcommand*{\GuideIndexSeeAlsos}{% - \Index{Ueberschriften=Überschriften|seealso{Abschnitt, Gliederung, Kapitel}}% - \Index{Gliederung|seealso{Abschnitt, Kapitel, Überschriften}}% + \Index{Ueberschriften=Ãœberschriften|seealso{Abschnitt, Gliederung, Kapitel}}% + \Index{Gliederung|seealso{Abschnitt, Kapitel, Ãœberschriften}}% \Index{Bindeanteil|seealso{Bindekorrektur}}% \Index{Bindung|seealso{Bindekorrektur}}% } @@ -522,9 +541,10 @@ Da-tei-na-me Da-tei-na-men Da-tei-na-mens Da-tei-na-men-er-wei-te-rung Da-tei-na-men-er-wei-te-rung-en Ein-trags-ebe-ne Ein-trags-ebe-nen + Farb-um-schal-tung Farb-um-schal-tung-en Gleich-zei-tig Hin-ter-grund-ebe-ne Hin-ter-grund-ebe-nen - In-halts-ver-zeich-nis-ein-trag In-halts-ver-zeich-nis-ein-trä-ge + In-halts-ver-zeich-nis-ein-trag In-halts-ver-zeich-nis-ein-trä-ge Ka-pi-tel-ebe-ne Ka-pi-tel-ebe-nen Pa-ket-au-to-ren Pa-pier-rand Pa-pier-ran-des @@ -535,7 +555,7 @@ Stan-dard-ein-stel-lung Stan-dard-ein-stel-lun-gen Text-ebe-ne Text-ebe-nen Unix - Zei-len-um-bruch Zei-len-um-bruchs Zei-len-um-brü-che Zei-len-um-brü-chen + Zei-len-um-bruch Zei-len-um-bruchs Zei-len-um-brü-che Zei-len-um-brü-chen } % \end{macrocode} % @@ -544,6 +564,6 @@ \endinput %%% Local Variables: %%% mode: doctex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide.tex" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/htmlsetup b/macros/latex/contrib/koma-script/source-doc/ngerman/htmlsetup index 92dd812ff4..64907a5e75 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/htmlsetup +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/htmlsetup @@ -1,6 +1,6 @@ # ====================================================================== # htmlsetup -# Copyright (c) Markus Kohm, 2002-2013 +# Copyright (c) Markus Kohm, 2002-2019 # # 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-2013 +# Copyright (c) Markus Kohm, 2002-2019 # # Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, # Version 1.3c, verteilt und/oder veraendert werden. @@ -39,18 +39,17 @@ $baselink="scrguide.pdf"; $htmlhead="<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.0//EN\"> <html> <head><title>Index</title> -<meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\"> + <meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\"> </head> <body> -<h1>Index der KOMA-Script-Anleitung</h1> -<p>Dies ist ein Index der in KOMA-Script definierten Elemente. Dieser Index bezieht sich auf die <a href=\"scrguide.pdf\">KOMA-Script-Anleitung</a>. Zur besseren Ãœbersicht ist der Index in mehrere Funktionsgruppen unterteilt:</p> + <h1>Index der KOMA-Script-Anleitung</h1> + <p>Dies ist ein Index der in KOMA-Script definierten Elemente. Dieser Index bezieht sich auf die <a href=\"scrguide.pdf\">KOMA-Script-Anleitung</a>. Zur besseren Ãœbersicht ist der Index in mehrere Funktionsgruppen unterteilt:</p> "; -$htmlend="<p> -<a href=\"http://validator.w3.org/check?uri=referer\"><img +$htmlend=" <p><a href=\"http://validator.w3.org/check?uri=referer\"><img src=\"http://www.w3.org/Icons/valid-html40\" -alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a> -</p> -</body></html>"; +alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a></p> +</body> +</html>"; %titles=( "option" => "Optionen", "macro" => "Anweisungen", "environment" => "Umgebungen", @@ -60,6 +59,7 @@ alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a> "pagestyle" => "Seitenstile", "counter" => "Zähler", "floatstyle" => "Stile für das float-Paket", - "fontelement" => "Elemente deren Schrift geändert werden kann" ); + "fontelement" => "Elemente deren Schrift geändert werden kann", + "dohook" => "Do-Hooks für Manipulationen auf unterer Ebene" ); # end of file diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/introduction.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/introduction.tex index b5cd43b836..5c99194e26 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/introduction.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/introduction.tex @@ -1,6 +1,6 @@ % ====================================================================== % introduction.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,84 +46,84 @@ % ====================================================================== \KOMAProvidesFile{introduction.tex} - [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide introduction] \chapter{Einleitung} \labelbase{introduction} -Dieses Kapitel enthält \iffree{unter anderem }{}wichtige Informationen über +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, die Jahre vor der ersten Version beginnt. Darüber hinaus finden +Sie Informationen für den Fall, dass Sie % \iffalse % Umbruchkorreturauslassung \KOMAScript{} noch nicht installiert haben, oder % \fi% -auf Fehler stoßen. +auf Fehler stoßen. \iffree{% \section{Vorwort} \seclabel{preface} {\KOMAScript} ist ein sehr komplexes Paket (engl. \emph{bundle}). Dies -ist schon allein darin begründet, dass es nicht nur aus einer einzigen +ist schon allein darin begründet, dass es nicht nur aus einer einzigen Klasse (engl. \emph{class}) oder einem einzigen Paket (engl. \emph{package}), sondern einer Vielzahl derer besteht. Zwar sind die -Klassen als Gegenstücke zu den Standardklassen konzipiert (siehe -\autoref{cha:maincls}), das heißt jedoch insbesondere nicht, -dass sie nur über die Befehle, Umgebungen und Einstellmöglichkeiten -der Standardklassen verfügen oder deren Aussehen als -Standardeinstellung übernehmen. -Die Fähigkeiten von {\KOMAScript} reichen -teilweise weit über die Fähigkeiten der Standardklassen hinaus. -Manche davon sind auch als Ergänzung zu den Grundfähigkeiten des +Klassen als Gegenstücke zu den Standardklassen konzipiert (siehe +\autoref{cha:maincls}), das heißt jedoch insbesondere nicht, +dass sie nur über die Befehle, Umgebungen und Einstellmöglichkeiten +der Standardklassen verfügen oder deren Aussehen als +Standardeinstellung übernehmen. +Die Fähigkeiten von {\KOMAScript} reichen +teilweise weit über die Fähigkeiten der Standardklassen hinaus. +Manche davon sind auch als Ergänzung zu den Grundfähigkeiten des \LaTeX-Kerns zu betrachten. -Allein aus dem Vorgenannten ergibt sich schon zwangsläufig, dass die -Dokumentation zu {\KOMAScript} sehr umfangreich ausfällt. Hinzu kommt, -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 der Autor gegenüber sieht, -besteht jedoch darin, dass eine Anleitung für alle möglichen -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. Ich habe mich bemüht, obwohl es sich -dabei eigentlich um ein unmögliches Unterfangen handelt. Ergebnis sind +Allein aus dem Vorgenannten ergibt sich schon zwangsläufig, dass die +Dokumentation zu {\KOMAScript} sehr umfangreich ausfällt. Hinzu kommt, +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 der Autor gegenüber sieht, +besteht jedoch darin, dass eine Anleitung für alle möglichen +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. Ich habe mich bemüht, obwohl es sich +dabei eigentlich um ein unmögliches Unterfangen handelt. Ergebnis sind zahlreiche Kompromisse. Ich bitte jedoch, die Problematik bei -eventuellen Beschwerden zu berücksichtigen und bei der Verbesserung -der derzeitigen Lösung zu helfen. +eventuellen Beschwerden zu berücksichtigen und bei der Verbesserung +der derzeitigen Lösung zu helfen. -Trotz des Umfangs der Anleitung bitte ich außerdem darum, im Falle von -Problemen zunächst die Dokumentation zu konsultieren. Als erste Anlaufstelle +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 +hingewiesen. \iffree{Zur Dokumentation gehören neben dieser Anleitung auch alle Text-Dokumente, die Bestandteil des Pakets sind. Sie sind in - \File{manifest.txt} vollständig aufgeführt}{} + \File{manifest.txt} vollständig aufgeführt}{} }{} \section{Dokumentaufbau} \seclabel{structure} -Diese Anleitung ist in mehrere Teile untergliedert. Es gibt einen Teil für -Anwender, einen für fortgeschrittene Anwender und Experten und einen Anhang -mit weiterführenden Informationen und Beispielen für diejenigen, die es ganz +Diese Anleitung ist in mehrere Teile untergliedert. Es gibt einen Teil für +Anwender, einen für fortgeschrittene Anwender und Experten und einen Anhang +mit weiterführenden Informationen und Beispielen für diejenigen, die es ganz genau wissen wollen. \autoref{part:forAuthors} richtet sich dabei an alle \KOMAScript-Anwender. Das -bedeutet, dass hier auch einige Informationen für \LaTeX-Neulinge zu finden +bedeutet, dass hier auch einige Informationen für \LaTeX-Neulinge zu finden sind. Insbesondere ist dieser Teil mit vielen Beispielen angereichert, die dem -reinen Anwender zur Verdeutlichung der Erklärungen dienen sollen. Scheuen Sie +reinen Anwender zur Verdeutlichung der Erklärungen dienen sollen. Scheuen Sie sich nicht, diese Beispiele selbst auszuprobieren und durch Abwandlung herauszufinden, wie \KOMAScript{} funktioniert. Trotz allem ist diese -Anleitung jedoch keine Einführung in \LaTeX. \LaTeX-Neulingen seien daher +Anleitung jedoch keine Einführung in \LaTeX. \LaTeX-Neulingen seien daher Dokumente wie \cite{l2kurz} nahegelegt. Wiedereinsteigern aus der Zeit von \LaTeX~2.09 sei zumindest \cite{latex:usrguide} empfohlen. Auch das Studium des einen oder anderen Buches zu \LaTeX{} wird empfohlen. Literaturempfehlungen finden sich beispielsweise in \cite{DANTE:FAQ}. Der Umfang von \cite{DANTE:FAQ} ist ebenfalls erheblich. Dennoch wird darum gebeten, sich -einen groben Überblick darüber zu verschaffen und es bei Problemen ebenso wie +einen groben Ãœberblick darüber zu verschaffen und es bei Problemen ebenso wie \iffree{diese Anleitung}{dieses Buch} zu konsultieren. \autoref{part:forExperts} richtet sich an fortgeschrittene @@ -131,56 +131,56 @@ einen groben Überblick darüber zu verschaffen und es bei Problemen ebenso wie auskennen oder schon einige Zeit mit \KOMAScript{} gearbeitet haben und jetzt etwas besser verstehen wollen, wie \KOMAScript{} funktioniert, wie es mit anderen Paketen interagiert und wie man speziellere Aufgaben mit \KOMAScript{} -lösen kann. Dazu werden die Klassenbeschreibungen aus -\autoref{part:forAuthors} in einigen Aspekten nochmals aufgegriffen und näher -erläutert. Dazu kommt die Dokumentation von Anweisungen, die speziell für -fortgeschrittene Anwender und Experten vorgesehen sind. Ergänzt wird dies -durch die Dokumentation von Paketen, die für den Anwender normalerweise insofern -verborgen sind, als sie unter der Oberfläche der Klassen und Anwenderpakete -ihre Arbeit verrichten. Diese Pakete sind ausdrücklich auch für die Verwendung +lösen kann. Dazu werden die Klassenbeschreibungen aus +\autoref{part:forAuthors} in einigen Aspekten nochmals aufgegriffen und näher +erläutert. Dazu kommt die Dokumentation von Anweisungen, die speziell für +fortgeschrittene Anwender und Experten vorgesehen sind. Ergänzt wird dies +durch die Dokumentation von Paketen, die für den Anwender normalerweise insofern +verborgen sind, als sie unter der Oberfläche der Klassen und Anwenderpakete +ihre Arbeit verrichten. Diese Pakete sind ausdrücklich auch für die Verwendung durch andere Klassen- und Paketautoren vorgesehen. Der Anhang\iffree{, der nur in der Buchfassung zu finden ist,}{} richtet sich -an diejenigen, denen all diese Informationen nicht genügen. Es gibt dort zum +an diejenigen, denen all diese Informationen nicht genügen. Es gibt dort zum einen Hintergrundwissen zu Fragen der Typografie, mit denen dem -fortgeschrittenen Anwender eine Grundlage für fundierte eigene Entscheidungen -vermittelt werden soll. Darüber hinaus sind dort Beispiele für angehende +fortgeschrittenen Anwender eine Grundlage für fundierte eigene Entscheidungen +vermittelt werden soll. Darüber hinaus sind dort Beispiele für angehende Paketautoren zu finden. Diese Beispiele sind weniger dazu gedacht, einfach -übernommen zu werden. Vielmehr sollen sie Wissen um Planung und Durchführung -von \LaTeX-Projekten sowie einige grundlegende \LaTeX-Anweisungen für +übernommen zu werden. Vielmehr sollen sie Wissen um Planung und Durchführung +von \LaTeX-Projekten sowie einige grundlegende \LaTeX-Anweisungen für Paketautoren vermitteln. Die Kapitel-Einteilung der Anleitung soll ebenfalls dabei -helfen, nur die Teile lesen zu müssen, die tatsächlich von Interesse sind. Um +helfen, nur die Teile lesen zu müssen, die tatsächlich von Interesse sind. Um dies zu erreichen, sind die Informationen zu den einzelnen Klassen und Paketen -nicht über das gesamte Dokument verteilt, sondern jeweils in einem Kapitel +nicht über das gesamte Dokument verteilt, sondern jeweils in einem Kapitel konzentriert. Querverweise in ein anderes Kapitel sind damit in der Regel auch Verweise auf einen anderen Teil des Gesamtpakets. Da die drei Hauptklassen in -weiten Teilen übereinstimmen, sind sie in einem gemeinsamen Kapitel +weiten Teilen übereinstimmen, sind sie in einem gemeinsamen Kapitel zusammengefasst. Die Unterschiede werden deutlich hervorgehoben, soweit sinnvoll auch durch eine entsprechende Randnotiz. Dies geschieht beispielsweise wie hier, wenn etwas nur die Klasse \Class{scrartcl}\OnlyAt{\Class{scrartcl}} betrifft. Nachteil dieses Vorgehens ist, dass diejenigen, die \KOMAScript{} insgesamt kennenlernen wollen, in -einigen Kapiteln auf bereits Bekanntes stoßen werden. Vielleicht nutzen Sie +einigen Kapiteln auf bereits Bekanntes stoßen werden. Vielleicht nutzen Sie die Gelegenheit, um Ihr Wissen zu vertiefen. Unterschiedliche Schriftarten werden auch zur Hervorhebung unterschiedlicher Dinge verwendet. So werden die Namen von \Package{Paketen} und \Class{Klassen} anders angezeigt als \File{Dateinamen}. \Option{Optionen}, \Macro{Anweisungen}, \Environment{Umgebungen}, \Variable{Variablen} und -\PLength{Pseudolängen} werden einheitlich hervorgehoben. Der -\PName{Platzhalter} für einen Parameter wird jedoch anders dargestellt als ein +\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{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{Umgebung} +\PValue{document} ein konkreter Wert für den Parameter \PName{Umgebung} der Anweisung \Macro{begin}. \iffalse% Umbruchkorrekturtext Damit sollten Sie nun alles wissen, um diese Anleitung lesen und verstehen zu -können. Trotzdem könnte es sich lohnen, den Rest dieses Kapitels gelegentlich +können. Trotzdem könnte es sich lohnen, den Rest dieses Kapitels gelegentlich auch zu lesen. \fi @@ -193,47 +193,47 @@ auch zu lesen. Vorlesungsskript zu setzen. Damals war noch \LaTeX~2.09 aktuell und es gab keine Unterscheidung nach Klassen und Paketen, sondern alles waren Stile (engl. \emph{styles}). Die Standarddokumentstile - erschienen ihm für ein Vorlesungsskript nicht optimal und boten auch - nicht alle Befehle und Umgebungen, die er benötigte. + erschienen ihm für ein Vorlesungsskript nicht optimal und boten auch + nicht alle Befehle und Umgebungen, die er benötigte. - Zur selben Zeit beschäftigte sich Frank auch mit Fragen der - Typografie, insbesondere mit \cite{JTsch87}. Damit stand für ihn - fest, nicht nur irgendeinen Dokumentstil für Skripten zu erstellen, - sondern allgemein eine Stilfamilie, die den Regeln der europäischen + Zur selben Zeit beschäftigte sich Frank auch mit Fragen der + Typografie, insbesondere mit \cite{JTsch87}. Damit stand für ihn + fest, nicht nur irgendeinen Dokumentstil für Skripten zu erstellen, + sondern allgemein eine Stilfamilie, die den Regeln der europäischen Typografie folgt. {\Script} war geboren. - Der \KOMAScript-Autor traf auf {\Script} ungefähr zum Jahreswechsel - 1992/""1993. Im Gegensatz zu Frank Neukam hatte er häufig mit Dokumenten im + Der \KOMAScript-Autor traf auf {\Script} ungefähr zum Jahreswechsel + 1992/""1993. Im Gegensatz zu Frank Neukam hatte er häufig mit Dokumenten im A5-Format zu tun. Zu jenem Zeitpunkt wurde A5 weder von den Standardstilen - noch von {\Script} unterstützt. Daher dauerte es nicht lange, bis er erste - Veränderungen an {\Script} vornahm. Diese fanden sich auch in {\ScriptII} - wieder, das im Dezember~1993 von Frank veröffentlicht wurde. + noch von {\Script} unterstützt. Daher dauerte es nicht lange, bis er erste + Veränderungen an {\Script} vornahm. Diese fanden sich auch in {\ScriptII} + wieder, das im Dezember~1993 von Frank veröffentlicht wurde. - Mitte 1994 erschien dann \LaTeXe. Die damit einhergehenden Änderungen waren + Mitte 1994 erschien dann \LaTeXe. Die damit einhergehenden Änderungen waren tiefgreifend. Daher blieb dem Anwender von {\ScriptII} nur die Entscheidung, - sich entweder auf den Kompatibilitätsmodus von \LaTeX{} zu beschränken oder + sich entweder auf den Kompatibilitätsmodus von \LaTeX{} zu beschränken oder auf {\Script} zu verzichten. Wie viele andere wollte ich beides nicht. Also - machte der \KOMAScript-Autor sich daran, einen \Script-Nachfolger für + machte der \KOMAScript-Autor sich daran, einen \Script-Nachfolger für {\LaTeXe} zu entwickeln, der am 7.~Juli~1994 unter dem Namen {\KOMAScript} - erschienen ist. Ich will hier nicht näher auf die Wirren eingehen, die es um + erschienen ist. Ich will hier nicht näher auf die Wirren eingehen, die es um die offizielle Nachfolge von {\Script} gab und warum dieser neue Name - gewählt wurde. Tatsache ist, dass auch aus Franks Sicht {\KOMAScript} der - Nachfolger von {\ScriptII} ist. Zu erwähnen ist noch, dass {\KOMAScript} - ursprünglich ohne Briefklasse erschienen war. Diese wurde im Dezember~1994 - von Axel Kielhorn beigesteuert. Noch etwas später erstellte Axel Sommerfeldt + gewählt wurde. Tatsache ist, dass auch aus Franks Sicht {\KOMAScript} der + Nachfolger von {\ScriptII} ist. Zu erwähnen ist noch, dass {\KOMAScript} + ursprünglich ohne Briefklasse erschienen war. Diese wurde im Dezember~1994 + von Axel Kielhorn beigesteuert. Noch etwas später erstellte Axel Sommerfeldt den ersten richtigen scrguide zu {\KOMAScript}. - Seither ist einige Zeit vergangen. {\LaTeX} hat sich kaum verändert, die + Seither ist einige Zeit vergangen. {\LaTeX} hat sich kaum verändert, die \LaTeX-Landschaft erheblich. {\KOMAScript} wurde weiterentwickelt. Es findet nicht mehr allein im deutschsprachigen Raum Anwender, sondern in ganz Europa, Nordamerika, Australien und Asien. Diese Anwender suchen bei {\KOMAScript} nicht allein nach einem typografisch ansprechenden Ergebnis. Zu beobachten ist vielmehr, dass bei {\KOMAScript} ein neuer Schwerpunkt entstanden ist: Flexibilisierung durch Variabilisierung. Unter - diesem Schlagwort verstehe ich die Möglichkeit, in das Erscheinungsbild an - vielen Stellen eingreifen zu können. Dies führte zu vielen neuen Makros, die - mehr schlecht als recht in die ursprüngliche Dokumentation integriert wurden. - Irgendwann wurde es damit auch Zeit für eine komplett überarbeitete + diesem Schlagwort verstehe ich die Möglichkeit, in das Erscheinungsbild an + vielen Stellen eingreifen zu können. Dies führte zu vielen neuen Makros, die + mehr schlecht als recht in die ursprüngliche Dokumentation integriert wurden. + Irgendwann wurde es damit auch Zeit für eine komplett überarbeitete Anleitung. %\end{Explain} @@ -242,16 +242,16 @@ auch zu lesen. \section{Danksagung} \seclabel{thanks} -Mein persönlicher Dank gilt Frank Neukam, ohne dessen \Script-Familie es -vermutlich {\KOMAScript} nie gegeben hätte. Mein Dank gilt denjenigen, die an +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 +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, +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 +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 @@ -259,9 +259,9 @@ 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 +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. @@ -269,32 +269,32 @@ Arbeit an \KOMAScript{} bedacht hat. \seclabel{legal} {\KOMAScript} steht unter der {\LaTeX} Project Public Licence. Eine nicht -offizielle deutsche Übersetzung ist Bestandteil des \KOMAScript-Pakets. In -allen Zweifelsfällen gilt im deutschsprachigen Raum der Text -\File{lppl-de.txt}, während in allen anderen Ländern der Text \File{lppl.txt} +offizielle deutsche Ãœbersetzung ist Bestandteil des \KOMAScript-Pakets. In +allen Zweifelsfällen gilt im deutschsprachigen Raum der Text +\File{lppl-de.txt}, während in allen anderen Ländern der Text \File{lppl.txt} anzuwenden ist. -\iffree{Für die Korrektheit der Anleitung, Teile der Anleitung oder einer - anderen in diesem Paket enthaltenen Dokumentation wird keine Gewähr - übernommen.}% +\iffree{Für die Korrektheit der Anleitung, Teile der Anleitung oder einer + anderen in diesem Paket enthaltenen Dokumentation wird keine Gewähr + übernommen.}% {Diese gedruckte Ausgabe der Anleitung ist davon und von den in den Dateien \File{lppl.txt} und \File{lppl-de.txt} des \KOMAScript-Pakets - festgeschriebenden rechtlichen Bedingungen ausdrücklich ausgenommen.} + festgeschriebenden rechtlichen Bedingungen ausdrücklich ausgenommen.} }{} \section{Installation} \seclabel{installation} Die drei wichtigsten \TeX-Distributionen, Mac\TeX, MiK\TeX{} und \TeX~Live, -stellen \KOMAScript{} über ihre jeweiligen Paketverwaltungen bereit. Es wird -empfohlen, die Installation und Aktualisierung von \KOMAScript{} darüber +stellen \KOMAScript{} über ihre jeweiligen Paketverwaltungen bereit. Es wird +empfohlen, die Installation und Aktualisierung von \KOMAScript{} darüber vorzunehmen. Die manuelle Installation von {\KOMAScript} ohne Verwendung der jeweiligen Paketverwaltung wird in der Datei \File{INSTALLD.txt}, die Bestandteil jeder \KOMAScript-Verteilung ist, beschrieben. Beachten Sie dazu auch die jeweilige Dokumentation zur installierten \TeX-Distribution. Daneben gibt es auf \cite{homepage} seit einiger Zeit Installationspakete von -Zwischenversionen von \KOMAScript{} für die wichtigsten Distributionen. Für +Zwischenversionen von \KOMAScript{} für die wichtigsten Distributionen. Für deren Installation ist die dortige Anleitung zu beachten. @@ -305,7 +305,7 @@ deren Installation ist die dortige Anleitung zu beachten. 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 + 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. @@ -315,110 +315,110 @@ deren Installation ist die dortige Anleitung zu beachten. 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 + % 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, + 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 + 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 + 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 + 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. + \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 + 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 + 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. + 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. + 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 + 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. + 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 + 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} + 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 + \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.% }{% - Der Autor hat sich große Mühe gegeben, Fehler in diesem Buch zu + 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 + 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 + 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.% + für die Beseitigung eventueller Fehler eine Grundvoraussetzung.% } Bitte beachten Sie, dass typografisch nicht optimale Voreinstellungen keine -Fehler darstellen. Aus Gründen der Kompatibilität werden Voreinstellungen nach -Möglichkeit auch in neuen \KOMAScript-Versionen beibehalten. Darüber hinaus +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. +von \KOMAScript{} stellen daher zwangsläufig einen Kompromiss dar. \iffree{% \section{Weitere Informationen} \seclabel{moreinfos} -Sobald Sie im Umgang mit \KOMAScript{} geübt sind, werden Sie sich -möglicherweise Beispiele zu schwierigeren Aufgaben wünschen. Solche Beispiele -gehen über die Vermittlung von Grundwissen hinaus und sind daher\iffree{}{ - außer im Angang} nicht Bestandteil dieser Anleitung. Auf den Internetseiten +Sobald Sie im Umgang mit \KOMAScript{} geübt sind, werden Sie sich +möglicherweise Beispiele zu schwierigeren Aufgaben wünschen. Solche Beispiele +gehen über die Vermittlung von Grundwissen hinaus und sind daher\iffree{}{ + außer im Angang} nicht Bestandteil dieser Anleitung. Auf den Internetseiten des \KOMAScript{} Documentation Projects \cite{homepage} finden Sie jedoch -weiterführende Beispiele. Diese sind für fortgeschrittene \LaTeX-Anwender -konzipiert. Für Anfänger sind sie wenig oder nicht geeignet. +weiterführende Beispiele. Diese sind für fortgeschrittene \LaTeX-Anwender +konzipiert. Für Anfänger sind sie wenig oder nicht geeignet. }{} \endinput %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide.tex" %%% End: % LocalWords: Installationspakete Zwischenversionen Wiedereinsteigern -% LocalWords: Kompatibilitätsmodus +% LocalWords: Kompatibilitätsmodus diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/preface.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/preface.tex index 8143c645f8..a80375159c 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/preface.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/preface.tex @@ -1,6 +1,6 @@ % ====================================================================== % preface.tex -% Copyright (c) Markus Kohm, 2008-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -36,89 +36,89 @@ % ====================================================================== \KOMAProvidesFile{typearea.tex} - [$Date: 2018-03-12 09:45:33 +0100 (Mon, 12 Mar 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ Vorwort zu Version 3.25] \addchap{Vorwort zu \KOMAScript~3.25} Die Anleitung zu \KOMAScript~3.25 profitiert wieder einmal davon, dass nahezu -zeitgleich mit dieser Version auch eine überarbeitete Neuauflage der +zeitgleich mit dieser Version auch eine überarbeitete Neuauflage der Print-Ausgabe \cite{book:komascript} und der eBook-Ausgabe -\cite{ebook:komascript} erscheinen wird. Das führte zu vielen Verbesserungen, +\cite{ebook:komascript} erscheinen wird. Das führte zu vielen Verbesserungen, die sich auch auf die freie Anleitung auswirken. Eine dieser Verbesserungen ist die Verlinkung von Befehlen, Umgebungen, -Optionen etc. jeweils auf die entsprechende Erklärung innerhalb dieser -Anleitung. Um innerhalb der Erklärung selbst nicht dazu verleitet zu werden, -erneut an den Anfang der Erklärung zu springen, und so quasi Leserekursionen -zu vermeiden, wurde die Verlinkung allerdings nur dann durchgeführt, wenn sie -tatsächlich von der aktuellen Stelle weg führt. +Optionen etc. jeweils auf die entsprechende Erklärung innerhalb dieser +Anleitung. Um innerhalb der Erklärung selbst nicht dazu verleitet zu werden, +erneut an den Anfang der Erklärung zu springen, und so quasi Leserekursionen +zu vermeiden, wurde die Verlinkung allerdings nur dann durchgeführt, wenn sie +tatsächlich von der aktuellen Stelle weg führt. -Viele der Verbesserungen gehen auch auf die fleißigen, freiwilligen -Korrekturleser zurück. Ihnen sei an dieser Stelle ausdrücklich gedankt. +Viele der Verbesserungen gehen auch auf die fleißigen, freiwilligen +Korrekturleser zurück. Ihnen sei an dieser Stelle ausdrücklich gedankt. -\iffree{Leser dieser freien Bildschirm-Version müssen allerdings weiterhin mit - gewissen Einschränkungen leben. So sind einige Informationen -- - hauptsächliche solche für fortgeschrittene Anwender oder die dazu geeignet +\iffree{Leser dieser freien Bildschirm-Version müssen allerdings weiterhin mit + gewissen Einschränkungen leben. So sind einige Informationen -- + hauptsächliche solche für fortgeschrittene Anwender oder die dazu geeignet sind, aus einem Anwender einen fortgeschrittenen Anwender zu machen -- der - Buchfassung vorbehalten. Das führt auch dazu, dass weiterhin einige Links in - dieser Anleitung lediglich zu einer Seite führen, auf der genau diese - Tatsache erwähnt ist. Darüber hinaus ist die freie Version nur eingeschränkt + Buchfassung vorbehalten. Das führt auch dazu, dass weiterhin einige Links in + dieser Anleitung lediglich zu einer Seite führen, auf der genau diese + Tatsache erwähnt ist. Darüber hinaus ist die freie Version nur eingeschränkt zum Ausdruck geeignet. Der Fokus liegt vielmehr auf der Verwendung am Bildschirm parallel zur Arbeit an einem Dokument. Sie hat auch weiterhin keinen optimierten Umbruch, sondern ist quasi ein erster Entwurf, bei dem - sowohl der Absatz- als auch der Seitenumbruch in einigen Fällen durchaus - dürftig ist. Entsprechende Optimierungen sind den Buchausgaben + sowohl der Absatz- als auch der Seitenumbruch in einigen Fällen durchaus + dürftig ist. Entsprechende Optimierungen sind den Buchausgaben vorbehalten.}{} Nicht nur zur Anleitung erfahre ich inzwischen eher wenig Kritik. Auch zu den -Klassen und Paketen gibt es kaum noch Nachfragen nach neuen Möglichkeiten. Für -mich selbst bedeutet das, dass das Wissen um die Wünsche der Anwender -stagniert. Schon seit einigen Jahren habe ich daher hauptsächlich Dinge -implementiert, von denen ich annahm, dass sie nützlich sein könnten. Die -Rückmeldungen, die ich zu diesen neuen Möglichkeiten erhalten habe, -beschränken sich aber überwiegend auf Kritik daran, dass uralte \emph{Hacks}, -die sich auf undokumentierte Eigenschaften von \KOMAScript{} stützen, in -einigen Fällen nicht mehr funktionieren. Freude darüber, dass derart unsaubere -Notlösungen nicht mehr notwendig sind, wurde hingegen kaum geäußert. Daher +Klassen und Paketen gibt es kaum noch Nachfragen nach neuen Möglichkeiten. Für +mich selbst bedeutet das, dass das Wissen um die Wünsche der Anwender +stagniert. Schon seit einigen Jahren habe ich daher hauptsächlich Dinge +implementiert, von denen ich annahm, dass sie nützlich sein könnten. Die +Rückmeldungen, die ich zu diesen neuen Möglichkeiten erhalten habe, +beschränken sich aber überwiegend auf Kritik daran, dass uralte \emph{Hacks}, +die sich auf undokumentierte Eigenschaften von \KOMAScript{} stützen, in +einigen Fällen nicht mehr funktionieren. Freude darüber, dass derart unsaubere +Notlösungen nicht mehr notwendig sind, wurde hingegen kaum geäußert. Daher habe ich beschlossen, Erweiterungen und Verbesserungen an \KOMAScript{} mehr -und mehr auf solche Dinge zu beschränken, die von Anwendern explizit +und mehr auf solche Dinge zu beschränken, die von Anwendern explizit nachgefragt werden. Oder sollte es gar sein, dass \KOMAScript{} nach bald -25~Jahren schlicht einen Stand erreicht hat, in dem es alle Wünsche erfüllt? +25~Jahren schlicht einen Stand erreicht hat, in dem es alle Wünsche erfüllt? -Die rückläufige Entwicklung bei Fehlermeldungen ist leider ebenfalls nicht nur -erfreulich. Inzwischen ist häufig zu beobachten, dass diejenigen, die ein +Die rückläufige Entwicklung bei Fehlermeldungen ist leider ebenfalls nicht nur +erfreulich. Inzwischen ist häufig zu beobachten, dass diejenigen, die ein Problem entdecken, dieses nicht mehr unmittelbar an mich melden, sondern sich -lediglich in irgendwelchen Internet-Foren darüber auslassen. Oftmals finden -sich in diesen Foren dann mehr oder weniger geschickte Notlösungen. Das ist -zwar grundsätzlich erfreulich, führt aber leider in der Regel dazu, dass das +lediglich in irgendwelchen Internet-Foren darüber auslassen. Oftmals finden +sich in diesen Foren dann mehr oder weniger geschickte Notlösungen. Das ist +zwar grundsätzlich erfreulich, führt aber leider in der Regel dazu, dass das Problem nie gemeldet und daher auch nie wirklich beseitigt wird. Dass solche -Notlösungen irgendwann selbst zu einem Problem werden können, versteht sich -von selbst und wurde bereits im vorherigen Absatz erwähnt. +Notlösungen irgendwann selbst zu einem Problem werden können, versteht sich +von selbst und wurde bereits im vorherigen Absatz erwähnt. Vereinzelt finden sich dankenswerter Weise Dritte, die mich auf solche Themen -hinweisen. Dies betrifft aber nur einzelne Beiträge in sehr wenigen Foren. Ein +hinweisen. Dies betrifft aber nur einzelne Beiträge in sehr wenigen Foren. Ein direkter Kontakt zu demjenigen, bei dem das Problem aufgetreten ist, ist dann -meist nicht möglich, obwohl er teilweise wünschenswert wäre. +meist nicht möglich, obwohl er teilweise wünschenswert wäre. -Daher sei noch einmal ausdrücklich darum gebeten, mir vermeintliche Bugs +Daher sei noch einmal ausdrücklich darum gebeten, mir vermeintliche Bugs wahlweise in Deutsch oder Englisch unmittelbar zu melden. Dabei ist sprachliche Perfektion weniger wichtig. Die Meldung sollte halbwegs -verständlich und das Problem nachvollziehbar sein. Ein möglichst kurzes -Code-Beispiel ist in der Regel unabhängig von der darin verwendeten Sprache zu -verstehen. Im direkten Kontakt sind mir bei Bedarf auch Rückfragen -möglich. Bitte verlassen Sie sich nicht darauf, dass irgendwer das Problem +verständlich und das Problem nachvollziehbar sein. Ein möglichst kurzes +Code-Beispiel ist in der Regel unabhängig von der darin verwendeten Sprache zu +verstehen. Im direkten Kontakt sind mir bei Bedarf auch Rückfragen +möglich. Bitte verlassen Sie sich nicht darauf, dass irgendwer das Problem schon irgendwann melden wird. Gehen Sie davon aus, dass es nur behoben wird, -wenn Sie es selbst melden. Näheres zu Fehlermeldungen ist im ersten Kapitel +wenn Sie es selbst melden. Näheres zu Fehlermeldungen ist im ersten Kapitel \iffree{der Anleitung}{des Buches} zu finden. \bigskip\noindent -Markus Kohm, Neckarhausen bei Regen im März 2018 +Markus Kohm, Neckarhausen bei Regen im März 2018 \endinput %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide.tex" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scraddr.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scraddr.tex index 9b74b665e6..82281a5697 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scraddr.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scraddr.tex @@ -1,6 +1,6 @@ % ====================================================================== % scraddr.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,16 +40,16 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scraddr in der KOMA-Script-Anleitung -% Verwaltet von Jens-Uwe Morawski (mit Unterstützung von Markus Kohm) +% Kapitel über scraddr in der KOMA-Script-Anleitung +% Verwaltet von Jens-Uwe Morawski (mit Unterstützung von Markus Kohm) % % ====================================================================== \KOMAProvidesFile{scraddr.tex} - [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scraddr)] -\chapter{Adressdateien mit \Package{scraddr} erschließen}% +\chapter{Adressdateien mit \Package{scraddr} erschließen}% \labelbase{scraddr}% \BeginIndexGroup \BeginIndex{Package}{scraddr} @@ -61,9 +61,9 @@ vereinfachen und ihre Anwendung flexibler zu gestalten. \section{Befehle} \seclabel{overview} -Im Grunde stellt das Paket nur einen Lademechanismus für Adressdateien bereit, +Im Grunde stellt das Paket nur einen Lademechanismus für Adressdateien bereit, die aus \DescRef{\LabelBase.cmd.adrentry}- und neueren -\DescRef{\LabelBase.cmd.addrentry}-Einträgen bestehen, wie sie in +\DescRef{\LabelBase.cmd.addrentry}-Einträgen bestehen, wie sie in \autoref{cha:scrlttr2} ab \DescPageRef{scrlttr2.cmd.adrentry} beschrieben sind. @@ -77,9 +77,9 @@ Er erwartet als obligatorisches Argument den Namen der einzulesenden Adressdatei.\Index{Adressdatei} Wird diese Datei nicht gefunden, wird ein Fehler ausgegeben. -Für jeden Eintrag dieser Adressdatei wird eine Reihe von Makros generiert, -die es ermöglichen, auf die Daten der Adressdatei zuzugreifen. Es soll an -dieser Stelle nicht verschwiegen werden, dass dies bei großen Adressdateien +Für jeden Eintrag dieser Adressdatei wird eine Reihe von Makros generiert, +die es ermöglichen, auf die Daten der Adressdatei zuzugreifen. Es soll an +dieser Stelle nicht verschwiegen werden, dass dies bei großen Adressdateien sehr viel \TeX-Speicher kostet. % \EndIndexGroup @@ -87,47 +87,47 @@ sehr viel \TeX-Speicher kostet. \begin{Declaration}% \Macro{adrentry}\Parameter{Name}\Parameter{Vorname}\Parameter{Adresse} \Parameter{Tel.}\Parameter{F1}\Parameter{F2} - \Parameter{Kommentar}\Parameter{Kürzel} + \Parameter{Kommentar}\Parameter{Kürzel} \Macro{addrentry}\Parameter{Name}\Parameter{Vorname}\Parameter{Adresse} \Parameter{Tel.}\Parameter{F1}\Parameter{F2} \Parameter{F3}\Parameter{F4} - \Parameter{Kürzel} + \Parameter{Kürzel} \Macro{adrchar}\Parameter{Anfangsbuchstaben} \Macro{addrchar}\Parameter{Anfangsbuchstaben} \end{Declaration}% -Der Aufbau der Adresseinträge in der Adressdatei wurde in +Der Aufbau der Adresseinträge in der Adressdatei wurde in \autoref{sec:scrlttr2.addressFile} ab -\DescPageRef{scrlttr2.cmd.adrentry} ausführlich besprochen. Die -ebenfalls dort erwähnte Unterteilung der Adressdatei mit Hilfe von -\Macro{adrchar} oder \Macro{addrchar} hat für \Package{scraddr} keine +\DescPageRef{scrlttr2.cmd.adrentry} ausführlich besprochen. Die +ebenfalls dort erwähnte Unterteilung der Adressdatei mit Hilfe von +\Macro{adrchar} oder \Macro{addrchar} hat für \Package{scraddr} keine Bedeutung und wird vom Paket ignoriert.% \EndIndexGroup \begin{Declaration} - \Macro{Name}\Parameter{Kürzel} - \Macro{FirstName}\Parameter{Kürzel} - \Macro{LastName}\Parameter{Kürzel} - \Macro{Address}\Parameter{Kürzel} - \Macro{Telephone}\Parameter{Kürzel} - \Macro{FreeI}\Parameter{Kürzel} - \Macro{FreeII}\Parameter{Kürzel} - \Macro{Comment}\Parameter{Kürzel} - \Macro{FreeIII}\Parameter{Kürzel} - \Macro{FreeIV}\Parameter{Kürzel} + \Macro{Name}\Parameter{Kürzel} + \Macro{FirstName}\Parameter{Kürzel} + \Macro{LastName}\Parameter{Kürzel} + \Macro{Address}\Parameter{Kürzel} + \Macro{Telephone}\Parameter{Kürzel} + \Macro{FreeI}\Parameter{Kürzel} + \Macro{FreeII}\Parameter{Kürzel} + \Macro{Comment}\Parameter{Kürzel} + \Macro{FreeIII}\Parameter{Kürzel} + \Macro{FreeIV}\Parameter{Kürzel} \end{Declaration}% Die englischen Namen der Zugriffsbefehle folgen den Bezeichnungen der Argumente von \DescRef{\LabelBase.cmd.adrentry} und \DescRef{\LabelBase.cmd.addrentry}. Die Auswahl des Adresseintrags erfolgt -anhand des Kürzels im letzten Argument eines Eintrags, das heißt Argument -Nummer 8 für \DescRef{\LabelBase.cmd.adrentry}-Einträge beziehungsweise -Argument Nummer 9 für \DescRef{\LabelBase.cmd.addrentry}-Einträge. Das +anhand des Kürzels im letzten Argument eines Eintrags, das heißt Argument +Nummer 8 für \DescRef{\LabelBase.cmd.adrentry}-Einträge beziehungsweise +Argument Nummer 9 für \DescRef{\LabelBase.cmd.addrentry}-Einträge. Das bedeutet auch, dass dieses Argument nicht leer sein darf. Um eine sichere -Funktionsweise zu garantieren, empfiehlt es sich, das Kürzel nur als Folge von -Buchstaben aufzubauen, wobei jedoch keine Umlaute benutzt werden dürfen. +Funktionsweise zu garantieren, empfiehlt es sich, das Kürzel nur als Folge von +Buchstaben aufzubauen, wobei jedoch keine Umlaute benutzt werden dürfen. Weiterhin ist zu beachten, dass bei mehrmaligem Auf"|treten -eines Kürzels in den Einträgen die Angaben beim -letzten Auf"|treten die gültigen sind.% +eines Kürzels in den Einträgen die Angaben beim +letzten Auf"|treten die gültigen sind.% % \EndIndexGroup @@ -137,28 +137,28 @@ letzten Auf"|treten die gültigen sind.% \BeginIndexGroup \BeginIndex[indexother]{Cmd}{addrentry}% \BeginIndex[indexother]{Cmd}{adrentry}% -Um das Paket benutzen zu können, ist eine gültige +Um das Paket benutzen zu können, ist eine gültige Adressdatei zu erstellen. -Diese, hier \File{lotr.adr} genannt, könnte beispielsweise -folgendermaßen aussehen: +Diese, hier \File{lotr.adr} genannt, könnte beispielsweise +folgendermaßen aussehen: \begin{lstcode} \addrentry{Beutlin}{Frodo}% - {Der Bühl\\ Beutelsend/Hobbingen im Auenland}{}% + {Der Bühl\\ Beutelsend/Hobbingen im Auenland}{}% {Bilbo Beutlin}{Rauchen von Pfeifenkraut}% - {der Ringträger}{Bilbos Erbe}{FRODO} + {der Ringträger}{Bilbos Erbe}{FRODO} \adrentry{Gamdschie}{Samweis}% {Beutelhaldenweg 3\\Hobbingen im Auenland}{}% {Rosie Kattun}{Knullen}% - {des Ringträgers treuester Gefährte}{SAM} + {des Ringträgers treuester Gefährte}{SAM} \adrentry{Bombadil}{Tom}% {Im Alten Wald}{}% - {Goldbeere}{trällern von Nonsensliedern}% + {Goldbeere}{trällern von Nonsensliedern}% {Meister von Wald, Wasser und Berg}{TOM} \end{lstcode} Das vierte Argument, die Telefonnummer, wurde hier leer gelassen, da es in Auenland keine Telefone gibt. Wie zu sehen ist, sind also auch leere -Angaben möglich. Dagegen ist es nicht erlaubt, ein Argument einfach komplett +Angaben möglich. Dagegen ist es nicht erlaubt, ein Argument einfach komplett weg zu lassen. \BeginIndexGroup @@ -180,9 +180,9 @@ in unser Briefdokument ein: \BeginIndex[indexother]{Cmd}{FreeIII}% \BeginIndex[indexother]{Cmd}{FreeIV}% \BeginIndex[indexother]{Cmd}{Comment}% -Mit Hilfe der vorgestellten Makros können wir dann einen Brief +Mit Hilfe der vorgestellten Makros können wir dann einen Brief an den alten \textsc{Tom Bombadil} schreiben, in dem wir ihn -fragen, ob er sich noch an zwei Gefährten aus alter Zeit +fragen, ob er sich noch an zwei Gefährten aus alter Zeit erinnern kann. \begin{lstcode} \begin{letter}{\Name{TOM}\\\Address{TOM}} @@ -196,47 +196,47 @@ erinnern kann. Begleitet wurde er von \Name{SAM}, \Comment{SAM}. Beider Vorlieben waren sehr weltlich. Der - \FirstName{FRODO} genoss das \FreeII{FRODO}, sein Gefährte - schätzte eine gute Mahlzeit mit \FreeII{SAM}. + \FirstName{FRODO} genoss das \FreeII{FRODO}, sein Gefährte + schätzte eine gute Mahlzeit mit \FreeII{SAM}. - Weißt du noch? Mithrandir hat Dir bestimmt viel von ihnen - erzählt. - \closing{"`O Frühling und Sommerzeit - und danach wieder Frühling!\\ + Weißt du noch? Mithrandir hat Dir bestimmt viel von ihnen + erzählt. + \closing{"`O Frühling und Sommerzeit + und danach wieder Frühling!\\ O Wind auf dem Wasserfall und Lachen des Laubes!"'} \end{letter} \end{lstcode} Die in diesem Beispiel in \DescRef{scrlttr2.cmd.opening} verwendete -Zusammensetzung aus \Macro{FirstName}\Parameter{Kürzel} und -\Macro{LastName}\Parameter{Kürzel} kann auch direkt mittels -\Macro{Name}\Parameter{Kürzel} erhalten werden. +Zusammensetzung aus \Macro{FirstName}\Parameter{Kürzel} und +\Macro{LastName}\Parameter{Kürzel} kann auch direkt mittels +\Macro{Name}\Parameter{Kürzel} erhalten werden. -Das fünf"|te und sechste Argument von \DescRef{\LabelBase.cmd.adrentry} und -\DescRef{\LabelBase.cmd.addrentry} steht zur freien Verfügung. Mit den Makros +Das fünf"|te und sechste Argument von \DescRef{\LabelBase.cmd.adrentry} und +\DescRef{\LabelBase.cmd.addrentry} steht zur freien Verfügung. Mit den Makros \Macro{FreeI} und \Macro{FreeII} kann auf diese Inhalte zugegriffen werden. Im -vorliegenden Fall wurde das fünf"|te Argument für die Person benutzt, die der -Person des Eintrags am nächsten steht. Das sechste Argument enthält im +vorliegenden Fall wurde das fünf"|te Argument für die Person benutzt, die der +Person des Eintrags am nächsten steht. Das sechste Argument enthält im Beispiel die besondere Vorliebe der jeweiligen Person. Das siebente Argument ist ebenfalls ein freier Eintrag. Der Zugriff erfolgt per \Macro{Comment} oder \Macro{FreeIII}. Der Zugriff auf das vierte freie Argument mittels -\Macro{FreeIV} ist nur für \DescRef{\LabelBase.cmd.addrentry}-Einträge gültig. -Bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen ist seine Verwendung nicht -zulässig. Näheres hierzu findet sich im nächsten Abschnitt. +\Macro{FreeIV} ist nur für \DescRef{\LabelBase.cmd.addrentry}-Einträge gültig. +Bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen ist seine Verwendung nicht +zulässig. Näheres hierzu findet sich im nächsten Abschnitt. % \EndIndexGroup \EndIndexGroup -\section{Paketoptionen für Warnungen} +\section{Paketoptionen für Warnungen} -Wie im vorherigen Abschnitt erwähnt, ist die Benutzung des Zugriffsbefehls -\Macro{FreeIV} bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen nicht -zulässig. Wie \Package{scraddr} darauf reagiert, ist allerdings durch +Wie im vorherigen Abschnitt erwähnt, ist die Benutzung des Zugriffsbefehls +\Macro{FreeIV} bei \DescRef{\LabelBase.cmd.adrentry}-Einträgen nicht +zulässig. Wie \Package{scraddr} darauf reagiert, ist allerdings durch Paketoptionen konfigurierbar. Bitte beachten Sie\textnote{Achtung!}, dass dieses Paket die erweiterte Optionenschnittstelle mit \DescRef{maincls.cmd.KOMAoptions} und \DescRef{maincls.cmd.KOMAoption} nicht -unterstützt. Die Optionen sind also entweder als globale Optionen bei +unterstützt. Die Optionen sind also entweder als globale Optionen bei \DescRef{maincls.cmd.documentclass} oder als lokale Optionen bei \DescRef{maincls.cmd.usepackage} anzugeben. @@ -256,14 +256,14 @@ verwendet wird: \item[\Option{adrFreeIVempty}] Der Befehl \Macro{FreeIV} wird einfach ignoriert. \item[\Option{adrFreeIVshow}] - Es wird die Warnung: »(entry FreeIV undefined at \PName{Kürzel})«, + Es wird die Warnung: »(entry FreeIV undefined at \PName{Kürzel})«, in den Text geschrieben. \item[\Option{adrFreeIVwarn}] In der Log-Datei erscheint eine Warnung. \item[\Option{adrFreeIVstop}] Der \LaTeX{}-Lauf wird mit einer Fehlermeldung unterbrochen. \end{labeling} -Wird für das Paket keine Option angegeben, so ist \Option{adrFreeIVshow} +Wird für das Paket keine Option angegeben, so ist \Option{adrFreeIVshow} voreingestellt.% \EndIndexGroup % @@ -273,7 +273,7 @@ voreingestellt.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbase.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbase.tex index f6fb67659e..b311b53be2 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbase.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbase.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrbase.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Paket scrbase für Paket- und Klassenautoren +% Paket scrbase für Paket- und Klassenautoren % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{scrbase.tex} - [$Date: 2018-08-27 08:53:35 +0200 (Mon, 27 Aug 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script package scrbase] \chapter{Grundlegende Funktionen im Paket \Package{scrbase}} @@ -55,95 +55,95 @@ \BeginIndex{Package}{scrbase}% Das Paket \Package{scrbase} stellt einige grundlegende Funktionen bereit, die -sich an Autoren von Paketen und Klassen richten. Dabei kann es nicht nur für +sich an Autoren von Paketen und Klassen richten. Dabei kann es nicht nur für Wrapper-Klassen genutzt werden, die ihrerseits eine \KOMAScript-Klasse laden. Auch Autoren von Klassen, die ansonsten nichts mit \KOMAScript{} zu tun -haben, können von der Funktionalität von \Package{scrbase} profitieren. +haben, können von der Funktionalität von \Package{scrbase} profitieren. \section{Laden des Pakets} \seclabel{loadit} -Während Anwender ein Paket mit Hilfe von \Macro{usepackage} laden, verwenden +Während Anwender ein Paket mit Hilfe von \Macro{usepackage} laden, verwenden Paket- und Klassenautoren \Macro{RequirePackage}\IndexCmd{RequirePackage}. Autoren von Wrapper-Paketen nutzen auch \Macro{RequirePackageWithOptions}\IndexCmd{RequirePackageWithOptions}. Bei -Verwendung von \Macro{RequirePackage} können wie bei +Verwendung von \Macro{RequirePackage} können wie bei \Macro{usepackage}\IndexCmd{usepackage} Optionen angegeben -werden. Demgegenüber erhält das Paket bei \Macro{RequirePackageWithOptions} -alle Optionen, mit denen zuvor das Wrapper-Paket geladen wurde. Näheres zu +werden. Demgegenüber erhält das Paket bei \Macro{RequirePackageWithOptions} +alle Optionen, mit denen zuvor das Wrapper-Paket geladen wurde. Näheres zu diesen Anweisungen ist \cite{latex:clsguide} zu entnehmen. -Das Paket \Package{scrbase} benötigt intern die Funktionalität des Pakets +Das Paket \Package{scrbase} benötigt intern die Funktionalität des Pakets \Package{keyval}\IndexPackage{keyval}\important{\Package{keyval}}. Diese kann -auch vom Paket \Package{xkeyval} zur Verfügung gestellt werden. Bei Bedarf -lädt \Package{scrbase} selbst \Package{keyval}. +auch vom Paket \Package{xkeyval} zur Verfügung gestellt werden. Bei Bedarf +lädt \Package{scrbase} selbst \Package{keyval}. -Das Paket \Package{keyval} erlaubt es, Schlüssel zu definieren und diesen +Das Paket \Package{keyval} erlaubt es, Schlüssel zu definieren und diesen Werten zuzuweisen. Auch die Optionen, die \Package{scrbase} bereitstellt, -verwenden die \Package{keyval}-Syntax: \OptionVName{\PName{Schlüssel}}{Wert}% -\important{\OptionVName{\PName{Schlüssel}}{Wert}}. +verwenden die \Package{keyval}-Syntax: \OptionVName{\PName{Schlüssel}}{Wert}% +\important{\OptionVName{\PName{Schlüssel}}{Wert}}. -\section{Schlüssel als Eigenschaften von Familien und deren Mitgliedern} +\section{Schlüssel als Eigenschaften von Familien und deren Mitgliedern} \seclabel{keyvalue} -Wie bereits in \autoref{sec:scrbase.loadit} erwähnt, setzt \Package{scrbase} -bei Schlüsseln und deren Werten auf das Paket \Package{keyval}. Allerdings -erweitert es dessen Funktionalität. Während bei \Package{keyval} ein Schlüssel -einer Familie gehört, kennt \Package{scrbase} zu jeder Familie auch noch -Familienmitglieder. Ein Schlüssel kann dann sowohl einer Familie als auch -einem oder mehreren Familienmitgliedern gehören. Außerdem kann ein Wert einem -Schlüssel eines Familienmitglieds, einem Schlüssel einer Familie oder einem -Schlüssel aller Familienmitglieder zugewiesen werden. +Wie bereits in \autoref{sec:scrbase.loadit} erwähnt, setzt \Package{scrbase} +bei Schlüsseln und deren Werten auf das Paket \Package{keyval}. Allerdings +erweitert es dessen Funktionalität. Während bei \Package{keyval} ein Schlüssel +einer Familie gehört, kennt \Package{scrbase} zu jeder Familie auch noch +Familienmitglieder. Ein Schlüssel kann dann sowohl einer Familie als auch +einem oder mehreren Familienmitgliedern gehören. Außerdem kann ein Wert einem +Schlüssel eines Familienmitglieds, einem Schlüssel einer Familie oder einem +Schlüssel aller Familienmitglieder zugewiesen werden. \begin{Declaration} \Macro{DefineFamily}\Parameter{Familienname} \Macro{DefineFamilyMember}\OParameter{Mitglied}\Parameter{Familienname} \end{Declaration} -\Package{scrbase} muss aus verschiedenen Gründen die Mitglieder einer Familie -kennen. Daher ist es notwendig, eine neue Familie zunächst mit +\Package{scrbase} muss aus verschiedenen Gründen die Mitglieder einer Familie +kennen. Daher ist es notwendig, eine neue Familie zunächst mit \Macro{DefineFamily} zu definieren und so eine leere Mitgliederliste zu erzeugen. Ist die Familie bereits definiert, so geschieht schlicht nichts. Es -wird also auch nicht eine bereits existierende Mitgliederliste überschrieben. +wird also auch nicht eine bereits existierende Mitgliederliste überschrieben. Ein neues Mitglied wird der Familie dann mit der Anweisung \Macro{DefineFamilyMember} bekannt gegeben. Existiert die Familie nicht, so -führt dies zu einer Fehlermeldung. Existiert das Mitglied bereits, so +führt dies zu einer Fehlermeldung. Existiert das Mitglied bereits, so geschieht nichts. Wird kein Mitglied angegeben, so bleibt das Mitglied nicht etwa leer, sondern es wird -»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Während +»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Während des Ladens einer Klasse oder eines Pakets sind \Macro{@currname} und \Macro{@currext} zusammen der Dateiname. -Theoretisch wäre es möglich, mit einem leeren optionalen Argument -\PName{Mitglied} auch ein Mitglied ohne Name zu definieren. Dies würde jedoch +Theoretisch wäre es möglich, mit einem leeren optionalen Argument +\PName{Mitglied} auch ein Mitglied ohne Name zu definieren. Dies würde jedoch der Familie selbst entsprechen. Es wird empfohlen, als \PName{Familienname} nur Buchstaben und Ziffern zu verwenden und das \PName{Mitglied} immer mit einem -anderen Zeichen, vorzugsweise einem Punkt, zu beginnen. Anderenfalls könnte +anderen Zeichen, vorzugsweise einem Punkt, zu beginnen. Anderenfalls könnte es passieren, dass sich Mitglieder einer Familie mit Mitgliedern anderer -Familien überdecken. +Familien überdecken. -\Package{scrbase} definiert selbst bereits die Familie »\PValue{KOMA}« und -fügt ihr das Mitglied »\PValue{.scrbase.sty}« hinzu. Grundsätzlich sind die -Familien »\PValue{KOMA}« und »\PValue{KOMAarg}« \KOMAScript{} vorbehalten. Es -wird empfohlen, für eigene Pakete den Namen des Gesamtpakets als Familie und +\Package{scrbase} definiert selbst bereits die Familie »\PValue{KOMA}« und +fügt ihr das Mitglied »\PValue{.scrbase.sty}« hinzu. Grundsätzlich sind die +Familien »\PValue{KOMA}« und »\PValue{KOMAarg}« \KOMAScript{} vorbehalten. Es +wird empfohlen, für eigene Pakete den Namen des Gesamtpakets als Familie und den Namen einzelner Pakete im Gesamtpaket als Mitglied zu verwenden. % \begin{Example} - Angenommen, Sie schreiben ein neues Gesamtpaket »Fleischermeister«. Darin + Angenommen, Sie schreiben ein neues Gesamtpaket »Fleischermeister«. Darin befinden sich die Pakete \File{Salami.sty}, \File{Mettwurst.sty} und - \File{Krakauer.sty}. Daher entscheiden Sie sich für den Familienname - »\PValue{Fleischermeister}« und fügen in jedem der Pakete die Zeilen + \File{Krakauer.sty}. Daher entscheiden Sie sich für den Familienname + »\PValue{Fleischermeister}« und fügen in jedem der Pakete die Zeilen % Umbruchoptimierung: listings \begin{lstcode}[aboveskip=0pt plus \dp\strutbox] \DefineFamily{Fleischermeister} \DefineFamilyMember{Fleischermeister} \end{lstcode} ein. Dadurch wird beim Laden der drei genannten Pakete der Familie - »\PValue{Fleischermeister}« je nach Paket eines der drei Mitglieder - »\PValue{.Salami.sty}«, »\PValue{.Mettwurst.sty}« und - »\PValue{.Krakauer.sty}« zugefügt. Am Ende sind dann alle drei Mitglieder + »\PValue{Fleischermeister}« je nach Paket eines der drei Mitglieder + »\PValue{.Salami.sty}«, »\PValue{.Mettwurst.sty}« und + »\PValue{.Krakauer.sty}« zugefügt. Am Ende sind dann alle drei Mitglieder definiert. \end{Example} % @@ -152,73 +152,73 @@ den Namen einzelner Pakete im Gesamtpaket als Mitglied zu verwenden. \begin{Declaration} \Macro{DefineFamilyKey}\OParameter{Mitglied}\Parameter{Familie}% - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Aktion} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\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 +Mit dieser Anweisung wird ein \PName{Schlüssel} definiert. Ist ein +\PName{Mitglied} angegeben, so ist der \PName{Schlüssel} eine Eigenschaft dieses Mitglieds der angegebenen \PName{Familie}. Ist\textnote{Hinweis} \OParameter{Mitglied} nicht angegeben, so wird wieder das Mitglied -»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Ist das -\PName{Mitglied} hingegen leer, so wird ein Familienschlüssel anstelle eines -Mitgliederschlüssels definiert. +»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Ist das +\PName{Mitglied} hingegen leer, so wird ein Familienschlüssel anstelle eines +Mitgliederschlüssels definiert. -Wird später dem \PName{Schlüssel} ein Wert zugewiesen, so wird \PName{Aktion} -ausgeführt, wobei der Wert als Parameter übergeben wird. Innerhalb von -\PName{Aktion} steht also »\lstinline{#1}« für den übergebenen Wert. Wurde -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. +Wird später dem \PName{Schlüssel} ein Wert zugewiesen, so wird \PName{Aktion} +ausgeführt, wobei der Wert als Parameter übergeben wird. Innerhalb von +\PName{Aktion} steht also »\lstinline{#1}« für den übergebenen Wert. Wurde +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 -\begin{lstcode}[escapeinside=»«] - \DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«} - [»\PName{Säumniswert}«]{»\PName{Aktion}«} + Letztlich führt +\begin{lstcode}[escapeinside=><] + \DefineFamilyKey[>\PName{Mitglied}<]{>\PName{Familie}<}{>\PName{Schlüssel}<} + [>\PName{Säumniswert}<]{>\PName{Aktion}<} \end{lstcode} zu dem Aufruf -\begin{lstcode}[moretexcs={define@key},escapeinside=»«] - \define@key{»\PName{Familie\,Mitglied}«}{»\PName{Schlüssel}«} - [»\PName{Säumniswert}«]{»\PName{erweiterte Aktion}«} +\begin{lstcode}[moretexcs={define@key},escapeinside=><] + \define@key{>\PName{Familie\,Mitglied}<}{>\PName{Schlüssel}<} + [>\PName{Säumniswert}<]{>\PName{erweiterte Aktion}<} \end{lstcode} wobei \Macro{define@key} im \Package{keyval}-Paket\IndexPackage{keyval} 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. + 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 +Erfolg\ChangedAt{v3.12}{\Package{scrbase}} oder Misserfolg der Ausführung der +\PName{Aktion} werden über \Macro{FamilyKeyState} %\important{\Macro{FamilyKeyState}} % einige davon sind % schlicht zu breit! -an \Package{scrbase} zurückgemeldet, damit dieses je nach Bedarf und -Verwendung des Schlüssels weitere Maßnahmen ergreifen kann. Dies kann +an \Package{scrbase} zurückgemeldet, damit dieses je nach Bedarf und +Verwendung des Schlüssels weitere Maßnahmen ergreifen kann. Dies kann beispielsweise eine Fehlermeldung aber auch nur die Signalisierung einer unbekannten Option sein. Der Zustand \Macro{FamilyKeyState} ist in der Voreinstellung identisch mit dem Zustand \Macro{FamilyKeyStateUnknown}. Das bedeutet, dass es nicht sicher ist, -ob der Schlüssel korrekt verarbeitet werden konnte. Findet \Package{scrbase} -nach Ausführung der \PName{Aktion} noch immer diesen Zustand vor, so wird ein +ob der Schlüssel 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} %\important{\Macro{FamilyKeyStateProcessed}} -signalisiert, dass der Schlüssel und die Wertzuweisung an den Schlüssel -vollständig abgeschlossen wurde und alles in Ordnung ist. Auf den Zustand kann +signalisiert, dass der Schlüssel und die Wertzuweisung an den Schlüssel +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} %\important{\Macro{FamilyKeyStateUnknownValue}} -signalisiert, dass der Schlüssel zwar verarbeitet wurde, ihm jedoch ein Wert +signalisiert, dass der Schlüssel zwar verarbeitet wurde, ihm jedoch ein Wert zugewiesen werden sollte, der nicht erlaubt ist. Diesen Zustand meldet beispielsweise \hyperref[cha:typearea]{\Package{typearea}}, wenn versucht wird, an Option \DescRef{typearea.option.twoside} den Wert \PValue{unbekannt} @@ -227,22 +227,22 @@ zuzuweisen. Die Umschaltung auf den Zustand erfolgt einfach durch Aufruf von Der Zustand \Macro{FamilyKeyStateNeedValue} %\important{\Macro{FamilyKeyStateNeedValue}} -signalisiert, dass der Schlüssel nicht verarbeitet werden konnte, weil er +signalisiert, dass der Schlüssel nicht verarbeitet werden konnte, weil er zwingend einen Wert erwartet, er aber ohne Wertzuweisung aufgerufen -wurde. Dieser Zustand wird automatisch gesetzt, wenn ein Schlüssel, der 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. +wurde. Dieser Zustand wird automatisch gesetzt, wenn ein Schlüssel, der 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. -Des Weiteren können zusätzliche Fehlerzustände definiert werden, indem man +Des Weiteren 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. +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 + Schlüssel \PValue{Aufschnitt} erhalten. Wird dieser aufgerufen, so soll in jedem der Pakete entsprechend dem Aufrufwert ein Schalter gesetzt - werden. Für das Paket \Package{Salami} könnte das beispielsweise so + werden. Für das Paket \Package{Salami} könnte das beispielsweise so aussehen: \begin{lstcode} \newif\if@Salami@Aufschnitt @@ -256,14 +256,14 @@ sollten jedoch die vier vordefinierten Zustände verwendet werden. \end{lstcode} Als Wert ist daher beim Aufruf \PValue{true} oder \PValue{false} erlaubt. Ein Test auf unerlaubte Werte existiert in diesem Beispiel - nicht. Stattdessen wird immer zurückgemeldet, dass der Schlüssel vollständig - und korrekt verarbeitet wurde. Wird der Schlüssel später verwendet, so muss + nicht. Stattdessen wird immer zurückgemeldet, dass der Schlüssel vollständig + und korrekt verarbeitet wurde. 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 kommt der Säumniswert + Wertzuweisung verwendet werden. In letzterem Fall kommt der Säumniswert \PName{true} zum Einsatz. - Für die anderen beiden Pakete kann das fast identisch definiert - werden. Lediglich die Zeichenfolge »\texttt{Salami}« ist jeweils zu + Für die anderen beiden Pakete kann das fast identisch definiert + werden. Lediglich die Zeichenfolge »\texttt{Salami}« ist jeweils zu ersetzen. \end{Example} % @@ -272,20 +272,20 @@ sollten jedoch die vier vordefinierten Zustände verwendet werden. \begin{Declaration} \Macro{RelaxFamilyKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} + \Parameter{Schlüssel} \end{Declaration} -Wurde\ChangedAt{v3.15}{\Package{scrbase}} \PName{Schlüssel} zuvor als +Wurde\ChangedAt{v3.15}{\Package{scrbase}} \PName{Schlüssel} zuvor als \PName{Mitglied} der \PName{Familie} definiert, so wird diese Definition -quasi aufgehoben. Der \PName{Schlüssel} ist dann für dieses \PName{Mitglied} -der \PName{Familie} nicht mehr definiert. Die Verwendung für einen -\PName{Schlüssel}, der für dieses \PName{Mitglied} der \PName{Familie} gar -nicht definiert ist, ist ebenfalls zulässig. +quasi aufgehoben. Der \PName{Schlüssel} ist dann für dieses \PName{Mitglied} +der \PName{Familie} nicht mehr definiert. Die Verwendung für einen +\PName{Schlüssel}, der für dieses \PName{Mitglied} der \PName{Familie} gar +nicht definiert ist, ist ebenfalls zulässig. Ist kein \PName{Mitglied} angegeben, so wird genau wie bei Anweisung \DescRef{\LabelBase.cmd.DefineFamilyKey} wieder das Mitglied -»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Allerdings -wird \Macro{RelaxFamilyKey} selten während des Ladens eines Pakets, -sondern häufiger zur Laufzeit verwendet. Daher ist \PName{Mitglied} in der +»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« angenommen. Allerdings +wird \Macro{RelaxFamilyKey} selten während des Ladens eines Pakets, +sondern häufiger zur Laufzeit verwendet. Daher ist \PName{Mitglied} in der Regel auch explizit anzugeben.% \EndIndexGroup @@ -293,52 +293,52 @@ Regel auch explizit anzugeben.% \begin{Declaration} \Macro{FamilyProcessOptions}\OParameter{Mitglied}\Parameter{Familie} \end{Declaration} -Grundsätzlich ist die Erweiterung der Schlüssel von Familien auf Familien und -Familienmitglieder dazu gedacht, dass Schlüssel beziehungsweise die -Wertzuweisung an Schlüssel als ganz normale Klassen- oder Paketoptionen -verwendet werden können. Diese Anweisung stellt daher eine Erweiterung von +Grundsätzlich ist die Erweiterung der Schlüssel von Familien auf Familien und +Familienmitglieder dazu gedacht, dass Schlüssel beziehungsweise die +Wertzuweisung an Schlüssel als ganz normale Klassen- oder Paketoptionen +verwendet werden können. Diese Anweisung stellt daher eine Erweiterung von \Macro{ProcessOptions*}\IndexCmd{ProcessOptions*}% \important{\Macro{ProcessOption*}} aus dem \LaTeX-Kern dar (siehe \cite{latex:clsguide}). Dabei verarbeitet die Anweisung nicht nur Optionen, die mit \Macro{DeclareOption}\IndexCmd{DeclareOption}% \important{\Macro{DeclareOption}} definiert wurden. Es werden auch alle -Schlüssel eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale +Schlüssel eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale Argument \PName{Mitglied} nicht angegeben, so wird wieder das Mitglied -»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« verwendet. +»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« verwendet. -Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern +Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern der Familie selbst zugeordnet sind, bei der also das Mitglied leer geblieben -ist. Diese werden ebenfalls gesetzt und zwar noch bevor der Schlüssel des +ist. Diese werden ebenfalls gesetzt und zwar noch bevor der Schlüssel des Mitglieds gesetzt wird. \begin{Example} - Wenn in den Paketen aus den zurückliegenden Beispielen nach der Definition - der Schlüssel die Zeile + Wenn in den Paketen aus den zurückliegenden Beispielen nach der Definition + der Schlüssel die Zeile \begin{lstcode} \FamilyProcessOptions{Fleischermeister} \end{lstcode} - ergänzt wird, so kann der Anwender bereits beim Laden der Pakete mit + ergänzt wird, so kann der Anwender bereits beim Laden der Pakete mit \Macro{usepackage} die Eigenschaft \Option{Aufschnitt} als Option angeben. Wird die Option global, also bei \Macro{documentclass}, angegeben, so wird die Eigenschaft automatisch bei allen drei Paketen gesetzt, wenn alle drei Pakete einzeln geladen werden. \end{Example} Es\textnote{Achtung!} wird darauf hingewiesen, dass bei Paketen globale -Optionen vor den lokal dem Paket zugewiesenen Optionen ausgeführt -werden. Während bei der Abarbeitung der globalen Optionen unbekannte Werte für -Optionen dazu führen, dass darüber lediglich in der \File{log}-Datei -informiert und die Option ansonsten ignoriert wird, führt dies bei lokalen +Optionen vor den lokal dem Paket zugewiesenen Optionen ausgeführt +werden. Während bei der Abarbeitung der globalen Optionen unbekannte Werte für +Optionen dazu führen, dass darüber lediglich in der \File{log}-Datei +informiert und die Option ansonsten ignoriert wird, führt dies bei lokalen Optionen zu einer Fehlermeldung. Man kann \Macro{FamilyProcessOptions} wahlweise als Erweiterung von \Macro{ProcessOption*} oder als Erweiterung des -\PName{Schlüssel=Wert}-Mechanismus von \Package{keyval} verstehen. Letztlich +\PName{Schlüssel=Wert}-Mechanismus von \Package{keyval} verstehen. Letztlich werden mit Hilfe von \Macro{FamilyProcessOptions} aus -\PName{Schlüssel=Wert}-Paaren Optionen. +\PName{Schlüssel=Wert}-Paaren Optionen. Wie\textnote{Achtung!} auch \Macro{ProcessOptions} darf -\Macro{FamilyProcessOptions} nicht während der Ausführung von Optionen +\Macro{FamilyProcessOptions} nicht während der Ausführung von Optionen verwendet werden. Es ist also insbesondere auch nicht erlaubt, innerhalb der -Ausführung von Optionen Pakete zu laden.%, die selbst +Ausführung von Optionen Pakete zu laden.%, die selbst %\Macro{FamilyProcessOptions} verwenden.% % \EndIndexGroup @@ -349,28 +349,28 @@ Ausführung von Optionen Pakete zu laden.%, die selbst \Parameter{Code}% \end{Declaration} Insbesondere\ChangedAt{v3.18}{\Package{scrbase}} Autoren von Wrapper-Klassen -wünschen manchmal, in ein Paket oder eine Klasse noch vor der Verarbeitung der -Optionen eines zukünftig geladenen Pakets oder einer zukünftig geladenen +wünschen manchmal, in ein Paket oder eine Klasse noch vor der Verarbeitung der +Optionen eines zukünftig geladenen Pakets oder einer zukünftig geladenen Klasse mit \DescRef{\LabelBase.cmd.FamilyProcessOptions} eingreifen zu -können. Dies ist mit \Macro{BeforeFamilyProcessOptions} möglich. Das Paket -\Package{scrbase} bietet dafür einen sogenannten Haken\Index{Haken} +können. Dies ist mit \Macro{BeforeFamilyProcessOptions} möglich. Das Paket +\Package{scrbase} bietet dafür einen sogenannten Haken\Index{Haken} (engl. \emph{hook}). Diesem kann man mit \Macro{BeforeFamilyProcessOptions} -neuen \PName{Code} hinzufügen. Die Parameter \PName{Mitglied} und +neuen \PName{Code} hinzufügen. Die Parameter \PName{Mitglied} und \PName{Familie} entsprechen dabei denen von \Macro{FammilyProcessOptions}. Allerdings kann man auch den Haken von -Familien-Mitgliedern \PName{Code} hinzufügen, wenn bisher die \PName{Familie} +Familien-Mitgliedern \PName{Code} hinzufügen, wenn bisher die \PName{Familie} oder das \PName{Mitglied} noch gar nicht definiert ist. -Der Haken eines Familien-Mitglieds wird übrigens nach dessen Ausführung -automatisch gelöscht. Verwendet man hingegen ein leeres \PName{Mitglied}, so -wird dieser Haken\Index{Haken} für alle Mitglieder der \PName{Familie} -ausgeführt und bleibt auch über die Ausführung hinaus erhalten. +Der Haken eines Familien-Mitglieds wird übrigens nach dessen Ausführung +automatisch gelöscht. Verwendet man hingegen ein leeres \PName{Mitglied}, so +wird dieser Haken\Index{Haken} für alle Mitglieder der \PName{Familie} +ausgeführt und bleibt auch über die Ausführung hinaus erhalten. \begin{Example} Sie schreiben ein Paket \Package{Rauchwurst}, das selbst \Package{Mettwurst} - lädt. Allerdings wollen Sie nicht, dass für dieses Paket die Option + lädt. Allerdings wollen Sie nicht, dass für dieses Paket die Option \Option{Aufschnitt} gesetzt werden kann. Daher deaktivieren sie die Option - vor dem Laden des Pakets über \Macro{BeforeFamilyProcessOptions}. + vor dem Laden des Pakets über \Macro{BeforeFamilyProcessOptions}. \begin{lstcode} \RequirePackage{scrbase} \BeforeFamilyProcessOptions[.Mettwurst.sty]% @@ -386,8 +386,8 @@ ausgeführt und bleibt auch über die Ausführung hinaus erhalten. globale Option angegeben, so ignoriert Paket \Package{Mettwurst} diese. Voreinstellungen innerhalb des Pakets \Package{Mettwurst}, die beispielsweise mit \DescRef{\LabelBase.cmd.FamilyExecuteOptions} noch vor - \DescRef{\LabelBase.cmd.FamilyProcessOptions} erfolgen könnten, wären - allerdings davon unabhängig. Aber natürlich kann man eigene + \DescRef{\LabelBase.cmd.FamilyProcessOptions} erfolgen könnten, wären + allerdings davon unabhängig. Aber natürlich kann man eigene Voreinstellungen von \Package{Rauchwurst} aus ebenfalls per \Macro{BeforeFamilyProcessOptions} in \Package{Mettwurst} einschleusen.% \end{Example} @@ -401,37 +401,38 @@ ausgeführt und bleibt auch über die Ausführung hinaus erhalten. Diese Anweisung stellt eine Erweiterung von \Macro{ExecuteOptions} aus dem \LaTeX-Kern dar (siehe \cite{latex:clsguide}). Dabei verarbeitet die Anweisung nicht nur Optionen, -die mit \Macro{DeclareOption} definiert wurden. Es werden auch alle Schlüssel +die mit \Macro{DeclareOption} definiert wurden. Es werden auch alle Schlüssel eines angegebenen Familienmitglieds abgearbeitet. Wird das optionale Argument \PName{Mitglied} nicht angegeben, so wird wieder das Mitglied -»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« verwendet. +»\texttt{.}\Macro{@currname}\texttt{.}\Macro{@currext}« verwendet. -Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern +Eine Besonderheit sind Schlüssel, die nicht einem Familienmitglied, sondern der Familie selbst zugeordnet sind, bei der also das Mitglied leer geblieben -ist. Diese werden ebenfalls gesetzt, und zwar noch bevor der Schlüssel des +ist. Diese werden ebenfalls gesetzt, und zwar noch bevor der Schlüssel des Mitglieds gesetzt wird. \begin{Example} - Angenommen, die Option \Option{Aufschnitt} soll in den zurückliegenden - Beispielen bereits als Voreinstellung gesetzt werden, so müssen die Pakete + Angenommen, die Option \Option{Aufschnitt} soll in den zurückliegenden + Beispielen bereits als Voreinstellung gesetzt werden, so müssen die Pakete nur um den Aufruf \begin{lstcode} \FamilyExecuteOptions{Fleischermeister} {Aufschnitt} \end{lstcode} - ergänzt werden. + ergänzt werden. \end{Example} Wird\ChangedAt{v3.20}{\Package{scrbase}} \Macro{FamilyExecuteOptions} mit einer nicht definierten Option in der \PName{Optionenliste} aufgerufen, so wird normalerweise ein Fehler ausgegeben. Eine Ausnahme von dieser Regel ist, -wenn für das \PName{Mitglied} eine Option namens +wenn für das \PName{Mitglied} eine Option namens \Option{@else@}\important{\Option{@else@}} definiert wurde. In diesem Fall wird statt der unbekannten Option eben diese Option \Option{@else@} -verwendet. Innerhalb von \KOMAScript{} wird das beispielsweise genutzt, um -die Stil-Option bei der Definition von Gliederungsbefehlen vor allen anderen -auszuwerten. +verwendet. Der an \Option{@else@} übergebene Wert ist dabei die nicht +definierte Option mit dem im Aufruf angegebenen Wert. Innerhalb von +\KOMAScript{} wird das beispielsweise genutzt, um die Stil-Option bei der +Definition von Gliederungsbefehlen vor allen anderen auszuwerten. -Diese Anweisung darf auch innerhalb der Ausführung von Optionen verwendet +Diese Anweisung darf auch innerhalb der Ausführung von Optionen verwendet werden.% % \EndIndexGroup @@ -441,30 +442,30 @@ werden.% \Macro{FamilyOptions}\Parameter{Familie}\Parameter{Optionenliste}% \end{Declaration} Im Gegensatz zu normalen Optionen, die mit \Macro{DeclareOption} definiert -wurden, können die \PName{Schlüssel} auch noch nach dem Laden der Klasse oder +wurden, können die \PName{Schlüssel} auch noch nach dem Laden der Klasse oder des Pakets gesetzt werden. Dazu verwendet der Anwender \Macro{FamilyOptions}. Die \PName{Optionenliste} hat dabei die Form: %\begin{flushleft}\begin{tabular}{l} - \PName{Schlüssel}\texttt{=}\PName{Wert}\texttt{,}\linebreak[1]% - \PName{Schlüssel}\texttt{=}\PName{Wert} \dots{} + \PName{Schlüssel}\texttt{=}\PName{Wert}\texttt{,}\linebreak[1]% + \PName{Schlüssel}\texttt{=}\PName{Wert} \dots{} %\end{tabular}\vskip\dp\strutbox\end{flushleft} -wobei für \PName{Schlüssel}, für die ein Säumniswert definiert ist, die -Wertzuweisung natürlich auch entfallen kann. - -Durch die Anweisung werden die \PName{Schlüssel} aller Mitglieder der -angegebenen \PName{Familie} gesetzt. Existiert ein \PName{Schlüssel} auch als -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 +wobei für \PName{Schlüssel}, für die ein Säumniswert definiert ist, die +Wertzuweisung natürlich auch entfallen kann. + +Durch die Anweisung werden die \PName{Schlüssel} aller Mitglieder der +angegebenen \PName{Familie} gesetzt. Existiert ein \PName{Schlüssel} auch als +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. Dies geschieht ebenfalls, wenn -zwar für einige Mitglieder ein Schlüssel existiert, jedoch jedes dieser -Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler -zurückmeldet. +zwar für einige Mitglieder ein Schlüssel existiert, jedoch jedes dieser +Mitglieder über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler +zurückmeldet. \begin{Example} - Sie ergänzen das Fleischermeister-Projekt um ein weiteres Paket + Sie ergänzen das Fleischermeister-Projekt um ein weiteres Paket \Package{Wurstsalat}. Wird dieses Paket verwendet, so sollen alle - Wurstpakete zunächst einmal Aufschnitt produzieren: + Wurstpakete zunächst einmal Aufschnitt produzieren: \begin{lstcode} \ProvidesPackage{Wurstsalat}% [2008/05/06 nonsense package] @@ -474,17 +475,17 @@ zurückmeldet. \FamilyProcessOptions{Fleischermeister}\relax \FamilyOptions{Fleischermeister}{Aufschnitt} \end{lstcode} - Sollte noch kein Wurstpaket geladen sein, so würde nun eine Fehlermeldung - wegen der nicht definierten Option »\Option{Aufschnitt}« ausgegeben. Das - kann vermieden werden, indem vor der letzten Zeile für das Paket selbst - ebenfalls ein entsprechender Schlüssel definiert wird: + Sollte noch kein Wurstpaket geladen sein, so würde nun eine Fehlermeldung + wegen der nicht definierten Option »\Option{Aufschnitt}« ausgegeben. Das + kann vermieden werden, indem vor der letzten Zeile für das Paket selbst + ebenfalls ein entsprechender Schlüssel definiert wird: \begin{lstcode} \DefineFamilyKey{Fleischermeister}% {Aufschnitt}[true]{}% \end{lstcode} Allerdings produzieren so Wurstpakete, die nach Paket \Package{Wurstsalat} geladen werden, keinen Aufschnitt. Dies kann man - ebenfalls ändern: + ebenfalls ändern: \begin{lstcode} \AtBeginDocument{% \DefineFamilyKey[.Wurstsalat.sty]% @@ -499,35 +500,43 @@ zurückmeldet. }% }% \end{lstcode} - Somit wird zunächst während \Macro{begin}\PParameter{document} die Option so - definiert, dass sie für das Paket \Package{Wurstsalat} keine Funktion mehr - ausübt. Da nach dem Laden von \Package{Wurstsalat}, innerhalb von + Somit wird zunächst während \Macro{begin}\PParameter{document} die Option so + definiert, dass sie für das Paket \Package{Wurstsalat} keine Funktion mehr + ausübt. Da nach dem Laden von \Package{Wurstsalat}, innerhalb von \Macro{begin}\PParameter{document} die beiden Anweisungen \Macro{@currname} und \Macro{@currext} nicht mehr den Dateinamen des Pakets enthalten, muss zwingend das optionale Argument von \DescRef{\LabelBase.cmd.DefineFamilyKey} verwendet werden. Bis zu dieser Umdefinierung der Option wird jedoch eine Definition - verwendet, die während \Macro{begin}\PParameter{document} die Option erneut - für die Familie und all ihre Mitglieder ausführt und damit auch für andere - Wurstpakete setzt. Die Verzögerung der Ausführung von \Macro{FamilyOptions} - ist hier entscheidend. Zum einen werden nur so später geladene Wurstpakete + verwendet, die während \Macro{begin}\PParameter{document} die Option erneut + für die Familie und all ihre Mitglieder ausführt und damit auch für andere + Wurstpakete setzt. Die Verzögerung der Ausführung von \Macro{FamilyOptions} + ist hier entscheidend. Zum einen werden nur so später geladene Wurstpakete erfasst. Zum anderen wird dadurch sichergestellt, dass die eigene Option \Option{Aufschnitt} bereits umdefiniert wurde. Dadurch wird eine endlose Rekursion vermieden.% \end{Example}% -% + +Wie\ChangedAt{v3.27}{\Package{scrbase}} schon bei +\DescRef{\LabelBase.cmd.FamilyExecuteOptions} gibt es auch bei +\Macro{FamilyOptions} eine Sonderbehandlung für eine Option Namens +\Option{@else@}\important{\Option{@else@}}. Ist eine solche für ein Mitglied +definiert, so wird sie immer dann ausgeführt, wenn das Mitglied eine +angegebene Option nicht kennt. Ist für die Familie selbst eine Option +\Option{@else@} definiert, so wird sie nur aufgerufen, wenn weder die Familie +noch eines ihrer Mitglieder eine angegebene Option vollständig verarbeiten +konnte und mit \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} quitiert hat.% \EndIndexGroup -\vskip-\ht\strutbox% Umbruchkorrektur wegen Beispiel am Ende \begin{Declaration} \Macro{FamilyOption}\Parameter{Familie}% \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 -wäre es bei Verwendung von \DescRef{\LabelBase.cmd.FamilyOptions} notwendig, +Neben Optionen, die sich gegenseitig ausschließende Werte besitzen, kann es +auch Optionen geben, die gleichzeitig mehrere Werte annehmen können. Für diese +wäre es bei Verwendung von \DescRef{\LabelBase.cmd.FamilyOptions} notwendig, der Option mehrfach einen Wert zuzuweisen und dabei die Option selbst mehrfach anzugeben. Stattdessen kann man einfach mit \Macro{FamilyOption} einer einzigen \PName{Option} eine ganze \PName{Werteliste} zuweisen. Die @@ -536,12 +545,12 @@ einzigen \PName{Option} eine ganze \PName{Werteliste} zuweisen. Die \PName{Wert}\texttt{,}\PName{Wert} \dots{} %\end{tabular}\end{flushleft} 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 weitere Funktionsweise ist der vorhergehenden Erklärung zu +Kommas in einem Wert möglich ist, wenn man den Wert in geschweifte Klammern +setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu \DescRef{\LabelBase.cmd.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 + Das Paket \Package{Wurstsalat} soll eine Option bekommen, über die man + weitere Zutaten bestimmen kann. Für jede Zutat wird dabei wieder ein Schalter gesetzt. \begin{lstcode} \newif\if@salatmit@Zwiebeln @@ -551,11 +560,11 @@ setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu \csname @salatmit@#1true\endcsname } \end{lstcode} - Es wurden hier die drei Zutaten »Zwiebeln«, »Gurken« und »Peperoni« - definiert. Eine Fehlerbehandlung für den Fall, dass der Anwender unbekannte + Es wurden hier die drei Zutaten »Zwiebeln«, »Gurken« und »Peperoni« + definiert. Eine Fehlerbehandlung für den Fall, dass der Anwender unbekannte Zutaten fordert, existiert nicht. - Für einen Salat mit Zwiebeln und Gurken kann der Anwender + Für einen Salat mit Zwiebeln und Gurken kann der Anwender \begin{lstcode} \FamilyOptions{Fleischermeister}{% SalatZusatz=Zwiebeln,SalatZusatz=Gurken} @@ -567,7 +576,10 @@ setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu \end{lstcode} verwenden. \end{Example} -% + +Die\ChangedAt{v3.27}{\Package{scrbase}} Verarbeitung einer Option +\Option{@else@} findet in derselben Weise statt wie bei +\DescRef{\LabelBase.cmd.FamilyOptions}.% \EndIndexGroup @@ -576,7 +588,7 @@ setzt. Die weitere Funktionsweise ist der vorhergehenden Erklärung zu \Macro{AtEndOfFamilyOptions*}\Parameter{Aktion}% \end{Declaration} Manchmal\ChangedAt{v3.12}{\Package{scrbase}} ist es vorteilhafter, wenn nicht -jede Wertzuweisung an eine Option unmittelbar eine \PName{Aktion} auslöst, +jede Wertzuweisung an eine Option unmittelbar eine \PName{Aktion} auslöst, sondern dies erst geschieht, wenn alle Wertzuweisungen innerhalb eines Aufrufs von \DescRef{\LabelBase.cmd.FamilyProcessOptions}\IndexCmd{FamilyProcessOptions} @@ -585,67 +597,67 @@ oder beziehungsweise \DescRef{\LabelBase.cmd.FamilyOptions}\IndexCmd{FamilyOptions} oder \DescRef{\LabelBase.cmd.FamilyOption}\IndexCmd{FamilyOptions} abgeschlossen sind. Genau das ist mit Hilfe von \Macro{AtEndOfFamilyOptions} -und dessen Sternvariante\ChangedAt{v3.23}{\Package{scrbase}} 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 +und dessen Sternvariante\ChangedAt{v3.23}{\Package{scrbase}} 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. Die beiden Variante unterscheiden sich im Falle von verschachtelt definierten -Optionen, wenn also die Ausführung einer Option den Aufruf einer oder mehrerer +Optionen, wenn also die Ausführung einer Option den Aufruf einer oder mehrerer anderen Option bedingt. In diesem Fall werden alle per -\Macro{AtEndOfFamilyOptions} festgelegten Aktionen ausgeführt, sobald der +\Macro{AtEndOfFamilyOptions} festgelegten Aktionen ausgeführt, sobald der innerste Optionenaufruf endet. Dagegen werden die per \Macro{AtEndOfFamilyOptions*} festgelegten Aktionen erst mit dem Ende des -äußersten Optionenaufrufs ausgeführt. Die Reihenfolge\textnote{Achtung!} der -Aktionen ist dabei jedoch ausdrücklich unbestimmt! Weder ist sichergestellt, -dass zuerst angeforderte Aktionen auch zuerst ausgeführt werden, noch die +äußersten Optionenaufrufs ausgeführt. Die Reihenfolge\textnote{Achtung!} der +Aktionen ist dabei jedoch ausdrücklich unbestimmt! Weder ist sichergestellt, +dass zuerst angeforderte Aktionen auch zuerst ausgeführt werden, noch die umgekehrte Reihenfolge.% \EndIndexGroup \begin{Declaration} \Macro{FamilyBoolKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Schaltername} + \Parameter{Schlüssel}\Parameter{Schaltername} \Macro{FamilySetBool}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Schaltername} + \Parameter{Schlüssel}\Parameter{Schaltername} \Parameter{Wert} \end{Declaration} In den vorherigen Beispielen wurden schon mehrfach Schalter gesetzt. Im Beispiel der Option \Option{Aufschnitt} war es dabei notwendig, dass der Anwender als Wert \PValue{true} oder \PValue{false} angibt. Es existierte keine Fehlerbehandlung, falls der Anwender einen falschen Wert verwendet. Da -solche booleschen Schalter ein häufiger Anwendungsfall sind, kann man sie bei +solche booleschen Schalter ein häufiger Anwendungsfall sind, kann man sie bei \Package{scrbase} einfach mit \Macro{FamilyBoolKey} definieren. Dabei sind die -Argumente \PName{Mitglied}, \PName{Familie} und \PName{Schlüssel} die gleichen +Argumente \PName{Mitglied}, \PName{Familie} und \PName{Schlüssel} die gleichen wie bei \DescRef{\LabelBase.cmd.DefineFamilyKey} (siehe \DescPageRef{scrbase.cmd.DefineFamilyKey}). Das Argument \PName{Schaltername} -ist der Name eines Schalter ohne den Präfix \Macro{if}. Existiert dieser +ist der Name eines Schalter ohne den Präfix \Macro{if}. Existiert dieser Schalter noch nicht, so wird er automatisch definiert und mit \PName{false} voreingestellt. Intern verwendet \Macro{FamilyBoolKey} dann -\Macro{FamilySetBool} als \PName{Aktion} für -\DescRef{\LabelBase.cmd.DefineFamilyKey}. Der Säumniswert für eine solche +\Macro{FamilySetBool} als \PName{Aktion} für +\DescRef{\LabelBase.cmd.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 -Ausschalten. Wird ein unbekannter Wert übergeben, so wird die Anweisung +Ausschalten. Wird ein unbekannter Wert übergeben, so wird die Anweisung \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} mit den Argumenten -\PName{Familie}, \PName{Schlüssel} und \PName{Wert} aufgerufen und so +\PName{Familie}, \PName{Schlüssel} und \PName{Wert} aufgerufen und so \DescRef{\LabelBase.cmd.FamilyKeyState} entsprechend gesetzt. Dadurch wird -dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben +dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben (siehe auch \DescPageRef{\LabelBase.cmd.FamilyUnknownKeyValue} und \DescPageRef{\LabelBase.cmd.FamilyKeyState}). \begin{Example} - Der Schlüssel \Option{Aufschnitt} soll in den Wurstpaketen etwas robuster - definiert werden. Außerdem sollen alle Wurstpakete denselben Schalter + Der Schlüssel \Option{Aufschnitt} soll in den Wurstpaketen etwas robuster + definiert werden. Außerdem sollen alle Wurstpakete denselben Schalter verwenden, so dass entweder alle Wurstpakete Aufschnitt produzieren oder keines. \begin{lstcode} \FamilyBoolKey{Fleischermeister}{Aufschnitt}% {@Aufschnitt} \end{lstcode} - Ein Test, ob Aufschnitt produziert wird, sähe dann so aus: + Ein Test, ob Aufschnitt produziert wird, sähe dann so aus: \begin{lstcode} \if@Aufschnitt ... @@ -653,8 +665,8 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben ... \fi \end{lstcode} - Dies wäre in allen drei Wurstpaketen identisch. Damit könnte man - prinzipiell die Eigenschaft »Aufschnitt« auch als Eigenschaft der Familie + Dies wäre in allen drei Wurstpaketen identisch. Damit könnte man + prinzipiell die Eigenschaft »Aufschnitt« auch als Eigenschaft der Familie definieren: \begin{lstcode}[moretexcs={define@key}] \@ifundefined{if@Aufschnitt}{% @@ -675,18 +687,18 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben {Aufschnitt}% {@Aufschnitt} \end{lstcode} - unter Ausnutzung des Hinweises bezüglich leerer Mitglieder + unter Ausnutzung des Hinweises bezüglich leerer Mitglieder \iftrue% Umbruchkorrekturtext im Gegensatz zum Weglassen des optionalen Arguments \fi% - auf \autopageref{explain:scrbase.macro.DefineFamilyKey}, der nicht nur für - \DescRef{\LabelBase.cmd.DefineFamilyKey}, sondern entsprechend auch für + auf \autopageref{explain:scrbase.macro.DefineFamilyKey}, der nicht nur für + \DescRef{\LabelBase.cmd.DefineFamilyKey}, sondern entsprechend auch für \Macro{FamilyBoolKey} gilt. Da \DescRef{\LabelBase.cmd.FamilyKeyState} bereits von \Macro{FamilySetBool} gesetzt wird, kann innerhalb der Definition der Option mit Hilfe von \DescRef{\LabelBase.cmd.DefineFamilyKey} der Status gegebenenfalls auch - abgefragt werden. So könnte man im ersten Fall beispielsweise nach + abgefragt werden. So könnte man im ersten Fall beispielsweise nach \Macro{FamilySetBool} einen Test der Art: \begin{lstcode} \ifx\FamilyKeyState\FamilyKeyStateProcessed @@ -695,34 +707,48 @@ dann gegebenenfalls eine Meldung über eine unbekannte Wertzuweisung ausgegeben ... \fi \end{lstcode} - ergänzen, um zusätzliche Aktionen in Abhängigkeit davon, ob + ergänzen, um zusätzliche Aktionen in Abhängigkeit davon, ob \Macro{FamilySetBool} erfolgreich war oder nicht, - auszuführen. Es\textnote{Achtung!} ist zu beachten, dass an dieser Stelle + auszuführen. Es\textnote{Achtung!} 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. Sie können abhängig vom + Tests wie \Macro{ifstr} sind hier zu vermeiden. Sie können abhängig vom aktuellen Status und dem Vergleichszustand zu unterschiedlichen - Fehlermeldungen und auch zu falschen Ergebnissen führen.% -\end{Example} -% + Fehlermeldungen und auch zu falschen Ergebnissen führen.% +\end{Example}% \EndIndexGroup +\begin{Declaration} + \Macro{FamilyInverseBoolKey}\OParameter{Mitglied}\Parameter{Familie} + \Parameter{Schlüssel}\Parameter{Schaltername} + \Macro{FamilySetInverseBool}\Parameter{Familie} + \Parameter{Schlüssel}\Parameter{Schaltername} + \Parameter{Wert} +\end{Declaration}% +Diese\ChangedAt{v3.27}{\Package{scrbase}} beiden Anweisungen unterscheiden +sich von \DescRef{\LabelBase.cmd.FamilyBoolKey} beziehungsweise +\DescRef{\LabelBase.cmd.FamilySetBool} nur dadurch, dass die Logik invertiert +wird. Das heißt, dass die Werte \PValue{true}, \PValue{yes} und \PValue{on} +den durch \PName{Schaltername} angegebenen Schalter auf \Macro{iffalse} setzen +und damit deaktivieren, während \PValue{false}, \PValue{no} und \PValue{off} +ihn zu \Macro{iftrue} werden lassen, also aktivieren.% +\EndIndexGroup \begin{Declaration} \Macro{FamilyNumericalKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makroname}% + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makroname}% \Parameter{Werteliste} - \Macro{FamilySetNumerical}\Parameter{Familie}\Parameter{Schlüssel} + \Macro{FamilySetNumerical}\Parameter{Familie}\Parameter{Schlüssel} \Parameter{Makroname}\Parameter{Werteliste}% \Parameter{Wert} \end{Declaration} -Während Schalter nur zwei Werte annehmen können, gibt es auch Schlüssel, die +Während Schalter nur zwei Werte annehmen können, gibt es auch Schlüssel, die mehrere Werte kennen. So kann beispielsweise eine Ausrichtung nicht nur entweder links oder nicht links, sondern auch links, mittig oder rechts sein. Intern unterscheidet man solche Einstellungen dann gerne mit Hilfe von \Macro{ifcase}\IndexCmd{ifcase}. Diese \TeX-Anweisung erwartet wiederum einen -nummerischen Wert. Daher heißt bei \Package{scrbase} die Anweisung, mit der -man via \PName{Schlüssel} einem Makro eine Definition zuweisen kann, +nummerischen Wert. Daher heißt bei \Package{scrbase} die Anweisung, mit der +man via \PName{Schlüssel} einem Makro eine Definition zuweisen kann, entsprechend \Macro{FamilyNumericalKey}. Die \PName{Werteliste} hat dabei die Form: @@ -730,17 +756,17 @@ Die \PName{Werteliste} hat dabei die Form: \Parameter{Wert}\Parameter{Definition}\texttt{,}\linebreak[1]% \Parameter{Wert}\Parameter{Definition}~\dots{} %\end{tabular}\vskip\dp\strutbox\end{flushleft} -Über diese \PName{Werteliste} werden so nicht nur die erlaubten Werte für den -\PName{Schlüssel} angegeben. Für jeden erlaubten \PName{Wert} wird auch +Ãœber diese \PName{Werteliste} werden so nicht nur die erlaubten Werte für den +\PName{Schlüssel} angegeben. Für jeden erlaubten \PName{Wert} wird auch gleich angegeben, wie bei Verwendung desselben das Makro -\Macro{\PName{Makroname}} definiert werden soll. Üblicherweise werden als +\Macro{\PName{Makroname}} definiert werden soll. Ãœblicherweise werden als \PName{Definition} schlicht Zahlenwerte angegeben. Es sind zwar auch andere -Angaben möglich, derzeit gibt es aber die Einschränkung, dass +Angaben möglich, derzeit gibt es aber die Einschränkung, dass \PName{Definition} voll expandierbar sein muss und bei der Zuweisung auch expandiert wird. \begin{Example} - Die Wurst für den Wurstsalat kann unterschiedlich geschnitten werden. So - wäre es denkbar, dass der Aufschnitt einfach ungeschnitten bleibt oder in + Die Wurst für den Wurstsalat kann unterschiedlich geschnitten werden. So + wäre es denkbar, dass der Aufschnitt einfach ungeschnitten bleibt oder in grobe oder feine Streifen geschnitten werden soll. Diese Information soll in der Anweisung \Macro{Schnitt} gespeichert werden. \begin{lstcode} @@ -760,13 +786,13 @@ expandiert wird. \begin{lstcode} \FamilyOptions{Fleischermeister}{SalatSchnitt=Nein} \end{lstcode} - angegeben werden. In beiden Fällen würde \Macro{Schnitt} mit dem Inhalt + angegeben werden. In beiden Fällen würde \Macro{Schnitt} mit dem Inhalt \PValue{Kein} definiert. Es kann durchaus sinnvoll sein, dem Anwender wie in - diesem Beispiel mehrere Werte für denselben Zweck anzubieten. + diesem Beispiel mehrere Werte für denselben Zweck anzubieten. Nun ist es sehr wahrscheinlich, dass die Schnittart nicht ausgegeben, - sondern später ausgewertet werden soll. In diesem Fall sind die textuellen - Definitionen aber eher unpraktisch. Definiert man den Schlüssel hingegen als + sondern später ausgewertet werden soll. In diesem Fall sind die textuellen + Definitionen aber eher unpraktisch. Definiert man den Schlüssel hingegen als \begin{lstcode} \FamilyNumericalKey{Fleischermeister}% {SalatSchnitt}{Schnitt}{% @@ -775,7 +801,7 @@ expandiert wird. {Fein}{2}% } \end{lstcode} - so kann später einfach in der Form + so kann später einfach in der Form \begin{lstcode} \ifcase\Schnitt % ungeschnitten @@ -790,10 +816,10 @@ expandiert wird. Intern wird von \Macro{FamilyNumericalKey} dann \DescRef{\LabelBase.cmd.DefineFamilyKey} mit der Anweisung -\Macro{FamilySetNumerical} verwendet. Wird an einen solchen Schlüssel ein -unbekannter Wert übergeben, so wird von \Macro{FamilySetNumerical} Anweisung +\Macro{FamilySetNumerical} verwendet. Wird an einen solchen Schlüssel ein +unbekannter Wert übergeben, so wird von \Macro{FamilySetNumerical} Anweisung \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} mit den Argumenten -\PName{Familie}, \PName{Schlüssel} und \PName{Wert} aufgerufen. Dies führt zu +\PName{Familie}, \PName{Schlüssel} und \PName{Wert} aufgerufen. Dies führt zu einer Fehlersignalisierung in \DescRef{\LabelBase.cmd.FamilyKeyState} mit Hilfe des Status \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} und beispielsweise bei der Verwendung als lokale Option zu einer @@ -806,30 +832,30 @@ Erfolg via \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} in \begin{Declaration} \Macro{FamilyCounterKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{\LaTeX-Zähler} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{\LaTeX-Zähler} \Macro{FamilySetCounter}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{\LaTeX-Zähler} + \Parameter{Schlüssel}\Parameter{\LaTeX-Zähler} \Parameter{Wert} \end{Declaration} -Während\ChangedAt{v3.12}{\Package{scrbase}} bei +Während\ChangedAt{v3.12}{\Package{scrbase}} bei \DescRef{\LabelBase.cmd.FamilyNumericalKey} ein Makro aufgrund eines symbolischen Wertes auf einen korrespondierenden nummerischen Wert -gesetzt wurde, gibt es natürlich auch Fälle, in denen ein \PName{Schlüssel} -direkt einen \PName{\LaTeX-Zähler} repräsentiert, dem unmittelbar ein +gesetzt wurde, gibt es natürlich auch Fälle, in denen ein \PName{Schlüssel} +direkt einen \PName{\LaTeX-Zähler} repräsentiert, dem unmittelbar ein nummerischer \PName{Wert} zugewiesen werden soll. Dazu dient die Anweisung \Macro{FamilyCounterKey}, von der intern dann \Macro{FamilySetCounter} -aufgerufen wird. Dabei finden einige grundlegende Prüfungen des -\PName{Wert}-Arguments statt um festzustellen, ob dieses Argument für eine -Zuweisung an einen Zähler in Frage kommt. Die Zuweisung findet nur statt, wenn -diese Prüfungen gelingen. Allerdings können hier nicht alle Fehler erkannt +aufgerufen wird. Dabei finden einige grundlegende Prüfungen des +\PName{Wert}-Arguments statt um festzustellen, ob dieses Argument für eine +Zuweisung an einen Zähler in Frage kommt. Die Zuweisung findet nur statt, wenn +diese Prüfungen gelingen. Allerdings können hier nicht alle Fehler erkannt werden, so dass eine falsche Zuweisung auch zu einer Fehlermeldung von \TeX{} -selbst führen kann. Erkannte Fehler werden hingegen über +selbst führen kann. Erkannte Fehler werden hingegen über \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} signalisiert. -Wurde\ChangedAt{v3.15}{\Package{scrbase}} 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 +Wurde\ChangedAt{v3.15}{\Package{scrbase}} 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.% \iffalse% Umbruchkorrekturtext \ Anderenfalls wir mit @@ -842,17 +868,17 @@ solcher gemeldet.% \begin{Declaration} \Macro{FamilyCounterMacroKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makro} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makro} \Macro{FamilySetCounterMacro}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Makro} + \Parameter{Schlüssel}\Parameter{Makro} \Parameter{Wert} \end{Declaration} Diese\ChangedAt{v3.12}{\Package{scrbase}} beiden Anweisungen unterscheiden -sich von den zuvor erklärten \DescRef{\LabelBase.cmd.FamilyCounterKey} und +sich von den zuvor erklärten \DescRef{\LabelBase.cmd.FamilyCounterKey} und \DescRef{\LabelBase.cmd.FamilySetCounter} nur dadurch, dass nicht ein -\LaTeX-Zähler auf einen Wert gesetzt wird, sondern ein \PName{Makro} mit -diesem Wert definiert wird. Auch dabei wird \PName{Wert} lokal einem Zähler +\LaTeX-Zähler auf einen Wert gesetzt wird, sondern ein \PName{Makro} mit +diesem Wert definiert wird. Auch dabei wird \PName{Wert} lokal einem Zähler zugewiesen und dann dessen expandierter Wert verwendet. Es gilt daher der Wert zum Zeitpunkt des Aufrufs der Option.% \EndIndexGroup @@ -860,46 +886,46 @@ zum Zeitpunkt des Aufrufs der Option.% \begin{Declaration} \Macro{FamilyLengthKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Länge} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Länge} \Macro{FamilySetLength}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Länge} + \Parameter{Schlüssel}\Parameter{Länge} \Parameter{Wert} \Macro{FamilyLengthMacroKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makro} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makro} \Macro{FamilySetLengthMacro}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Makro} + \Parameter{Schlüssel}\Parameter{Makro} \Parameter{Wert} \Macro{FamilyUseLengthMacroKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makro} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makro} \Macro{FamilySetUseLengthMacro}\Parameter{Familie} - \Parameter{Schlüssel}\Parameter{Makro} + \Parameter{Schlüssel}\Parameter{Makro} \Parameter{Wert} \end{Declaration} -Über\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey} kann ein -\PName{Schlüssel} definiert werden, der eine \PName{Länge} -repräsentiert. Dabei spielt es keine Rolle, ob eine \LaTeX-Länge, ein -\TeX-Abstand oder eine \TeX-Ausdehnung als \PName{Länge} verwendet -wird. Intern wird die \PName{Länge} über \Macro{FamilySetLength} gesetzt. -Dabei finden einige grundlegende Prüfungen des \PName{Wert}-Arguments statt um -festzustellen, ob dieses Argument für eine Zuweisung an eine \PName{Länge} in -Frage kommt. Die Zuweisung findet nur statt, wenn diese Prüfungen -gelingen. Allerdings können hier nicht alle Fehler erkannt werden, so dass -eine falsche Zuweisung auch zu einer Fehlermeldung von \TeX{} selbst führen -kann. Erkannte Fehler werden hingegen über +Ãœber\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey} kann ein +\PName{Schlüssel} definiert werden, der eine \PName{Länge} +repräsentiert. Dabei spielt es keine Rolle, ob eine \LaTeX-Länge, ein +\TeX-Abstand oder eine \TeX-Ausdehnung als \PName{Länge} verwendet +wird. Intern wird die \PName{Länge} über \Macro{FamilySetLength} gesetzt. +Dabei finden einige grundlegende Prüfungen des \PName{Wert}-Arguments statt um +festzustellen, ob dieses Argument für eine Zuweisung an eine \PName{Länge} in +Frage kommt. Die Zuweisung findet nur statt, wenn diese Prüfungen +gelingen. Allerdings können hier nicht alle Fehler erkannt werden, so dass +eine falsche Zuweisung auch zu einer Fehlermeldung von \TeX{} selbst führen +kann. Erkannte Fehler werden hingegen über \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} signalisiert. -Wurde\ChangedAt{v3.15}{\Package{scrbase}} 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 +Wurde\ChangedAt{v3.15}{\Package{scrbase}} 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. Bei Verwendung der Anweisungen \Macro{FamilyLengthMacroKey} und \Macro{FamilyUseLengthMacroKey} beziehungsweise \Macro{FamilySetLengthMacro} und \Macro{FamilySetUseLengthMacro} findet die Speicherung des Wertes nicht in -einer \PName{Länge}, sondern in einem \PName{Makro} statt. Dabei wird bei +einer \PName{Länge}, sondern in einem \PName{Makro} statt. Dabei wird bei \Macro{FamilyLengthMacroKey} und \Macro{FamilySetLengthMacro} vergleichbar zu \Macro{setlength} der aktuelle \PName{Wert} zum Zeitpunkt des Aufrufs der beiden Anweisungen in \PName{Makro} gespeichert. Dagegen wird bei @@ -911,41 +937,41 @@ beiden Anweisungen in \PName{Makro} gespeichert. Dagegen wird bei \begin{Declaration} \Macro{FamilyStringKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makro} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makro} \Macro{FamilyCSKey}\OParameter{Mitglied}\Parameter{Familie} - \Parameter{Schlüssel} - \OParameter{Säumniswert}\Parameter{Makronamen} + \Parameter{Schlüssel} + \OParameter{Säumniswert}\Parameter{Makronamen} \end{Declaration} -Hier wird nun\ChangedAt{v3.08}{\Package{scrbase}} ein Schlüssel definiert, der +Hier wird nun\ChangedAt{v3.08}{\Package{scrbase}} ein Schlüssel definiert, der jeden beliebigen Wert annehmen kann. Der Wert wird in dem angegebenen -\PName{Makro} gespeichert. Wird das optionale Argument für den -\PName{Säumniswert} weggelassen, so entspricht \Macro{FamilyStringKey}: -\begin{lstcode}[escapeinside=»«] - \DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«} - {\def»\PName{Makro}«{#1}} +\PName{Makro} gespeichert. Wird das optionale Argument für den +\PName{Säumniswert} weggelassen, so entspricht \Macro{FamilyStringKey}: +\begin{lstcode}[escapeinside=><] + \DefineFamilyKey[>\PName{Mitglied}<]{>\PName{Familie}<}{>\PName{Schlüssel}<} + {\def>\PName{Makro}<{#1}} \end{lstcode} Existiert -das optionale Argument für den \PName{Säumniswert} so entspricht die Anweisung: -\begin{lstcode}[escapeinside=»«] - \DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«} - [»\PName{Säumniswert}«] - {\def»\PName{Makro}«{#1}\FamilyKeyStateProcessed} +das optionale Argument für den \PName{Säumniswert} so entspricht die Anweisung: +\begin{lstcode}[escapeinside=><] + \DefineFamilyKey[>\PName{Mitglied}<]{>\PName{Familie}<}{>\PName{Schlüssel}<} + [>\PName{Säumniswert}<] + {\def>\PName{Makro}<{#1}\FamilyKeyStateProcessed} \end{lstcode} \begin{Example} In der Voreinstellung sollen 250\,g Wurstsalat erzeugt werden. Die Menge - soll jedoch einfach per Option geändert werden können. Dazu wird die zu + soll jedoch einfach per Option geändert werden können. Dazu wird die zu erstellende Menge im Makro \Macro{Salatgewicht} gespeichert. Die Option, - über die das Gewicht geändert werden kann, soll ebenfalls - \PValue{Salatgewicht} heißen: + über die das Gewicht geändert werden kann, soll ebenfalls + \PValue{Salatgewicht} heißen: \begin{lstcode} \newcommand*{\Salatgewicht}{250g} \FamilyStringKey{Fleischermeister}% {Salatgewicht}[250g]% {\Salatgewicht} \end{lstcode} - Soll nach einer Änderung + Soll nach einer Änderung \iffalse% Umbruchkorrekturtext wie \begin{lstcode} @@ -958,12 +984,12 @@ das optionale Argument für den \PName{Säumniswert} so entspricht die Anweisung: \begin{lstcode} \FamilyOptions{Fleischermeister}{Salatgewicht} \end{lstcode} - Das ist möglich, weil die Standardmenge bei der Definition auch als - Säumniswert angegeben wurde. + Das ist möglich, weil die Standardmenge bei der Definition auch als + Säumniswert angegeben wurde. \end{Example} -In diesem Fall existieren keine unbekannten Werte, da alle Werte schlicht für +In diesem Fall existieren keine unbekannten Werte, da alle Werte schlicht für eine Makrodefinition verwendet werden. Es ist jedoch zu beachten, dass in der -Wertzuweisung an den Schlüssel keine Absätze enthalten sein dürfen. +Wertzuweisung an den Schlüssel keine Absätze enthalten sein dürfen. Im\ChangedAt{v3.25}{\Package{scrbase}} Unterschied zu \Macro{FamilyStringKey} erwartet \Macro{FamilyCSKey} kein Makro als letztes Argument, sondern @@ -974,10 +1000,10 @@ lediglich den Namen eines Makros, also beispielsweise nicht \begin{Declaration} - \Macro{FamilyUnknownKeyValue}\Parameter{Familie}\Parameter{Schlüssel} + \Macro{FamilyUnknownKeyValue}\Parameter{Familie}\Parameter{Schlüssel} \Parameter{Wert}\Parameter{Werteliste} \end{Declaration} -Diese Anweisung signalisiert über \DescRef{\LabelBase.cmd.FamilyKeyState} +Diese Anweisung signalisiert über \DescRef{\LabelBase.cmd.FamilyKeyState} einen Fehler aufgrund eines unbekannten oder unerlaubten Wertes. Dabei wird als \PName{Werteliste} eine durch Komma separierte Liste von erlaubten Werten der Form: @@ -988,7 +1014,7 @@ 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 + 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 dann verwendet werden soll, wenn nicht angegeben wird, wie der Aufschnitt zu schneiden ist. @@ -1023,27 +1049,27 @@ erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die \fi }% \end{lstcode} - Zunächst wird versucht, den booleschen Schalter für Aufschnitt über + Zunächst wird versucht, den booleschen Schalter für Aufschnitt über \DescRef{\LabelBase.cmd.FamilySetBool} zu setzen. Gelingt dies, wurde also \DescRef{\LabelBase.cmd.FamilyKeyState} zu \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} definiert, wird - der Feinschnitt abgeschaltet. Anderenfalls wird überprüft, ob anstelle - eines gültigen Wertes für einen booleschen Schalter %der Wert - \PValue{fein} übergeben wurde. In diesem Fall wird sowohl der Feinschnitt, + der Feinschnitt abgeschaltet. Anderenfalls wird überprüft, ob anstelle + eines gültigen Wertes für einen booleschen Schalter %der Wert + \PValue{fein} übergeben wurde. In diesem Fall wird sowohl der Feinschnitt, als auch Aufschnitt aktiviert und mit Hilfe von \DescRef{\LabelBase.cmd.FamilyKeyStateProcessed} der Erfolgs-Status gesetzt. Ist auch das nicht der Fall, wird der von \DescRef{\LabelBase.cmd.FamilySetBool} signalisierte Fehler-Zustand neu auf \DescRef{\LabelBase.cmd.FamilyKeyStateUnknownValue} gesetzt. Die - Liste der üblichen erlaubten Werte von + Liste der üblichen erlaubten Werte von \DescRef{\LabelBase.cmd.FamilySetBool} wird dabei um \PValue{fein} - ergänzt. Da diese Liste jedoch inzwischen nicht mehr verwendet wird, hätte + ergänzt. Da diese Liste jedoch inzwischen nicht mehr verwendet wird, hätte man auf den Aufruf von \Macro{FamilyUnknownKeyValue} im Beispiel auch einfach verzichten und damit den Fehlerstatus von - \DescRef{\LabelBase.cmd.FamilySetBool} übernehmen können. + \DescRef{\LabelBase.cmd.FamilySetBool} übernehmen können. Die bei den Tests verwendete Anweisung \Macro{ifstr}\IndexCmd{ifstr} ist auf - \DescPageRef{scrbase.cmd.ifstr} in \autoref{sec:scrbase.if} erklärt. + \DescPageRef{scrbase.cmd.ifstr} in \autoref{sec:scrbase.if} erklärt. \end{Example} % \EndIndexGroup @@ -1052,9 +1078,9 @@ erwartet. Allerdings\ChangedAt{v3.12}{\Package{scrbase}} wird die \begin{Declaration} \Macro{FamilyElseValues} \end{Declaration} -In\ChangedAt{v3.12}{\Package{scrbase}} früheren\textnote{Veraltet!} Versionen -von \Package{scrbase} konnte man über die Anweisung \Macro{FamilyElseValues} -weitere erlaubte Werte für die Bearbeitung durch +In\ChangedAt{v3.12}{\Package{scrbase}} früheren\textnote{Veraltet!} Versionen +von \Package{scrbase} konnte man über die Anweisung \Macro{FamilyElseValues} +weitere erlaubte Werte für die Bearbeitung durch \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} \iffalse% Umbruchkorrekturtext in der Form @@ -1066,8 +1092,8 @@ ablegen, die dann ebenfalls in einer Fehlermeldung mit ausgegeben wurden. Seit Version~3.12 gibt \DescRef{\LabelBase.cmd.FamilyUnknownKeyValue} keine Fehlermeldungen mehr aus, sondern setzt nur noch \DescRef{\LabelBase.cmd.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 +von \Macro{FamilyElseValue} ebenfalls überholt. Ihre Verwendung wird jedoch +erkannt und führt dann zu einer Aufforderung, den Code entsprechend anzupassen.% \EndIndexGroup @@ -1076,7 +1102,7 @@ anzupassen.% \seclabel{if} Das Paket \Package{scrbase} stellt eine ganze Reihe von -Verzweigungsanweisungen zur Verfügung. Dabei wird nicht auf die \TeX-Syntax +Verzweigungsanweisungen zur Verfügung. Dabei wird nicht auf die \TeX-Syntax von Verzweigungen wie beispielsweise \begin{lstcode} \iftrue @@ -1088,35 +1114,35 @@ von Verzweigungen wie beispielsweise gebaut, sondern es wird die \LaTeX-Syntax mit Argumenten eingesetzt, wie man sie auch von \LaTeX-Anweisungen wie \Macro{IfFileExists}, \Macro{@ifundefined}, \Macro{@ifpackageloaded} und vielen weiteren -kennt. Einige Paketautoren ziehen es allerdings vor, die \TeX-Syntax auch für +kennt. Einige Paketautoren ziehen es allerdings vor, die \TeX-Syntax auch für Anwender in die \LaTeX-Ebene zu bringen. Da es sich bei den Verzweigungen von -\Package{scrbase} um recht grundlegende Möglichkeiten handelt, ist die +\Package{scrbase} um recht grundlegende Möglichkeiten handelt, ist die Wahrscheinlichkeit gegeben, dass dabei gleichnamige Anwenderanweisungen -verwendet würden. Dies könnte selbst bei eigentlich gleicher Semantik +verwendet würden. Dies könnte selbst bei eigentlich gleicher Semantik zu einem Problem aufgrund unterschiedlichen Syntax -führen. \Package{scrbase} geht daher auf Nummer sicher. +führen. \Package{scrbase} geht daher auf Nummer sicher. \begin{Declaration} \OptionVName{internalonly}{Wert} \end{Declaration} Von \Package{scrbase} werden einige Verzweigungsanweisungen -bereitgestellt. Dabei verwendet es primär die Bezeichnungen +bereitgestellt. Dabei verwendet es primär die Bezeichnungen \Macro{scr@\PName{Name}}\textnote{Paketautoren}. Es handelt sich somit um interne Anweisungen. Diese werden auch intern von \KOMAScript{} -verwendet. Paket- und Klassenautoren können diese Anweisungen ebenfalls +verwendet. Paket- und Klassenautoren können diese Anweisungen ebenfalls verwenden, sollten sie aber nicht umdefinieren. Da einige dieser Anweisungen -auch für Benutzer nützlich sein können, werden die gleichen Anweisungen +auch für Benutzer nützlich sein können, werden die gleichen Anweisungen normalerweise auch als \Macro{\PName{Name}}\textnote{Anwender} bereitgestellt. Da eventuell andere Pakete gleichnamige Anweisungen mit -anderer Syntax bereitstellen könnten und es so zu Konflikten kommen könnte, +anderer Syntax bereitstellen könnten und es so zu Konflikten kommen könnte, kann der Anwender die Definition von \Macro{\PName{Name}} verhindern. Dazu gibt er entweder die Option ohne Wertangabe an. In diesem Fall werden nur die internen Verzweigungsanweisungen definiert. Oder er gibt genau die Anweisungen, die nicht definiert werden sollen, als Wert an, wobei er -»\Macro{}« durch »\texttt{/}« ersetzt. +»\Macro{}« durch »\texttt{/}« ersetzt. Paket- und Klassenautoren sollten diese Option normalerweise nicht verwenden. -Anwender können sie mit oder ohne Wertangabe entweder als globale Option bei +Anwender können sie mit oder ohne Wertangabe entweder als globale Option bei \DescRef{maincls.cmd.documentclass} oder per \Macro{PassOptionsToPackage}\IndexCmd{PassOptionsToPackage} angeben. \begin{Example} @@ -1129,14 +1155,14 @@ Anwender können sie mit oder ohne Wertangabe entweder als globale Option bei internalonly=/ifVTeX/ifundefinedorrelax% ]{foo} \end{lstcode} - Der Klassenname \Class{foo} wird hier als Platzhalter für irgendeine Klasse + Der Klassenname \Class{foo} wird hier als Platzhalter für irgendeine Klasse verwendet. Die Anweisungen \DescRef{\LabelBase.cmd.ifVTeX} und \DescRef{\LabelBase.cmd.ifundefinedorrelax} werden im weiteren Verlauf - dieses Abschnittes erklärt.% + dieses Abschnittes erklärt.% \end{Example} Paket- und Klassenautoren sollten wie \KOMAScript{} selbst auch die internen -Namen verwenden. Zur Vollständigkeit sind in den nachfolgenden Erklärungen +Namen verwenden. Zur Vollständigkeit sind in den nachfolgenden Erklärungen aber auch die Anwenderanweisungen angegeben.% \EndIndexGroup @@ -1149,7 +1175,7 @@ aber auch die Anwenderanweisungen angegeben.% \end{Declaration} Diese Anweisung funktioniert prinzipiell wie \Macro{@ifundefined} aus dem \LaTeX-Kern (siehe \cite{latex:source2e}). Es wird also der \PName{Dann-Teil} -ausgeführt, wenn \PName{Name} der Name einer undefinierten Anweisung oder +ausgeführt, wenn \PName{Name} der Name einer undefinierten Anweisung oder \Macro{\PName{Name}} derzeit \Macro{relax} ist. Im Unterschied zu \Macro{@ifundefined} wird % \iftrue% Umbruchvarianten @@ -1166,9 +1192,9 @@ zu \Macro{relax}, wenn \Macro{\PName{Name}} zuvor undefiniert war.% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} Ist die Anweisung mit dem angegebenen Namen bereits definiert wird der -\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Da es bei +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Da es bei \eTeX{} bereits ein Primitiv \Macro{ifdefined} gibt, musste leider diese -etwas unhandliche Bezeichnung gewählt werden. % +etwas unhandliche Bezeichnung gewählt werden. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% \else% @@ -1182,13 +1208,13 @@ Es gibt keine interne Variante.% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} Wird\ChangedAt{v3.21}{\Package{scrbase}} mit lua\TeX{} gearbeitet, wird der -\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. \iftrue% Umbruchkorrekturtext Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. % \fi% -In der Regel sollte man besser auf die gewünschte Anweisung +In der Regel sollte man besser auf die gewünschte Anweisung testen. Von\textnote{Achtung!} dieser Anweisung gibt es kein -Benutzeräquivalent. Verwenden Sie stattdessen bei Bedarf das Paket +Benutzeräquivalent. Verwenden Sie stattdessen bei Bedarf das Paket \Package{ifluatex}\important{\Package{ifluatex}} (siehe \cite{package:ifluatex}).% \EndIndexGroup @@ -1200,13 +1226,13 @@ Benutzeräquivalent. Verwenden Sie stattdessen bei Bedarf das Paket \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} Bis lua\TeX~0.85 war es meist unerheblich, ob mit pdf\TeX{} oder lua\TeX{} -gearbeitet wurde. Von daher stammt diese Anweisung, die in beiden Fällen den -\PName{Dann-Teil} ausführt. Wird weder mit pdf\TeX{} noch mit lua\TeX{} -gearbeitet, so wird der \PName{Sonst-Teil} ausgeführt. -Seit Version 0.85 wurde bei lua\TeX{} die Kompatibilität bei vielen der -zusätzlichen Befehle jedoch aufgegeben. Daher ist diese Unterscheidung in der +gearbeitet wurde. Von daher stammt diese Anweisung, die in beiden Fällen den +\PName{Dann-Teil} ausführt. Wird weder mit pdf\TeX{} noch mit lua\TeX{} +gearbeitet, so wird der \PName{Sonst-Teil} ausgeführt. +Seit Version 0.85 wurde bei lua\TeX{} die Kompatibilität bei vielen der +zusätzlichen Befehle jedoch aufgegeben. Daher ist diese Unterscheidung in der Praxis nicht mehr von Nutzen und wird von \KOMAScript{} selbst auch nicht mehr -verwendet. Von dieser Anweisung gibt es auch kein Benutzeräquivalent.% +verwendet. Von dieser Anweisung gibt es auch kein Benutzeräquivalent.% \EndIndexGroup \fi @@ -1217,13 +1243,13 @@ verwendet. Von dieser Anweisung gibt es auch kein Benutzeräquivalent.% \Macro{ifpdftex} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wird mit pdf\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt, -anderenfalls der \PName{Sonst-Teil}. Dabei ist es unerheblich, ob tatsächlich +Wird mit pdf\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt, +anderenfalls der \PName{Sonst-Teil}. Dabei ist es unerheblich, ob tatsächlich eine PDF-Datei ausgegeben werden soll oder nicht. \iftrue% Umbruchkorrekturtext Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. % \fi% -In der Regel sollte man besser auf die gewünschte Anweisung testen.% +In der Regel sollte man besser auf die gewünschte Anweisung testen.% \EndIndexGroup @@ -1233,12 +1259,12 @@ In der Regel sollte man besser auf die gewünschte Anweisung testen.% \Macro{ifVTeX} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wird mit V\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt, +Wird mit V\TeX{} gearbeitet, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. \iftrue% Umbruchkorrekturtext Diese Unterscheidung ist nur sehr selten wirklich von Nutzen. % \fi% -In der Regel sollte man besser auf die gewünschte Anweisung testen.% +In der Regel sollte man besser auf die gewünschte Anweisung testen.% \EndIndexGroup @@ -1248,7 +1274,7 @@ In der Regel sollte man besser auf die gewünschte Anweisung testen.% \Macro{ifpdfoutput} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wird eine PDF-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt, +Wird eine PDF-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Dabei ist es unerheblich, ob die PDF-Datei mit Hilfe von lua\TeX{}, pdf\TeX{}, V\TeX{} oder \XeTeX{} erzeugt wird.% @@ -1261,10 +1287,10 @@ wird.% \Macro{ifpsoutput} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wird eine PostScript-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt, +Wird eine PostScript-Datei erzeugt, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. V\TeX{} kann PostScript direkt erzeugen, was hier erkannt wird. Wird hingegen kein V\TeX{} verwendet, ist aber ein -Schalter \Macro{if@dvips} definiert, so wird die Entscheidung darüber +Schalter \Macro{if@dvips} definiert, so wird die Entscheidung darüber getroffen. \KOMAScript{} stellt \Macro{if@dvips} in \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}% \IndexCmd{if@dvips} bereit.% @@ -1277,7 +1303,7 @@ getroffen. \KOMAScript{} stellt \Macro{if@dvips} in \Macro{ifdvioutput} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wird eine DVI-Datei erzeugt, so wird der \PName{Dann-Teil} ausgeführt, +Wird eine DVI-Datei erzeugt, so wird der \PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Es wird immer dann davon ausgegangen, dass eine DVI-Datei erzeugt wird, wenn keine direkte Ausgabe einer PDF- oder Postscript-Datei erkannt werden kann.% @@ -1289,10 +1315,10 @@ Postscript-Datei erkannt werden kann.% \textMacro{else}\ \PName{Sonst-Teil} \textMacro{fi} \end{Declaration} Diese Verzweigung existiert ganz bewusst nur als interne Anweisung. Dabei -entspricht \Macro{if@atdocument} in der Dokumentpräambel \Macro{iffalse}, nach +entspricht \Macro{if@atdocument} in der Dokumentpräambel \Macro{iffalse}, nach \Macro{begin}\PParameter{document} entspricht \Macro{if@atdocument} hingegen -\Macro{iftrue}. Klassen und Paketautoren können dieses Anweisung manchmal -sinnvoll nutzen, wenn sich Anweisungen in der Dokumentpräambel anders +\Macro{iftrue}. Klassen und Paketautoren können dieses Anweisung manchmal +sinnvoll nutzen, wenn sich Anweisungen in der Dokumentpräambel anders verhalten sollen als innerhalb des Dokuments. Es\textnote{Achtung!} ist zu beachten, dass es sich bei dieser Anweisung um eine Verzweigung in \TeX-Syntax und nicht in \LaTeX-Syntax handelt! @@ -1305,7 +1331,7 @@ und nicht in \LaTeX-Syntax handelt! \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} Die beiden Argumente \PName{Zeichenfolge} werden expandiert und dann -verglichen. Sind sie dabei gleich, so wird der \PName{Dann-Teil} ausgeführt, +verglichen. Sind sie dabei gleich, so wird der \PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1322,7 +1348,7 @@ Es gibt keine interne Variante.% 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}. % +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% \else% @@ -1335,8 +1361,8 @@ Es gibt keine interne Variante.% \Macro{ifisdimen}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} 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 +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. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1351,10 +1377,10 @@ Es gibt keine interne Variante.% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} 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 +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. % +Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% \else% @@ -1367,8 +1393,8 @@ Es gibt keine interne Variante.% \Macro{ifdimen}\Parameter{Zeichenfolge}% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der -\PName{Zeichenfolge} eine gültige Länge mit einer gültigen Längeneinheit +Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der +\PName{Zeichenfolge} eine gültige Länge mit einer gültigen Längeneinheit ist. Anderenfalls wird der \PName{Sonst-Teil} verwendet. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1384,10 +1410,10 @@ Es gibt keine interne Variante.% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in -einer \Macro{dimexpr}\IndexCmd{dimexpr}, also einem \eTeX-Längenausdruck -resultiert, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der +einer \Macro{dimexpr}\IndexCmd{dimexpr}, also einem \eTeX-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 +Ausdrücke zu Fehlermeldungen führen! Die Anweisung ist nicht voll expandierbar. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1402,7 +1428,7 @@ Es gibt keine interne Variante.% \end{Declaration} 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 +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die Anweisung ist nicht voll expandierbar. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1418,9 +1444,9 @@ Es gibt keine interne Variante.% \end{Declaration} 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 +\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. % +Fehlermeldung führen. Die Anweisung ist nicht voll expandierbar. % \iffalse% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% \else% @@ -1436,9 +1462,9 @@ Es gibt keine interne Variante.% Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in einer \Macro{glueexpr}\IndexCmd{glueexpr}, also einem \mbox{\eTeX}-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. % +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. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% \else% @@ -1448,11 +1474,11 @@ Es gibt keine interne Variante.% \begin{Declaration} - \Macro{ifiscounter}\Parameter{Zähler}% + \Macro{ifiscounter}\Parameter{Zähler}% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Wenn\ChangedAt{v3.12}{\Package{scrbase}} \PName{Zähler} ein definierter -\LaTeX-Zähler ist, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der +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. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1466,9 +1492,9 @@ Es gibt keine interne Variante.% \Macro{ifiscount}\Parameter{Code}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} 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 +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 \DescRef{\LabelBase.cmd.ifiscounter}. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1483,8 +1509,8 @@ Es gibt keine interne Variante.% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} 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, +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. % \iftrue% Umbruchvaritanten @@ -1499,8 +1525,8 @@ Es gibt keine interne Variante.% \Macro{ifnumber}\Parameter{Zeichenfolge}% \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der -\PName{Zeichenfolge} nur aus Ziffern besteht. In allen anderen Fällen wird der +Der \PName{Dann-Teil} wird ausgeführt, wenn die einfache Expansion der +\PName{Zeichenfolge} nur aus Ziffern besteht. In allen anderen Fällen wird der \PName{Sonst-Teil} verwendet. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1516,9 +1542,9 @@ Es gibt keine interne Variante.% \end{Declaration} Wenn\ChangedAt{v3.12}{\Package{scrbase}} die Expansion von \PName{Code} in einer \Macro{numexpr}\IndexCmd{numexpr}, also einem \eTeX-Zahlenausdruck -resultiert, wird der \PName{Dann-Teil} ausgeführt, anderenfalls der +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 +Ausdrücke zu Fehlermeldungen führen! Die Anweisung ist nicht voll expandierbar. % \iftrue% Umbruchvaritanten Von dieser Anweisung gibt es keine interne Variante.% @@ -1528,50 +1554,115 @@ Es gibt keine interne Variante.% \EndIndexGroup -\section{Definition sprachabhängiger Bezeichner} +\begin{Declaration} + \Macro{IfActiveMkBoth}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} +\end{Declaration} +Bei\ChangedAt{v3.27}{\Package{scrbase}} der Umschaltung zwischen automatischen +und manuellen Kolumnentiteln, verwendet der \LaTeX-Kern die Anweisung +\DescRef{scrlayer.cmd.@mkboth}\important{\Macro{@mkboth}}\IndexCmd{@mkboth}. +Im Falle automatischer Kolumnentitel setzt diese normalerweise sowohl den +linken als auch rechten Markenanteil. Im Falle manueller Kolumnentiteln setzt +sie keine Marke. Will man wissen, ob \DescRef{scrlayer.cmd.@mkboth} Marken +setzt oder nicht, so verwenden viele Pakete einen Vergleich entweder mit +\DescRef{maincls.cmd.markboth}\IndexCmd{markboth} oder +\Macro{@gobbletwo}. Dies deckt aber nicht alle Fälle von möglichen +Umdefinierungen von \DescRef{scrlayer.cmd.@mkboth} ab. Daher testet +\Macro{IfActiveMkBoth}, ob \DescRef{scrlayer.cmd.@mkboth} tatsächlich zum +Setzen einer Marke führen würde und deckt dabei sogar die Verwendung von +\Macro{marks} für die Definition von \DescRef{scrlayer.cmd.@mkboth} ab. Wird +eine solches aktives \DescRef{scrlayer.cmd.@mkboth} entdeckt, so wird der +\PName{Dann-Teil} ausgeführt. In allen anderen Fällen wird der +\PName{Sonst-Teil} ausgeführt.% +\begin{Example} + Angenommen, Sie wollen in einem Paket im Fall der Verwendung automatischer + Kolumnentitel, beispielsweise durch den Seitenstil + \PageStyle{headings}\IndexPagestyle{headings} nur die rechte Marke setzen + und die linke unverändert lassen, wohingegen bei Verwendung manueller + Kolumentitel die Marken unverändert bleiben sollen. In einem ersten Ansatz + verwenden Sie dafür: +\begin{lstcode} + \ifx\@mkboth\markboth \markright{Kolumnentitel}\fi +\end{lstcode} + Etwas später entdecken Sie, dass irgendein Paket nicht wie gewohnt +\begin{lstcode} + \let\@mkboth\markboth +\end{lstcode} + sondern +\begin{lstcode} + \renewcommand{\@mkboth}{\markboth} +\end{lstcode} + verwendet hat, um automatische Kolumnentitel zu aktivieren. Daher ruft Ihr + Vergleich niemals die \DescRef{maincls.cmd.markright}-Anweisung auf. Daher + ändern Sie den Vergleich oben zu +\begin{lstcode} + \ifx\@mkboth\@gobbletwo\else \markright{Kolumnentitel}\fi +\end{lstcode} + Leider wird nun \DescRef{maincls.cmd.markright} auch bei manuellen + Kolumentiteln aufgerufen, weil irgend jemand für diesen Fall +\begin{lstcode} + \renewcommand{\@mkboth}[2]{% + \typeout{DEBUG: ignoring running head setting}% + } +\end{lstcode} + definiert hat. + + Beide Probleme sind jedoch mit Hilfe von \Package{scrbase} einfach zu lösen: +\begin{lstcode} + \IfActiveMKBoth{\markright{Kolumnentitel}}{} +\end{lstcode}% +\end{Example} +Noch einfacher lässt sich das Problem aus dem Beispiel übrigens mit Hilfe von +\DescRef{scrlayer.cmd.@mkright} aus Paket +\hyperref[cha:scrlayer]{\Package{scrlayer}} lösen (siehe +\autoref{sec:scrlayer.pagestyle.content}, +\DescPageRef{scrlayer.cmd.@mkright}).% +\EndIndexGroup + + +\section{Definition sprachabhängiger Bezeichner} \seclabel{languageSupport} \BeginIndexGroup \BeginIndex{}{Sprachdefinition} \iftrue -Anfänger haben häufig Probleme damit, sprachabhängige Begriffe wie +Anfänger haben häufig Probleme damit, sprachabhängige Begriffe wie \Macro{listfigurename}\IndexCmd{listfigurename}, in der Voreinstellung meist -»List of Figures« beziehungsweise in Deutsch: »Abbildungsverzeichnis«, zu -ändern. Werden diese beispielsweise einfach mit \Macro{renewcommand} in der -Dokumentpräambel umdefiniert, so überleben sie eine spätere Umschaltung der +»List of Figures« beziehungsweise in Deutsch: »Abbildungsverzeichnis«, zu +ändern. Werden diese beispielsweise einfach mit \Macro{renewcommand} in der +Dokumentpräambel umdefiniert, so überleben sie eine spätere Umschaltung der Sprache nicht. Bei Verwendung von \Package{babel}\IndexCmd{babel} wird die -Umdefinierung in der Dokumentpräambel bereits von -\Macro{begin}\PParameter{document} wieder überschrieben. +Umdefinierung in der Dokumentpräambel bereits von +\Macro{begin}\PParameter{document} wieder überschrieben. \fi -Normalerweise muss man zur Definition oder zur Änderung sprachabhängiger +Normalerweise muss man zur Definition oder zur Änderung sprachabhängiger Begriffe Anweisungen wie \Macro{captionsngerman} so umdefinieren, dass -zusätzlich zu den bisherigen Begriffen auch die neuen oder geänderten +zusätzlich zu den bisherigen Begriffen auch die neuen oder geänderten definiert werden. Erschwert wird dieses Vorhaben dadurch, dass beim Laden eines Pakets wie \Package{german}\IndexPackage{german} oder \Package{ngerman}\IndexPackage{ngerman} diese Anweisungen von den Paketen erneut definiert werden. Bei den genannten Paketen geschieht dies leider in -einer Form, die alle zuvor gemachten Änderungen zunichte macht. Aus diesem -Grund ist es sinnvoll, die Änderungen mit Hilfe von \Macro{AtBeginDocument} bis +einer Form, die alle zuvor gemachten Änderungen zunichte macht. Aus diesem +Grund ist es sinnvoll, die Änderungen mit Hilfe von \Macro{AtBeginDocument} bis \Macro{begin}\PParameter{document}, also bis nach dem Laden aller Pakete, zu -verzögern. +verzögern. \iftrue Auch der Anwender muss entweder von \Macro{AtBeginDocument} -Gebrauch machen oder aber seine Änderungen nicht in die Dokumentpräambel, -sondern hinter \Macro{begin}\PParameter{document} einfügen. +Gebrauch machen oder aber seine Änderungen nicht in die Dokumentpräambel, +sondern hinter \Macro{begin}\PParameter{document} einfügen. \fi -Darüber hinaus kommt erschwerend hinzu, dass einige Pakete zusätzliche, -sprachabhängige Begriffe in \Macro{captions\PName{Sprache}} definieren, -während andere dafür \Macro{extras\PName{Sprache}} verwenden. So muss der +Darüber hinaus kommt erschwerend hinzu, dass einige Pakete zusätzliche, +sprachabhängige Begriffe in \Macro{captions\PName{Sprache}} definieren, +während andere dafür \Macro{extras\PName{Sprache}} verwenden. So muss der Anwender sich schon sehr genau auskennen, um die richtige Anweisung auf die -richtige Weise zu ergänzen. +richtige Weise zu ergänzen. -Das Paket \Package{scrbase} bietet dem Anwender daher für die Definition und -Änderung selbst einige zusätzliche Anweisungen, die ihn von vielen dieser -Überlegungen entlasten. Gleichzeitig erlauben diese Befehle, die -sprachabhängigen Begriffe mehrerer Dialekte oder Ausprägungen einer Sprache -gleichzeitig zu definieren oder zu ändern. +Das Paket \Package{scrbase} bietet dem Anwender daher für die Definition und +Änderung selbst einige zusätzliche Anweisungen, die ihn von vielen dieser +Ãœberlegungen entlasten. Gleichzeitig erlauben diese Befehle, die +sprachabhängigen Begriffe mehrerer Dialekte oder Ausprägungen einer Sprache +gleichzeitig zu definieren oder zu ändern. \begin{Declaration} \Macro{defcaptionname} @@ -1591,9 +1682,9 @@ gleichzeitig zu definieren oder zu ändern. \Macro{renewcaptionname*}% \Parameter{Sprachliste}\Parameter{Begriff}\Parameter{Inhalt} \end{Declaration} -Mit Hilfe dieser vier Anweisungen und ihrer Sternvarianten ist es möglich, -einem \PName{Begriff} in Abhängigkeit der Sprache einen \PName{Inhalt} -zuzuweisen. Mehrere Sprachen können durch Komma voneinander getrennt als +Mit Hilfe dieser vier Anweisungen und ihrer Sternvarianten ist es möglich, +einem \PName{Begriff} in 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. Der \PName{Begriff} ist immer ein Makro. Die Arbeitsweise der Anweisungen @@ -1601,9 +1692,9 @@ unterscheidet sich je nachdem, ob eine Sprache und ein \PName{Begriff} innerhalb der 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 +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 +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 Sprache bereits definiert, so wird er nicht umdefiniert, sondern ebenfalls ein entsprechender Hinweis in @@ -1611,23 +1702,23 @@ die \File{log}-Datei geschrieben. Ist dagegen bei \Macro{newcaptionname} 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 Sprache +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 Sprache definiert, der \PName{Begriff} in dieser Sprache aber noch nicht -vorhanden, so wird er mit dem gewünschten \PName{Inhalt} definiert. Ist der +vorhanden, so wird er mit dem gewünschten \PName{Inhalt} definiert. Ist der \PName{Begriff} in der Sprache bereits vorhanden, so wird eine Fehlermeldung ausgegeben. -Die Anweisung \Macro{renewcaptionname} verhält sich noch einmal anders. Ist +Die Anweisung \Macro{renewcaptionname} verhält sich noch einmal anders. Ist 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. +er auf den gewünschten \PName{Inhalt} umdefiniert. Die\ChangedAt{v3.12}{\Package{scrbase}} Anweisung \Macro{defcaptionname} -definiert einen \PName{Begriff} immer, überschreibt also eventuell vorhandene +definiert einen \PName{Begriff} immer, überschreibt also eventuell vorhandene Definitionen. Wie bei \Macro{providecaptionname} braucht eine angegebene Sprache nicht definiert zu sein. @@ -1636,58 +1727,58 @@ Sprache nicht definiert zu sein. \DescPageRef{scrlttr2-experts.cmd.yourrefname} zu definieren. \begin{Example} - Möchten Sie »Abb.« statt »Abbildung« in den Abbildungsunterschriften, so + Möchten Sie »Abb.« statt »Abbildung« in den Abbildungsunterschriften, so erreichen Sie dies mit: \begin{lstcode} \renewcaptionname{ngerman}{\figurename}{Abb.} \end{lstcode} - Soll dieselbe Änderung nicht nur für \PValue{ngerman}, sondern - auch für die Sprachen \PValue{naustrian} und \PValue{nswissgerman}, also für - Österreichisch und Schweizer Deutsch gelten, so ist + Soll dieselbe Änderung nicht nur für \PValue{ngerman}, sondern + auch für die Sprachen \PValue{naustrian} und \PValue{nswissgerman}, also für + Österreichisch und Schweizer Deutsch gelten, so ist es nicht notwendig zwei weitere Anweisungen: \begin{lstcode} \renewcaptionname{naustrian}{\figurename}{Abb.} \renewcaptionname{nswissgerman}{\figurename}{Abb.} \end{lstcode} - hinzuzufügen. Stattdessen kann einfach, die \PName{Sprachliste} erweitert + hinzuzufügen. Stattdessen kann einfach, die \PName{Sprachliste} erweitert werden: \begin{lstcode} \renewcaptionname{ngerman,naustrian,nswissgerman}% {\figurename}{Abb.} \end{lstcode} - In gleicher Weise können auch \PValue{german}, \PValue{austrian} und - \PValue{swissgerman}, also Deutsch, Österreichisch und Schweizer Deutsch - nach der veralteten Rechtschreibung, hinzugefügt werden. + In gleicher Weise können auch \PValue{german}, \PValue{austrian} und + \PValue{swissgerman}, also Deutsch, Österreichisch und Schweizer Deutsch + nach der veralteten Rechtschreibung, hinzugefügt werden. \end{Example} \begin{Explain} - Die Sprachen \PValue{swissgerman} und \PValue{nswissgerman} werden übrigens - von älteren Versionen von \Package{babel} noch nicht unterstützt. Sie sind - erst seit Dezember~2013 Bestandteil des deutschen Sprachpakets für - \Package{babel}. Für die Anweisungen \Macro{defcaptionname}, + Die Sprachen \PValue{swissgerman} und \PValue{nswissgerman} werden übrigens + von älteren Versionen von \Package{babel} noch nicht unterstützt. Sie sind + erst seit Dezember~2013 Bestandteil des deutschen Sprachpakets für + \Package{babel}. Für die Anweisungen \Macro{defcaptionname}, \Macro{newcaptionname} und \Macro{providecaptionname} spielt dies kaum eine - Rolle, da diese auch Begriffe für nicht existierende Sprachen definieren - können. Da mit \Macro{renewcaptionname} jedoch nur existierende Begriffe von - existierenden Sprachen umdefiniert werden können, resultiert die - Umdefinierung für \Option{nswissgerman} und \Option{swissgerman} bei - Verwendung einer älteren Version von \Package{babel} in einer entsprechenden + Rolle, da diese auch Begriffe für nicht existierende Sprachen definieren + können. Da mit \Macro{renewcaptionname} jedoch nur existierende Begriffe von + existierenden Sprachen umdefiniert werden können, resultiert die + Umdefinierung für \Option{nswissgerman} und \Option{swissgerman} bei + Verwendung einer älteren Version von \Package{babel} in einer entsprechenden Fehlermeldung. \end{Explain} 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 +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 +ist. Die neuen Sternvarianten der Befehle verwenden grundsätzlich \Macro{extras\PName{Sprache}}, da dessen Definitionen in der Regel nach \Macro{captions\PName{Sprache}} Anwendung finden. 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. +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 +In \autoref{tab:scrbase.commonNames} ist ein Ãœberblick über die üblicherweise von Klassen und Sprachpaketen definierten Begriffe und deren Verwendung zu finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere Begriffe. Siehe dazu \autoref{sec:scrlttr2-experts.languages} ab @@ -1696,44 +1787,44 @@ finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere \begin{desclist} \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}% \desccaption[{% - Überblick über übliche sprachabhängige Begriffe% + Ãœberblick über übliche sprachabhängige Begriffe% }]{% - Überblick über sprachabhängige Begriffe in den üblichen + Ãœberblick über sprachabhängige Begriffe in den üblichen Sprachpaketen\label{tab:scrbase.commonNames}% }{% - Überblick über übliche sprachabhängige Begriffe + Ãœberblick über übliche sprachabhängige Begriffe (\emph{Fortsetzung})% }% \entry{\Macro{abstractname}}{% - Überschrift für die Zusammenfassung% + Ãœberschrift für die Zusammenfassung% \IndexCmd{abstractname}% }% \entry{\Macro{alsoname}}{% - »Siehe auch« bei ergänzenden Verweisen im Stichwortverzeichnis% + »Siehe auch« bei ergänzenden Verweisen im Stichwortverzeichnis% \IndexCmd{alsoname}% }% \entry{\Macro{appendixname}}{% - »Anhang« in der Kapitelüberschrift eines Anhangs% + »Anhang« in der Kapitelüberschrift eines Anhangs% \IndexCmd{appendixname}% }% \entry{\Macro{bibname}}{% - Überschrift für das Literaturverzeichnis% + Ãœberschrift für das Literaturverzeichnis% \IndexCmd{bibname}% }% \entry{\Macro{ccname}}{% - Spitzmarke für den Verteiler in Briefen% + Spitzmarke für den Verteiler in Briefen% \IndexCmd{ccname}% }% \entry{\Macro{chaptername}}{% - »Kapitel« in der Kapitelüberschrift% + »Kapitel« in der Kapitelüberschrift% \IndexCmd{chaptername}% }% \entry{\Macro{contentsname}}{% - Überschrift für das Inhaltsverzeichnis% + Ãœberschrift für das Inhaltsverzeichnis% \IndexCmd{contentsname}% }% \entry{\Macro{enclname}}{% - Spitzmarke für die Anlagen bei Briefen% + Spitzmarke für die Anlagen bei Briefen% \IndexCmd{enclname}% }% \entry{\Macro{figurename}}{% @@ -1741,35 +1832,35 @@ finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere \IndexCmd{figurename}% }% \entry{\Macro{glossaryname}}{% - Überschrift für das Glossar% + Ãœberschrift für das Glossar% \IndexCmd{glossaryname}% }% \entry{\Macro{headtoname}}{% - »An« im Briefkopf% + »An« im Briefkopf% \IndexCmd{headtoname}% }% \entry{\Macro{indexname}}{% - Überschrift für das Stichwortverzeichnis% + Ãœberschrift für das Stichwortverzeichnis% \IndexCmd{indexname}% }% \entry{\Macro{listfigurename}}{% - Überschrift für das Abbildungsverzeichnis% + Ãœberschrift für das Abbildungsverzeichnis% \IndexCmd{listfigurename}% }% \entry{\Macro{listtablename}}{% - Überschrift für das Tabellenverzeichnis% + Ãœberschrift für das Tabellenverzeichnis% \IndexCmd{listtablename}% }% \entry{\Macro{pagename}}{% - »Seite« in der Seitennummer von Briefen% + »Seite« in der Seitennummer von Briefen% \IndexCmd{pagename}% }% \entry{\Macro{partname}}{% - »Teil« in der Teileüberschrift% + »Teil« in der Teileüberschrift% \IndexCmd{partname}% }% \entry{\Macro{prefacename}}{% - Überschrift für das Vorwort% + Ãœberschrift für das Vorwort% \IndexCmd{prefacename}% }% \entry{\Macro{proofname}}{% @@ -1777,15 +1868,15 @@ finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere \IndexCmd{proofname}% }% \entry{\Macro{refname}}{% - Überschrift für das Quellenverzeichnis% + Ãœberschrift für das Quellenverzeichnis% \IndexCmd{refname}% }% \entry{\Macro{seename}}{% - »Siehe« bei Verweisen im Stichwortverzeichnis% + »Siehe« bei Verweisen im Stichwortverzeichnis% \IndexCmd{seename}% }% \entry{\Macro{tablename}}{% - Spitzmarke in der Tabellenunter- bzw. "~überschrift% + Spitzmarke in der Tabellenunter- bzw. "~überschrift% \IndexCmd{tablename}% }% \end{desclist} @@ -1798,9 +1889,9 @@ finden.\iffree{}{ \KOMAScript{} selbst definiert noch einige weitere \section{Identifikation von \KOMAScript} \seclabel{identify} -Obwohl -- oder gerade weil -- \Package{scrbase} ganz allgemein als Paket für -Klassen- und Paketautoren konzipiert ist, wird es natürlich von den -\KOMAScript-Klassen und den meisten \KOMAScript-Paketen verwendet. Es enthält +Obwohl -- oder gerade weil -- \Package{scrbase} ganz allgemein als Paket für +Klassen- und Paketautoren konzipiert ist, wird es natürlich von den +\KOMAScript-Klassen und den meisten \KOMAScript-Paketen verwendet. Es enthält daher auch zwei Anweisungen, die in allen \KOMAScript-Klassen und allen grundlegenden \KOMAScript-Paketen vorhanden sind. @@ -1808,13 +1899,13 @@ grundlegenden \KOMAScript-Paketen vorhanden sind. \begin{Declaration} \Macro{KOMAScript} \end{Declaration} -Diese Anweisung setzt schlicht die Wortmarke »\KOMAScript« in serifenloser +Diese Anweisung setzt schlicht die Wortmarke »\KOMAScript« in serifenloser Schrift und mit leichter Sperrung des in Versalien gesetzten -Teils. \Macro{KOMAScript} wird übrigens bei Bedarf von allen +Teils. \Macro{KOMAScript} wird übrigens bei Bedarf von allen \KOMAScript-Klassen und "~Paketen definiert. Die Definition erfolgt mit \Macro{DeclareRobustCommand}. Da auch Pakete, die nicht zu \KOMAScript{} -gehören, diese Wortmarke definieren können, sollte man die Anweisung jedoch -nicht als Indiz für die Verwendung eines \KOMAScript-Pakets verstehen.% +gehören, diese Wortmarke definieren können, sollte man die Anweisung jedoch +nicht als Indiz für die Verwendung eines \KOMAScript-Pakets verstehen.% \EndIndexGroup @@ -1822,23 +1913,23 @@ nicht als Indiz für die Verwendung eines \KOMAScript-Pakets verstehen.% \Macro{KOMAScriptVersion} \end{Declaration} Bei \KOMAScript{} ist in dieser Anweisung die Hauptversion von \KOMAScript{} -in der Form »\PName{Datum} \PName{Version} \texttt{KOMA-Script}« -abgelegt. Diese Hauptversion ist für alle \KOMAScript-Klassen und alle +in der Form »\PName{Datum} \PName{Version} \texttt{KOMA-Script}« +abgelegt. Diese Hauptversion ist für alle \KOMAScript-Klassen und alle \KOMAScript-Pakete, die von den Klassen verwendet werden, gleich. Daher kann sie auch nach dem Laden von \Package{scrbase} abgefragt werden. Diese Anleitung wurde beispielsweise mit der \KOMAScript-Version -»\KOMAScriptVersion« erstellt. Das Vorhandensein dieser Anweisung ist ein -starkes Indiz dafür, dass zumindest ein \KOMAScript-Paket verwendet wird.% +»\KOMAScriptVersion« erstellt. Das Vorhandensein dieser Anweisung ist ein +starkes Indiz dafür, dass zumindest ein \KOMAScript-Paket verwendet wird.% \EndIndexGroup \section{Erweiterungen des \LaTeX-Kerns} \seclabel{latexkernel} -In einigen Fällen stellt der \LaTeX-Kern selbst Anweisungen zur Verfügung, -lässt aber ganz ähnliche Anweisungen, die ebenfalls häufiger benötigt werden +In einigen Fällen stellt der \LaTeX-Kern selbst Anweisungen zur Verfügung, +lässt aber ganz ähnliche Anweisungen, die ebenfalls häufiger benötigt werden oder eigentlich nahe liegen, vermissen. Einige wenige solcher Anweisungen -für Klassen- und Paketautoren stellt \Package{scrbase} zur Verfügung. +für Klassen- und Paketautoren stellt \Package{scrbase} zur Verfügung. \begin{Declaration} \Macro{ClassInfoNoLine}\Parameter{Klassenname}\Parameter{Information} @@ -1863,28 +1954,28 @@ von \Package{scrbase} bereit gestellt. \end{Declaration}% Der \LaTeX-Kern bietet mit \Macro{g@addto@macro} eine interne Anweisung, um die Definition eines Makro \PName{Anweisung} global um den Code -\PName{Erweiterung} zu erweitern. Das funktioniert in dieser Form nur für -Makros ohne Argumente. Dennoch könnte man diese Anweisung in einigen Fällen -auch in einer Form benötigen, die lokal zur aktuellen Gruppe arbeitet. Diese +\PName{Erweiterung} zu erweitern. Das funktioniert in dieser Form nur für +Makros ohne Argumente. Dennoch könnte man diese Anweisung in einigen Fällen +auch in einer Form benötigen, die lokal zur aktuellen Gruppe arbeitet. Diese wird mit \Macro{l@addto@macro} von \Package{scrbase} bereit gestellt. Eine Alternative stellt hier die Verwendung des Pakets \Package{etoolbox}\IndexPackage{etoolbox} oder \Package{xpatch}\IndexPackage{xpatch} dar, das eine ganze Reihe solcher -Anweisungen für unterschiedliche Zwecke bietet (siehe +Anweisungen für unterschiedliche Zwecke bietet (siehe \cite{package:etoolbox} beziehungsweise \cite{package:xpatch}). % \EndIndexGroup -\section{Erweiterungen der mathematischen Fähigkeiten von \eTeX} +\section{Erweiterungen der mathematischen Fähigkeiten von \eTeX} \seclabel{etex} -Das für \LaTeX{} inzwischen verwendete und von \KOMAScript{} vorausgesetzte -\eTeX{} besitzt mit \Macro{numexpr}\IndexCmd{numexpr} erweiterte Möglichkeiten -zur Berechnung einfacher Ausdrücke mit \TeX-Zählern und ganzen Zahlen. Als +Das für \LaTeX{} inzwischen verwendete und von \KOMAScript{} vorausgesetzte +\eTeX{} besitzt mit \Macro{numexpr}\IndexCmd{numexpr} erweiterte Möglichkeiten +zur Berechnung einfacher Ausdrücke mit \TeX-Zählern und ganzen Zahlen. Als Operationen werden dabei die vier Grundrechenarten und Klammern -unterstützt. Bei der Division wird korrekt gerundet. Manchmal sind weitere -Operationen nützlich. +unterstützt. Bei der Division wird korrekt gerundet. Manchmal sind weitere +Operationen nützlich. \begin{Declaration} \Macro{XdivY}\Parameter{Dividend}\Parameter{Divisor} @@ -1901,29 +1992,269 @@ Rests der Division mit Rest. Diese Art der Division ist nach der Gleichung \] % definiert, wobei \textit{Dividend}, \textit{Divisor} und \textit{Rest} ganze -Zahlen und \textit{Rest} außerdem größer oder gleich 0 und kleiner als -\textit{Divisor} ist. Der \textit{Divisor} ist eine natürliche Zahl (ohne die +Zahlen und \textit{Rest} außerdem größer oder gleich 0 und kleiner als +\textit{Divisor} ist. Der \textit{Divisor} ist eine natürliche Zahl (ohne die 0). -Der Wert kann jeweils zur Zuweisung an einen Zähler oder direkt innerhalb +Der Wert kann jeweils zur Zuweisung an einen Zähler oder direkt innerhalb eines Ausdrucks mit \Macro{numexpr}\IndexCmd{numexpr} verwendet werden. Zur Ausgabe als arabische Zahl ist \Macro{the} voranzustellen.% % \EndIndexGroup + + +\section[{Allgemeiner Mechanismus für mehrstufige Haken}] +{Allgemeiner Mechanismus für mehrstufige + Haken\ChangedAt[2019/01]{v3.27}{\Package{scrbase}}} +\seclabel{hooks} + +\BeginIndexGroup +\BeginIndex{}{Haken} +Der \LaTeX-Kern bietet selbst bereits einige wenige Stellen in der +Verarbeitung eines Dokuments, an denen die Ausführung zusätzlichen Codes +\emph{eingehakt} werden kann. Klassen- und Paketautoren dürften +\Macro{AtBeginDocument} und \Macro{AtEndDocument} bestens bekannt +sein. \KOMAScript{} bietet an einigen Stellen vergleichbares, beispielsweise +um Code in die Ausführung von +\hyperref[sec:maincls.structure]{Gliederungsbefehlen} einzuhaken. Ãœber die +Jahre zeigten sich dabei zwei Probleme: +\begin{itemize} +\item Es gibt nie genug Haken. +\item Es gibt sowohl Code, der nur einmal ausgeführt werden soll, also quasi + bei seiner Ausführung wieder vom Haken fällt, als auch Code, der bei jedem + Durchlaufen des Hakens auszuführen ist, also dauerhaft auf dem Haken bleibt. +\end{itemize} +Ãœblicherweise muss man zur Definition eines einzelnen Hakens eine Anweisung +definieren, mit der Code für den jeweiligen Haken aufgesammelt wird. Dieser +Code wird dann in einem weiteren internen Makro abgelegt, das man an der +Stelle einfügen muss, an der der aufgesammelte Code auszuführen ist. Je mehr +Haken man einfügt, desto mehr solcher Anweisungen gibt es. Um sowohl +Einmalcode als auch dauerhaften Code zu ermöglichen, benötigt es gegebenfalls +sogar zwei Haken und damit die doppelte Anzahl an zu definierenden +Anweisungen. + +Das Beispiel der Gliederungsbefehle zeigt, dass sich das erste Problem +teilweise an einem einzigen Codeausführungspunkt noch verschärfen kann. Hier +benötigt der eine Paketautor lediglich eine Möglichkeit für alle +Gliederungsbefehle denselben Code auszuführen. Ein anderer Paketautor hätte +lieber, dass er nur bei bestimmten Gliederungsbefehlen unterschiedlichen Code +ausführen kann. Es würde also sowohl ein allgemeiner Haken als auch ein Haken +je Gliederungsbefehl benötigt. Das ganze dann wieder wegen des zweiten +Problems verdoppelt. + +\KOMAScript{} bietet in \Package{scrbase} daher einen verallgemeinerten +Hakenmechanismus, der mehrstufige Haken sowohl für Einmalcode als auch für +dauerhaften Code bereitstellt. Diese Haken haben aufgrund der Implementierung +den Namen \emph{do-hook} erhalten. Davon leitet sich auch der Name der +Anweisungen ab, mit denen sie gesteuert werden. + +\begin{Declaration} + \Macro{ExecuteDoHook}\Parameter{Spezifikator} +\end{Declaration} +Ãœber\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} diese Anweisung werden Haken +implementiert. Dabei bestimmt der \PName{Spezifikator} den Namen des oder +genauer der Haken. Der \PName{Spezifikator} wird zur Analyse immer vollständig +expandiert. + +Der \PName{Spezifikator} besteht allgemein aus durch Querstrichen, +»\texttt{/}«, voneinander getrennten Zeichenfolgen. Von \Macro{ExecuteDoHook} +wird dann zunächst die Zeichenfolge vor dem ersten Querstrich +abgetrennt. Diese ist der Name. Der verbleibende Rest (ohne den Querstrich) +ist das Argument. Dann wird der Code für den Haken mit diesem Namen +ausgeführt. Anschließend wird erneut die vordere Zeichenfolge vom Rest +abgetrennt und mit einem Querstrich hinten an den Namen angefügt und der Code +für den so neu gebildeten Namen ausgeführt. Das geht so lange, bis der Code +für den Haken mit dem Namen \PName{Spezifikator} und leerem Argument +ausgeführt wurde. + +Im einfachsten Fall besteht der \PName{Spezifikator} aus einem einzelnen +Namen. In diesem Fall wird zunächst der dauerhafte Code für genau einen durch +diesen Namen festgelegten Haken mit leerem Argument ausgeführt. + +In jeder Stufe der Ausführung wird nach dem dauerhaften Code für einen Haken +zusätzlich Einmalcode ausgeführt, bevor der Einmalcode global vom Haken +genommen wird. + +\begin{Example} + Durch Einfügen von \DescRef{\LabelBase.cmd.ExecuteDoHook}% + \PParameter{heading/begingroup/\PName{Name}} in die Ausführung eines jeden + mit \DescRef{maincls-experts.cmd.DeclareSectionCommand} definierten + Gliederungbefehls wurden in den \KOMAScript-Klassen letztlich sechs Haken an + diesem Codepunkt eingefügt, die in dieser Reihenfolge ausgeführt werden: + \begin{enumerate} + \item \PValue{heading} mit Argument \PValue{begingroup/}\PName{Name} für + dauerhaften Code, + \item \PValue{heading} mit Argument \PValue{begingroup/}\PName{Name} für + Einmalcode, + \item \PValue{heading/begingroup} mit Argument \PName{Name} für + dauerhaften Code, + \item \PValue{heading/begingroup} mit Argument \PName{Name} für + Einmalcode, + \item \PValue{heading/begingroup/}\PName{Name} mit leerem Argument für + dauerhaften Code, + \item \PValue{heading/begingroup/}\PName{Name} mit leerem Argument für + Einmalcode. + \end{enumerate} + \PName{Name} ist dabei der bei + \DescRef{maincls-experts.cmd.DeclareSectionCommand}, + \DescRef{maincls-experts.cmd.DeclareNewSectionCommand} oder + \DescRef{maincls-experts.cmd.ProvideSectionCommand} angegebene \PName{Name} + der Gliederungsebene beziehungsweise des dadurch bestimmten + Gliederungsbefehls, also beispielsweise \PValue{chapter} oder + \PValue{subparagraph}. Betrachtet man obige Auflistung unter + Berücksichtigung der Tatsache, dass es diverse Gliederungsbefehle gibt, + wird klar, dass die Haken \PValue{heading} und \PValue{heading/begingroup} + mehrfach, nämlich für jeden Gliederungsbefehl existieren.% +\end{Example}% % \EndIndexGroup +\begin{Declaration} + \Macro{AddtoDoHook}\Parameter{Name}\Parameter{Befehl} + \Macro{AddtoOneTimeDoHook}\Parameter{Name}\Parameter{Befehl} +\end{Declaration} +Mit\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} \Macro{AddtoDoHook} wird an +dem Haken mit dem Namen \PName{Name} dauerhafter Code aufgehängt. Als Code +dient dabei der \PName{Befehl}, dem das in der Erklärung zu +\DescRef{\LabelBase.cmd.ExecuteDoHook} erwähnte Argument als Parameter +angehängt wird. +\begin{Example} + Angenommen, es soll innerhalb von \Macro{section} mitgezählt werden, wie oft + diese Anweisung ausgeführt wird. Dies wäre in Fortführung des obigen + Beispiels mit +\begin{lstcode} + \newcounter{sectionZaehler} + \AddtoDoHook{heading/begingroup/section} + {\stepcounter{sectionZaehler}} +\end{lstcode} + sehr einfach möglich. Allerdings würde dann in Wirklichkeit + \Macro{stepcounter}\PParameter{sectionZaehler}\PParameter{} ausgeführt. Wir + erinnern uns daran, dass immer ein Argument als Parameter angehängt wird. + Im Falle des Hakens mit dem Namen \PValue{heading/begingroup/section} ist + dieses Argument leer. Da ein solcher leerer Parameter hier zur einer leeren + Gruppe wird, ist es besser, diesen leeren Parameter quasi aufzubrauchen: +\begin{lstcode} + \newcommand*{\stepcountergobble}[2]{% + \stepcounter{#1}% + } + \AddtoDoHook{heading/begingroup/section} + {\stepcountergobble{sectionZaehler}} +\end{lstcode} + Hier wird der angehängte, leere Parameter von \Macro{stepcountergobble} + gelesen, aber nicht verwendet. + + Sollen nun statt \Macro{section} alle Gliederungsbefehle gezählt werden, so + muss nur ein anderer Hakenname eingesetzt werden: +\begin{lstcode} + \AddtoDoHook{heading/begingroup} + {\stepcountergobble{sectionZaehler}} +\end{lstcode} + Hier ist übrigens der angehängte Parameter nicht leer, sondern enthält den + Namen der Gliederungsebene oder des Gliederungsbefehls. Wollte man die + Gliederungsbefehle einzeln zählen, so könnte man genau dies ausnützen: +\begin{lstcode} + \newcommand*{\stepZaehler}[1]{% + \stepcounter{#1Zaehler}% + } + \AddtoDoHook{heading/begingroup} + {\stepZaehler} +\end{lstcode} + Natürlich müssten dann auch die Zähler \Counter{partZaehler}, + \Counter{chapterZaehler} bis hinunter zu \Counter{subparagraphZaehler} + definiert werden. +\end{Example} + +Die Anweisung \Macro{AddtoOneTimeDoHook} arbeitet vergleichbar, fügt den +\PName{Befehl} aber dem Einmalcode hinzu. Dieser Code wird dann nach der +ersten Ausführung global vom Haken genommen.% +\EndIndexGroup + +\begin{Declaration} + \Macro{ForDoHook}\Parameter{Spezifikator}\Parameter{Befehl} +\end{Declaration} +Während\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} +\DescRef{\LabelBase.cmd.ExecuteDoHook} dazu gedacht ist, die Befehle +auszuführen, die zuvor mit \DescRef{\LabelBase.cmd.AddtoDoHook} oder +\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} für die durch den +\PName{Spezifikator} bestimmten Haken gespeichert wurden, führt diese Anweisung +den unmittelbar angegebenen \PName{Befehl} aus. Dabei werden an \PName{Befehl} +sogar zwei Parameter angefügt. Der erste Parameter ist der Name des Haken, der +zweite das Argument des Hakens. + +Diese Anweisung ist ein Abfallprodukt der Implementierung von +\DescRef{\LabelBase.cmd.ExecuteDoHook}. Normalerweise sollten weder Anwender +noch Paketautoren diese Anweisung benötigen.% +\EndIndexGroup + +\begin{Declaration} + \Macro{SplitDoHook}\Parameter{Spezifikator}\Parameter{Kopf-Makro} + \Parameter{Rest-Makro} +\end{Declaration} +Wie\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} aus den vorangegangenen +Erklärungen deutlich wird, kann der Parameter eines mit +\DescRef{\LabelBase.cmd.AddtoDoHook} oder +\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} hinzugefügten \PName{Befehls} +ebenfalls ein mehrteiliger \PName{Spezifikator} sein. Mit \Macro{SplitDoHook} +kann so ein \PName{Spezifikator} in das vordere Element und den Rest +aufgeteilt werden. Das \PName{Kopf-Makro} wird dabei als das vordere Element +definiert. Das \PName{Rest-Makro} wird als der Rest definiert. Im Falle, dass +kein Rest bleibt, wird das \PName{Rest-Makro} leer definiert. Falls bereits der +\PName{Spezifikator} leer war, wird eine Warnung ausgegeben und sowohl +\PName{Kopf-Makro} als auch \PName{Rest-Makro} leer definiert. + +\begin{Example} + Wollte man am Anfang der Gruppe, in der die Ãœberschrift ausgegeben wird, + einen Zähler erhöhen, diesen am Ende aber wieder verringern, so könnte man + dies über zwei Haken tun: +\begin{lstcode} + \AddtoDoHook{heading/begingroup} + {\stepZaehler} + \newcommand*{\restepZaehler}[1]{% + \addtocounter{#1Zaehler}{-1}% + } + \AddtoDoHook{heading/endgroup} + {\restepcounter} +\end{lstcode} + Man könnte aber auch mit einem einzigen Haken arbeiten und dessen Parameter + zerlegen: +\begin{lstcode} + \newcommand*{\changeZaehler}[1]{% + \SplitDoHook{#1}{\Gruppe}{\Ebene}% + \ifstr{\Gruppe}{begingroup}{% + \stepcounter{\Ebene Zaehler}% + }{% + \ifstr{\Gruppe}{endgroup}{% + \addtocounter{\Ebene Zaehler}{-1}% + }{}% + }% + } + \AddtoDoHook{heading} + {\changeZaehler} +\end{lstcode} + Wie zu sehen ist, ist die erste Lösung um einiges einfacher. Dazu kommt, + dass man die zweite Fallunterscheidung in der zweiten Lösung gerne + vergisst. Das wäre allerdings fatal, da es weitere Haken mit Namen + \PValue{heading} aber abweichendem Argument geben kann. +\end{Example} + +Genau genommen ist diese Anweisung ein Abfallprodukt aus der Implementierung +von \DescRef{\LabelBase.cmd.ForDoHook}.% +\EndIndexGroup +% +\EndIndexGroup +\EndIndexGroup + \endinput %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide.tex" %%% End: -% LocalWords: Paketoptionen Familienmitglieder Familienmitglieds Säumniswert +% LocalWords: Paketoptionen Familienmitglieder Familienmitglieds Säumniswert % LocalWords: Fleischermeister FamilyProcessOptions ProcessOption keyval Cmd % LocalWords: documentclass ProcessOptions FamilyExecuteOptions currname % LocalWords: Optionenliste ExecuteOptions DeclareOption currext Wurstsalat @@ -1931,7 +2262,7 @@ Ausgabe als arabische Zahl ist \Macro{the} voranzustellen.% % LocalWords: Wurstpaket FamilyOption salatmit SalatZusatz scrbase false % LocalWords: AtEndOfFamilyOptions FamilyBoolKey FamilySetBool Schaltername % LocalWords: FamilyLengthKey FamilySetLength FamilyLengthMacroKey -% LocalWords: FamilySetLengthMacro Wertübergabe Gliederungsbefehlen +% LocalWords: FamilySetLengthMacro Wertübergabe Gliederungsbefehlen % LocalWords: Sternvariante Anwenderanweisungen Signalisierung Paketautoren -% LocalWords: Familienschlüssel Mitgliederschlüssels Vergleichszustand -% LocalWords: Benutzeräquivalent Dokumentpräambel voranzustellen +% LocalWords: Familienschlüssel Mitgliederschlüssels Vergleichszustand +% LocalWords: Benutzeräquivalent Dokumentpräambel voranzustellen diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle-experts.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle-experts.tex index 410c320f04..b947969971 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrbookreportarticle-experts.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -41,44 +41,50 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrbook, scrreprt und scrartcl im Experten-Teil der +% Kapitel über scrbook, scrreprt und scrartcl im Experten-Teil der % KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex}% - [$Date: 2018-10-14 20:31:51 +0200 (Sun, 14 Oct 2018) $ + [$Date: 2019-10-09 16:34:25 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] -\chapter[{Zusätzliche Informationen zu den Hauptklassen und - \Package{scrextend}}]{Zusätzliche +\chapter[{Zusätzliche Informationen zu den Hauptklassen und + \Package{scrextend}}]{Zusätzliche Informationen zu den Hauptklassen \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} sowie dem Paket \Package{scrextend}} \labelbase{maincls-experts} -\BeginIndexGroup \BeginIndex{Class}{scrartcl} \BeginIndex{Class}{scrbook} -\BeginIndex{Class}{scrreprt} \BeginIndex{Package}{scrextend} In diesem Kapitel -finden Sie zusätzliche Informationen zu den \KOMAScript-Klassen -\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} und einigen -Anweisungen, die auch in \Package{scrextend} vorhanden sind. \iffree{Einige - Teile des Kapitels sind dabei dem \KOMAScript-Buch \cite{book:komascript} - vorbehalten. Dies sollte kein Problem sein, denn der}{Der} normale Anwender, -der die Klassen einfach nur verwenden will, wird diese Informationen eher -selten benötigen. Ein Teil der Informationen richtet sich an Anwender, die -ausgefallene Aufgaben lösen oder eigene Klassen schreiben wollen, die auf -einer \KOMAScript-Klasse basieren. Anderes existiert nur aus Gründen der -Kompatibilität zu den Standardklassen\iffree{ oder früheren Versionen von - \KOMAScript}{}.\iffree{}{ Teile, die nur aus Gründen der - Kompatibilität zu früheren Versionen von \KOMAScript{} existieren, sind in - serifenloser Schrift gesetzt und sollten nicht mehr verwendet werden.} +\BeginIndexGroup% +\BeginIndex{Class}{scrartcl}% +\BeginIndex{Class}{scrbook}% +\BeginIndex{Class}{scrreprt}% +\BeginIndex{Package}{scrextend}% +In diesem Kapitel finden Sie zusätzliche Informationen zu den +\KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} und +einigen Anweisungen, die auch in \Package{scrextend} vorhanden sind. +\iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch + \cite{book:komascript} vorbehalten. Dies sollte kein Problem sein, denn + der}{Der} normale Anwender, der die Klassen einfach nur verwenden will, wird +diese Informationen eher selten benötigen. Ein Teil der Informationen richtet +sich an Anwender, die ausgefallene Aufgaben lösen oder eigene Klassen +schreiben wollen, die auf einer \KOMAScript-Klasse basieren. Da sich die +entsprechenden Erklärungen ausdrücklich nicht an \LaTeX-Anfänger richtet, sind +sie teilweise deutlich kürzer gefasst und setzen ein vertieftes Wissen über +\LaTeX{} voraus. Anderes existiert nur aus Gründen der Kompatibilität zu den +Standardklassen\iffree{ oder früheren Versionen von \KOMAScript}{}.\iffree{}{ + Teile, die nur aus Gründen der Kompatibilität zu früheren Versionen von + \KOMAScript{} existieren, sind in serifenloser Schrift gesetzt und sollten + nicht mehr verwendet werden.} \LoadNonFree{scrbookreportarticle-experts}{0} -\section{Ergänzungen zu Benutzeranweisungen} +\section{Ergänzungen zu Benutzeranweisungen} \seclabel{addInfos} \LoadNonFree{scrbookreportarticle-experts}{1} @@ -90,17 +96,14 @@ Kompatibilität zu den Standardklassen\iffree{ oder früheren Versionen von \LoadNonFree{scrbookreportarticle-experts}{2} -\section{Anweisungen für Experten} -\seclabel{experts} +\section{Erkennung von \KOMAScript-Klassen} +\seclabel{identify} -In diesem Abschnitt werden Anweisungen beschrieben, die für den normalen -Anwender kaum oder gar nicht von Interesse sind. Experten bieten diese -Anweisungen zusätzliche Möglichkeiten. Da die Beschreibungen für Experten -gedacht sind, sind sie kürzer gefasst. - - -% \subsection{Identifikation} -% \seclabel{identification} +Für Paketautoren besteht manchmal die Notwendigkeit, eine \KOMAScript-Klasse +zu erkennen. Für Anwender besteht diese Notwendigkeit dagegen eher +nicht. Bezüglich der verwendeten \KOMAScript-Version sei auf +\DescRef{scrbase.cmd.KOMAScriptVersion} in \autoref{sec:scrbase.identify}, +\DescPageRef{scrbase.cmd.KOMAScriptVersion} verwiesen. \begin{Declaration} \Macro{KOMAClassName} @@ -109,50 +112,57 @@ gedacht sind, sind sie kürzer gefasst. In \Macro{KOMAClassName} ist der Name der aktuell verwendeten \KOMAScript-Klasse abgelegt. Will man also wissen, ob eine oder welche \KOMAScript-Klasse verwendet wird, so kann man einfach auf diese Anweisung -testen. Demgegenüber gibt \Macro{ClassName} Auskunft, welche Standardklasse +testen. Demgegenüber gibt \Macro{ClassName} Auskunft, welche Standardklasse durch diese \KOMAScript-Klasse ersetzt wird. Es\textnote{Achtung!} sei in diesem Zusammenhang darauf hingewiesen, dass dagegen die Existenz von -\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} nicht als Indiz für die +\DescRef{scrbase.cmd.KOMAScript}\IndexCmd{KOMAScript} nicht als Indiz für die Verwendung einer \KOMAScript-Klasse dienen kann. Zum einen definieren alle -\KOMAScript-Pakete diese Anweisung, zum anderen können auch andere Pakete es -für sinnvoll erachten, das \KOMAScript-Piktogramm unter diesem Namen zu +\KOMAScript-Pakete diese Anweisung, zum anderen können auch andere Pakete es +für sinnvoll erachten, das \KOMAScript-Piktogramm unter diesem Namen zu definieren.% \EndIndexGroup -% \subsection{Einträge ins Inhaltsverzeichnis} -% \seclabel{toc} +\section{Einträge ins Inhaltsverzeichnis} +\seclabel{toc} + +\KOMAScript-Klassen bieten erweiterte Möglichkeiten zur Erstellung und +Manipulation von Einträgen in das Inhaltsverzeichnis. Einige davon basieren +auf der Verwendung von \Package{tocbasic} (siehe +\autoref{sec:tocbasic.tocstyle} ab +\autopageref{sec:tocbasic.tocstyle}). Andere sind direkt in den Klassen +implementiert. \begin{Declaration} \Macro{addtocentrydefault}\Parameter{Ebene}\Parameter{Nummer}% - \Parameter{Überschrift} + \Parameter{Ãœberschrift} \end{Declaration} Die\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} \KOMAScript-Klassen verwenden \Macro{addcontentsline}\IndexCmd{addcontentsline}% -\important{\Macro{addcontentsline}} nicht direkt, um Einträge ins +\important{\Macro{addcontentsline}} nicht direkt, um Einträge ins Inhaltsverzeichnis vorzunehmen. Stattdessen wird \Macro{addtocentrydefault} -mit ganz ähnlichen Argumenten aufgerufen. Die Anweisung kann sowohl für -nummerierte als auch für nicht nummerierte Einträge verwendet werden. Dabei +mit ganz ähnlichen Argumenten aufgerufen. Die Anweisung kann sowohl für +nummerierte als auch für nicht nummerierte Einträge verwendet werden. Dabei gibt \PName{Ebene} die Gliederungsebene in Textform an, also \PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection}, \PValue{subsubsection}, \PValue{paragraph} oder \PValue{subparagraph}. Die -formatierte Gliederungsnummer wird über das zweite Argument \PName{Nummer} -übergeben. Dieses Argument darf auch leer sein. Der Text des Eintrags wird mit -\PName{Überschrift} angegeben. Zerbrechliche Befehle in +formatierte Gliederungsnummer wird über das zweite Argument \PName{Nummer} +übergeben. Dieses Argument darf auch leer sein. Der Text des Eintrags wird mit +\PName{Ãœberschrift} angegeben. Zerbrechliche Befehle in diesem Argument sind mit -\Macro{protect}\IndexCmd{protect}\important{\Macro{protect}} zu schützen. +\Macro{protect}\IndexCmd{protect}\important{\Macro{protect}} zu schützen. -Für das Argument \PName{Nummer} gilt noch eine Besonderheit. Ist das Argument +Für das Argument \PName{Nummer} gilt noch eine Besonderheit. Ist das Argument leer, so signalisiert dies, dass ein nicht nummerierter Eintrag erzeugt werden soll. In der Voreinstellung wird dies mit \begin{quote}\small\raggedright \Macro{addcontentsline}\PParameter{toc}\Parameter{Ebene}% \PParameter{\%\\ \quad\Macro{protect}\DescRef{tocbasic.cmd.nonumberline} - \PName{Überschrift}\%\\ + \PName{Ãœberschrift}\%\\ } \end{quote} erreicht. Ist das Argument jedoch nicht leer, so soll ein nummerierter Eintrag @@ -162,14 +172,14 @@ der Voreinstellung verwendet \KOMAScript{} dann: \Macro{addcontentsline}\PParameter{toc}\Parameter{Ebene}% \PParameter{\%\\ \quad\Macro{protect}\DescRef{tocbasic.cmd.numberline}\Parameter{Nummer}% - \PName{Überschrift}\%\\ + \PName{Ãœberschrift}\%\\ } \end{quote} \iffalse zur Erzeugung dieses Eintrags.\fi -Paketautoren und Autoren von Wrapper-Klassen können diese Anweisung -umdefinieren, um Einfluss auf die Einträge zu nehmen. So\textnote{Beispiel} -wäre beispielsweise denkbar, mit +Paketautoren und Autoren von Wrapper-Klassen können diese Anweisung +umdefinieren, um Einfluss auf die Einträge zu nehmen. So\textnote{Beispiel} +wäre beispielsweise denkbar, mit \begin{lstcode} \renewcommand{\addtocentrydefault}[3]{% \ifstr{#3}{}{% @@ -182,30 +192,30 @@ wäre beispielsweise denkbar, mit }% }% \end{lstcode} -dafür\IndexCmd{ifstr} zu sorgen, dass Einträge mit leerer \PName{Überschrift} -erst gar nicht vorgenommen werden. Eine solche Änderung ist in der Praxis -jedoch nicht notwendig, da die Unterdrückung leerer Einträge bereits auf +dafür\IndexCmd{ifstr} zu sorgen, dass Einträge mit leerer \PName{Ãœberschrift} +erst gar nicht vorgenommen werden. Eine solche Änderung ist in der Praxis +jedoch nicht notwendig, da die Unterdrückung leerer Einträge bereits auf andere Weise in die \KOMAScript-Klassen eingebaut ist. Siehe hierzu auch die -Erklärung zu den Gliederungsbefehlen in \autoref{sec:maincls.structure} ab +Erklärung zu den Gliederungsbefehlen in \autoref{sec:maincls.structure} ab \DescPageRef{maincls.cmd.part}.% % \EndIndexGroup \begin{Declaration} - \Macro{addparttocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addchaptertocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addsectiontocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addsubsectiontocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addsubsubsectiontocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addparagraphtocentry}\Parameter{Nummer}\Parameter{Überschrift} - \Macro{addsubparagraphtocentry}\Parameter{Nummer}\Parameter{Überschrift} + \Macro{addparttocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addchaptertocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addsectiontocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addsubsectiontocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addsubsubsectiontocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addparagraphtocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} + \Macro{addsubparagraphtocentry}\Parameter{Nummer}\Parameter{Ãœberschrift} \end{Declaration}% Auch \ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} die oben dokumentierte Anweisung \DescRef{\LabelBase.cmd.addtocentrydefault}\IndexCmd{addtocentrydefault}% \important{\DescRef{\LabelBase.cmd.addtocentrydefault}} wird von den -\KOMAScript-Klassen nur dann direkt aufgerufen, wenn für die angegebene +\KOMAScript-Klassen nur dann direkt aufgerufen, wenn für die angegebene \PName{Ebene} keine direkte Anweisung definiert oder diese \Macro{relax}\IndexCmd{relax}\important{\Macro{relax}} ist. In der Voreinstellung sind die angegebenen Anweisungen alle so definiert, dass sie @@ -218,57 +228,62 @@ ihre \PName{Ebene} und die Argumente direkt an \begin{Declaration} \Macro{raggedchapterentry} \end{Declaration} -Bei früheren\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} Version -von \KOMAScript{} gab es die Möglichkeit, das Makro \Macro{raggedchapterentry} -als \Macro{raggedright} zu definieren, um den Text der Kapiteleinträge ins -Inhaltsverzeichnis im linksbündigen Flattersatz zu setzen. Offiziell existiert -diese Möglichkeit seit \KOMAScript-Version~3.21 nicht mehr. +Bei früheren\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} Version +von \KOMAScript{} gab es die Möglichkeit, das Makro \Macro{raggedchapterentry} +als \Macro{raggedright} zu definieren, um den Text der Kapiteleinträge ins +Inhaltsverzeichnis im linksbündigen Flattersatz zu setzen. Offiziell existiert +diese Möglichkeit seit \KOMAScript-Version~3.21 nicht mehr. -Tatsächlich ist aber die Eigenschaft \PValue{raggedentrytext} für den +Tatsächlich ist aber die Eigenschaft \PValue{raggedentrytext} für den Eintrags-Stil \PValue{tocline} im Paket \hyperref[cha:tocbasic]{\Package{tocbasic}}\IndexPackage{tocbasic} so implementiert, dass sie das Makro \Macro{ragged\PName{Eintragsebene}entry} entweder auf \Macro{relax} oder auf \Macro{raggedright} setzt. Bei der Auswertung der Eigenschaft wird dann getestet, ob das entsprechende Makro entweder \Macro{raggedright} ist oder als \Macro{raggedright} definiert -ist. In beiden Fällen wird Flattersatz verwendet. In allen anderen Fällen wird +ist. In beiden Fällen wird Flattersatz verwendet. In allen anderen Fällen wird kein Flattersatz verwendet. -Da schon früher dokumentiert war, dass \Macro{raggedchapterentry} nicht +Da schon früher dokumentiert war, dass \Macro{raggedchapterentry} nicht als etwas anderes als \Macro{raggedright} definiert werden sollte, ist damit -Kompatibilität zum dokumentierten Verhalten früherer Versionen erreicht. Wie -in früheren Versionen gewarnt, führen andere Definitionen von +Kompatibilität zum dokumentierten Verhalten früherer Versionen erreicht. Wie +in früheren Versionen gewarnt, führen andere Definitionen von \Macro{raggedchapterentry} -- nun aber auch von \Macro{raggedsectionentry} und -entsprechend für die anderen Eintragsebenen -- möglicherweise zu unerwarteten +entsprechend für die anderen Eintragsebenen -- möglicherweise zu unerwarteten Ergebnissen. -Empfohlen wird, eventuell gewünschten Flattersatz für Verzeichniseinträge -stattdessen über die genannte Eigenschaft des Verzeichniseintragsstils -\PValue{tocline} zu wählen.% +Empfohlen wird, eventuell gewünschten Flattersatz für Verzeichniseinträge +stattdessen über die genannte Eigenschaft des Verzeichniseintragsstils +\PValue{tocline} zu wählen.% \EndIndexGroup -% \subsection{Schrifteinstellungen} -% \seclabel{fonts} +\section{Schrifteinstellungen} +\seclabel{fonts} + +\KOMAScript-Klassen verfügen nicht nur über erweiterte Möglichkeiten zur +Auswahl der Grundschriftgröße. Sie erlauben auch die Definition von Elementen +mit eigenen Schrifteinstellungen, sowie deren Manipulation und dedizierter +Anwendung. \begin{Declaration} \Macro{@fontsizefilebase} - \Macro{changefontsizes}\Parameter{Schriftgröße} + \Macro{changefontsizes}\Parameter{Schriftgröße} \end{Declaration} Der\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} auf -\DescPageRef{maincls-experts.option.fontsize} für die Schriftgrößendateien -angegebene Präfix \File{scrsize}, ist lediglich die Voreinstellung für das +\DescPageRef{maincls-experts.option.fontsize} für die Schriftgrößendateien +angegebene Präfix \File{scrsize}, ist lediglich die Voreinstellung für das interne Makro \Macro{@fontsizefilebase}\IndexCmd{@fontsizefilebase}, die verwendet wird, wenn das Makro beim Laden der Klasse oder des Pakets \Package{scrextend} noch nicht definiert ist. Autoren von Wrapper-Klassen -können dieses Makro abweichend definieren, um andere Schriftgrößendateien zu -verwenden. Ebenso\textnote{Tipp!} können Autoren von Wrapper-Klassen die -\emph{fallback}-Lösung der berechneten Schriftgrößen dadurch ändern oder +können dieses Makro abweichend definieren, um andere Schriftgrößendateien zu +verwenden. Ebenso\textnote{Tipp!} können Autoren von Wrapper-Klassen die +\emph{fallback}-Lösung der berechneten Schriftgrößen dadurch ändern oder abschalten, dass sie das Makro \Macro{changefontsizes}\important{\Macro{changefontsizes}}, das als Argument -die gewünschte \PName{Schriftgröße} erwartet, umdefinieren. Das +die gewünschte \PName{Schriftgröße} erwartet, umdefinieren. Das Makro\textnote{Achtung!} \Macro{changefontsizes} ist jedoch nicht als -Anweisung für den Aufruf durch Anwender konzipiert.% +Anweisung für den Aufruf durch Anwender konzipiert.% \EndIndexGroup @@ -277,37 +292,37 @@ Anweisung für den Aufruf durch Anwender konzipiert.% \Parameter{Voreinstellung} \Macro{aliaskomafont}\Parameter{Aliasname}\Parameter{Element} \end{Declaration} -Experten können mit \Macro{newkomafont} eine \PName{Voreinstellung} für die -Schrift eines \PName{Element}s definieren. Anschließend kann diese +Experten können mit \Macro{newkomafont} eine \PName{Voreinstellung} für die +Schrift eines \PName{Element}s definieren. Anschließend kann diese Voreinstellung mit den Anweisungen \DescRef{maincls.cmd.setkomafont} und \DescRef{maincls.cmd.addtokomafont} (siehe \autoref{sec:maincls.textmarkup}, -\DescPageRef{maincls.cmd.setkomafont}) verändert werden. Natürlich wird diese -Schrift damit noch lange nicht verwendet. Der Experte muss selbst Sorge dafür +\DescPageRef{maincls.cmd.setkomafont}) verändert werden. Natürlich wird diese +Schrift damit noch lange nicht verwendet. Der Experte muss selbst Sorge dafür tragen, dass er an den entsprechenden Stellen die Anweisung \DescRef{maincls.cmd.usekomafont}% \important{\DescRef{maincls.cmd.usekomafont}}\IndexCmd{usekomafont} (siehe -\DescPageRef{maincls.cmd.usekomafont}) für dieses Element in seinen -Definitionen einbaut. Der Aufruf von \Macro{newkomafont} für ein bereits -existierendes Element führt zu Fehlermeldungen. +\DescPageRef{maincls.cmd.usekomafont}) für dieses Element in seinen +Definitionen einbaut. Der Aufruf von \Macro{newkomafont} für ein bereits +existierendes Element führt zu Fehlermeldungen. Das optionale Argument \PName{Warnung} definiert eine Warnmeldung. Diese wird bei den \KOMAScript-Klassen per \Macro{ClassWarning} oder beim Paket \Package{scrextend} per \Macro{PackageWarning} immer dann ausgegeben, wenn die -Voreinstellung für das Element verändert wird. Als Urheber der +Voreinstellung für das Element verändert wird. Als Urheber der Warnung wird das Paket \Package{scrkbase}\IndexPackage{scrkbase}\important{\Package{scrkbase}} angegeben. -Mit \Macro{aliaskomafont} kann für ein bereits existierendes \PName{Element} +Mit \Macro{aliaskomafont} kann für ein bereits existierendes \PName{Element} ein \PName{Aliasname} definiert werden. \KOMAScript{} informiert den Benutzer -in der \File{log}-Datei über den Namen des tatsächlichen Elements, wenn dieser -den \PName{Aliasname} verwendet. \PName{Aliasname}n\textnote{Tipp!} können -beispielsweise dann eingesetzt werden, wenn der Entwickler sich später einen -besseren Namen für ein Element überlegt und der alte Name aus -Kompatibilitätsgründen weiter verwendbar bleiben soll. Außerdem kann damit die -Benutzerfreundlichkeit erhöht werden, indem einem Element all die Namen als -Alias zugeordnet werden, die unterschiedliche Benutzer intuitiv wählen -würden. \KOMAScript{} selbst macht von dieser Möglichkeit regen Gebrauch. +in der \File{log}-Datei über den Namen des tatsächlichen Elements, wenn dieser +den \PName{Aliasname} verwendet. \PName{Aliasname}n\textnote{Tipp!} können +beispielsweise dann eingesetzt werden, wenn der Entwickler sich später einen +besseren Namen für ein Element überlegt und der alte Name aus +Kompatibilitätsgründen weiter verwendbar bleiben soll. Außerdem kann damit die +Benutzerfreundlichkeit erhöht werden, indem einem Element all die Namen als +Alias zugeordnet werden, die unterschiedliche Benutzer intuitiv wählen +würden. \KOMAScript{} selbst macht von dieser Möglichkeit regen Gebrauch. % \EndIndexGroup @@ -317,25 +332,25 @@ würden. \KOMAScript{} selbst macht von dieser Möglichkeit regen Gebrauch. \Macro{addtokomafontonearglist}\Parameter{Makro} \Macro{addtokomafontgobblelist}\Parameter{Makro} \end{Declaration} -Wie bereits in \autoref{part:forAuthors} der Anleitung erklärt, dürfen in den -Schrifteinstellungen der Elemente nur Befehle zur Wahl der Größe, Familie, -Codierung, Strichstärke, Form und Farbe enthalten sein. Dabei erfolgt schon -die Änderung der Farbe bei \LaTeX{} nicht transparent und kann damit -unerwünschte Effekte hervorrufen, wenn man \DescRef{maincls.cmd.usekomafont} -an ungünstiger Stelle verwendet. +Wie bereits in \autoref{part:forAuthors} der Anleitung erklärt, dürfen in den +Schrifteinstellungen der Elemente nur Befehle zur Wahl der Größe, Familie, +Codierung, Strichstärke, Form und Farbe enthalten sein. Dabei erfolgt schon +die Änderung der Farbe bei \LaTeX{} nicht transparent und kann damit +unerwünschte Effekte hervorrufen, wenn man \DescRef{maincls.cmd.usekomafont} +an ungünstiger Stelle verwendet. Nun neigen Anwender dazu, in die Schrifteinstellungen auch ganz andere, teilweise sehr kritische Dinge zu packen, beispielsweise ein \Macro{MakeUppercase} ganz am Ende der Einstellung. Bei der internen -Verwendung der Schrifteinstellungen wurde daher möglichst so vorgegangen, dass +Verwendung der Schrifteinstellungen wurde daher möglichst so vorgegangen, dass viele dieser eigentlich verbotenen Einstellungen trotzdem keinen Schaden anrichten und es meist sogar funktioniert, wenn der letzte Befehl in der Schrifteinstellung ein Argument erwartet, also beispielsweise \Macro{textbf} -anstelle von \Macro{bfseries} verwendet wird. Eine Garantie gibt es dafür +anstelle von \Macro{bfseries} verwendet wird. Eine Garantie gibt es dafür jedoch nicht. -In Einzelfällen war es innerhalb von \KOMAScript{} notwendig, die Umschaltung -wirklich auf Schrifteinstellungen zu beschränken. Dies erfolgt dann +In Einzelfällen war es innerhalb von \KOMAScript{} notwendig, die Umschaltung +wirklich auf Schrifteinstellungen zu beschränken. Dies erfolgt dann beispielsweise mit \DescRef{maincls.cmd.usefontofkomafont}\IndexCmd{usefontofkomafont}% \IndexCmd{usesizeofkomafont}\IndexCmd{useencodingofkomafont}% @@ -357,32 +372,32 @@ zu \Macro{relax} werden sollen. In der Voreinstellung ist das seit Es ist zu beachten, dass das angegebene \PName{Makro} wirklich stur auf \Macro{relax} gesetzt wird. Irgendwelche Argumente innerhalb der -Schrifteinstellung werden also gegebenenfalls lokal ausgeführt. Daher dürfen -Anweisungen wie \Macro{setlength} keinesfalls zu dieser Liste hinzugefügt -werden. Für alle Fehler, die durch die Verwendung von +Schrifteinstellung werden also gegebenenfalls lokal ausgeführt. Daher dürfen +Anweisungen wie \Macro{setlength} keinesfalls zu dieser Liste hinzugefügt +werden. Für alle Fehler, die durch die Verwendung von \Macro{addtokomafontrelaxlist} entstehen, ist der Anwender selbst -verantwortlich. Außerdem sollte diese Möglichkeit nicht als Legitimation dafür -missverstanden werden, den Schrifteinstellungen alle möglichen Anweisungen -hinzuzufügen! +verantwortlich. Außerdem sollte diese Möglichkeit nicht als Legitimation dafür +missverstanden werden, den Schrifteinstellungen alle möglichen Anweisungen +hinzuzufügen! -Für\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} Befehle, deren erstes Argument noch ohne zusätzliche -Gruppe ausgeführt werden soll, gibt es +Für\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} Befehle, deren erstes Argument noch ohne zusätzliche +Gruppe ausgeführt werden soll, gibt es \Macro{addtokomafontonearglist}. Das angegebene \PName{Makro} wird dabei auf -\Macro{@firstofone} gesetzt. In der Voreinstellung wird dies für +\Macro{@firstofone} gesetzt. In der Voreinstellung wird dies für \Macro{MakeUppercase} und \Macro{MakeLowercase} verwendet. Soll\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} hingegen ein \PName{Makro} innerhalb von \DescRef{maincls.cmd.usefontofkomafont} und ihren Geschwistern zusammen mit seinem ersten Argument ignoriert werden, so ist stattdessen -\Macro{addtokomafontgobblelist} zu verwenden. Ein Beispiel dafür ist die -Anweisung \Macro{color}, die einschließlich des Namens der Farbe ignoriert +\Macro{addtokomafontgobblelist} zu verwenden. Ein Beispiel dafür ist die +Anweisung \Macro{color}, die einschließlich des Namens der Farbe ignoriert werden muss und deshalb bereits in der Voreinstellung Teil dieser Liste ist. Es ist zu beachten, dass sich die hier genannten Voreinstellungen in -zukünftigen Versionen ändern können. Wenn Sie bestimmte Befehle in einer der -Liste zwingend benötigen, sollte Sie diese also selbst explizit hinzufügen.% +zukünftigen Versionen ändern können. Wenn Sie bestimmte Befehle in einer der +Liste zwingend benötigen, sollte Sie diese also selbst explizit hinzufügen.% \EndIndexGroup @@ -394,38 +409,44 @@ Liste zwingend benötigen, sollte Sie diese also selbst explizit hinzufügen.% \end{Declaration} Da\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} die Schrift mancher Elemente erst ab -bestimmten Versionen von \KOMAScript{} geändert werden kann, ist es manchmal -sinnvoll, vorher testen zu können, ob ein \PName{Element} mit dieser -Möglichkeit überhaupt existiert. Die Anweisung \Macro{IfExistskomafont} führt -den \PName{Dann-Code} genau dann aus, wenn das \PName{Element} über +bestimmten Versionen von \KOMAScript{} geändert werden kann, ist es manchmal +sinnvoll, vorher testen zu können, ob ein \PName{Element} mit dieser +Möglichkeit überhaupt existiert. Die Anweisung \Macro{IfExistskomafont} führt +den \PName{Dann-Code} genau dann aus, wenn das \PName{Element} über \DescRef{\LabelBase.cmd.newkomafont} oder \DescRef{\LabelBase.cmd.aliaskomafont} definiert wurde und daher auch mit \DescRef{maincls.cmd.setkomafont} oder \DescRef{maincls.cmd.addtokomafont} -geändert und mit den \Macro{use\dots komafont}-Anweisungen abgefragt werden -kann. Anderenfalls wird der \PName{Sonst-Code} ausgeführt. +geändert und mit den \Macro{use\dots komafont}-Anweisungen abgefragt werden +kann. Anderenfalls wird der \PName{Sonst-Code} ausgeführt. -Im Unterschied dazu führt +Im Unterschied dazu führt \Macro{IfIsAliaskomafont}\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}} den -\PName{Dann-Code} nur aus, wenn \PName{Element} über -\DescRef{\LabelBase.cmd.aliaskomafont} als Alias für ein anderes Element -definiert wurde. Sowohl für nicht definierte Elemente als auch für mit +\PName{Dann-Code} nur aus, wenn \PName{Element} über +\DescRef{\LabelBase.cmd.aliaskomafont} als Alias für ein anderes Element +definiert wurde. Sowohl für nicht definierte Elemente als auch für mit \DescRef{\LabelBase.cmd.newkomafont} definierte Elemente wird hingegen der -\PName{Sonst-Code} ausgeführt.% +\PName{Sonst-Code} ausgeführt.% \EndIndexGroup -% \subsection{Absatzmarkierung} -% \seclabel{parskip} +\section{Absatzmarkierung} +\seclabel{parskip} + +Nicht nur aber insbesondere aufgrund der erweiterten Möglichkeiten der +Absatzmarkierung bei den \KOMAScript-Klassen sollte auf die direkte Änderung +der Standardlängen \Length{parskip}\IndexLength{parskip}, +\Length{parindent}\IndexLength{parskip} und +\Length{parfillskip}\IndexLength{parskip} weitgehend verzichtet werden. \begin{Declaration} \Macro{setparsizes}\Parameter{Einzug}\Parameter{Abstand} \Parameter{Endzeilenleerraum} \end{Declaration} -\KOMAScript{} bietet mit dieser Anweisung die Möglichkeit, sowohl den +\KOMAScript{} bietet mit dieser Anweisung die Möglichkeit, sowohl den Absatzeinzug als auch den Absatzabstand und den Freiraum am Ende der letzten Zeile des Absatzes einzustellen. Diese Anweisung ist immer dann zu verwenden, -wenn die Änderungen auch bei Einstellung +wenn die Änderungen auch bei Einstellung \OptionValueRef{\LabelBase}{parskip}{relative} beachtet werden sollen. \KOMAScript{}\textnote{Beispiel} selbst verwendet sie beispielsweise in der Form @@ -433,11 +454,11 @@ in der Form \setparsizes{0pt}{0pt}{0pt plus 1fil} \end{lstcode} um sowohl den Einzug als auch den Abstand abzuschalten und am Ende des -Absatzes beliebigen Freiraum zu erlauben. Eine solche Maßnahme ist sinnvoll, +Absatzes beliebigen Freiraum zu erlauben. Eine solche Maßnahme ist sinnvoll, wenn ein Absatz nur aus einer Box besteht, die ohne Abstand nach oben oder unten gesetzt werden soll und die gesamte Spaltenbreite einnimmt. Soll -demgegenüber die Box nur die gesamte Breite einnehmen, jedoch mit der -aktuellen Einstellung bezüglich des Absatzabstandes gesetzt werden, so ist +demgegenüber die Box nur die gesamte Breite einnehmen, jedoch mit der +aktuellen Einstellung bezüglich des Absatzabstandes gesetzt werden, so ist \begin{lstcode} \setlength{\parfillskip}{0pt plus 1fil} \end{lstcode} @@ -445,12 +466,12 @@ vorzuziehen. Eine\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Neuberechnung\IndexCmd{activateareas} oder Reaktivierung -der Einstellungen für den Satzspiegel und die Ränder (siehe -\autoref{cha:typearea}) führt seit \KOMAScript~3.17 übrigens immer auch zu +der Einstellungen für den Satzspiegel und die Ränder (siehe +\autoref{cha:typearea}) führt seit \KOMAScript~3.17 übrigens immer auch zu einer Neueinstellung der via \Macro{setparsizes} gesetzten Werte, falls die -Werte nicht zwischenzeitlich geändert wurden. Dies sollte ein Grund mehr sein, -nicht an \KOMAScript{} vorbei die Einstellungen zu ändern. Die Neuberechnung -wird bei einer Kompatibilitätseinstellung zu einer früheren Version (siehe +Werte nicht zwischenzeitlich geändert wurden. Dies sollte ein Grund mehr sein, +nicht an \KOMAScript{} vorbei die Einstellungen zu ändern. Die Neuberechnung +wird bei einer Kompatibilitätseinstellung zu einer früheren Version (siehe \autoref{sec:maincls.compatibilityOptions}, \DescPageRef{maincls.option.version}, Option \DescRef{maincls.option.version}% @@ -459,13 +480,19 @@ deaktiviert.% % \EndIndexGroup -% \subsection{Zähler} -% \seclabel{counter} +\section{Zähler} +\seclabel{counter} +% TODO: Die entsprechenden Erklärungen für die Buchfassung an die Verwendung +% eines eigenen Abschnitts anpassen. \LoadNonFree{scrbookreportarticle-experts}{3} -% \subsection{Gliederung} -% \seclabel{sections} +\section{Gliederung} +\seclabel{sections} + +Die \KOMAScript-Klassen bieten weitreichende Möglichkeiten, um Einfluss auf +die Gliederungsebenen und die zugehörigen Ãœberschriften zu nehmen. Selbst die +Definition neuer Ebenen ist damit möglich. \begin{Declaration} \Macro{DeclareSectionCommand}\OParameter{Einstellungen}\Parameter{Name} @@ -476,231 +503,231 @@ deaktiviert.% Diese\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Anweisungen dienen dazu, einen neuen Gliederungsbefehl \Macro{\PName{Name}} zu definieren beziehungsweise einen vorhandenen -Gliederungsbefehl \Macro{\PName{Name}} zu verändern. Dazu werden über das +Gliederungsbefehl \Macro{\PName{Name}} zu verändern. Dazu werden über das optionale Argument \PName{Einstellungen} vorgenommen. Die \PName{Einstellungen} sind dabei eine durch Komma separierte Liste von -\PName{Schlüssel}=\PName{Wert}-Zuweisungen. Neben den vom Stil der Überschrift -unabhängigen Eigenschaften, die +\PName{Schlüssel}=\PName{Wert}-Zuweisungen. Neben den vom Stil der Ãœberschrift +unabhängigen Eigenschaften, die \autoref{tab:maincls-experts.declaresection.keys}, \autopageref{tab:maincls-experts.declaresection.keys} zu entnehmen sind, gibt -es auch Eigenschaften, die vom jeweiligen Stil abhängig sind. Derzeit stehen -die folgenden Stile zur Verfügung: +es auch Eigenschaften, die vom jeweiligen Stil abhängig sind. Derzeit stehen +die folgenden Stile zur Verfügung: \begin{description}\setkomafont{descriptionlabel}{} \item[\PValue{chapter}] \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}}ist der Stil\textnote{Gliederungsstil - \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} für - Kapitelüberschriften. Dieser Stil wird in der Voreinstellung für - \DescRef{maincls.cmd.chapter}\IndexCmd{chapter} und indirekt für + \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} für + Kapitelüberschriften. Dieser Stil wird in der Voreinstellung für + \DescRef{maincls.cmd.chapter}\IndexCmd{chapter} und indirekt für \DescRef{maincls.cmd.addchap}\IndexCmd{addchap} verwendet. Neue - Überschriften in diesem Stil können definiert werden, haben dann aber nicht - automatisch auch eine \Macro{add\dots}-Variante. Für die Konfiguration der - vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften aus + Ãœberschriften in diesem Stil können definiert werden, haben dann aber nicht + automatisch auch eine \Macro{add\dots}-Variante. Für die Konfiguration der + vorhandenen oder neuer Ãœberschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declarechapterstyle.keys}, \autopageref{tab:maincls-experts.declarechapterstyle.keys} zur - Verfügung. Die\textnote{Achtung!} Anweisung \DescRef{maincls.cmd.addchap} + Verfügung. Die\textnote{Achtung!} Anweisung \DescRef{maincls.cmd.addchap} wird ebenso wie die Sternformen automatisch zusammen mit - \DescRef{maincls.cmd.chapter} umkonfiguriert und kann nicht unabhängig davon - verändert werden. Es ist zu beachten, dass dieser Stil von + \DescRef{maincls.cmd.chapter} umkonfiguriert und kann nicht unabhängig davon + verändert werden. Es ist zu beachten, dass dieser Stil von \Class{scrartcl}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nicht bereitgestellt wird. \item[\PValue{part}] \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}ist der Stil\textnote{Gliederungsstil - \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} für - Teileüberschriften. Dieser Stil wird in der Voreinstellung für - \DescRef{maincls.cmd.part}\IndexCmd{part} und indirekt für + \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} für + Teileüberschriften. Dieser Stil wird in der Voreinstellung für + \DescRef{maincls.cmd.part}\IndexCmd{part} und indirekt für \DescRef{maincls.cmd.addpart}\IndexCmd{addpart} verwendet. Neue - Überschriften in diesem Stil können definiert werden, haben dann aber nicht - automatisch auch eine \Macro{add\dots}-Variante. Für die Konfiguration der - vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften aus + Ãœberschriften in diesem Stil können definiert werden, haben dann aber nicht + automatisch auch eine \Macro{add\dots}-Variante. Für die Konfiguration der + vorhandenen oder neuer Ãœberschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declarepartstyle.keys}, \autopageref{tab:maincls-experts.declarepartstyle.keys} zur - Verfügung. Die\textnote{Achtung!} Anweisung \DescRef{maincls.cmd.addpart} + Verfügung. Die\textnote{Achtung!} Anweisung \DescRef{maincls.cmd.addpart} wird ebenso wie die Sternformen automatisch zusammen mit - \DescRef{maincls.cmd.part} umkonfiguriert und kann nicht unabhängig davon - verändert werden. + \DescRef{maincls.cmd.part} umkonfiguriert und kann nicht unabhängig davon + verändert werden. \item[\PValue{section}] ist der Stil\textnote{Gliederungsstil - \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} für - Abschnittsüberschriften und tieferer Ebenen. Dieser Stil wird derzeit sowohl - für \DescRef{maincls.cmd.section}\IndexCmd{section}, + \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} für + Abschnittsüberschriften und tieferer Ebenen. Dieser Stil wird derzeit sowohl + für \DescRef{maincls.cmd.section}\IndexCmd{section}, \DescRef{maincls.cmd.subsection}\IndexCmd{subsection}, \DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection} als auch \DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph} und \DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} verwendet. Neue - Überschriften in diesem Stil können definiert werden. Für die Konfiguration - der vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften + Ãœberschriften in diesem Stil können definiert werden. Für die Konfiguration + der vorhandenen oder neuer Ãœberschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declaresectionstyle.keys}, \autopageref{tab:maincls-experts.declaresectionstyle.keys} zur - Verfügung. Bei\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} der Neudefinition sind die \PName{Schlüssel} + Verfügung. Bei\ChangedAt{v3.24}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} der Neudefinition sind die \PName{Schlüssel} \PValue{style}, \PValue{afterskip}, \PValue{beforeskip} und \PValue{level} - zwingend. Die \PName{Schlüssel} + zwingend. Die \PName{Schlüssel} \PValue{afterindent}\ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}, \PValue{font}, \PValue{indent} und \PValue{runin} sind empfohlen. \PValue{tocindent} und \PValue{tocnumwidth} - können abhängig vom Namen der Gliederungsebene ebenfalls zwingend sein. Das + können abhängig vom Namen der Gliederungsebene ebenfalls zwingend sein. Das gilt auch, falls ein Befehl, der bisher kein Gliederungsbefehl war, mit \Macro{RedeclareSectionCommand} zu einem Gliederungsbefehl umdefiniert wird. Die\textnote{Achtung!} Anweisung \Macro{addsec} wird ebenso wie die Sternformen zusammen mit \DescRef{maincls.cmd.section} umkonfiguriert und - kann nicht unabhängig davon verändert werden. + kann nicht unabhängig davon verändert werden. \end{description} Bei der Definition eines Gliederungsbefehls wird ein gleichnamiges Element angelegt, falls es noch nicht existiert. Bei \PValue{chapter} und -\PValue{part} werden ebenso Elemente für die Präfixzeile erzeugt. Die +\PValue{part} werden ebenso Elemente für die Präfixzeile erzeugt. Die Schrifteinstellung der Elemente kann mit \DescRef{maincls.cmd.setkomafont} und \DescRef{maincls.cmd.addtokomafont} (siehe \autoref{sec:maincls.textmarkup}, -\DescPageRef{maincls.cmd.setkomafont}) geändert werden. +\DescPageRef{maincls.cmd.setkomafont}) geändert werden. \begin{table} - \caption[{Stil unabhängige Eigenschaften bei der Deklaration von - Gliederungsbefehlen}]{Mögliche vom Stil der Überschrift unabhängige - \PName{Schlüssel} und \PName{Werte} für die \PName{Eigenschaften} bei der + \caption[{Stil unabhängige Eigenschaften bei der Deklaration von + Gliederungsbefehlen}]{Mögliche vom Stil der Ãœberschrift unabhängige + \PName{Schlüssel} und \PName{Werte} für die \PName{Eigenschaften} bei der Deklaration von Gliederungsbefehlen}% \label{tab:maincls-experts.declaresection.keys}% \begin{tabularx}{\linewidth}{llX} \toprule - \PName{Schlüssel} + \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ \midrule \PValue{counterwithin} - & \PName{Zählername} - & Der zur Gliederungsebene gehörende Zähler soll vom als Wert angegebenen - Zähler abhängig sein. Wird \PName{Zählername} über \Macro{stepcounter} - oder \Macro{refstepcounter} erhöht, so wird der zur Gliederungsebene - gehörende Zähler auf 0 zurückgesetzt. Darüber hinaus wird - \Macro{the\PName{Zählername}}, gefolgt von einem Punkt in der Ausgabe - des zur Gliederungsebene gehörenden Zählers vorangestellt.\\ + & \PName{Zählername} + & Der zur Gliederungsebene gehörende Zähler soll vom als Wert angegebenen + Zähler abhängig sein. Wird \PName{Zählername} über \Macro{stepcounter} + oder \Macro{refstepcounter} erhöht, so wird der zur Gliederungsebene + gehörende Zähler auf 0 zurückgesetzt. Darüber hinaus wird + \Macro{the\PName{Zählername}}, gefolgt von einem Punkt in der Ausgabe + des zur Gliederungsebene gehörenden Zählers vorangestellt.\\ \PValue{counterwithout}% \ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - & \PName{Zählername} - & Hebt eine früher vorgenommene \PValue{counterwithin}-Einstellung auf und - ist daher nur bei Änderung vorhandener Gliederungsbefehle sinnvoll.\\ + & \PName{Zählername} + & Hebt eine früher vorgenommene \PValue{counterwithin}-Einstellung auf und + ist daher nur bei Änderung vorhandener Gliederungsbefehle sinnvoll.\\ \PValue{expandtopt} & \PName{Schalter} & Ist dieser Schalter aktiv, so werden alle in den \PName{Einstellungen} - nachfolgend angegebenen Werte für Längen vollständig expandiert, + nachfolgend angegebenen Werte für Längen vollständig expandiert, ausgewertet und in \texttt{pt} umgerechnet gespeichert. Ist der Schalter nicht aktiv, so werden alle nachfolgend angegebenen - Werte für Längen nur testweise expandiert und ausgewertet, aber - lediglich expandiert gespeichert. Es werden die Werte für einfache + Werte für Längen nur testweise expandiert und ausgewertet, aber + lediglich expandiert gespeichert. Es werden die Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verstanden.\\ \PValue{level} & \PName{Ganzzahl} - & Nummerischer Wert der Gliederungsebene (siehe Zähler + & Nummerischer Wert der Gliederungsebene (siehe Zähler \DescRef{maincls.counter.secnumdepth}, \autoref{sec:maincls.structure}, \DescPageRef{maincls.counter.secnumdepth}); der Wert sollte eindeutig - sein und ist für neue Ebenen zwingend.\\ + sein und ist für neue Ebenen zwingend.\\ \PValue{style} & \PName{Name} - & Legt den Stil der Überschrift fest und ist für neue Ebenen zwingend.\\ + & Legt den Stil der Ãœberschrift fest und ist für neue Ebenen zwingend.\\ \PValue{tocstyle}% \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% & \PName{Name} - & Legt den Stil des zur Überschrift gehörenden Verzeichniseintrags fest. - Es können alle bisher definierten Verzeichniseintragsstile (siehe + & Legt den Stil des zur Ãœberschrift gehörenden Verzeichniseintrags fest. + Es können alle bisher definierten Verzeichniseintragsstile (siehe \autoref{sec:tocbasic.tocstyle}) verwendet werden. Ein leerer \PName{Name} verhindert die Umdefinierung des Befehls - \Macro{l@\dots} für die Verzeichniseinträge.\\ + \Macro{l@\dots} für die Verzeichniseinträge.\\ \PValue{toc\PName{Option}}% \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% & \PName{Wert} - & Weitere Optionen in Abhängigkeit vom via \Option{tocstyle} gewählten + & Weitere Optionen in Abhängigkeit vom via \Option{tocstyle} gewählten Verzeichniseintragsstil. Siehe dazu \autoref{sec:tocbasic.tocstyle} ab - \autopageref{sec:tocbasic.tocstyle}. Für die von + \autopageref{sec:tocbasic.tocstyle}. Für die von \hyperref[cha:tocbasic]{\Package{tocbasic}} vordefinierten Verzeichniseintragsstile finden sich die als \PName{Option} verwendbaren Attribute in \autoref{tab:tocbasic.tocstyle.attributes}, ab \autopageref{tab:tocbasic.tocstyle.attributes}.\\ % \PValue{tocindent} - % & \PName{Länge} - % & Der horizontale Einzug des zum Gliederungsbefehls gehörenden - % Eintrags ins Inhaltsverzeichnis, falls ein solcher abhängig von + % & \PName{Länge} + % & Der horizontale Einzug des zum Gliederungsbefehls gehörenden + % Eintrags ins Inhaltsverzeichnis, falls ein solcher abhängig von % \DescRef{maincls.counter.tocdepth} (siehe \autoref{sec:maincls.toc}, % \DescPageRef{maincls.counter.tocdepth}) erzeugt wird.\\ % \PValue{toclevel} % & \PName{Ganzzahl} - % & Die Ebene des zum Gliederungsbefehl gehörenden Eintrags ins + % & Die Ebene des zum Gliederungsbefehl gehörenden Eintrags ins % Inhaltsverzeichnis, falls diese von \PValue{level} abweichen soll % (siehe auch \DescRef{maincls.counter.tocdepth} in % \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). \\ % PValue{tocnumwidth} - % & \PName{Länge} - % & Die Breite, die für die Gliederungsnummer im zum Gliederungsbefehl - % gehörenden Eintrag ins Inhaltsverzeichnis reserviert wird.\\ + % & \PName{Länge} + % & Die Breite, die für die Gliederungsnummer im zum Gliederungsbefehl + % gehörenden Eintrag ins Inhaltsverzeichnis reserviert wird.\\ \bottomrule \end{tabularx} \end{table} \begin{table} \caption[{Eigenschaften des Stils \PValue{section} bei der Deklaration von - Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für + Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für die \PName{Eigenschaften} bei der Deklaration von Gliederungsbefehlen des Stils \PValue{section}\Index{Gliederung>Stil>~\PValue{section}}}% \label{tab:maincls-experts.declaresectionstyle.keys}% \begin{tabularx}{\linewidth}{llX} \toprule - \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ + \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ \midrule \PValue{afterindent}% \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% & \PName{Schalter} & Es wird bestimmt, ob auf die erste Zeile nach einer freistehenden - Überschrift (siehe \PValue{runin}) der aktuelle Absatzeinzug angewendet + Ãœberschrift (siehe \PValue{runin}) der aktuelle Absatzeinzug angewendet wird. Bei der Voreinstellung \PValue{bysign} bestimmt das Vorzeichen von - \PValue{beforeskip} das Verhalten. Ein negativer Wert für - \PValue{beforeskip} bewirkt dann, dass der Absatzeinzug entfällt. Mit - den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, + \PValue{beforeskip} das Verhalten. Ein negativer Wert für + \PValue{beforeskip} bewirkt dann, dass der Absatzeinzug entfällt. Mit + den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) kann die Anwendung des aktuellen Absatzeinzugs explizit aktiviert oder deaktiviert werden.\\ \PValue{afterskip} - & \PName{Länge} + & \PName{Länge} & Im Fall einer Spitzmarke (siehe \PValue{runin}) ist der Betrag der - \PName{Länge} der horizontale Abstand nach der Überschrift. Es - wird in diesem Fall also immer ein positiver Abstand eingefügt. Im Fall - einer freistehenden Überschrift ist \PName{Länge} der vertikale Abstand - nach der Überschrift. Ist \OptionValue{runin}{bysign}, so - führt ein positiver Wert zu einer freistehenden Überschrift, während - ein negativer Wert oder Null zu einer Spitzmarke führt.\\ + \PName{Länge} der horizontale Abstand nach der Ãœberschrift. Es + wird in diesem Fall also immer ein positiver Abstand eingefügt. Im Fall + einer freistehenden Ãœberschrift ist \PName{Länge} der vertikale Abstand + nach der Ãœberschrift. Ist \OptionValue{runin}{bysign}, so + führt ein positiver Wert zu einer freistehenden Ãœberschrift, während + ein negativer Wert oder Null zu einer Spitzmarke führt.\\ \PValue{beforeskip} - & \PName{Länge} - & Gibt den vertikalen Abstand vor der Überschrift an. Ist - \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag - von \PName{Länge} verwendet, es wird also trotzdem ein positiver - Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein - Absatzeinzug nach der Überschrift entfällt.\\ + & \PName{Länge} + & Gibt den vertikalen Abstand vor der Ãœberschrift an. Ist + \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag + von \PName{Länge} verwendet, es wird also trotzdem ein positiver + Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein + Absatzeinzug nach der Ãœberschrift entfällt.\\ \PValue{font} & \PName{Befehle} - & Die Schrifteinstellungen, die zusätzlich zum Element + & Die Schrifteinstellungen, die zusätzlich zum Element \DescRef{maincls.fontelement.disposition} bei der Ausgabe der - Überschrift verwendet werden sollen. Hier sind alle \PName{Befehle} - erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und - \DescRef{maincls.cmd.addtokomafont} für das Element des + Ãœberschrift verwendet werden sollen. Hier sind alle \PName{Befehle} + erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und + \DescRef{maincls.cmd.addtokomafont} für das Element des Gliederungsbefehls erlaubt sind.\\ \PValue{indent} - & \PName{Länge} + & \PName{Länge} & Einzug vom linken Rand vor der Ausgabe der Nummer und des Textes - der Überschrift.\\ + der Ãœberschrift.\\ \PValue{runin}% \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% & \PName{Schalter} - & Es wird bestimmt, ob die Überschrift als Spitzmarke\iffree{ (am + & Es wird bestimmt, ob die Ãœberschrift als Spitzmarke\iffree{ (am Zeilenanfang)}{} oder freistehend gesetzt wird. \iffree{}{Bei einer - Spitzmarke schließt sich der nachfolgende Text direkt an die - Überschrift an, während bei einer freistehenden Überschrift erst noch + Spitzmarke schließt sich der nachfolgende Text direkt an die + Ãœberschrift an, während bei einer freistehenden Ãœberschrift erst noch ein Absatz und ein vertikaler Abstand (siehe \PValue{afterskip}) folgt. }% Bei der Voreinstellung \PValue{bysign} bestimmt das Vorzeichen von - \PValue{afterskip} das Verhalten. Ein positiver Wert für - \PValue{afterskip} bewirkt dann eine freistehende Überschrift. - Darüber hinaus kann mit den Werten für einfache Schalter (siehe + \PValue{afterskip} das Verhalten. Ein positiver Wert für + \PValue{afterskip} bewirkt dann eine freistehende Ãœberschrift. + Darüber hinaus kann mit den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) eine Spitzmarke explizit aktiviert oder deaktiviert werden.\\ \bottomrule @@ -709,62 +736,62 @@ Schrifteinstellung der Elemente kann mit \DescRef{maincls.cmd.setkomafont} und \begin{table} \caption[{Eigenschaften des Stils \PValue{chapter} bei der Konfiguration von - Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für + Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für die \PName{Eigenschaften} bei der Konfiguration von Gliederungsbefehlen des Stils \PValue{chapter}\Index{Gliederung>Stil>~\PValue{chapter}}}% \label{tab:maincls-experts.declarechapterstyle.keys}% \begin{tabularx}{\linewidth}{llX} \toprule - \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ + \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ \midrule \PValue{afterindent}% \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}}% & \PName{Schalter} - & Es wird bestimmt, ob auf die erste Zeile nach der Überschrift der + & Es wird bestimmt, ob auf die erste Zeile nach der Ãœberschrift der aktuelle Absatzeinzug angewendet wird. Bei der Voreinstellung \PValue{bysign} bestimmt das Vorzeichen von \PValue{beforeskip} das - Verhalten. Ein negativer Wert für \PValue{beforeskip} bewirkt dann, dass - der Absatzeinzug entfällt. Mit den Werten für einfache Schalter (siehe + Verhalten. Ein negativer Wert für \PValue{beforeskip} bewirkt dann, dass + der Absatzeinzug entfällt. Mit den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) kann die Anwendung des aktuellen Absatzeinzugs explizit aktiviert oder deaktiviert werden.\\ \PValue{afterskip}% \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}}% - & \PName{Länge} - & Gibt den vertikalen Abstand nach der Überschrift an.\\ + & \PName{Länge} + & Gibt den vertikalen Abstand nach der Ãœberschrift an.\\ \PValue{beforeskip} - & \PName{Länge} - & Gibt den vertikalen Abstand vor der Überschrift an. Ist - \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag - von \PName{Länge} verwendet, es wird also trotzdem ein positiver - Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein - Absatzeinzug nach der Überschrift entfällt.\\ + & \PName{Länge} + & Gibt den vertikalen Abstand vor der Ãœberschrift an. Ist + \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag + von \PName{Länge} verwendet, es wird also trotzdem ein positiver + Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein + Absatzeinzug nach der Ãœberschrift entfällt.\\ \PValue{font} & \PName{Befehle} - & Die Schrifteinstellungen, die zusätzlich zum Element + & Die Schrifteinstellungen, die zusätzlich zum Element \DescRef{maincls.fontelement.disposition} bei der Ausgabe der - Überschrift verwendet werden sollen. Hier sind alle \PName{Befehle} - erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und - \DescRef{maincls.cmd.addtokomafont} für das Element des + Ãœberschrift verwendet werden sollen. Hier sind alle \PName{Befehle} + erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und + \DescRef{maincls.cmd.addtokomafont} für das Element des Gliederungsbefehls erlaubt sind.\\ \PValue{innerskip} - & \PName{Länge} - & Der vertikale Abstand zwischen Präfixzeile und Text der - Überschrift, falls eine Präfixzeile verwendet wird.\\ + & \PName{Länge} + & Der vertikale Abstand zwischen Präfixzeile und Text der + Ãœberschrift, falls eine Präfixzeile verwendet wird.\\ \PValue{pagestyle} & \PName{Seitenstil} - & Der Name des Seitenstils, der für die Seite mit der Überschrift - verwendet werden soll. Es findet keine Überprüfung statt, ob der - angegebene \PName{Seitenstil} gültig ist. Fehlerhafte Angaben führen + & Der Name des Seitenstils, der für die Seite mit der Ãœberschrift + verwendet werden soll. Es findet keine Ãœberprüfung statt, ob der + angegebene \PName{Seitenstil} gültig ist. Fehlerhafte Angaben führen daher zu Fehlermeldungen bei Verwendung des Gliederungsbefehls.\\ \PValue{prefixfont} & \PName{Befehle} - & Die Schrifteinstellungen, die zusätzlich zum Element + & Die Schrifteinstellungen, die zusätzlich zum Element \DescRef{maincls.fontelement.disposition} und dem Element des - Gliederungsbefehls bei der Ausgabe einer Präfixzeile in der Überschrift + Gliederungsbefehls bei der Ausgabe einer Präfixzeile in der Ãœberschrift verwendet werden sollen. Hier sind alle \PName{Befehle} erlaubt, die - auch über \DescRef{maincls.cmd.setkomafont} und - \DescRef{maincls.cmd.addtokomafont}für das Element der Präfixzeile des + auch über \DescRef{maincls.cmd.setkomafont} und + \DescRef{maincls.cmd.addtokomafont}für das Element der Präfixzeile des Gliederungsbefehls erlaubt sind.\\ \bottomrule \end{tabularx} @@ -772,13 +799,13 @@ Schrifteinstellung der Elemente kann mit \DescRef{maincls.cmd.setkomafont} und \begin{table} \caption[{Eigenschaften des Stils \PValue{part} bei der Konfiguration von - Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für + Gliederungsbefehlen}]{Zusätzliche \PName{Schlüssel} und \PName{Werte} für die \PName{Eigenschaften} bei der Konfiguration von Gliederungsbefehlen des Stils \PValue{part}\Index{Gliederung>Stil>~\PValue{part}}}% \label{tab:maincls-experts.declarepartstyle.keys}% \begin{tabularx}{\linewidth}{llX} \toprule - \PName{Schlüssel} + \PName{Schlüssel} & \PName{Wert} & Bedeutung \\ \midrule @@ -787,55 +814,55 @@ Schrifteinstellung der Elemente kann mit \DescRef{maincls.cmd.setkomafont} und \Class{scrartcl}}% & \PName{Schalter} & Es wird bestimmt, ob auf die erste Zeile nach der - Überschrift der aktuelle Absatzeinzug angewendet + Ãœberschrift der aktuelle Absatzeinzug angewendet wird. Bei der Einstellung \PValue{bysign} bestimmt das Vorzeichen von - \PValue{beforeskip} das Verhalten. Ein negativer Wert für - \PValue{beforeskip} bewirkt dann, dass der Absatzeinzug entfällt. Mit - den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, + \PValue{beforeskip} das Verhalten. Ein negativer Wert für + \PValue{beforeskip} bewirkt dann, dass der Absatzeinzug entfällt. Mit + den Werten für einfache Schalter (siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) kann die Anwendung des aktuellen Absatzeinzugs explizit aktiviert oder deaktiviert werden. Aus - Kompatibilitätsgründen ist die Voreinstellung - für \Class{scrartcl} \PValue{false}, für \Class{scrbook} und + Kompatibilitätsgründen ist die Voreinstellung + für \Class{scrartcl} \PValue{false}, für \Class{scrbook} und \Class{scrreprt} \PValue{true}.\\ \PValue{afterskip} - & \PName{Länge} - & Der Betrag gibt den vertikalen Abstand nach der Überschrift an.\\ + & \PName{Länge} + & Der Betrag gibt den vertikalen Abstand nach der Ãœberschrift an.\\ \PValue{beforeskip} - & \PName{Länge} - & Gibt den vertikalen Abstand vor der Überschrift an. Ist - \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag - von \PName{Länge} verwendet, es wird also trotzdem ein positiver - Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein - Absatzeinzug nach der Überschrift entfällt.\\ + & \PName{Länge} + & Gibt den vertikalen Abstand vor der Ãœberschrift an. Ist + \OptionValue{afterindent}{bysign}, so wird für den Abstand der Betrag + von \PName{Länge} verwendet, es wird also trotzdem ein positiver + Abstand eingefügt. Negative Werte bedeuten in diesem Fall, dass ein + Absatzeinzug nach der Ãœberschrift entfällt.\\ \PValue{font} & \PName{Befehle} - & Die Schrifteinstellungen, die zusätzlich zum Element + & Die Schrifteinstellungen, die zusätzlich zum Element \DescRef{maincls.fontelement.disposition} bei der Ausgabe der - Überschrift verwendet werden sollen. Hier sind alle \PName{Befehle} - erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und - \DescRef{maincls.cmd.addtokomafont} für das Element des + Ãœberschrift verwendet werden sollen. Hier sind alle \PName{Befehle} + erlaubt, die auch über \DescRef{maincls.cmd.setkomafont} und + \DescRef{maincls.cmd.addtokomafont} für das Element des Gliederungsbefehls erlaubt sind.\\ \PValue{innerskip} - & \PName{Länge} + & \PName{Länge} & %\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% - Der vertikale Abstand zwischen Präfixzeile und Text der Überschrift bei + Der vertikale Abstand zwischen Präfixzeile und Text der Ãœberschrift bei \Class{scrbook} und \Class{scrreprt}.\\ \PValue{pagestyle} & \PName{Seitenstil} & %\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% - Der Name des Seitenstils, der für die Seite mit der Überschrift - verwendet werden soll. Es findet keine Überprüfung statt, ob der - angegebene \PName{Seitenstil} gültig ist. Fehlerhafte Angaben führen + Der Name des Seitenstils, der für die Seite mit der Ãœberschrift + verwendet werden soll. Es findet keine Ãœberprüfung statt, ob der + angegebene \PName{Seitenstil} gültig ist. Fehlerhafte Angaben führen daher zu Fehlermeldungen bei Verwendung des Gliederungsbefehls. Diese - Möglichkeit existiert nur bei \Class{scrbook} und \Class{scrreprt}. \\ + Möglichkeit existiert nur bei \Class{scrbook} und \Class{scrreprt}. \\ \PValue{prefixfont} & \PName{Befehle} - & Die Schrifteinstellungen, die zusätzlich zum Element + & Die Schrifteinstellungen, die zusätzlich zum Element \DescRef{maincls.fontelement.disposition} und dem Element des - Gliederungsbefehls bei der Ausgabe einer Präfixzeile in der Überschrift + Gliederungsbefehls bei der Ausgabe einer Präfixzeile in der Ãœberschrift verwendet werden sollen. Hier sind alle \PName{Befehle} erlaubt, die - auch über \DescRef{maincls.cmd.setkomafont} und - \DescRef{maincls.cmd.addtokomafont} für das Element der Präfixzeile des + auch über \DescRef{maincls.cmd.setkomafont} und + \DescRef{maincls.cmd.addtokomafont} für das Element der Präfixzeile des Gliederungsbefehls erlaubt sind.\\ \bottomrule \end{tabularx} @@ -846,66 +873,66 @@ Gliederungsbefehls. Ist derselbe \PName{Name} von \TeX{} bereits anderweitig belegt, so wird ein Fehler ausgegeben und es findet keine Umdefinierung statt. -\Macro{ProvideSectionSommand} verhält sich ähnlich, gibt aber keine +\Macro{ProvideSectionSommand} verhält sich ähnlich, gibt aber keine Fehlermeldung aus. \Macro{RedeclareSectionCommand} kann hingegen nur verwendet werden, um eine existierende Anweisung zu einem Gliederungsbefehl mit den angegebenen -\PName{Eigenschaften} zu ändern. Dabei wird nicht überprüft, ob +\PName{Eigenschaften} zu ändern. Dabei wird nicht überprüft, ob \Macro{\PName{Name}} bereits zuvor ein Gliederungsbefehl war. Es muss nur ein von \TeX{} bereits belegter \PName{Name} sein. -Bei \Macro{DeclareSectionCommand} findet keinerlei Überprüfung statt, ob +Bei \Macro{DeclareSectionCommand} findet keinerlei Ãœberprüfung statt, ob \PName{Name} von \TeX{} bereits anderweitig belegt ist. Stattdessen wird der Gliederungsbefehl \Macro{\PName{Name}} unbedingt entsprechend der angegebenen \PName{Eigenschaften} definiert. -Zu jeder Gliederungsanweisung gehört außerdem ein Zähler: \PName{Name}, der +Zu jeder Gliederungsanweisung gehört außerdem ein Zähler: \PName{Name}, der bei Bedarf von allen vier Befehlen mit \Macro{newcounter} neu angelegt -wird. Dasselbe gilt für die Ausgabe des Zählers: \Macro{the\PName{Name}}, die -Formatierung des Zählers: \Macro{\PName{Name}format}, die Anweisung zur +wird. Dasselbe gilt für die Ausgabe des Zählers: \Macro{the\PName{Name}}, die +Formatierung des Zählers: \Macro{\PName{Name}format}, die Anweisung zur Erstellung eines Kolumnentitels: \Macro{\PName{Name}mark}, die dabei -verwendete Formatierung des Zählers: \Macro{\PName{Name}markformat}, die oben -erwähnten Elemente: \FontElement{\PName{Name}} und gegebenenfalls +verwendete Formatierung des Zählers: \Macro{\PName{Name}markformat}, die oben +erwähnten Elemente: \FontElement{\PName{Name}} und gegebenenfalls \FontElement{\PName{Name}prefix}, die nummerische Gliederungsebene: \Macro{\PName{Name}numdepth}. Die Anweisung \Macro{\PName{Name}mark} wird gegebenenfalls so vordefiniert, dass kein Kolumnentitel erzeugt wird. Die -Ausgabe des Zählers, \Macro{\PName{the}mark}, wird als arabische Zahl -vordefiniert. Wird über den \PName{Schlüssel} \PValue{counterwithin} der -Zähler als von einem anderen Zähler abhängig definiert, so wird in der Ausgabe -dieser andere Zähler mit einem Punkt getrennt vorangestellt. +Ausgabe des Zählers, \Macro{\PName{the}mark}, wird als arabische Zahl +vordefiniert. Wird über den \PName{Schlüssel} \PValue{counterwithin} der +Zähler als von einem anderen Zähler abhängig definiert, so wird in der Ausgabe +dieser andere Zähler mit einem Punkt getrennt vorangestellt. Neben\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} dem Gliederungsbefehl selbst wird auch ein Befehl für -einen Eintrag ins Inhaltsverzeichnis definiert. Dafür wird auf das Paket + \Class{scrartcl}} dem Gliederungsbefehl selbst wird auch ein Befehl für +einen Eintrag ins Inhaltsverzeichnis definiert. Dafür wird auf das Paket \hyperref[cha:tocbasic]{\Package{tocbasic}}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}\IndexPackage{tocbasic} -zurückgegriffen. Der Stil des Verzeichniseintrags wird über die Eigenschaft +zurückgegriffen. Der Stil des Verzeichniseintrags wird über die Eigenschaft \PValue{tocstyle} festgelegt. Wird hier mit \OptionValue{tocstyle}{} oder \OptionValue{tocstyle}{\{\}} ein leerer \PName{Name} angegeben, so erfolgt -keine Umdefinierung des Befehls für den Verzeichniseintrag. Das ist -beispielsweise dann wichtig, wenn Sie ein zusätzliches Paket zur Modifikation +keine Umdefinierung des Befehls für den Verzeichniseintrag. Das ist +beispielsweise dann wichtig, wenn Sie ein zusätzliches Paket zur Modifikation des Inhaltsverzeichnisses verwenden. Fehlt die Eigenschaft \PValue{tocstyle}, so wird bei der Umdefinierung der bisherige Stil erneut verwendet. Unterschiedliche\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} Stile für Verzeichniseinträge haben -unterschiedliche zusätzliche Eigenschaften. Diese können, mit dem Präfix + \Class{scrreprt}\and \Class{scrartcl}} Stile für Verzeichniseinträge haben +unterschiedliche zusätzliche Eigenschaften. Diese können, mit dem Präfix \PValue{toc} versehen, direkt mit angegeben werden. So kann beispielsweise die Ebene des Verzeichniseintrags, die bei allen von den \KOMAScript-Klassen und \hyperref[cha:tocbasic]{\Package{tocbasic}} definierten Stilen als Eigenschaft \PValue{level} bekannt ist, mit \PValue{toclevel} gesetzt werden, der Einzug -des Eintrags, \PValue{indent}, über \PValue{tocindent} und die für die Nummer -reservierte Breite, \PValue{numwidth}, mit \PValue{tocnumwidth}. Für weitere -Eigenschaften der Verzeichniseinträge siehe \autoref{sec:tocbasic.tocstyle} ab +des Eintrags, \PValue{indent}, über \PValue{tocindent} und die für die Nummer +reservierte Breite, \PValue{numwidth}, mit \PValue{tocnumwidth}. Für weitere +Eigenschaften der Verzeichniseinträge siehe \autoref{sec:tocbasic.tocstyle} ab Seite \autopageref{sec:tocbasic.tocstyle}. \begin{Example} - Aus unerfindlichen Gründen sollen die Überschriften von + Aus unerfindlichen Gründen sollen die Ãœberschriften von \DescRef{maincls.cmd.paragraph} nicht mehr als Spitzmarken, sondern als - Überschriften ähnlich \DescRef{maincls.cmd.subsubsection} umdefiniert - werden. Dabei soll über der Überschrift ein kleiner Abstand von 10\,pt und - unter der Überschrift kein zusätzlicher Abstand eingefügt werden. Das wäre + Ãœberschriften ähnlich \DescRef{maincls.cmd.subsubsection} umdefiniert + werden. Dabei soll über der Ãœberschrift ein kleiner Abstand von 10\,pt und + unter der Ãœberschrift kein zusätzlicher Abstand eingefügt werden. Das wäre bereits mit \begin{lstcode} \RedeclareSectionCommand[% @@ -913,18 +940,18 @@ Seite \autopageref{sec:tocbasic.tocstyle}. afterskip=1sp% ]{paragraph} \end{lstcode} - möglich. Durch den negativen Wert bei \PValue{beforeskip} wird der vertikale - Abstand über der Überschrift erzeugt und gleichzeitig der Einzug des ersten - Abschnitts nach der Überschrift abgeschaltet. Obwohl eigentlich nach der - Überschrift kein vertikaler Abstand gewünscht wird, wurde als Wert hier + möglich. Durch den negativen Wert bei \PValue{beforeskip} wird der vertikale + Abstand über der Ãœberschrift erzeugt und gleichzeitig der Einzug des ersten + Abschnitts nach der Ãœberschrift abgeschaltet. Obwohl eigentlich nach der + Ãœberschrift kein vertikaler Abstand gewünscht wird, wurde als Wert hier 1\,sp angegeben. Der Grund ist einfach: Einen Wert von 0\,pt betrachtet \LaTeX{} an dieser Stelle nicht als positiven Wert und erzeugt damit eine - Überschrift in der Form einer Spitzmarke. Der kleinste positive Wert ist + Ãœberschrift in der Form einer Spitzmarke. Der kleinste positive Wert ist 1\,sp. - In der Regel ist es für den vertikalen Ausgleich (siehe + In der Regel ist es für den vertikalen Ausgleich (siehe \DescRef{maincls.cmd.flushbottom}, \autoref{sec:maincls.typearea}, - \DescPageRef{maincls.cmd.flushbottom}) besser, wenn man die Abstände + \DescPageRef{maincls.cmd.flushbottom}) besser, wenn man die Abstände mit etwas Spielraum, dem sogenannten Leim, versieht: \begin{lstcode} \RedeclareSectionCommand[% @@ -932,18 +959,18 @@ Seite \autopageref{sec:tocbasic.tocstyle}. afterskip=1sp plus -1sp minus 1sp% ]{paragraph} \end{lstcode} - Dabei ist zu beachten, dass natürlich auch der Leim bei der Anwendung als + Dabei ist zu beachten, dass natürlich auch der Leim bei der Anwendung als vertikaler Abstand das Vorzeichen wechselt, also bei \PValue{beforeskip} im Beispiel negativ angegeben wird. Gleichzeitig wurde die Gelegenheit genutzt, - über den Leim bei \PValue{afterskip} dafür zu sorgen, dass der Abstand dort - gegebenenfalls tatsächlich bis auf 0 schrumpft. + über den Leim bei \PValue{afterskip} dafür zu sorgen, dass der Abstand dort + gegebenenfalls tatsächlich bis auf 0 schrumpft. \end{Example} -Dass im Beispiel nur die Schlüssel \PValue{beforeskip} und \PValue{afterskip} +Dass im Beispiel nur die Schlüssel \PValue{beforeskip} und \PValue{afterskip} verwendet werden mussten, liegt daran, dass seit \KOMAScript{} 3.15 \DescRef{maincls.cmd.paragraph} intern bereits mit -\Macro{DeclareSectionCommand} definiert wird und daher die übrigen -Einstellungen unverändert übernommen werden können. Die Originaldefinition von +\Macro{DeclareSectionCommand} definiert wird und daher die übrigen +Einstellungen unverändert übernommen werden können. Die Originaldefinition von \DescRef{maincls.cmd.paragraph} entspricht bei \Class{scrartcl}: \begin{lstcode} \DeclareSectionCommand[% @@ -960,17 +987,17 @@ Einstellungen unverändert übernommen werden können. Die Originaldefinition von Bei \Class{scrreprt} und \Class{scrbook} werden teilweise abweichende Werte verwendet. -Für \DescRef{maincls.cmd.chapter} sind einige Einstellungen für die -Überschriften von Option \DescRef{maincls.option.headings} (siehe +Für \DescRef{maincls.cmd.chapter} sind einige Einstellungen für die +Ãœberschriften von Option \DescRef{maincls.option.headings} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.headings}) -abhängig. Diese abhängigen Einstellungen sind in -\autoref{tab:maincls.chapter.skips} zu finden. Eine Übersicht über alle +abhängig. Diese abhängigen Einstellungen sind in +\autoref{tab:maincls.chapter.skips} zu finden. Eine Ãœbersicht über alle Voreinstellungen bietet \autoref{tab:maincls.section.defaults}. Es ist zu beachten, dass dabei \PValue{1ex} und \Length{baselineskip} von der -voreingestellten Größe der Überschrift beziehungsweise des -Inhaltsverzeichniseintrags abhängig sind. Weitere +voreingestellten Größe der Ãœberschrift beziehungsweise des +Inhaltsverzeichniseintrags abhängig sind. Weitere Voreinstellungen\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} für die Stile der Verzeichniseinträge + \Class{scrreprt}\and \Class{scrartcl}} für die Stile der Verzeichniseinträge sind \autoref{sec:tocbasic.tocstyle}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} ab \autopageref{sec:tocbasic.tocstyle} zu entnehmen. @@ -981,12 +1008,12 @@ sind \autoref{sec:tocbasic.tocstyle}% \setcapindent{0pt}% % \caption \begin{captionbeside} - [{Voreinstellungen für die Kapitelüberschriften von \Class{scrbook} - und \Class{scrreprt} in Abhängigkeit von Option + [{Voreinstellungen für die Kapitelüberschriften von \Class{scrbook} + und \Class{scrreprt} in Abhängigkeit von Option \DescRef{maincls.option.headings}}] {\hskip 0pt plus .5em - Voreinstellungen für die Kapitelüberschriften von \Class{scrbook} - und \Class{scrreprt} in Abhängigkeit von Option + Voreinstellungen für die Kapitelüberschriften von \Class{scrbook} + und \Class{scrreprt} in Abhängigkeit von Option \DescRef{maincls.option.headings}% \label{tab:maincls.chapter.skips}} [l] @@ -1034,11 +1061,11 @@ sind \autoref{sec:tocbasic.tocstyle}% %begin{table} % \centering \begin{longtable}{@{}p{\columnwidth}@{}} - \caption{Voreinstellungen für die Formatierung der Überschriften von + \caption{Voreinstellungen für die Formatierung der Ãœberschriften von \Class{scrbook} und \Class{scrreprt}}% \label{tab:maincls.section.defaults}\\ \endfirsthead - \caption[]{Voreinstellungen für die Formatierung der Überschriften von + \caption[]{Voreinstellungen für die Formatierung der Ãœberschriften von \Class{scrbook} und \Class{scrreprt} \emph{(Fortsetzung)}}\\ \addlinespace[-\normalbaselineskip] \endhead @@ -1190,10 +1217,10 @@ sind \autoref{sec:tocbasic.tocstyle}% \end{tabularx} \end{longtable} %end{table} -Das in den Einstellungen für \DescRef{maincls.cmd.subparagraph} verwendete -interne Makro \Macro{scr@parindent} ist übrigens, der per Option +Das in den Einstellungen für \DescRef{maincls.cmd.subparagraph} verwendete +interne Makro \Macro{scr@parindent} ist übrigens, der per Option \DescRef{maincls.option.parskip} oder Befehl -\DescRef{maincls-experts.cmd.setparsizes} eingestellte Absatzeinzug. +\DescRef{maincls-experts.cmd.setparsizes} eingestellte Absatzeinzug.% \EndIndexGroup @@ -1208,31 +1235,46 @@ interne Makro \Macro{scr@parindent} ist übrigens, der per Option \Parameter{Namensliste} \end{Declaration} Diese\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} Anweisungen können gleich eine ganze Reihe von -Gliederungsbefehlen definieren oder ändern. Dabei ist \PName{Namensliste} eine + \Class{scrartcl}} Anweisungen können gleich eine ganze Reihe von +Gliederungsbefehlen definieren oder ändern. Dabei ist \PName{Namensliste} eine durch Komma separierte Liste von Namen der Gliederungsbefehle. Diese Anweisungen unterscheiden sich in zwei weiteren Punkten von den zuvor -erklärten Anweisungen zur Definition oder Änderung eines einzelnen +erklärten Anweisungen zur Definition oder Änderung eines einzelnen Gliederungsbefehls. Zum einen wird im Fehlerfall, also wenn eine Anweisung bei \Macro{DeclareNewSectionCommands} bereits zuvor existierte oder bei \Macro{RedeclareSectionCommands} noch nicht existierte, die Definition dennoch -vorgenommen. Ein entsprechender Fehler wird natürlich trotzdem gemeldet. +vorgenommen. Ein entsprechender Fehler wird natürlich trotzdem gemeldet. Zum anderen gibt es eine weitere Einstellung, \important{\PValue{increaselevel}}\OptionVName{increaselevel}{Ganzzahl}. -Damit ändert sich die Bedeutung von \PValue{level} und \PValue{toclevel} +Damit ändert sich die Bedeutung von \PValue{level} und \PValue{toclevel} (siehe \autoref{tab:maincls-experts.declaresection.keys}, \autopageref{tab:maincls-experts.declaresection.keys}) dahingehend, dass deren Werte lediglich als \PName{Einstellungen} des ersten Gliederungsbefehls aus -der \PName{Namensliste} dienen. Für alle weiteren Gliederungsbefehle werden die +der \PName{Namensliste} dienen. Für alle weiteren Gliederungsbefehle werden die Werte von \PValue{level} und \PValue{toclevel} um den Wert von -\PValue{increaselevel} erhöht. Wurde die Einstellung \PValue{increaselevel} +\PValue{increaselevel} erhöht. Wurde die Einstellung \PValue{increaselevel} ohne Wertzuweisung verwendet, so wird der Wert 1 angenommen.% \EndIndexGroup \begin{Declaration} + \Macro{IfSectionCommandStyleIs}\Parameter{Name}\Parameter{Stil} + \Parameter{Dann-Code}\Parameter{Sonst-Code} +\end{Declaration} +In\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +seltenen Fällen ist es nützlich, testen zu können, ob ein Gliederungsbefehl +einem bestimmten \PName{Stil} angehört. Ist der mittels \PName{Name} bestimmte +Gliederungsbefehl aus \KOMAScript-Sicht derzeit mit dem angebenen \PName{Stil} +definiert, so wird der \PName{Dann-Code} ausgeführt, anderenfalls der +\PName{Sonst-Code}. Ist \Macro{\PName{Name}} nicht definiert oder kein mit +\KOMAScript-Mitteln definierter Gliederungsbefehl, so wird dies als Fehler +gemeldet.% +\EndIndexGroup + + +\begin{Declaration} \Macro{chapterheadstartvskip} \Macro{chapterheadmidvskip} \Macro{chapterheadendvskip} @@ -1249,8 +1291,8 @@ Diese\important[i]{\DescRef{maincls.cmd.chapter}\\ \DescRef{maincls.cmd.part*}\\ \DescRef{maincls.cmd.addchap*}\\ \DescRef{maincls.cmd.addpart*}} Anweisungen werden innerhalb von -Überschriften der zuvor erklärten Stile \PValue{chapter} und \PValue{part} und -damit für die Definition der Überschriften +Ãœberschriften der zuvor erklärten Stile \PValue{chapter} und \PValue{part} und +damit für die Definition der Ãœberschriften \DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, \DescRef{maincls.cmd.part}\IndexCmd{part}, \DescRef{maincls.cmd.addchap}\IndexCmd{addchap}, @@ -1259,34 +1301,34 @@ damit für die Definition der Überschriften \DescRef{maincls.cmd.part*}\IndexCmd{part*}, \DescRef{maincls.cmd.addchap*}\IndexCmd{addchap*}, \DescRef{maincls.cmd.addpart*}\IndexCmd{addpart*} verwendet. Dabei ist -\Macro{chapterheadstartvskip} eine Anweisung, die dafür vorgesehen ist, vor -der Kapitelüberschrift einen vertikalen Abstand einzufügen. Entsprechend ist -\Macro{chapterheadendvskip} eine Anweisung, die dafür vorgesehen ist, nach der -Kapitelüberschrift einen vertikalen Abstand -einzufügen. Bei\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}} -Kapitelüberschriften mit eigener Nummernzeile (siehe Option +\Macro{chapterheadstartvskip} eine Anweisung, die dafür vorgesehen ist, vor +der Kapitelüberschrift einen vertikalen Abstand einzufügen. Entsprechend ist +\Macro{chapterheadendvskip} eine Anweisung, die dafür vorgesehen ist, nach der +Kapitelüberschrift einen vertikalen Abstand +einzufügen. Bei\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}} +Kapitelüberschriften mit eigener Nummernzeile (siehe Option \DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.chapterprefix}) wird zwischen der Nummernzeile und -der eigentlichen Überschrift außerdem \Macro{chapterheadmidvskip} ausgeführt. +der eigentlichen Ãœberschrift außerdem \Macro{chapterheadmidvskip} ausgeführt. -Für das Einfügen der vertikalen Abstände über und unter Teile-Überschriften +Für das Einfügen der vertikalen Abstände über und unter Teile-Ãœberschriften sind die Anweisungen \Macro{partheadstartvskip} und \Macro{partheadendvskip} vorgesehen. Dabei wird ein Seitenumbruch als Teil des vertikalen Abstandes interpretiert. Ein solcher Seitenumbruch ist in der Voreinstellung sowohl bei \Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} als auch \Class{scrreprt} in der Definition von \Macro{partheadendvskip} enthalten. Die -Anweisung \Macro{partheadmidvskip} ist für den Abstand zwischen der -Teile-Nummer und dem Text der Teile-Überschrift vorgesehen. Die Anweisung +Anweisung \Macro{partheadmidvskip} ist für den Abstand zwischen der +Teile-Nummer und dem Text der Teile-Ãœberschrift vorgesehen. Die Anweisung \Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and \Class{scrreprt}} wird bei \Class{scrbook} und \Class{scrreprt} -gegebenenfalls für die leere Seite nach der Überschrift verwendet. +gegebenenfalls für die leere Seite nach der Ãœberschrift verwendet. Die Voreinstellungen der sieben Anweisungen sind seit \KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} von der Einstellung von Option \DescRef{maincls.option.headings} (siehe \autoref{sec:maincls.structure}, -\DescPageRef{maincls.option.headings}) unabhängig. Die Original-Definitionen -für die Kapitelüberschriften ab +\DescPageRef{maincls.option.headings}) unabhängig. Die Original-Definitionen +für die Kapitelüberschriften ab \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} entsprechen:\IndexLength{@tempskipa} \begin{lstcode} @@ -1300,9 +1342,9 @@ Diese werden auch bei jeder Verwendung von Option \OptionValueRef{maincls}{headings}{normal} oder \OptionValueRef{maincls}{headings}{small} reaktiviert. Als Seiteneffekt haben diese Optionen also gegebenenfalls nicht nur Auswirkungen auf -Kapitelüberschriften, sondern auf alle Überschriften im Stil \PValue{chapter}. +Kapitelüberschriften, sondern auf alle Ãœberschriften im Stil \PValue{chapter}. -Der Stil \PValue{chapter} setzt die interne Länge +Der Stil \PValue{chapter} setzt die interne Länge \Length{@tempskipa}\IndexLength{@tempskipa} vor Aufruf von \Macro{chapterheadstartvskip} automatisch auf den Wert, der sich aus der \DescRef{\LabelBase.cmd.DeclareSectionCommand}-Einstellung% @@ -1313,9 +1355,9 @@ sich aus der Einstellung mit dem Wert, der sich aus der Einstellung \PValue{innerskip} ergibt. -Da die Voreinstellungen für die Abstände von \DescRef{maincls.cmd.part} nicht -von Option \DescRef{maincls.option.headings} abhängen, werden auch die -zugehörigen Anweisungen von dieser Option nicht neu +Da die Voreinstellungen für die Abstände von \DescRef{maincls.cmd.part} nicht +von Option \DescRef{maincls.option.headings} abhängen, werden auch die +zugehörigen Anweisungen von dieser Option nicht neu definiert. Ihre\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Original-Definitionen entsprechen bei \Class{scrbook} und \Class{scrreprt}: @@ -1343,27 +1385,27 @@ und bei \Class{scrartcl}: \vskip\@tempskipa } \end{lstcode} -Auch hier wird vom Stil \PValue{part} die interne Länge +Auch hier wird vom Stil \PValue{part} die interne Länge \Length{@tempskipa}\IndexLength{@tempskipa}\IndexLength{@tempskipa} vor der Verwendung der Befehle entsprechend der Einstellungen von \DescRef{\LabelBase.cmd.DeclareSectionCommand}\IndexCmd{DeclareSectionCommand} gesetzt. -Wird eine der Anweisungen, die im Original \Length{@tempskipa} für den -vertikalen Abstand verwendet, umdefiniert und sollen die Abstände weiterhin +Wird eine der Anweisungen, die im Original \Length{@tempskipa} für den +vertikalen Abstand verwendet, umdefiniert und sollen die Abstände weiterhin beispielsweise mit \DescRef{\LabelBase.cmd.RedeclareSectionCommand} konfigurierbar sein, so sollte man in der neuen Definition ebenfalls \Length{@tempskipa} verwenden. Da\ChangedAt{v3.17}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} die Abstände über, innerhalb und -unter den Überschriften einfacher mit -\DescRef{\LabelBase.cmd.RedeclareSectionCommand} eingestellt werden können, + \Class{scrreprt}\and \Class{scrartcl}} die Abstände über, innerhalb und +unter den Ãœberschriften einfacher mit +\DescRef{\LabelBase.cmd.RedeclareSectionCommand} eingestellt werden können, wird generell nicht empfohlen, zu diesem Zweck stattdessen die hier -beschriebenen Anweisungen umzudefinieren. Sie sollten für tiefgreifendere -Änderungen reserviert bleiben, die nicht über +beschriebenen Anweisungen umzudefinieren. Sie sollten für tiefgreifendere +Änderungen reserviert bleiben, die nicht über \DescRef{\LabelBase.cmd.RedeclareSectionCommand} zu erreichen sind. Auf\textnote{Beispiel!} \cite{homepage} findet sich dazu ein Beispiel, bei dem durch Umdefinierung von \Macro{chapterheadstartvskip} und -\Macro{chapterheadendvskip} Linien über und unter der Kapitelüberschrift +\Macro{chapterheadendvskip} Linien über und unter der Kapitelüberschrift gesetzt werden.% % \EndIndexGroup @@ -1374,14 +1416,14 @@ gesetzt werden.% \Parameter{Ebene}\Parameter{Nummer}\Parameter{Text} \end{Declaration} Diese\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} Anweisung wird von Überschriften des Stils + \Class{scrartcl}} Anweisung wird von Ãœberschriften des Stils \PValue{part}\textnote{Gliederungsstil \PValue{part}}\Index{Gliederung>Stil>~\PValue{part}} verwendet. Die beiden -Argumente \PName{Nummer} und \PName{Text} sind dabei einschließlich -Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regelt die -Anweisung also die Anordnung der beiden Teile der Überschrift. Bei nicht -nummerierten Überschriften ist \PName{Nummer} ein komplett leeres Argument, -enthält also auch keine Formatierungsanweisungen. +Argumente \PName{Nummer} und \PName{Text} sind dabei einschließlich +Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regelt die +Anweisung also die Anordnung der beiden Teile der Ãœberschrift. Bei nicht +nummerierten Ãœberschriften ist \PName{Nummer} ein komplett leeres Argument, +enthält also auch keine Formatierungsanweisungen. Vordefiniert ist die Anweisung mit: \begin{lstcode} @@ -1392,7 +1434,7 @@ Vordefiniert ist die Anweisung mit: bisher eher spartanisch. \begin{Example} - Sie wollen die Teile-Überschriften in eine hellblaue Box mit blauer + Sie wollen die Teile-Ãœberschriften in eine hellblaue Box mit blauer Umrandung stellen, die nur etwa drei Viertel der Breite des Textbereichs einnimmt. Hierzu verwenden Sie \begin{lstcode}[moretexcs={fcolorbox}] @@ -1407,19 +1449,19 @@ bisher eher spartanisch. \part{Umrahmte Teile} \end{document} \end{lstcode} - Allerdings fällt Ihnen auf, dass die Überschrift dabei nicht wie sonst - für Teile üblich zentriert wird -- weder die Box selbst noch der Text + Allerdings fällt Ihnen auf, dass die Ãœberschrift dabei nicht wie sonst + für Teile üblich zentriert wird -- weder die Box selbst noch der Text innerhalb der Box. - Die Ursache für die fehlende Zentrierung der Box liegt - darin, dass aufgrund der Änderung das in Argument 3 versteckte Absatzende + Die Ursache für die fehlende Zentrierung der Box liegt + darin, dass aufgrund der Änderung das in Argument 3 versteckte Absatzende nur noch den Absatz innerhalb der Box beendet, aber nicht mehr den Absatz mit - der \Macro{parbox}. Also ergänzen Sie ein \Macro{par} am Ende der Definition. + der \Macro{parbox}. Also ergänzen Sie ein \Macro{par} am Ende der Definition. Die Ursache der fehlenden Zentrierung innerhalb der Box ist, dass in der \Macro{parbox}-Anweisung die Ausrichtung von - \DescRef{maincls.cmd.raggedpart} nicht automatisch gültig ist. Daher - ergänzen Sie diese Anweisung innerhalb der Box. + \DescRef{maincls.cmd.raggedpart} nicht automatisch gültig ist. Daher + ergänzen Sie diese Anweisung innerhalb der Box. Mit \begin{lstcode}[moretexcs={fcolorbox}] @@ -1435,16 +1477,16 @@ bisher eher spartanisch. \part{Umrahmte Teile} \end{document} \end{lstcode} - erhalten Sie die gewünschte Formatierung. + erhalten Sie die gewünschte Formatierung. \end{Example} Wie im Beispiel gezeigt, ist der Anwender bei der Umdefinierung der Anweisung -für einige Dinge selbst verantwortlich. Dazu gehört neben dem Erhalt der -voreingestellten Ausrichtung auch, dass innerhalb der Überschrift kein -Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder -Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich +für einige Dinge selbst verantwortlich. Dazu gehört neben dem Erhalt der +voreingestellten Ausrichtung auch, dass innerhalb der Ãœberschrift kein +Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder +Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich unproblematisch. Nicht nur, dass die beiden Boxen ohnehin keinen Seitenumbruch -erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil +erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil von \PName{Text} so, dass darin kein Seitenumbruch stattfinden darf. Gleichzeitig endet \PName{Text} immer mit einem internen Absatz, \Macro{@@par}. @@ -1453,7 +1495,7 @@ Das Argument \PName{Ebene} wird von \Macro{partlineswithprefixformat} in der Voreinstellung nicht verwendet und ist auch im Beispiel nicht erforderlich. Erst wenn der Anwender mehrere Anweisungen im Stil \PValue{part} definiert und man innerhalb der Definition -nach den Anweisungen unterscheiden will, kann dies über \PName{Ebene} +nach den Anweisungen unterscheiden will, kann dies über \PName{Ebene} erfolgen. Dabei ist \PName{Ebene} der vom Namen der Anweisung abgeleitete Name der Gliederungsebene. Bei \DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.part*}, \DescRef{maincls.cmd.addpart} und @@ -1468,8 +1510,8 @@ der Gliederungsebene. Bei \DescRef{maincls.cmd.part}, \Parameter{Ebene}\Parameter{Nummer}\Parameter{Text} \end{Declaration} Diese\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}} Anweisungen -werden von Überschriften des Stils \PValue{chapter}\textnote{Gliederungsstil - \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} in Abhängigkeit +werden von Ãœberschriften des Stils \PValue{chapter}\textnote{Gliederungsstil + \PValue{chapter}}\Index{Gliederung>Stil>~\PValue{chapter}} in Abhängigkeit von Option \DescRef{maincls.option.chapterprefix}\IndexOption{chapterprefix}% \textnote{\DescRef{maincls.option.chapterprefix}} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.chapterprefix}) @@ -1478,10 +1520,10 @@ aktivierter Option vor. Bei deaktivierter Option bestimmt dagegen \Macro{chapterlinesformat} die Ausgabe. Die beiden Argumente \PName{Nummer} und \PName{Text} sind dabei -einschließlich Einstellung der Fonts für sich bereits fertig +einschließlich Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regeln die Anweisungen also die Anordnung der beiden -Teile der Überschrift. Bei nicht nummerierten Überschriften ist \PName{Nummer} -ein komplett leeres Argument, enthält also auch keine +Teile der Ãœberschrift. Bei nicht nummerierten Ãœberschriften ist \PName{Nummer} +ein komplett leeres Argument, enthält also auch keine Formatierungsanweisungen. Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit: @@ -1497,8 +1539,8 @@ Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit: %bisher eher spartanisch. \begin{Example} - Sie wollen Überschriften im Kapitelstil gelb hinterlegen. Für - Überschriften ohne Präfixzeile definieren Sie daher in der Präambel des + Sie wollen Ãœberschriften im Kapitelstil gelb hinterlegen. Für + Ãœberschriften ohne Präfixzeile definieren Sie daher in der Präambel des Dokument: \begin{lstcode}[moretexcs={colorbox}] \makeatletter @@ -1512,7 +1554,7 @@ Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit: } \makeatother \end{lstcode} - und für Überschriften mit Präfixzeile: + und für Ãœberschriften mit Präfixzeile: \begin{lstcode}[moretexcs={colorbox}] \renewcommand{\chapterlineswithprefixformat}[3]{% \colorbox{yellow}{% @@ -1523,9 +1565,9 @@ Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit: }% } \end{lstcode} - Allerdings fällt Ihnen nach einiger Zeit auf, dass mit dieser Umdefinierung - die Überschriften wieder im Blocksatz gesetzt werden. Das liegt daran, dass - \Macro{parbox} sein Argument so setzt. Um dies zu korrigieren, fügen Sie die + Allerdings fällt Ihnen nach einiger Zeit auf, dass mit dieser Umdefinierung + die Ãœberschriften wieder im Blocksatz gesetzt werden. Das liegt daran, dass + \Macro{parbox} sein Argument so setzt. Um dies zu korrigieren, fügen Sie die Anweisung \DescRef{maincls.cmd.raggedchapter} (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.raggedchapter}), die automatisch bereits vor \Macro{chapterlinesformat} und @@ -1554,28 +1596,28 @@ Vordefiniert\textnote{Voreinstellung} sind die beiden Anweisungen mit: } \end{lstcode} Es sei daran erinnert, dass die Klammerung mit den Anweisungen - \Macro{makeatletter} und \Macro{makeatother} nur in der Dokumentpräambel zu + \Macro{makeatletter} und \Macro{makeatother} nur in der Dokumentpräambel zu verwenden ist. In einer eigenen Wrapper-Klasse oder einem Paket haben sie zu entfallen. Sie werden auch nur wegen \Macro{@hangfrom} in der Definition von - \Macro{chapterlinesformat} benötigt.% + \Macro{chapterlinesformat} benötigt.% \end{Example} Wie im Beispiel gezeigt, ist der Anwender bei der Umdefinierung der -Anweisungen für einige Dinge selbst verantwortlich. Dazu gehört neben dem -Erhalt der voreingestellten Ausrichtung auch, dass innerhalb der Überschrift -kein Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder -Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich +Anweisungen für einige Dinge selbst verantwortlich. Dazu gehört neben dem +Erhalt der voreingestellten Ausrichtung auch, dass innerhalb der Ãœberschrift +kein Seitenumbruch, beispielsweise an zusätzlich eingefügten Absätzen oder +Abständen, erfolgen kann. Das gezeigte Beispiel ist diesbezüglich unproblematisch. Nicht nur, dass die beiden Boxen ohnehin keinen Seitenumbruch -erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil +erlauben. \KOMAScript{} verändert außerdem \Macro{interlinepenalty} als Teil von \PName{Text} so, dass darin kein Seitenumbruch stattfinden darf. Gleichzeitig endet \PName{Text} immer mit einem internen Absatz, \Macro{@@par}. -Die Anweisung \DescRef{maincls.cmd.raggedchapter} ist übrigens nicht +Die Anweisung \DescRef{maincls.cmd.raggedchapter} ist übrigens nicht Bestandteil von \PName{Text}, weil anderenfalls beispielsweise die Verwendung von \Macro{MakeUppercase} innerhalb der Umdefinierung der beiden Anweisungen -erheblich erschwert wäre. Dennoch sei darauf hingewiesen, dass typografischen -Regeln zufolge Versalsatz mit gängigen Fonts immer der Sperrung und des +erheblich erschwert wäre. Dennoch sei darauf hingewiesen, dass typografischen +Regeln zufolge Versalsatz mit gängigen Fonts immer der Sperrung und des Ausgleichs bedarf. Die \LaTeX-Anweisung \Macro{MakeUppercase} leistet dies jedoch nicht. @@ -1583,7 +1625,7 @@ Das erste Argument, \PName{Ebene}, wird von den Anweisungen in der Voreinstellung nicht verwendet und ist auch im Beispiel nicht erforderlich. Erst wenn der Anwender mehrere Anweisungen im Stil \PValue{chapter} definiert und man innerhalb der Definition nach den -Anweisungen unterscheiden will, kann dies über \PName{Ebene} erfolgen. Dabei +Anweisungen unterscheiden will, kann dies über \PName{Ebene} erfolgen. Dabei ist \PName{Ebene} der vom Namen der Anweisung abgeleitete Name der Gliederungsebene. Bei \DescRef{maincls.cmd.chapter}, \DescRef{maincls.cmd.chapter*}, \DescRef{maincls.cmd.addchap} und @@ -1599,24 +1641,24 @@ Gliederungsebene. Bei \DescRef{maincls.cmd.chapter}, \Parameter{Ebene}\Parameter{Einzug}\Parameter{Nummer}\Parameter{Text} \end{Declaration} Diese\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} Anweisungen werden von Überschriften des Stils + \Class{scrartcl}} Anweisungen werden von Ãœberschriften des Stils \PValue{section}\textnote{Gliederungsstil - \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} in Abhängigkeit -davon verwendet, ob die jeweilige Überschrift eine Spitzmarke erzeugt oder -eine frei stehende Überschrift. Frei stehende Überschriften werden dabei per -\Macro{sectionlinesformat} ausgegeben, während -\Macro{sectioncatchphraseformat} für Spitzmarken zuständig ist. - -In beiden Fällen gibt \PName{Einzug} den Wert eines horizontalen Einzugs -der Überschrift gegenüber dem Textbereich an. Durch Angabe eines negativen -Wertes soll es auch möglich sein, die Überschrift in den linken Rand zu -rücken. - -Die beiden Argumente \PName{Nummer} und \PName{Text} sind einschließlich -Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regeln die -Anweisungen also die Anordnung der beiden Teile der Überschrift. Bei nicht -nummerierten Überschriften ist \PName{Nummer} ein komplett leeres Argument, -enthält also auch keine Formatierungsanweisungen. + \PValue{section}}\Index{Gliederung>Stil>~\PValue{section}} in Abhängigkeit +davon verwendet, ob die jeweilige Ãœberschrift eine Spitzmarke erzeugt oder +eine frei stehende Ãœberschrift. Frei stehende Ãœberschriften werden dabei per +\Macro{sectionlinesformat} ausgegeben, während +\Macro{sectioncatchphraseformat} für Spitzmarken zuständig ist. + +In beiden Fällen gibt \PName{Einzug} den Wert eines horizontalen Einzugs +der Ãœberschrift gegenüber dem Textbereich an. Durch Angabe eines negativen +Wertes soll es auch möglich sein, die Ãœberschrift in den linken Rand zu +rücken. + +Die beiden Argumente \PName{Nummer} und \PName{Text} sind einschließlich +Einstellung der Fonts für sich bereits fertig formatiert. Letztlich regeln die +Anweisungen also die Anordnung der beiden Teile der Ãœberschrift. Bei nicht +nummerierten Ãœberschriften ist \PName{Nummer} ein komplett leeres Argument, +enthält also auch keine Formatierungsanweisungen. Vordefiniert sind die beiden Anweisungen als: \begin{lstcode} @@ -1629,15 +1671,15 @@ Vordefiniert sind die beiden Anweisungen als: \end{lstcode} Bei Umdefinierung einer der beiden Anweisungen ist wiederum der Anwender -selbst dafür verantwortlich, Seitenumbrüche innerhalb der Ausgabe zu +selbst dafür verantwortlich, Seitenumbrüche innerhalb der Ausgabe zu verhindern. \KOMAScript{} hilft hier lediglich mit entsprechend gesetztem \Macro{interlinepenalty}. \begin{Example} - Wie schon im Beispiel der Kapitelüberschriften sollen nun die frei stehenden - Überschriften der Ebenen \PValue{section} mit einer Farbe hinterlegt - werden. Die frei stehenden Überschriften tieferer Ebenen sollen nicht - verändert werden: + Wie schon im Beispiel der Kapitelüberschriften sollen nun die frei stehenden + Ãœberschriften der Ebenen \PValue{section} mit einer Farbe hinterlegt + werden. Die frei stehenden Ãœberschriften tieferer Ebenen sollen nicht + verändert werden: \begin{lstcode}[moretexcs={colorbox}] \makeatletter \renewcommand{\sectionlinesformat}[4]{% @@ -1656,22 +1698,22 @@ verhindern. \KOMAScript{} hilft hier lediglich mit entsprechend gesetztem } \makeatother \end{lstcode} - Mit dem gezeigten Code wird im Falle eines Einzugs der Überschrift der - Bereich des Einzugs nicht mit gefärbt. Wird hingegen die Überschrift in den + Mit dem gezeigten Code wird im Falle eines Einzugs der Ãœberschrift der + Bereich des Einzugs nicht mit gefärbt. Wird hingegen die Ãœberschrift in den linken Rand gestellt, so wird dieser Bereich des Randes ebenfalls farbig hinterlegt. Durch Verschiebung der \Macro{hspace*}-Anweisung in die - \Macro{colorbox} kann dieses Verhalten verändert werden.% + \Macro{colorbox} kann dieses Verhalten verändert werden.% \iffalse Umbruchkorrekturtext Erneut sei daran erinnert, dass \Macro{makeatletter} und \Macro{makeatother} - nur in der Dokumentpräambel zu verwenden sind. In einer eigenen + nur in der Dokumentpräambel zu verwenden sind. In einer eigenen Wrapper-Klasse oder einem Paket haben sie zu entfallen. Sie werden auch nur wegen \Macro{@hangfrom} in der Definition von \Macro{sectionlinesformat} - benötigt.% + benötigt.% \else% - \Macro{makeatletter} und \Macro{makeatother} werden in der Dokumentpräambel - erneut wegen \Macro{@hangfrom} benötigt.% + \Macro{makeatletter} und \Macro{makeatother} werden in der Dokumentpräambel + erneut wegen \Macro{@hangfrom} benötigt.% \fi% \end{Example} @@ -1683,89 +1725,185 @@ Stil \PValue{section} zu unterscheiden.% \begin{Declaration} +\DoHook{heading/preinit/\PName{Name}}% +\DoHook{heading/postinit/\PName{Name}}% +\DoHook{heading/branch/star/\PName{Name}}% +\DoHook{heading/branch/nostar/\PName{Name}}% +\DoHook{heading/begingroup/\PName{Name}}% +\DoHook{heading/endgroup/\PName{Name}}% +\end{Declaration} +\BeginIndex{}{Haken}% +Neben\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} den übrigen Einstellmöglichkeiten bieten sämtliche mit +\DescRef{\LabelBase.cmd.DeclareSectionCommand}, +\DescRef{\LabelBase.cmd.DeclareNewSectionCommand} und +\DescRef{\LabelBase.cmd.ProvideSectionCommand} definierten oder mit +\DescRef{\LabelBase.cmd.RedeclareSectionCommand} umdefinierten +Gliederungsanweisungen eine ganze Reihe an Haken, die per +\DescRef{scrbase.cmd.AddtoDoHook} manipuliert werden können. Zur +Funktionsweise dieser \emph{do-hook} genannten Haken sei auf +\autoref{sec:scrbase.hooks} ab \autopageref{sec:scrbase.hooks} +verwiesen. Der letzte Teil des Spezifikators ist dabei der \PName{Name} der +Gliederungsanweisung, wie er auch bei den oben genannten Befehlen als letztes +Argument anzugeben ist. + +Wichtig\important{Achtung!} ist, dass keiner dieser Haken für Anweisungen +verwendet werden sollte, die Auswirkungen auf den Seitenumbruch oder die +Positionierung der Ãœberschriften haben. Daher sollten nur wirklich erfahrene +Anwender Gebrauch von diesen Haken machen. Im Zweifelsfall ist außerdem der +Quellcode der Klasse bezüglich des genauen Ausführungszeitpunktes des +jeweiligen Haken zu konsultieren. Diese Haken dienen als letzter Notanker vor +einer tatsächlichen Umdefinierung von Gliederungsbefehlen außerhalb der von +\KOMAScript{} gebotenen Mittel. + +Der\textnote{\DoHook{\dots/preinit/\dots}} Haken +\DoHook{heading/preinit/\PName{Name}} wird unmittelbar vor der +Initialisierung der Anweisungen ausgeführt. Zu diesem Zeitpunkt wurden noch +keine Einstellungen vorgenommen. Selbst der Absatz, der einer Ãœberschrift +voraus geht, ist noch nicht zwingend beendet. + +Der\textnote{\DoHook{\dots/postinit/\dots}} Haken +\DoHook{heading/postinit/\PName{Name}} wird etwas später ausgeführt. Zu +diesem Zeitpunkt wurden einige Einstellungen bereits vorgenommen und auch ein +vorausgehender Absatz wurde bereits beendet. + +Von\textnote{\DoHook{\dots/branch/\dots}} den Haken +\DoHook{heading/branch/nostar/\PName{Name}} oder +\DoHook{heading/branch/star/\PName{Name}} wird jeweils nur einer ausgeführt, +sobald feststeht, ob die Sternform oder die Normalform der +Gliederungsanweisung ausgeführt wird. Zu diesem Zeitpunkt sind auch bereits +vertikale Abstände über der jeweiligen Ãœberschrift ausgeführt. + +Der\textnote{\DoHook{\dots/begingroup/\dots}} Haken +\DoHook{heading/begingroup/\PName{Name}} wird am Anfang der Gruppe +ausgeführt, in der schließlich die Ãœberschrift gesetzt wird. Das ist also die +letzte Eingriffsmöglichkeit vor der Ausgabe der Ãœberschrift. + +Entsprechend\textnote{\DoHook{\dots/begingroup/\dots}} wird +\DoHook{heading/endgroup/\PName{Name}} vor dem Ende der Gruppe ausgeführt, in +der die Ãœberschrift gesetzt wurde. Derzeit ist das auch der letzte Haken +innerhalb einer Gliederungsanweisung. + +Zu beachten\textnote{\DescRef{maincls.cmd.minisec}} ist, dass +\DescRef{maincls.cmd.minisec} keine echte Gliederungsanweisung ist und die +genannten Haken daher auf diese Anweisung keine Anwendung finden.% +\EndIndexGroup + + +\begin{Declaration} + \Macro{IfUseNumber}\Parameter{Dann-Code}\Parameter{Sonst-Code} +\end{Declaration} +Streng\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} genommen handelt es sich hier um eine interne +Anweisung. Sie ist nur innerhalb von Ãœberschriften von Haken +\DoHook{\dots/begingroup/\dots} bis \DoHook{\dots/endgroup/\dots} +spezifiziert. In diesem Fall wird der \PName{Dann-Code} ausgeführt, wenn die +aktuelle Ãœberschrift gemäß Einstellung von +\DescRef{maincls.counter.secnumdepth} und Aufgrund der Nichtverwendung einer +Sternform nummeriert werden soll. Soll die Ãœberschrift aufgrund der Verwenudng +einer Sternform oder der Einstellung von \DescRef{maincls.counter.secnumdepth} +nicht nummeriert werden, so wird der \PName{Sonst-Code} ausgeführt. Bei +Ãœberschriften im Stil \PValue{chapter} wird für die Entscheidung außerdem +berücksichtigt, ob die Ãœberschrift im Hauptteil gesetzt wird. + +Wird die Anweisung außerhalb von +Ãœberschriften verwendet, so ist ihr Ergebnis nicht spezifiziert. In der Regel +gibt sie dann eine Fehlermeldung aus und führt weder den \PName{Dann-Code} +noch den \PName{Sonst-Code} aus.% +\EndIndexGroup + + +\begin{Declaration} \Macro{SecDef}\Parameter{Sternanweisung}\Parameter{Normalanweisung} \Macro{scr@startsection}\Parameter{Name}\Parameter{Ebene}% \Parameter{Einzug}\Parameter{Abstand~davor}\Parameter{Abstand~danach} \Parameter{Stilanweisungen}% - \OParameter{Kurzform}\Parameter{Überschrift} + \OParameter{Kurzform}\Parameter{Ãœberschrift} \labelsuffix[*]% \Macro{scr@startsection}\Parameter{Name}\Parameter{Ebene}% \Parameter{Einzug}\Parameter{Abstand~davor} \Parameter{Abstand~danach} \Parameter{Stilanweisungen}% - \nobreak\texttt{*}\Parameter{Überschrift} + \nobreak\texttt{*}\Parameter{Ãœberschrift} \labelsuffix - \Macro{At@startsection}\Parameter{Code} - \Macro{Before@ssect}\Parameter{Code} - \Macro{Before@sect}\Parameter{Code} \end{Declaration} -Wie\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and +Wie\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} bereits in \autoref{sec:maincls.structure} bei der Beschreibung zu den Gliederungsbefehlen ab -\DescPageRef{maincls.cmd.chapter} erklärt, verfügt \KOMAScript{} -bezüglich des optionalen Arguments der Gliederungsbefehle über erweiterte -Möglichkeiten. Um dies zu erreichen, war es notwendig, einige Anweisungen -des \LaTeX-Kerns zu ersetzen. Dazu gehören auch die Anweisungen -\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} und -\Macro{@startsection}\IndexCmd{@startsection}% -\important{\Macro{@startsection}}. Die Bedeutung der Parameter dieser -Anweisungen ist der Anleitung zum \LaTeX-Kern \cite{latex:source2e} zu -entnehmen. - -Da diese Anweisungen jedoch auch häufig von Paketen komplett neu definiert -werden und dadurch die Funktion von \KOMAScript{} teilweise stark -beeinträchtigt werden kann, wurden die genannten \LaTeX-Kern-Anweisungen nicht -einfach nur umdefiniert, sondern es wurden zusätzlich die alternativen -Anweisungen \Macro{SecDef} und \Macro{scr@startsection} definiert. Diese -können von Paketautoren genau wie die \LaTeX-Kern-Anweisungen verwendet -werden, bieten dann aber automatisch die erweiterte Funktionalität von -\KOMAScript{}. Die beiden Anweisungen sollten jedoch nicht umdefiniert werden, -da sie sich jederzeit ändern können und dann die Funktionalität von -\KOMAScript{} durch diese Umdefinierung erneut beeinträchtigt werden -könnte. - -\KOMAScript{} selbst verwendet intern die Anweisungen -\Macro{SecDef}\important{\Macro{SecDef}\\\Macro{scr@startsection}} und -\Macro{scr@startsection} anstelle von \Macro{secdef} und \Macro{@startsection} -beispielsweise bei den mit \DescRef{\LabelBase.cmd.DeclareSectionCommand} -definierten Gliederungsbefehlen. Eine nachträgliche Umdefinierung von -\Macro{secdef} und \Macro{@startsection} hat daher keine Auswirkungen auf -diese Gliederungsbefehle. - -Als Ersatz für die Umdefinierung der Anweisungen bietet \KOMAScript{} die -Möglichkeit, zusätzlichen \PName{Code} in die Ausführung der -\KOMAScript-eigenen Erweiterungen einzufügen. Der \PName{Code} aller Aufrufe -der Anweisungen \Macro{At@startsection}\important{\Macro{At@startsection}\\ - \Macro{Before@sect}\\ - \Macro{Before@@sect}}, \Macro{Before@sect} und -\Macro{Before@@sect} wird für die einzelnen Anweisungen getrennt aufgesammelt. -Es ist nicht vorgesehen, einmal eingefügten Code wieder zu entfernen. - -Der \PName{Code} von Makro -\Macro{At@startsection}\important{\Macro{At@startsection}\\ - \Macro{scr@startsection}} wird dabei in Anweisung \Macro{scr@startsection} -unmittelbar nach der Auswertung von Parameter \PName{Abstand davor} und der -zugehörigen Berechnung des resultierenden \Length{@tempskipa} aber noch vor -Einfügen des Abstandes angewendet. Es ist damit also noch möglich, diesen -Abstand über \Length{@tempskipa} zu verändern. - -Der \PName{Code} von \Macro{Before@sect}\important{\Macro{Before@sect}\\ - \Macro{@sect}} beziehungsweise -\Macro{Before@ssect}\important{\Macro{Before@ssect}\\ - \Macro{@ssect}} wird unmittelbar vor dem Aufruf von \Macro{@sect} respektive -\Macro{@ssect} innerhalb von -\Macro{scr@startsection}\important{\Macro{scr@startsection}} ausgeführt. Zu -diesem Zeitpunkt ist gegebenenfalls der vertikale Abstand vor der Überschrift -bereits über \Macro{addvspace} eingefügt. - -Die drei Anweisungen \Macro{At@startsection}\important{\Macro{At@startsection}\\ - \Macro{Before@sect}\\ - \Macro{Before@ssect}}, \Macro{Before@sect} und \Macro{Before@ssect} sind als -Schnittstelle für Paketautoren entworfen und für diese zur Verwendung -freigegeben.% +\DescPageRef{maincls.cmd.chapter} erklärt, verfügt \KOMAScript{} +bezüglich des optionalen Arguments der Gliederungsbefehle über erweiterte +Möglichkeiten. Um dies zu erreichen, war es notwendig, einige Anweisungen +des \LaTeX-Kerns zu ersetzen: +\begin{itemize} +\item Statt + \Macro{@startsection}\IndexCmd{@startsection}\important{\Macro{@startsection}} + wird von \KOMAScript{} \Macro{scr@startsection} verwendet. Die Definition + von \Macro{@startsection} wird jedoch geprüft. Entspricht diese beim Laden + der Klasse nicht den Erwartungen, so wird eine Warnung ausgegeben, diverse + Möglichkeiten von \KOMAScript{} werden deaktiviert und + \Macro{scr@startsection} stützt sich auf eine Kopie von + \Macro{@startsection}, während \Macro{@startsection} selbst dann + \Macro{scr@startsection} aufruft. +\item Statt \Macro{@dblarg}\IndexCmd{@dblarg}\important{\Macro{@dblarg}} wird + in \KOMAScript{} von den Gliederungsbefehlen eine eigene, interne Anweisung + verwendet. +\item Statt \Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} wird + von \KOMAScript{} \Macro{SecDef} verwendet, um die erwähnte Änderung + bezüglich \Macro{@dblarg} zu erreichen. Sollte die Definition von + \Macro{secdef} nicht den Erwartungen entsprechen, wird eine Warnung + ausgegeben. +\item \Macro{@sect}\IndexCmd{@sect}\important{\Macro{@sect}} wird umdefiniert, + um diverse Erweiterungen von \KOMAScript{} zu realisieren. +\item \Macro{@ssect}\IndexCmd{@ssect}\important{\Macro{@ssect}} wird + umdefiniert, um diverse Erweiterungen von \KOMAScript{} zu realisieren. +\item \Macro{@xsect}\IndexCmd{@xsect}\important{\Macro{@xsect}} wird + umdefiniert, um diverse Erweiterungen von \KOMAScript{} zu realisieren. +\end{itemize} +Es gibt Ãœberlegungen, in künftigen Versionen von \KOMAScript{} die erwähnten +Anweisungen aus dem \LaTeX-Kern nicht mehr anzutasten, sondern intern komplett +durch Eigenentwicklungen zu ersetzen. Bei Verwendung eigentlich inkompatibler +Pakete würden dadurch automatisch Erweiterungen von \KOMAScript{} deaktiviert +und die Gliederungsbefehle in die Hände jener Pakete gelegt. Gleichzeitig +müssten aber zum Erhalt der Kompatibilität mit anderen Paketen zusätzliche +Maßnahmen ergriffen werden. + +Die erwähnten Ersatzanweisungen können von Paketautoren genau wie die +\LaTeX-Kern-Anweisungen verwendet werden, bieten dann aber automatisch die +erweiterte Funktionalität von \KOMAScript{}. Jedoch sollten sie nicht +umdefiniert werden, da sie sich jederzeit ändern können und dann die +Funktionalität von \KOMAScript{} durch diese Umdefinierung erneut +beeinträchtigt werden könnte. Die Bedeutung der Parameter ist der +Anleitung zum \LaTeX-Kern \cite{latex:source2e} zu entnehmen. +Als\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} Ersatz für die Umdefinierung von Anweisungen bietet +\KOMAScript{} die zuvor dokumentierten Haken.% \EndIndexGroup -% \subsection{Anhang} +\begin{Explain} + \begin{Declaration} + \Macro{At@startsection}\Parameter{Code} + \Macro{Before@ssect}\Parameter{Code} + \Macro{Before@sect}\Parameter{Code} + \end{Declaration} + Bis\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} \KOMAScript{}~v3.26b dienten diese Anweisungen ebenfalls + als Ersatz für die Umdefinierung von + \DescRef{\LabelBase.cmd.scr@startsection} und + \DescRef{\LabelBase.cmd.SecDef}. Seit\textnote{veraltete + \KOMAScript-Anweisungen} \KOMAScript~v3.27 gelten sie jedoch als veraltet. + + Intern wird \Macro{At@startsection} nun über den Haken + \DescRef{\LabelBase.dohook.heading/postinit} + realisiert. \Macro{Before@ssect} ist mit Hilfe von + \DescRef{\LabelBase.dohook.heading/branch/star} und \Macro{Before@sect} über + \DescRef{\LabelBase.dohook.heading/branch/nostar} implementiert. Der + \PName{Code} wird den Haken per \DescRef{scrbase.cmd.AddtoDoHook} + hinzugefügt. Es ist nicht vorgesehen, einmal eingefügten Code wieder zu + entfernen.% + \EndIndexGroup +\end{Explain} + +% \section{Anhang} % \seclabel{appendix} \begin{Declaration} @@ -1775,30 +1913,30 @@ Bei den {\KOMAScript}-Klassen gibt es innerhalb der Anweisung \DescRef{maincls.cmd.appendix}% \IndexCmd{appendix}\important{\DescRef{maincls.cmd.appendix}} eine Besonderheit. Ist \Macro{appendixmore} definiert, so wird diese Anweisung von -\DescRef{maincls.cmd.appendix} ebenfalls ausgeführt. Intern wird das von den +\DescRef{maincls.cmd.appendix} ebenfalls ausgeführt. Intern wird das von den {\KOMAScript}-Klassen \Class{scrbook}\OnlyAt{\Class{scrbook}\and - \Class{scrreprt}} und \Class{scrreprt} für die Realisierung der Layoutoption + \Class{scrreprt}} und \Class{scrreprt} für die Realisierung der Layoutoption \DescRef{maincls.option.appendixprefix} genutzt (siehe \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.appendixprefix}). Dies\textnote{Achtung!} sollten Sie unbedingt beachten, falls Sie selbst das Makro \Macro{appendixmore} definieren oder umdefinieren wollen. Ist diese Option bereits verwendet, so erhalten Sie bei \verb|\newcommand{\appendixmore}{|\dots\verb|}| eine -Fehlermeldung. Dadurch wird verhindert, dass Sie die Optionen außer +Fehlermeldung. Dadurch wird verhindert, dass Sie die Optionen außer Kraft setzen, ohne es zu merken. \begin{Example} Sie wollen nicht, dass bei Verwendung der Klasse \Class{scrbook} oder - \Class{scrreprt} im Hauptteil die Kapitel mit einer Präfixzeile versehen + \Class{scrreprt} im Hauptteil die Kapitel mit einer Präfixzeile versehen werden (siehe Layoutoption \DescRef{maincls.option.chapterprefix} in \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.chapterprefix}). Damit die Konsistenz gewahrt bleibt, wollen Sie auch nicht, dass eine solche Zeile im Anhang - verwendet wird. Stattdessen soll in den Anhängen direkt vor dem - Kapitelbuchstaben das Wort »Anhang« in der jeweiligen Sprache stehen. Dies - soll auch für die Kolumnentitel gelten. Also verwenden Sie nicht die + verwendet wird. Stattdessen soll in den Anhängen direkt vor dem + Kapitelbuchstaben das Wort »Anhang« in der jeweiligen Sprache stehen. Dies + soll auch für die Kolumnentitel gelten. Also verwenden Sie nicht die Layoutoption \DescRef{maincls.option.appendixprefix}, sondern - definieren in der Dokumentpräambel: + definieren in der Dokumentpräambel: \begin{lstcode} \newcommand*{\appendixmore}{% \renewcommand*{\chapterformat}{% @@ -1811,11 +1949,11 @@ Kraft setzen, ohne es zu merken. \DescRef{maincls.cmd.documentclass} setzen wollen, so erhalten Sie aufgrund der dann bereits definierten Anweisung \Macro{appendixmore} eine Fehlermeldung. Damit wird verhindert, dass obige Definition unbemerkt die - Einstellungen überschreibt, die Sie per Option getroffen haben. + Einstellungen überschreibt, die Sie per Option getroffen haben. - Wenn Sie ein vergleichbares Verhalten des Anhangs für die Klasse - \Class{scrartcl} erreichen wollen, so ist dies ebenfalls möglich. Schreiben - Sie dazu beispielsweise Folgendes in die Präambel Ihres Dokuments: + Wenn Sie ein vergleichbares Verhalten des Anhangs für die Klasse + \Class{scrartcl} erreichen wollen, so ist dies ebenfalls möglich. Schreiben + Sie dazu beispielsweise Folgendes in die Präambel Ihres Dokuments: \begin{lstcode}[moretexcs={ifthenelse,equal}] \newcommand*{\appendixmore}{% \renewcommand*{\sectionformat}{% @@ -1824,7 +1962,7 @@ Kraft setzen, ohne es zu merken. \appendixname~\thesection\autodot\enskip}} \end{lstcode} - Die Erklärungen zu den in diesem Beispiel umdefinierten Anweisungen finden + Die Erklärungen zu den in diesem Beispiel umdefinierten Anweisungen finden Sie in \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.chapterformat} und \DescPageRef{maincls.cmd.chaptermarkformat}. @@ -1832,8 +1970,13 @@ Kraft setzen, ohne es zu merken. % \EndIndexGroup -% \subsection{Literaturverzeichnis} -% \seclabel{bibliography} +\section{Literaturverzeichnis} +\seclabel{bibliography} + +Die Erklärungen in diesem Abschnitt verlieren mit der Verwendung von Paketen +wie \Package{biblatex} zunehmend an Bedeutung. Die weitreichenden +Möglichkeiten solcher Pakete ersetzen dann die hier beschriebenen +Erweiterungen der \KOMAScript-Klassen. \begin{Declaration} \Macro{newbibstyle}\OParameter{Elternstil}\Parameter{Name}% @@ -1844,49 +1987,49 @@ Kraft setzen, ohne es zu merken. \Macro{bib@endhook} \end{Declaration} Schon die Standardklassen\textnote{Standardklassen} kennen zur Unterteilung -der Einträge in das Literaturverzeichnis die Anweisung \Macro{newblock}. Was -diese Anweisung genau macht, hängt dabei von den Klassenoptionen ab. Wird die +der Einträge in das Literaturverzeichnis die Anweisung \Macro{newblock}. Was +diese Anweisung genau macht, hängt dabei von den Klassenoptionen ab. Wird die Option \Option{openbib}\important{\Option{openbib}} verwendet, so werden am Ende der Standardklasse die Anweisungen \Macro{@openbib@code} und \Macro{newblock} selbst umdefiniert. Von den Standardklassen wird die -Anweisung \Macro{@openbib@code} beim Start der Liste für das -Literaturverzeichnis --~genauer: bei der Festlegung der Parameter für diese -Liste~-- ausgeführt. Es darf davon ausgegangen werden, dass auch viele Pakete, +Anweisung \Macro{@openbib@code} beim Start der Liste für das +Literaturverzeichnis --~genauer: bei der Festlegung der Parameter für diese +Liste~-- ausgeführt. Es darf davon ausgegangen werden, dass auch viele Pakete, die das Literaturverzeichnis umdefinieren, diese Anweisung entsprechend abarbeiten. Bei den \KOMAScript-Klassen\textnote{\KOMAScript} geschieht etwas -ähnliches. Allerdings wird \Macro{@openbib@code} nicht am Ende der Klasse +ähnliches. Allerdings wird \Macro{@openbib@code} nicht am Ende der Klasse umdefiniert. Stattdessen wird mit \Macro{newbibstyle} der Stil -\PValue{openstyle} für das Literaturverzeichnis definiert. Die +\PValue{openstyle} für das Literaturverzeichnis definiert. Die \PName{Anweisungen}, die dabei in der Implementierung angegeben wurden, -beinhalten die gewünschten Umdefinierung von \Macro{@openbib@code} und von +beinhalten die gewünschten Umdefinierung von \Macro{@openbib@code} und von \Macro{newblock}. Wird nun mit Hilfe der Option \OptionValueRef{maincls}{bibliography}{openstyle}% \IndexOption{bibliography~=\textKValue{openstyle}}% \important{\OptionValueRef{maincls}{bibliography}{openstyle}} dieser -Literaturverzeichnisstil gewählt, so werden die \PName{Anweisungen} -unmittelbar ausgeführt, also \Macro{@openbib@code} und \Macro{newblock} +Literaturverzeichnisstil gewählt, so werden die \PName{Anweisungen} +unmittelbar ausgeführt, also \Macro{@openbib@code} und \Macro{newblock} umdefiniert. -Neben \Macro{@openbib@code} und \Macro{newblock} können in \PName{Anweisungen} +Neben \Macro{@openbib@code} und \Macro{newblock} können in \PName{Anweisungen} auch noch \Macro{bib@beginhook} und \Macro{bib@endhook} umdefiniert werden. Die Anweisung \Macro{bib@beginhook} wird unmittelbar nach der -Überschrift und der Präambel des Literaturverzeichnisses, aber noch vor der -Liste mit den Literatureinträgen ausgeführt. Die Anweisung \Macro{bib@endhook} +Ãœberschrift und der Präambel des Literaturverzeichnisses, aber noch vor der +Liste mit den Literatureinträgen ausgeführt. Die Anweisung \Macro{bib@endhook} wird direkt nach dieser Liste am Ende des Literaturverzeichnisses -ausgeführt. Im Falle eines mit \DescRef{maincls.cmd.BreakBibliography} (siehe +ausgeführt. Im Falle eines mit \DescRef{maincls.cmd.BreakBibliography} (siehe \autoref{sec:maincls.bibliography}, \DescPageRef{maincls.cmd.BreakBibliography}) unterbrochenen -Literaturverzeichnisses werden diese Anweisungen außerdem am Anfang und Ende +Literaturverzeichnisses werden diese Anweisungen außerdem am Anfang und Ende jedes Teils, also unmittelbar vor und nach -\DescRef{maincls.cmd.BreakBibliography} ausgeführt. +\DescRef{maincls.cmd.BreakBibliography} ausgeführt. Die Anweisungen \Macro{newblock}, \Macro{@openbib@code}, \Macro{bib@beginhook} und \Macro{bib@endhook} werden bei der Verwendung eines -neuen Literaturverzeichnisstils zunächst als leer definiert. Danach werden die +neuen Literaturverzeichnisstils zunächst als leer definiert. Danach werden die \PName{Anweisungen} des bei der Definition des Stils optional angegebenen -Elternstils ausgeführt und dann erst die \PName{Anweisungen}, die bei +Elternstils ausgeführt und dann erst die \PName{Anweisungen}, die bei Definition des neuen Stils angegeben wurden. Daraus ergibt sich auch, dass jede der vier Anweisungen innerhalb von \PName{Anweisung} bei Bedarf keinesfalls mit \Macro{newcommand}, sondern mit @@ -1895,20 +2038,20 @@ definiert werden sollte. Setzt der Anwender mit den Anweisungen \DescRef{maincls.cmd.AtEndBibliography}%\important[i]{\DescRef{maincls.cmd.AtEndBibliography}\\ -% \DescRef{maincls.cmd.AfterBibliographyPreamble}}% Passt blöder Weise nicht! +% \DescRef{maincls.cmd.AfterBibliographyPreamble}}% Passt blöder Weise nicht! \IndexCmd{AtEndBibliography} und \DescRef{maincls.cmd.AfterBibliographyPreamble}% -\IndexCmd{AfterBibliographyPreamble} weitere \PName{Anweisungen} für die -Ausführung nach der Präambel und am Ende des Literaturverzeichnisses, so +\IndexCmd{AfterBibliographyPreamble} weitere \PName{Anweisungen} für die +Ausführung nach der Präambel und am Ende des Literaturverzeichnisses, so werden die mit \DescRef{maincls.cmd.AfterBibliographyPreamble} festgelegten \PName{Anweisungen} einmalig am Anfang des Literaturverzeichnisses nach \Macro{bib@beginhook} und die mit \DescRef{maincls.cmd.AtEndBibliography} festgelegten \PName{Anweisungen} einmalig am Ende des Literaturverzeichnisses -vor \Macro{bib@endhook} ausgeführt. +vor \Macro{bib@endhook} ausgeführt. Mit\textnote{Beispiel!} Hilfe des Pakets \Package{multicol}\IndexPackage{multicol}\important{\Package{multicol}} (siehe -\cite{package:multicol}) könnte man beispielsweise einen Literaturstil für ein +\cite{package:multicol}) könnte man beispielsweise einen Literaturstil für ein zweispaltiges Literaturverzeichnis definieren: % Umbruchkorrektur: listings korrigiert \begin{lstcode} @@ -1916,8 +2059,8 @@ zweispaltiges Literaturverzeichnis definieren: \renewcommand*{\bib@beginhook}{\begin{multicols}{2}}% \renewcommand*{\bib@endhook}{\end{multicols}}}% \end{lstcode} -Soll es außerdem eine \emph{open}-Variante davon geben, kann man hier die -Möglichkeiten der Vererbung verwenden und bei der Definition einen Elternstil +Soll es außerdem eine \emph{open}-Variante davon geben, kann man hier die +Möglichkeiten der Vererbung verwenden und bei der Definition einen Elternstil mit angeben: % Umbruchkorrektur: listings korrigiert \begin{lstcode} @@ -1925,7 +2068,7 @@ mit angeben: \renewcommand*{\bib@beginhook}{\begin{multicols}{2}}% \renewcommand*{\bib@endhook}{\end{multicols}}}% \end{lstcode} -Die Auswahl eines dieser neuen Stile erfolgt dann einfach wieder über die +Die Auswahl eines dieser neuen Stile erfolgt dann einfach wieder über die Option \DescRef{maincls.option.bibliography}. Wie\textnote{Achtung!} schon \DescRef{maincls.cmd.BreakBibliography} verlieren @@ -1948,21 +2091,21 @@ umdefiniert wird.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "guide.tex" %%% End: -% LocalWords: Sternvarianten Kapitelüberschrift Standardklassen Paketautoren +% LocalWords: Sternvarianten Kapitelüberschrift Standardklassen Paketautoren % LocalWords: Klassenoptionen Gliederungsbefehlen Namensliste umzudefinieren % LocalWords: Inhaltsverzeichniseintrags Abstandsanweisungen Sternformen -% LocalWords: Teilüberschriften Benutzerfreundlichkeit Absatzmarkierung -% LocalWords: umkonfiguriert Teileüberschrift Abschnittsüberschrift -% LocalWords: Absolutwert Gliederungsbefehls Präfixzeile Schrifteinstellung -% LocalWords: Zählername Spitzmarke Kolumnentitels Schrifteinstellungen -% LocalWords: Strichstärke expandierbar expandierbaren expandierbares +% LocalWords: Teilüberschriften Benutzerfreundlichkeit Absatzmarkierung +% LocalWords: umkonfiguriert Teileüberschrift Abschnittsüberschrift +% LocalWords: Absolutwert Gliederungsbefehls Präfixzeile Schrifteinstellung +% LocalWords: Zählername Spitzmarke Kolumnentitels Schrifteinstellungen +% LocalWords: Strichstärke expandierbar expandierbaren expandierbares % LocalWords: spartanisch Kapitelstil Spitzmarken Formatierungsanweisungen -% LocalWords: Kapitelüberschriften Gliederungsebenen Verzeichniseinträge +% LocalWords: Kapitelüberschriften Gliederungsebenen Verzeichniseinträge % LocalWords: Verzeichniseintragsstile Gliederungsbefehl Verzeichniseintrag % LocalWords: Verzeichniseintrags Verzeichniseintragsstilen Gliederungsstil -% LocalWords: Gliederungsebene Eintragsebenen Absatzeinzug Dokumentpräambel +% LocalWords: Gliederungsebene Eintragsebenen Absatzeinzug Dokumentpräambel diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle.tex index 58b51a63fa..12b493c5f7 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrbookreportarticle.tex @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrbook, scrreprt und scrartcl in der KOMA-Script-Anleitung +% Kapitel über scrbook, scrreprt und scrartcl in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrbookreportarticle.tex} - [$Date: 2019-01-14 14:29:39 +0100 (Mon, 14 Jan 2019) $ + [$Date: 2019-10-09 17:14:53 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)] \chapter{Die Hauptklassen \Class{scrbook}, \Class{scrreprt}, \Class{scrartcl}} @@ -58,25 +58,25 @@ \AddSeeIndex{Anweisung}{gen}{\GuidecmdIndexShort}{cmd}% \AddSeeIndex{Makro}{gen}{\GuidecmdIndexShort}{cmd}% -Die Hauptklassen des \KOMAScript-Pakets sind als Äquivalent zu den +Die Hauptklassen des \KOMAScript-Pakets sind als Äquivalent zu den \LaTeX-Standard"-klassen angelegt. Das bedeutet, dass zu den drei Standardklassen \Class{book}\IndexClass{book}, \Class{report}% \IndexClass{report} und \Class{article}\IndexClass{article} im -\KOMAScript-Paket Entsprechungen zu finden sind. Daneben ist auch für die +\KOMAScript-Paket Entsprechungen zu finden sind. Daneben ist auch für die Standardklasse \Class{letter}\IndexClass{letter} eine Entsprechung vorhanden. Der Briefklasse in {\KOMAScript} ist jedoch ein eigenes Kapitel gewidmet, da -sie sich von den drei Hauptklassen grundsätzlich unterscheidet (siehe +sie sich von den drei Hauptklassen grundsätzlich unterscheidet (siehe \autoref{cha:scrlttr2}). -Die einfachste Möglichkeit, anstelle einer Standardklasse eine +Die einfachste Möglichkeit, anstelle einer Standardklasse eine \KOMAScript-Klasse zu verwenden, ist das Ersetzen des Klassennamens in der Anweisung \verb|\documentclass| entsprechend \autoref{tab:maincls.overview}. Man tauscht also beispielsweise \Macro{documentclass}\PParameter{book} gegen -\Macro{documentclass}\PParameter{scrbook}. Der anschließende \LaTeX-Lauf -sollte lediglich einige Layoutänderungen mit sich bringen. Ein großer Teil der -in den nachfolgenden Abschnitten beschriebenen vielfältigen Möglichkeiten und -Optionen werden von den \KOMAScript-Klassen zusätzlich geboten. +\Macro{documentclass}\PParameter{scrbook}. Der anschließende \LaTeX-Lauf +sollte lediglich einige Layoutänderungen mit sich bringen. Ein großer Teil der +in den nachfolgenden Abschnitten beschriebenen vielfältigen Möglichkeiten und +Optionen werden von den \KOMAScript-Klassen zusätzlich geboten. \begin{table} % \centering @@ -84,7 +84,7 @@ Optionen werden von den \KOMAScript-Klassen zusätzlich geboten. \setcapindent{0pt}% % \caption \begin{captionbeside} - [Klassengegenüberstellung]{\label{tab:maincls.overview}Gegenüberstellung der + [Klassengegenüberstellung]{\label{tab:maincls.overview}Gegenüberstellung der Standardklassen und der \KOMAScript-Klassen} [l] \begin{tabular}[t]{ll} @@ -100,28 +100,28 @@ Optionen werden von den \KOMAScript-Klassen zusätzlich geboten. \end{captionbeside} \end{table} -Lassen Sie mich der Erläuterung der Klassen noch eine Bemerkung +Lassen Sie mich der Erläuterung der Klassen noch eine Bemerkung vorausschicken. Oft ist man sich am Anfang eines Dokuments unsicher, welche -Einstellungen konkret zu wählen sind. Bei einigen Einstellungen, wie der -Auswahl des Papierformats, mögen sie bereits vorab feststehen. Aber schon die -Frage nach der Seitenauf"|teilung könnte im Voraus schwer zu beantworten sein. -Andererseits sollten diese Angaben für die Haupttätigkeiten des Autors -- +Einstellungen konkret zu wählen sind. Bei einigen Einstellungen, wie der +Auswahl des Papierformats, mögen sie bereits vorab feststehen. Aber schon die +Frage nach der Seitenauf"|teilung könnte im Voraus schwer zu beantworten sein. +Andererseits sollten diese Angaben für die Haupttätigkeiten des Autors -- Entwurf der Gliederung, Schreiben des Textes, Zusammenstellen von Abbildungen, -Tabellen und Verzeichnissen -- zunächst auch unerheblich sein. Konzentrieren -Sie sich als Autor erst einmal auf den Inhalt. Wenn der dann steht, können Sie -sich um die Feinheiten der Form kümmern. Neben der Auswahl der Optionen -gehören dazu dann auch Dinge wie die Korrektur der Trennung und möglicherweise +Tabellen und Verzeichnissen -- zunächst auch unerheblich sein. Konzentrieren +Sie sich als Autor erst einmal auf den Inhalt. Wenn der dann steht, können Sie +sich um die Feinheiten der Form kümmern. Neben der Auswahl der Optionen +gehören dazu dann auch Dinge wie die Korrektur der Trennung und möglicherweise dezente Eingriffe in den Seitenumbruch oder die Verteilung von Abbildungen und Tabellen. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} %\iffree{}{\clearpage}% Umbruchkorrektur!!! -\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} +\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} \LoadCommonFile{draftmode} % \section{Entwurfsmodus} @@ -132,46 +132,46 @@ Tabellen. \Macro{raggedbottom} \end{Declaration} \begin{Explain} - Insbesondere bei doppelseitigen Dokumenten ist es wünschenswert, wenn nicht + Insbesondere bei doppelseitigen Dokumenten ist es wünschenswert, wenn nicht 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 + 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, 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 + 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 - notwendig, dass man zumindest einige der vertikalen Abstände etwas dehnt + notwendig, dass man zumindest einige der vertikalen Abstände etwas dehnt oder staucht, um das Ziel wieder zu erreichen. \TeX{} kennt zu diesem Zweck - dehn- und stauchbare Abstände und \LaTeX{} bietet die Möglichkeit, + dehn- und stauchbare Abstände und \LaTeX{} bietet die Möglichkeit, diesen \emph{vertikalen Ausgleich}\Index{Ausgleich} automatisch - durchzuführen. + durchzuführen. \end{Explain} -Wird über die Option +Wird über die Option \Option{twoside}\IndexOption{twoside}\important{\Option{twoside}} (siehe \autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.twoside}) -doppelseitiger oder über Option +doppelseitiger oder über Option \Option{twocolumn}\IndexOption{twocolumn}\important{\Option{twocolumn}} (siehe \DescPageRef{typearea.option.twocolumn}) zweispaltiger Satz angefordert, so wird der vertikale Ausgleich ebenfalls eingeschaltet. Das\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} gilt jedoch bei einer Kompatibilitätseinstellung zu einer + \Class{scrartcl}} gilt jedoch bei einer Kompatibilitätseinstellung zu einer \KOMAScript-Version vor 3.17 (siehe \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}, Option \DescRef{\LabelBase.option.version}% \IndexOption{version}\important{\OptionValueRef{\LabelBase}{version}{3.17}}) -nicht, wenn die Option über \DescRef{\LabelBase.cmd.KOMAoption} oder -\DescRef{\LabelBase.cmd.KOMAoptions} geändert wird. +nicht, wenn die Option über \DescRef{\LabelBase.cmd.KOMAoption} oder +\DescRef{\LabelBase.cmd.KOMAoptions} geändert wird. Man kann den vertikalen Ausgleich auch mit \Macro{flushbottom} jederzeit -ab der aktuellen Seite explizit fordern. Umgekehrt ist es möglich, mit +ab der aktuellen Seite explizit fordern. Umgekehrt ist es möglich, mit \Macro{raggedbottom} den vertikalen Ausgleich ab der aktuellen Seite explizit abzuschalten. Dies entspricht der Voreinstellung bei einseitigem Satz. -{\KOMAScript} verwendet übrigens einen leicht modifizierten Verzicht auf den -vertikalen Ausgleich. \iffree{}{Näheres dazu ist in +{\KOMAScript} verwendet übrigens einen leicht modifizierten Verzicht auf den +vertikalen Ausgleich. \iffree{}{Näheres dazu ist in \autoref{sec:maincls-experts.addInfos}, \DescPageRef{maincls-experts.cmd.footnoterule} zu erfahren.}% % @@ -180,7 +180,7 @@ vertikalen Ausgleich. \iffree{}{Näheres dazu ist in \EndIndexGroup -\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} +\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} \LoadCommonFile{textmarkup} % \section{Textauszeichnungen} @@ -204,23 +204,23 @@ Bei\ChangedAt{v3.00}{\Class{scrreprt}\and \Class{scrartcl}}% \OnlyAt{\Class{scrreprt}\and \Class{scrartcl}} den Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} setzt die \DescRef{\LabelBase.env.abstract}-Umgebung noch den zentrierten Titel -»\abstractname« vor die Zusammenfassung. Früher war dies durchaus -üblich. Inzwischen sind wir durch das Zeitunglesen darin geübt, einen +»\abstractname« vor die Zusammenfassung. Früher war dies durchaus +üblich. Inzwischen sind wir durch das Zeitunglesen darin geübt, einen entsprechend hervorgehobenen Text am Anfang eines Artikels oder Berichts als Zusammenfassung zu erkennen. Dies gilt umso mehr, wenn dieser Text noch vor dem Inhaltsverzeichnis steht. Zudem verwundert es, wenn ausgerechnet diese -Überschrift klein und zentriert ist. {\KOMAScript} bietet mit der Option -\Option{abstract} die Möglichkeit, die Überschrift über der Zusammenfassung +Ãœberschrift klein und zentriert ist. {\KOMAScript} bietet mit der Option +\Option{abstract} die Möglichkeit, die Ãœberschrift über der Zusammenfassung ein- oder auszuschalten. Als \PName{Ein-Aus-Wert} kann einer der -Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist bei \KOMAScript{} \PValue{false}. -Bei Büchern wird in der Regel eine andere Art der Zusammenfassung +Bei Büchern wird in der Regel eine andere Art der Zusammenfassung verwendet. Dort setzt man ein entsprechendes Kapitel an den Anfang oder das Ende des Werks. Oft wird diese Zusammenfassung entweder mit der Einleitung -oder einem weiteren Ausblick verknüpft. Daher gibt es bei \Class{scrbook} -überhaupt keine \DescRef{\LabelBase.env.abstract}-Umgebung. +oder einem weiteren Ausblick verknüpft. Daher gibt es bei \Class{scrbook} +überhaupt keine \DescRef{\LabelBase.env.abstract}-Umgebung. Bei\textnote{Tipp!} Berichten im weiteren Sinne, etwa einer Studien- oder Diplomarbeit, ist ebenfalls eine Zusammenfassung in dieser Form zu empfehlen. Siehe dazu die in \autoref{sec:maincls.structure}, ab @@ -235,19 +235,19 @@ empfehlen. Siehe dazu die in \autoref{sec:maincls.structure}, ab \begin{Environment}{abstract}\end{Environment} \end{Declaration}% \OnlyAt{\Class{scrartcl}\and \Class{scrreprt}}% -Einige \LaTeX-Klassen bieten eine spezielle Umgebung für die +Einige \LaTeX-Klassen bieten eine spezielle Umgebung für die Zusammenfassung: die \Environment{abstract}-Umgebung. Diese wird unmittelbar ausgegeben, ist also nicht Bestandteil der mit \DescRef{\LabelBase.cmd.maketitle} gesetzten Titelei. Bitte\textnote{Achtung!} beachten Sie unbedingt, dass es sich bei \Environment{abstract} um eine Umgebung und nicht um eine Anweisung handelt. Ob die Zusammenfassung mit einer -Überschrift versehen wird oder nicht, wird über die Option +Ãœberschrift versehen wird oder nicht, wird über die Option \DescRef{\LabelBase.option.abstract} gesteuert (siehe oben). -Bei Büchern ist die Zusammenfassung häufig Bestandteil der Einleitung oder +Bei Büchern ist die Zusammenfassung häufig Bestandteil der Einleitung oder eines gesonderten Kapitels am Ende des Dokuments. Daher gibt es bei \Class{scrbook} keine \Environment{abstract}-Umgebung. Bei Verwendung der -Klasse \Class{scrreprt} ist es sicher eine Überlegung wert, ob man nicht +Klasse \Class{scrreprt} ist es sicher eine Ãœberlegung wert, ob man nicht genauso verfahren sollte. Siehe hierzu in \autoref{sec:\LabelBase.structure} ab \DescPageRef{\LabelBase.cmd.chapter*} die Anweisungen \DescRef{\LabelBase.cmd.chapter*}\IndexCmd{chapter*} und @@ -260,11 +260,11 @@ Wird ein Titelkopf\Index{Titel>Kopf} (siehe Option Zusammenfassung intern mit Hilfe einer \DescRef{\LabelBase.env.quotation}-Umgebung\IndexEnv{quotation} (siehe \autoref{sec:\LabelBase.lists}, \DescPageRef{\LabelBase.env.quotation}) -gesetzt. Dabei werden Absatzanfänge normalerweise mit Einzug gesetzt. Soll der +gesetzt. Dabei werden Absatzanfänge normalerweise mit Einzug gesetzt. Soll der erste Absatz nicht eingezogen werden, so kann dieser Einzug mit \Macro{noindent}\IndexCmd{noindent}\important{\Macro{noindent}} \iffree{unmittelbar nach \Macro{begin}\PParameter{abstract}}{am Anfang der - Umgebung} unterdrückt werden.% + Umgebung} unterdrückt werden.% % \EndIndexGroup % @@ -277,32 +277,32 @@ erste Absatz nicht eingezogen werden, so kann dieser Einzug mit \BeginIndex{}{Inhaltsverzeichnis} Auf die Titelei und eine eventuell vorhandene Zusammenfassung folgt -normalerweise das Inhaltsverzeichnis. Häufig findet +normalerweise das Inhaltsverzeichnis. Häufig findet man nach dem Inhaltsverzeichnis auch noch die Verzeichnisse der Gleitumgebungen, beispielsweise von Tabellen und Abbildungen (siehe \autoref{sec:\LabelBase.floats}). \iffalse% Es ist zu beachten, dass neben den in diesem Abschnitt dokumentierten -Möglichkeiten auch noch die Anweisungen +Möglichkeiten auch noch die Anweisungen \DescRef{maincls-experts.cmd.DeclareSectionCommand}, \DescRef{maincls-experts.cmd.DeclareNewSectionCommand}, \DescRef{maincls-experts.cmd.RedeclareSectionCommand} und \DescRef{maincls-experts.cmd.ProvideSectionCommand} Auswirkungen auf das -Inhaltsverzeichnis haben können. Siehe \autoref{sec:maincls-experts.experts}, +Inhaltsverzeichnis haben können. Siehe \autoref{sec:maincls-experts.sections}, \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.% \else% -Neben den in diesem Abschnitt dokumentierten Möglichkeiten hat auch der mit +Neben den in diesem Abschnitt dokumentierten Möglichkeiten hat auch der mit \DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}% \important[O]{\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}} -gewählte und +gewählte und konfigurierte Eintragsstil des Pakets \hyperref[cha:tocbasic]{\Package{tocbasic}}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}% \IndexPackage{tocbasic} (siehe -\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) maßgeblichen Einfluss auf die -Darstellung des Inhaltsverzeichnisses. Entsprechend können sich auch die in -\autoref{sec:maincls-experts.experts} ab +\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) maßgeblichen Einfluss auf die +Darstellung des Inhaltsverzeichnisses. Entsprechend können sich auch die in +\autoref{sec:maincls-experts.sections} ab \DescPageRef{maincls-experts.cmd.DeclareSectionCommand} dokumentierten Befehle \DescRef{maincls-experts.cmd.DeclareSectionCommand}% @@ -320,52 +320,52 @@ Befehle \begin{Declaration} \OptionVName{toc}{Einstellung} \end{Declaration} -Neuerdings ist es fast schon üblich geworden Tabellen- und +Neuerdings ist es fast schon üblich geworden Tabellen- und Abbildungsverzeichnis sowie das Literaturverzeichnis, seltener das Stichwortverzeichnis, ins Inhaltsverzeichnis aufzunehmen. Dies hat sicher auch mit der neuen Mode zu tun, Abbildungs- und Tabellenverzeichnis ans Buchende zu stellen. Beide Verzeichnisse haben von Aufbau und Intention eine deutliche -Ähnlichkeit mit dem Inhaltsverzeichnis. Daher betrachte ich die Entwicklung +Ähnlichkeit mit dem Inhaltsverzeichnis. Daher betrachte ich die Entwicklung skeptisch. Da\important{\OptionValue{toc}{listof}} es keinen Sinn hat, nur das Tabellen- oder nur das Abbildungsverzeichnis ohne das jeweils andere ins Inhaltsverzeichnis aufzunehmen, werden mit der \PName{Einstellung}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} \PValue{listof}\IndexOption{toc~=\textKValue{listof}} beide Verzeichnisse gemeinsam ins Inhaltsverzeichnis aufgenommen. Dabei werden auch -Verzeichnisse berücksichtigt, die mit Hilfe des +Verzeichnisse berücksichtigt, die mit Hilfe des \Package{float}-Pakets\IndexPackage{float} ab Version~1.2e (siehe \cite{package:float}) oder \Package{floatrow} (siehe \cite{package:floatrow}) erstellt werden. Als\important{\OptionValue{toc}{listofnumbered}} -Verzeichnisse, die den Inhalt anderer Abschnitte des Werks auf"|führen, +Verzeichnisse, die den Inhalt anderer Abschnitte des Werks auf"|führen, erhalten Tabellen"~, Abbildungs- und die mit den genannten Paketen erzeugten -Verzeichnisse grundsätzlich keine Kapitelnummer. Wer diesen Grundsatz +Verzeichnisse grundsätzlich keine Kapitelnummer. Wer diesen Grundsatz ignorieren will, bedient sich der \PName{Einstellung} \PValue{listofnumbered}\IndexOption{toc~=\textKValue{listofnumbered}}. \leavevmode\LabelOptionValue{toc}{index}\nobreak -Das\important{\OptionValue{toc}{index}} Stichwortverzeichnis erhält mit +Das\important{\OptionValue{toc}{index}} Stichwortverzeichnis erhält mit \OptionValue{toc}{index}\IndexOption{toc~=\textKValue{index}} einen Eintrag im Inhaltsverzeichnis. Da das Stichwortverzeichnis ebenfalls nur Verweise auf den -Inhalt anderer Abschnitte enthält, wird auch dieser Eintrag grundsätzlich +Inhalt anderer Abschnitte enthält, wird auch dieser Eintrag grundsätzlich nicht nummeriert. Eine\ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Abweichung\important{\OptionValue{toc}{indexnumbered}} von diesem Grundsatz wird von \KOMAScript{} trotz Bedenken des Autors mit \OptionValue{toc}{indexnumbered}\IndexOption{toc~=\textKValue{indexnumbered}} -ebenfalls unterstützt. +ebenfalls unterstützt. \leavevmode\LabelOptionValue{toc}{bibliography}\nobreak Das Literaturverzeichnis stellt eine etwas andere Art von Verzeichnis dar. Hier wird nicht der Inhalt des vorliegenden Werks aufgelistet, sondern auf externe Inhalte verwiesen. Mit\important{\OptionValue{toc}{bibliographynumbered}} -dieser Begründung könnte man argumentieren, dass das Literaturverzeichnis ein +dieser Begründung könnte man argumentieren, dass das Literaturverzeichnis ein eigenes Kapitel bzw. einen eigenen Abschnitt darstelle und somit eine Nummer verdiene. Die Option \OptionValue{toc}{bibliographynumbered}% -\IndexOption{toc~=\textKValue{bibliographynumbered}} führt genau dazu, -einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst +\IndexOption{toc~=\textKValue{bibliographynumbered}} führt genau dazu, +einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst bin allerdings 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 +wäre. Außerdem ist das Literaturverzeichnis letztlich nichts, was man selbst geschrieben hat. Deshalb\important{\OptionValue{toc}{bibliography}} erscheint mir allenfalls ein nicht nummerierter Eintrag im Inhaltsverzeichnis angemessen, was mit der Einstellung @@ -377,8 +377,8 @@ Normalerweise\ChangedAt{v2.8q}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% \important{\OptionValue{toc}{graduated}} wird das Inhaltsverzeichnis so formatiert, dass die Gliederungsebenen unterschiedlich weit eingezogen -werden. Dabei wird für die Gliederungsnummer jeder Ebene ein Raum fester -Breite vorgesehen, in dem die Nummer linksbündig gesetzt wird. Dies entspricht +werden. Dabei wird für die Gliederungsnummer jeder Ebene ein Raum fester +Breite vorgesehen, in dem die Nummer linksbündig gesetzt wird. Dies entspricht der Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} \OptionValue{toc}{graduated}\IndexOption{toc~=\textKValue{graduated}}. @@ -386,58 +386,58 @@ der Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \leavevmode\LabelOptionValue{toc}{flat}\nobreak Werden sehr viele Gliederungspunkte verwendet, so werden die Gliederungsnummern sehr breit. Damit reicht der vorgesehene Platz nicht -aus. In \cite{DANTE:FAQ} wird für solche Fälle vorgeschlagen, die Erzeugung +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~=\textKValue{flat}} werden die unterschiedlichen Gliederungsebenen nicht unterschiedlich weit -eingezogen. Stattdessen wird eine tabellenartige Form gewählt, in der alle +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 +linksbündig untereinander stehen. Der für die Gliederungsnummern benötigte Platz wird dabei automatisch ermittelt. -Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von +Einen Ãœberblick über alle möglichen Werte für die \PName{Einstellung} von \Option{toc} ist in \autoref{tab:maincls.toc} zu finden. \begin{desclist} - \desccaption[{Mögliche Werte für Option \Option{toc}}]{% - Mögliche Werte für Option \Option{toc} zur Einstellung von Form und Inhalt + \desccaption[{Mögliche Werte für Option \Option{toc}}]{% + Mögliche Werte für Option \Option{toc} zur Einstellung von Form und Inhalt des Inhaltsverzeichnisses\label{tab:maincls.toc}% }{% - Mögliche Werte für Option \Option{toc} (\emph{Fortsetzung})% + Mögliche Werte für Option \Option{toc} (\emph{Fortsetzung})% }% \entry{\PValue{bibliography}, \PValue{bib}}{% - Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne dass es nummeriert wird.% \IndexOption{toc~=\textKValue{bibliography}}}% \entry{\PValue{bibliographynumbered}, \PValue{bibnumbered}, \PValue{numberedbibliography}, \PValue{numberedbib}}{% - Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und wird nummeriert.% \IndexOption{toc~=\textKValue{bibliographynumbered}}}% \entry{\PValue{chapterentrywithdots}, \PValue{chapterentrydotfill}}{% \ChangedAt[2014/12]{v3.15}{\Class{scrbook}\and \Class{scrreprt}}% - Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt} + Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt} werden Text und Seitenzahl ebenfalls durch eine punktierte Linie miteinander verbunden.% \IndexOption{toc~=\textKValue{chapterentrywithdots}}}% \entry{\PValue{chapterentrywithoutdots}, \PValue{chapterentryfill}}{% \ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}}% - Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt} + Bei den Kapiteleinträgen der Klassen \Class{scrbook} und \Class{scrreprt} werden Text und Seitenzahl nicht durch eine punktierte Linie miteinander verbunden. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{chapterentrywithoutdots}}}% \entry{\PValue{flat}, \PValue{left}}{% - Das Inhaltsverzeichnis erhält eine tabellarische Form. Die - Gliederungsnummern sind dabei die erste Spalte, die Überschriften die - zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die - Gliederungsnummern reserviert wird, richtet sich nach dem benötigten Platz + Das Inhaltsverzeichnis erhält eine tabellarische Form. Die + Gliederungsnummern sind dabei die erste Spalte, die Ãœberschriften die + zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die + Gliederungsnummern reserviert wird, richtet sich nach dem benötigten Platz des vorherigen \LaTeX-Laufs.% \IndexOption{toc~=\textKValue{flat}}}% \entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{% - Das Inhaltsverzeichnis erhält eine hierarchische Form. Es steht nur ein - begrenzter Platz für die Gliederungsnummern zur Verfügung. Dies entspricht + Das Inhaltsverzeichnis erhält eine hierarchische Form. Es steht nur ein + begrenzter Platz für die Gliederungsnummern zur Verfügung. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{graduated}}}% \entry{\PValue{indenttextentries}, \PValue{indentunnumbered}, @@ -445,18 +445,18 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc}, - \DescPageRef{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.% + \DescPageRef{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~=\textKValue{numberline}}}% \entry{\PValue{index}, \PValue{idx}}{% - Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne dass es nummeriert wird.% \IndexOption{toc~=\textKValue{index}}}% \entry{\PValue{indexnumbered}}{% \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und wird nummeriert.% \IndexOption{toc~=\textKValue{index}}}% \entry{\PValue{leftaligntextentries}, \PValue{leftalignunnumbered}, @@ -464,9 +464,9 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc}, - \DescPageRef{tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis - gelöscht. Dadurch werden nicht nummerierte Einträge linksbündig mit der - Nummer von nummerierten Einträgen gleicher Ebene gesetzt. Dies entspricht + \DescPageRef{tocbasic.cmd.setuptoc}) wird für das Inhaltsverzeichnis + gelöscht. Dadurch werden nicht nummerierte Einträge linksbündig mit der + Nummer von nummerierten Einträgen gleicher Ebene gesetzt. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{numberline}}}% \pventry{listof}{% @@ -480,11 +480,11 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von werden nummeriert.% \IndexOption{toc~=\textKValue{listofnumbered}}}% \entry{\PValue{nobibliography}, \PValue{nobib}}{% - Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies + Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{nobibliography}}}% \entry{\PValue{noindex}, \PValue{noidx}}{% - Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies + Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{noindex}}}% \pventry{nolistof}{% @@ -494,12 +494,12 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \IndexOption{toc~=\textKValue{nolistof}}}% \entry{\PValue{sectionentrywithdots}, \PValue{sectionentrydotfill}}{% \ChangedAt[2014/12]{v3.15}{\Class{scrartcl}}% - Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und + Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und Seitenzahl ebenfalls durch eine punktierte Linie miteinander verbunden.% \IndexOption{toc~=\textKValue{sectionentrywithdots}}}% \entry{\PValue{sectionentrywithoutdots}, \PValue{sectionentryfill}}{% \ChangedAt{v3.15}{\Class{scrartcl}}% - Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und + Bei den Abschnittseinträgen der Klasse \Class{scrartcl} werden Text und Seitenzahl nicht durch eine punktierte Linie miteinander verbunden. Dies entspricht der Voreinstellung.% \IndexOption{toc~=\textKValue{sectionentrywithoutdots}}}% @@ -514,23 +514,23 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \end{Declaration} Diese\ChangedAt[2014/12]{v3.15}{\Class{scrbook}\and \Class{scrreprt}} Optionen legen fest, ob im Inhaltsverzeichnis bei den Klassen \Class{scrbook} und -\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} für die +\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} für die Kapitelebene beziehungsweise bei der Klasse -\Class{scrartcl}\OnlyAt{\Class{scrartcl}} für die Abschnittsebene wie bei den +\Class{scrartcl}\OnlyAt{\Class{scrartcl}} für die Abschnittsebene wie bei den tieferen Ebenen auch eine punktierte Verbindungslinie zwischen dem Text des -Eintrags und der zugehörigen Seitenzahl verwendet werden soll. Als -\PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus +Eintrags und der zugehörigen Seitenzahl verwendet werden soll. Als +\PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet -werden. Voreingestellt ist für beide Optionen \PValue{false}, wodurch statt +werden. Voreingestellt ist für beide Optionen \PValue{false}, wodurch statt einer punktierten Linie lediglich ein Abstand verwendet wird. \BeginIndex{FontElement}{chapterentrydots}\LabelFontElement{chapterentrydots}% \BeginIndex{FontElement}{sectionentrydots}\LabelFontElement{sectionentrydots}% -Wird die punktierte Linie verwendet, so kann deren Schrift über die Elemente +Wird die punktierte Linie verwendet, so kann deren Schrift über die Elemente \FontElement{chapterentrydots}% \important{\FontElement{chapterentrydots}\\ - \FontElement{sectionentrydots}} und \FontElement{sectionentrydots} gegenüber -den Einstellungen für die Seitenzahlen in den Einträgen verändert werden + \FontElement{sectionentrydots}} und \FontElement{sectionentrydots} gegenüber +den Einstellungen für die Seitenzahlen in den Einträgen verändert werden (siehe auch \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont}, \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}, sowie @@ -538,8 +538,8 @@ den Einstellungen für die Seitenzahlen in den Einträgen verändert werden \autopageref{tab:maincls.fontelements}). Die Voreinstellungen der Elemente sind \autoref{tab:maincls.tocelements} auf \autopageref{tab:maincls.tocelements} zu entnehmen. Es ist zu -beachten\textnote{Achtung!}, dass die Pünktchen nur sauber untereinander -stehen, wenn die Schrift aller Pünktchen identisch ist.% +beachten\textnote{Achtung!}, dass die Pünktchen nur sauber untereinander +stehen, wenn die Schrift aller Pünktchen identisch ist.% \EndIndexGroup @@ -548,22 +548,22 @@ stehen, wenn die Schrift aller Pünktchen identisch ist.% \end{Declaration}% Die Ausgabe des Inhaltsverzeichnisses wird mit \Macro{tableofcontents} erreicht. Um ein korrektes Inhaltsverzeichnis zu erhalten, sind nach jeder -Änderung mindestens zwei \LaTeX-Läufe notwendig. Mit der oben erläuterten +Änderung mindestens zwei \LaTeX-Läufe notwendig. Mit der oben erläuterten Option \DescRef{\LabelBase.option.toc} kann der Umfang und die Form des Inhaltsverzeichnisses beeinflusst werden. Nach einer Umschaltung der Option -sind ebenfalls mindestens zwei weitere \LaTeX-Läufe notwendig. +sind ebenfalls mindestens zwei weitere \LaTeX-Läufe notwendig. -Der Eintrag für \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} bei +Der Eintrag für \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} bei \Class{scrbook}\IndexClass{scrbook} und \Class{scrreprt}\IndexClass{scrreprt} beziehungsweise \DescRef{\LabelBase.cmd.section}\IndexCmd{section} bei \Class{scrartcl}\IndexClass{scrartcl} sowie der Gliederungsebene \DescRef{\LabelBase.cmd.part}\IndexCmd{part} wird nicht -eingerückt. Gleichzeitig befinden sich zwischen dem Text der Gliederungsebene -und der Seitenzahl in der Voreinstellung keine Pünktchen. Die typografischen -Gründe dafür liegen in der normalerweise anderen Schriftart sowie der -erwünschten Hervorhebung. Dies\ChangedAt{v3.15}{\Class{scrbook}\and +eingerückt. Gleichzeitig befinden sich zwischen dem Text der Gliederungsebene +und der Seitenzahl in der Voreinstellung keine Pünktchen. Die typografischen +Gründe dafür liegen in der normalerweise anderen Schriftart sowie der +erwünschten Hervorhebung. Dies\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} kann jedoch mit den zuvor -dokumentierten Optionen geändert werden. Das Inhaltsverzeichnis \iffree{dieser +dokumentierten Optionen geändert werden. Das Inhaltsverzeichnis \iffree{dieser Anleitung}{dieses Buches} ist mit den Voreinstellungen gesetzt und dient als Beispiel. @@ -574,11 +574,11 @@ Die\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}\important{\FontElement{partentry}\\ \FontElement{chapterentry}\\ \FontElement{sectionentry}} Schrift der oberen -Inhaltsverzeichniseinträge ist über die Elemente -\FontElement{partentry} und für \Class{scrbook} -und \Class{scrreprt} über +Inhaltsverzeichniseinträge ist über die Elemente +\FontElement{partentry} und für \Class{scrbook} +und \Class{scrreprt} über \FontElement{chapterentry} beziehungsweise -\FontElement{sectionentry} für \Class{scrartcl} +\FontElement{sectionentry} für \Class{scrartcl} einstellbar. \BeginIndex{FontElement}{partentrypagenumber}% \LabelFontElement{partentrypagenumber}% @@ -587,7 +587,7 @@ einstellbar. \LabelFontElement{chapterentrypagenumber}% \BeginIndex{FontElement}{sectionentrypagenumber}% \LabelFontElement{sectionentrypagenumber}% -Die Schrift der Seitenzahlen kann jeweils davon abweichend über die Elemente +Die Schrift der Seitenzahlen kann jeweils davon abweichend über die Elemente \FontElement{partentrypagenumber}% \important{\FontElement{partentrypagenumber}} und \FontElement{chapterentrypagenumber}% @@ -599,22 +599,22 @@ eingestellt werden (siehe auch \DescRef{\LabelBase.cmd.setkomafont} und \DescPageRef{\LabelBase.cmd.setkomafont}, sowie \autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}). Werden\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} je nach Klasse für die Kapitel- beziehungsweise -Abschnittseinträge ebenfalls punktierte Verbindungslinien zu den Seitenzahlen -über Option \DescRef{\LabelBase.option.toc}% + \Class{scrartcl}} je nach Klasse für die Kapitel- beziehungsweise +Abschnittseinträge ebenfalls punktierte Verbindungslinien zu den Seitenzahlen +über Option \DescRef{\LabelBase.option.toc}% \IndexOption{toc~=\textKValue{chapterentrywithdots}}% \IndexOption{toc~=\textKValue{sectionentrywithdots}}, \DescRef{\LabelBase.option.chapterentrydots}% \IndexOption{chapterentrydots~=\PName{Ein-Aus-Wert}} oder \DescRef{\LabelBase.option.sectionentrydots}% \IndexOption{sectionentrydots~=\PName{Ein-Aus-Wert}} verwendet, so kann deren -Schrift über die Elemente \DescRef{\LabelBase.fontelement.chapterentrydots}% +Schrift über die Elemente \DescRef{\LabelBase.fontelement.chapterentrydots}% \IndexFontElement{chapterentrydots}% \important{\DescRef{\LabelBase.fontelement.chapterentrydots}\\ \DescRef{\LabelBase.fontelement.sectionentrydots}} und \DescRef{\LabelBase.fontelement.sectionentrydots}% -\IndexFontElement{sectionentrydots} gegenüber den Einstellungen für die -Seitenzahlen verändert werden. Die Voreinstellungen der Elemente sind +\IndexFontElement{sectionentrydots} gegenüber den Einstellungen für die +Seitenzahlen verändert werden. Die Voreinstellungen der Elemente sind \autoref{tab:maincls.tocelements} zu entnehmen. \begin{table} % \centering @@ -622,10 +622,10 @@ Seitenzahlen verändert werden. Die Voreinstellungen der Elemente sind \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside} - [Schriftvoreinstellungen für die Elemente + [Schriftvoreinstellungen für die Elemente des Inhaltsverzeichnisses] {\label{tab:maincls.tocelements}% - \hspace{0pt plus 1ex}Vorein\-stel\-lung\-en der Schrift für die Elemente + \hspace{0pt plus 1ex}Vorein\-stel\-lung\-en der Schrift für die Elemente des In\-halts\-ver\-zeich\-nis\-ses} [l] \setlength{\tabcolsep}{.9\tabcolsep}% Umbruchoptimierung! @@ -664,53 +664,53 @@ Gliederungsebenen \DescRef{\LabelBase.cmd.part} bis \DescRef{\LabelBase.cmd.subsection} und bei der Klasse \Class{scrartcl} die Ebenen \DescRef{\LabelBase.cmd.part} bis \DescRef{\LabelBase.cmd.subsubsection} in das Inhaltsverzeichnis -aufgenommen. Dies wird über den Zähler \Counter{tocdepth} gesteuert. Dabei -steht der Wert -1 für \DescRef{\LabelBase.cmd.part}, 0 für -\DescRef{\LabelBase.cmd.chapter} und so weiter. Durch Setzen oder Erhöhen -oder Verringern des Zählers kann bestimmt werden, bis zu welcher -Gliederungsebene Einträge in das Inhaltsverzeichnis erfolgen sollen. Dies ist -übrigens bei den Standardklassen ganz +aufgenommen. Dies wird über den Zähler \Counter{tocdepth} gesteuert. Dabei +steht der Wert -1 für \DescRef{\LabelBase.cmd.part}, 0 für +\DescRef{\LabelBase.cmd.chapter} und so weiter. Durch Setzen oder Erhöhen +oder Verringern des Zählers kann bestimmt werden, bis zu welcher +Gliederungsebene Einträge in das Inhaltsverzeichnis erfolgen sollen. Dies ist +übrigens bei den Standardklassen ganz genauso. Im\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Unterschied\textnote{\KOMAScript{} vs. Standardklassen} zu den Standardklassen muss sich bei \KOMAScript{} aber niemand diese Zuordnung -merken. \KOMAScript{} definiert für jede Gliederungsebene eine Anweisung -\Macro{\PName{Ebene}tocdepth} mit dem entsprechenden Wert, die für Zuweisungen +merken. \KOMAScript{} definiert für jede Gliederungsebene eine Anweisung +\Macro{\PName{Ebene}tocdepth} mit dem entsprechenden Wert, die für Zuweisungen an \Counter{tocdepth} verwendet werden kann. -Bitten beachten Sie\textnote{Achtung!}, dass die Werte für \Counter{tocdepth} +Bitten beachten Sie\textnote{Achtung!}, dass die Werte für \Counter{tocdepth} und \DescRef{\LabelBase.counter.secnumdepth}\IndexCounter{secnumdepth} (siehe \autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.counter.secnumdepth}) bei -\Class{scrartcl}\OnlyAt{\Class{scrartcl}} für \DescRef{\LabelBase.cmd.part} -nicht übereinstimmen. Dies wurde aus Gründen der Kompatibilität von der -Standardklasse \Class{article} übernommen. Daher sollte beispielsweise die +\Class{scrartcl}\OnlyAt{\Class{scrartcl}} für \DescRef{\LabelBase.cmd.part} +nicht übereinstimmen. Dies wurde aus Gründen der Kompatibilität von der +Standardklasse \Class{article} übernommen. Daher sollte beispielsweise die Anweisung \DescRef{\LabelBase.cmd.partnumdepth}\IndexCmd{partnumdepth} auch nicht zum Setzen von \Counter{tocdepth} verwendet werden.% \begin{Example} Angenommen, Sie setzen einen Artikel, bei dem die Gliederungsebene \DescRef{\LabelBase.cmd.subsubsection} verwendet wird. Gehen wir weiter davon aus, dass Sie diese Gliederungsebene aber nicht im Inhaltsverzeichnis - haben wollen. Dann könnte die Präambel Ihres Dokuments wie folgt + haben wollen. Dann könnte die Präambel Ihres Dokuments wie folgt aussehen: \begin{lstcode} \documentclass{scrartcl} \setcounter{tocdepth}{\subsectiontocdepth} \end{lstcode} - Sie setzen den Zähler \Counter{tocdepth} daher auf den in Anweisung + Sie setzen den Zähler \Counter{tocdepth} daher auf den in Anweisung \Macro{subsectiontocdepth} gespeicherten Wert. Dass dies normalerweise der - Wert 2 ist, müssen Sie sich also gar nicht merken. + Wert 2 ist, müssen Sie sich also gar nicht merken. Wollen Sie stattdessen nur, dass eine Ebene weniger in das - Inhaltsverzeichnis eingetragen wird als normalerweise, können Sie auch - einfach vom voreingestellten Wert des Zählers \Counter{tocdepth} eins + Inhaltsverzeichnis eingetragen wird als normalerweise, können Sie auch + einfach vom voreingestellten Wert des Zählers \Counter{tocdepth} eins abziehen: \begin{lstcode} \documentclass{scrartcl} \addtocounter{tocdepth}{-1} \end{lstcode} 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. + subtrahieren müssen, können Sie nach mindestens zwei \LaTeX-Läufen einfach + im Inhaltsverzeichnis abzählen. \end{Example}% \EndIndexGroup % @@ -722,14 +722,14 @@ nicht zum Setzen von \Counter{tocdepth} verwendet werden.% \LoadCommonFile{oddorevenpage}% \section{Erkennung von rechten und linken Seiten} -\section{Kopf und Fuß bei vordefinierten Seitenstilen} +\section{Kopf und Fuß bei vordefinierten Seitenstilen} \seclabel{pagestyle} \BeginIndexGroup \BeginIndex{}{Seiten>Stil}% Eine der allgemeinen Eigenschaften eines Dokuments ist der Seitenstil. Bei {\LaTeX} versteht man unter dem Seitenstil in erster Linie den Inhalt der -Kopf- und Fußzeilen. +Kopf- und Fußzeilen. \begin{Declaration} @@ -738,37 +738,37 @@ Kopf- und Fußzeilen. \end{Declaration}% Mit diesen Optionen kann eingestellt werden, ob\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -unter Kolumnentiteln oder über dem Fuß eine horizontale Linie\Index{Trennlinie} -gewünscht wird. Als \PName{Ein-Aus-Wert} kann -einer der Standardwerte für einfache Schalter aus +unter Kolumnentiteln oder über dem Fuß eine horizontale Linie\Index{Trennlinie} +gewünscht wird. Als \PName{Ein-Aus-Wert} kann +einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Ein Aktivieren der Option \Option{headsepline} oder die Verwendung -der Option ohne Wertübergabe schaltet die Linie unter den Kolumnentiteln +der Option ohne Wertübergabe schaltet die Linie unter den Kolumnentiteln ein. Ein Aktivieren der Option \Option{footsepline} oder die Verwendung der -Option ohne Wertübergabe schaltet die Linie über der Fußzeile ein. Die +Option ohne Wertübergabe schaltet die Linie über der Fußzeile ein. Die Deaktivierung der Optionen schaltet die jeweilige Linie aus. -Bei\textnote{Achtung!} den weiter unten erklärten Seitenstilen +Bei\textnote{Achtung!} den weiter unten erklärten Seitenstilen \DescRef{\LabelBase.pagestyle.empty} und \DescRef{\LabelBase.pagestyle.plain} -hat die Option \Option{headsepline} selbstverständlich keine Auswirkung, da -hier auf einen Seitenkopf\Index{Seiten>Kopf} ausdrücklich verzichtet werden +hat die Option \Option{headsepline} selbstverständlich keine Auswirkung, da +hier auf einen Seitenkopf\Index{Seiten>Kopf} ausdrücklich verzichtet werden soll. Typografisch betrachtet, hat eine solche Linie immer die Auswirkung, -dass der Kopf optisch näher an den Text heranrückt. Dies bedeutet nun nicht, -dass der Kopf räumlich weiter vom Textkörper\Index{Text>Bereich} weggerückt -werden müsste. Stattdessen sollte der Kopf dann bei der Berechnung des -Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei +dass der Kopf optisch näher an den Text heranrückt. Dies bedeutet nun nicht, +dass der Kopf räumlich weiter vom Textkörper\Index{Text>Bereich} weggerückt +werden müsste. Stattdessen sollte der Kopf dann bei der Berechnung des +Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei \KOMAScript{} dadurch erreicht, dass Paket \hyperref[cha:typearea]{\Package{typearea}}% \important{\hyperref[cha:typearea]{\Package{typearea}}}\IndexPackage{typearea} ebenfalls auf \Option{headsepline} reagiert und automatisch die Paketoption \DescRef{typearea.option.headinclude}% \IndexOption{headinclude}\important{\DescRef{typearea.option.headinclude}} mit -gleichem Wert ausführt. Entsprechendes gilt auch für die Fußlinie. Im +gleichem Wert ausführt. Entsprechendes gilt auch für die Fußlinie. 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. +Fuß ausgibt. -Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels +Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe Option \DescRef{typearea.option.DIV} mit den Werten \hyperref[desc:typearea.option.DIV.last]{\PValue{last}} oder @@ -780,8 +780,8 @@ aus. Zur Neuberechnung des Satzspiegels siehe Option Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe -\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für -Linien im Kopf und Fuß.% +\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für +Linien im Kopf und Fuß.% % \EndIndexGroup @@ -790,46 +790,46 @@ Linien im Kopf und Fuß.% \Macro{pagestyle}\Parameter{Seitenstil} \Macro{thispagestyle}\Parameter{lokaler Seitenstil} \end{Declaration}% -Üblicherweise wird zwischen vier verschiedenen Seitenstilen unterschieden: +Ãœblicherweise wird zwischen vier verschiedenen Seitenstilen unterschieden: \begin{description} \item[{\PageStyle{empty}% \BeginIndex[indexmain]{Pagestyle}{empty}\LabelPageStyle{empty}}] ist der - Seitenstil, bei dem Kopf- und Fußzeile vollständig leer bleiben. Dies ist + Seitenstil, bei dem Kopf- und Fußzeile vollständig leer bleiben. Dies ist bei {\KOMAScript} vollkommen identisch zu den Standardklassen.% \item[{\PageStyle{headings}% \BeginIndex[indexmain]{Pagestyle}{headings}\LabelPageStyle{headings}}] ist - der Seitenstil für lebende Kolumnentitel. Das sind Kolumnentitel, bei denen - Überschriften automatisch\Index[indexmain]{Kolumnentitel>automatisch} in den - Seitenkopf übernommen werden. Im Internet oder in Beschreibungen zu - \LaTeX-Paketen findet man auch häufig die englische Bezeichnung - »\emph{running headline}«. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% + der Seitenstil für lebende Kolumnentitel. Das sind Kolumnentitel, bei denen + Ãœberschriften automatisch\Index[indexmain]{Kolumnentitel>automatisch} in den + Seitenkopf übernommen werden. Im Internet oder in Beschreibungen zu + \LaTeX-Paketen findet man auch häufig die englische Bezeichnung + »\emph{running headline}«. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% Bei den Klassen \Class{scrbook}\IndexClass{scrbook} und \Class{scrreprt}\IndexClass{scrreprt} werden dabei im doppelseitigen Layout - die Überschriften der Kapitel und der Abschnitte in der Kopfzeile wiederholt + die Ãœberschriften der Kapitel und der Abschnitte in der Kopfzeile wiederholt -- bei {\KOMAScript}\textnote{\KOMAScript{} vs. Standardklassen} jeweils - außen, bei den Standardklassen innen. Die Seitenzahl wird bei {\KOMAScript} - im Fuß außen, bei den Standardklassen im Kopf außen gesetzt. Im einseitigen - Layout werden nur die Überschriften der Kapitel verwendet und bei + außen, bei den Standardklassen innen. Die Seitenzahl wird bei {\KOMAScript} + im Fuß außen, bei den Standardklassen im Kopf außen gesetzt. Im einseitigen + Layout werden nur die Ãœberschriften der Kapitel verwendet und bei {\KOMAScript} zentriert im Kopf ausgegeben. Die Seitenzahlen werden bei - {\KOMAScript} dann zentriert im Fuß gesetzt. \OnlyAt{\Class{scrartcl}}Bei + {\KOMAScript} dann zentriert im Fuß gesetzt. \OnlyAt{\Class{scrartcl}}Bei \Class{scrartcl}\IndexClass{scrartcl} wird entsprechend verfahren, jedoch eine Ebene tiefer bei Abschnitt und Unterabschnitt angesetzt, da die Gliederungsebene Kapitel hier nicht existiert. - Während die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} - automatische Kolumnentitel immer in Versalien -- also Großbuchstaben -- - setzen, verwendet {\KOMAScript} die Schreibweise, die in der Überschrift - vorgefunden wurde. Dies hat verschiedene typografische Gründe. So sind - Versalien als Auszeichnung eigentlich viel zu mächtig. Verwendet man sie + Während die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} + automatische Kolumnentitel immer in Versalien -- also Großbuchstaben -- + setzen, verwendet {\KOMAScript} die Schreibweise, die in der Ãœberschrift + vorgefunden wurde. Dies hat verschiedene typografische Gründe. So sind + Versalien als Auszeichnung eigentlich viel zu mächtig. Verwendet man sie trotzdem, sollten sie um einen Punkt kleiner gesetzt und leicht gesperrt werden (siehe hierzu beispielsweise \cite{JTschErfreulich}). All dies findet bei den Standardklassen keine Beachtung. - Darüber hinaus können bei den \KOMAScript-Klassen mit den Optionen + Darüber hinaus können bei den \KOMAScript-Klassen mit den Optionen \DescRef{\LabelBase.option.headsepline} und \DescRef{\LabelBase.option.footsepline} (siehe - \DescPageRef{\LabelBase.option.headsepline}) Linien unter dem Kopf und über - dem Fuß gesetzt werden.% + \DescPageRef{\LabelBase.option.headsepline}) Linien unter dem Kopf und über + dem Fuß gesetzt werden.% \item[{\PageStyle{myheadings}% \BeginIndex[indexmain]{Pagestyle}{myheadings}\LabelPageStyle{myheadings}}] entspricht weitgehend dem Seitenstil \PageStyle{headings}, allerdings werden @@ -845,9 +845,9 @@ Linien im Kopf und Fuß.% ist der Seitenstil, bei dem keinerlei Kolumnentitel\Index{Kolumnentitel} verwendet, sondern nur eine Seitenzahl\Index{Seiten>Zahl}\Index{Paginierung} ausgegeben wird. Bei\textnote{\KOMAScript{} vs. Standardklassen} den - Standardklassen wird diese Seitenzahl immer mittig im Fuß ausgegeben. Bei + Standardklassen wird diese Seitenzahl immer mittig im Fuß ausgegeben. Bei {\KOMAScript} erfolgt die Ausgabe im doppelseitigen\Index{doppelseitig} - Layout stattdessen außen im Fuß. Der einseitige Seitenstil entspricht bei + Layout stattdessen außen im Fuß. Der einseitige Seitenstil entspricht bei {\KOMAScript} dem der Standardklassen.% \end{description} @@ -858,30 +858,30 @@ Der\important{\Macro{pagestyle}} Seitenstil kann jederzeit mit Hilfe der Mit \Macro{pagestyle} kann der Seitenstil jederzeit % \fi % gesetzt werden. Verwendet\textnote{Tipp!} man \Macro{pagestyle} vor -Anweisungen, die einen Seitenumbruch mit Einfügen einer -Vakatseite\Index{Vakatseite}\textnote{Vakatseite} herbeiführen können, und -soll die Änderung erst ab der neuen Seite gelten, so ist ein -\DescRef{\LabelBase.cmd.cleardoublepage} davor nützlich. +Anweisungen, die einen Seitenumbruch mit Einfügen einer +Vakatseite\Index{Vakatseite}\textnote{Vakatseite} herbeiführen können, und +soll die Änderung erst ab der neuen Seite gelten, so ist ein +\DescRef{\LabelBase.cmd.cleardoublepage} davor nützlich. % \iffalse % Umbruchkorrektur -Üblicherweise verwendet man \Macro{pagestyle} aber nur einmal zu -Beginn des Dokuments oder in der Präambel. +Ãœ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 +Für\important{\Macro{thispagestyle}} eine Änderung des Seitenstils nur der aktuellen Seite verwendet man stattdessen die Anweisung \Macro{thispagestyle}. Dies geschieht auch an einigen Stellen im Dokument automatisch. Beispielsweise wird bei allen Kapitelanfangsseiten implizit die Anweisung \Macro{thispagestyle}\PParameter{\DescRef{\LabelBase.cmd.chapterpagestyle}} -ausgeführt. +ausgeführt. Bitte\textnote{Achtung!} beachten Sie, dass die Umschaltung zwischen automatischen und manuellen Kolumnentiteln bei Verwendung von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} nicht -mehr über den Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die +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. @@ -890,16 +890,16 @@ nicht zusammen mit diesem Paket verwendet werden. \LabelFontElement{pagehead}% \BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}% \BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}% -Um die Schriftarten von Kopf und Fuß der Seite oder der Seitenzahl zu -ändern\ChangedAt{v2.8p}{% +Um die Schriftarten von Kopf und Fuß der Seite oder der Seitenzahl zu +ändern\ChangedAt{v2.8p}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}, % verwenden Sie die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, -\DescPageRef{\LabelBase.cmd.setkomafont}). Für den Kopf und den Fuß ist dabei +\DescPageRef{\LabelBase.cmd.setkomafont}). Für den Kopf und den Fuß ist dabei das gleiche Element \FontElement{pageheadfoot}\IndexFontElement{pageheadfoot}% -\important{\FontElement{pageheadfoot}} zuständig. Das Element für die -Seitenzahl innerhalb des Kopfes oder Fußes heißt +\important{\FontElement{pageheadfoot}} zuständig. Das Element für die +Seitenzahl innerhalb des Kopfes oder Fußes heißt \FontElement{pagenumber}\IndexFontElement{pagenumber}% \important{\FontElement{pagenumber}}. Das ebenfalls in den \KOMAScript-Klassen bereitgestellte Element \FontElement{pagefoot}\IndexFontElement{pagefoot}% @@ -907,7 +907,7 @@ bereitgestellte Element \FontElement{pagefoot}\IndexFontElement{pagefoot}% \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage} (siehe \autoref{cha:scrlayer-scrpage}, \DescPageRef{scrlayer-scrpage.fontelement.pagefoot}) einen Seitenstil -definiert, bei dem auch der Fuß Text enthält. +definiert, bei dem auch der Fuß Text enthält. Die Voreinstellungen sind in \autoref{tab:maincls.defaultFontsHeadFoot} zu finden. @@ -919,10 +919,10 @@ finden. \setcapindent{0pt}% % \addtokomafont{caption}{\raggedright}% \begin{captionbeside} - [{Schriftvoreinstellungen für die Elemente des Seitenstils}] + [{Schriftvoreinstellungen für die Elemente des Seitenstils}] {\label{tab:maincls.defaultFontsHeadFoot}% \hspace{0pt plus 1ex}% - Vorein\-stellungen der Schrift für die Elemente des Seitenstils} + Vorein\-stellungen der Schrift für die Elemente des Seitenstils} [l] \begin{tabular}[t]{ll} \toprule @@ -941,17 +941,17 @@ finden. % \begin{Example} \leavevmode\phantomsection\xmpllabel{cmd.pagestyle}% - Angenommen, Sie wollen Kopf und Fuß einen Schriftgrad kleiner und kursiv + Angenommen, Sie wollen Kopf und Fuß einen Schriftgrad kleiner und kursiv setzen. Die Seitenzahl soll jedoch nicht kursiv, sondern fett gesetzt - werden. Davon abgesehen, dass das Ergebnis grauenvoll aussehen wird, können + werden. Davon abgesehen, dass das Ergebnis grauenvoll aussehen wird, können Sie dies wie folgt erreichen: \begin{lstcode} \setkomafont{pageheadfoot}{% \normalfont\normalcolor\itshape\small} \setkomafont{pagenumber}{\normalfont\bfseries} \end{lstcode} - Wollen Sie hingegen lediglich, dass zusätzlich zur bereits voreingestellten - schrägen Variante ebenfalls eine kleinere Schrift verwendet wird, so genügt: + Wollen Sie hingegen lediglich, dass zusätzlich zur bereits voreingestellten + schrägen Variante ebenfalls eine kleinere Schrift verwendet wird, so genügt: \begin{lstcode} \addtokomafont{pagehead}{\small} \end{lstcode} @@ -962,10 +962,10 @@ finden. \autoref{tab:maincls.fontelements}, \autopageref{tab:maincls.fontelements}). \end{Example} -Es ist an dieser Stelle nicht möglich, Versalien für die automatischen -Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, müssen Sie beispielsweise +Es ist an dieser Stelle nicht möglich, Versalien für die automatischen +Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, müssen Sie beispielsweise \DescRef{tocbasic.cmd.MakeMarkcase}\IndexCmd{MakeMarkcase} entsprechend -umdefinieren. Es wird jedoch empfohlen, in solchen Fällen das Paket +umdefinieren. Es wird jedoch empfohlen, in solchen Fällen das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} zu verwenden (siehe \autoref{cha:scrlayer-scrpage}, \DescPageRef{scrlayer-scrpage.option.markcase}). @@ -974,20 +974,20 @@ Werden\textnote{Tipp!} eigene Seitenstile definiert, sind eventuell die Befehle \DescRef{\LabelBase.cmd.usekomafont}\PParameter{pageheadfoot}, \DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagenumber} sowie \DescRef{\LabelBase.cmd.usekomafont}\PParameter{pagefoot} -nützlich. Insbesondere falls Sie dafür nicht das \KOMAScript-Paket +nützlich. Insbesondere falls Sie dafür nicht das \KOMAScript-Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} (siehe \autoref{cha:scrlayer-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 +\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 +so bleiben Schriftänderungen wie in den vorangehenden Beispielen unbeachtet. Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% -\IndexPackage{scrlayer-scrpage} sorgt selbst für maximale -Kompatibilität. Solange beispielsweise für die Seitenzahl nicht direkt +\IndexPackage{scrlayer-scrpage} sorgt selbst für maximale +Kompatibilität. Solange beispielsweise für die Seitenzahl nicht direkt \DescRef{\LabelBase-experts.cmd.thepage}\IndexCmd{thepage}, sondern -das dafür vorgesehene +das dafür vorgesehene \DescRef{\LabelBase-experts.cmd.pagemark}\IndexCmd{pagemark} verwendet wird.% \EndIndexGroup @@ -1009,14 +1009,14 @@ verwendet. Im einseitigen Satz existiert nur die rechte Marke. Bei Verwendung des Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} steht -außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}% +außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}% \IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} zur -Verfügung. +Verfügung. -Die Anweisungen können auch zusammen mit anderen Seitenstilen verwendet +Die Anweisungen können auch zusammen mit anderen Seitenstilen verwendet werden. Bei Kombination mit automatischen Kolumnentiteln, etwa dem Seitenstil \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}, ist der -Wirkungsbereich allerdings bis zum nächsten automatischen Setzen der +Wirkungsbereich allerdings bis zum nächsten automatischen Setzen der entsprechenden Marke begrenzt.% % \EndIndexGroup @@ -1032,12 +1032,12 @@ entsprechenden Marke begrenzt.% \Index{Kapitel>Seitenstil}% \Index{Stichwortverzeichnis>Seitenstil}% Auf einigen Seiten wird mit Hilfe von \DescRef{\LabelBase.cmd.thispagestyle} -automatisch ein anderer Seitenstil gewählt. Welcher Seitenstil dies ist, wird +automatisch ein anderer Seitenstil gewählt. Welcher Seitenstil dies ist, wird diesen vier Makros entnommen, wobei \Macro{partpagestyle} und \Macro{chapterpagestyle}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nur bei den Klassen \Class{scrbook} und \Class{scrreprt} nicht jedoch bei \Class{scrartcl} existieren. In der Voreinstellung ist der Seitenstil in allen -vier Fällen \DescRef{\LabelBase.pagestyle.plain}\IndexPagestyle{plain}. Die +vier Fällen \DescRef{\LabelBase.pagestyle.plain}\IndexPagestyle{plain}. Die Bedeutung der einzelnen Makros entnehmen Sie bitte \autoref{tab:specialpagestyles}. % @@ -1047,7 +1047,7 @@ Bedeutung der einzelnen Makros entnehmen Sie bitte \label{tab:specialpagestyles} \begin{desctabular} \mentry{titlepagestyle}{Seitenstil der Seite mit der Titelei bei - Titelköpfen (siehe \autoref{sec:\LabelBase.titlepage})}% + Titelköpfen (siehe \autoref{sec:\LabelBase.titlepage})}% \mentry{partpagestyle}{Seitenstil der Seiten mit \DescRef{\LabelBase.cmd.part}-Titeln (siehe \autoref{sec:\LabelBase.structure})}% \mentry{chapterpagestyle}{Seitenstil auf Kapitelanfangsseiten (siehe @@ -1057,28 +1057,29 @@ Bedeutung der einzelnen Makros entnehmen Sie bitte \end{desctabular} \end{table} % -Die Seitenstile können mit Hilfe von \Macro{renewcommand} umdefiniert +Die Seitenstile können mit Hilfe von \Macro{renewcommand} umdefiniert werden. \begin{Example} Angenommen, Sie wollen nicht, dass die Seiten mit der - \DescRef{\LabelBase.cmd.part}-Überschrift mit einer Nummer versehen - werden. Dann setzen Sie folgende Anweisung beispielsweise in der Präambel + \DescRef{\LabelBase.cmd.part}-Ãœberschrift mit einer Nummer versehen + werden. Dann setzen Sie folgende Anweisung beispielsweise in der Präambel Ihres Dokuments: \begin{lstcode} \renewcommand*{\partpagestyle}{empty} \end{lstcode} Wie Sie auf \DescPageRef{\LabelBase.pagestyle.empty} erfahren haben, ist der Seitenstil \DescRef{\LabelBase.pagestyle.empty}\IndexPagestyle{empty} - genau das, was in diesem Beispiel verlangt wird. Natürlich können Sie auch + genau das, was in diesem Beispiel verlangt wird. Natürlich können Sie auch einen selbst definierten Seitenstil verwenden. Angenommen, Sie haben mit dem Paket - \hyperref[cha:scrlayer]{\Package{scrlayer}} (siehe \autoref{cha:scrlayer}) - oder Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} - (siehe \autoref{cha:scrlayer-scrpage}) einen eigenen Seitenstil für - Kapitelanfangsseiten\Index{Kapitel>Seitenstil}% + \hyperref[cha:scrlayer]{\Package{scrlayer}} (siehe + \autoref{sec:scrlayer.pagestyles}) oder Paket + \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} (siehe + \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}) 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 ihn auch tatsächlich zu + den passenden Namen \PValue{chapter} gegeben. Um ihn auch tatsächlich zu verwenden, definieren Sie \Macro{chapterpagestyle} entsprechend um: \begin{lstcode} \renewcommand*{\chapterpagestyle}{chapter} @@ -1099,10 +1100,10 @@ werden. \pagestyle{headings} \renewcommand*{\chapterpagestyle}{plain} \end{lstcode} - Sie können die Umdefinierung des Seitenstils für Kapitelanfangsseiten aber - auch lokal halten. Das hat den Vorteil, dass Sie dann keine Annahmen über - die vor der Änderung gültige Einstellung treffen müssen. Die Änderung - des Seitenstils selbst können Sie gleichermaßen lokal halten: + Sie können die Umdefinierung des Seitenstils für Kapitelanfangsseiten aber + auch lokal halten. Das hat den Vorteil, dass Sie dann keine Annahmen über + die vor der Änderung gültige Einstellung treffen müssen. Die Änderung + des Seitenstils selbst können Sie gleichermaßen lokal halten: \begin{lstcode} \clearpage \begingroup @@ -1113,13 +1114,13 @@ werden. \endgroup \end{lstcode} Beachten\textnote{Achtung!} Sie jedoch, dass Sie niemals eine nummerierte - Gliederungsüberschrift in eine Gruppe packen sollten. Anderenfalls können + Gliederungsüberschrift in eine Gruppe packen sollten. Anderenfalls können Anweisungen wie \Macro{label} rasch zu unvorhergesehenen Ergebnissen - führen. + führen. Auf \DescPageRef{tocbasic.cmd.AfterTOCHead} in \autoref{sec:tocbasic.toc} werden Sie die Anweisung \DescRef{tocbasic.cmd.AfterTOCHead} kennenlernen, - mit der eine Lösung noch einfacher ist: + mit der eine Lösung noch einfacher ist: \begin{lstcode} \AfterTOCHead[toc]{% \thispagestyle{empty}% @@ -1132,17 +1133,17 @@ werden. \end{Example} \begin{Explain} - Wer nun glaubt, er könne auf Kapitelanfangsseiten ebenfalls mit + Wer nun glaubt, er könne auf Kapitelanfangsseiten ebenfalls mit lebenden Kolumnentiteln arbeiten, indem er einfach \begin{lstcode} \renewcommand*{\chapterpagestyle}{headings} \end{lstcode} verwendet, sollte in \autoref{sec:maincls-experts.addInfos} auf - \DescPageRef{maincls-experts.cmd.rightmark} Näheres über die - Hintergründe zu \DescRef{maincls-experts.cmd.rightmark} nachlesen. Auch die - Ausführungen zu \DescRef{scrlayer-scrpage-experts.cmd.rightfirstmark} ab + \DescPageRef{maincls-experts.cmd.rightmark} Näheres über die + Hintergründe zu \DescRef{maincls-experts.cmd.rightmark} nachlesen. Auch die + Ausführungen zu \DescRef{scrlayer-scrpage-experts.cmd.rightfirstmark} ab Seite \DescPageRef{scrlayer-scrpage-experts.cmd.rightfirstmark} in - \autoref{cha:scrlayer-scrpage-experts}, \autoref{part:forExperts} können + \autoref{cha:scrlayer-scrpage-experts}, \autoref{part:forExperts} können hierzu wichtige Informationen liefern.% \end{Explain} % @@ -1154,17 +1155,17 @@ werden. \end{Declaration} Diese Anweisung funktioniert bei \KOMAScript{} in der gleichen Weise wie bei den Standardklassen. Genau genommen handelt es sich dabei weder um eine -Fähigkeit der Standardklassen noch der \KOMAScript-Klassen, sondern um eine +Fähigkeit der Standardklassen noch der \KOMAScript-Klassen, sondern um eine Anweisung des \LaTeX-Kerns. Sie wird verwendet, um den -\PName{Nummerierungsstil} für die Seitenzahlen umzuschalten. +\PName{Nummerierungsstil} für die Seitenzahlen umzuschalten. Die Umschaltung gilt ab sofort, also ab der Seite, auf der diese Anweisung aufgerufen wird. Gegebenenfalls sollte also zuvor mit \DescRef{\LabelBase.cmd.clearpage} oder besser \DescRef{\LabelBase.cmd.cleardoubleoddpage}% \important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}% -\IndexCmd{cleardoubleoddpage} diese Seite erst beendet werden. Mögliche -Angaben für den \PName{Nummerierungsstil} sind \autoref{tab:numberKind} zu +\IndexCmd{cleardoubleoddpage} diese Seite erst beendet werden. Mögliche +Angaben für den \PName{Nummerierungsstil} sind \autoref{tab:numberKind} zu entnehmen. % \begin{table} @@ -1176,57 +1177,57 @@ entnehmen. \begin{captionbeside} {\label{tab:numberKind}% \hspace{0pt plus 1ex}% - Verfügbare Nummerierungsstile für Seitenzahlen} + Verfügbare Nummerierungsstile für Seitenzahlen} \begin{tabular}[t]{lll} \toprule Nummerierungsstil & Beispiel & Bedeutung \\ \midrule \PValue{arabic} & 8 & arabische Zahlen \\ - \PValue{roman} & viii & kleine römische Zahlen \\ - \PValue{Roman} & VIII & große römische Zahlen \\ + \PValue{roman} & viii & kleine römische Zahlen \\ + \PValue{Roman} & VIII & große römische Zahlen \\ \PValue{alph} & h & Kleinbuchstaben \\ - \PValue{Alph} & H & Großbuchstaben \\ + \PValue{Alph} & H & Großbuchstaben \\ \bottomrule \end{tabular} \end{captionbeside} \end{table} Der\textnote{Achtung!} Aufruf von \Macro{pagenumbering} setzt immer die -Seitenzahl\Index{Seiten>Zahl} zurück. Die aktuelle Seite bekommt also die -Nummer 1 im gewählten \PName{Nummerierungsstil}. Damit bei doppelseitigen +Seitenzahl\Index{Seiten>Zahl} zurück. Die aktuelle Seite bekommt also die +Nummer 1 im gewählten \PName{Nummerierungsstil}. Damit bei doppelseitigen Dokumenten diese neue Seite auch wirklich auf eine gerade Seite folgt, die linke Seite also nicht etwa fehlt, sollte man daher vor \Macro{pagenumbering} immer \DescRef{\LabelBase.cmd.cleardoubleoddpage}% \important{\DescRef{\LabelBase.cmd.cleardoubleoddpage}}% -\IndexCmd{cleardoubleoddpage} einfügen. Näheres zu einer dabei gegebenenfalls -eingefügten Vakatseite erfahren Sie im nächsten Abschnitt. +\IndexCmd{cleardoubleoddpage} einfügen. Näheres zu einer dabei gegebenenfalls +eingefügten Vakatseite erfahren Sie im nächsten Abschnitt. \begin{Explain} - Lassen Sie mich noch ein Wort zu einem häufigen Fehler verlieren, den man in - diversen Vorlagen findet, die im Internet kursieren. Wenn Sie -- natürlich + Lassen Sie mich noch ein Wort zu einem häufigen Fehler verlieren, den man in + diversen Vorlagen findet, die im Internet kursieren. Wenn Sie -- natürlich ohne den Eingangskommentar -- auf Zeilen wie: \begin{lstcode} - % Achtung dieses Beispiel enthält Fehler! - % Beachten Sie bitte die Erklärungen im Text! + % Achtung dieses Beispiel enthält Fehler! + % Beachten Sie bitte die Erklärungen im Text! \tableofcontents \pagenumbering{arabic} \setcounter{page}{1} \end{lstcode} - stoßen, so ist das ein untrügliches Zeichen dafür, dass der Ersteller dieser - Vorlage obige Ausführungen nicht gelesen oder nicht verstanden hat. Da + stoßen, so ist das ein untrügliches Zeichen dafür, dass der Ersteller dieser + Vorlage obige Ausführungen nicht gelesen oder nicht verstanden hat. Da \DescRef{\LabelBase.cmd.tableofcontents} das Inhaltsverzeichnis zwar - ausgibt, aber die letzte Seite nicht automatisch beendet, wird bereits für + ausgibt, aber die letzte Seite nicht automatisch beendet, wird bereits für diese letzte Seite des Inhaltsverzeichnisses die Seitennummerierung - umgeschaltet. Sie erhält damit die arabische Seitenzahl 1. Es fehlt also + umgeschaltet. Sie erhält damit die arabische Seitenzahl 1. Es fehlt also \DescRef{\LabelBase.cmd.cleardoubleoddpage} vor \Macro{pagenumbering}. Ebenso ist die letzte Zeile mit dem Setzen der - Seitennummerierung auf 1 überflüssig, da dies bereits von + Seitennummerierung auf 1 überflüssig, da dies bereits von \Macro{pagenumbering} erledigt wird. - Teilweise findet man -- natürlich ohne den Eingangskommentar -- auch: + Teilweise findet man -- natürlich ohne den Eingangskommentar -- auch: \begin{lstcode} - % Achtung dieses Beispiel enthält Fehler! - % Beachten Sie bitte die Erklärungen im Text! + % Achtung dieses Beispiel enthält Fehler! + % Beachten Sie bitte die Erklärungen im Text! \tableofcontents \pagebreak \pagenumbering{arabic} @@ -1234,51 +1235,51 @@ eingefügten Vakatseite erfahren Sie im nächsten Abschnitt. \end{lstcode} Hier hat der Ersteller versucht, das Problem mit der letzten Seite des Inhaltsverzeichnisses mit Hilfe von \Macro{pagebreak}\IndexCmd{pagebreak} zu - lösen. + lösen. - Diese Lösung ist aber leider auch nicht viel besser. Hier wird die letzte - Seite des Inhaltsverzeichnisses auf die nächste Seite umbrochen. Damit - werden bei einem doppelseitigen Dokument unter Umständen die Einträge auf - der letzten Seite mit einem erhöhten vertikalen Abstand gesetzt (siehe + Diese Lösung ist aber leider auch nicht viel besser. Hier wird die letzte + Seite des Inhaltsverzeichnisses auf die nächste Seite umbrochen. Damit + werden bei einem doppelseitigen Dokument unter Umständen die Einträge auf + der letzten Seite mit einem erhöhten vertikalen Abstand gesetzt (siehe \DescRef{\LabelBase.cmd.flushbottom} auf \DescPageRef{\LabelBase.cmd.flushbottom}). \Macro{pagebreak} ist hier eindeutig die falsche Anweisung. Aber auch \Macro{newpage}\IndexCmd{newpage} oder - \DescRef{\LabelBase.cmd.clearpage} würden bei einem doppelseitigen Dokument - nicht genügen. Hätte die letzte Seite des Inhaltsverzeichnisses - beispielsweise die römische Nummer vii, so würde auf die römisch nummerierte + \DescRef{\LabelBase.cmd.clearpage} würden bei einem doppelseitigen Dokument + nicht genügen. Hätte die letzte Seite des Inhaltsverzeichnisses + beispielsweise die römische Nummer vii, so würde auf die römisch nummerierte rechte Seite nun unmittelbar die arabisch nummerierte rechte Seite 1 - folgen. Eine linke Seite zwischen diesen beiden Seiten würde im Dokument - fehlen, was beim späteren Druck erhebliche Probleme bereiten könnte. + folgen. Eine linke Seite zwischen diesen beiden Seiten würde im Dokument + fehlen, was beim späteren Druck erhebliche Probleme bereiten könnte. Mein Rat: Vermeiden Sie die Verwendung von Vorlagen, die bereits in solch - einfachen Dingen Fehler enthalten. Korrekt wäre übrigens: + einfachen Dingen Fehler enthalten. Korrekt wäre übrigens: \begin{lstcode} \tableofcontents \cleardoubleoddpage \pagenumbering{arabic} \end{lstcode} Das gilt auch, wenn mit \Class{scrartcl}\OnlyAt{\Class{scrartcl}} eine - Klasse verwendet wird, bei der üblicherweise nach dem Inhaltsverzeichnis + Klasse verwendet wird, bei der üblicherweise nach dem Inhaltsverzeichnis keine neue Seite begonnen wird. Schaltet man die Seitennummerierung um, so muss eine neue rechte Seite begonnen werden. Wollen Sie eine solche - Umschaltung nicht, so sollten Sie den Nummerierungsstil der Seiten über das + Umschaltung nicht, so sollten Sie den Nummerierungsstil der Seiten über das gesamte Dokument konsequent durchhalten, ohne ihn zwischendurch zu - ändern. + ändern. \iffalse% Umbruchkorrekturtext Bei Artikeln oder anderen kurzen Dokumenten ist das generell zu empfehlen. \fi - Einfacher wird die Änderung des Nummerierungsstils bei Verwendung von + Einfacher wird die Änderung des Nummerierungsstils bei Verwendung von \Class{scrbook}\OnlyAt{\Class{scrbook}}. Dort werden Sie durch die beiden Anweisungen \DescRef{\LabelBase.cmd.frontmatter}% \important{\DescRef{\LabelBase.cmd.frontmatter}\\ \DescRef{\LabelBase.cmd.mainmatter}}% \IndexCmd{fontmatter} und \DescRef{\LabelBase.cmd.mainmatter}% - \IndexCmd{mainmatter} bei der am häufigsten verwendeten Umschaltung - unterstützt. Nähere Informationen entnehmen Sie bitte + \IndexCmd{mainmatter} bei der am häufigsten verwendeten Umschaltung + unterstützt. Nähere Informationen entnehmen Sie bitte \autoref{sec:maincls.separation}, ab \DescPageRef{\LabelBase.cmd.mainmatter}.% \end{Explain}% @@ -1288,15 +1289,15 @@ eingefügten Vakatseite erfahren Sie im nächsten Abschnitt. \LoadCommonFile{interleafpage}% \section{Vakatseiten} -\LoadCommonFile{footnotes}% \section{Fußnoten} +\LoadCommonFile{footnotes}% \section{Fußnoten} \section[Abgrenzung]{Abgrenzung\protect\OnlyAt{\Class{scrbook}}} \seclabel{separation} -Bei Büchern gibt es teilweise die Grobauf"|teilung in +Bei Büchern gibt es teilweise die Grobauf"|teilung in \emph{Vorspann}\Index{Vorspann}, \emph{Hauptteil}\Index{Hauptteil} und -\emph{Nachspann}\Index{Nachspann}. Auch \KOMAScript{} bietet für -\Class{scrbook} diese Möglichkeit. +\emph{Nachspann}\Index{Nachspann}. Auch \KOMAScript{} bietet für +\Class{scrbook} diese Möglichkeit. \begin{Declaration} @@ -1305,29 +1306,29 @@ Bei Büchern gibt es teilweise die Grobauf"|teilung in \Macro{backmatter} \end{Declaration}% Mit \Macro{frontmatter}\important{\Macro{frontmatter}} wird der Vorspann -eingeleitet. Im Vorspann werden die nummerierten Seiten mit römischen -Seitenzahlen versehen. Kapitelüberschriften sind im Vorspann nicht -nummeriert. Abschnittsüberschriften wären jedoch nummeriert, gingen von -Kapitelnummer~0 aus und wären außerdem über Kapitelgrenzen hinweg durchgehend -nummeriert. Dies spielt jedoch keine Rolle, da der Vorspann allenfalls für die +eingeleitet. Im Vorspann werden die nummerierten Seiten mit römischen +Seitenzahlen versehen. Kapitelüberschriften sind im Vorspann nicht +nummeriert. Abschnittsüberschriften wären jedoch nummeriert, gingen von +Kapitelnummer~0 aus und wären außerdem über Kapitelgrenzen hinweg durchgehend +nummeriert. Dies spielt jedoch keine Rolle, da der Vorspann allenfalls für die Titelei, das Inhalts-\Index{Inhaltsverzeichnis}, Abbildungs-\Index{Abbildungen>Verzeichnis} und Tabellenverzeichnis\Index{Tabellen>Verzeichnis} und ein Vorwort\Index{Vorwort} verwendet wird. Das Vorwort kann also als normales Kapitel gesetzt werden. Ein Vorwort sollte niemals in Abschnitte unterteilt, -sondern möglichst kurz gefasst werden. Im Vorwort wird also keine tiefere -Gliederungsebene als Kapitel benötigt. +sondern möglichst kurz gefasst werden. Im Vorwort wird also keine tiefere +Gliederungsebene als Kapitel benötigt. -Für den Fall, dass der Anwender dies anders sieht und nummerierte +Für den Fall, dass der Anwender dies anders sieht und nummerierte Abschnitte\Index{Abschnitt>Nummer} in den Kapiteln des Vorspanns haben will, -enthält ab Version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}}% +enthält ab Version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}}% \important{\OptionValueRef{\LabelBase}{version}{2.97e}} die Nummerierung der -Abschnitte keine Kapitelnummer. Diese Änderung gibt es nur, wenn eine -Kompatibilität ab Version~2.97e eingestellt ist (siehe Option +Abschnitte keine Kapitelnummer. Diese Änderung gibt es nur, wenn eine +Kompatibilität ab Version~2.97e eingestellt ist (siehe Option \DescRef{\LabelBase.option.version}, \autoref{sec:\LabelBase.compatibilityOptions}, -\DescPageRef{\LabelBase.option.version}). Es wird ausdrücklich darauf -hingewiesen, dass dadurch bezüglich der Nummern eine Verwechslung mit +\DescPageRef{\LabelBase.option.version}). Es wird ausdrücklich darauf +hingewiesen, dass dadurch bezüglich der Nummern eine Verwechslung mit Kapitelnummern gegeben ist! Die Verwendung von \DescRef{\LabelBase.cmd.addsec} und \DescRef{\LabelBase.cmd.section*} (siehe \autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.cmd.section*} und \DescPageRef{\LabelBase.cmd.addsec}) @@ -1335,26 +1336,26 @@ sind aus Sicht des Autors im Vorspann deshalb unbedingt vorzuziehen! Ab Version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}}% \important{\OptionValueRef{\LabelBase}{version}{2.97e}} enthalten auch die -Nummern für Gleitumgebungen wie Tabellen\Index{Tabellen>Nummern} und +Nummern für Gleitumgebungen wie Tabellen\Index{Tabellen>Nummern} und Abbildungen\Index{Abbildungen>Nummern} und die Gleichungsnummern\Index{Gleichungen>Nummern} im Vorspann keinen Kapitelanteil. Auch dies erfordert eine entsprechende -Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}, +Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}, \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}). Mit \Macro{mainmatter}\important{\Macro{mainmatter}} wird der Hauptteil eingeleitet. Existiert kein Vorspann, so kann diese Anweisung auch entfallen. Im Hauptteil sind arabische Seitenzahlen voreingestellt. Die -Seitenzählung beginnt im Hauptteil neu mit der 1. +Seitenzählung beginnt im Hauptteil neu mit der 1. Mit \Macro{backmatter}\important{\Macro{backmatter}} wird der Nachspann -eingeleitet. Was zum Nachspann gehört, ist unterschiedlich. Manchmal wird im +eingeleitet. Was zum Nachspann gehört, ist unterschiedlich. Manchmal wird im Nachspann nur das Literaturverzeichnis\Index{Literaturverzeichnis}, manchmal nur das Stichwortverzeichnis\Index{Stichwortverzeichnis} gesetzt. Manchmal -erscheint der gesamte Anhang im Nachspann. Der Nachspann gleicht bezüglich der -Gliederungsüberschriften dem Vorspann. Eine getrennte Seitennummerierung ist -jedoch nicht vorgesehen. Falls Sie dies ebenfalls benötigen, bedienen Sie sich +erscheint der gesamte Anhang im Nachspann. Der Nachspann gleicht bezüglich der +Gliederungsüberschriften dem Vorspann. Eine getrennte Seitennummerierung ist +jedoch nicht vorgesehen. Falls Sie dies ebenfalls benötigen, bedienen Sie sich bitte der Anweisung \DescRef{\LabelBase.cmd.pagenumbering}% \important{\DescRef{\LabelBase.cmd.pagenumbering}} aus \autoref{sec:\LabelBase.pagestyle}, @@ -1376,16 +1377,16 @@ Teile, Kapitel, Abschnitte und weitere Gliederungsebenen. \OptionVName{open}{Methode} \end{Declaration}% Bei\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} den \KOMAScript-Klassen -\Class{scrbook} und \Class{scrreprt} kann gewählt werden, wo im doppelseitigen +\Class{scrbook} und \Class{scrreprt} kann gewählt werden, wo im doppelseitigen Satz neue Kapitel beginnen. In der Voreinstellung beginnen bei -\Class{scrreprt} neue Kapitel\Index{Kapitel>Anfang} auf der nächsten neuen -Seite. Dies entspricht der \PName{Methode} \PValue{any}. Demgegenüber beginnen -bei \Class{scrbook} neue Kapitel auf der nächsten rechten Seite. Dies -entspricht der \PName{Methode} \PValue{right} und ist bei den meisten Büchern -üblich. In einigen Fällen sollen neue Kapitel jedoch auf der linken Seite +\Class{scrreprt} neue Kapitel\Index{Kapitel>Anfang} auf der nächsten neuen +Seite. Dies entspricht der \PName{Methode} \PValue{any}. Demgegenüber beginnen +bei \Class{scrbook} neue Kapitel auf der nächsten rechten Seite. Dies +entspricht der \PName{Methode} \PValue{right} und ist bei den meisten Büchern +üblich. In einigen Fällen sollen neue Kapitel jedoch auf der linken Seite einer kompletten Doppelseite beginnen. Dies entspricht der \PName{Methode} \PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}}. -Eine Zusammenfassung der möglichen Werte findet sich in +Eine Zusammenfassung der möglichen Werte findet sich in \autoref{tab:maincls.open}. Dabei sind auch die Auswirkungen auf \DescRef{\LabelBase.cmd.cleardoublepage} sowie % die vier \KOMAScript"=Anweisungen @@ -1397,8 +1398,8 @@ Anweisungen, \DescRef{\LabelBase.cmd.cleardoubleemptypage}, (siehe \DescPageRef{\LabelBase.cmd.cleardoublepage}) angegeben. \begin{table} - \caption[{Mögliche Werte für Option \Option{open}}]{Mögliche Werte für - Option \Option{open} zur Auswahl von Umbrüchen mit Vakatseiten bei + \caption[{Mögliche Werte für Option \Option{open}}]{Mögliche Werte für + Option \Option{open} zur Auswahl von Umbrüchen mit Vakatseiten bei \Class{scrbook} und \Class{scrreprt}} \begin{desctabular} \pventry{any}{% @@ -1420,8 +1421,8 @@ Anweisungen, \DescRef{\LabelBase.cmd.cleardoubleemptypage}, (siehe \DescRef{\LabelBase.cmd.cleardoubleplainpage}, \DescRef{\LabelBase.cmd.cleardoubleemptypage} und \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch - und fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im - doppelseitigen Satz auf die nächste linke Seite zu gelangen.% + und fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im + doppelseitigen Satz auf die nächste linke Seite zu gelangen.% \IndexOption{open~=\textKValue{left}}}% \pventry{right}{% Teile, Kapitel, Index und Nachspann verwenden @@ -1431,8 +1432,8 @@ Anweisungen, \DescRef{\LabelBase.cmd.cleardoubleemptypage}, (siehe \DescRef{\LabelBase.cmd.cleardoubleplainpage}, \DescRef{\LabelBase.cmd.cleardoubleemptypage} und \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch - und fügen gegebenenfalls eine Vakatseite ein, um im doppelseitigen Satz - auf die nächste rechte Seite zu gelangen.% + und fügen gegebenenfalls eine Vakatseite ein, um im doppelseitigen Satz + auf die nächste rechte Seite zu gelangen.% \IndexOption{open~=\textKValue{right}}}% \end{desctabular} \label{tab:maincls.open} @@ -1442,7 +1443,7 @@ Da im einseitigen Satz nicht zwischen linken und rechten Seiten unterschieden wird, hat die Option dort keine Wirkung. Bei der Klasse \Class{scrartcl} ist die oberste Gliederungsebene unter dem -Teil der Abschnitt. Daher unterstützt \Class{scrartcl} diese Option nicht.% +Teil der Abschnitt. Daher unterstützt \Class{scrartcl} diese Option nicht.% % \EndIndexGroup @@ -1453,41 +1454,41 @@ Teil der Abschnitt. Daher unterstützt \Class{scrartcl} diese Option nicht.% \Macro{IfChapterUsesPrefixLine}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration}% Bei\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} den Standardklassen -\Class{book} und \Class{report} werden Kapitelüberschriften% -\Index{Kapitel>Ueberschrift=Überschrift} in der Form ausgegeben, dass zunächst -in einer Zeile »Kapitel«\iffree{\footnote{Bei Verwendung einer anderen Sprache - als Deutsch wird »Kapitel« selbstverständlich in der jeweiligen Sprache - gesetzt.}}{\footnote{Die Ausgabe erfolgt tatsächlich in der aktuell +\Class{book} und \Class{report} werden Kapitelüberschriften% +\Index{Kapitel>Ueberschrift=Ãœberschrift} in der Form ausgegeben, dass zunächst +in einer Zeile »Kapitel«\iffree{\footnote{Bei Verwendung einer anderen Sprache + als Deutsch wird »Kapitel« selbstverständlich in der jeweiligen Sprache + gesetzt.}}{\footnote{Die Ausgabe erfolgt tatsächlich in der aktuell aktiven Sprache.}}, % -gefolgt von der Kapitelnummer steht. Erst ab der nächsten Zeile wird dann die -Überschrift in linksbündigem Flattersatz ausgegeben. Bei {\KOMAScript} kann +gefolgt von der Kapitelnummer steht. Erst ab der nächsten Zeile wird dann die +Ãœberschrift in linksbündigem Flattersatz ausgegeben. Bei {\KOMAScript} kann dieses Verhalten mit der Klassenoption \Option{chapterprefix} ebenfalls -erreicht werden. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für +erreicht werden. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt\textnote{\KOMAScript{} vs. Standardklassen} ist -\OptionValue{chapterprefix}{false}, während das +\OptionValue{chapterprefix}{false}, während das Verhalten\important{\Option{chapterprefix}} der Standardklassen \OptionValue{chapterprefix}{true} entspricht. Die Optionen wirken sich -außerdem auf das Aussehen der automatischen Kolumnentitel für Kapitel aus +außerdem auf das Aussehen der automatischen Kolumnentitel für Kapitel aus (siehe \autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.pagestyle.headings}). -Zuweilen kommt es vor, dass man die Kapitelüberschriften im Hauptteil durchaus +Zuweilen kommt es vor, dass man die Kapitelüberschriften im Hauptteil durchaus in der einfachen Form von \OptionValue{chapterprefix}{false} setzen -möchte. Gleichzeitig\important{\Option{appendixprefix}} sollen die -Überschriften im Anhang\Index{Anhang} jedoch davon abweichend mit einer -Präfixzeile --~»Anhang«, gefolgt vom Buchstaben des Anhangs~-- versehen +möchte. Gleichzeitig\important{\Option{appendixprefix}} sollen die +Ãœberschriften im Anhang\Index{Anhang} jedoch davon abweichend mit einer +Präfixzeile --~»Anhang«, gefolgt vom Buchstaben des Anhangs~-- versehen werden. Dies ist mit der Einstellung \OptionValue{appendixprefix}{true} -möglich. Da sich jedoch dadurch ein inkonsistentes Layout ergibt, rate ich von -der Verwendung ab. Letztlich führt die Option dazu, dass -\Option{chapterprefix} zu Beginn des Anhangs automatisch geändert wird. +möglich. Da sich jedoch dadurch ein inkonsistentes Layout ergibt, rate ich von +der Verwendung ab. Letztlich führt die Option dazu, dass +\Option{chapterprefix} zu Beginn des Anhangs automatisch geändert wird. Mit der Anweisung \Macro{IfChapterUsesPrefixLine}\ChangedAt{v3.18}{\Class{scrbook}\and - \Class{scrreprt}} kann man Code in Abhängigkeit der aktuellen Einstellung -für die Präfixzeile ausführen. Ist \Option{chapterprefix} aktiv, so wird der -\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. + \Class{scrreprt}} kann man Code in Abhängigkeit der aktuellen Einstellung +für die Präfixzeile ausführen. Ist \Option{chapterprefix} aktiv, so wird der +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. \BeginIndex{FontElement}{chapterprefix}% Die Schriftart der Kapitelnummernzeile bei \OptionValue{chapterprefix}{true} @@ -1495,109 +1496,110 @@ oder \OptionValue{appendixprefix}{true} kann mit den beiden Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -für das Element \FontElement{chapterprefix}% -\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} geändert +für das Element \FontElement{chapterprefix}% +\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} geändert werden. Voreingestellt ist die Verwendung des Elements \DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter} (siehe \DescPageRef{\LabelBase.cmd.chapter}, sowie \autoref{tab:maincls.structureElementsFont}, \autopageref{tab:maincls.structureElementsFont}). -Weitere Einstellmöglichkeiten für Kapitelüberschriften sind den Erklärungen -zu \DescRef{maincls-experts.cmd.RedeclareSectionCommand} sowie den Anweisungen +Weitere Einstellmöglichkeiten für Kapitelüberschriften sind den Erklärungen zu +\DescRef{maincls-experts.cmd.RedeclareSectionCommand} sowie den Anweisungen \DescRef{maincls-experts.cmd.chapterlineswithprefixformat} und \DescRef{maincls-experts.cmd.chapterlinesformat} in -\autoref{sec:maincls-experts.experts}, \autoref{part:forExperts} zu entnehmen.% +\autoref{sec:maincls-experts.sections}, \autoref{part:forExperts} zu +entnehmen.% \EndIndexGroup \begin{Declaration} \OptionVName{headings}{Einstellung} \end{Declaration} -Die Überschriften\index{Ueberschriften=Überschriften} werden sowohl bei den -Standardklassen als auch bei {\KOMAScript} normalerweise recht groß -gesetzt. Dies gefällt nicht jedem und wirkt insbesondere bei kleinen -Papiergrößen oft störend. Daher stehen bei {\KOMAScript} neben den mit der +Die Ãœberschriften\index{Ueberschriften=Ãœberschriften} werden sowohl bei den +Standardklassen als auch bei {\KOMAScript} normalerweise recht groß +gesetzt. Dies gefällt nicht jedem und wirkt insbesondere bei kleinen +Papiergrößen oft störend. Daher stehen bei {\KOMAScript} neben den mit der Option \OptionValue{headings}{big}\IndexOption{headings~=\textKValue{big}}% \ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% \important{\OptionValue{headings}{big}\\ \OptionValue{headings}{normal}\\ - \OptionValue{headings}{small}} sehr groß voreingestellten Überschriften die -beiden Möglichkeiten + \OptionValue{headings}{small}} sehr groß voreingestellten Ãœberschriften die +beiden Möglichkeiten \OptionValue{headings}{normal}\IndexOption{headings~=\textKValue{normal}} und \OptionValue{headings}{small}\IndexOption{headings~=\textKValue{small}} zur -Verfügung, mit denen man insgesamt kleinere Überschriften erhält. Die aus den -Optionen resultierenden Schriftgrößen sind für die Überschriften der Klassen +Verfügung, mit denen man insgesamt kleinere Ãœberschriften erhält. Die aus den +Optionen resultierenden Schriftgrößen sind für die Ãœberschriften der Klassen \Class{scrbook} und \Class{scrreprt} \autoref{tab:maincls.structureElementsFont}, \autopageref{tab:maincls.structureElementsFont} zu entnehmen. Konkret setzen -alle drei Einstellungen die Schrift für die Elemente +alle drei Einstellungen die Schrift für die Elemente \DescRef{\LabelBase.fontelement.chapter}\IndexFontElement{chapter}, \DescRef{\LabelBase.fontelement.section}\IndexFontElement{section}, \DescRef{\LabelBase.fontelement.subsection}\IndexFontElement{subsection}, \DescRef{\LabelBase.fontelement.subsubsection}\IndexFontElement{subsubsection}, \DescRef{\LabelBase.fontelement.paragraph}\IndexFontElement{paragraph} und \DescRef{\LabelBase.fontelement.subparagraph}\IndexFontElement{subparagraph} -auf entsprechende Voreinstellungen zurück. Bei \Class{scrartcl} werden -generell etwas kleinere Überschriften verwendet. \OnlyAt{\Class{scrbook}\and - \Class{scrreprt}}Die Abstände vor und nach Kapitelüberschriften werden von +auf entsprechende Voreinstellungen zurück. Bei \Class{scrartcl} werden +generell etwas kleinere Ãœberschriften verwendet. \OnlyAt{\Class{scrbook}\and + \Class{scrreprt}}Die Abstände vor und nach Kapitelüberschriften werden von diesen Optionen ebenfalls neu definiert. \iffalse% -Auf Kapitelüberschriften wirkt sich außerdem die Option \Option{headings} mit +Auf Kapitelüberschriften wirkt sich außerdem die Option \Option{headings} mit den Einstellungen \PValue{twolinechapter} oder \PValue{onelinechapter} aus, -die den oben erklärten Optionen +die den oben erklärten Optionen \OptionValueRef{\LabelBase}{chapterprefix}{true} und \OptionValueRef{\LabelBase}{chapterprefix}{false} entsprechen. Im Anhang gibt -es zusätzlich Auswirkungen durch die Einstellungen \PValue{onelineappendix} -und \PValue{twolineappendix} für Option \Option{headings}, was dann +es zusätzlich Auswirkungen durch die Einstellungen \PValue{onelineappendix} +und \PValue{twolineappendix} für Option \Option{headings}, was dann \OptionValueRef{\LabelBase}{appendixprefix}{false} und \OptionValueRef{\LabelBase}{appendixprefix}{true} entspricht (siehe ebenfalls oben). \else% -Auf Kapitelüberschriften\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} wirken +Auf Kapitelüberschriften\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} wirken sich\important{% \OptionValue{headings}{twolinechapter}\\ \OptionValue{headings}{onelinechapter}\\ \OptionValue{headings}{twolineappendix}\\ \OptionValue{headings}{onelineappendix}% -} außerdem die beiden Optionen \OptionValue{headings}{twolinechapter} und -\OptionValue{headings}{onelinechapter}, die den oben erklärten +} außerdem die beiden Optionen \OptionValue{headings}{twolinechapter} und +\OptionValue{headings}{onelinechapter}, die den oben erklärten \OptionValueRef{\LabelBase}{chapterprefix}{true} und -\OptionValueRef{\LabelBase}{chapterprefix}{false} entsprechen, aus. Für den +\OptionValueRef{\LabelBase}{chapterprefix}{false} entsprechen, aus. Für den Anhang stehen als Alternativen zu \OptionValueRef{\LabelBase}{appendixprefix}{true} und \OptionValueRef{\LabelBase}{appendixprefix}{false} die Optionen \OptionValue{headings}{twolineappendix} und -\OptionValue{headings}{onelineappendix} zur Verfügung. \iffalse Für den +\OptionValue{headings}{onelineappendix} zur Verfügung. \iffalse Für den Anhang stehen \OptionValue{headings}{twolineappendix} und -\OptionValue{headings}{onelineappendix} zur Verfügung, die den Optionen +\OptionValue{headings}{onelineappendix} zur Verfügung, die den Optionen \OptionValueRef{\LabelBase}{appendixprefix}{true} und \OptionValueRef{\LabelBase}{appendixprefix}{false} entsprechen (siehe -ebenfalls oben). \fi Diese existieren natürlich nicht bei \Class{scrartcl}% +ebenfalls oben). \fi Diese existieren natürlich nicht bei \Class{scrartcl}% \iffree{}{% Umbruchkorrekturtext - , da diese Klasse nicht über Kapitel verfügt}% + , da diese Klasse nicht über Kapitel verfügt}% .% \fi Option\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} \OptionValue{headings}{standardclasses}% \important{\OptionValue{headings}{standardclasses}} passt zum Einen die -Schriftgrößen der Überschriften an die der Standardklassen an. Des Weiteren -wird die Schrift für Element +Schriftgrößen der Ãœberschriften an die der Standardklassen an. Des Weiteren +wird die Schrift für Element \DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition} auf -\Macro{bfseries} gesetzt. Es wird also für Überschriften nicht mehr auf einen +\Macro{bfseries} gesetzt. Es wird also für Ãœberschriften nicht mehr auf einen serifenlosen Font umgeschaltet. Bei Verwendung von \Class{scrbook}\OnlyAt{\Class{scrbook}\and\Class{scrreprt}} oder -\Class{scrreprt} wird außerdem \OptionValue{headings}{twolinechapter} gesetzt -und die Abstände bei den Kapitelüberschriften werden denen der Standardklassen +\Class{scrreprt} wird außerdem \OptionValue{headings}{twolinechapter} gesetzt +und die Abstände bei den Kapitelüberschriften werden denen der Standardklassen angepasst. -Für\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} Kapitel kann mit +Für\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} Kapitel kann mit \OptionValue{headings}{openany}\important{% \OptionValue{headings}{openany}\\ \OptionValue{headings}{openright}\\ \OptionValue{headings}{openleft}}, \OptionValue{headings}{openright} und -\OptionValue{headings}{openleft} die Methode für Kapitelanfänge alternativ zur +\OptionValue{headings}{openleft} die Methode für Kapitelanfänge alternativ zur Verwendung der Option \DescRef{\LabelBase.option.open} mit den Werten \PValue{any}, \PValue{right} und \PValue{left} (siehe oben) gesetzt werden. @@ -1617,46 +1619,46 @@ und \OptionValue{headings}{optiontoheadandtoc}% \IndexOption{headings~=\textKValue{optiontoheadandtoc}} beeinflusst werden. -Eine Zusammenfassung der möglichen Einstellungen für Option \Option{headings} +Eine Zusammenfassung der möglichen Einstellungen für Option \Option{headings} finden Sie in \autoref{tab:maincls.headings}. Beispiele zur Verwendung einiger -der möglichen Einstellungen sind in den nachfolgenden Beschreibungen +der möglichen Einstellungen sind in den nachfolgenden Beschreibungen der Gliederungsbefehle enthalten. \begin{desclist} - \desccaption[{Mögliche Werte für Option \Option{headings}}]{% - Mögliche Werte für Option \Option{headings} zur Einstellung der - Überschriften% + \desccaption[{Mögliche Werte für Option \Option{headings}}]{% + Mögliche Werte für Option \Option{headings} zur Einstellung der + Ãœberschriften% \label{tab:maincls.headings}% }{% - Mögliche Werte für Option \Option{headings} (\emph{Fortsetzung})% + Mögliche Werte für Option \Option{headings} (\emph{Fortsetzung})% }% \pventry{big}{% - Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen - zurück und verwendet große Überschriften mit großen Abständen darüber und + Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen + zurück und verwendet große Ãœberschriften mit großen Abständen darüber und darunter.% \IndexOption{headings~=\textKValue{big}}}% \pventry{normal}{% - Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen - zurück und verwendet mittelgroße Überschriften mit mittelgroßen Abständen - darüber und darunter.% + Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen + zurück und verwendet mittelgroße Ãœberschriften mit mittelgroßen Abständen + darüber und darunter.% \IndexOption{headings~=\textKValue{normal}}}% \entry{\PValue{onelineappendix}, \PValue{noappendixprefix}, \PValue{appendixwithoutprefix}, \PValue{appendixwithoutprefixline}% \IndexOption{headings~=\textKValue{onelineappendix}}}{% - Kapitelüberschriften im Anhang werden wie andere Überschriften auch + Kapitelüberschriften im Anhang werden wie andere Ãœberschriften auch gesetzt.}% \entry{\PValue{onelinechapter}, \PValue{nochapterprefix}, \PValue{chapterwithoutprefix}, \PValue{chapterwithoutprefixline}% \IndexOption{headings~=\textKValue{onelinechapter}}}{% - Kapitelüberschriften werden wie andere Überschriften auch gesetzt.}% + Kapitelüberschriften werden wie andere Ãœberschriften auch gesetzt.}% \pventry{openany}{% Die Anweisungen \DescRef{\LabelBase.cmd.cleardoublepageusingstyle}, \DescRef{\LabelBase.cmd.cleardoublestandardpage}, \DescRef{\LabelBase.cmd.cleardoubleplainpage}, \DescRef{\LabelBase.cmd.cleardoubleemptypage} und \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und - fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im + fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen Satz wie bei \OptionValue{headings}{openright} auf die - nächste rechte Seite zu gelangen. Teile, Kapitel, Index und Nachspann + nächste rechte Seite zu gelangen. Teile, Kapitel, Index und Nachspann verwenden \DescRef{\LabelBase.cmd.clearpage}, aber nicht \DescRef{\LabelBase.cmd.cleardoublepage}.% \IndexOption{headings~=\textKValue{openany}}}% @@ -1666,8 +1668,8 @@ der Gliederungsbefehle enthalten. \DescRef{\LabelBase.cmd.cleardoubleplainpage}, \DescRef{\LabelBase.cmd.cleardoubleemptypage} und \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und - fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen - Satz auf die nächste linke Seite zu gelangen. Teile, Kapitel, Index und + fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen + Satz auf die nächste linke Seite zu gelangen. Teile, Kapitel, Index und Nachspann verwenden \DescRef{\LabelBase.cmd.cleardoublepage}.% \IndexOption{headings~=\textKValue{openleft}}}% \pventry{openright}{% @@ -1676,15 +1678,15 @@ der Gliederungsbefehle enthalten. \DescRef{\LabelBase.cmd.cleardoubleplainpage}, \DescRef{\LabelBase.cmd.cleardoubleemptypage} und \DescRef{\LabelBase.cmd.cleardoublepage} erzeugen einen Seitenumbruch und - fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen - Satz auf die nächste rechte Seite zu gelangen. Teile, Kapitel, Index und + fügen gegebenenfalls eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen + Satz auf die nächste rechte Seite zu gelangen. Teile, Kapitel, Index und Nachspann verwenden \DescRef{\LabelBase.cmd.cleardoublepage}.% \IndexOption{headings~=\textKValue{openright}}}% \pventry{optiontohead}{% Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and \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.% + optionale Argument ausschließlich für den Kolumnentitel verwendet.% \IndexOption{headings~=\textKValue{optiontohead}}% }% \entry{\PValue{optiontoheadandtoc}, \PValue{optiontotocandhead}% @@ -1692,40 +1694,40 @@ der Gliederungsbefehle enthalten. Die\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and \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 + 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 Arguments der Gliederungsbefehle wird aktiviert. In der Voreinstellung wird das - optionale Argument ausschließlich für den Eintrag ins Inhaltsverzeichnis + optionale Argument ausschließlich für den Eintrag ins Inhaltsverzeichnis verwendet.% \IndexOption{headings~=\textKValue{optiontohead}}% }% \pventry{small}{% - Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen - zurück und verwendet kleine Überschriften mit kleinen Abständen darüber + Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen + zurück und verwendet kleine Ãœberschriften mit kleinen Abständen darüber und darunter.% \IndexOption{headings~=\textKValue{small}}}% \pventry{standardclasses}{% \ChangedAt{v3.12}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}% - Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen - zurück und verwendet Überschriften in den Größen der Standardklassen. Für - Kapitelüberschriften wird bei \Class{scrbook} und \Class{scrreprt} + Setzt die Schrifteinstellung für die einzelnen Standard-Gliederungsebenen + zurück und verwendet Ãœberschriften in den Größen der Standardklassen. Für + Kapitelüberschriften wird bei \Class{scrbook} und \Class{scrreprt} \OptionValue{headings}{twolinechapter} gesetzt.% }% \entry{\PValue{twolineappendix}, \PValue{appendixprefix}, \PValue{appendixwithprefix}, \PValue{appendixwithprefixline}% \IndexOption{headings~=\textKValue{twolineappendix}}}{% - Kapitelüberschriften im Anhang werden mit einer Vorsatzzeile gesetzt, + Kapitelüberschriften im Anhang werden mit einer Vorsatzzeile gesetzt, deren Inhalt von \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat} bestimmt wird.}% \entry{\PValue{twolinechapter}, \PValue{chapterprefix}, \PValue{chapterwithprefix}, \PValue{chapterwithprefixline}% \IndexOption{headings~=\textKValue{twolinechapter}}}{% - Kapitelüberschriften werden mit einer Vorsatzzeile gesetzt, deren Inhalt + Kapitelüberschriften werden mit einer Vorsatzzeile gesetzt, deren Inhalt von \DescRef{\LabelBase.cmd.chapterformat}\IndexCmd{chapterformat} bestimmt wird.}% \end{desclist} @@ -1737,64 +1739,64 @@ der Gliederungsbefehle enthalten. \OptionVName{numbers}{Einstellung} \end{Declaration}% Nach {\small DUDEN} steht in Gliederungen\Index{Gliederung}, in denen -ausschließlich arabische Ziffern für die Nummerierung\Index{Nummerierung} -verwendet werden, am Ende der Gliederungsnummern kein abschließender Punkt +ausschließlich arabische Ziffern für die Nummerierung\Index{Nummerierung} +verwendet werden, am Ende der Gliederungsnummern kein abschließender Punkt (siehe \cite[R\,3]{DUDEN}). Wird hingegen innerhalb der Gliederung auch mit -römischen Zahlen oder Groß- oder Kleinbuchstaben gearbeitet, so steht am Ende -aller Gliederungsnummern ein abschließender Punkt (siehe +römischen Zahlen oder Groß- oder Kleinbuchstaben gearbeitet, so steht am Ende +aller Gliederungsnummern ein abschließender Punkt (siehe \cite[R\,4]{DUDEN}). In {\KOMAScript} ist ein Automatismus eingebaut, der -diese etwas komplexe Regel zu erfüllen versucht. Der Automatismus wirkt sich +diese etwas komplexe Regel zu erfüllen versucht. Der Automatismus wirkt sich so aus, dass normalerweise bei Verwendung des Gliederungsbefehls \DescRef{\LabelBase.cmd.part} -oder eines Anhangs (\DescRef{\LabelBase.cmd.appendix}) auf Gliederungsnummer mit abschließendem +oder eines Anhangs (\DescRef{\LabelBase.cmd.appendix}) auf Gliederungsnummer mit abschließendem Punkt umgeschaltet wird. Diese Information wird in der \File{aux}-Datei -gespeichert und wirkt sich dann beim nächsten \LaTeX-Lauf auf das gesamte +gespeichert und wirkt sich dann beim nächsten \LaTeX-Lauf auf das gesamte Dokument aus. Manchmal versagt der mit \OptionValue{numbers}{autoendperiod}% \IndexOption{numbers~=\textKValue{autoendperiod}} voreingestellte Automatismus zum -Setzen oder Weglassen des abschließenden Punktes in der +Setzen oder Weglassen des abschließenden Punktes in der Gliederungsnummer. Teilweise sehen andere Sprachen auch andere Regeln vor. Deshalb ist es beispielsweise mit der Einstellung \OptionValue{numbers}{endperiod}\IndexOption{numbers~=\textKValue{endperiod}}% \important{\OptionValue{numbers}{endperiod}\\ - \OptionValue{numbers}{noendperiod}} möglich, den Punkt manuell + \OptionValue{numbers}{noendperiod}} möglich, den Punkt manuell vorzuschreiben oder mit \OptionValue{numbers}{noendperiod} zu verbieten. -Es ist zu beachten\textnote{Achtung!}, dass der Automatismus immer erst für -den nächsten \LaTeX-Lauf die Verwendung des abschließenden Punktes ein- oder -ausschaltet. Bevor also versucht wird, die korrekte Darstellung über -Verwendung einer der Optionen zu erzwingen, sollte grundsätzlich ein weiterer -\LaTeX-Lauf ohne Dokumentänderung durchgeführt werden. +Es ist zu beachten\textnote{Achtung!}, dass der Automatismus immer erst für +den nächsten \LaTeX-Lauf die Verwendung des abschließenden Punktes ein- oder +ausschaltet. Bevor also versucht wird, die korrekte Darstellung über +Verwendung einer der Optionen zu erzwingen, sollte grundsätzlich ein weiterer +\LaTeX-Lauf ohne Dokumentänderung durchgeführt werden. -Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von +Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von \PName{numbers} bietet \autoref{tab:maincls.numbers}. Im Unterschied zu den -meisten anderen Einstellungen, kann diese Option nur in der Dokumentpräambel, +meisten anderen Einstellungen, kann diese Option nur in der Dokumentpräambel, also vor \Macro{begin}\PParameter{document} vorgenommen werden. \begin{table} - \caption[{Mögliche Werte für Option \Option{numbers}}]{Mögliche Werte für + \caption[{Mögliche Werte für Option \Option{numbers}}]{Mögliche Werte für Option \Option{numbers} zur Konfigurierung des Abschlusspunktes in Gliederungsnummern} \label{tab:maincls.numbers} \begin{desctabular} \entry{\PValue{autoendperiod}, \PValue{autoenddot}, \PValue{auto}}{% \KOMAScript{} trifft die Entscheidung, ob am Ende von Gliederungsnummern - und allen von Gliederungsnummern abhängigen Nummern ein Punkt gesetzt - wird, selbst. Kommen in sämtlichen Gliederungsnummern nur arabische + und allen von Gliederungsnummern abhängigen Nummern ein Punkt gesetzt + wird, selbst. Kommen in sämtlichen Gliederungsnummern nur arabische Ziffern vor, so wird kein Punkt gesetzt. Wird in einer Gliederungsnummer - ein Buchstabe oder eine römische Zahl entdeckt, so wird der Punkt bei + ein Buchstabe oder eine römische Zahl entdeckt, so wird der Punkt bei allen Nummern gesetzt. Referenzen auf diese Nummern werden jedoch ohne - abschließenden Punkt gesetzt.% + abschließenden Punkt gesetzt.% \IndexOption{numbers~=\textKValue{autoendperiod}}}% \entry{\PValue{endperiod}, \PValue{withendperiod}, \PValue{periodatend}, \PValue{enddot}, \PValue{withenddot}, \PValue{dotatend}}{% - Bei sämtlichen Gliederungsnummern und davon abhängigen Nummern wird am - Ende ein Punkt gesetzt, der bei der Referenzierung entfällt.% + Bei sämtlichen Gliederungsnummern und davon abhängigen Nummern wird am + Ende ein Punkt gesetzt, der bei der Referenzierung entfällt.% \IndexOption{numbers~=\textKValue{endperiod}}}% \entry{\PValue{noendperiod}, \PValue{noperiodatend}, \PValue{noenddot}, \PValue{nodotatend}}{% - Gliederungsnummern und davon abhängige Nummern werden ohne - abschließenden Punkt gesetzt.% + Gliederungsnummern und davon abhängige Nummern werden ohne + abschließenden Punkt gesetzt.% \IndexOption{numbers~=\textKValue{noendperiod}}}% \end{desctabular} \end{table} @@ -1808,19 +1810,19 @@ also vor \Macro{begin}\PParameter{document} vorgenommen werden. \end{Declaration}% Wie\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} auch bei der Option \DescRef{\LabelBase.option.listof} in \autoref{sec:\LabelBase.floats}, -\DescPageRef{\LabelBase.option.listof} erwähnt wird, fügt +\DescPageRef{\LabelBase.option.listof} erwähnt wird, fügt normalerweise\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} jeder mit \DescRef{\LabelBase.cmd.chapter} erzeugte Kapiteleintrag einen vertikalen Abstand in die Verzeichnisse der Gleitumgebungen ein. Seit Version~2.96a\important{\OptionValueRef{\LabelBase}{version}{2.96a}} gilt dies -auch für die Anweisung \DescRef{\LabelBase.cmd.addchap}, wenn nicht eine -Kompatibilitätseinstellung zu einer früheren Version gewählt wurde (siehe +auch für die Anweisung \DescRef{\LabelBase.cmd.addchap}, wenn nicht eine +Kompatibilitätseinstellung zu einer früheren Version gewählt wurde (siehe Option \DescRef{\LabelBase.option.version} in \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}). -Außerdem kann mit der Option \Option{chapteratlists} der Abstand verändert -werden. Dazu gibt man als \PName{Wert} den gewünschten Abstand an. Bei der +Außerdem kann mit der Option \Option{chapteratlists} der Abstand verändert +werden. Dazu gibt man als \PName{Wert} den gewünschten Abstand an. Bei der Voreinstellung \OptionValueRef{\LabelBase}{listof}{chaptergapsmall}% \IndexOption{listof~=\textKValue{chaptergapsmall}} (siehe \DescPageRef{\LabelBase.option.listof.chaptergapsmall}) sind dies @@ -1832,32 +1834,32 @@ Mit der Einstellung \OptionValue{chapteratlists}{entry}% \Option{chapteratlists} ohne Angabe eines Wertes wird statt des Abstandes der Kapiteleintrag selbst in die Verzeichnisse eingetragen. Es wird darauf hingewiesen, dass ein solcher Eintrag auch dann erfolgt, wenn das Kapitel -keine Gleitumgebung enthält. Eine Lösung, bei der nur Kapitel mit +keine Gleitumgebung enthält. Eine Lösung, bei der nur Kapitel mit Gleitumgebungen im jeweiligen Verzeichnis angezeigt werden, finden Sie unter \cite{https://komascript.de/comment/5070}. -Es ist zu beachten\textnote{Achtung!}, dass sich eine Änderung der -Einstellung je nach Art der Änderung erst nach zwei weiteren \LaTeX-Läufen im +Es ist zu beachten\textnote{Achtung!}, dass sich eine Änderung der +Einstellung je nach Art der Änderung erst nach zwei weiteren \LaTeX-Läufen im Verzeichnis auswirkt.% % \EndIndexGroup \begin{Declaration} - \Macro{part}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{chapter}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{section}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{subsection}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{subsubsection}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{paragraph}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{subparagraph}\OParameter{Kurzform}\Parameter{Überschrift} + \Macro{part}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{chapter}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{section}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{subsection}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{subsubsection}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{paragraph}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{subparagraph}\OParameter{Kurzform}\Parameter{Ãœberschrift} \end{Declaration}% \Index[indexmain]{Teil}% \Index[indexmain]{Kapitel}% \Index[indexmain]{Abschnitt}% Die Standardgliederungsbefehle funktionieren bei {\KOMAScript} im Grundsatz -wie bei den Standardklassen. So kann in der Voreinstellung ganz normal über -ein optionales Argument ein abweichender Text für den Kolumnentitel und das +wie bei den Standardklassen. So kann in der Voreinstellung ganz normal über +ein optionales Argument ein abweichender Text für den Kolumnentitel und das Inhaltsverzeichnis vorgegeben werden. Mit\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and @@ -1865,158 +1867,173 @@ Mit\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and Einstellung\important{\DescRef{\LabelBase.option.headings}} \OptionValueRef{\LabelBase}{headings}{optiontohead}% \IndexOption[indexmain]{headings~=\textKValue{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 wird. Siehe hierzu +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 wird. Siehe hierzu \autoref{sec:\LabelBase.pagestyle} sowie \autoref{cha:scrlayer-scrpage}. Mit der Einstellung \OptionValueRef{\LabelBase}{headings}{optiontotoc}% \IndexOption[indexmain]{headings~=\textKValue{optiontotoc}} wird das optionale -Argument hingegen ausschließlich für den Eintrag ins Inhaltsverzeichnis -verwendet. Auch dies selbstverständlich nur, wenn die Einstellung für den -Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe +Argument hingegen ausschließlich für den Eintrag ins Inhaltsverzeichnis +verwendet. Auch dies selbstverständlich nur, wenn die Einstellung für den +Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe \autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.counter.tocdepth}) einen -Eintrag der entsprechenden Ebene überhaupt vorsieht. Mit der Einstellung +Eintrag der entsprechenden Ebene überhaupt vorsieht. Mit der Einstellung \OptionValueRef{\LabelBase}{headings}{optiontoheadandtoc}% \IndexOption[indexmain]{headings~=\textKValue{optiontoheadandtoc}} findet -schließlich das optionale Argument wieder sowohl für den Kolumnentitel als +schließlich das optionale Argument wieder sowohl für den Kolumnentitel als auch den Eintrag ins Inhaltsverzeichnis Verwendung. Allen drei Einstellungen ist gemeinsam, dass sie im Gegensatz zur Voreinstellung die erweiterte Interpretation des optionalen Arguments aktivieren. Bei\ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} der erweiterten Interpretation des optionalen Arguments -wird geprüft, ob sich ein Gleichheitszeichen in \PName{Kurzform} befindet. Ist +wird geprüft, ob sich ein Gleichheitszeichen in \PName{Kurzform} befindet. Ist dies der Fall, so wird das optionale Argument der Gliederungsbefehle selbst statt als \PName{Kurzform} als \PName{Optionenliste} interpretiert. Dabei -werden die drei Optionen +werden die vier Optionen \OptionVName{head}{Kolumnentitel}\important{\Option{head}\\ \Option{tocentry}\\ - \Option{reference}}, \OptionVName{tocentry}{Inhaltsverzeichniseintrag} und -\OptionVName{reference}{Querverweistitel}% -\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -akzeptiert. Um ein Gleichheitszeichen oder ein Komma in einem der beiden Werte -dieser Optionen unterzubringen, muss dieses in zusätzliche geschweifte -Klammern gesetzt werden. + \Option{reference}\\ + \Option{nonumber}}, \OptionVName{tocentry}{Inhaltsverzeichniseintrag}, +\OptionVName{reference}{Querverweistitel}\ChangedAt{v3.22}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}} und +\OptionVName{nonumber}{Ein-Aus-Wert}\ChangedAt{v3.27}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}} akzeptiert. Um ein Gleichheitszeichen +oder ein Komma in einem der Werte der ersten drei Optionen unterzubringen, +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 +funktioniert, solange \KOMAScript{} die Kontrolle über die Gliederungsbefehle besitzt. Wird hingegen ein Paket verwendet, dass die Gliederungsbefehle oder -die internen \LaTeX-Kern-Anweisungen für Gliederungsbefehle umdefiniert, so -kann \KOMAScript{} diese erweiterte Funktionalität nicht mehr zur Verfügung -stellen. Dies gilt auch für die immer aktive Erweiterung, dass -leere\textnote{leere Inhalts\-verzeichnis\-einträge} -Inhaltsverzeichniseinträge nicht zu einem Eintrag ohne Text führen, sondern -gänzlich unterbleiben. Soll tatsächlich einmal ein leerer Eintrag ins +die internen \LaTeX-Kern-Anweisungen für Gliederungsbefehle umdefiniert, so +kann \KOMAScript{} diese erweiterte Funktionalität nicht mehr zur Verfügung +stellen. Dies gilt auch für die immer aktive Erweiterung, dass +leere\textnote{leere Inhalts\-verzeichnis\-einträge} +Inhaltsverzeichniseinträge nicht zu einem Eintrag ohne Text führen, sondern +gänzlich unterbleiben. Soll tatsächlich einmal ein leerer Eintrag ins Inhaltsverzeichnis erfolgen, so kann dies mit einem unsichtbaren Eintrag wie \lstinline|\mbox{}| erreicht werden. \begin{Example} Angenommen, Sie haben ein Dokument mit teilweise sehr langen - Kapitelüberschriften. Diese langen Kapitelüberschriften sollen auch im + Kapitelüberschriften. Diese langen Kapitelüberschriften sollen auch im Inhaltsverzeichnis ausgegeben werden. Die Kolumnentitel wollen Sie jedoch - auf einzeilige Kurztexte beschränken. Dazu stellen Sie mit + auf einzeilige Kurztexte beschränken. Dazu stellen Sie mit \begin{lstcode} \documentclass[headings=optiontohead]{scrbook} \end{lstcode} bereits beim Laden der Klasse ein, dass das optionale Argument der - Gliederungsbefehle nur für die Kolumnentitel verwendet werden soll. Im - Dokument nehmen Sie dann einen entsprechenden Eintrag über das optionale + Gliederungsbefehle nur für die Kolumnentitel verwendet werden soll. Im + Dokument nehmen Sie dann einen entsprechenden Eintrag über das optionale Argument von \Macro{chapter} vor. \begin{lstcode} - \chapter[Kurzformen für Kapitel] - {Der Gliederungsbefehl für - Kapitelüberschriften erlaubt neben dem - Text für die eigentliche - Kapitelüberschrift auch eine Kurzform + \chapter[Kurzformen für Kapitel] + {Der Gliederungsbefehl für + Kapitelüberschriften erlaubt neben dem + Text für die eigentliche + Kapitelüberschrift auch eine Kurzform mit steuerbarer Verwendung} \end{lstcode} - Etwas später wird Ihnen bewusst, dass diese lange Überschrift sehr ungünstig - umbrochen wird. Sie wollen deshalb die Umbrüche für diese Überschrift selbst + Etwas später wird Ihnen bewusst, dass diese lange Ãœberschrift sehr ungünstig + umbrochen wird. Sie wollen deshalb die Umbrüche für diese Ãœberschrift selbst bestimmen. Im Inhaltsverzeichnis soll allerdings weiterhin automatisch umbrochen werden. Mit \begin{lstcode} - \chapter[head={Kurzformen für Kapitel}, - tocentry={Der Gliederungsbefehl für - Kapitelüberschriften erlaubt neben - dem Text für die eigentliche - Kapitelüberschrift auch eine Kurzform + \chapter[head={Kurzformen für Kapitel}, + tocentry={Der Gliederungsbefehl für + Kapitelüberschriften erlaubt neben + dem Text für die eigentliche + Kapitelüberschrift auch eine Kurzform mit steuerbarer Verwendung}] - {Der Gliederungsbefehl für - Kapitelüberschriften\\ + {Der Gliederungsbefehl für + Kapitelüberschriften\\ erlaubt neben dem\\ - Text für die eigentliche - Kapitelüberschrift\\ + Text für die eigentliche + Kapitelüberschrift\\ auch eine Kurzform\\ mit steuerbarer Verwendung} \end{lstcode} - setzen Sie daher die Einträge für den Kolumnentitel und das - Inhaltsverzeichnis unabhängig voneinander und von der Überschrift selbst. + setzen Sie daher die Einträge für den Kolumnentitel und das + Inhaltsverzeichnis unabhängig voneinander und von der Ãœberschrift selbst. Die Argumente der beiden Optionen \Option{head} und \Option{tocentry} wurden dabei in geschweifte Klammern gesetzt, damit der Inhalt der Argumente beliebig sein kann. - Die Notwendigkeit der geschweiften Klammern im vorherigen Beispiel lässt + Die Notwendigkeit der geschweiften Klammern im vorherigen Beispiel lässt sich am besten an einem weiteren Beispiel verdeutlichen. Angenommen, Sie - haben als Option \OptionValueRef{\LabelBase}{headings}{optiontotoc} gewählt - und setzen nun die Überschrift: + haben als Option \OptionValueRef{\LabelBase}{headings}{optiontotoc} gewählt + und setzen nun die Ãœberschrift: \begin{lstcode} \section[head=\emph{Wert}] {Die Option head=\emph{Wert}} \end{lstcode} - Dies führt dazu, dass im Inhaltsverzeichnis der Eintrag »Die Option - head=\emph{Wert}« und im Kolumnentitel der Eintrag »\emph{Wert}« verwendet + Dies führt dazu, dass im Inhaltsverzeichnis der Eintrag »Die Option + head=\emph{Wert}« und im Kolumnentitel der Eintrag »\emph{Wert}« verwendet wird. In Wirklichkeit wollten Sie aber, dass im Inhaltsverzeichnis der - Eintrag »head=\emph{Wert}« lautet und im Kolumnentitel der Text der - Überschrift übernommen wird. Dies ist dadurch zu erreichen, dass das + Eintrag »head=\emph{Wert}« lautet und im Kolumnentitel der Text der + Ãœberschrift übernommen wird. Dies ist dadurch zu erreichen, dass das Gleichheitszeichen in geschweifte Klammern gesetzt wird: \begin{lstcode} \section[head{=}\emph{Wert}] {Die Option head=\emph{Wert}} \end{lstcode} - Ein ähnlicher Fall betrifft das Komma. Bei gleicher Voreinstellung der - Optionen würde + Ein ähnlicher Fall betrifft das Komma. Bei gleicher Voreinstellung der + Optionen würde \begin{lstcode} \section[head=0, 1, 2, 3, \dots] - {Die natürlichen Zahlen mit der Null} + {Die natürlichen Zahlen mit der Null} \end{lstcode} - zu einer Fehlermeldung führen, weil die Kommata als Trennzeichen zwischen - den einzelnen Optionen der Optionenliste »\lstinline|head=0, 1, 2, 3, \dots|« - interpretiert würden. Schreibt man hingegen + zu einer Fehlermeldung führen, weil die Kommata als Trennzeichen zwischen + den einzelnen Optionen der Optionenliste »\lstinline|head=0, 1, 2, 3, \dots|« + interpretiert würden. Schreibt man hingegen \begin{lstcode} \section[head={0, 1, 2, 3, \dots}] - {Die natürlichen Zahlen mit der Null} + {Die natürlichen Zahlen mit der Null} \end{lstcode} - so ist »\lstinline|0, 1, 2, 3, \dots|« das Argument der Option + so ist »\lstinline|0, 1, 2, 3, \dots|« das Argument der Option \Option{head}. \end{Example} So\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -wie im Beispiel Option \Option{head} den Titel für den lebenden Kolumnentitel -und Option \Option{tocentry} den Titel für den Verzeichniseintrag bestimmt, -kann mit \Option{reference}\important{\Option{reference}} der Titel für einen +wie im Beispiel Option \Option{head} den Titel für den lebenden Kolumnentitel +und Option \Option{tocentry} den Titel für den Verzeichniseintrag bestimmt, +kann mit \Option{reference}\important{\Option{reference}} der Titel für einen Querverweise durch die Pakete \Package{nameref}\IndexPackage{nameref}\important{\Package{nameref}\\ \Package{titleref}\\ \Package{zref-titleref}}, \Package{titleref}\IndexPackage{titleref} oder das \Package{titleref}\IndexPackage{zref-titleref}-Modul von \Package{zref}\IndexPackage{zref} explizit vorgegeben werden. Die -Unterstützung für \Package{titleref} ist dabei eher rudimentär, da das Paket -mit der Leistungsfähigkeit der anderen beiden nur schlecht mithalten kann und +Unterstützung für \Package{titleref} ist dabei eher rudimentär, da das Paket +mit der Leistungsfähigkeit der anderen beiden nur schlecht mithalten kann und auch nicht mit \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}} kompatibel ist. -Die\important{\Macro{part}} Überschrift der Teile-Ebene (\Macro{part}) +Darüber hinaus kann mit Hilfe der Option +\OptionValue{nonumber}{true}\important{\Option{nonumber}}% +\ChangedAt{v3.27}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}} im erweiterten optionalen Argument +die Nummerierung der Ãœberschrift deaktiviert werden. Im Gegensatz zu den +nachfolgend erklärten +\hyperref[desc:maincls.cmd.part*]{Sternvarianten der Gliederungsbefehle} wird +jedoch trotzdem ein Inhaltsverzeichniseintrag und gegebenenfalls ein +Kolumnentitel erzeugt. Für \Macro{part}, \Macro{chapter} und \Macro{section} +entspricht dies weitgehend den auf \DescPageRef{\LabelBase.cmd.addpart} +erklärten Anweisungen \DescRef{\LabelBase.cmd.addpart}, +\DescRef{\LabelBase.cmd.addchap} und \DescRef{\LabelBase.cmd.addsec}. + +Die\important{\Macro{part}} Ãœberschrift der Teile-Ebene (\Macro{part}) unterscheidet sich von den anderen Gliederungsebenen dadurch, dass sie -unabhängig von den übrigen Ebenen nummeriert wird. Das bedeutet, dass die +unabhängig von den übrigen Ebenen nummeriert wird. Das bedeutet, dass die Kapitel-Ebene (bei \Class{scrbook} oder \Class{scrreprt}) bzw. die -Abschnitt-Ebene (bei \Class{scrartcl}) über alle Teile hinweg durchgehend -nummeriert wird. Darüber hinaus steht bei den Klassen \Class{scrbook} und -\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} die Überschrift -dieser Ebene zusammen mit ihrer Präambel (siehe Anweisung +Abschnitt-Ebene (bei \Class{scrartcl}) über alle Teile hinweg durchgehend +nummeriert wird. Darüber hinaus steht bei den Klassen \Class{scrbook} und +\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} die Ãœberschrift +dieser Ebene zusammen mit ihrer Präambel (siehe Anweisung \DescRef{\LabelBase.cmd.setpartpreamble}, \DescPageRef{\LabelBase.cmd.setpartpreamble}) alleine auf einer Seite. @@ -2025,20 +2042,20 @@ dieser Ebene zusammen mit ihrer Präambel (siehe Anweisung \Class{book}, \Class{scrbook}, \Class{report} und \Class{scrreprt}, nicht jedoch bei den Artikelklassen \Class{article} und \Class{scrartcl}. \Macro{chapter}\textnote{\KOMAScript{} - vs. Standardklassen} unterscheidet sich bei {\KOMAScript} außerdem + vs. Standardklassen} unterscheidet sich bei {\KOMAScript} außerdem gravierend von der Version der Standardklassen. Bei den Standardklassen wird -die Kapitelnummer mit dem Präfix »Kapitel« beziehungsweise dem Kapitelnamen in -der gewählten Sprache in einer Zeile vor dem eigentlichen Text der Überschrift +die Kapitelnummer mit dem Präfix »Kapitel« beziehungsweise dem Kapitelnamen in +der gewählten Sprache in einer Zeile vor dem eigentlichen Text der Ãœberschrift ausgegeben. Diese\important{\DescRef{\LabelBase.option.chapterprefix}\\ - \DescRef{\LabelBase.option.appendixprefix}} sehr mächtige Form -wird bei {\KOMAScript} durch eine einfache Nummer vor dem Text abgelöst, lässt + \DescRef{\LabelBase.option.appendixprefix}} sehr mächtige Form +wird bei {\KOMAScript} durch eine einfache Nummer vor dem Text abgelöst, lässt sich aber durch die Optionen \DescRef{\LabelBase.option.chapterprefix} und \DescRef{\LabelBase.option.appendixprefix} einstellen (siehe \DescPageRef{\LabelBase.option.chapterprefix}). Bitte beachten\textnote{Achtung!} Sie, dass \Macro{part} und \Macro{chapter} bei \Class{scrbook} und \Class{scrreprt}\OnlyAt{\Class{scrbook}\and - \Class{scrreprt}} den Seitenstil für eine Seite umschalten. Der jeweilige + \Class{scrreprt}} den Seitenstil für eine Seite umschalten. Der jeweilige Seitenstil ist bei \KOMAScript{} in den Makros \DescRef{\LabelBase.cmd.partpagestyle} und \DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe @@ -2046,7 +2063,7 @@ Seitenstil ist bei \KOMAScript{} in den Makros \BeginIndexGroup \BeginIndex[indexother]{}{Schrift>Art}% -\BeginIndex[indexother]{}{Schrift>Groesse=Größe}% +\BeginIndex[indexother]{}{Schrift>Groesse=Größe}% \BeginIndex{FontElement}{disposition}\LabelFontElement{disposition}% \BeginIndex{FontElement}{part}\LabelFontElement{part}% \BeginIndex{FontElement}{parnumber}\LabelFontElement{partnumber}% @@ -2063,9 +2080,9 @@ sieben Gliederungsebenen kann mit den Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -bestimmt werden. Dabei wird zunächst generell das Element +bestimmt werden. Dabei wird zunächst generell das Element \FontElement{disposition}\important{\FontElement{disposition}} und -anschließend zusätzlich je Gliederungsebene ein spezifisches +anschließend zusätzlich je Gliederungsebene ein spezifisches Element\important{% \FontElement{part}\\ \FontElement{partnumber}\\ @@ -2076,16 +2093,16 @@ Element\important{% \FontElement{paragraph}\\ \FontElement{subparagraph}} verwendet (siehe \autoref{tab:maincls.fontelements}, -\autopageref{tab:maincls.fontelements}). Für den Nummernteil der -Teile-Überschrift wird zusätzlich das Element \FontElement{partnumber} -verwendet, für die optionale Präfixzeile der Kapitelüberschriften das Element -\FontElement{chapterprefix}. Die Schriftart für das Element +\autopageref{tab:maincls.fontelements}). Für den Nummernteil der +Teile-Ãœberschrift wird zusätzlich das Element \FontElement{partnumber} +verwendet, für die optionale Präfixzeile der Kapitelüberschriften das Element +\FontElement{chapterprefix}. Die Schriftart für das Element \FontElement{disposition} ist als \Macro{normalcolor}""\Macro{sffamily}""\Macro{bfseries} vordefiniert. Die -Voreinstellungen für die spezifischen Elemente sind mit einer Schriftgröße +Voreinstellungen für die spezifischen Elemente sind mit einer Schriftgröße vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und -\PValue{small} für die Option -\DescRef{\LabelBase.option.headings}\IndexOption{headings} abhängig (siehe +\PValue{small} für die Option +\DescRef{\LabelBase.option.headings}\IndexOption{headings} abhängig (siehe \DescPageRef{\LabelBase.option.headings}). Sie finden die Voreinstellungen in \autoref{tab:maincls.structureElementsFont}. % Umbruchkorrektur: Tabelle verschoben @@ -2094,11 +2111,11 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und % \caption \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% - \begin{captionbeside}[{Schriftvoreinstellungen für die Elemente der Gliederung + \begin{captionbeside}[{Schriftvoreinstellungen für die Elemente der Gliederung bei\newline \Class{scrbook} und \Class{scrreprt}}]{% \label{tab:maincls.structureElementsFont}% \hspace{0pt plus .5em}Voreinstellungen der Schrift - für die Elemente der Gliederung bei \Class{scrbook} und \Class{scrreprt}} + für die Elemente der Gliederung bei \Class{scrbook} und \Class{scrreprt}} [l] \begin{tabular}[t]{lll} \toprule @@ -2152,23 +2169,24 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und % \begin{Example} Angenommen, Sie stellen bei Verwendung der Klassenoption - \OptionValueRef{\LabelBase}{headings}{big} fest, dass die sehr großen - Überschriften von Teildokumenten (\Macro{part} oder \DescRef{\LabelBase.cmd.addpart}) zu fett - wirken. Nun könnten Sie natürlich wie folgt % + \OptionValueRef{\LabelBase}{headings}{big} fest, dass die sehr großen + Ãœberschriften von Teildokumenten (\Macro{part} oder + \DescRef{\LabelBase.cmd.addpart}) zu fett wirken. Nun könnten Sie natürlich + wie folgt % \iftrue % Umbruchoptimierung!!!! verfahren:% \else % - für Abhilfe sorgen:% + für Abhilfe sorgen:% \fi \begin{lstcode} \setkomafont{disposition}{\normalcolor\sffamily} \part{\appendixname} \addtokomafont{disposition}{\bfseries} \end{lstcode} - Auf diese Weise würden Sie nur für die eine Überschrift »Anhang« + Auf diese Weise würden Sie nur für die eine Ãœberschrift »Anhang« das Schriftattribut \textbf{Fett} abschalten. Sehr viel komfortabler - und eleganter ist es aber, stattdessen generell für - \Macro{part}-Überschriften eine entsprechende Änderung vorzunehmen. + und eleganter ist es aber, stattdessen generell für + \Macro{part}-Ãœberschriften eine entsprechende Änderung vorzunehmen. Das ist wahlweise mit: \begin{lstcode} \addtokomafont{part}{\normalfont\sffamily} @@ -2179,54 +2197,54 @@ vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und \addtokomafont{part}{\mdseries} \addtokomafont{partnumber}{\mdseries} \end{lstcode} - möglich. Die Verwendung von \DescRef{\LabelBase.cmd.setkomafont} wäre zwar grundsätzlich - möglich, müsste aber auch die Auswahl der Schriftgröße enthalten und würde - damit die Größenänderung über die Option \DescRef{\LabelBase.option.headings} verhindern. + möglich. Die Verwendung von \DescRef{\LabelBase.cmd.setkomafont} wäre zwar grundsätzlich + möglich, müsste aber auch die Auswahl der Schriftgröße enthalten und würde + damit die Größenänderung über die Option \DescRef{\LabelBase.option.headings} verhindern. Die zweite Version mit \Macro{mdseries} ist vorzuziehen, da diese auch dann - noch zum gewünschten Ergebnis führt, wenn Sie später das Element - \FontElement{disposition}\IndexFontElement{disposition} wie folgt ändern: + noch zum gewünschten Ergebnis führt, wenn Sie später das Element + \FontElement{disposition}\IndexFontElement{disposition} wie folgt ändern: \begin{lstcode} \setkomafont{disposition}{\normalcolor\bfseries} \end{lstcode} - Mit dieser Änderung verzichten Sie darauf, für alle + Mit dieser Änderung verzichten Sie darauf, für alle Gliederungsebenen serifenlose Schrift voreinzustellen. \end{Example} -Ich möchte eindringlich davon abraten, die Möglichkeit zur -Schriftumschaltung zu missbrauchen, um wild Schriften, Schriftgrößen und -Schriftattribute miteinander zu mischen. Die Auswahl der richtigen Schrift für -die richtige Aufgabe ist eine Sache für Experten und hat sehr, sehr wenig mit -dem persönlichem Geschmack eines Laien zu tun. Siehe hierzu auch das Zitat am +Ich möchte eindringlich davon abraten, die Möglichkeit zur +Schriftumschaltung zu missbrauchen, um wild Schriften, Schriftgrößen und +Schriftattribute miteinander zu mischen. Die Auswahl der richtigen Schrift für +die richtige Aufgabe ist eine Sache für Experten und hat sehr, sehr wenig mit +dem persönlichem Geschmack eines Laien zu tun. Siehe hierzu auch das Zitat am Ende von \autoref{sec:typearea.tips}, \autopageref{sec:typearea.tips.cite} und -die folgende Erklärung. +die folgende Erklärung. \begin{Explain} - Unterschiedliche Schriften für unterschiedliche Gliederungsebenen sind mit - {\KOMAScript}-Mitteln möglich. Der Laie sollte sie aber meiden wie der - Teufel das Weihwasser. Dies hat typografische Gründe. - - Eine Regel der Typografie besagt, dass man möglichst wenig Schriften - miteinander mischen soll. Serifenlose für die Überschriften scheinen bereits - ein Verstoß gegen diese Regel zu sein. Allerdings muss man wissen, dass - fette, große, serifenbehaftete Buchstaben oft viel zu mächtig für eine - Überschrift sind. Man müsste dann strenggenommen zumindest auf eine normale + Unterschiedliche Schriften für unterschiedliche Gliederungsebenen sind mit + {\KOMAScript}-Mitteln möglich. Der Laie sollte sie aber meiden wie der + Teufel das Weihwasser. Dies hat typografische Gründe. + + Eine Regel der Typografie besagt, dass man möglichst wenig Schriften + miteinander mischen soll. Serifenlose für die Ãœberschriften scheinen bereits + ein Verstoß gegen diese Regel zu sein. Allerdings muss man wissen, dass + fette, große, serifenbehaftete Buchstaben oft viel zu mächtig für eine + Ãœberschrift sind. Man müsste dann strenggenommen zumindest auf eine normale statt eine fette oder halbfette Schrift ausweichen. In tiefen Gliederungsebenen kann das aber wieder zu schwach sein. Andererseits haben - Serifenlose in Überschriften eine sehr angenehme Wirkung und fast nur für - Überschriften eine Berechtigung. Daher wurde diese Voreinstellung für - {\KOMAScript} mit gutem Grund gewählt. + Serifenlose in Ãœberschriften eine sehr angenehme Wirkung und fast nur für + Ãœberschriften eine Berechtigung. Daher wurde diese Voreinstellung für + {\KOMAScript} mit gutem Grund gewählt. - Größere Vielfalt sollte aber vermieden werden. Schriftenmischung ist etwas - für Profis. Aus den genannten Gründen sollten Sie bei Verwendung anderer als + Größere Vielfalt sollte aber vermieden werden. Schriftenmischung ist etwas + für Profis. Aus den genannten Gründen sollten Sie bei Verwendung anderer als der Standard-\TeX-Fonts -- egal ob CM"~\Index{CM-Fonts}, - EC"~\Index{EC-Fonts} oder LM-Fonts\Index{LM-Fonts} -- bezüglich der - Verträglichkeit der serifenlosen und serifenbehafteten Schrift einen - Experten zu Rate ziehen oder die Schrift für das Element + EC"~\Index{EC-Fonts} oder LM-Fonts\Index{LM-Fonts} -- bezüglich der + Verträglichkeit der serifenlosen und serifenbehafteten Schrift einen + Experten zu Rate ziehen oder die Schrift für das Element \FontElement{disposition}\IndexFontElement{disposition} vorsichtshalber wie - in obigem Beispiel umdefinieren. Die häufig anzutreffenden Kombinationen + in obigem Beispiel umdefinieren. Die häufig anzutreffenden Kombinationen Times mit Helvetica oder Palatino mit Helvetica werden vom Autor als - ungünstig betrachtet. + ungünstig betrachtet. \end{Explain} \EndIndexGroup % @@ -2234,29 +2252,29 @@ die folgende Erklärung. \begin{Declaration} - \Macro{part*}\Parameter{Überschrift} - \Macro{chapter*}\Parameter{Überschrift} - \Macro{section*}\Parameter{Überschrift} - \Macro{subsection*}\Parameter{Überschrift} - \Macro{subsubsection*}\Parameter{Überschrift} - \Macro{paragraph*}\Parameter{Überschrift} - \Macro{subparagraph*}\Parameter{Überschrift} + \Macro{part*}\Parameter{Ãœberschrift} + \Macro{chapter*}\Parameter{Ãœberschrift} + \Macro{section*}\Parameter{Ãœberschrift} + \Macro{subsection*}\Parameter{Ãœberschrift} + \Macro{subsubsection*}\Parameter{Ãœberschrift} + \Macro{paragraph*}\Parameter{Ãœberschrift} + \Macro{subparagraph*}\Parameter{Ãœberschrift} \end{Declaration}% Bei den Sternvarianten der Gliederungsbefehle erfolgt keine Nummerierung\Index{Nummerierung}, wird kein Kolumnentitel\Index{Kolumnentitel>automatisch} gesetzt und kein Eintrag im Inhaltsverzeichnis\Index{Inhaltsverzeichnis} vorgenommen. Der Verzicht auf -den Kolumnentitel hat übrigens einen oftmals unerwünschten Effekt. Geht -beispielsweise ein mit \Macro{chapter*} gesetztes Kapitel über mehrere Seiten, -so taucht plötzlich der Kolumnentitel des letzten Kapitels wieder auf. -{\KOMAScript} bietet dafür aber eine Lösung, die im Anschluss beschrieben +den Kolumnentitel hat übrigens einen oftmals unerwünschten Effekt. Geht +beispielsweise ein mit \Macro{chapter*} gesetztes Kapitel über mehrere Seiten, +so taucht plötzlich der Kolumnentitel des letzten Kapitels wieder auf. +{\KOMAScript} bietet dafür aber eine Lösung, die im Anschluss beschrieben wird. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}\Macro{chapter*} existiert -selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{book}, +selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{book}, \Class{scrbook}, \Class{report} und \Class{scrreprt}, nicht jedoch bei den Artikelklassen \Class{article} und \Class{scrartcl}. Bitte\textnote{Achtung!} beachten Sie, dass \Macro{part*} und \Macro{chapter*} -den Seitenstil für eine Seite umschalten. Während die +den Seitenstil für eine Seite umschalten. Während die Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} dabei den Seitenstil \PageStyle{plain} verwenden, ist bei \KOMAScript{} der zu verwendende Seitenstil in den Makros \DescRef{\LabelBase.cmd.partpagestyle} @@ -2264,9 +2282,9 @@ und \DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe \autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.cmd.titlepagestyle}). -Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% +Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} % -gilt das Gleiche, wie zuvor in der Erklärung zu den sternlosen +gilt das Gleiche, wie zuvor in der Erklärung zu den sternlosen Varianten geschrieben. Die Elemente tragen die gleichen Namen, da sie nicht Varianten, sondern Gliederungsebenen bezeichnen.% % @@ -2283,38 +2301,41 @@ bei denen ein automatischer Kolumnentitel erzeugt wird. \begin{Declaration} - \Macro{addpart}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{addpart*}\Parameter{Überschrift} - \Macro{addchap}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{addchap*}\Parameter{Überschrift} - \Macro{addsec}\OParameter{Kurzform}\Parameter{Überschrift} - \Macro{addsec*}\Parameter{Überschrift} + \Macro{addpart}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{addpart*}\Parameter{Ãœberschrift} + \Macro{addchap}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{addchap*}\Parameter{Ãœberschrift} + \Macro{addsec}\OParameter{Kurzform}\Parameter{Ãœberschrift} + \Macro{addsec*}\Parameter{Ãœberschrift} \textnote[n]{\KOMAScript{} vs. Standardklassen} \end{Declaration}% -{\KOMAScript} bietet über die Gliederungsbefehle der Standardklassen hinaus +{\KOMAScript} bietet über die Gliederungsbefehle der Standardklassen hinaus die Anweisungen \Macro{addpart}, \Macro{addchap} und \Macro{addsec}. Diese -ähneln bis auf die fehlende Nummerierung sehr den Standardanweisungen +ähneln bis auf die fehlende Nummerierung sehr den Standardanweisungen \DescRef{\LabelBase.cmd.part}\IndexCmd{part}% \important{\DescRef{\LabelBase.cmd.part}, \DescRef{\LabelBase.cmd.chapter}, \DescRef{\LabelBase.cmd.section}}, \DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} und -\DescRef{\LabelBase.cmd.section}\IndexCmd{section}. Sie erzeugen sowohl -einen automatischen Kolumnentitel als auch einen Eintrag im -Inhaltsverzeichnis, wobei auch die Einstellungen von Option -\DescRef{\LabelBase.option.headings}% -\important{\DescRef{\LabelBase.option.headings}} beachtet werden, -insbesondere auch die entsprechende Erweiterung des optionalen Arguments -verfügbar ist. +\DescRef{\LabelBase.cmd.section}\IndexCmd{section}. Sie erzeugen sowohl einen +automatischen Kolumnentitel als auch einen Eintrag im Inhaltsverzeichnis, +wobei auch die Einstellungen von Option \DescRef{\LabelBase.option.headings}% +\important{\DescRef{\LabelBase.option.headings}} beachtet werden, insbesondere +auch die entsprechende Erweiterung des optionalen Arguments verfügbar ist. Das +Aktivieren oder Deaktivieren des in der Erklärung zu +\DescRef{\LabelBase.cmd.part}, +\DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} und +\DescRef{\LabelBase.cmd.section}\IndexCmd{section} dokumentierten Schalters +\Option{nonumber} bleibt dabei jedoch wirkungslos. Die Sternvarianten \Macro{addchap*} und \Macro{addsec*} gleichen hingegen den Standardanweisungen \DescRef{\LabelBase.cmd.chapter*} und \DescRef{\LabelBase.cmd.section*} mit einem winzigen, aber wichtigen -Unterschied: Die Kolumnentitel werden gelöscht. Dadurch wird der oben erwähnte +Unterschied: Die Kolumnentitel werden gelöscht. Dadurch wird der oben erwähnte Effekt veralteter Kolumnentitel ausgeschlossen. Stattdessen bleibt der Kolumnentitel auf Folgeseiten leer. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}\Macro{addchap} und \Macro{addchap*} existieren \iffree{% - selbstverständlich nur bei Buch- und Berichtklassen, also bei + selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{scrbook} und \Class{scrreprt}, nicht jedoch bei der Artikelklasse \Class{scrartcl}.% }{% @@ -2325,13 +2346,13 @@ Kolumnentitel auf Folgeseiten leer. \OnlyAt{\Class{scrbook}\and Die Anweisung \Macro{addpart} erstellt entsprechend einen nicht nummerierten Dokumentteil mit einem Eintrag im Inhaltsverzeichnis. Da bereits \DescRef{\LabelBase.cmd.part} und \DescRef{\LabelBase.cmd.part*} den -Kolumnentitel löschen, ergibt sich hier nicht das oben genannte Problem mit +Kolumnentitel löschen, ergibt sich hier nicht das oben genannte Problem mit veralteten Kolumnentiteln. Die Sternvariante \Macro{addpart*} ist daher identisch mit der Sternvariante \DescRef{\LabelBase.cmd.part*} und wurde nur -aus Konsistenzgründen definiert. +aus Konsistenzgründen definiert. Bitte\textnote{Achtung!} beachten Sie, dass \Macro{addpart} und -\Macro{addchap} und deren Sternvarianten den Seitenstil für eine Seite +\Macro{addchap} und deren Sternvarianten den Seitenstil für eine Seite umschalten. Der jeweilige Seitenstil ist in den Makros \DescRef{\LabelBase.cmd.partpagestyle} und \DescRef{\LabelBase.cmd.chapterpagestyle} abgelegt (siehe @@ -2339,9 +2360,9 @@ umschalten. Der jeweilige Seitenstil ist in den Makros \DescPageRef{\LabelBase.cmd.titlepagestyle}). \iffree{\iffalse}{\csname iftrue\endcsname}% Umbruchkorrekturbeispiel \begin{Example} - Sie schreiben ein Buch mit einem ausladenden Nachwort über mehrere + Sie schreiben ein Buch mit einem ausladenden Nachwort über mehrere Seiten. Dieses soll weder einen Kolumnentitel noch einen Eintrag ins - Inhaltsverzeichnis erhalten. Daher verwenden Sie zunächst + Inhaltsverzeichnis erhalten. Daher verwenden Sie zunächst \DescRef{\LabelBase.cmd.chapter*}: \begin{lstcode} \documentclass{scrbook} @@ -2356,7 +2377,7 @@ umschalten. Der jeweilige Seitenstil ist in den Makros \end{lstcode} Allerdings entdecken Sie, dass auf der zweiten und dritten Seite des Nachworts der Kolumnentitel des vorherigen Kapitels wieder auftaucht. Das - wollen Sie natürlich nicht. Deshalb verwenden Sie nun \Macro{addchap*}: + wollen Sie natürlich nicht. Deshalb verwenden Sie nun \Macro{addchap*}: \begin{lstcode} \documentclass{scrbook} \usepackage[ngerman]{babel} @@ -2368,9 +2389,9 @@ umschalten. Der jeweilige Seitenstil ist in den Makros \Blindtext[10] \end{document} \end{lstcode} - Wunschgemäß ist das komplette Nachwort nun ohne Kolumnentitel. Doch auch das - entspricht nicht ganz Ihren Vorstellungen. Ein Kolumnentitel wäre doch - schön. Mit + Wunschgemäß ist das komplette Nachwort nun ohne Kolumnentitel. Doch auch das + entspricht nicht ganz Ihren Vorstellungen. Ein Kolumnentitel wäre doch + schön. Mit \begin{lstcode} \documentclass{scrbook} \usepackage[ngerman]{babel} @@ -2382,13 +2403,13 @@ umschalten. Der jeweilige Seitenstil ist in den Makros \Blindtext[10] \end{document} \end{lstcode} - erhalten Sie nun sowohl »Nachwort« als Kolumnentitel der geraden Seiten, als - auch einen Inhaltsverzeichniseintrag. Genau an diesem Eintrag stört sich + erhalten Sie nun sowohl »Nachwort« als Kolumnentitel der geraden Seiten, als + auch einen Inhaltsverzeichniseintrag. Genau an diesem Eintrag stört sich dann aber der Verlag. Er besteht darauf, dass das Nachwort keinen Eintrag ins Inhaltsverzeichnis zu erhalten hat. Auch wenn Ihnen das seltsam erscheint, wollen Sie den Verlag zufriedenstellen. Also aktivieren Sie mit - \OptionValueRef{\LabelBase}{headings}{optiontotocandhead} zunächst die - erweiterte Funktion für das optionale Argument und setzen dann für das + \OptionValueRef{\LabelBase}{headings}{optiontotocandhead} zunächst die + erweiterte Funktion für das optionale Argument und setzen dann für das Inhaltsverzeichnis explizit ein leeres Argument: \begin{lstcode} \documentclass[headings=optiontotocandhead] @@ -2402,15 +2423,15 @@ umschalten. Der jeweilige Seitenstil ist in den Makros \Blindtext[10] \end{document} \end{lstcode} - Der Kolumnentitel wird von \OptionValue{tocentry}{\{\}} nicht verändert. - Da \Class{scrbook} leere Einträge ins Inhaltsverzeichnis automatisch - unterdrückt, ist nun auch der Verlag zufriedengestellt. + Der Kolumnentitel wird von \OptionValue{tocentry}{\{\}} nicht verändert. + Da \Class{scrbook} leere Einträge ins Inhaltsverzeichnis automatisch + unterdrückt, ist nun auch der Verlag zufriedengestellt. \end{Example}% \fi -Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% +Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} % -gilt das Gleiche, wie zuvor in der Erklärung zu \DescRef{\LabelBase.cmd.part*}, +gilt das Gleiche, wie zuvor in der Erklärung zu \DescRef{\LabelBase.cmd.part*}, \DescRef{\LabelBase.cmd.chapter*} und \DescRef{\LabelBase.cmd.section*} geschrieben. Die Elemente tragen die gleichen Namen, da sie nicht Varianten, sondern Gliederungsebenen bezeichnen.% @@ -2419,42 +2440,42 @@ sondern Gliederungsebenen bezeichnen.% \begin{Declaration} - \Macro{minisec}\Parameter{Überschrift} + \Macro{minisec}\Parameter{Ãœberschrift} \end{Declaration}% -Manchmal ist eine Art Überschrift\Index{Ueberschriften=Überschriften} -wünschenswert, die zwar hervorgehoben wird, ansonsten aber eng mit dem -nachfolgenden Text zusammenhängt. Eine solche Überschrift soll dann ohne große -Abstände gesetzt werden. +Manchmal ist eine Art Ãœberschrift\Index{Ueberschriften=Ãœberschriften} +wünschenswert, die zwar hervorgehoben wird, ansonsten aber eng mit dem +nachfolgenden Text zusammenhängt. Eine solche Ãœberschrift soll dann ohne große +Abstände gesetzt werden. -Der Befehl \Macro{minisec} bewirkt genau eine derartige Überschrift. Diese -Überschrift ist keiner Gliederungsebene\textnote{ohne Gliederungsebene} +Der Befehl \Macro{minisec} bewirkt genau eine derartige Ãœberschrift. Diese +Ãœberschrift ist keiner Gliederungsebene\textnote{ohne Gliederungsebene} zugeordnet. Eine solche \emph{Mini-Section} wird nicht in das -Inhaltsverzeichnis aufgenommen und erhält auch keine Nummerierung. +Inhaltsverzeichnis aufgenommen und erhält auch keine Nummerierung. \BeginIndexGroup \BeginIndex{FontElement}{minisec}\LabelFontElement{minisec}% -Die Schriftart des Gliederungsbefehls \Macro{minisec} kann über die Elemente +Die Schriftart des Gliederungsbefehls \Macro{minisec} kann über die Elemente \DescRef{\LabelBase.fontelement.disposition}% \important{\DescRef{\LabelBase.fontelement.disposition}\\ \FontElement{minisec}} und \FontElement{minisec}\ChangedAt{v2.96a}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} beeinflusst werden (siehe \autoref{tab:maincls.fontelements}, -\autopageref{tab:maincls.fontelements}). Die Voreinstellung für das Element +\autopageref{tab:maincls.fontelements}). Die Voreinstellung für das Element \FontElement{minisec} ist leer, so dass in der Voreinstellung nur das Element \DescRef{\LabelBase.fontelement.disposition} wirkt.% \EndIndexGroup \begin{Example} - Sie haben einen Bausatz für eine Mausefalle entwickelt und wollen - diesen getrennt nach den benötigten Materialien und der Anleitung für - die Montage beschreiben. Das könnte so gemacht werden: + Sie haben einen Bausatz für eine Mausefalle entwickelt und wollen + diesen getrennt nach den benötigten Materialien und der Anleitung für + die Montage beschreiben. Das könnte so gemacht werden: \begin{lstcode} \documentclass{scrartcl} \usepackage[ngerman]{babel} \usepackage{selinput} \SelectInputMappings{ - adieresis={ä}, - germandbls={ß} + adieresis={ä}, + germandbls={ß} } \begin{document} @@ -2465,8 +2486,8 @@ werden (siehe \autoref{tab:maincls.fontelements}, \maketitle \section{Mausefalle} - Das erste Projekt ist auch für Anfänger geeignet - und benötigt lediglich einige wenige Bauteile, + Das erste Projekt ist auch für Anfänger geeignet + und benötigt lediglich einige wenige Bauteile, die in jedem Haushalt zu finden sein sollten. \minisec{Bauteile} @@ -2475,7 +2496,7 @@ werden (siehe \autoref{tab:maincls.fontelements}, 1 Brett ($100\times 50 \times 12$)\\ 1 Bierflaschenschnappverschluss\\ 1 Kugelschreiberfeder\\ - 1 Reißzwecke\\ + 1 Reißzwecke\\ 2 Schrauben\\ 1 Hammer\\ 1 Messer @@ -2483,24 +2504,24 @@ werden (siehe \autoref{tab:maincls.fontelements}, \minisec{Montage} - Zunächst suche man das Mauseloch. Dann lege man - die Reißzwecke innen unmittelbar hinter das Loch, + Zunächst suche man das Mauseloch. Dann lege man + die Reißzwecke innen unmittelbar hinter das Loch, damit bei den folgenden Aktionen die Maus nicht - entschlüpfen kann. - Anschließend klopfe man mit dem Hammer den + entschlüpfen kann. + Anschließend klopfe man mit dem Hammer den Bierflaschenschnappverschluss in das Mauseloch. - Sollte der Verschluss nicht groß genug sein, um - das Loch vollständig und dauerhaft zu - verschließen, nehme man stattdessen das Brett + Sollte der Verschluss nicht groß genug sein, um + das Loch vollständig und dauerhaft zu + verschließen, nehme man stattdessen das Brett und schraube es unter Zuhilfenahme der beiden Schrauben und des Messers vor das Loch. Statt - des Messers kann selbstverständlich auch ein + des Messers kann selbstverständlich auch ein Schraubendreher verwendet werden. Die Kugelschreiberfeder ist dem Tierschutz zum Opfer gefallen. \end{document} \end{lstcode} - Der wesentliche Teil ab der Überschrift »Bauteile« sieht anschließend wie + Der wesentliche Teil ab der Ãœberschrift »Bauteile« sieht anschließend wie folgt aus: \begin{ShowOutput}[\baselineskip]\setlength{\parindent}{1em} \minisec{Bauteile} @@ -2509,7 +2530,7 @@ werden (siehe \autoref{tab:maincls.fontelements}, 1 Brett ($100\times 50 \times 12$)\\ 1 Bierflaschenschnappverschluss\\ 1 Kugelschreiberfeder\\ - 1 Reißzwecke\\ + 1 Reißzwecke\\ 2 Schrauben\\ 1 Hammer\\ 1 Messer @@ -2517,26 +2538,26 @@ werden (siehe \autoref{tab:maincls.fontelements}, \minisec{Montage} - Zunächst suche man das Mauseloch. Dann lege man die - Reißzwecke innen unmittelbar hinter das Loch, damit + Zunächst suche man das Mauseloch. Dann lege man die + Reißzwecke innen unmittelbar hinter das Loch, damit bei den folgenden Aktionen die Maus nicht - entschlüpfen kann. - Anschließend klopfe man mit dem Hammer den + entschlüpfen kann. + Anschließend klopfe man mit dem Hammer den Bierflaschenschnappverschluss in das Mauseloch. - Sollte der Verschluss nicht groß genug sein, um das - Loch vollständig und dauerhaft zu verschließen, + Sollte der Verschluss nicht groß genug sein, um das + Loch vollständig und dauerhaft zu verschließen, nehme man stattdessen das Brett und schraube es unter Zuhilfenahme der beiden Schrauben und des Messers vor das Loch. Statt des Messers kann - selbstverständlich auch ein Schraubendreher + selbstverständlich auch ein Schraubendreher verwendet werden. Die Kugelschreiberfeder ist dem Tierschutz zum Opfer gefallen. % Mit der Kugelschreiberfeder hat es eine besondere % Bewandtnis. Sie stammt noch aus dem Selbstbauprojekt -% »Mauseschnappfalle«, das dem Tierschutz zum Opfer gefallen ist. +% »Mauseschnappfalle«, das dem Tierschutz zum Opfer gefallen ist. \end{ShowOutput} - Zum Verständnis der Verwendung des Pakets + Zum Verständnis der Verwendung des Pakets \Package{selinput}\IndexPackage{selinput}\important{\Package{selinput}} und % \iffalse % Umbruchkorrektur @@ -2557,44 +2578,44 @@ werden (siehe \autoref{tab:maincls.fontelements}, \Macro{raggedpart} \end{Declaration}% Bei den Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} werden die -Überschriften ganz normal im Blocksatz ausgegeben. Dadurch können in den -Überschriften Trennungen auf"|treten und mehrzeilige Überschriften werden auf +Ãœberschriften ganz normal im Blocksatz ausgegeben. Dadurch können in den +Ãœberschriften Trennungen auf"|treten und mehrzeilige Ãœberschriften werden auf Textbreite gedehnt. Dieses Vorgehen ist in der Typografie eher -unüblich. {\KOMAScript} setzt Überschriften von +unüblich. {\KOMAScript} setzt Ãœberschriften von \DescRef{\LabelBase.cmd.chapter} bis \DescRef{\LabelBase.cmd.subparagraph} -daher in linksbündigem Flattersatz mit hängendem Einzug. Verantwortlich ist -dafür die Anweisung \Macro{raggedsection}, die vordefiniert ist als: +daher in linksbündigem Flattersatz mit hängendem Einzug. Verantwortlich ist +dafür die Anweisung \Macro{raggedsection}, die vordefiniert ist als: \begin{lstcode} \let\raggedsection\raggedright \end{lstcode} Die Anweisung \Macro{raggedsection} kann mit \Macro{renewcommand} umdefiniert werden. \begin{Example} - Sie wollen auch für Überschriften Blocksatz. Dazu schreiben Sie in - die Präambel Ihres Dokuments: + Sie wollen auch für Ãœberschriften Blocksatz. Dazu schreiben Sie in + die Präambel Ihres Dokuments: \begin{lstcode} \renewcommand*{\raggedsection}{} \end{lstcode} - oder kürzer: + oder kürzer: \begin{lstcode} \let\raggedsection\relax \end{lstcode} - Sie erreichen somit eine ähnliche Formatierung der Überschriften wie - bei den Standardklassen. Noch ähnlicher wird es, wenn Sie diese - Änderung mit der oben vorgestellten Änderung für das Element + Sie erreichen somit eine ähnliche Formatierung der Ãœberschriften wie + bei den Standardklassen. Noch ähnlicher wird es, wenn Sie diese + Änderung mit der oben vorgestellten Änderung für das Element \DescRef{\LabelBase.fontelement.disposition}\IndexFontElement{disposition} kombinieren. \end{Example} -Da\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}} manche Anwender für -die Kapitelebene eine andere Ausrichtung wünschen als für alle anderen Ebenen, -kann diese über \Macro{raggedchapter} auch getrennt verändert werden. In der +Da\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}} manche Anwender für +die Kapitelebene eine andere Ausrichtung wünschen als für alle anderen Ebenen, +kann diese über \Macro{raggedchapter} auch getrennt verändert werden. In der Voreinstellung verwendet die Anweisung jedoch einfach \Macro{raggedsection}, -so dass eine Änderung von \Macro{raggedsection} sich indirekt auch auf +so dass eine Änderung von \Macro{raggedsection} sich indirekt auch auf \Macro{raggedchapter} auswirkt. -Die Überschriften von Teilen (\DescRef{\LabelBase.cmd.part}) werden in der Voreinstellung als -einzige nicht in linksbündigem Flattersatz, sondern zentriert gesetzt. Dafür +Die Ãœberschriften von Teilen (\DescRef{\LabelBase.cmd.part}) werden in der Voreinstellung als +einzige nicht in linksbündigem Flattersatz, sondern zentriert gesetzt. Dafür ist die Anweisung \Macro{raggedpart} verantwortlich, die als: \begin{lstcode} \let\raggedpart\centering @@ -2602,18 +2623,18 @@ ist die Anweisung \Macro{raggedpart} verantwortlich, die als: vordefiniert ist. Auch diese Anweisung kann mit \Macro{renewcommand} umdefiniert werden. \begin{Example} - Sie wollen, dass Überschriften mit \DescRef{\LabelBase.cmd.part} in der + Sie wollen, dass Ãœberschriften mit \DescRef{\LabelBase.cmd.part} in der gleichen Weise formatiert werden wie alle anderen Ebenen. Dazu schreiben Sie \begin{lstcode} \renewcommand*{\raggedpart}{\raggedsection} \end{lstcode} - in die Präambel Ihres Dokuments. An\textnote{Tipp!} dieser Stelle wurde im + in die Präambel Ihres Dokuments. An\textnote{Tipp!} dieser Stelle wurde im Gegensatz zu oben absichtlich nicht \Macro{let} verwendet, da mit \Macro{let} der Anweisung \Macro{raggedpart} die aktuelle Bedeutung von - \Macro{raggedsection} zugewiesen würde. Spätere Änderungen von + \Macro{raggedsection} zugewiesen würde. Spätere Änderungen von \Macro{raggedsection} blieben also bei \Macro{raggedpart} - unberücksichtigt. Bei der Umdefinierung mit \Macro{renewcommand} erhält + unberücksichtigt. Bei der Umdefinierung mit \Macro{renewcommand} erhält \Macro{raggedpart} dagegen nicht die Bedeutung von \Macro{raggedsection} zum Zeitpunkt dieser Umdefinierung, sondern zum Zeitpunkt der Verwendung von \Macro{raggedpart}. @@ -2631,47 +2652,47 @@ umdefiniert werden. \Macro{paragraphformat} \Macro{subparagraphformat} \Macro{othersectionlevelsformat}\Parameter{Gliederungsname}\Parameter{} - \Parameter{Zählerausgabe} + \Parameter{Zählerausgabe} \Macro{IfUsePrefixLine}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \Macro{autodot} \end{Declaration}% -\KOMAScript{} fügt der Ausgabe der Gliederungsnummern oberhalb von -\Macro{the\PName{Gliederungsname}} (siehe \Macro{the\PName{Zähler}}, -\DescPageRef{maincls-experts.cmd.the/Zaehler/}) eine weitere logische Ebene -hinzu. Die Zähler werden für die jeweilige Überschrift nicht einfach nur +\KOMAScript{} fügt der Ausgabe der Gliederungsnummern oberhalb von +\Macro{the\PName{Gliederungsname}} (siehe \Macro{the\PName{Zähler}}, +\DescPageRef{maincls-experts.cmd.the/Zähler/}) eine weitere logische Ebene +hinzu. Die Zähler werden für die jeweilige Ãœberschrift nicht einfach nur ausgegeben. Sie werden mit Hilfe der parameterlosen Anweisungen \Macro{partformat}, \Macro{chapterformat} bis \Macro{subparagraphformat}\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} formatiert. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Die Anweisung \Macro{chapterformat} existiert, wie bereits \Macro{thechapter}, -selbstverständlich nicht in der Klasse \Class{scrartcl}, sondern nur in den +selbstverständlich nicht in der Klasse \Class{scrartcl}, sondern nur in den Klassen \Class{scrbook} und \Class{scrreprt}. Wie bereits bei Option \DescRef{\LabelBase.option.numbers}% \important{\DescRef{\LabelBase.option.numbers}} am Anfang dieses Abschnitts -(siehe \DescPageRef{\LabelBase.option.numbers}) erläutert wurde, müssen gemäß +(siehe \DescPageRef{\LabelBase.option.numbers}) erläutert wurde, müssen gemäß \cite{DUDEN} die Gliederungsnummern je nach Gliederung mit einem nachfolgenden Punkt versehen werden oder dieser hat zu entfallen. Die Anweisung -\Macro{autodot} ist bei {\KOMAScript} für die Einhaltung dieser Regel -verantwortlich. Auf den Punkt folgt bei allen Gliederungsebenen außer +\Macro{autodot} ist bei {\KOMAScript} für die Einhaltung dieser Regel +verantwortlich. Auf den Punkt folgt bei allen Gliederungsebenen außer \DescRef{\LabelBase.cmd.part} noch ein \Macro{enskip}. Dies entspricht einem Leerraum von 0,5\Unit{em}, also einem Halbgeviert. Die Anweisung \Macro{othersectionlevelsformat}\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} wird seit \KOMAScript~3.17 nur noch -in Ausnahmefällen verwendet, wenn für eine Gliederungsebene keine +in Ausnahmefällen verwendet, wenn für eine Gliederungsebene keine Format-Anweisung definiert oder diese \Macro{relax} ist, was jedoch in der -Voreinstellung für die Gliederungsebenen von KOMA-Script nicht zutrifft. Daher +Voreinstellung für die Gliederungsebenen von KOMA-Script nicht zutrifft. Daher wird sie auch nicht mehr offiziell dokumentiert. Bei einer -Kompatibilitätseinstellung zu Versionen vor +Kompatibilitätseinstellung zu Versionen vor 3.17\important{\OptionValueRef{\LabelBase}{version}{3.17}} (siehe Option \DescRef{\LabelBase.option.version}, \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}) haben hingegen die Anweisungen \Macro{sectionformat} bis \Macro{subparagraphformat} keine interne -Funktion. Stattdessen wird für diese Ebenen dann weiterhin +Funktion. Stattdessen wird für diese Ebenen dann weiterhin \Macro{othersectionlevelsformat} verwendet. Mit Hilfe von \Macro{renewcommand} kann jede der @@ -2697,35 +2718,35 @@ anzupassen. Nachfolgend finden Sie einige Definitionen, die denen aus den Wegen\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}} der Verwendung von \Macro{IfUsePrefixLine} sollte die Anweisung \Macro{chapterformat} nicht -außerhalb von \DescRef{\LabelBase.cmd.chapter} verwendet +außerhalb von \DescRef{\LabelBase.cmd.chapter} verwendet werden. \Macro{IfUsePrefixLine} ist nur innerhalb der Gliederungsbefehle von \KOMAScript{} wohldefiniert. Dort wird dann im Falle der Verwendung einer -Präfixzeile für die Nummer der Überschrift der \PName{Dann-Teil} ausgeführt, -während im anderen Fall der \PName{Sonst-Teil} zur Ausführung kommt. +Präfixzeile für die Nummer der Ãœberschrift der \PName{Dann-Teil} ausgeführt, +während im anderen Fall der \PName{Sonst-Teil} zur Ausführung kommt. -Bitte\textnote{Achtung!} beachten Sie außerdem, dass bei der Umdefinierung -selbstverständlich \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen +Bitte\textnote{Achtung!} beachten Sie außerdem, dass bei der Umdefinierung +selbstverständlich \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen ist. \begin{Example} Angenommen, Sie wollen, dass bei \DescRef{\LabelBase.cmd.part} das Wort - »Teil« vor der Nummer nicht ausgegeben wird. Dann können Sie beispielsweise - folgende Anweisung in die Präambel Ihres Dokuments schreiben: + »Teil« vor der Nummer nicht ausgegeben wird. Dann können Sie beispielsweise + folgende Anweisung in die Präambel Ihres Dokuments schreiben: \begin{lstcode} \renewcommand*{\partformat}{\thepart\autodot} \end{lstcode} - Genau genommen könnten Sie an dieser Stelle auch auf \Macro{autodot} + Genau genommen könnten Sie an dieser Stelle auch auf \Macro{autodot} verzichten und stattdessen einen festen Punkt setzen. Da - \DescRef{\LabelBase.cmd.part} mit römischen Zahlen nummeriert wird, muss der + \DescRef{\LabelBase.cmd.part} mit römischen Zahlen nummeriert wird, muss der Punkt laut \cite{DUDEN} folgen. Allerdings bringen Sie sich dann um die - Möglichkeit, die Option \DescRef{\LabelBase.option.numbers}% + Möglichkeit, die Option \DescRef{\LabelBase.option.numbers}% \important{\DescRef{\LabelBase.option.numbers}} einzusetzen und so von der - Regel abzuweichen. Näheres zu der Option siehe + Regel abzuweichen. Näheres zu der Option siehe \DescPageRef{\LabelBase.option.numbers}. - Eine weitere Möglichkeit besteht darin, die Nummerierung der Abschnitte - so in den Rand zu platzieren, dass der Überschriftentext - links mit dem umgebenden Text abschließt. Dies erreicht man + Eine weitere Möglichkeit besteht darin, die Nummerierung der Abschnitte + so in den Rand zu platzieren, dass der Ãœberschriftentext + links mit dem umgebenden Text abschließt. Dies erreicht man mit: \begin{lstcode} \renewcommand*{\sectionformat}{% @@ -2742,18 +2763,18 @@ ist. \thesubparagraph\autodot\enskip}} \end{lstcode} Die optionalen Argumente der \Macro{makebox}-Anweisungen fordern von - \LaTeX{} dabei eine Box der Breite Null, deren Inhalt rechtsbündig + \LaTeX{} dabei eine Box der Breite Null, deren Inhalt rechtsbündig angeordnet ist. Im Ergebnis wird der Inhalt der Box links von der aktuellen Position ausgegeben.\iffree{}{ %Umbruchkorrekturtext - Mit diesem beliebten Trick wird vermieden, dass zunächst die Breite von + Mit diesem beliebten Trick wird vermieden, dass zunächst die Breite von Nummer und Abstand ausgemessen werden muss, um dann die aktuelle Position - entsprechend mit \Macro{hspace} zu verändern.} - Näheres zu den optionalen Argumenten von \Macro{makebox} ist + entsprechend mit \Macro{hspace} zu verändern.} + Näheres zu den optionalen Argumenten von \Macro{makebox} ist \cite{latex:usrguide} zu entnehmen. \end{Example} -Für Formatierungsänderungen bei den Überschriften, die über die reine Ausgabe -der Nummer hinaus gehen, sei ausdrücklich auf +Für Formatierungsänderungen bei den Ãœberschriften, die über die reine Ausgabe +der Nummer hinaus gehen, sei ausdrücklich auf \DescRef{maincls-experts.cmd.partlineswithprefixformat}% \IndexCmd{partlineswithprefixformat}, \DescRef{maincls-experts.cmd.chapterlineswithprefixformat}% @@ -2761,8 +2782,8 @@ der Nummer hinaus gehen, sei ausdrücklich auf \DescRef{maincls-experts.cmd.chapterlinesformat}\IndexCmd{chapterlinesformat} sowie \DescRef{maincls-experts.cmd.sectionlinesformat}\IndexCmd{sectionlinesformat} -und das zugehörige \DescRef{maincls-experts.cmd.sectioncatchphraseformat}% -\IndexCmd{sectioncatchphraseformat} in \autoref{sec:maincls-experts.experts}, +und das zugehörige \DescRef{maincls-experts.cmd.sectioncatchphraseformat}% +\IndexCmd{sectioncatchphraseformat} in \autoref{sec:maincls-experts.sections}, ab \DescPageRef{maincls-experts.cmd.partlineswithprefixformat} verwiesen.% \EndIndexGroup @@ -2774,22 +2795,22 @@ ab \DescPageRef{maincls-experts.cmd.partlineswithprefixformat} verwiesen.% Diese \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% \ChangedAt{v2.8o}{\Class{scrbook}\and \Class{scrreprt}}% beiden Anweisungen werden nicht nur intern von {\KOMAScript} verwendet, -sondern stehen auch dem Anwender zur Verfügung. Nachfolgend werden sie -beispielsweise für die Umdefinierung anderer Anweisungen verwendet. +sondern stehen auch dem Anwender zur Verfügung. Nachfolgend werden sie +beispielsweise für die Umdefinierung anderer Anweisungen verwendet. Bei Verwendung von Option \OptionValueRef{\LabelBase}{chapterprefix}{true}% \important{\DescRef{\LabelBase.option.chapterprefix}} (siehe \DescPageRef{\LabelBase.option.chapterprefix}) setzt \Macro{chapappifchapterprefix} im Hauptteil des Dokuments das Wort -»Kapitel«\Index{Kapitel>Ueberschrift=Überschrift} in der aktuellen Sprache, +»Kapitel«\Index{Kapitel>Ueberschrift=Ãœberschrift} in der aktuellen Sprache, gefolgt vom \PName{Zusatztext}. Im Anhang\Index{Anhang} wird stattdessen das -Wort »Anhang« in der aktuellen Sprache, ebenfalls gefolgt vom +Wort »Anhang« in der aktuellen Sprache, ebenfalls gefolgt vom \PName{Zusatztext}, ausgegeben. Bei der Einstellung \OptionValueRef{\LabelBase}{chapterprefix}{false} wird hingegen nichts ausgegeben. -Die Anweisung \Macro{chapapp} setzt immer das Wort »Kapitel« -beziehungsweise »Anhang«. Dabei spielt die Einstellung der Option +Die Anweisung \Macro{chapapp} setzt immer das Wort »Kapitel« +beziehungsweise »Anhang«. Dabei spielt die Einstellung der Option \DescRef{\LabelBase.option.chapterprefix} keine Rolle. Da es Kapitel nur bei den Klassen \Class{scrbook} und \Class{scrreprt} @@ -2809,19 +2830,19 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.% \Macro{subsectionmarkformat} \end{Declaration}% \begin{Explain} - Wie bereits in \autoref{sec:\LabelBase.pagestyle} erwähnt, arbeitet der + Wie bereits in \autoref{sec:\LabelBase.pagestyle} erwähnt, arbeitet der Seitenstil \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}% \important{\DescRef{\LabelBase.pagestyle.headings}} mit automatischen Kolumnentiteln\Index{Kolumnentitel>automatisch}. Dazu werden die Anweisungen \Macro{chaptermark} und \Macro{sectionmark} beziehungsweise \Macro{sectionmark} und \Macro{subsectionmark} entsprechend definiert. Gliederungsbefehle (\DescRef{\LabelBase.cmd.chapter}, - \DescRef{\LabelBase.cmd.section}~\dots) führen automatisch eine - entsprechende \Macro{\dots mark}-Anweisung aus. Der dabei übergebene + \DescRef{\LabelBase.cmd.section}~\dots) führen automatisch eine + entsprechende \Macro{\dots mark}-Anweisung aus. Der dabei übergebene Parameter beinhaltet den Text der - Gliederungsüberschrift\Index{Ueberschriften=Überschriften}. Die zugehörige + Gliederungsüberschrift\Index{Ueberschriften=Ãœberschriften}. Die zugehörige Gliederungsnummer wird automatisch in der \Macro{\dots mark}-Anweisung - hinzugefügt. Die Formatierung erfolgt je nach Gliederungsebene mit einer der + hinzugefügt. Die Formatierung erfolgt je nach Gliederungsebene mit einer der drei Anweisungen \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und \Macro{subsectionmarkformat}. @@ -2829,32 +2850,32 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.% \DescRef{\LabelBase.cmd.addchap}\IndexCmd{addchap} und \DescRef{\LabelBase.cmd.addsec}\IndexCmd{addsec} ebenfalls auf \Macro{chaptermark} und \Macro{sectionmark} basieren. Dabei wird aber lokal - der Zähler \DescRef{\LabelBase.counter.secnumdepth} auf einen Wert gesetzt, + der Zähler \DescRef{\LabelBase.counter.secnumdepth} auf einen Wert gesetzt, mit dem die Nummerierung von Kapiteln beziehungsweise Abschnitten abgeschaltet wird. Dies sollte man beispielsweise bei der Umdefinierung von - \Macro{chaptermark} und \Macro{sectionmark} berücksichtigen (siehe - \Macro{ifnumbered} auf \DescPageRef{\LabelBase.cmd.ifnumbered}). Für die + \Macro{chaptermark} und \Macro{sectionmark} berücksichtigen (siehe + \Macro{ifnumbered} auf \DescPageRef{\LabelBase.cmd.ifnumbered}). Für die Sternformen \DescRef{\LabelBase.cmd.addchap*} und - \DescRef{\LabelBase.cmd.addsec*} existieren außerdem die Anweisungen + \DescRef{\LabelBase.cmd.addsec*} existieren außerdem die Anweisungen \Macro{addchapmark} und \Macro{addsecmark}, die in der Voreinstellung ebenfalls in der genannten Weise definiert sind. - Während\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} bei \Class{scrartcl} + 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}. Bei Verwendung des Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% - \IndexPackage{scrlayer-scrpage} ändert sich dies jedoch (siehe + \IndexPackage{scrlayer-scrpage} ändert sich dies jedoch (siehe \autoref{cha:scrlayer-scrpage}). \end{Explain} So wie mit \DescRef{\LabelBase.cmd.partformat} bis \DescRef{\LabelBase.cmd.subparagraphformat} die Nummern der -Gliederungsüberschriften formatiert ausgegeben werden, werden entsprechend mit +Gliederungsüberschriften formatiert ausgegeben werden, werden entsprechend mit \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und \Macro{subsectionmarkformat} die Nummern der Gliederungsebenen in den automatischen Kolumnentiteln formatiert ausgegeben. Mit \Macro{renewcommand} -können sie eigenen Anforderungen angepasst werden. Die Originaldefinitionen +können sie eigenen Anforderungen angepasst werden. Die Originaldefinitionen aus den {\KOMAScript}-Klassen sind: \begin{lstcode} \newcommand*{\chaptermarkformat}{% @@ -2866,8 +2887,8 @@ aus den {\KOMAScript}-Klassen sind: \end{lstcode} \begin{Example} Angenommen, Sie wollen, dass der Kapitelnummer in den Kolumnentiteln - das Wort »Kapitel« vorangestellt wird. Dann setzen Sie - beispielsweise diese Definition in die Präambel Ihres Dokuments: + das Wort »Kapitel« vorangestellt wird. Dann setzen Sie + beispielsweise diese Definition in die Präambel Ihres Dokuments: \begin{lstcode} \renewcommand*{\chaptermarkformat}{% \chapapp~\thechapter\autodot\enskip} @@ -2876,7 +2897,7 @@ aus den {\KOMAScript}-Klassen sind: Wie Sie sehen, finden hier die beiden Anweisungen \DescRef{\LabelBase.cmd.chapapp} und \DescRef{\LabelBase.cmd.chapappifchapterprefix} Verwendung, die weiter oben -erklärt wurden.% +erklärt wurden.% \EndIndexGroup @@ -2898,32 +2919,32 @@ Normalerweise werden bei den Klassen \Class{scrbook}\IndexClass{scrbook} und \DescRef{\LabelBase.cmd.subsection}\IndexCmd{subsection} und bei der Klasse \Class{scrartcl}\IndexClass{scrartcl} die Ebenen \DescRef{\LabelBase.cmd.part} bis \DescRef{\LabelBase.cmd.subsubsection}\IndexCmd{subsubsection} -nummeriert. Gesteuert wird dies über den \LaTeX-Zähler \Counter{secnumdepth}. +nummeriert. Gesteuert wird dies ü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 +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 + (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 +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. +\KOMAScript{} als auch bei Verwendung von Drittpaketen führen kann. -Der\textnote{Achtung!} Zähler \Counter{secnumdepth} ist nicht zu verwechseln -mit dem Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe +Der\textnote{Achtung!} Zähler \Counter{secnumdepth} ist nicht zu verwechseln +mit dem Zähler \DescRef{\LabelBase.counter.tocdepth} (siehe \autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.counter.tocdepth}). Auch -sind die Werte je nach Klasse nicht eins zu eins übertragbar.% +sind die Werte je nach Klasse nicht eins zu eins übertragbar.% % \EndIndexGroup @@ -2934,15 +2955,15 @@ sind die Werte je nach Klasse nicht eins zu eins übertragbar.% \Parameter{Dann-Teil}\Parameter{Else-Teil} \end{Declaration} Nachdem\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} zuvor erklärt wurde, wie man bestimmen kann, welche + \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 +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}. @@ -2950,7 +2971,7 @@ wohingegen \Macro{ifunnumbered} den \PName{Dann-Teil} ausführt. Als \KOMAScript{} selbst verwendet diesen Test beispielsweise in der Definition von \DescRef{\LabelBase.cmd.chaptermark}\IndexCmd{chaptermark} beim Seitenstil \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}. Dadurch wird -indirekt auch sichergestellt, dass Überschriften mit +indirekt auch sichergestellt, dass Ãœberschriften mit \DescRef{\LabelBase.cmd.addchap} den Kolumnentitel nicht mit einer Nummer versehen (siehe auch \DescRef{\LabelBase.cmd.addchapmark}, \DescPageRef{\LabelBase.cmd.addchapmark}).% @@ -2959,43 +2980,43 @@ versehen (siehe auch \DescRef{\LabelBase.cmd.addchapmark}, \begin{Declaration} \Macro{setpartpreamble}% - \OParameter{Position}\OParameter{Breite}\Parameter{Präambel} + \OParameter{Position}\OParameter{Breite}\Parameter{Präambel} \Macro{setchapterpreamble}% - \OParameter{Position}\OParameter{Breite}\Parameter{Präambel} + \OParameter{Position}\OParameter{Breite}\Parameter{Präambel} \end{Declaration}% \OnlyAt{\Class{scrbook}\and - \Class{scrreprt}}Teile\Index{Teil>Praeambel=Präambel} und -Kapitel\Index{Kapitel>Praeambel=Präambel} können bei {\KOMAScript} mit einer -\PName{Präambel} versehen werden. Dies ist insbesondere im zweispaltigen + \Class{scrreprt}}Teile\Index{Teil>Praeambel=Präambel} und +Kapitel\Index{Kapitel>Praeambel=Präambel} können bei {\KOMAScript} mit einer +\PName{Präambel} versehen werden. Dies ist insbesondere im zweispaltigen Layout mit der Klassenoption \Option{twocolumn}\IndexOption{twocolumn} -nützlich, da die \PName{Präambel} zusammen mit der Überschrift einspaltig -gesetzt wird. Die \PName{Präambel} kann auch mehrere Absätze beinhalten. Die -Anweisung zum Setzen der \PName{Präambel} muss vor der jeweiligen +nützlich, da die \PName{Präambel} zusammen mit der Ãœberschrift einspaltig +gesetzt wird. Die \PName{Präambel} kann auch mehrere Absätze beinhalten. Die +Anweisung zum Setzen der \PName{Präambel} muss vor der jeweiligen \DescRef{\LabelBase.cmd.part}- oder \DescRef{\LabelBase.cmd.addpart}- bzw. \DescRef{\LabelBase.cmd.chapter}- oder \DescRef{\LabelBase.cmd.addchap}-Anweisung stehen. \begin{Example} - Sie schreiben einen Bericht über den Zustand einer Firma. Dabei + Sie schreiben einen Bericht über den Zustand einer Firma. Dabei organisieren Sie den Bericht so, dass jeder Abteilung ein eigener - Teilbericht spendiert wird. Jedem dieser Teile soll außerdem eine + Teilbericht spendiert wird. Jedem dieser Teile soll außerdem eine Zusammenfassung vorangestellt werden. Diese Zusammenfassung soll auf - der Titelseite jedes Teils stehen. Das ist wie folgt möglich: + der Titelseite jedes Teils stehen. Das ist wie folgt möglich: \begin{lstcode} \setpartpreamble{% \begin{abstract} Dies ist ein Blindtext zur Demonstration. \end{abstract}} - \part{Abteilung Grünschnitt} + \part{Abteilung Grünschnitt} \end{lstcode} - Je nach Einstellung der Optionen für die - Überschriftengröße\Index{Ueberschriften=Überschriften} (siehe - \DescPageRef{\LabelBase.option.headings}) und der Optionen für die Form + Je nach Einstellung der Optionen für die + Ãœberschriftengröße\Index{Ueberschriften=Ãœberschriften} (siehe + \DescPageRef{\LabelBase.option.headings}) und der Optionen für die Form der \DescRef{\LabelBase.env.abstract}-Umgebung\IndexEnv{abstract} (siehe \autoref{sec:\LabelBase.abstract}, \DescPageRef{\LabelBase.option.abstract}), - sieht das Ergebnis ungefähr wie folgt aus: + sieht das Ergebnis ungefähr wie folgt aus: \begin{ShowOutput}\centering {\LARGE\usekomafont{disposition} Teil III.\par\vspace{14pt}} - {\LARGE\usekomafont{disposition} Abteilung Grünschnitt\strut\par} + {\LARGE\usekomafont{disposition} Abteilung Grünschnitt\strut\par} \begin{quote}\small \vspace{4ex} \begin{center} @@ -3006,50 +3027,50 @@ bzw. \DescRef{\LabelBase.cmd.chapter}- oder \end{quote} \end{ShowOutput} \end{Example} -Bitte\textnote{Achtung!} beachten Sie, dass Sie für die Abstände der Präambel -zur Teilüberschrift bzw. zum Kapiteltext selbst verantwortlich sind. Bitte +Bitte\textnote{Achtung!} beachten Sie, dass Sie für die Abstände der Präambel +zur Teilüberschrift bzw. zum Kapiteltext selbst verantwortlich sind. Bitte beachten Sie auch, dass die \DescRef{\LabelBase.env.abstract}-Umgebung bei der Klasse \Class{scrbook} nicht existiert (siehe \autoref{sec:\LabelBase.abstract}, \DescPageRef{\LabelBase.env.abstract}). Das\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}} erste -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: +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=-\parsep -\item [\quad\PValue{o}] über der Überschrift -\item [\quad\PValue{u}] unter der Überschrift +\item [\quad\PValue{o}] über der Ãœberschrift +\item [\quad\PValue{u}] unter der Ãœberschrift \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: +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{l}] linksbündig +\item [\quad\PValue{r}] rechtsbündig \item [\quad\PValue{c}] zentriert \end{labeling} -Dabei wird allerdings nicht der Text der \PName{Präambel} entsprechend +Dabei wird allerdings nicht der Text der \PName{Präambel} entsprechend angeordnet, sondern eine Box, deren Breite durch das zweite optionale Argument \PName{Breite} bestimmt wird. Wird auf das zweite optionale Argument verzichtet, so wird stattdessen die gesamte Textbreite verwendet. Damit bleibt die Option zur horizontalen Positionierung in -diesem Fall wirkungslos. Es kann jeweils ein Buchstabe für die -vertikale mit einem Buchstaben für die horizontale Anordnung +diesem Fall wirkungslos. Es kann jeweils ein Buchstabe für die +vertikale mit einem Buchstaben für die horizontale Anordnung kombiniert werden. -Eine häufigere Anwendung von \Macro{setchapterpreamble} dürfte ein Spruch oder -Zitat zu einer Überschrift sein. Die dazu verwendbare Anweisung +Eine häufigere Anwendung von \Macro{setchapterpreamble} dürfte ein Spruch oder +Zitat zu einer Ãœberschrift sein. Die dazu verwendbare Anweisung \DescRef{\LabelBase.cmd.dictum}\IndexCmd{dictum} ist im nachfolgenden -Abschnitt erläutert. Dort findet sich auch ein entsprechendes Beispiel. - -Bitte\textnote{Achtung!} beachten Sie, dass \PName{Präambel} bei der -Platzierung über der Überschrift in den dort vorhandenen freien Platz gesetzt -wird. Die Überschrift wird dabei nicht nach unten verschoben. Der Anwender ist -also selbst dafür verantwortlich dass \PName{Präambel} nicht zu groß ist und -der vorhandene freie Platz über der Überschrift genügt. Siehe dazu auch -Einstellung \Option{beforeskip} für +Abschnitt erläutert. Dort findet sich auch ein entsprechendes Beispiel. + +Bitte\textnote{Achtung!} beachten Sie, dass \PName{Präambel} bei der +Platzierung über der Ãœberschrift in den dort vorhandenen freien Platz gesetzt +wird. Die Ãœberschrift wird dabei nicht nach unten verschoben. Der Anwender ist +also selbst dafür verantwortlich dass \PName{Präambel} nicht zu groß ist und +der vorhandene freie Platz über der Ãœberschrift genügt. Siehe dazu auch +Einstellung \Option{beforeskip} für \DescRef{maincls-experts.cmd.RedeclareSectionCommand} in -\autoref{sec:maincls-experts.experts}, +\autoref{sec:maincls-experts.sections}, \autoref{tab:maincls-experts.declarechapterstyle.keys}, \autopageref{tab:maincls-experts.declarechapterstyle.keys}. % @@ -3070,10 +3091,10 @@ Einstellung \Option{beforeskip} für \BeginIndex{}{Formeln}% \BeginIndex{}{Gleichungen}% -Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische -Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik -bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll -und ganz auf den \LaTeX-Kern. Dies gilt auch für die Realisierung der beiden +Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische +Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik +bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll +und ganz auf den \LaTeX-Kern. Dies gilt auch für die Realisierung der beiden Optionen \DescRef{\LabelBase.option.leqno} und \DescRef{\LabelBase.option.fleqn}. @@ -3081,7 +3102,7 @@ Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also \Environment{displaymath}\IndexEnv{displaymath}, \Environment{equation}\IndexEnv{equation} und \Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle -verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für +verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die Verwendung von Paket \Package{amsmath}\textnote{Tipp!} empfohlen (siehe \cite{package:amsmath}).% @@ -3095,8 +3116,8 @@ Standardoptionsdatei \File{leqno.clo} geladen. Dadurch erfolgt die Nummerierung von Gleichungen links. Diese Option ist als optionales Argument\textnote{Achtung!} von \DescRef{\LabelBase.cmd.documentclass} zu verwenden. Eine Einstellung per \DescRef{\LabelBase.cmd.KOMAoptions} oder -\DescRef{\LabelBase.cmd.KOMAoption} wird nicht unterstützt. Dies wäre auch -deshalb nicht sinnvoll, weil das für den Mathematiksatz empfohlene Paket +\DescRef{\LabelBase.cmd.KOMAoption} wird nicht unterstützt. Dies wäre auch +deshalb nicht sinnvoll, weil das für den Mathematiksatz empfohlene Paket \Package{amsmath} ebenfalls nur beim Laden, nicht aber zur Laufzeit auf diese Option reagieren kann.% % @@ -3109,11 +3130,11 @@ Option reagieren kann.% Gleichungen\Index{Gleichungen>Ausrichtung} werden normalerweise horizontal zentriert ausgegeben. Mit Hilfe der Standardoption \Option{fleqn} wird die Standardoptionsdatei \File{fleqn.clo} geladen. Dadurch erfolgt die Ausgabe von -Gleichungen linksbündig. Diese Option ist als optionales +Gleichungen linksbündig. Diese Option ist als optionales Argument\textnote{Achtung!} von \DescRef{\LabelBase.cmd.documentclass} zu verwenden. Eine Einstellung per \DescRef{\LabelBase.cmd.KOMAoptions} oder -\DescRef{\LabelBase.cmd.KOMAoption} wird nicht unterstützt. Dies wäre auch -deshalb nicht sinnvoll, weil das für den Mathematiksatz empfohlene Paket +\DescRef{\LabelBase.cmd.KOMAoption} wird nicht unterstützt. Dies wäre auch +deshalb nicht sinnvoll, weil das für den Mathematiksatz empfohlene Paket \Package{amsmath} ebenfalls nur beim Laden, nicht aber zur Laufzeit auf diese Option reagieren kann.% % @@ -3122,46 +3143,46 @@ Option reagieren kann.% \EndIndexGroup -\section{Gleitumgebungen für Tabellen und Abbildungen} +\section{Gleitumgebungen für Tabellen und Abbildungen} \seclabel{floats} \BeginIndexGroup \BeginIndex{}{Gleitumgebungen} \BeginIndex{}{Tabellen} \BeginIndex{}{Abbildungen} -{\LaTeX} bietet mit den Gleitumgebungen einen sehr leistungsfähigen und -komfortablen Mechanismus für die automatische Anordnung von Abbildungen und -Tabellen. Genau genommen sollte von »Tafeln«\Index{Tafeln} statt von -»Tabellen« die Rede sein. Dies wäre auch zur Unterscheidung der Umgebungen +{\LaTeX} bietet mit den Gleitumgebungen einen sehr leistungsfähigen und +komfortablen Mechanismus für die automatische Anordnung von Abbildungen und +Tabellen. Genau genommen sollte von »Tafeln«\Index{Tafeln} statt von +»Tabellen« die Rede sein. Dies wäre auch zur Unterscheidung der Umgebungen \Environment{table}\IndexEnv{table} und \Environment{tabular}\IndexEnv{tabular} von Vorteil. Es hat sich im Deutschen -aber für beides die Bezeichnung »Tabelle« eingebürgert. Das kommt vermutlich -daher, dass man in \Environment{table}-Umgebungen üblicherweise +aber für beides die Bezeichnung »Tabelle« eingebürgert. Das kommt vermutlich +daher, dass man in \Environment{table}-Umgebungen üblicherweise \Environment{tabular}-Umgebungen setzt, auch wenn dies keineswegs zwingend ist. -Häufig\textnote{Achtung!} werden die Gleitumgebungen von Anfängern nicht +Häufig\textnote{Achtung!} werden die Gleitumgebungen von Anfängern nicht richtig verstanden. So wird oft die Forderung aufgestellt, eine Tabelle oder Abbildung genau an einer bestimmten Position im Text zu setzen. Dies ist -jedoch nicht erforderlich, da auf Gleitumgebungen im Text über eine Referenz +jedoch nicht erforderlich, da auf Gleitumgebungen im Text über eine Referenz verwiesen wird. Es ist auch nicht sinnvoll, da ein solches Objekt an einer -Stelle nur dann gesetzt werden kann, wenn auf der Seite noch genügend Platz -für das Objekt vorhanden ist. Ist dies nicht der Fall, müsste das Objekt auf -die nächste Seite umbrochen werden und auf der aktuellen Seite würde ein -möglicherweise sehr großer leerer Raum bleiben. +Stelle nur dann gesetzt werden kann, wenn auf der Seite noch genügend Platz +für das Objekt vorhanden ist. Ist dies nicht der Fall, müsste das Objekt auf +die nächste Seite umbrochen werden und auf der aktuellen Seite würde ein +möglicherweise sehr großer leerer Raum bleiben. -Häufig\textnote{Achtung!} findet sich in einem Dokument auch bei jedem +Häufig\textnote{Achtung!} findet sich in einem Dokument auch bei jedem Gleitobjekt das gleiche optionale Argument zur Platzierung des Objekts. Auch -dies ist nicht sinnvoll. In solchen Fällen sollte man besser den Standardwert -global ändern. Näheres dazu ist \cite{DANTE:FAQ} zu entnehmen. +dies ist nicht sinnvoll. In solchen Fällen sollte man besser den Standardwert +global ändern. Näheres dazu ist \cite{DANTE:FAQ} zu entnehmen. \iffree{}{\pagebreak[3]}% Umbruchoptimierung!!! Ein\textnote{Achtung!} wichtiger Hinweis sei diesem Abschnitt noch -vorangestellt: Die meisten Mechanismen, die hier vorgestellt werden und über -die Fähigkeiten der Standardklassen hinaus gehen, funktionieren nicht mehr, +vorangestellt: Die meisten Mechanismen, die hier vorgestellt werden und über +die Fähigkeiten der Standardklassen hinaus gehen, funktionieren nicht mehr, wenn Sie ein Paket verwenden, das in die Generierung von Tabellen- und -Abbildungstiteln eingreift und deren Aussehen verändert. Dies sollte -selbstverständlich sein, wird aber leider häufig nicht bedacht. +Abbildungstiteln eingreift und deren Aussehen verändert. Dies sollte +selbstverständlich sein, wird aber leider häufig nicht bedacht. \begin{Declaration} @@ -3169,125 +3190,125 @@ selbstverständlich sein, wird aber leider häufig nicht bedacht. \end{Declaration} Bei den Standardklassen werden die Titel von Gleitumgebungen, die mit der Anweisung \DescRef{\LabelBase.cmd.caption}\IndexCmd{caption} (siehe unten) -gesetzt werden, als Unterschrift formatiert. Darüber hinaus wird zwischen +gesetzt werden, als Unterschrift formatiert. Darüber hinaus wird zwischen ein"~ und mehrzeiligen Unterschriften unterschieden, wobei einzeilige Unterschriften horizontal zentriert werden. \leavevmode\LabelOptionValue{captions}{tableheading}\nobreak% -Tabellen werden jedoch häufig mit -Überschriften\important{\OptionValue{captions}{tableheading}} statt mit +Tabellen werden jedoch häufig mit +Ãœberschriften\important{\OptionValue{captions}{tableheading}} 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 auf der ersten Seite wissen, worum es sich handelt. Darüber +die sich über mehrere Seiten erstrecken. Bei solchen Tabellen möchte man +natürlich bereits 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 +mindestens zwei gute Gründe, in der Regel alle Tabellen mit Ãœberschriften zu versehen. \KOMAScript{} bietet daher mit der Einstellung \OptionValue{captions}{tableheading}% -\IndexOption{captions~=\textKValue{tableheading}} die Möglichkeit, bei -Tabellen die Formatierung auf Überschriften zu ändern. +\IndexOption{captions~=\textKValue{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 -automatischen Seitenumbruch von Tabellen werden außerdem Zusatzpakete wie +mehrseitige Tabellen nicht als Gleitumgebungen gesetzt werden können. Für den +automatischen Seitenumbruch von Tabellen werden außerdem Zusatzpakete wie \Package{longtable}\IndexPackage{longtable} (siehe \cite{package:longtable}) oder \Package{supertabular}\IndexPackage{supertabular} (siehe -\cite{package:supertabular}) benötigt. +\cite{package:supertabular}) benötigt. Mit\important{\OptionValue{captions}{tablesignature}} der Einstellung \OptionValue{captions}{tablesignature}% \IndexOption{captions~=\textKValue{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"~ -oder Unterschrift gesetzt wird, hängt bei den Gleitumgebungen von +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"~ +oder Unterschrift gesetzt wird, hängt bei den Gleitumgebungen von \KOMAScript{} allein vom Ort ab, an dem die Anweisung -\DescRef{\LabelBase.cmd.caption} verwendet wird. Dies ändert sich jedoch bei +\DescRef{\LabelBase.cmd.caption} verwendet wird. Dies ändert sich jedoch bei Verwendung des Pakets \Package{float}\IndexPackage{float} mit der Anweisung \Macro{restylefloat}\IndexCmd{restylefloat}\important{\Macro{restylefloat}} (siehe \cite{package:float}). -Natürlich\important{\OptionValue{captions}{figureheading}\\ +Natürlich\important{\OptionValue{captions}{figureheading}\\ \OptionValue{captions}{figuresignature}} existiert\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} mit den Optionen \OptionValue{captions}{figureheading}% \IndexOption{captions~=\textKValue{figureheading}} und \OptionValue{captions}{figuresignature}% \IndexOption{captions~=\textKValue{figuresignature}} auch die entsprechende -Funktion für Abbildungen. Allerdings werden Abbildungen in der Regel wie im +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 Fällen dürfte es daher +von unten links her betrachtet. In den wenigsten Fällen dürfte es daher sinnvoll sein, nur bei Abbildungen die Formatierung von Unterschriften in -Überschriften zu ändern. +Ãœberschriften zu ändern. -Manchmal wird jedoch gewünscht, alle Gleitumgebungen mit Überschriften zu +Manchmal wird jedoch gewünscht, alle Gleitumgebungen mit Ãœberschriften zu versehen. Daher gibt es bei \KOMAScript{} die Einstellungen\important{% \OptionValue{captions}{heading}\\ \OptionValue{captions}{signature}} \OptionValue{captions}{heading}% \IndexOption{captions~=\textKValue{heading}} und \OptionValue{captions}{signature}\IndexOption{captions~=\textKValue{signature}}, -mit der man die Formatierungen aller Gleitumgebungen entsprechend ändern +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 -Unterschriften oder Überschriften nicht mehr funktionieren, sobald Sie -\Macro{restylefloat} auf Tabellen oder Abbildungen anwenden. Näheres zum +Unterschriften oder Ãœberschriften nicht mehr funktionieren, sobald Sie +\Macro{restylefloat} auf Tabellen oder Abbildungen anwenden. Näheres zum \Package{float}-Paket und \Macro{restylefloat} entnehmen Sie bitte -\cite{package:float}. Dies gilt ebenso für \DescRef{\LabelBase.cmd.caption} +\cite{package:float}. Dies gilt ebenso für \DescRef{\LabelBase.cmd.caption} innerhalb von neuen Gleitumgebungen, die mit \Package{float} definiert -wurden. Zusätzliche Unterstützung, die \KOMAScript{} bei Verwendung des -\Package{float}-Pakets bietet, finden Sie bei der Erklärung zu +wurden. Zusätzliche Unterstützung, die \KOMAScript{} bei Verwendung des +\Package{float}-Pakets bietet, finden Sie bei der Erklärung zu \PValue{komaabove} (siehe \DescPageRef{\LabelBase.floatstyle.komaabove}). Als Alternative zu \Package{float} sei auch die Verwendung von \DescRef{\LabelBase.cmd.captionof} (siehe \DescPageRef{\LabelBase.cmd.captionof}) und \DescRef{tocbasic.cmd.DeclareNewTOC} (siehe -\DescPageRef{tocbasic.cmd.DeclareNewTOC}) erwähnt. Darüber hinaus sei bei -Verwendung von \Package{float} ausdrücklich Paket +\DescPageRef{tocbasic.cmd.DeclareNewTOC}) erwähnt. Darüber hinaus sei bei +Verwendung von \Package{float} ausdrücklich Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% \important{\hyperref[cha:scrhack]{\Package{scrhack}}} (siehe \autoref{cha:scrhack} ab \autopageref{cha:scrhack} in \autoref{part:forExperts}) empfohlen. \leavevmode\LabelOptionValue{captions}{nooneline}\nobreak -Bei\important{\OptionValue{captions}{nooneline}} \KOMAScript{} besteht darüber -hinaus auch die Möglichkeit, mit der Einstellung +Bei\important{\OptionValue{captions}{nooneline}} \KOMAScript{} besteht darüber +hinaus auch die Möglichkeit, mit der Einstellung \OptionValue{captions}{nooneline}\IndexOption{captions~=\textKValue{nooneline}} -die Unterscheidung zwischen ein"~ und mehrzeiligen Über"~ bzw. Unterschriften +die Unterscheidung zwischen ein"~ und mehrzeiligen Ãœber"~ bzw. Unterschriften abzuschalten. Dies ist beispielsweise dann wichtig, wenn man keine Zentrierung -wünscht. Die\important{\OptionValue{captions}{oneline}}% +wünscht. Die\important{\OptionValue{captions}{oneline}}% \LabelOptionValue{captions}{oneline} -Voreinstellung\textnote{Voreinstellung}, bei der einzeilige Über"~ und +Voreinstellung\textnote{Voreinstellung}, bei der einzeilige Ãœber"~ und Unterschriften automatisch horizontal zentriert werden, entspricht der Einstellung \OptionValue{captions}{oneline}. Als Besonderheit bietet \KOMAScript{} innerhalb von Gleitumgebungen die -Möglichkeit, den Titel statt als Über"~ oder Unterschrift neben den +Möglichkeit, den Titel statt als Ãœber"~ oder Unterschrift neben den eigentlichen Inhalt zu setzen. Die\important{\DescRef{\LabelBase.env.captionbeside}} dazu notwendige Umgebung \DescRef{\LabelBase.env.captionbeside}\IndexEnv{captionbeside} ist ab -\DescPageRef{\LabelBase.env.captionbeside} erklärt. Die Einstellungen für -diese Umgebung können ebenfalls mit der Option \Option{captions} geändert -werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind +\DescPageRef{\LabelBase.env.captionbeside} erklärt. Die Einstellungen für +diese Umgebung können ebenfalls mit der Option \Option{captions} geändert +werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind \autoref{tab:maincls.captions} zu entnehmen. % \iffree{}{% Umbruchoptimierung!!!! \enlargethispage*{\dp\strutbox}}% \begin{desclist} - \desccaption[{Mögliche Werte für Option \Option{captions}}]{M% - ögliche Werte für Option \Option{captions} zur Einstellung der - Formatierung von Über"~ und Unterschriften in + \desccaption[{Mögliche Werte für Option \Option{captions}}]{M% + ögliche Werte für Option \Option{captions} zur Einstellung der + Formatierung von Ãœber"~ und Unterschriften in Gleitumgebungen\label{tab:maincls.captions}% }{% - Mögliche Werte für Option \Option{captions} (\emph{Fortsetzung})% + Mögliche Werte für Option \Option{captions} (\emph{Fortsetzung})% }% \entry{\PValue{bottombeside}, \PValue{besidebottom}}{% Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside} (siehe \autoref{sec:\LabelBase.floats}, \DescPageRef{\LabelBase.env.captionbeside}) werden mit der untersten - Grundlinie auf Höhe der untersten Grundlinie des Inhalts der Gleitumgebung + Grundlinie auf Höhe der untersten Grundlinie des Inhalts der Gleitumgebung ausgerichtet.% \IndexOption{captions~=\textKValue{bottombeside}}}% \entry{\PValue{centeredbeside}, \PValue{besidecentered}, @@ -3303,8 +3324,8 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind \ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% Bei Abbildungen wird (gegebenenfalls abweichend von - \OptionValue{captions}{signature}) die Formatierung als Überschrift - gewählt.}% + \OptionValue{captions}{signature}) die Formatierung als Ãœberschrift + gewählt.}% \entry{\PValue{figuresignature}, \PValue{figurebelow}, \PValue{belowfigure}, \PValue{bottomatfigure}% \IndexOption{captions~=\textKValue{figuresignature}}}{% @@ -3312,12 +3333,12 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind \Class{scrartcl}}% Bei Abbildungen wird (gegebenenfalls abweichend von \OptionValue{captions}{heading}) die Formatierung als Unterschrift - gewählt.}% + gewählt.}% \entry{\PValue{heading}, \PValue{above}, \PValue{top}% \IndexOption{captions~=\textKValue{heading}}}{% Gleitumgebungstitel\ChangedAt{v3.09}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} werden als Überschriften - formatiert. Dies hat jedoch keinen Einfluss darauf, ob sie über oder unter + \Class{scrreprt}\and \Class{scrartcl}} werden als Ãœberschriften + formatiert. Dies hat jedoch keinen Einfluss darauf, ob sie über oder unter der Gleitumgebung platziert werden. Die Option impliziert auch \OptionValue{captions}{tableheading} und \OptionValue{captions}{figureheading}.}% @@ -3336,11 +3357,11 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind \DescPageRef{\LabelBase.env.captionbeside}) werden in der Voreinstellung links neben dem Inhalt der Gleitumgebung gesetzt.}% \pventry{nooneline}{% - Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden nicht + Einzeilige Ãœber"~ und Unterschriften von Gleitumgebungen werden nicht gesondert, sondern genau wie mehrzeilige behandelt.% \IndexOption{captions~=\textKValue{nooneline}}}% \pventry{oneline}{% - Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden gesondert + Einzeilige Ãœber"~ und Unterschriften von Gleitumgebungen werden gesondert behandelt, um sie horizontal zu zentrieren.% \IndexOption{captions~=\textKValue{oneline}}}% \entry{\PValue{outerbeside}, \PValue{besideouter}% @@ -3348,7 +3369,7 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside} (siehe \autoref{sec:\LabelBase.floats}, \DescPageRef{\LabelBase.env.captionbeside}) werden bei doppelseitigem Satz - in der Voreinstellung außen neben dem Inhalt der Gleitumgebung + in der Voreinstellung außen neben dem Inhalt der Gleitumgebung gesetzt. Dies entspricht im einseitigen Satz \OptionValue{captions}{rightbeside}.}% \entry{\PValue{rightbeside}, \PValue{besideright}% @@ -3362,26 +3383,26 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind \ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% Gleitumgebungstitel werden als Unterschriften formatiert. Dies hat jedoch - keinen Einfluss darauf, ob sie über oder unter der Gleitumgebung platziert + keinen Einfluss darauf, ob sie über oder unter der Gleitumgebung platziert werden. Die Option impliziert auch \OptionValue{captions}{tablesignature} und \OptionValue{captions}{figuresignature}.}% \entry{\PValue{tableheading}, \PValue{tableabove}, \PValue{abovetable}, \PValue{abovetabular}, \PValue{topattable}% \IndexOption{captions~=\textKValue{tableheading}}}{% Bei Tabellen wird (gegebenenfalls abweichend von - \OptionValue{captions}{signature}) die Formatierung als Überschrift - gewählt.}% + \OptionValue{captions}{signature}) die Formatierung als Ãœberschrift + gewählt.}% \entry{\PValue{tablesignature}, \PValue{belowtable}, \PValue{belowtabular}, \PValue{bottomattable}% \IndexOption{captions~=\textKValue{tablesignature}}}{% Bei Tabellen wird (gegebenenfalls abweichend von \OptionValue{captions}{heading}) die Formatierung als Unterschrift - gewählt.}% + gewählt.}% \entry{\PValue{topbeside}, \PValue{besidetop}}{% Gleitumgebungstitel der Umgebung \DescRef{\LabelBase.env.captionbeside} (siehe \autoref{sec:\LabelBase.floats}, \DescPageRef{\LabelBase.env.captionbeside}) werden mit der obersten - Grundlinie auf Höhe der obersten Grundlinie des Inhalts der Gleitumgebung + Grundlinie auf Höhe der obersten Grundlinie des Inhalts der Gleitumgebung ausgerichtet.% \IndexOption{captions~=\textKValue{topbeside}}}% \end{desclist}% @@ -3397,30 +3418,30 @@ werden. Die dabei möglichen Werte für die jeweilige \PName{Einstellung} sind Tabellen und Abbildungen werden bei den Standardklassen mit Hilfe der Anweisung \Macro{caption} mit einem \PName{Titel} in Form einer Unterschrift\Index{Tabellen>Unterschrift} versehen. Bei Abbildungen ist dies -grundsätzlich korrekt. Bei Tabellen wird gestritten, ob der \PName{Titel} als -Überschrift über oder konsistent mit der -Bildunterschrift\Index{Bildunterschrift} unter die Tabelle gehört. Daher +grundsätzlich korrekt. Bei Tabellen wird gestritten, ob der \PName{Titel} als +Ãœberschrift über oder konsistent mit der +Bildunterschrift\Index{Bildunterschrift} unter die Tabelle gehört. Daher bietet \KOMAScript{}\textnote{\KOMAScript{} vs. Standardklassen} im -Gegensatz zu den Standardklassen die Anweisungen \Macro{captionbelow} für -\PName{Titel} in Form von Unterschriften und \Macro{captionabove} für -\PName{Titel} in Form von Überschriften. +Gegensatz zu den Standardklassen die Anweisungen \Macro{captionbelow} für +\PName{Titel} in Form von Unterschriften und \Macro{captionabove} für +\PName{Titel} in Form von Ãœberschriften. -Sowohl bei Tabellen als auch bei Abbildungen oder generell für alle -Gleitumgebungen lässt sich das Verhalten von \Macro{caption} mit der Option +Sowohl bei Tabellen als auch bei Abbildungen oder generell für alle +Gleitumgebungen lässt sich das Verhalten von \Macro{caption} mit der Option \DescRef{\LabelBase.option.captions}\IndexOption{captions} steuern, die am -Anfang dieses Abschnitts zu finden ist. Aus Gründen der Kompatibilität ist +Anfang dieses Abschnitts zu finden ist. Aus Gründen der Kompatibilität ist voreingestellt, dass sich \Macro{caption} bei allen Gleitumgebungen wie -\Macro{captionbelow} verhält. Es wird jedoch empfohlen\textnote{Tipp!}, -Tabellenüberschriften zu verwenden und auf die Formatierung mit +\Macro{captionbelow} verhält. Es wird jedoch empfohlen\textnote{Tipp!}, +Tabellenüberschriften zu verwenden und auf die Formatierung mit \OptionValueRef{\LabelBase}{captions}{tableheading} entsprechend umzustellen -oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. +oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. % \begin{Example} Sie wollen mit - Tabellenüberschriften\Index{Tabellen>Ueberschrift=Überschrift} statt mit - Tabellenunterschriften arbeiten, weil Sie teilweise Tabellen haben, die über + Tabellenüberschriften\Index{Tabellen>Ueberschrift=Ãœberschrift} statt mit + Tabellenunterschriften arbeiten, weil Sie teilweise Tabellen haben, die über mehr als eine Seite gehen. Mit den Standardklassen bliebe Ihnen nur die - Möglichkeit: + Möglichkeit: \begin{lstcode} \begin{table} \caption{Dies ist nur eine Beispieltabelle} @@ -3431,7 +3452,7 @@ oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. \end{tabular} \end{table} \end{lstcode} - Damit hätten Sie das unschöne Ergebnis: + Damit hätten Sie das unschöne Ergebnis: \begin{ShowOutput}\centering {\usekomafont{caption}{\usekomafont{captionlabel}\tablename~30.2:} Dies ist nur eine @@ -3453,7 +3474,7 @@ oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. \end{tabular} \end{table} \end{lstcode} - Sie erhalten dann das gewünschte Ergebnis: + Sie erhalten dann das gewünschte Ergebnis: \begin{ShowOutput}\centering {\usekomafont{caption}{\usekomafont{captionlabel}\tablename~30.2:} Dies ist nur eine @@ -3464,10 +3485,10 @@ oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. Inhalt & dieser & Tabelle & unbeachtet. \end{tabular} \end{ShowOutput} - Da Sie konsequent nicht nur eine, sondern alle Tabellen mit Überschriften - versehen, können Sie stattdessen auch die Option + Da Sie konsequent nicht nur eine, sondern alle Tabellen mit Ãœberschriften + versehen, können Sie stattdessen auch die Option \OptionValueRef{\LabelBase}{captions}{tableheading} setzen (siehe - \DescPageRef{\LabelBase.option.captions.tableheading}). Dann genügt es, + \DescPageRef{\LabelBase.option.captions.tableheading}). Dann genügt es, wenn Sie wie bei den Standardklassen \Macro{caption} verwenden. Sie erhalten trotzdem das Ergebnis von \Macro{captionabove}. \end{Example} @@ -3476,17 +3497,17 @@ oder bei Tabellen auf \Macro{captionabove} zurück zu greifen. \BeginIndex{FontElement}{caption}\LabelFontElement{caption}% \BeginIndex{FontElement}{captionlabel}\LabelFontElement{captionlabel}% Die Schriftart\ChangedAt{v2.8p}{% - \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} für die -Beschreibung und das Label~-- »Abbildung« oder »Tabelle«, gefolgt von der -Nummer und einem Trennzeichen -- kann über die Anweisungen + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} für die +Beschreibung und das Label~-- »Abbildung« oder »Tabelle«, gefolgt von der +Nummer und einem Trennzeichen -- kann über die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -verändert werden. Zuständig sind hier die Elemente \FontElement{caption}% +verändert werden. Zuständig sind hier die Elemente \FontElement{caption}% \important[i]{\FontElement{caption}\\\FontElement{captionlabel}} und \FontElement{captionlabel} (siehe \autoref{tab:maincls.fontelements}, -\autopageref{tab:maincls.fontelements}). Dabei wird die Schriftart für das -Element \FontElement{caption} zunächst auch auf das Element +\autopageref{tab:maincls.fontelements}). Dabei wird die Schriftart für das +Element \FontElement{caption} zunächst auch auf das Element \FontElement{captionlabel} angewandt, bevor dessen spezifische Schriftart Anwendung findet. Die Vorbelegungen sind \autoref{tab:maincls.captionFont} zu entnehmen. @@ -3497,12 +3518,12 @@ entnehmen. \KOMAoptions{captions=topbeside}% \setcapindent{0pt} \begin{captionbeside} - [{Schriftvoreinstellungen für die Elemente der Tabellen- + [{Schriftvoreinstellungen für die Elemente der Tabellen- oder\newline Abbildungsunterschrift - bzw. "~überschrift}] + bzw. "~überschrift}] {\label{tab:maincls.captionFont}% - Voreinstellungen der Schrift für die Elemente der Tabellen- - oder Abbildungsunterschrift bzw. "~überschrift} + Voreinstellungen der Schrift für die Elemente der Tabellen- + oder Abbildungsunterschrift bzw. "~überschrift} [l] \begin{tabular}[t]{ll} \toprule @@ -3518,17 +3539,17 @@ entnehmen. \begin{Example} Sie wollen, dass Tabellen- und Abbildungsbeschreibungen in einer kleineren Schriftart gesetzt werden. Also setzen Sie - beispielsweise in der Präambel Ihres Dokuments: + beispielsweise in der Präambel Ihres Dokuments: \begin{lstcode} \addtokomafont{caption}{\small} \end{lstcode} - Außerdem hätten Sie gerne, dass das Label serifenlos und fett - gedruckt wird. Sie setzen also außerdem: + Außerdem hätten Sie gerne, dass das Label serifenlos und fett + gedruckt wird. Sie setzen also außerdem: \begin{lstcode} \setkomafont{captionlabel}{\sffamily\bfseries} \end{lstcode} - Das Ergebnis wäre bei Verwendung von \DescRef{\LabelBase.cmd.addtokomafont} - in diesem Fall übrigens gleich. + Das Ergebnis wäre bei Verwendung von \DescRef{\LabelBase.cmd.addtokomafont} + in diesem Fall übrigens gleich. \end{Example}% \EndIndexGroup @@ -3541,25 +3562,25 @@ entnehmen. \Macro{captionbelowof}\Parameter{Objekttyp}\OParameter{Verzeichniseintrag} \Parameter{Titel} \end{Declaration} -Ähnlich wie die Pakete \Package{caption}\IndexPackage{caption} und +Ähnlich wie die Pakete \Package{caption}\IndexPackage{caption} und \Package{capt-of}\IndexPackage{capt-of} bietet auch \KOMAScript{} die Anweisung \Macro{captionof}\ChangedAt{v3.05}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} mit der man auch außerhalb einer + \Class{scrreprt}\and \Class{scrartcl}} mit der man auch außerhalb einer Gleitumgebung oder in einer fremden Gleitumgebung einen entsprechenden Titel mit Eintrag in das jeweilige Verzeichnis setzen kann. Dabei muss im Gegensatz -zu \DescRef{\LabelBase.cmd.caption} die Art des Gleitobjekts als zusätzliches +zu \DescRef{\LabelBase.cmd.caption} die Art des Gleitobjekts als zusätzliches erstes Argument angegeben werden. -Darüber hinaus bietet \KOMAScript{} zusätzlich auch die Anweisungen +Darüber hinaus bietet \KOMAScript{} zusätzlich auch die Anweisungen \Macro{captionaboveof}\ChangedAt{v3.09}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} und \Macro{captionbelowof}. Diese -dienen als Gegenstücke zu \DescRef{\LabelBase.cmd.captionabove} und +dienen als Gegenstücke zu \DescRef{\LabelBase.cmd.captionabove} und \DescRef{\LabelBase.cmd.captionbelow}. -Selbstverständlich berücksichtigt\ChangedAt{v3.09a}{\Class{scrbook}\and +Selbstverständlich berücksichtigt\ChangedAt{v3.09a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} \Macro{captionof} auch die -Einstellungen von Option \DescRef{\LabelBase.option.captions} bezüglich der -Formatierung des Titels als Über- oder Unterschrift. Diese Fähigkeit geht +Einstellungen von Option \DescRef{\LabelBase.option.captions} bezüglich der +Formatierung des Titels als Ãœber- oder Unterschrift. Diese Fähigkeit geht jedoch eventuell durch das Laden von Paketen wie \Package{capt-of}\IndexPackage{capt-of} oder \Package{caption}\IndexPackage{caption} verloren. Bei Verwendung von @@ -3568,7 +3589,7 @@ jedoch eventuell durch das Laden von Paketen wie \begin{Example} Angenommen, Sie wollen ein Gleitobjekt erstellen, bei dem eine Tabelle und eine Abbildung nebeneinander stehen. Da es keine gemischten Gleitobjekte gibt, - verwenden Sie primär eine \Environment{figure}-Umgebung: + verwenden Sie primär eine \Environment{figure}-Umgebung: \begin{lstcode} \begin{figure} \begin{minipage}{.5\linewidth} @@ -3579,13 +3600,13 @@ jedoch eventuell durch das Laden von Paketen wie \begin{minipage}{.5\linewidth} \centering \captionaboveof{table} - [Maße des Rechtecks aus + [Maße des Rechtecks aus Abbildung~\ref{fig:rechteck}]% - {Rechtecksmaße} + {Rechtecksmaße} \label{tab:rechteck} \begin{tabular}{ll} Breite: & 4\,cm\\ - Höhe: & 5\,cm + Höhe: & 5\,cm \end{tabular} \end{minipage} \end{figure} @@ -3593,22 +3614,22 @@ jedoch eventuell durch das Laden von Paketen wie Um Abbildung und Tabelle nebeneinander zu setzen, wurden zwei \Environment{minipage}-Umgebungen verwendet. Wichtig\textnote{Achtung!} ist hier das Prozentzeichen nach der ersten \Environment{minipage}, ohne das ein - zusätzlicher Wortabstand zwischen die beiden - \Environment{minipage}-Umgebungen gesetzt würde. + zusätzlicher Wortabstand zwischen die beiden + \Environment{minipage}-Umgebungen gesetzt würde. Die Abbildungsunterschrift wurde mit \DescRef{\LabelBase.cmd.caption} - gesetzt. Für die Tabellenüberschrift wurde \Macro{captionaboveof} - verwendet. Als erstes Argument wurde \PValue{table} angegeben. Dadurch weiß + gesetzt. Für die Tabellenüberschrift wurde \Macro{captionaboveof} + verwendet. Als erstes Argument wurde \PValue{table} angegeben. Dadurch weiß \KOMAScript{}, dass es sich trotz \Environment{figure}-Umgebung um eine - Tabellenüberschrift handelt. + Tabellenüberschrift handelt. Das optionale Argument von \Macro{captionaboveof} setzt den Eintrag in das - Tabellenverzeichnis. Ohne das optionale Argument würde der als letztes + Tabellenverzeichnis. Ohne das optionale Argument würde der als letztes Argument angegebene Titel ebenfalls in das Tabellenverzeichnis - geschrieben. Während dieser Titel im Gleitobjekt selbst völlig ausreichend - ist, wäre er jedoch im Tabellenverzeichnis wenig aussagekräftig. Daher wird - hier für das Verzeichnis ein abweichender Titel über das optionale Argument - verwendet. Das Ergebnis der Bemühungen zeigt + geschrieben. Während dieser Titel im Gleitobjekt selbst völlig ausreichend + ist, wäre er jedoch im Tabellenverzeichnis wenig aussagekräftig. Daher wird + hier für das Verzeichnis ein abweichender Titel über das optionale Argument + verwendet. Das Ergebnis der Bemühungen zeigt \autoref{fig:maincls.captionaboveof}.% % \begin{figure} @@ -3631,12 +3652,12 @@ jedoch eventuell durch das Laden von Paketen wie \end{minipage}% \begin{minipage}{.5\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax} \centering - \captionaboveof{table}[Beispiel: Maße des Rechtecks aus - Abbildung~\ref{fig:maincls.rechteck}]{Rechteckmaße} + \captionaboveof{table}[Beispiel: Maße des Rechtecks aus + Abbildung~\ref{fig:maincls.rechteck}]{Rechteckmaße} \label{tab:maincls.rechteck} \begin{tabular}{ll} Breite: & 4\,cm\\ - Höhe: & 5\,cm + Höhe: & 5\,cm \end{tabular} \end{minipage}}}% \end{minipage}% @@ -3644,12 +3665,12 @@ jedoch eventuell durch das Laden von Paketen wie \end{figure}% \end{Example}% In gleicher Weise, wie in obigem Beispiel eine Tabelle innerhalb einer -Abbildungsumgebung gesetzt und mit einem Titel versehen wird, könnte man auch -eine nicht gleitende Tabelle außerhalb jeder Gleitumgebung setzen. Auch dabei +Abbildungsumgebung gesetzt und mit einem Titel versehen wird, könnte man auch +eine nicht gleitende Tabelle außerhalb jeder Gleitumgebung setzen. Auch dabei sollte in der Regel eine \Environment{minipage} verwendet werden, um zu -verhindern, dass zwischen Überschrift und Tabelle ein Seitenumbruch erfolgen -kann. Zusätzlich sollte man die \Environment{minipage} dann noch in eine -\Environment{flushleft}-Umgebung einbetten, um einerseits einen gefälligen +verhindern, dass zwischen Ãœberschrift und Tabelle ein Seitenumbruch erfolgen +kann. Zusätzlich sollte man die \Environment{minipage} dann noch in eine +\Environment{flushleft}-Umgebung einbetten, um einerseits einen gefälligen Abstand zum Text davor und dahinter zu erreichen und andererseits den Absatzeinzug vor der \Environment{minipage} zu verhindern.% \EndIndexGroup @@ -3676,10 +3697,10 @@ Absatzeinzug vor der \Environment{minipage} zu verhindern.% \end{Declaration} Neben \ChangedAt{v2.8q}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -den Unter- und Überschriften findet man insbesondere bei kleineren Abbildungen -häufiger Beschreibungen, die neben der Abbildung gesetzt werden. Dabei -schließt normalerweise die Unterkante der Beschreibung mit der Unterkante der -Abbildung ab. Natürlich kann man mit etwas Geschick und beispielsweise zwei +den Unter- und Ãœberschriften findet man insbesondere bei kleineren Abbildungen +häufiger Beschreibungen, die neben der Abbildung gesetzt werden. Dabei +schließt normalerweise die Unterkante der Beschreibung mit der Unterkante der +Abbildung ab. Natürlich kann man mit etwas Geschick und beispielsweise zwei \Macro{parbox}-Anweisungen dergleichen auch in den Standardklassen erreichen. \KOMAScript{} bietet jedoch eine spezielle Umgebung. Diese Umgebung kann innerhalb der Gleitumgebungen verwendet werden. Der erste optionale @@ -3698,7 +3719,7 @@ werden. Es darf genau einer der folgenden Buchstaben angegeben werden: \item[\quad\PValue{r}] rechts \item[\quad\PValue{i}] innen: auf rechten Seiten links, auf linken Seiten rechts -\item[\quad\PValue{o}] außen: auf rechten Seiten rechts, auf +\item[\quad\PValue{o}] außen: auf rechten Seiten rechts, auf linken Seiten links \end{labeling} Voreingestellt ist rechts neben dem Inhalt der Umgebung. Diese @@ -3712,33 +3733,33 @@ Voreinstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \PValue{outerbeside}\IndexOption[indexmain]{captions~=\textKValue{outerbeside}} und \PValue{rightbeside}\IndexOption[indexmain]{captions~=\textKValue{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. +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\important{\PName{Breite}} nehmen der Inhalt der Umgebung und der -\PName{Titel} die gesamte verfügbare Breite ein. Es besteht jedoch die -Möglichkeit, mit dem optionalen Parameter \PName{Breite} eine andere Breite -anzugeben. Diese kann auch größer als die Breite des Textkörpers sein. +\PName{Titel} die gesamte verfügbare Breite ein. Es besteht jedoch die +Möglichkeit, mit dem optionalen Parameter \PName{Breite} eine andere Breite +anzugeben. Diese kann auch größer als die Breite des Textkörpers sein. Bei Angabe einer \PName{Breite}\important{\PName{Breite}\\\PName{Offset}} wird -die genutzte Breite normalerweise bezüglich der Breite des Textkörpers +die genutzte Breite normalerweise bezüglich der Breite des Textkörpers zentriert. Mit dem optionalen Argument \PName{Offset} kann stattdessen eine Verschiebung relativ zum linken Rand angegeben werden. Ein positiver Wert entspricht einer Verschiebung nach rechts, ein negativer Wert einer Verschiebung nach links. Mit einem \PName{Offset} von 0\Unit{pt} erfolgt die -Ausgabe linksbündig. +Ausgabe linksbündig. Wird\important{\PValue{*}} hinter den optionalen Parameter \PName{Offset} noch ein Stern gesetzt, so stellt der \PName{Offset} im doppelseitigen Druck auf linken Seiten eine Verschiebung relativ zum rechten Rand dar. Ein positiver -Wert entspricht dann einer Verschiebung nach außen, während ein negativer Wert -für eine Verschiebung nach innen steht. Ein \PName{Offset} von 0\Unit{pt} wäre -dann also bündig zum inneren Rand. Diese Variante benötigt unter Umständen -zwei \LaTeX-Durchläufe, um die korrekte Verschiebung zu erreichen. +Wert entspricht dann einer Verschiebung nach außen, während ein negativer Wert +für eine Verschiebung nach innen steht. Ein \PName{Offset} von 0\Unit{pt} wäre +dann also bündig zum inneren Rand. Diese Variante benötigt unter Umständen +zwei \LaTeX-Durchläufe, um die korrekte Verschiebung zu erreichen. Vertikal erfolgt die Ausrichtung in der Voreinstellung unten. Das bedeutet, dass die untere Grundlinie des Inhalts des Gleitobjekts und die untere -Grundlinie von \PName{Titel} auf einer Höhe liegen. Diese +Grundlinie von \PName{Titel} auf einer Höhe liegen. Diese Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} kann mit der Option \DescRef{\LabelBase.option.captions}\IndexOption{captions}% @@ -3748,15 +3769,15 @@ Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \PValue{centeredbeside}% \IndexOption[indexmain]{captions~=\textKValue{centeredbeside}} und \PValue{bottombeside}\IndexOption[indexmain]{captions~=\textKValue{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 +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. +Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \begin{Example} - Ein Beispiel für die Verwendung der + Ein Beispiel für die Verwendung der \Environment{captionbeside}-""Umgebung ist in \autoref{fig:maincls.captionbeside} zu finden. Gesetzt wurde diese Abbildung mit: @@ -3764,7 +3785,7 @@ Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \begin{figure} \begin{captionbeside}% [Beispiel: Bildbeschreibung daneben, unten]% - {Eine Bildbeschreibung weder über noch unter + {Eine Bildbeschreibung weder über noch unter der Abbildung, sondern unten daneben}% [i][\linewidth][% \dimexpr\marginparwidth+\marginparsep\relax]* @@ -3781,19 +3802,19 @@ Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \end{lstcode} \begin{figure} \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, unten]% - {Eine Bildbeschreibung weder über noch unter der Abbildung, + {Eine Bildbeschreibung weder über noch unter der Abbildung, sondern unten daneben}[i][\linewidth] \fbox{\parbox[b][5\baselineskip][c]{.25\textwidth}{% \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}} \end{captionbeside} \label{fig:maincls.captionbeside} \end{figure} - Die Gesamtbreite ist also die aktuell verfügbare Breite + Die Gesamtbreite ist also die aktuell verfügbare Breite \PValue{\Macro{linewidth}}. Diese wird jedoch um $\Length{marginparwidth} + \Length{marginparsep}$ nach - außen verschoben. Der Titel oder die Beschreibung steht innen neben + außen verschoben. Der Titel oder die Beschreibung steht innen neben der Abbildung. Damit erscheint die Abbildung selbst bis in die - Marginalienspalte in den Rand gerückt. + Marginalienspalte in den Rand gerückt. \iffalse% Umbruchkorrekturtext Mit \Macro{dimexpr} wird hier eine \eTeX-Anweisung verwendet, da @@ -3807,16 +3828,16 @@ Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \end{lstcode} zeigt \autoref{fig:maincls.captionbesidecentered}. % \iffalse % Umbruchalternativen - Auch der typografisch weniger bewanderte Anfänger wird sofort + 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.% + Das ist jedoch sicher keine empfehlswerte Lösung.% \fi \begin{figure} \KOMAoption{captions}{centeredbeside} \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, mittig]% - {Eine Bildbeschreibung weder über noch unter der Abbildung, + {Eine Bildbeschreibung weder über noch unter der Abbildung, sondern mittig daneben}[i][\linewidth] \fbox{\parbox[b][5\baselineskip][c]{.25\textwidth}{% \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}} @@ -3824,7 +3845,7 @@ Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \label{fig:maincls.captionbesidecentered} \end{figure} - Demgegenüber kann die Ausrichtung oben, die bei + Demgegenüber kann die Ausrichtung oben, die bei \autoref{fig:maincls.captionbesidetop} zu sehen ist, durchaus verwendet werden. Zur Verdeutlichung, wie man \Macro{raisebox} zur Verschiebung der Grundlinie nutzen kann, sei hier ein komplettes Beispiel angegeben. Eine @@ -3858,7 +3879,7 @@ Anweisung \Macro{raisebox}\IndexCmd{raisebox} verändert werden. \begin{figure} \KOMAoption{captions}{topbeside} \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, oben]% - {Eine Bildbeschreibung weder über noch unter der Abbildung, + {Eine Bildbeschreibung weder über noch unter der Abbildung, sondern oben daneben}[i][\linewidth] \raisebox{\dimexpr\baselineskip-\totalheight}{% \fbox{% @@ -3902,7 +3923,7 @@ dieses Typs bestimmt wird, so gibt es passend zur Umgebung \DescRef{\LabelBase.env.captionbeside} mit \Environment{captionofbeside} auch eine entsprechende Umgebung. Im Unterschied zu \DescRef{\LabelBase.env.captionbeside} ist auch hier der \PName{Objekttyp} als -zusätzliches, erstes Argument anzugeben.% +zusätzliches, erstes Argument anzugeben.% % \EndIndexGroup @@ -3913,17 +3934,17 @@ zusätzliches, erstes Argument anzugeben.% Bei\OnlyAt{\Package{float}} Verwendung des \Package{float}-Pakets\IndexPackage{float} wird das Aussehen der damit definierten Gleitumgebungen allein vom \emph{float}-Stil bestimmt. Dies -schließt auch die Frage ein, ob mit Überschriften oder Unterschriften +schließt auch die Frage ein, ob mit Ãœberschriften oder Unterschriften gearbeitet wird. Im \Package{float}-Paket gibt es keinen vordefinierten Stil, der im Aussehen dem von \KOMAScript{} entspricht und dieselben -Einstellmöglichkeiten (siehe unten) bietet. \KOMAScript{} definiert deshalb -zusätzlich die beiden Stile \PValue{komaabove} und \PValue{komabelow}. Diese -können bei Verwendung des \Package{float}-Pakets wie die dort definierten +Einstellmöglichkeiten (siehe unten) bietet. \KOMAScript{} definiert deshalb +zusätzlich die beiden Stile \PValue{komaabove} und \PValue{komabelow}. Diese +können bei Verwendung des \Package{float}-Pakets wie die dort definierten Stile \PValue{plain}\IndexFloatstyle{plain}, \PValue{boxed}\IndexFloatstyle{boxed} oder \PValue{ruled}\IndexFloatstyle{ruled} aktiviert werden. Siehe dazu \cite{package:float}. Beim Stil \PValue{komaabove} werden \DescRef{\LabelBase.cmd.caption}, -\DescRef{\LabelBase.cmd.captionabove} und \DescRef{\LabelBase.cmd.captionbelow} als Überschrift, beim Stil +\DescRef{\LabelBase.cmd.captionabove} und \DescRef{\LabelBase.cmd.captionbelow} als Ãœberschrift, beim Stil \PValue{komabelow} als Unterschrift gesetzt.% % \EndIndexGroup @@ -3932,27 +3953,27 @@ Stile \PValue{plain}\IndexFloatstyle{plain}, \begin{Declaration} \Macro{captionformat} \end{Declaration}% -Bei {\KOMAScript} gibt es verschiedene Eingriffsmöglichkeiten, um die -Formatierung der Beschreibung zu ändern. Die Änderung der Schriftart -wurde bereits erläutert. Das oder die Trennzeichen zwischen dem Label +Bei {\KOMAScript} gibt es verschiedene Eingriffsmöglichkeiten, um die +Formatierung der Beschreibung zu ändern. Die Änderung der Schriftart +wurde bereits erläutert. Das oder die Trennzeichen zwischen dem Label und dem eigentlichen Beschreibungstext sind im Makro \Macro{captionformat} abgelegt. Abweichend von allen anderen -\Macro{\dots}format-Anweisungen ist hier also nicht der Zähler, -sondern nur die auf den Zähler folgenden Angaben enthalten. Die +\Macro{\dots}format-Anweisungen ist hier also nicht der Zähler, +sondern nur die auf den Zähler folgenden Angaben enthalten. Die Originaldefinition lautet: \begin{lstcode} \newcommand*{\captionformat}{:\ } \end{lstcode} -Auch diese kann mit \Macro{renewcommand} geändert werden. +Auch diese kann mit \Macro{renewcommand} geändert werden. \begin{Example} - Aus mir unerfindlichen Gründen wollen Sie als Trennzeichen + Aus mir unerfindlichen Gründen wollen Sie als Trennzeichen keinen Doppelpunkt, gefolgt von einem Leerzeichen, sondern einen - Gedankenstrich einschließlich der notwendigen Leerzeichen. + Gedankenstrich einschließlich der notwendigen Leerzeichen. Daher definieren Sie: \begin{lstcode} \renewcommand*{\captionformat}{~--~} \end{lstcode} - Diese Definition sollten Sie beispielsweise in die Präambel Ihres + Diese Definition sollten Sie beispielsweise in die Präambel Ihres Dokuments stellen. \end{Example} % @@ -3964,10 +3985,10 @@ Auch diese kann mit \Macro{renewcommand} geändert werden. \Macro{tableformat} \end{Declaration}% Es wurde schon darauf hingewiesen, dass \DescRef{\LabelBase.cmd.captionformat} -keine Formatierung für das Label selbst enthält. Dieses sollte nun keineswegs -über Umdefinierung der Anweisungen für die Zählerausgabe, \Macro{thefigure} -oder \Macro{thetable}, verändert werden. Eine solche Umdefinierung hätte -nämlich auch Auswirkungen auf die Ausgabe von \Macro{ref} oder der +keine Formatierung für das Label selbst enthält. Dieses sollte nun keineswegs +über Umdefinierung der Anweisungen für die Zählerausgabe, \Macro{thefigure} +oder \Macro{thetable}, verändert werden. Eine solche Umdefinierung hätte +nämlich auch Auswirkungen auf die Ausgabe von \Macro{ref} oder der Verzeichnisse. Stattdessen bietet {\KOMAScript} auch hier zwei \Macro{\dots format}-Anweisungen. Diese sind wie folgt vordefiniert: % Umbruchkorrektur: listings @@ -3975,19 +3996,19 @@ Verzeichnisse. Stattdessen bietet {\KOMAScript} auch hier zwei \Macro{\dots \newcommand*{\figureformat}{\figurename~\thefigure\autodot} \newcommand*{\tableformat}{\tablename~\thetable\autodot} \end{lstcode} -Sie können ebenfalls mit \Macro{renewcommand} eigenen Anforderungen +Sie können ebenfalls mit \Macro{renewcommand} eigenen Anforderungen angepasst werden. \begin{Example} - Hin und wieder wird gewünscht, dass die Beschreibungstexte ganz ohne - Label und natürlich auch ohne Trennzeichen ausgegeben werden. Bei - {\KOMAScript} genügen folgende Definitionen, um dies zu erreichen: + Hin und wieder wird gewünscht, dass die Beschreibungstexte ganz ohne + Label und natürlich auch ohne Trennzeichen ausgegeben werden. Bei + {\KOMAScript} genügen folgende Definitionen, um dies zu erreichen: \begin{lstcode} \renewcommand*{\figureformat}{} \renewcommand*{\tableformat}{} \renewcommand*{\captionformat}{} \end{lstcode} Dabei ist jedoch zu beachten, dass die Nummerierung damit zwar nicht - ausgegeben, aber dennoch fortgezählt wird. Dies ist insbesondere dann + ausgegeben, aber dennoch fortgezählt wird. Dies ist insbesondere dann von Bedeutung, wenn die Umdefinierungen nur auf einzelne \Environment{figure}- oder \Environment{table}-Umgebungen angewendet werden. @@ -4001,32 +4022,32 @@ angepasst werden. \Macro{setcapindent*}\Parameter{XEinzug} \Macro{setcaphanging} \end{Declaration}% -Wie bereits erwähnt wurde, werden in den +Wie bereits erwähnt wurde, werden in den Standardklassen\textnote{\KOMAScript{} vs. Standardklassen} die -Beschreibungen nicht hängend gesetzt. Das heißt: In mehrzeiligen +Beschreibungen nicht hängend gesetzt. Das heißt: In mehrzeiligen Beschreibungen beginnt die zweite Zeile direkt unter dem Labeltext. Es gibt bei den Standardklassen auch keinen Mechanismus, dies direkt zu beeinflussen. Bei {\KOMAScript} werden hingegen alle Zeilen ab der -zweiten so weit eingerückt, dass diese nicht mehr unter dem Label, -»Abbildung~\dots:« oder »Tabelle~\dots:«, sondern unter dem +zweiten so weit eingerückt, dass diese nicht mehr unter dem Label, +»Abbildung~\dots:« oder »Tabelle~\dots:«, sondern unter dem eigentlichen Text der ersten Zeile beginnen. Dieses Verhalten, das der Verwendung von \Macro{setcaphanging} entspricht, kann bei {\KOMAScript} jederzeit durch Verwendung der Anweisung -\Macro{setcapindent} oder \Macro{setcapindent*} geändert werden. Dabei gibt -der Parameter \PName{Einzug} an, wie weit ab der zweiten Zeile eingerückt +\Macro{setcapindent} oder \Macro{setcapindent*} geändert werden. Dabei gibt +der Parameter \PName{Einzug} an, wie weit ab der zweiten Zeile eingerückt werden soll. Soll nach dem Label und vor dem Beschreibungstext noch ein -Zeilenumbruch erfolgen, so definieren Sie die Einrücktiefe \PName{XEinzug} der +Zeilenumbruch erfolgen, so definieren Sie die Einrücktiefe \PName{XEinzug} der Beschreibung stattdessen mit der Sternvariante der Anweisung: \Macro{setcapindent*}. Mit einem negativen \PName{Einzug} erreicht man hingegen, dass vor der Beschreibung ebenfalls ein Umbruch erfolgt und nur die erste Zeile der Beschreibung, nicht jedoch die folgenden, um den Betrag von \PName{Einzug} -eingerückt werden. +eingerückt werden. Ob einzeilige Beschreibungen wie mehrzeilige Beschreibungen gesetzt werden -oder eine Sonderbehandlung erfahren, wird über die Option -\DescRef{\LabelBase.option.captions} gewählt. Siehe hierzu die Erklärung zu +oder eine Sonderbehandlung erfahren, wird über die Option +\DescRef{\LabelBase.option.captions} gewählt. Siehe hierzu die Erklärung zu den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf \DescPageRef{\LabelBase.option.captions.oneline}. @@ -4034,7 +4055,7 @@ den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf Die Abbildungen~\ref{fig:maincls.caption.first} bis \ref{fig:maincls.caption.last} zeigen die Auswirkungen unterschiedlicher Einstellungen. Dabei wird deutlich, dass bei geringer Spaltenbreite der - komplett hängende Einzug unvorteilhaft ist. Der Quelltext der zweiten + komplett hängende Einzug unvorteilhaft ist. Der Quelltext der zweiten Abbildung sei hier mit abgewandelter Unterschrift beispielhaft wiedergegeben: \begin{lstcode} @@ -4042,16 +4063,16 @@ den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf \setcapindent{1em} \fbox{\parbox{.95\linewidth}{% \centering\KOMAScript}} - \caption{Beispiel mit teilweise hängendem Einzug + \caption{Beispiel mit teilweise hängendem Einzug ab der zweiten Zeile} \end{figure} \end{lstcode} Wie zu sehen ist, kann die Formatierung also auch lokal innerhalb - der \Environment{figure}-Umgebung\IndexEnv{figure} geändert werden. Die - Änderung gilt dann nur für die eine Abbildung. Nachfolgende Abbildungen + der \Environment{figure}-Umgebung\IndexEnv{figure} geändert werden. Die + Änderung gilt dann nur für die eine Abbildung. Nachfolgende Abbildungen werden wieder mit den Grundeinstellungen oder den globalen Einstellungen, - die Sie beispielsweise in der Dokumentpräambel vorgenommen haben, - gesetzt. Das gilt für Tabellen natürlich genauso. + die Sie beispielsweise in der Dokumentpräambel vorgenommen haben, + gesetzt. Das gilt für Tabellen natürlich genauso. \begin{figure} \typeout{^^J--- Ignore underfull and overfull \string\hbox:} \addtokomafont{caption}{\small} @@ -4069,8 +4090,8 @@ den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf \begin{minipage}[t]{.48\linewidth}\sloppy \setcapindent{1em} \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} - \caption[Beispiel: Bildunterschrift mit teilweise hängendem Einzug]% - {Mit teilweise häng"-endem Einzug ab der zweiten Zeile durch + \caption[Beispiel: Bildunterschrift mit teilweise hängendem Einzug]% + {Mit teilweise häng"-endem Einzug ab der zweiten Zeile durch Verwendung von \Macro{setcapindent}\PParameter{1em}} \end{minipage} \end{minipage} @@ -4080,8 +4101,8 @@ den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf \begin{minipage}[t]{.48\linewidth}\sloppy \setcapindent*{1em} \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} - \caption[Beispiel: Bildunterschrift mit hängendem Einzug und Umbruch]% - {Mit hängendem Einzug ab der zweiten Zeile und Umbruch vor + \caption[Beispiel: Bildunterschrift mit hängendem Einzug und Umbruch]% + {Mit hängendem Einzug ab der zweiten Zeile und Umbruch vor der Beschreibung durch Verwendung von \Macro{setcapindent*}\PParameter{1em}} \end{minipage} @@ -4113,29 +4134,29 @@ den Werten \PValue{oneline} und \PValue{nooneline} dieser Option auf Mit \ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Hilfe dieser drei Befehle kann die Breite und Anordnung der Beschreibung beeinflusst werden. Normalerweise steht die gesamte Text- -oder Spaltenbreite für den Text der Beschreibung zur Verfügung. +oder Spaltenbreite für den Text der Beschreibung zur Verfügung. Mit\important{\Macro{setcapwidth}} der Anweisung \Macro{setcapwidth} kann diese \PName{Breite} reduziert werden. Dabei gibt das obligatorische Argument -die maximale für die Beschreibung verwendete \PName{Breite} an. Als optionales -Argument kann genau ein Buchstabe übergeben werden, der die horizontale -Ausrichtung der Beschreibung angibt. Die möglichen Ausrichtungen finden Sie in +die maximale für die Beschreibung verwendete \PName{Breite} an. Als optionales +Argument kann genau ein Buchstabe übergeben werden, der die horizontale +Ausrichtung der Beschreibung angibt. Die möglichen Ausrichtungen finden Sie in der folgenden Liste. \begin{labeling}[~--]{\quad\PValue{o}}% \itemsep=.5\topsep plus .5\topsep minus .5\topsep \rightskip=1em -\item[\quad\PValue{l}] linksbündig +\item[\quad\PValue{l}] linksbündig \item[\quad\PValue{c}] zentriert -\item[\quad\PValue{r}] rechtsbündig -\item[\quad\PValue{i}] innen: auf rechten Seiten linksbündig, auf - linken Seiten rechtsbündig -\item[\quad\PValue{o}] außen: auf rechten Seiten rechtsbündig, auf - linken Seiten linksbündig +\item[\quad\PValue{r}] rechtsbündig +\item[\quad\PValue{i}] innen: auf rechten Seiten linksbündig, auf + linken Seiten rechtsbündig +\item[\quad\PValue{o}] außen: auf rechten Seiten rechtsbündig, auf + linken Seiten linksbündig \end{labeling} -Die Ausrichtung innen und außen entspricht im einseitigen Satz linksbündig und -rechtsbündig. Innerhalb\textnote{Achtung!} von +Die Ausrichtung innen und außen entspricht im einseitigen Satz linksbündig und +rechtsbündig. Innerhalb\textnote{Achtung!} von \Package{longtable}\IndexPackage{longtable}-Tabellen% -\important{\Package{longtable}} funktioniert die Ausrichtung innen und außen +\important{\Package{longtable}} funktioniert die Ausrichtung innen und außen nicht korrekt. Insbesondere werden Beschreibungen von Folgeseiten bei diesen Tabellen immer nach den Beschreibungen der ersten Teiltabelle ausgerichtet. Dies ist ein konzeptionelles Problem des Pakets @@ -4143,18 +4164,18 @@ ausgerichtet. Dies ist ein konzeptionelles Problem des Pakets Zu\ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}\textnote{Achtung!} beachten ist, dass die an -\Macro{setcapwidth} übergebene \PName{Breite} wie bei \Macro{setlength} zum +\Macro{setcapwidth} übergebene \PName{Breite} wie bei \Macro{setlength} zum Zeitpunkt der Zuweisung ausgewertet wird. Will\important{\Macro{setcapdynwidth}} man hingegen, dass \PName{Breite} erst bei der Verwendung ausgewertet wird, dann sollte man stattdessen \Macro{setcapdynwidth} verwenden. Entscheidende Unterschiede gibt es -beispielsweise, wenn Längen wie \Length{linewidth} oder andere Anweisungen als +beispielsweise, wenn Längen wie \Length{linewidth} oder andere Anweisungen als Argument verwendet werden. Mit\important{\Macro{setcapmargin}} der Anweisung \Macro{setcapmargin} kann statt der Breite der Beschreibung ein \PName{Rand} angegeben werden, der neben -der Beschreibung zusätzlich zum normalen Textrand eingehalten werden soll. -Sollen der Rand rechts und links nicht identisch gewählt werden, kann mit dem +der Beschreibung zusätzlich zum normalen Textrand eingehalten werden soll. +Sollen der Rand rechts und links nicht identisch gewählt werden, kann mit dem optionalen Argument ein von \PName{Rand} abweichender \PName{Rand \kern-.25em links} von der Beschreibung eingestellt werden. Bei\important{\Macro{setcapmargin*}} der Sternvariante @@ -4163,19 +4184,19 @@ doppelseitigen Satz \PName{Rand \kern-.25em innen} abweichend definiert. Hier\textnote{Achtung!} ergibt sich bei \Package{longtable}\IndexPackage{longtable}-Tabellen% \important{\Package{longtable}} das gleiche Problem wie bei der Ausrichtung -außen oder innen bei der Anweisung \Macro{setcapwidth}. Die Verwendung von -\Macro{setcapmargin} oder \Macro{setcapmargin*} aktiviert außerdem +außen oder innen bei der Anweisung \Macro{setcapwidth}. Die Verwendung von +\Macro{setcapmargin} oder \Macro{setcapmargin*} aktiviert außerdem \OptionValueRef{\LabelBase}{captions}{nooneline} (siehe -\DescPageRef{\LabelBase.option.captions.nooneline}) für die Beschreibungen, +\DescPageRef{\LabelBase.option.captions.nooneline}) für die Beschreibungen, die mit dieser Randeinstellung gesetzt werden. -Man\textnote{Tipp!} kann übrigens auch negative Werte für \PName{Rand} und -\PName{Rand \kern-.25em rechts} oder \PName{Rand \kern-.25em außen} +Man\textnote{Tipp!} kann übrigens auch negative Werte für \PName{Rand} und +\PName{Rand \kern-.25em rechts} oder \PName{Rand \kern-.25em außen} angeben. Dadurch erreicht man, dass die Beschreibung in den entsprechenden Rand hineinragt.% \iffalse\par% Anhang wurde entfernt. -Für\textnote{Tipp!} Experten und versierte Anwender ist eine etwas -trickreiche Anwendung für \Macro{setcapwidth} in +Für\textnote{Tipp!} Experten und versierte Anwender ist eine etwas +trickreiche Anwendung für \Macro{setcapwidth} in \iffree{\cite{book:komascript}}{\autoref{cha:floattricks}, \autopageref{cha:floattricks}} zu finden.% \fi% @@ -4189,9 +4210,9 @@ Normalerweise\ChangedAt{v3.25}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} werden mehrzeilige\textnote{Ausrichtung mehrzeiliger Beschreibungen} Beschreibungen im Blocksatz gesetzt. Dies entspricht \Macro{setcaptionalignment}\PParameter{j}. Manchmal wird allerdings eine davon -abweichende Ausrichtung gewünscht, beispielsweise linksbündiger -Flattersatz. Eine entsprechende Änderung ist mit \Macro{setcaptionalignment} -jederzeit möglich. Für \PName{Ausrichtung} kann dabei genau einer der +abweichende Ausrichtung gewünscht, beispielsweise linksbündiger +Flattersatz. Eine entsprechende Änderung ist mit \Macro{setcaptionalignment} +jederzeit möglich. Für \PName{Ausrichtung} kann dabei genau einer der Buchstaben aus \autoref{tab:maincls.captionalignment} angegeben werden. Wird eine unbekannte \PName{Ausrichtung} angegeben, so resultiert dies in einer Fehlermeldung. @@ -4201,53 +4222,53 @@ Fehlermeldung. \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside} - [{Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen}] + [{Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen}] {\label{tab:maincls.captionalignment}% - Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen} + Ausrichtungen für mehrzeilige Beschreibungen von Gleitumgebungen} [l] \begin{tabular}[t]{ll} \toprule c & zentriert \\ j & Blocksatz \\ - l & linksbündig \\ - r & rechtsbündig \\ + l & linksbündig \\ + r & rechtsbündig \\ C & zentriert mit \Package{ragged2e} \\ J & Blocksatz mit \Package{ragged2e} \\ - L & linksbündig mit \Package{ragged2e} \\ - R & rechtsbündig mit \Package{ragged2e} \\ + L & linksbündig mit \Package{ragged2e} \\ + R & rechtsbündig mit \Package{ragged2e} \\ \bottomrule \end{tabular} \end{captionbeside} \end{table} -Die vier Möglichkeiten mit Paket +Die vier Möglichkeiten mit Paket \Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e} stehen -nur zur Verfügung, wenn das Paket vor Verwendung von +nur zur Verfügung, wenn das Paket vor Verwendung von \Macro{setcaptionalignment} geladen wurde. Anderenfalls werden sie auf die -entsprechenden Möglichkeiten ohne \Package{ragged2e} abgebildet. Zur +entsprechenden Möglichkeiten ohne \Package{ragged2e} abgebildet. Zur Sicherheit wird in diesem Fall eine Warnung ausgegeben. Verwendet man den Befehl ohne\textnote{kein optionaler Parameter} den -optionalen Parameter, so hängt das Ergebnis davon ab, ob der Aufruf innerhalb -oder außerhalb einer Gleitumgebung stattfindet. Innerhalb einer Gleitumgebung -wird dann die Ausrichtung für diese Gleitumgebung gesetzt. Außerhalb wird +optionalen Parameter, so hängt das Ergebnis davon ab, ob der Aufruf innerhalb +oder außerhalb einer Gleitumgebung stattfindet. Innerhalb einer Gleitumgebung +wird dann die Ausrichtung für diese Gleitumgebung gesetzt. Außerhalb wird hingegen ein leerer optionaler Parameter angenommen. Beim Aufruf mit einem leeren\textnote{leerer optionaler Parameter} optionalen -Parameter oder außerhalb einer Gleitumgebung auch komplett ohne optionalen +Parameter oder außerhalb einer Gleitumgebung auch komplett ohne optionalen Parameter wird die allgemeine Ausrichtung festgelegt. Diese wird immer dann -verwendet, wenn keine Ausrichtung für den aktuellen Gleitumgebungstyp +verwendet, wenn keine Ausrichtung für den aktuellen Gleitumgebungstyp definiert ist. Will man nur die Ausrichtung eines bestimmen Typs\textnote{mit \PName{Gleitumgebung}} von Gleitumgebungen festlegen, ohne -\PName{Ausrichtung} auch für andere Arten von Gleitumgebungen zu verändern, so +\PName{Ausrichtung} auch für andere Arten von Gleitumgebungen zu verändern, so gibt man den Typ der Gleitumgebung, beispielsweise \PValue{figure} oder \PValue{table}, als optionalen Parameter \PName{Gleitumgebung} an. % \begin{Example} - Sie wollen, dass Bildunterschriften auch dann vollständig zentriert unter - den Bildern stehen, wenn sie mehrzeilig sind. Um das zunächst einmal nur für + Sie wollen, dass Bildunterschriften auch dann vollständig zentriert unter + den Bildern stehen, wenn sie mehrzeilig sind. Um das zunächst einmal nur für eine einzige Abbildung zu testen, verwenden Sie\textnote{in der Gleitumgebung}: \begin{lstcode} @@ -4259,42 +4280,42 @@ gibt man den Typ der Gleitumgebung, beispielsweise \PValue{figure} oder \end{figure} \end{lstcode} Da Sie mit dem Ergebnis zufrieden sind, verschieben Sie die - Anweisung\textnote{in der Dokumentpräambel} + Anweisung\textnote{in der Dokumentpräambel} \begin{lstcode} \setcaptionalignment{c} \end{lstcode} - in die Dokumentpräambel. Daraufhin bemerken Sie allerdings, dass Ihnen - diese Änderung für Tabellenüberschriften überhaupt nicht gefällt. Daher - beschränken Sie mit\textnote{nur für Abbildungen} + in die Dokumentpräambel. Daraufhin bemerken Sie allerdings, dass Ihnen + diese Änderung für Tabellenüberschriften überhaupt nicht gefällt. Daher + beschränken Sie mit\textnote{nur für Abbildungen} \begin{lstcode} \setcaptionalignment[figure]{c} \end{lstcode} die Zentrierung auf Abbildungen. - Etwas später stellen Sie fest, dass die Zentrierung doch nicht so günstig - ist. Stattdessen wollen Sie nun lieber eine linksbündige Ausrichtung im - Flattersatz haben. Also ändern Sie die Anweisung erneut zu: + Etwas später stellen Sie fest, dass die Zentrierung doch nicht so günstig + ist. Stattdessen wollen Sie nun lieber eine linksbündige Ausrichtung im + Flattersatz haben. Also ändern Sie die Anweisung erneut zu: \begin{lstcode} \setcaptionalignment[figure]{l} \end{lstcode} - Allerdings gefällt Ihnen nun nicht, dass die Zeilen sehr unterschiedlich + Allerdings gefällt Ihnen nun nicht, dass die Zeilen sehr unterschiedlich lang werden. Als Ursache machen Sie die fehlende Trennung aus, wodurch lange - Wörter komplett in die nächste Zeile rutschen und so große Lücken - hinterlassen. Also wollen Sie zusätzlich Trennung nach Bedarf - ermöglichen. Dies ist mit Hilfe des Pakets + Wörter komplett in die nächste Zeile rutschen und so große Lücken + hinterlassen. Also wollen Sie zusätzlich Trennung nach Bedarf + ermöglichen. Dies ist mit Hilfe des Pakets \Package{ragged2e}\important{\Package{ragged2e}}\IndexPackage{ragged2e} - leicht möglich. Dabei genügt es allerdings nicht, das Paket mit + leicht möglich. Dabei genügt es allerdings nicht, das Paket mit \begin{lstcode} \usepackage{ragged2e} \end{lstcode} zu laden. Auch Option \Option{newcommands} beim Laden des Pakets bringt - keine Abhilfe. Stattdessen muss zusätzlich die \PName{Ausrichtung} geändert + keine Abhilfe. Stattdessen muss zusätzlich die \PName{Ausrichtung} geändert werden: \begin{lstcode} \usepackage{ragged2e} \setcaptionalignment[figure]{L} \end{lstcode} - Beachten\textnote{Achtung!} Sie den Großbuchstabe für \PName{Ausrichtung}. + Beachten\textnote{Achtung!} Sie den Großbuchstabe für \PName{Ausrichtung}. \end{Example} \EndIndexGroup @@ -4303,13 +4324,13 @@ gibt man den Typ der Gleitumgebung, beispielsweise \PValue{figure} oder \Option{origlongtable} \end{Declaration}% \BeginIndex{Package}{longtable}% -Falls die Tabellenüberschriften des \Package{longtable}-Pakets (siehe +Falls die Tabellenüberschriften des \Package{longtable}-Pakets (siehe \cite{package:longtable}) von den \KOMAScript-Klassen nicht umdefiniert werden sollen, kann die Option \Option{origlongtable} gesetzt werden. Diese Option\textnote{Achtung!} ist als optionales Argument von \DescRef{\LabelBase.cmd.documentclass} zu verwenden. Eine Einstellung per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} -wird nicht unterstützt. +wird nicht unterstützt. % \EndIndexGroup % @@ -4324,7 +4345,7 @@ Normalerweise\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and Tabellen"~\Index{Tabellen>Verzeichnis} und das Abbildungsverzeichnis\Index{Abbildungen>Verzeichnis}~-- nicht nummeriert oder in das Inhaltsverzeichnis aufgenommen. In \autoref{sec:\LabelBase.toc} wurde -dies bereits näher ausgeführt. Alternativ zu den dort erwähnten Einstellungen +dies bereits näher ausgeführt. Alternativ zu den dort erwähnten Einstellungen \OptionValueRef{\LabelBase}{toc}{nolistof}% \IndexOption{toc~=\textKValue{nolistof}}, \OptionValueRef{\LabelBase}{toc}{listof}\IndexOption{toc~=\textKValue{listof}} @@ -4334,22 +4355,22 @@ Sicht der Verzeichnisse selbst gesehen werden. Daher kann man die gleichen Ergebnisse auch mit den Einstellungen \OptionValue{listof}{notoc}, \OptionValue{listof}{totoc} und \OptionValue{listof}{numbered} erreichen. -Dabei werden in der Voreinstellung für die Überschriften der Verzeichnisse die -oberste verfügbare Gliederungsebene unterhalb von +Dabei werden in der Voreinstellung für die Ãœberschriften der Verzeichnisse die +oberste verfügbare Gliederungsebene unterhalb von \DescRef{\LabelBase.cmd.part} verwendet. Bei \Class{scrbook} und \Class{scrreprt} ist das die Kapitelebene, bei \Class{scrartcl} die Abschnittsebene. Mit\important{\OptionValue{listof}{leveldown}}% \ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -Hilfe der Einstellung \OptionValue{listof}{leveldown} kann hingegen die nächst +Hilfe der Einstellung \OptionValue{listof}{leveldown} kann hingegen die nächst tiefere Gliederungsebene verwendet werden. \important{\OptionValue{listof}{standardlevel}}% \ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% -\OptionValue{listof}{standardlevel} schaltet bei Bedarf wieder zurück auf die +\OptionValue{listof}{standardlevel} schaltet bei Bedarf wieder zurück auf die voreingestellte Gliederungsebene. \begin{Example} Sie wollen in einem Buch das Abbildungs- und das Tabellenverzeichnis als - Unterverzeichnisse eines gemeinsamen Verzeichnisses »Abbildungen und - Tabellen« setzen. Dazu verwenden Sie einfach: + Unterverzeichnisse eines gemeinsamen Verzeichnisses »Abbildungen und + Tabellen« setzen. Dazu verwenden Sie einfach: \begin{lstcode} \KOMAoption{listof}{leveldown} \end{lstcode} @@ -4359,7 +4380,7 @@ voreingestellte Gliederungsebene. \listoffigures \listoftables \end{lstcode} - Näheres zur Anweisung \DescRef{\LabelBase.cmd.addchap*} ist + Näheres zur Anweisung \DescRef{\LabelBase.cmd.addchap*} ist \autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.cmd.addchap*} zu entnehmen. \end{Example} @@ -4367,25 +4388,25 @@ voreingestellte Gliederungsebene. Normalerweise\ChangedAt{v2.8q}{% \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} werden die Verzeichnisse\Index{Abbildungen>Verzeichnis}\Index{Tabellen>Verzeichnis} -der Gleitumgebungen so formatiert, dass für die Nummer ein Raum fester Breite -verwendet wird. Gleichzeitig werden alle Einträge leicht eingezogen. Dies +der Gleitumgebungen so formatiert, dass für die Nummer ein Raum fester Breite +verwendet wird. Gleichzeitig werden alle Einträge leicht eingezogen. Dies entspricht der Verwendung der Einstellung \OptionValue{listof}{graduated}\IndexOption{listof~=\textKValue{graduated}}. Werden die Nummern sehr breit, weil beispielsweise sehr viele Tabellen verwendet werden, so reicht der vorgesehene Platz irgendwann nicht mehr aus. Vergleichbar\important{\OptionValue{listof}{flat}} zur Einstellung -\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\textKValue{flat}} für das +\OptionValueRef{\LabelBase}{toc}{flat}\IndexOption{toc~=\textKValue{flat}} für das Inhaltsverzeichnis bietet \KOMAScript{} daher die Einstellung -\OptionValue{listof}{flat}\IndexOption{listof~=\textKValue{flat}} für die +\OptionValue{listof}{flat}\IndexOption{listof~=\textKValue{flat}} für die Verzeichnisse der Gleitumgebungen. Dabei wird die Breite der Nummern -automatisch ermittelt und der Platz entsprechend angepasst. Bezüglich der +automatisch ermittelt und der Platz entsprechend angepasst. Bezüglich der Nebenwirkungen und Funktionsweise gilt, was in \autoref{sec:\LabelBase.toc}, -\DescPageRef{\LabelBase.option.toc.flat} für die Einstellung -\OptionValueRef{\LabelBase}{toc}{flat} erklärt wurde. Es sei an dieser Stelle +\DescPageRef{\LabelBase.option.toc.flat} für die Einstellung +\OptionValueRef{\LabelBase}{toc}{flat} erklärt wurde. Es sei an dieser Stelle jedoch nochmals darauf hingewiesen, dass mit der Einstellung -\OptionValue{listof}{flat} mehrere \LaTeX-Durchläufe benötigt werden, bis die -Verzeichnisse ihre endgültige Form erhalten haben. +\OptionValue{listof}{flat} mehrere \LaTeX-Durchläufe benötigt werden, bis die +Verzeichnisse ihre endgültige Form erhalten haben. Die Einstellung \OptionValue{listof}{flat} wird automatisch aktiviert, falls die Einstellung @@ -4393,20 +4414,20 @@ die Einstellung \Class{scrreprt}\and \Class{scrartcl}} verwendet wird. Normalerweise\important{\OptionValue{listof}{entryprefix}} ist es nicht sinnvoll jeden Eintrag in eines der Verzeichnisse der Gleitumgebungen mit -einem Präfix wie »Abbildung« oder »Tabelle« zu versenden, da natürlich im +einem Präfix wie »Abbildung« oder »Tabelle« zu versenden, da natürlich im Abbildungsverzeichnis nur Abbildungen und im Tabellenverzeichnis nur Tabellen -zu finden sind. Damit hat ein solcher Präfix keinen zusätzlichen +zu finden sind. Damit hat ein solcher Präfix keinen zusätzlichen Informationswert und wird in der Voreinstellung auch weggelassen. Mit der -Einstellung \OptionValue{listof}{entryprefix} wird ein solcher Präfix jedoch -gesetzt. Dabei erhalten alle Einträge eines Verzeichnisses denselben -Präfix. Dieser richtet sich nach dem Dateianhang der Hilfsdatei, die für das -Verzeichnis verwendet wird. Für das Abbildungsverzeichnis, das den Dateianhang -»\File{lof}« besitzt, wird beispielsweise \Macro{listoflofentryname} verwendet, -während für das Tabellenverzeichnis, das den Dateianhang »\File{lot}« besitzt, +Einstellung \OptionValue{listof}{entryprefix} wird ein solcher Präfix jedoch +gesetzt. Dabei erhalten alle Einträge eines Verzeichnisses denselben +Präfix. Dieser richtet sich nach dem Dateianhang der Hilfsdatei, die für das +Verzeichnis verwendet wird. Für das Abbildungsverzeichnis, das den Dateianhang +»\File{lof}« besitzt, wird beispielsweise \Macro{listoflofentryname} verwendet, +während für das Tabellenverzeichnis, das den Dateianhang »\File{lot}« besitzt, \Macro{listoflotentryname} verwendet wird. Bei den Klassen \Class{scrbook} und -\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} fügt +\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} fügt \KOMAScript{} in der Voreinstellung bei jedem Kapitelanfang einen vertikalen Abstand in die Verzeichnisse der Gleitumgebungen ein. Dieses Verhalten, das es auch bei den Standardklassen gibt, dient dazu, diese Verzeichnisse nach @@ -4427,73 +4448,73 @@ kann man den vertikalen Abstand komplett abschalten. Eine\important{\OptionValue{listof}{chapterentry}} Besonderheit stellt die Einstellung \OptionValue{listof}{chapterentry}\IndexOption{listof~=\textKValue{chapterentry}} -dar. Dabei wird statt des Abstandes der Inhaltsverzeichniseintrag für das +dar. Dabei wird statt des Abstandes der Inhaltsverzeichniseintrag für das Kapitel in das Verzeichnis der Gleitumgebungen -eingefügt. Es\textnote{Achtung!} wird darauf hingewiesen, dass ein solcher -Eintrag auch dann erfolgt, wenn das Kapitel keine Gleitumgebung enthält. Eine -Lösung, bei der nur Kapitel mit Gleitumgebungen im jeweiligen Verzeichnis +eingefügt. Es\textnote{Achtung!} wird darauf hingewiesen, dass ein solcher +Eintrag auch dann erfolgt, wenn das Kapitel keine Gleitumgebung enthält. Eine +Lösung, bei der nur Kapitel mit Gleitumgebungen im jeweiligen Verzeichnis angezeigt werden, finden Sie unter \cite{https://komascript.de/comment/5070}. Eine noch direktere Beeinflussung, was in den Verzeichnissen der Gleitumgebungen bei neuen Kapiteln geschehen soll, ist mit der Option \DescRef{\LabelBase.option.chapteratlists} zu erreichen, die in \autoref{sec:\LabelBase.structure} auf -\DescPageRef{\LabelBase.option.chapteratlists} erläutert wird. +\DescPageRef{\LabelBase.option.chapteratlists} erläutert wird. -Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von +Einen Ãœberblick über alle möglichen Werte für die \PName{Einstellung} von \Option{listof} ist in \autoref{tab:maincls.listof} zu finden. \begin{desclist} - \desccaption[{Mögliche Werte für Option \Option{listof}}]{% - Mögliche Werte für Option \Option{listof} zur Einstellung von Form und + \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} (\emph{Fortsetzung})% + Mögliche Werte für Option \Option{listof} (\emph{Fortsetzung})% }% \entry{\PValue{chapterentry}, \PValue{withchapterentry}}{% - Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch einen Inhaltsverzeichniseintrag des Kapitels markiert.% \IndexOption{listof~=\textKValue{chapterentry}}}% \entry{\PValue{chaptergapline}, \PValue{onelinechaptergap}}{% - Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch einen Abstand von einer Zeile markiert.% \IndexOption{listof~=\textKValue{chaptergapline}}}% \entry{\PValue{chaptergapsmall}, \PValue{smallchaptergap}}{% - Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch einen kleinen Abstand markiert.% \IndexOption{listof~=\textKValue{chaptergapsmall}}}% \entry{\PValue{entryprefix}}{% \ChangedAt{v3.06}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - Jeder Verzeichniseintrag wird mit einem vom Verzeichnis abhängenden Präfix - vor der Nummer versehen. Der Präfix ist normalerweise sprachabhängig, - beispielsweise bei deutschen Spracheinstellungen »Abbildung« für das - Abbildungsverzeichnis und »Tabelle« für das Tabellenverzeichnis, jeweils + Jeder Verzeichniseintrag wird mit einem vom Verzeichnis abhängenden Präfix + vor der Nummer versehen. Der Präfix ist normalerweise sprachabhängig, + beispielsweise bei deutschen Spracheinstellungen »Abbildung« für das + Abbildungsverzeichnis und »Tabelle« für das Tabellenverzeichnis, jeweils gefolgt von einem Leerzeichen.% \IndexOption{listof~=\textKValue{entryprefix}}}% \entry{\PValue{flat}, \PValue{left}}{% Die Verzeichnisse der Gleitumgebungen erhalten eine tabellarische Form. Die Gleitumgebungsnummern sind dabei die erste Spalte, der Titel die - zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die - Gleitumgebungsnummern reserviert wird, richtet sich nach dem benötigten + zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die + Gleitumgebungsnummern reserviert wird, richtet sich nach dem benötigten Platz des vorherigen \LaTeX-Laufs.% \IndexOption{listof~=\textKValue{flat}}}% \entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{% Die Verzeichnisse der Gleitumgebungen erhalten eine hierarchische Form. Es - steht nur ein begrenzter Platz für die Gleitumgebungsnummern zur - Verfügung.% + steht nur ein begrenzter Platz für die Gleitumgebungsnummern zur + Verfügung.% \IndexOption{listof~=\textKValue{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}, - \DescPageRef{tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der + \DescPageRef{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 + 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, + 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 \DescRef{tocbasic.cmd.addxcontentsline} (siehe \autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.addxcontentsline}) erzeugt werden.% @@ -4503,13 +4524,13 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% Die Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc}, - \DescPageRef{tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der + \DescPageRef{tocbasic.cmd.setuptoc}) wird für die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und das - Tabellenverzeichnis, gelöscht. Dadurch werden nicht nummerierte Einträge - linksbündig mit der Nummer von nummerierten Einträgen gleicher Ebene + Tabellenverzeichnis, gelöscht. 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, + 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 \DescRef{tocbasic.cmd.addxcontentsline} (siehe \autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.addxcontentsline}) erzeugt werden.% @@ -4518,7 +4539,7 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von Die Verzeichnisse werden um eine Gliederungsebene nach unten verschoben.% \IndexOption{listof~=\textKValue{leveldown}}}% \entry{\PValue{nochaptergap}, \PValue{ignorechapter}}{% - Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen nicht + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen nicht markiert.% \IndexOption{listof~=\textKValue{nochaptergap}}}% \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{% @@ -4532,7 +4553,7 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von werden nummeriert.% \IndexOption{listof~=\textKValue{numbered}}}% \entry{\PValue{standardlevel}}{% - Die Verzeichnisse liegen auf der üblichen Gliederungsebene.% + Die Verzeichnisse liegen auf der üblichen Gliederungsebene.% \IndexOption{listof~=\textKValue{standardlevel}}}% \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{% Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und @@ -4549,16 +4570,16 @@ Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von \Macro{listoffigures} \end{Declaration}% Mit diesen Anweisungen kann ein Verzeichnis der Tabellen beziehungsweise der -Abbildungen ausgegeben werden. Änderungen, die Auswirkungen auf diese -Verzeichnisse haben, werden erst nach zwei \LaTeX{}-Läufen sichtbar. Die Form +Abbildungen ausgegeben werden. Änderungen, die Auswirkungen auf diese +Verzeichnisse haben, werden erst nach zwei \LaTeX{}-Läufen sichtbar. Die Form der Verzeichnisse kann durch die Option \DescRef{\LabelBase.option.listof}\important{\DescRef{\LabelBase.option.listof}} mit den Werten \PValue{graduated} und \PValue{flat} beeinflusst werden (siehe -\DescPageRef{\LabelBase.option.listof}). Darüber hinaus wirken sich indirekt -die Werte \PValue{listof} und \PValue{listofnumbered} für die Option +\DescPageRef{\LabelBase.option.listof}). Darüber hinaus wirken sich indirekt +die Werte \PValue{listof} und \PValue{listofnumbered} für die Option \DescRef{\LabelBase.option.toc}\important{\DescRef{\LabelBase.option.toc}} (siehe \autoref{sec:\LabelBase.toc}, \DescPageRef{\LabelBase.option.toc}), -sowie die Werte \PValue{totoc} und \PValue{numbered} der oben erläuterten +sowie die Werte \PValue{totoc} und \PValue{numbered} der oben erläuterten Option \DescRef{\LabelBase.option.listof} auf die Verzeichnisse aus. In\textnote{Tipp!} der Regel findet man die Verzeichnisse der @@ -4582,9 +4603,9 @@ Inhaltsverzeichnis.% Der Anhang eines Dokuments besteht im Wesentlichen aus den Anlagen zu einem Dokument. Typische Teile eines Anhangs sind Literaturverzeichnis, -Stichwortverzeichnis und Begriffsverzeichnis. Alleine für diese Teile würde +Stichwortverzeichnis und Begriffsverzeichnis. Alleine für diese Teile würde man jedoch keinen Anhang beginnen, da diese Teile normalerweise schon von sich -aus eine Auszeichnung besitzen, die sie als Anhang erkennbar macht. Enthält +aus eine Auszeichnung besitzen, die sie als Anhang erkennbar macht. Enthält der Anhang aber weitere Teile wie beispielsweise zitierte Fremddokumente, Endnoten oder Tafeln, so werden die zuvor genannten Teile ebenfalls im Anhang gesetzt. @@ -4595,17 +4616,17 @@ gesetzt. \end{Declaration}% Der Anhang wird in den Standardklassen und den {\KOMAScript}-Klassen mit der Anweisung \Macro{appendix} eingeleitet. Diese Anweisung schaltet unter anderem -die Kapitelnummerierung auf Großbuchstaben um und sorgt gleichzeitig dafür, -dass die Regeln für die Nummerierung der Gliederungsebenen nach \cite{DUDEN} +die Kapitelnummerierung auf Großbuchstaben um und sorgt gleichzeitig dafür, +dass die Regeln für die Nummerierung der Gliederungsebenen nach \cite{DUDEN} eingehalten werden. Diese Regeln sind in der Beschreibung der Option \DescRef{\LabelBase.option.numbers} in \autoref{sec:\LabelBase.structure}, -\DescPageRef{\LabelBase.option.numbers} näher erläutert. +\DescPageRef{\LabelBase.option.numbers} näher erläutert. -Die Form der Kapitelüberschriften\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} +Die Form der Kapitelüberschriften\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} im Anhang wird durch die Optionen \DescRef{\LabelBase.option.chapterprefix}% \important{\DescRef{\LabelBase.option.chapterprefix}\\ \DescRef{\LabelBase.option.appendixprefix}} und -\DescRef{\LabelBase.option.appendixprefix} bestimmt. Näheres dazu ist +\DescRef{\LabelBase.option.appendixprefix} bestimmt. Näheres dazu ist \autoref{sec:\LabelBase.structure}, \DescPageRef{\LabelBase.option.appendixprefix} zu entnehmen. @@ -4625,15 +4646,15 @@ des Anhangs werden ganz normal mit \DescRef{\LabelBase.cmd.chapter} und \BeginIndexGroup \BeginIndex{}{Literaturverzeichnis} -Das Literaturverzeichnis erschließt externe Quellen. In der Regel wird das +Das Literaturverzeichnis erschließt externe Quellen. In der Regel wird das Literaturverzeichnis mit Hilfe des Programms \BibTeX{} aus einer Datei mit -datenbankähnlicher Struktur erzeugt. Dabei kann über den \BibTeX-Stil sowohl -die Form der Einträge als auch deren Sortierung verändert werden. Wird -zusätzlich ein Literaturpaket, beispielsweise +datenbankähnlicher Struktur erzeugt. Dabei kann über den \BibTeX-Stil sowohl +die Form der Einträge als auch deren Sortierung verändert werden. Wird +zusätzlich ein Literaturpaket, beispielsweise \Package{natbib}\IndexPackage{natbib}, \Package{babelbib}\IndexPackage{babelbib} oder \Package{biblatex}\IndexPackage{biblatex} verwendet, so schwindet der Einfluss -von \KOMAScript{} auf das Literaturverzeichnis. In diesen Fällen ist unbedingt +von \KOMAScript{} auf das Literaturverzeichnis. In diesen Fällen ist unbedingt die Anleitung des verwendeten Pakets zu beachten! Zur generellen Verwendung eines Literaturverzeichnisses sei auf \cite{l2kurz} verwiesen. @@ -4642,47 +4663,47 @@ eines Literaturverzeichnisses sei auf \cite{l2kurz} verwiesen. \OptionVName{bibliography}{Einstellung} \end{Declaration} Als \PName{Einstellung}\ChangedAt{v3.00}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}} kann zunächst einmal jeder definierte -Formatierungsstil gewählt werden. Vordefiniert sind bei \KOMAScript{} zwei -solche Formatierungsstile für das Literaturverzeichnis. Diese sind jedoch -nicht zu verwechseln mit den unterschiedlichen Stilen für -\BibTeX\Index{BibTeX=\BibTeX}, die man mit \Macro{bibstyle} auswählt. Während + \Class{scrreprt}\and \Class{scrartcl}} kann zunächst einmal jeder definierte +Formatierungsstil gewählt werden. Vordefiniert sind bei \KOMAScript{} zwei +solche Formatierungsstile für das Literaturverzeichnis. Diese sind jedoch +nicht zu verwechseln mit den unterschiedlichen Stilen für +\BibTeX\Index{BibTeX=\BibTeX}, die man mit \Macro{bibstyle} auswählt. Während \BibTeX{} sowohl die Art der Sortierung als auch den Inhalt des -Literaturverzeichnisses bestimmt, können über die Einstellungen von +Literaturverzeichnisses bestimmt, können über die Einstellungen von \KOMAScript{} nur grundlegende Eigenschaften des Literaturverzeichnisses oder -einige wenige Eigenschaften der Formatierung der Einträge beeinflusst werden. +einige wenige Eigenschaften der Formatierung der Einträge beeinflusst werden. Mit\important{\OptionValue{bibliography}{oldstyle}} \OptionValue{bibliography}{oldstyle}% \IndexOption{bibliography~=\textKValue{oldstyle}} wird die kompakte Formatierung -gewählt. Dabei führt die Anweisung +gewählt. Dabei führt die Anweisung \DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} in den einzelnen -Einträgen lediglich zu einem dehnbaren horizontalen Abstand. Der Name kommt -daher, dass dies die häufigste klassische Form eines Literaturverzeichnisses -ist. Demgegenüber\important{\OptionValue{bibliography}{openstyle}} erreicht +Einträgen lediglich zu einem dehnbaren horizontalen Abstand. Der Name kommt +daher, dass dies die häufigste klassische Form eines Literaturverzeichnisses +ist. Demgegenüber\important{\OptionValue{bibliography}{openstyle}} erreicht man die etwas modernere, offene Form mit der Einstellung \OptionValue{bibliography}{openstyle}% \IndexOption{bibliography~=\textKValue{openstyle}}. Der Name kommt daher, dass hier die Anweisung \DescRef{maincls-experts.cmd.newblock} einen Absatz -einfügt. Die Einträge im Literaturverzeichnis werden so stärker +einfügt. Die Einträge im Literaturverzeichnis werden so stärker gegliedert. Sie sind weniger kompakt und deutlich aufgelockerter oder -geöffnet. Bezüglich der Möglichkeit, neue Formatierungsstile zu definieren, +geöffnet. Bezüglich der Möglichkeit, neue Formatierungsstile zu definieren, sei auf \DescRef{maincls-experts.cmd.newbibstyle}, -\autoref{sec:maincls-experts.experts}, +\autoref{sec:maincls-experts.bibliography}, \DescPageRef{maincls-experts.cmd.newbibstyle} verwiesen. -Neben dem Formatierungsstil gibt es eine weitere Eigenschaft, die über -\PName{Einstellung} verändert werden kann. Das Literaturverzeichnis stellt +Neben dem Formatierungsstil gibt es eine weitere Eigenschaft, die über +\PName{Einstellung} verändert werden kann. Das Literaturverzeichnis stellt eine Art von Verzeichnis dar, bei der nicht der Inhalt des vorliegenden Werks -aufgelistet, sondern auf externe Inhalte verwiesen wird. Mit dieser Begründung -könnte man argumentieren, dass das Literaturverzeichnis ein eigenes Kapitel +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 verdiene. Die Einstellung \OptionValue{bibliography}{numbered}% \important{\OptionValue{bibliography}{numbered}}% -\IndexOption{bibliography~=\textKValue{numbered}} führt genau dazu, -einschließlich des dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst +\IndexOption{bibliography~=\textKValue{numbered}} 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 +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 @@ -4698,26 +4719,26 @@ die Werte \PValue{bibliographynumbered}, \PValue{bibliography} und \PValue{nobibliography} ab \DescPageRef{\LabelBase.option.toc.bibliography}. In\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -einigen Fällen wird nicht das gesamte Dokument mit einem einzigen +einigen Fällen wird nicht das gesamte Dokument mit einem einzigen Literaturverzeichnis versehen, sondern jedes Kapitel eines mit \Class{scrbook} -oder \Class{scrreprt} gesetzten Dokuments erhält sein eigenes +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~=\textKValue{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. +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 +Eine Zusammenfassung möglicher Werte für \PName{Einstellung} ist \autoref{tab:maincls.bibliography} zu entnehmen. Es ist jedoch zu beachten, dass mit \DescRef{maincls-experts.cmd.newbibstyle}\IndexCmd{newbibstyle} -weitere Werte definiert werden können. +weitere Werte definiert werden können. \begin{table} - \caption[{Mögliche Werte für Option \Option{bibliography}}]{Vordefinierte - Werte für Option \Option{bibliography} zur Einstellung der Form des + \caption[{Mögliche Werte für Option \Option{bibliography}}]{Vordefinierte + Werte für Option \Option{bibliography} zur Einstellung der Form des Literatur\-verzeichnisses} \label{tab:maincls.bibliography} \begin{desctabular} @@ -4728,31 +4749,31 @@ weitere Werte definiert werden können. verschoben.% \IndexOption{bibliography~=\textKValue{leveldown}}}% \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{% - Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis und + Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis und wird auch nicht nummeriert.% \IndexOption{bibliography~=\textKValue{nottotoc}}}% \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered}, \PValue{numberedtoc}, \PValue{numberedtotoc}}{% - Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und wird nummeriert.% \IndexOption{bibliography~=\textKValue{numbered}}}% \pventry{oldstyle}{% - Es wird die klassische, kompakte Formatierung gewählt, bei der + Es wird die klassische, kompakte Formatierung gewählt, bei der \DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} nur einen dehnbaren horizontalen Abstand darstellt.% \IndexOption{bibliography~=\textKValue{oldstyle}}}% \pventry{openstyle}{% - Es wird eine untergliederte, offene Formatierung gewählt, bei der + Es wird eine untergliederte, offene Formatierung gewählt, bei der \DescRef{maincls-experts.cmd.newblock}\IndexCmd{newblock} einen Absatz darstellt.% \IndexOption{bibliography~=\textKValue{openstyle}}}% \pventry{standardlevel}{% \ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - Das Literaturverzeichnis liegt auf der üblichen Gliederungsebene.% + Das Literaturverzeichnis liegt auf der üblichen Gliederungsebene.% \IndexOption{bibliography~=\textKValue{standardlevel}}}% \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{% - Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne dass es nummeriert wird.% \IndexOption{bibliography~=\textKValue{totoc}}}% \end{desctabular} @@ -4762,10 +4783,10 @@ weitere Werte definiert werden können. \begin{Declaration} - \Macro{setbibpreamble}\Parameter{Präambel} + \Macro{setbibpreamble}\Parameter{Präambel} \end{Declaration}% -Mit der Anweisung \Macro{setbibpreamble} kann eine Präambel für das -Literaturverzeichnis gesetzt werden. Bedingung dafür ist, dass die Präambel +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 Option @@ -4787,8 +4808,8 @@ funktioniert (siehe \cite{package:natbib}). sortiert. Bei mehreren Autoren wird nach dem ersten Autor sortiert.\par\bigskip} \end{lstcode} - Die Anweisung \Macro{bigskip}\IndexCmd{bigskip} sorgt dafür, dass - zwischen der Präambel und der ersten Literaturangabe ein großer + Die Anweisung \Macro{bigskip}\IndexCmd{bigskip} sorgt dafür, dass + zwischen der Präambel und der ersten Literaturangabe ein großer Zwischenraum gesetzt wird.% \end{Example} % @@ -4801,15 +4822,15 @@ funktioniert (siehe \cite{package:natbib}). Diese\textnote{Achtung!}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Anweisung existiert nur, wenn Umgebung \Environment{thebibliography} nicht durch ein Paket neu definiert -wurde. In diesem Fall ist es möglich, mit dieser Anweisung das +wurde. In diesem Fall ist es möglich, mit dieser Anweisung das Literaturverzeichnis zu unterbrechen. Die \PName{Unterbrechung} wird dann -innerhalb einer Gruppe ausgegeben. Eine solche \PName{Unterbrechung} könnte -beispielsweise eine Überschrift mit Hilfe von \DescRef{\LabelBase.cmd.minisec} -sein. Leider gibt es bisher keine Möglichkeit, diese Anweisung beispielsweise +innerhalb einer Gruppe ausgegeben. Eine solche \PName{Unterbrechung} könnte +beispielsweise eine Ãœberschrift mit Hilfe von \DescRef{\LabelBase.cmd.minisec} +sein. Leider gibt es bisher keine Möglichkeit, diese Anweisung beispielsweise mit Hilfe eines speziellen Eintrags in der Literaturdatenbank von \BibTeX{} erzeugen zu lassen. Daher kann sie derzeit nur von Anwendern verwendet werden, die das Literaturverzeichnis selbst editieren. Ihr Nutzen ist damit sehr -beschränkt.% +beschränkt.% % \EndIndexGroup @@ -4819,22 +4840,22 @@ beschränkt.% \Macro{AtEndBibliography}\Parameter{Anweisungen} \end{Declaration} In\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} -einigen Fällen ist es nützlich, wenn man nach der Präambel des +einigen Fällen ist es nützlich, wenn man nach der Präambel des Literaturverzeichnisses oder unmittelbar vor dem Ende des -Literaturverzeichnisses noch \PName{Anweisungen} ausführen kann. Dies ist mit -Hilfe dieser beiden Anweisungen möglich. +Literaturverzeichnisses noch \PName{Anweisungen} ausführen kann. Dies ist mit +Hilfe dieser beiden Anweisungen möglich. \begin{Example} Sie wollen, dass das Literaturverzeichnis nicht im Blocksatz, sondern im - linksbündigen Flattersatz ausgegeben wird. Dies ist einfach mit: + linksbündigen Flattersatz ausgegeben wird. Dies ist einfach mit: \begin{lstcode} \AfterBibliographyPreamble{\raggedright} \end{lstcode} - zu erreichen. Sie können diese Anweisung an beliebiger Stelle vor dem + zu erreichen. Sie können diese Anweisung an beliebiger Stelle vor dem Literaturverzeichnis verwenden. Es wird jedoch empfohlen, sie in die - Präambel des Dokuments oder ein eigenes Paket zu schreiben. + Präambel des Dokuments oder ein eigenes Paket zu schreiben. \end{Example} Die\textnote{Achtung!} Realisierung dieser Anweisung bedarf bei Verwendung -eines Pakets, das die Umgebung für Literaturverzeichnisse umdefiniert, der +eines Pakets, das die Umgebung für Literaturverzeichnisse umdefiniert, der Zusammenarbeit mit dem entsprechenden Paket (siehe \autoref{sec:maincls-experts.coexistence}, \DescPageRef{maincls-experts.cmd.AfterBibliographyPreamble}).% @@ -4851,8 +4872,8 @@ Zusammenarbeit mit dem entsprechenden Paket (siehe Das Stichwortverzeichnis ist auch unter den Bezeichnungen Index oder Register bekannt. Zur generellen Verwendung eines Stichwortverzeichnisses sei auf \cite{l2kurz} sowie auf \cite{makeindex} und \cite{xindy} verwiesen. Wird ein -Paket verwendet, das selbst Anweisungen und Umgebungen für das -Stichwortverzeichnis zur Verfügung stellt, so schwindet eventuell der +Paket verwendet, das selbst Anweisungen und Umgebungen für das +Stichwortverzeichnis zur Verfügung stellt, so schwindet eventuell der Einfluss, den \KOMAScript{} auf dieses Verzeichnis hat. Dies gilt beispielsweise bei Verwendung von \Package{index}\IndexPackage{index}, nicht jedoch bei Verwendung von @@ -4868,9 +4889,9 @@ In der Voreinstellung \OptionValue{index}{nottotoc}\IndexOption{index~=\textKValue{nottotoc}} 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 -zuletzt steht, benötigt es eigentlich auch keinen -Inhaltsverzeichniseintrag. Wird dieser dennoch gewünscht, beispielsweise weil +Stichwortverzeichnis normalerweise in einem Buch oder ähnlichen Dokument +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~=\textKValue{totoc}} erreicht @@ -4884,24 +4905,24 @@ Option \OptionValue{index}{numbered}. Siehe hierzu auch Option Werden beispielsweise mit Hilfe von \Package{splitidx}\IndexPackage{splitidx} (siehe \cite{package:splitindex}) mehrere Stichwortverzeichnisse erstellt, so -kann es sinnvoll sein, diese unter einer gemeinsamen Überschrift zusammen zu -fassen. Um dies zu ermöglichen, kann mit \OptionValue{index}{leveldown}% +kann es sinnvoll sein, diese unter einer gemeinsamen Ãœberschrift zusammen zu +fassen. Um dies zu ermöglichen, kann mit \OptionValue{index}{leveldown}% \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}\important{\OptionValue{index}{leveldown}} das Verzeichnis -eine Gliederungsebene tiefer als üblich angesiedelt werden. Bei +eine Gliederungsebene tiefer als üblich angesiedelt werden. Bei \Class{scrbook} und \Class{scrreprt} ist es dann also kein Kapitel mehr, sondern ein Abschnitt, bei \Class{scrartcl} entsprechend ein Unterabschnitt. Option \OptionValue{index}{standardlevel}% \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}\important{\OptionValue{index}{standardlevel}} ist das -Gegenstück dazu und hebt ein eventuell zuvor verwendetes +Gegenstück dazu und hebt ein eventuell zuvor verwendetes \OptionValue{index}{leveldown} wieder auf. -Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von +Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von \Option{index} ist in \autoref{tab:maincls.index} zu finden. \begin{table} - \caption[{Mögliche Werte für Option \Option{index}}]{Mögliche Werte für + \caption[{Mögliche Werte für Option \Option{index}}]{Mögliche Werte für Option \Option{index} zur Einstellung des Stich\-wort\-verzeichnisses} \label{tab:maincls.index} \begin{desctabular} @@ -4912,23 +4933,23 @@ Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von \IndexOption{index~=\textKValue{leveldown}}% }% \entry{\PValue{notoc}, \PValue{nottotoc}, \PValue{plainheading}}{% - Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.% + Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.% \IndexOption{index~=\textKValue{nottotoc}}}% \entry{\PValue{numbered}, \PValue{tocnumbered}, \PValue{totocnumbered}, \PValue{numberedtoc}, \PValue{numberedtotoc}}{% \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und wird nummeriert.% \IndexOption{index~=\textKValue{numbered}}}% \pventry{standardlevel}{% \ChangedAt{v3.18}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - Der Index liegt auf der üblichen Gliederungsebene.% + Der Index liegt auf der üblichen Gliederungsebene.% \IndexOption{index~=\textKValue{standardlevel}}% }% \entry{\PValue{toc}, \PValue{totoc}, \PValue{notnumbered}}{% - Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne dass er nummeriert wird.% \IndexOption{index~=\textKValue{totoc}}}% \end{desctabular} @@ -4938,48 +4959,48 @@ Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von \begin{Declaration} - \Macro{setindexpreamble}\Parameter{Präambel} + \Macro{setindexpreamble}\Parameter{Präambel} \end{Declaration}% -Analog zur Präambel des Literaturverzeichnisses können Sie auch das -Stichwortverzeichnis mit einer Präambel versehen. Dies findet häufig +Analog zur Präambel des Literaturverzeichnisses können Sie auch das +Stichwortverzeichnis mit einer Präambel versehen. Dies findet häufig dann Anwendung, wenn es mehr als einen Index gibt oder im Index unterschiedliche Arten der Referenzierung durch unterschiedliche Hervorhebung der Seitenzahlen markiert werden. \begin{Example} Sie haben ein Dokument, in dem Begriffe sowohl definiert als auch verwendet werden. Die Seitenzahlen der Begriffsdefinitionen sind - fett dargestellt. Natürlich möchten Sie gerne auf diesen Umstand - hinweisen. Also setzen Sie eine entsprechende Präambel für den + fett dargestellt. Natürlich möchten Sie gerne auf diesen Umstand + hinweisen. Also setzen Sie eine entsprechende Präambel für den Index: \begin{lstcode} \setindexpreamble{Alle \textbf{fett} gedruckten Seitenzahlen sind Referenzen auf die Definition - des jeweiligen Begriffs. Demgegenüber geben + des jeweiligen Begriffs. Demgegenüber geben normal gedruckte Seitenzahlen die Seiten der Verwendung des jeweiligen Begriffs wieder.\par \bigskip} \end{lstcode} \end{Example} -Bitte\textnote{Achtung!} beachten Sie, dass für die erste Seite des Index der +Bitte\textnote{Achtung!} beachten Sie, dass für die erste Seite des Index der Seitenstil umgeschaltet wird. Welcher Seitenstil hierbei Verwendung findet, ist im Makro \DescRef{\LabelBase.cmd.indexpagestyle} abgelegt (siehe \autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.cmd.indexpagestyle}). -Für die Erstellung, Sortierung und Ausgabe des Stichwortverzeichnisses -sind die üblichen Standard-\LaTeX-Pakete und Zusatzprogramme -zuständig.% +Für die Erstellung, Sortierung und Ausgabe des Stichwortverzeichnisses +sind die üblichen Standard-\LaTeX-Pakete und Zusatzprogramme +zuständig.% \iftrue % Umbruchoptimierung \iffree{}{ % Besonders empfehlenswert ist beispielsweise das Paket \Package{imakeidx}\IndexPackage{imakeidx} (siehe \cite{package:imakeidx}), das unter anderem den Aufruf des Programms \File{makeindex} oder - \File{xindy} automatisiert. Damit entfällt eine häufige Fehlerquelle - insbesondere für \LaTeX-Anfänger.% + \File{xindy} automatisiert. Damit entfällt eine häufige Fehlerquelle + insbesondere für \LaTeX-Anfänger.% } Von {\KOMAScript} werden genau wie von den Standardklassen - lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung + lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung gestellt.% \fi % @@ -4994,22 +5015,22 @@ zuständig.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide.tex" %%% End: % LocalWords: Teildokumenten Klassenoption Tabellenunterschrift float -% LocalWords: Satzspiegels Schrifteinstellung Abschnittseinträgen Nachspann +% LocalWords: Satzspiegels Schrifteinstellung Abschnittseinträgen Nachspann % LocalWords: Vakatseiten Kolumnentitel Sternformen Teiltabelle Seitenstil -% LocalWords: Bildunterschriften Dokumentpräambel Tabellenüberschriften -% LocalWords: Gleitumgebungstyp Kapitelüberschriften Standardklassen -% LocalWords: serifenlosen Abschnittseinträge Gliederungsebenen Paketoption +% LocalWords: Bildunterschriften Dokumentpräambel Tabellenüberschriften +% LocalWords: Gleitumgebungstyp Kapitelüberschriften Standardklassen +% LocalWords: serifenlosen Abschnittseinträge Gliederungsebenen Paketoption % LocalWords: Nummerierungsstilen Seitenstilen Seitenankern Vakatseite % LocalWords: Nummerierungsstil Eingangskommentar Nummerierungsstils -% LocalWords: Standardanweisung Einstellmöglichkeiten Umbruchkorrekturtext -% LocalWords: Inhaltsverzeichniseintrag Formatierungsänderungen Präfixzeile +% LocalWords: Standardanweisung Einstellmöglichkeiten Umbruchkorrekturtext +% LocalWords: Inhaltsverzeichniseintrag Formatierungsänderungen Präfixzeile diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex index 0a39c2767b..ab623a7286 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrdatetime.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrdatetime.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrpage2 in der KOMA-Script-Anleitung +% Kapitel über scrpage2 in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{scrdatetime.tex} - [$Date: 2018-02-05 09:57:42 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrdate, scrtime)] \chapter{Der Wochentag mit \Package{scrdate}} @@ -54,8 +54,8 @@ \BeginIndexGroup \BeginIndex{Package}{scrdate} -Ursprünglich sollte das Paket \Package{scrdate} lediglich den Wochentag zum -aktuellen Datum liefern. Inzwischen bietet es dies und etwas mehr für jedes +Ursprünglich sollte das Paket \Package{scrdate} lediglich den Wochentag zum +aktuellen Datum liefern. Inzwischen bietet es dies und etwas mehr für jedes beliebige Datum im Gregorianischen Kalender. \begin{Declaration} @@ -64,10 +64,10 @@ beliebige Datum im Gregorianischen Kalender. \end{Declaration}% Die\ChangedAt{v3.05a}{\Package{scrdate}} Anweisung \Macro{CenturyPart} ergibt den Wert der Jahrhundert-Stellen eines Jahres. Die Anweisung -\Macro{DecadePart} ergibt hingegen den Wert der übrigen Stellen, also der +\Macro{DecadePart} ergibt hingegen den Wert der übrigen Stellen, also der Einer und Zehner. Dabei darf die Jahreszahl beliebig viele Stellen aufweisen. -Der Wert kann direkt zur Zuweisung an einen Zähler oder für Berechnungen mit -Hilfe von \Macro{numexpr}\IndexCmd{numexpr} verwendet werden. Für die +Der Wert kann direkt zur Zuweisung an einen Zähler oder für Berechnungen mit +Hilfe von \Macro{numexpr}\IndexCmd{numexpr} verwendet werden. Für die Ausgabe\textnote{Achtung!} als arabische Zahl ist \Macro{the}\IndexCmd{the} voran zu stellen. @@ -87,10 +87,10 @@ voran zu stellen. \end{quote} \end{Example}% -Bitte\textnote{Achtung!} beachten Sie, dass hier die Zählweise verwendet +Bitte\textnote{Achtung!} beachten Sie, dass hier die Zählweise verwendet wird, bei der das Jahr 2000 das Jahr~0 -- also das erste Jahr -- des -21.~Jahrhunderts ist. Bei Bedarf kann aber, wie im Beispiel für die -Ordnungszahl gezeigt, mit \Macro{numexpr} eine Korrektur herbeigeführt +21.~Jahrhunderts ist. Bei Bedarf kann aber, wie im Beispiel für die +Ordnungszahl gezeigt, mit \Macro{numexpr} eine Korrektur herbeigeführt werden.% \EndIndexGroup @@ -100,15 +100,15 @@ werden.% \Macro{ISODayNumber}\Parameter{ISO-Datum} \end{Declaration}% Diese\ChangedAt{v3.05a}{\Package{scrdate}} beiden Anweisungen geben den Wert -der Nummer des Wochentags\Index{Wochentag} zu einem Datum zurück. Sie -unterscheiden sich nur in der Art der Angabe des Datums. Während bei -\Macro{DayNumber} Jahr, Monat und Tag des gewünschten Datums eigene Parameter +der Nummer des Wochentags\Index{Wochentag} zu einem Datum zurück. Sie +unterscheiden sich nur in der Art der Angabe des Datums. Während bei +\Macro{DayNumber} Jahr, Monat und Tag des gewünschten Datums eigene Parameter sind, wird bei \Macro{ISODayNumber} das Datum in ISO-Schreibweise, \PName{Jahr}\texttt{-}\PName{Monat}\texttt{-}\PName{Tag} angegeben. Dabei spielt es keine Rolle, ob Monat und Tag ein- oder zweistellig angegeben -werden. Der Wert kann direkt zur Zuweisung an einen Zähler oder für +werden. Der Wert kann direkt zur Zuweisung an einen Zähler oder für Berechnungen mit Hilfe von \Macro{numexpr}\IndexCmd{numexpr} verwendet -werden. Für die Ausgabe\textnote{Achtung!} als arabische Zahl ist +werden. Für die Ausgabe\textnote{Achtung!} als arabische Zahl ist \Macro{the}\IndexCmd{the} voran zu stellen. \begin{Example} @@ -124,8 +124,8 @@ werden. Für die Ausgabe\textnote{Achtung!} als arabische Zahl ist \end{quote} \end{Example} -Als Besonderheit ist es sogar möglich, von einem vorgegebenen Datum eine -gewünschte Anzahl an Tagen in die Zukunft oder Vergangenheit zu gehen. +Als Besonderheit ist es sogar möglich, von einem vorgegebenen Datum eine +gewünschte Anzahl an Tagen in die Zukunft oder Vergangenheit zu gehen. \begin{Example} Sie wollen die Nummer des Wochentags wissen, den wir in 12~Tagen haben und den wir 24~Tage vor dem 24.~Dezember~2027 gehabt haben werden. @@ -158,11 +158,11 @@ Samstag\,=\,6.% \Macro{DayName}\Parameter{Jahr}\Parameter{Monat}\Parameter{Tag} \Macro{ISODayName}\Parameter{ISO-Datum} \end{Declaration}% -Üblicherweise\ChangedAt{v3.05a}{\Package{scrdate}} ist man weniger an der +Ãœblicherweise\ChangedAt{v3.05a}{\Package{scrdate}} ist man weniger an der Nummer eines Wochentags als dem Namen des Wochentags interessiert. Daher liefert die Anweisung \Macro{DayNameByNumber} den Namen des Wochentags zu -einer Wochentagsnummer zurück, die man beispielsweise mit einer der beiden -zuvor erklärten Anweisungen \DescRef{\LabelBase.cmd.DayNumber} oder +einer Wochentagsnummer zurück, die man beispielsweise mit einer der beiden +zuvor erklärten Anweisungen \DescRef{\LabelBase.cmd.DayNumber} oder \DescRef{\LabelBase.cmd.ISODayNumber} bestimmt hat. Die beiden Anweisungen \Macro{DayName} und \Macro{ISODayName} liefern entsprechend den Wochentag zu einem bestimmten Datum. @@ -181,7 +181,7 @@ einem bestimmten Datum. \end{quote} \end{Example} -Als Besonderheit ist es auch hier möglich, in gewissem Umfang Berechnungen +Als Besonderheit ist es auch hier möglich, in gewissem Umfang Berechnungen anzustellen: \begin{Example} Sie wollen den Wochentag wissen, den wir in 12~Tagen haben und @@ -190,7 +190,7 @@ anzustellen: In 12~Tagen haben wir einen \DayName{\year}{\month}{\day+12} und 24~Tage vor dem 24.~Dezember~2027 ist ein - \ISODayName{2027-12-24-24}, während zwei Wochen + \ISODayName{2027-12-24-24}, während zwei Wochen und drei Tage nach einem Mittwoch ein \DayNameByNumber{3+2*7+3} folgt. \end{lstcode} @@ -199,7 +199,7 @@ anzustellen: In 12~Tagen haben wir einen \DayName{\year}{\month}{\day+12} und 24~Tage vor dem 24.~Dezember~2027 ist ein - \ISODayName{2027-12-24-24}, während + \ISODayName{2027-12-24-24}, während zwei Wochen und drei Tage nach einem Mittwoch ein \DayNameByNumber{3+2*7+3} folgt. @@ -216,20 +216,20 @@ anzustellen: \Macro{todaysnumber} \end{Declaration}% In den bisherigen Beispielen dieses Abschnitts wurde das aktuelle Datum immer -recht umständlich über die \TeX-Register \Macro{year}\IndexCmd{year}, +recht umständlich über die \TeX-Register \Macro{year}\IndexCmd{year}, \Macro{month}\IndexCmd{month}, \Macro{day}\IndexCmd{day} bestimmt. Die Anweisungen \Macro{ISOToday}\ChangedAt{v3.05a}{\Package{scrdate}} und \Macro{IsoToday} liefern direkt das aktuelle Datum in ISO-Schreibweise. Sie unterscheiden sich lediglich darin, dass \Macro{ISOToday} Monat und Tag immer -zweistellig ausgibt, während \Macro{IsoToday} Monat und Tag bei Werten kleiner +zweistellig ausgibt, während \Macro{IsoToday} Monat und Tag bei Werten kleiner 10 einstellig ausgibt. Die Anweisung \Macro{todaysname} bietet direkt den -aktuellen Wochentag, während \Macro{todaysnumber} den Wert des aktuellen -Wochentags liefert. Näheres zur Verwendung dieses Wertes ist den obigen -Erklärungen zu den Anweisungen \DescRef{scrdate.cmd.DayNumber} und \DescRef{scrdate.cmd.ISODayNumber} zu +aktuellen Wochentag, während \Macro{todaysnumber} den Wert des aktuellen +Wochentags liefert. Näheres zur Verwendung dieses Wertes ist den obigen +Erklärungen zu den Anweisungen \DescRef{scrdate.cmd.DayNumber} und \DescRef{scrdate.cmd.ISODayNumber} zu entnehmen. \begin{Example} - Ich will Ihnen zeigen, an was für einem Wochentag dieses Dokument gesetzt + Ich will Ihnen zeigen, an was für einem Wochentag dieses Dokument gesetzt wurde. Dazu schreibe ich: \begin{lstcode} Dieses Dokument entstand an einem \todaysname. @@ -241,18 +241,18 @@ entnehmen. \end{Example} \begin{Explain} - Wenn\textnote{Tipp!} Sie den Namen des Tages in Kleinbuchstaben benötigen, - weil das in der entsprechenden Sprache innerhalb des Satzes so üblich ist, - können Sie das erreichen, obwohl die Namen der Wochentage in - \Package{scrdate} alle groß geschrieben sind. Greifen Sie mit + Wenn\textnote{Tipp!} Sie den Namen des Tages in Kleinbuchstaben benötigen, + weil das in der entsprechenden Sprache innerhalb des Satzes so üblich ist, + können Sie das erreichen, obwohl die Namen der Wochentage in + \Package{scrdate} alle groß geschrieben sind. Greifen Sie mit % Umbruchkorrektur: listings \begin{lstcode} \MakeLowercase{\todaysname} \end{lstcode} einfach auf die \LaTeX-Anweisung \Macro{MakeLowercase}\IndexCmd{MakeLowercase}% - \important{\Macro{MakeLowercase}} zurück. Diese wandelt ihr Argument - komplett in Kleinbuchstaben. Natürlich funktioniert dieser Tipp auch für + \important{\Macro{MakeLowercase}} zurück. Diese wandelt ihr Argument + komplett in Kleinbuchstaben. Natürlich funktioniert dieser Tipp auch für obige Anweisungen \DescRef{scrdate.cmd.DayNameByNumber}\IndexCmd{DayNameByNumber}, \DescRef{scrdate.cmd.DayName}\IndexCmd{DayName} und \DescRef{scrdate.cmd.ISODayName}\IndexCmd{ISODayName}.% @@ -264,11 +264,11 @@ entnehmen. \Macro{nameday}\Parameter{Name} \end{Declaration}% So wie mit \DescRef{maincls.cmd.date}\IndexCmd{date} die Ausgabe von -\Macro{today} direkt geändert werden kann, setzt \Macro{nameday} die Ausgabe +\Macro{today} direkt geändert werden kann, setzt \Macro{nameday} die Ausgabe von \DescRef{scrdate.cmd.todaysname} auf den Wert \PName{Name}. \begin{Example} Sie setzen mit \DescRef{maincls.cmd.date} das aktuelle Datum auf einen - festen Wert. Für die Ausgabe des zugehörigen Wochentags interessiert es nur, + festen Wert. Für die Ausgabe des zugehörigen Wochentags interessiert es nur, dass dieser Tag ein Werktag war. Daher schreiben Sie \begin{lstcode} \nameday{Werktag} @@ -279,7 +279,7 @@ von \DescRef{scrdate.cmd.todaysname} auf den Wert \PName{Name}. Dieses Dokument entstand an einem {\todaysname}. \end{quote} \end{Example} -Für \DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} und +Für \DescRef{scrdate.cmd.ISOToday}\IndexCmd{ISOToday} und \DescRef{scrdate.cmd.IsoToday}\IndexCmd{IsoToday} existieren keine entsprechenden Anweisungen.% \EndIndexGroup @@ -294,7 +294,7 @@ Anweisungen.% \end{Declaration} Das \Package{scrdate}-Paket beherrscht derzeit die folgenden Sprachen: \begin{itemize}\raggedright\setlength{\itemsep}{.5\itemsep} -\item Dänisch (\PValue{danish}), +\item Dänisch (\PValue{danish}), \item Deutsch (\PValue{austrian}\ChangedAt{v3.08b}{\Package{scrdate}}, \PValue{german}, \PValue{naustrian}, \PValue{ngerman}, \PValue{nswissgerman}, \PValue{swissgerman}\ChangedAt{v3.13}{\Package{scrdate}}), @@ -303,11 +303,11 @@ Das \Package{scrdate}-Paket beherrscht derzeit die folgenden Sprachen: \PValue{newzealand}, \PValue{UKenglish}, \PValue{ukenglish}, \PValue{USenglish}, \PValue{usenglish}), \item Finnisch (\PValue{finnish}), -\item Französisch (\PValue{acadian}, \PValue{canadien}, +\item Französisch (\PValue{acadian}, \PValue{canadien}, \PValue{francais}\ChangedAt{v3.13}{\Package{scrdate}}, \PValue{french}), \item Italienisch (\PValue{italian}), \item Kroatisch (\PValue{croatian}), -\item Niederländisch (\PValue{dutch}), +\item Niederländisch (\PValue{dutch}), \item Norwegisch (\PValue{norsk}), \item Polnisch (\PValue{polish}\ChangedAt{v3.13}{\Package{scrdate}}), \item Schwedisch (\PValue{swedish}), @@ -315,25 +315,25 @@ Das \Package{scrdate}-Paket beherrscht derzeit die folgenden Sprachen: \item Spanisch (\PValue{spanish}), \item Tschechisch (\PValue{czech}\ChangedAt{v3.13}{\Package{scrdate}}). \end{itemize} -Es kann aber auch für andere Sprachen konfiguriert werden. Dazu gibt man als +Es kann aber auch für andere Sprachen konfiguriert werden. Dazu gibt man als erstes Argument von \Macro{newdaylanguage} den Namen der Sprache an und als weitere Parameter die Namen der entsprechenden Wochentage. Bei der aktuellen Version ist es auch egal, ob \Package{scrdate} vor oder nach \Package{ngerman}\IndexPackage{ngerman}, \Package{babel}\IndexPackage{babel} -oder ähnlichen Paketen geladen wird, in jedem Falle wird die korrekte Sprache -gewählt, vorausgesetzt diese wird unterstützt. +oder ähnlichen Paketen geladen wird, in jedem Falle wird die korrekte Sprache +gewählt, vorausgesetzt diese wird unterstützt. \begin{Explain} - Etwas genauer ausgedrückt: Solange die Sprachauswahl in einer zu + Etwas genauer ausgedrückt: Solange die Sprachauswahl in einer zu \Package{babel}\IndexPackage{babel} kompatiblen Form erfolgt und die Sprache - \Package{scrdate} bekannt ist, wird die Sprache korrekt gewählt. Ist dies - nicht der Fall, werden (US-)englische Ausdrücke verwendet. + \Package{scrdate} bekannt ist, wird die Sprache korrekt gewählt. Ist dies + nicht der Fall, werden (US-)englische Ausdrücke verwendet. \end{Explain} -Natürlich ist es sinnvoll Definitionen für bisher nicht unterstützte Sprachen +Natürlich ist es sinnvoll Definitionen für bisher nicht unterstützte Sprachen an den \KOMAScript-Autor zu melden. In diesem Fall stehen die Chancen gut, -dass künftige \KOMAScript-Versionen die Sprache ebenfalls unterstützen +dass künftige \KOMAScript-Versionen die Sprache ebenfalls unterstützen werden.% \EndIndexGroup % @@ -346,9 +346,9 @@ werden.% \BeginIndex{Package}{scrtime} Mit Hilfe dieses Pakets kann die Frage nach der aktuellen Zeit beantwortet -werden. Seit Version~3.05 unterstützt das Paket auch die von den +werden. Seit Version~3.05 unterstützt das Paket auch die von den \KOMAScript-Klassen und diversen anderen \KOMAScript-Paketen bekannten -Möglichkeiten zur Angabe von Optionen. Siehe dazu beispielsweise +Möglichkeiten zur Angabe von Optionen. Siehe dazu beispielsweise \autoref{sec:typearea.options}. \begin{Declaration}% @@ -358,7 +358,7 @@ Möglichkeiten zur Angabe von Optionen. Siehe dazu beispielsweise \Macro{thistime} liefert die aktuelle Zeit\Index{Zeit} in Stunden und Minuten. In der Ausgabe wird zwischen den Stunden und Minuten das optionale Argument \PName{Trennung} gesetzt. Voreingestellt ist das Zeichen -»\PValue{:}«. +»\PValue{:}«. \Macro{thistime*} funktioniert fast genau wie \Macro{thistime}. Der einzige Unterschied besteht darin, dass im Gegensatz zu @@ -379,18 +379,18 @@ erweitert wird. Ihr Zug geht um 23:09 Uhr. \end{quote} \bigskip - Demgegenüber liefert die Zeile + Demgegenüber liefert die Zeile \begin{lstcode} - Beim nächsten Ton ist es \thistime*[\ Uhr,\ ] + Beim nächsten Ton ist es \thistime*[\ Uhr,\ ] Minuten und 42 Sekunden. \end{lstcode} - als mögliches Ergebnis etwas wie + als mögliches Ergebnis etwas wie \begin{quote} - Beim nächsten Ton ist es 8\ Uhr,\ 41 Minuten und 42 Sekunden. + Beim nächsten Ton ist es 8\ Uhr,\ 41 Minuten und 42 Sekunden. \end{quote} oder \begin{quote} - Beim nächsten Ton ist es 23\ Uhr,\ 9 Minuten und 42 Sekunden. + Beim nächsten Ton ist es 23\ Uhr,\ 9 Minuten und 42 Sekunden. \end{quote} \end{Example} \EndIndexGroup @@ -404,7 +404,7 @@ erweitert wird. %\footnote{Allerdings darf man nicht erwarten, dass nun die Zeit % stillsteht!} . % -Anschließend wird das optionale Argument von \DescRef{scrtime.cmd.thistime} bzw. +Anschließend wird das optionale Argument von \DescRef{scrtime.cmd.thistime} bzw. \DescRef{scrtime.cmd.thistime*} ignoriert, da ja die komplette Zeichenkette, die \DescRef{scrtime.cmd.thistime} bzw. \DescRef{scrtime.cmd.thistime*} nun liefert, hiermit explizit festgelegt wurde.% @@ -415,10 +415,10 @@ festgelegt wurde.% \OptionVName{12h}{Ein-Aus-Wert} \end{Declaration}% \BeginIndex{Option}{24h}% -Mit der Option \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} kann gewählt +Mit der Option \Option{12h}\ChangedAt{v3.05a}{\Package{scrtime}} kann gewählt werden, ob die Zeit bei \DescRef{scrtime.cmd.thistime} und \DescRef{scrtime.cmd.thistime*} im 12-Stunden- oder 24-Stunden-Format ausgegeben werden soll. Als \PName{Ein-Aus-Wert} kann -dabei einer der Standardwerte für einfache Schalter aus +dabei einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Wird die Option ohne Wert-Angabe verwendet, so wird der Wert \PValue{true} angenommen, also auf das 12-Stunden-Format geschaltet. @@ -434,14 +434,14 @@ Die Option kann wahlweise als Klassenoption bei \DescRef{typearea.cmd.KOMAoption} (siehe beispielsweise \autoref{sec:typearea.options}, \DescPageRef{typearea.cmd.KOMAoptions}) gesetzt werden. Sie verliert jedoch bei einem Aufruf von -\DescRef{scrtime.cmd.settime} ihre Gültigkeit. Die Uhrzeit wird nach +\DescRef{scrtime.cmd.settime} ihre Gültigkeit. Die Uhrzeit wird nach Verwendung dieser Anweisung nur noch mit dem dort angegebenen Wert im dort verwendeten Format ausgegeben. -Rein\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren Versionen +Rein\textnote{Achtung!} aus Gründen der Kompatibilität zu früheren Versionen von \Package{scrtime} wird bei \DescRef{typearea.cmd.documentclass} und \DescRef{typearea.cmd.usepackage} auch noch die Option \Option{24h} zur -Umschaltung auf das 24-Stunden-Format unterstützt. Deren Verwendung wird +Umschaltung auf das 24-Stunden-Format unterstützt. Deren Verwendung wird jedoch nicht mehr empfohlen.% \EndIndexGroup % @@ -450,10 +450,10 @@ jedoch nicht mehr empfohlen.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "scrlayer-de.tex" %%% TeX-PDF-mode: t %%% End: -% LocalWords: Gregorianischen Zählweise Ordnungszahl +% LocalWords: Gregorianischen Zählweise Ordnungszahl diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrextend.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrextend.tex index c124db974c..ae00fd978d 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrextend.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrextend.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrextend.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,55 +40,55 @@ % % ---------------------------------------------------------------------- % -% Paket scrextend für Dokument-Autoren +% Paket scrextend für Dokument-Autoren % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{scrextend.tex} - [$Date: 2018-01-24 11:44:29 +0100 (Wed, 24 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script package scrextend] -\chapter[tocentry={Grundlegende Fähigkeiten der +\chapter[tocentry={Grundlegende Fähigkeiten der \KOMAScript-Klassen\protect\linebreak - mit Hilfe des Pakets \Package{scrextend} anderen Klassen erschließen}, - head={Fähigkeiten von \KOMAScript-Klassen mit \Package{scrextend}}] -{Grundlegende Fähigkeiten der \KOMAScript-Klassen mit Hilfe des Pakets - \Package{scrextend} anderen Klassen erschließen} + mit Hilfe des Pakets \Package{scrextend} anderen Klassen erschließen}, + head={Fähigkeiten von \KOMAScript-Klassen mit \Package{scrextend}}] +{Grundlegende Fähigkeiten der \KOMAScript-Klassen mit Hilfe des Pakets + \Package{scrextend} anderen Klassen erschließen} \labelbase{scrextend} \BeginIndexGroup \BeginIndex{Package}{scrextend}% -Es gibt einige Möglichkeiten, die allen \KOMAScript-Klassen gemeinsam +Es gibt einige Möglichkeiten, die allen \KOMAScript-Klassen gemeinsam sind. Dies betrifft in der Regel nicht nur die Klassen \Class{scrbook}, -\Class{scrreprt} und \Class{scrartcl}, die als Ersatz für die Standardklassen -\Class{book}, \Class{report} und \Class{article} für Bücher, Berichte und +\Class{scrreprt} und \Class{scrartcl}, die als Ersatz für die Standardklassen +\Class{book}, \Class{report} und \Class{article} für Bücher, Berichte und Artikel gedacht sind, sondern in weiten Teilen auch die \KOMAScript-Klasse -\Class{scrlttr2}, die als Nachfolger von \Class{scrlettr} für Briefe gedacht -ist. Diese grundlegenden Möglichkeiten, die in den genannten Klassen zu finden +\Class{scrlttr2}, die als Nachfolger von \Class{scrlettr} für Briefe gedacht +ist. Diese grundlegenden Möglichkeiten, die in den genannten Klassen zu finden sind, werden von \KOMAScript{} ab Version~3.00 auch vom Paket \Package{scrextend} bereitgestellt. Dieses Paket sollte nicht\textnote{Achtung!} mit \KOMAScript-Klassen verwendet werden. Es ist -ausschließlich zur Verwendung mit anderen Klassen gedacht. Der Versuch, das +ausschließlich zur Verwendung mit anderen Klassen gedacht. Der Versuch, das Paket mit einer \KOMAScript-Klasse zu laden, wird von \Package{scrextend} erkannt und mit einer Warnung abgelehnt. Dass \hyperref[cha:scrlttr2]{\Package{scrletter}}\IndexPackage{scrletter} nicht nur mit \KOMAScript-Klassen, sondern auch mit den Standardklassen -verwendet werden kann, liegt übrigens teilweise an \Package{scrextend}. Stellt -\hyperref[cha:scrlttr2]{\Package{scrletter}} nämlich fest, dass es nicht mit -einer \KOMAScript-Klasse verwendet wird, so lädt es automatisch -\Package{scrextend}. Damit stehen dann alle unbedingt benötigten Möglichkeiten -der \KOMAScript-Klassen zur Verfügung. - -Es gibt natürlich keine Garantie, dass \Package{scrextend} mit jeder -beliebigen Klasse zusammenarbeitet. Es ist primär für die Erweiterung der +verwendet werden kann, liegt übrigens teilweise an \Package{scrextend}. Stellt +\hyperref[cha:scrlttr2]{\Package{scrletter}} nämlich fest, dass es nicht mit +einer \KOMAScript-Klasse verwendet wird, so lädt es automatisch +\Package{scrextend}. Damit stehen dann alle unbedingt benötigten Möglichkeiten +der \KOMAScript-Klassen zur Verfügung. + +Es gibt natürlich keine Garantie, dass \Package{scrextend} mit jeder +beliebigen Klasse zusammenarbeitet. Es ist primär für die Erweiterung der Standardklassen und davon abgeleiteten Klassen gedacht. In jedem Fall sollten -Benutzer zunächst prüfen, ob die verwendete Klasse nicht selbst entsprechende -Möglichkeiten bereitstellt. +Benutzer zunächst prüfen, ob die verwendete Klasse nicht selbst entsprechende +Möglichkeiten bereitstellt. -Neben den in diesem Kapitel beschriebenen Möglichkeiten gibt es einige -weitere, die jedoch hauptsächlich für Klassen- und Paketautoren gedacht +Neben den in diesem Kapitel beschriebenen Möglichkeiten gibt es einige +weitere, die jedoch hauptsächlich für Klassen- und Paketautoren gedacht sind. Diese sind in \autoref{cha:scrbase}, ab \autopageref{cha:scrbase} zu finden. Das dort dokumentierte Paket \hyperref[cha:scrbase]{\Package{scrbase}}% @@ -100,55 +100,55 @@ Auch das Paket \hyperref[cha:scrlfile]{\Package{scrlfile}}% \important{\hyperref[cha:scrlfile]{\Package{scrlfile}}}\IndexPackage{scrlfile} aus \autoref{cha:scrlfile} ab \autopageref{cha:scrlfile} wird von allen \KOMAScript-Klassen und dem Paket \Package{scrextend} geladen. Daher stehen -auch dessen Möglichkeiten bei Verwendung von \Package{scrextend} zur -Verfügung. +auch dessen Möglichkeiten bei Verwendung von \Package{scrextend} zur +Verfügung. \iftrue % Umbruchkorrekturtext -Im Unterschied dazu wird das ebenfalls für Klassen- und Paketautoren gedachte +Im Unterschied dazu wird das ebenfalls für Klassen- und Paketautoren gedachte Paket \hyperref[cha:tocbasic]{\Package{tocbasic}} (siehe \autoref{cha:tocbasic} ab \autopageref{cha:tocbasic}) nur von den Klassen \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} geladen, so dass die -dort definierten Möglichkeiten auch nur in diesen Klassen und nicht in -\Package{scrextend} zu finden sind. Natürlich kann +dort definierten Möglichkeiten auch nur in diesen Klassen und nicht in +\Package{scrextend} zu finden sind. Natürlich kann \hyperref[cha:tocbasic]{\Package{tocbasic}} aber auch zusammen mit \Package{scrextend} verwendet werden.% \fi -\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl bei \KOMAScript} +\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl bei \KOMAScript} -\LoadCommonFile{compatibility}% \section{Kompatibilität zu früheren Versionen von \KOMAScript} +\LoadCommonFile{compatibility}% \section{Kompatibilität zu früheren Versionen von \KOMAScript} -\section{Optionale, erweiterte Möglichkeiten} +\section{Optionale, erweiterte Möglichkeiten} \seclabel{optionalFeatures} -Das Paket \Package{scrextend} kennt optional verfügbare, erweiterte -Möglichkeiten. Das sind Möglichkeiten, die in der Grundeinstellung nicht -vorhanden sind, aber zusätzlich ausgewählt werden können. Diese +Das Paket \Package{scrextend} kennt optional verfügbare, erweiterte +Möglichkeiten. Das sind Möglichkeiten, die in der Grundeinstellung nicht +vorhanden sind, aber zusätzlich ausgewählt werden können. Diese sind beispielsweise deshalb optional, weil sie potentiell in Konflikt mit den -Möglichkeiten der Standardklassen oder häufig benutzter Pakete stehen. +Möglichkeiten der Standardklassen oder häufig benutzter Pakete stehen. \begin{Declaration} - \OptionVName{extendedfeature}{Möglichkeit} + \OptionVName{extendedfeature}{Möglichkeit} \end{Declaration} -Mit dieser Option kann eine optionale Möglichkeit von \Package{scrextend} -ausgewählt werden. Diese Option steht nur während des Ladens von -\Package{scrextend} zur Verfügung. Anwender geben diese Option daher als +Mit dieser Option kann eine optionale Möglichkeit von \Package{scrextend} +ausgewählt werden. Diese Option steht nur während des Ladens von +\Package{scrextend} zur Verfügung. Anwender geben diese Option daher als optionales Argument von \DescRef{\LabelBase.cmd.usepackage}\PParameter{scrextend} an. % \iffree{% - Eine Übersicht über die verfügbaren optionalen Möglichkeiten bietet + Eine Ãœbersicht über die verfügbaren optionalen Möglichkeiten bietet \autoref{tab:scrextend.optionalFeatures}. \begin{table} - \caption[{Optional verfügbare, erweiterte Möglichkeiten - von \Package{scrextend}}]{Übersicht über die optional verfügbaren, - erweiterten Möglichkeiten von \Package{scrextend}} + \caption[{Optional verfügbare, erweiterte Möglichkeiten + von \Package{scrextend}}]{Ãœbersicht über die optional verfügbaren, + erweiterten Möglichkeiten von \Package{scrextend}} \label{tab:scrextend.optionalFeatures} \begin{desctabular} \entry{\PName{title}}{% - die Titelseiten werden auf die Möglichkeiten der \KOMAScript-Klassen - erweitert; dies betrifft neben den Anweisungen für die Titelseiten + die Titelseiten werden auf die Möglichkeiten der \KOMAScript-Klassen + erweitert; dies betrifft neben den Anweisungen für die Titelseiten auch die Option \DescRef{\LabelBase.option.titlepage} (siehe \autoref{sec:scrextend.titlepage}, ab \autopageref{sec:scrextend.titlepage})% @@ -157,10 +157,10 @@ optionales Argument von \end{table}% }{% \par% - Die derzeit einzige optionale Möglichkeit ist + Die derzeit einzige optionale Möglichkeit ist \PValue{title}\IndexOption[indexmain]{extendedfeature~=\textKValue{title}}% \important{\OptionValue{extendedfeature}{title}}. - Damit werden die Titelseiten auf die Möglichkeiten der \KOMAScript-Klassen + Damit werden die Titelseiten auf die Möglichkeiten der \KOMAScript-Klassen erweitert, wie sie in \autoref{sec:scrextend.titlepage} ab \autopageref{sec:scrextend.titlepage} beschrieben sind.% }% @@ -170,7 +170,7 @@ optionales Argument von \LoadCommonFile{draftmode}% \section{Entwurfsmodus} -\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} +\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} \LoadCommonFile{textmarkup}% \section{Textauszeichnungen} @@ -184,7 +184,7 @@ optionales Argument von Eine der allgemeinen Eigenschaften eines Dokuments ist der Seitenstil\Index[indexmain]{Seiten>Stil}. Bei {\LaTeX} versteht man unter dem -Seitenstil in erster Linie den Inhalt der Kopf- und Fußzeilen. Das Paket +Seitenstil in erster Linie den Inhalt der Kopf- und Fußzeilen. Das Paket \Package{scrextend} definiert selbst keine Seitenstile, nutzt aber Seitenstile des \LaTeX-Kerns. @@ -195,23 +195,23 @@ Seitenstile des \LaTeX-Kerns. \BeginIndex{}{Titel>Seitenstil}% Auf einigen Seiten wird mit Hilfe von \DescRef{maincls.cmd.thispagestyle}\IndexCmd{thispagestyle} automatisch ein -anderer Seitenstil gewählt. Bei \Package{scrextend} betrifft dies bisher nur +anderer Seitenstil gewählt. Bei \Package{scrextend} betrifft dies bisher nur die Titelseiten und auch dies nur, wenn mit \OptionValueRef{\LabelBase}{extendedfeature}{title} gearbeitet wird (siehe \autoref{sec:scrextend.optionalFeatures}, \DescPageRef{scrextend.option.extendedfeature}). Welcher Seitenstil in diesem -Fall für einen +Fall für einen Titelkopf\important{\OptionValueRef{\LabelBase}{titlepage}{false}}% \IndexOption{titlepage~=\textKValue{false}}\Index{Titel>Kopf} verwendet wird, ist im Makro \Macro{titlepagestyle} festgelegt. In der Voreinstellung ist das der Seitenstil \DescRef{maincls.pagestyle.plain}\IndexPagestyle{plain}. Dieser Seitenstil wird bereits im \LaTeX-Kern vordefiniert und sollte daher immer -verfügbar sein.% +verfügbar sein.% \EndIndexGroup \LoadCommonFile{interleafpage}% \section{Vakatseiten} -\LoadCommonFile{footnotes}% \section{Fußnoten} +\LoadCommonFile{footnotes}% \section{Fußnoten} \LoadCommonFile{dictum}% \section{Schlauer Spruch} @@ -225,6 +225,6 @@ verfügbar sein.% %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "guide.tex" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrhack.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrhack.tex index 9d9b3faed2..38f281f3b6 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrhack.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrhack.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrhack.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------------- % -% Kapitel über scrhack in der KOMA-Script-Anleitung +% Kapitel über scrhack in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrhack.tex} - [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrhack)] \chapter{Fremdpakete verbessern mit \Package{scrhack}} @@ -54,26 +54,26 @@ \BeginIndexGroup \BeginIndex{Package}{scrhack} -Einige Pakete außerhalb von \KOMAScript{} arbeiten nicht sehr gut mit -\KOMAScript{} zusammen. Für den \KOMAScript-Autor ist es dabei oftmals sehr -mühsam, die Autoren der jeweiligen Pakete von einer Verbesserung zu -überzeugen. Das betrifft auch Pakete, deren Entwicklung eingestellt -wurde. Deshalb wurde das Paket \Package{scrhack} begonnen. Dieses Paket ändert +Einige Pakete außerhalb von \KOMAScript{} arbeiten nicht sehr gut mit +\KOMAScript{} zusammen. Für den \KOMAScript-Autor ist es dabei oftmals sehr +mühsam, die Autoren der jeweiligen Pakete von einer Verbesserung zu +überzeugen. Das betrifft auch Pakete, deren Entwicklung eingestellt +wurde. Deshalb wurde das Paket \Package{scrhack} begonnen. Dieses Paket ändert Anweisungen und Definitionen anderer Pakete, damit sie besser mit -\KOMAScript{} zusammenarbeiten. Einige Änderungen sind auch bei -Verwendung anderer Klassen nützlich. +\KOMAScript{} zusammenarbeiten. Einige Änderungen sind auch bei +Verwendung anderer Klassen nützlich. \section{Entwicklungsstand} \seclabel{draft} -Obwohl das Paket bereits seit längerer Zeit Teil von \KOMAScript{} ist und +Obwohl das Paket bereits seit längerer Zeit Teil von \KOMAScript{} ist und von vielen Anwendern genutzt wird, hat es auch ein Problem: Bei der Umdefinierung von Makros fremder Pakete ist es von der genauen Definition -und Verwendung dieser Makros abhängig. Damit ist es gleichzeitig auch von -bestimmten Versionen dieser Pakete abhängig. Wird eine unbekannte Version +und Verwendung dieser Makros abhängig. Damit ist es gleichzeitig auch von +bestimmten Versionen dieser Pakete abhängig. Wird eine unbekannte Version eines der entsprechenden Pakete verwendet, kann \Package{scrhack} den -notwendigen Patch eventuell nicht ausführen. Im Extremfall kann aber umgekehrt -der Patch einer unbekannten Version auch zu einem Fehler führen. +notwendigen Patch eventuell nicht ausführen. Im Extremfall kann aber umgekehrt +der Patch einer unbekannten Version auch zu einem Fehler führen. Da also \Package{scrhack} immer wieder an neue Versionen fremder Pakete angepasst werden muss, kann es niemals als fertig angesehen werden. Daher @@ -86,42 +86,42 @@ nicht dauerhaft garantiert werden. \section{Verwendung von \Package{tocbasic}} \seclabel{improvement} -In den Anfängen von \KOMAScript{} gab es von Anwenderseite den Wunsch, dass +In den Anfängen von \KOMAScript{} gab es von Anwenderseite den Wunsch, dass Verzeichnisse von Gleitumgebungen, die mit dem Paket \Package{float}\IndexPackage{float}\important{\Package{float}} erzeugt werden, genauso behandelt werden wie das Abbildungsverzeichnis oder das Tabellenverzeichnis, das von den \KOMAScript-Klassen selbst angelegt wird. Damals setzte sich der \KOMAScript-Autor mit dem Autor von -\Package{float} in Verbindung, um diesem eine Schnittstelle für entsprechende +\Package{float} in Verbindung, um diesem eine Schnittstelle für entsprechende Erweiterungen zu unterbreiten. In etwas abgewandelter Form wurde diese in Gestalt der beiden Anweisungen \Macro{float@listhead}\IndexCmd[indexmain]{float@listhead} und \Macro{float@addtolists}\IndexCmd[indexmain]{float@addtolists} realisiert. -Später zeigte sich, dass diese beiden Anweisungen nicht genug Flexibilität für -eine umfangreiche Unterstützung aller \KOMAScript-Möglichkeiten boten. Leider +Später zeigte sich, dass diese beiden Anweisungen nicht genug Flexibilität für +eine umfangreiche Unterstützung aller \KOMAScript-Möglichkeiten boten. Leider hatte der Autor von \Package{float} die Entwicklung aber bereits eingestellt, -so dass hier keine Änderungen mehr zu erwarten sind. +so dass hier keine Änderungen mehr zu erwarten sind. -Andere Paketautoren haben die beiden Anweisungen ebenfalls übernommen. Dabei +Andere Paketautoren haben die beiden Anweisungen ebenfalls übernommen. Dabei zeigte sich, dass die Implementierung in einigen Paketen, darunter auch -\Package{float}, dazu führt, dass all diese Pakete nur in einer bestimmten -Reihenfolge geladen werden können, obwohl sie ansonsten in keinerlei Beziehung +\Package{float}, dazu führt, dass all diese Pakete nur in einer bestimmten +Reihenfolge geladen werden können, obwohl sie ansonsten in keinerlei Beziehung zueinander stehen. -Um all diese Nachteile und Probleme zu beseitigen, unterstützt \KOMAScript{} +Um all diese Nachteile und Probleme zu beseitigen, unterstützt \KOMAScript{} diese alte Schnittstelle offiziell nicht mehr. Stattdessen wird bei Verwendung dieser Schnittstelle von \KOMAScript{} gewarnt. Gleichzeitig wurde in \KOMAScript{} das Paket \Package{tocbasic}\IndexPackage{tocbasic}\important{\Package{tocbasic}} (siehe -\autoref{cha:tocbasic}) als zentrale Schnittstelle für die Verwaltung von +\autoref{cha:tocbasic}) als zentrale Schnittstelle für die Verwaltung von Verzeichnissen entworfen und realisiert. Die Verwendung dieses Pakets bietet -weit mehr Vorteile und Möglichkeiten als die beiden alten Anweisungen. +weit mehr Vorteile und Möglichkeiten als die beiden alten Anweisungen. Obwohl der Aufwand zur Verwendung dieses Pakets sehr gering ist, haben bisher die Autoren der Pakete, die auf die beiden alten Anweisungen gesetzt haben, -keine Anpassung vorgenommen. Daher enthält \Package{scrhack} selbst -entsprechende Anpassungen für die Pakete +keine Anpassung vorgenommen. Daher enthält \Package{scrhack} selbst +entsprechende Anpassungen für die Pakete \Package{float}\IndexPackage{float}\important{\Package{float}, \Package{floatrow}, \Package{listings}}, \Package{floatrow}\IndexPackage{floatrow} und @@ -130,44 +130,44 @@ entsprechende Anpassungen für die Pakete von Option \DescRef{maincls.option.listof}\IndexOption{listof~=\PName{Einstellung}}, sondern beachten auch Sprachumschaltungen durch das -\Package{babel}-Paket\IndexPackage{babel}. Näheres zu den Möglichkeiten, die -durch die Umstellung der Pakete auf \Package{tocbasic} nun zur Verfügung +\Package{babel}-Paket\IndexPackage{babel}. Näheres zu den Möglichkeiten, die +durch die Umstellung der Pakete auf \Package{tocbasic} nun zur Verfügung stehen, ist \autoref{sec:tocbasic.toc} zu entnehmen. -Sollte diese Änderung für eines der Pakete nicht erwünscht sein oder zu -Problemen führen, so kann sie selektiv mit den Einstellungen +Sollte diese Änderung für eines der Pakete nicht erwünscht sein oder zu +Problemen führen, so kann sie selektiv mit den Einstellungen \OptionValue{float}{false}\IndexOption[indexmain]{float~=\textKValue{false}}, \OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\textKValue{false}} und \OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\textKValue{false}} -abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung -der Optionen nach dem Laden des zugehörigen Pakets keinen Einfluss mehr hat! +abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung +der Optionen nach dem Laden des zugehörigen Pakets keinen Einfluss mehr hat! \section{Falsche Erwartungen an \Macro{@ptsize}} \seclabel{ptsize} -Einige Pakete gehen grundsätzlich davon aus, dass das klasseninterne Makro +Einige Pakete gehen grundsätzlich davon aus, dass das klasseninterne Makro \Macro{@ptsize}\IndexCmd{@ptsize} sowohl definiert ist als auch zu einer -ganzen Zahl expandiert. Aus Kompatibilitätsgründen definiert \KOMAScript{} -\Macro{@ptsize} auch bei anderen Grundschriftgrößen als 10\Unit{pt}, -11\Unit{pt} oder 12\Unit{pt}. Da \KOMAScript{} außerdem auch gebrochene -Schriftgrößen erlaubt, kann dabei \Macro{@ptsize} natürlich auch zu einem +ganzen Zahl expandiert. Aus Kompatibilitätsgründen definiert \KOMAScript{} +\Macro{@ptsize} auch bei anderen Grundschriftgrößen als 10\Unit{pt}, +11\Unit{pt} oder 12\Unit{pt}. Da \KOMAScript{} außerdem auch gebrochene +Schriftgrößen erlaubt, kann dabei \Macro{@ptsize} natürlich auch zu einem Dezimalbruch expandieren. Eines\ChangedAt{v3.17}{\Package{scrhack}} der Pakete, die damit nicht zurecht kommen, ist das Paket \Package{setspace}\IndexPackage[indexmain]{setspace}% -\important{\Package{setspace}}. Darüber hinaus sind die von diesem Paket -eingestellten Werte immer von der Grundschriftgröße abhängig, auch wenn die -Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket -\Package{scrhack} löst beide Probleme, indem es die Einstellungen von +\important{\Package{setspace}}. Darüber hinaus sind die von diesem Paket +eingestellten Werte immer von der Grundschriftgröße abhängig, auch wenn die +Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket +\Package{scrhack} löst beide Probleme, indem es die Einstellungen von \Macro{onehalfspacing} und \Macro{doublespacing} immer relativ zur aktuellen, -tatsächlichen Schriftgröße vornimmt. +tatsächlichen Schriftgröße vornimmt. -Sollte diese Änderung nicht erwünscht sein oder zu Problemen führen, so kann +Sollte diese Änderung nicht erwünscht sein oder zu Problemen führen, so kann sie selektiv mit der Einstellung \OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\textKValue{false}} -abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung +abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung der Option nach dem Laden von \Package{setspace} keinen Einfluss mehr hat! Ebenso muss \Package{scrhack} vor \Package{setspace} geladen werden, falls \Package{setspace} mit einer der Optionen \Option{onehalfspacing} oder @@ -178,16 +178,16 @@ auswirken soll. \section{Sonderfall \Package{hyperref}} \seclabel{hyperref} -Ältere Versionen von +Ältere Versionen von \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}} vor 6.79h haben bei den Sternformen der Gliederungsbefehle hinter statt vor oder -auf die Gliederungsüberschriften verlinkt. Inzwischen ist dieses Problem auf -Vorschlag des \KOMAScript-Autors beseitigt. Da die entsprechende Änderung aber -über ein Jahr auf sich warten ließ, wurde in \Package{scrhack} ein +auf die Gliederungsüberschriften verlinkt. Inzwischen ist dieses Problem auf +Vorschlag des \KOMAScript-Autors beseitigt. Da die entsprechende Änderung aber +über ein Jahr auf sich warten ließ, wurde in \Package{scrhack} ein entsprechender Patch aufgenommen. Zwar kann dieser ebenfalls durch \OptionValue{hyperref}{false} deaktiviert werden, empfohlen wird jedoch stattdessen die aktuelle Version von \Package{hyperref} zu verwenden. In -diesem Fall wird die Änderung durch \Package{scrhack} automatisch verhindert. +diesem Fall wird die Änderung durch \Package{scrhack} automatisch verhindert. \section{Inkonsistente Behandlung von \Length{textwidth} und \Length{textheight}} @@ -197,31 +197,31 @@ Das\ChangedAt{v3.18}{\Package{scrhack}} Paket \Package{lscape}\IndexPackage[indexmain]{lscape}% \important{\Package{lscape}} definiert eine Umgebung \Environment{landscape}\IndexEnv{landscape}, um den Inhalt einer Seite aber -nicht deren Kopf und Fuß quer zu setzen. Innerhalb dieser Umgebung wird +nicht deren Kopf und Fuß quer zu setzen. Innerhalb dieser Umgebung wird \Length{textheight}\IndexLength{textheight} auf den Wert von \Length{textwidth} gesetzt. Umgekehrt wird jedoch \Length{textwidth} nicht auf den vorherigen Wert von \Length{textheight} gesetzt. Das ist inkonsistent. Meines Wissens wird \Length{textwidth} nicht entsprechend -geändert, weil andere Pakete oder Anwenderanweisungen gestört werden -könnten. Jedoch hat auch die Änderung von \Length{textwidth} dieses Potential -und in der Tat beschädigt sie die Funktion beispielsweise der Pakete +geändert, weil andere Pakete oder Anwenderanweisungen gestört werden +könnten. Jedoch hat auch die Änderung von \Length{textwidth} dieses Potential +und in der Tat beschädigt sie die Funktion beispielsweise der Pakete \Package{showframe}\IndexPackage{showframe} und -\Package{scrlayer}\IndexPackage{scrlayer}. Daher wäre es am besten, wenn -\Length{textheight} ebenfalls unverändert bliebe. \Package{scrhack} verwendet +\Package{scrlayer}\IndexPackage{scrlayer}. Daher wäre es am besten, wenn +\Length{textheight} ebenfalls unverändert bliebe. \Package{scrhack} verwendet Paket \Package{xpatch} (siehe \cite{package:xpatch}), um die Startanweisung -\Macro{landscape} der gleichnamigen Umgebung entsprechend zu ändern. +\Macro{landscape} der gleichnamigen Umgebung entsprechend zu ändern. -Falls diese Änderung nicht gewünscht wird oder Probleme verursacht, kann sie +Falls diese Änderung nicht gewünscht wird oder Probleme verursacht, kann sie mit Option \OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\textKValue{false}} deaktiviert werden. Es ist zu beachten\textnote{Achtung!}, dass eine -nachträgliche Zuweisung an Option \Option{lscape} mit +nachträgliche Zuweisung an Option \Option{lscape} mit \DescRef{\LabelBase.cmd.KOMAoption}\IndexCmd{KOMAoption} oder \DescRef{\LabelBase.cmd.KOMAoptions}\IndexCmd{KOMAoptions} nur eine Wirkung -hat, wenn sie während des Ladens von \Package{lscape} nicht \PValue{false} +hat, wenn sie während des Ladens von \Package{lscape} nicht \PValue{false} war. -Im übrigens wird \Package{lscape} auch von dem Paket +Im übrigens wird \Package{lscape} auch von dem Paket \Package{pdflscape}\IndexPackage[indexmain]{pdflscape}% \important{\Package{pdflscape}} verwendet, so dass \Package{scrhack} sich auch auf die Funktion dieses Pakets auswirkt.% @@ -230,56 +230,96 @@ auf die Funktion dieses Pakets auswirkt.% \section{Sonderfall \Package{nomencl}} \seclabel{nomencl} -Eine\ChangedAt{v3.23}{\Package{scrhack}} Besonderheit stellt der Hack für das +Eine\ChangedAt{v3.23}{\Package{scrhack}} Besonderheit stellt der Hack für das Paket \Package{nomencl}\IndexPackage[indexmain]{nomencl}\important{\Package{nomencl}} -dar. Dieser rüstet einerseits nach, dass der optionale -Inhaltsverzeichniseintrag für die Nomenklatur Option +dar. Dieser rüstet einerseits nach, dass der optionale +Inhaltsverzeichniseintrag für die Nomenklatur Option \OptionValueRef{maincls}{toc}{indentunnumbered} beachtet. Quasi nebenbei -werden über das Paket \Package{tocbasic} auch gleich die Endungen \File{nlo} -und \File{nls} für den Besitzer \PValue{nomencl} reserviert (siehe +werden über das Paket \Package{tocbasic} auch gleich die Endungen \File{nlo} +und \File{nls} für den Besitzer \PValue{nomencl} reserviert (siehe \DescRef{tocbasic.cmd.addtotoclist}, \autoref{sec:tocbasic.basics}, \DescPageRef{tocbasic.cmd.addtotoclist}). -Außerdem wird die Umgebung -\Environment{thenomenclature}\IndexEnv{thenomenclature} so geändert, -dass \DescRef{tocbasic.cmd.tocbasic@listhead}\IndexCmd{tocbasic@listhead} für -die Überschrift verwendet wird (siehe \autoref{sec:tocbasic.internals}, -\DescPageRef{tocbasic.cmd.tocbasic@listhead}). Dadurch können mit dem Hack -diverse Attribute für die Endung \File{nls} über +Außerdem wird die Umgebung +\Environment{thenomenclature}\IndexEnv{thenomenclature} so geändert, +dass \DescRef{tocbasic.cmd.tocbasic@listhead}\IndexCmd{tocbasic@listhead} für +die Ãœberschrift verwendet wird (siehe \autoref{sec:tocbasic.internals}, +\DescPageRef{tocbasic.cmd.tocbasic@listhead}). Dadurch können mit dem Hack +diverse Attribute für die Endung \File{nls} über \DescRef{tocbasic.cmd.setuptoc}\IndexCmd{setuptoc}% \important{\DescRef{tocbasic.cmd.setuptoc}} gesetzt werden. So ist es -beispielsweise möglich, mit +beispielsweise möglich, mit \DescRef{tocbasic.cmd.setuptoc}\PParameter{nls}\PParameter{numbered} die Nomenklatur nicht nur ins Inhaltsverzeichnis einzutragen sondern auch gleich -zu nummerieren. Näheres zu \DescRef{tocbasic.cmd.setuptoc} und den damit -möglichen Einstellungen ist in \autoref{sec:tocbasic.toc}, ab +zu nummerieren. Näheres zu \DescRef{tocbasic.cmd.setuptoc} und den damit +möglichen Einstellungen ist in \autoref{sec:tocbasic.toc}, ab \DescPageRef{tocbasic.cmd.setuptoc} zu finden. Als kleiner aber wichtiger -Nebeneffekt erhält die Nomenklatur mit diesem Patch außerdem einen passenden +Nebeneffekt erhält die Nomenklatur mit diesem Patch außerdem einen passenden Kolumnentitel, falls lebende Kolumnentitel beispielsweise durch Verwendung von Seitenstil \DescRef{maincls.pagestyle.headings} aktiviert wurden. -Dieser eher simple Patch ist damit ein Beispiel dafür, wie auch Pakete, die +Dieser eher simple Patch ist damit ein Beispiel dafür, wie auch Pakete, die keine Gleitumgebungen definieren, Nutzen aus der Verwendung von -\Package{tocbasic} ziehen könnten. Falls diese Änderung jedoch nicht -gewünscht wird oder Probleme verursacht, kann sie mit Option +\Package{tocbasic} ziehen könnten. Falls diese Änderung jedoch nicht +gewünscht wird oder Probleme verursacht, kann sie mit Option \OptionValue{nomencl}{false}\IndexOption[indexmain]{nomencl~=\textKValue{false}} deaktiviert werden. Entscheidend\textnote{Achtung!} ist dabei die Einstellung -der Option zum Zeitpunkt, zu dem \Package{nomencl} geladen wird! Spätere -Änderungen der Option mit \DescRef{\LabelBase.cmd.KOMAoption} oder -\DescRef{\LabelBase.cmd.KOMAoptions} haben also keinen Einfluss und führen zu +der Option zum Zeitpunkt, zu dem \Package{nomencl} geladen wird! Spätere +Änderungen der Option mit \DescRef{\LabelBase.cmd.KOMAoption} oder +\DescRef{\LabelBase.cmd.KOMAoptions} haben also keinen Einfluss und führen zu einer entsprechenen Warnung.% -\EndIndexGroup +\section{Sonderfall Ãœberschriften} +\seclabel{sections} + +Diverse\ChangedAt{v3.27}{\Package{scrhack}} Pakete gehen davon aus, dass +Ãœberschriften auf eine ganz bestimmte Weise definiert sind, die weitgehend den +Definitionen der Standardklassen entsprechen. Dies ist jedoch nicht bei allen +Klassen der Fall. Beispielsweise sind bei den \KOMAScript-Klassen die +Ãœberschriften komplett anders definiert, um viele zusätzliche Möglichkeiten zu +bieten. Das kann einige wenige Pakete aus dem Tritt bringen. Ab Version~3.27 +bietet \Package{scrhack} daher die Möglichkeit, zwangsweise die +Ãœberschriftenbefehle \DescRef{maincls.cmd.part}\IndexCmd{part}, +\DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, +\DescRef{maincls.cmd.section}\IndexCmd{section}, +\DescRef{maincls.cmd.subsection}\IndexCmd{subsection}, +\DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection}, +\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph} und +\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} kompatibel zu den +Standardklassen zu definieren. Dabei werden im Fall, dass +\DescRef{maincls.cmd.chapter} definiert ist, die Definitionen von \Class{book} +zugrunde gelegt. Ist \DescRef{maincls.cmd.chapter} nicht definiert, so werden +die Definitionen von \Class{article} herangezogen. + +Bei Verwendung einer \KOMAScript-Klasse werden als Seiteneffekt zusätzlich +diverse Möglichkeiten dieser Klassen deaktviert. Beispielsweise stehen dann +die Befehle zur Neudefinition oder Änderung der Gliederungsbefehle aus +\autoref{sec:maincls-experts.sections} oder Option +\DescRef{maincls.option.headings} nicht mehr zur Verfügung und Befehle wie +\DescRef{maincls.cmd.partformat} erhalten eine neue Voreinstellung. + +Da dieser Hack häufig mehr Schaden als Nutzen bringt, erzeugt er eine größere +Anzahl an Warnungen. Außerdem ist er nicht bereits durch das Laden von Paket +\Package{scrhack} aktiv, sondern muss beim Laden des Pakets mit Option +\Option{standardsections}\IndexOption[indexmain]{standardsections} explizit +aktiviert werden. Eine nachträgliche Aktivierung oder Deaktivierung ist nicht +möglich. + +Da es für die eingangs erwähnten Probleme oft weniger invasive Lösungen gibt, +wird die Verwendung des Hacks ausdrücklich nicht empfohlen, sondern lediglich +als letzte Rettungschance für Notfälle angeboten.% +\EndIndexGroup + %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: % LocalWords: Eindateiensystem Schreibdatei Zieldatei Zielendung Quellendung -% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei -% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene Sternformen -% LocalWords: Sprachumschaltungen Gliederungsüberschriften Gliederungsbefehle +% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei +% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene Sternformen +% LocalWords: Sprachumschaltungen Gliederungsüberschriften Gliederungsbefehle % LocalWords: Paketautoren diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrjura.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrjura.tex index 05503a86fe..d9727ff1f5 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrjura.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrjura.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrjura.tex -% Copyright (c) Markus Kohm, 2011-2018 +% Copyright (c) Markus Kohm, 2011-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrjura.tex -% Copyright (c) Markus Kohm, 2011-2018 +% Copyright (c) Markus Kohm, 2011-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,44 +46,49 @@ % ====================================================================== \KOMAProvidesFile{scrjura.tex}% - [$Date: 2018-07-20 09:52:01 +0200 (Fri, 20 Jul 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrjura)] -\chapter{Unterstützung für die Anwaltspraxis durch \Package{scrjura}} +\chapter{Unterstützung für die Anwaltspraxis durch \Package{scrjura}} \labelbase{scrjura} \BeginIndexGroup \BeginIndex{Package}{scrjura} -Will man einen Vertrag\Index{Vertraege=Verträge}, die Satzung einer +Will man einen Vertrag\Index{Vertraege=Verträge}, die Satzung einer Gesellschaft oder eines Vereins, ein Gesetz oder gleich einen -Gesetzeskommentar schreiben, so übernimmt das Paket \Package{scrjura} den -typografischen Teil der Unterstützung für diese Tätigkeit. Obwohl -\Package{scrjura} als allgemeine Hilfe für anwaltliche Schriftstücke angedacht +Gesetzeskommentar schreiben, so übernimmt das Paket \Package{scrjura} den +typografischen Teil der Unterstützung für diese Tätigkeit. Obwohl +\Package{scrjura} als allgemeine Hilfe für anwaltliche Schriftstücke angedacht ist, hat sich gezeigt, dass der Vertrag dabei ein ganz zentrales Element ist. Besonderes Augenmerk gilt hier dem Paragraphen\Index{Paragraphen>juristische} mit Nummer, Titel, nummerierten -Absätzen -- falls es mehrere davon in einem Paragraphen gibt --, bedarfsweise -nummerierten Sätzen, Einträgen in das Inhaltsverzeichnis und Querverweisen in +Absätzen -- falls es mehrere davon in einem Paragraphen gibt --, bedarfsweise +nummerierten Sätzen, Einträgen in das Inhaltsverzeichnis und Querverweisen in den deutschen Gepflogenheiten entsprechenden Formen. Das Paket ist in Zusammenarbeit mit Rechtsanwalt Dr.\,Alexander Willand, -Karlsruhe, entstanden. Viele der Möglichkeiten gehen außerdem auf konstruktive -Nachfragen von Prof.\,Heiner Richter von der Hochschule Stalsund zurück. +Karlsruhe, entstanden. Viele der Möglichkeiten gehen außerdem auf konstruktive +Nachfragen von Prof.\,Heiner Richter von der Hochschule Stalsund zurück. Es ist zu beachten\textnote{Achtung!}, dass das Paket mit \Package{hyperref}\IndexPackage{hyperref} zusammenarbeitet. Es ist dabei -jedoch wichtig, dass \Package{hyperref} wie üblich nach \Package{scrjura} +jedoch wichtig, dass \Package{hyperref} wie üblich nach \Package{scrjura} geladen wird! -\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl} \LoadCommonFile{textmarkup}% \section{Textauszeichnungen} \section{Verzeichnisse} \label{sec:scrjura.toc} -Die Überschriften juristischer Paragraphen können auf Wunsch auch automatisch -ins Inhaltsverzeichnis eingetragen werden. +Die Ãœberschriften juristischer Paragraphen können auf Wunsch auch automatisch +ins Inhaltsverzeichnis eingetragen +werden. Dazu\ChangedAt{v3.27}{\Package{scrjura}} definiert das Paket mit Hilfe +von \DescRef{tocbasic.cmd.DeclareTOCStyleEntry} (siehe +\autoref{sec:tocbasic.tocstyle} ab +\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry})\IndexCmd{DeclareTOCStyleEntry} +die Verzeichnisebene \PValue{cpar}. \begin{Declaration} \OptionVName{juratotoc}{Ein-Aus-Wert} @@ -91,27 +96,33 @@ ins Inhaltsverzeichnis eingetragen werden. \end{Declaration} Im Inhaltsverzeichnis angezeigt werden Paragraphen\Index{Paragraphen>juristische} nur, wenn ihre \PName{Ebenennummer} -kleiner oder gleich dem Zähler \DescRef{maincls.counter.tocdepth}% +kleiner oder gleich dem Zähler \DescRef{maincls.counter.tocdepth}% \important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} ist (siehe \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). Voreingestellt\textnote{Voreinstellung} -ist für \PName{Ebenennummer} der Wert 10000, der auch verwendet wird, wenn die -Option über einen +ist für \PName{Ebenennummer} der Wert \Length{maxdimen}, der auch verwendet +wird, wenn die Option über einen \PName{Ein-Aus-Wert}\important{\OptionValue{juratotoc}{false}} (siehe \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}) -ausgeschaltet wird. Da der Zähler \DescRef{maincls.counter.tocdepth} -üblicherweise einen kleinen, einstelligen Wert besitzt, werden die -Paragraphen-Einträge im Inhaltsverzeichnis daher normalerweise nicht +ausgeschaltet wird. Da der Zähler \DescRef{maincls.counter.tocdepth} +üblicherweise einen kleinen, einstelligen Wert besitzt, werden die +Paragraphen-Einträge im Inhaltsverzeichnis daher normalerweise nicht angezeigt. -Wird die Option hingegen über einen +Wird die Option hingegen über einen \PName{Ein-Aus-Wert}\important{\OptionValue{juratotoc}{true}} eingeschaltet, so wird als \PName{Ebenennummer} 2 voreingestellt. Damit werden sie in Inhaltsverzeichnissen bei allen \KOMAScript-Klassen auf derselben Ebene wie \DescRef{maincls.cmd.subsection}\IndexCmd{subsection}% \important{\DescRef{maincls.cmd.subsection}} eingeordnet. In der Voreinstellung von \DescRef{maincls.counter.tocdepth} werden sie dann auch bei -allen \KOMAScript-Klassen im Inhaltsverzeichnis angezeigt.% +allen \KOMAScript-Klassen im Inhaltsverzeichnis angezeigt. + +Intern\ChangedAt{v3.27}{\Package{scrjura}} führt die Verwendung der Option zu +einem erneuten Aufruf von +\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry} +mit dem \PName{Stil} \PValue{default} und entsprechender Einstellung für +\Option{level} in der \PName{Optionenlist}.% \EndIndexGroup @@ -119,41 +130,47 @@ allen \KOMAScript-Klassen im Inhaltsverzeichnis angezeigt.% \OptionVName{juratocindent}{Einzug} \OptionVName{juratocnumberwidth}{Nummernbreite} \end{Declaration} -Mit diesen beiden Optionen kann für die Einträge der Paragraphen ins -Inhaltsverzeichnis sowohl der Einzug als auch die Breite, die für Nummern +Mit diesen beiden Optionen kann für die Einträge der Paragraphen ins +Inhaltsverzeichnis sowohl der Einzug als auch die Breite, die für Nummern reserviert wird, festgelegt werden. Voreingestellt\textnote{Voreinstellung} -sind dieselben Werte wie für -\DescRef{maincls.cmd.subsection}-Einträge\IndexCmd{subsection}% +sind dieselben Werte wie für +\DescRef{maincls.cmd.subsection}-Einträge\IndexCmd{subsection}% \important{\DescRef{maincls.cmd.subsection}} bei \Class{scrartcl}. -% + +Intern\ChangedAt{v3.27}{\Package{scrjura}} führt die Verwendung der Optionen +zu erneuten Aufrufen von +\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry} mit +dem \PName{Stil} \PValue{default} und \OptionVName{indent}{Einzug} +beziehungsweise \OptionVName{numwidth}{Nummernbreite} in der +\PName{Optionenlist}.% \EndIndexGroup -\section{Umgebung für Verträge} +\section{Umgebung für Verträge} \label{sec:scrjura.contract} \BeginIndexGroup -\BeginIndex{}{Vertraege=Verträge} -Die wesentlichen Mechanismen von \Package{scrjura} stehen ausschließlich -innerhalb von Verträgen der zugehörigen Umgebung zur Verfügung. +\BeginIndex{}{Vertraege=Verträge} +Die wesentlichen Mechanismen von \Package{scrjura} stehen ausschließlich +innerhalb von Verträgen der zugehörigen Umgebung zur Verfügung. \begin{Declaration} \begin{Environment}{contract}\end{Environment} \end{Declaration} -Dies ist die erste und bisher einzige Umgebung für Juristen, die +Dies ist die erste und bisher einzige Umgebung für Juristen, die \Package{scrjura} bereitstellt. Durch ihre Verwendung wird die automatische Absatznummerierung aktiviert und die Anweisungen \DescRef{\LabelBase.cmd.Clause} und \DescRef{\LabelBase.cmd.SubClause} mit -einer konkreten Form versehen, die später näher dokumentiert wird. +einer konkreten Form versehen, die später näher dokumentiert wird. Die\textnote{Achtung!} Umgebung \Environment{contract} darf nicht in sich -selbst geschachtelt werden. Innerhalb eines Dokuments dürfen jedoch mehrere +selbst geschachtelt werden. Innerhalb eines Dokuments dürfen jedoch mehrere dieser Umgebungen verwendet werden. Dabei werden die Paragraphen innerhalb -dieser Umgebungen so behandelt, als stünden sie innerhalb einer einzigen +dieser Umgebungen so behandelt, als stünden sie innerhalb einer einzigen Umgebung. Durch das Beenden der Umgebung wird diese also quasi unterbrochen und durch den Beginn einer neuen Umgebung wird sozusagen die alte Umgebung fortgesetzt. Dabei sind allerdings keine Unterbrechungen innerhalb -eines Paragraphen möglich.% +eines Paragraphen möglich.% \EndIndexGroup \begin{Declaration} @@ -164,13 +181,13 @@ Bei Angabe dieser Option beim Laden des Pakets beispielsweise mit \important{\DescRef{\LabelBase.cmd.usepackage}} oder als globale Option bei \DescRef{\LabelBase.cmd.documentclass}% \important{\DescRef{\LabelBase.cmd.documentclass}} wird das gesamte Dokument -zu einem Vertrag. Das Dokument verhält sich dann also genauso, als würde es +zu einem Vertrag. Das Dokument verhält sich dann also genauso, als würde es genau eine \DescRef{\LabelBase.env.contract}-Umgebung enthalten. Es\textnote{Achtung!} wird darauf hingewiesen, dass Option \Option{contract} weder mit \DescRef{\LabelBase.cmd.KOMAoption} noch \DescRef{\LabelBase.cmd.KOMAoptions} gesetzt werden kann! Damit ist es auch -nicht möglich die Option wieder abzuschalten. Verwenden Sie in einem solchen +nicht möglich die Option wieder abzuschalten. Verwenden Sie in einem solchen Fall stattdessen direkt eine \DescRef{\LabelBase.env.contract}-Umgebung. % \EndIndexGroup @@ -181,12 +198,12 @@ Fall stattdessen direkt eine \DescRef{\LabelBase.env.contract}-Umgebung. \BeginIndexGroup \BeginIndex{}{Paragraphen>juristische} -Paragraphen\footnote{Obwohl der korrekte Begriff für juristische Paragraphen - im Englischen »\emph{section}« wäre, sind die Bezeichnungen in - \Package{scrjura} von »\emph{clause}« abgeleitet. Dadurch sollen +Paragraphen\footnote{Obwohl der korrekte Begriff für juristische Paragraphen + im Englischen »\emph{section}« wäre, sind die Bezeichnungen in + \Package{scrjura} von »\emph{clause}« abgeleitet. Dadurch sollen Verwechslungen sowohl mit \DescRef{maincls.cmd.section} als auch mit \DescRef{maincls.cmd.paragraph} vermieden werden.} im juristischen Sinn -sind bei \Package{scrjura} nur innerhalb von Verträgen, also innerhalb der +sind bei \Package{scrjura} nur innerhalb von Verträgen, also innerhalb der Umgebung \DescRef{\LabelBase.env.contract} oder weiteren mit \DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment} (siehe \autoref{sec:\LabelBase.newenv}, @@ -200,31 +217,31 @@ definiert. \Macro{SubClause}\Parameter{Einstellungen} \end{Declaration} Dies sind die wichtigsten Anweisungen innerhalb eines Vertrags. Ohne -zusätzliche \PName{Einstellungen} erzeugt \Macro{Clause} eine -Paragraphenüberschrift, die nur aus dem Paragraphenzeichen, gefolgt von einer +zusätzliche \PName{Einstellungen} erzeugt \Macro{Clause} eine +Paragraphenüberschrift, die nur aus dem Paragraphenzeichen, gefolgt von einer fortlaufenden Nummer besteht. Dagegen erzeugt \Macro{SubClause} eine -Paragraphenüberschrift, bei der an die zuletzt mit \Macro{Clause} gesetzte -Nummer noch ein fortlaufender Kleinbuchstabe angehängt wird. Gedacht ist -\Macro{SubClause} vor allem für den Fall, dass bei der Novellierung von -Gesetzen oder Verträgen nicht nur Paragraphen umformuliert oder gestrichen -werden, sondern zwischen existierenden Paragraphen neue eingefügt werden, ohne +Paragraphenüberschrift, bei der an die zuletzt mit \Macro{Clause} gesetzte +Nummer noch ein fortlaufender Kleinbuchstabe angehängt wird. Gedacht ist +\Macro{SubClause} vor allem für den Fall, dass bei der Novellierung von +Gesetzen oder Verträgen nicht nur Paragraphen umformuliert oder gestrichen +werden, sondern zwischen existierenden Paragraphen neue eingefügt werden, ohne dass eine komplett neue Nummerierung erfolgt. Als \PName{Einstellungen} kann bei beiden Anweisungen eine durch Komma -separierte Liste von Eigenschaften angegeben werden. Eine Übersicht über die -möglichen Eigenschaften bietet \autoref{tab:scrjura.Clause.options}. Auf die -wichtigsten soll noch näher eingegangen werden. +separierte Liste von Eigenschaften angegeben werden. Eine Ãœbersicht über die +möglichen Eigenschaften bietet \autoref{tab:scrjura.Clause.options}. Auf die +wichtigsten soll noch näher eingegangen werden. \begin{table} - \caption{Mögliche Eigenschaften für die optionalen Argumente der Anweisungen + \caption{Mögliche Eigenschaften für die optionalen Argumente der Anweisungen \Macro{Clause} und \Macro{SubClause}} \label{tab:scrjura.Clause.options} \begin{desctabular} \entry{\Option{dummy}}{% - Die Überschrift wird nicht gesetzt, aber gezählt.% + Die Ãœberschrift wird nicht gesetzt, aber gezählt.% }% \entry{\OptionVName{head}{Kolumnentitel}}{% - Sind Kolumnentitel aktiviert, wird unabhängig von einem Titel für den + Sind Kolumnentitel aktiviert, wird unabhängig von einem Titel für den Paragraphen dieser Kolumnentitel verwendet.% }% \entry{\Option{nohead}}{% @@ -234,33 +251,33 @@ wichtigsten soll noch näher eingegangen werden. Es wird kein Eintrag ins Inhaltsverzeichnis vorgenommen.% }% \entry{\OptionVName{number}{Nummer}}{% - Die Nummer für den Paragraphen wird direkt angegeben.% + Die Nummer für den Paragraphen wird direkt angegeben.% }% \entry{\OptionVName{preskip}{Abstand}}{% - Neuer Abstand vor den Überschriften der Paragraphen.% + Neuer Abstand vor den Ãœberschriften der Paragraphen.% }% \entry{\OptionVName{postskip}{Abstand}}{% - Neuer Abstand nach den Überschrift der Paragraphen.% + Neuer Abstand nach den Ãœberschrift der Paragraphen.% }% - \entry{\OptionVName{title}{Überschrift}}{% - Der Paragraph wird zusätzlich zur Nummer mit einem Titel versehen. Dies - ist gleichzeitig die Grundeinstellung für die Einträge in den + \entry{\OptionVName{title}{Ãœberschrift}}{% + Der Paragraph wird zusätzlich zur Nummer mit einem Titel versehen. Dies + ist gleichzeitig die Grundeinstellung für die Einträge in den Kolumnentitel und das Inhaltsverzeichnis.% }% \entry{\OptionVName{tocentry}{Inhaltsverzeichniseintrag}}{% - Unabhängig von einem Titel für den Paragraphen wird dieser Eintrag ins + Unabhängig von einem Titel für den Paragraphen wird dieser Eintrag ins Inhaltsverzeichnis vorgenommen.% }% \end{desctabular} \end{table} -In der Voreinstellung\textnote{Voreinstellung} wird vor der Überschrift ein -Abstand von zwei Zeilen und danach ein Abstand von einer Zeile eingefügt. Über +In der Voreinstellung\textnote{Voreinstellung} wird vor der Ãœberschrift ein +Abstand von zwei Zeilen und danach ein Abstand von einer Zeile eingefügt. Ãœber die Eigenschaften \Option{preskip}\important[i]{\Option{preskip}, - \Option{postskip}} und \Option{postskip} kann dieser Abstand verändert -werden. Die neue Einstellung gilt dann aber nicht nur für den aktuellen + \Option{postskip}} und \Option{postskip} kann dieser Abstand verändert +werden. Die neue Einstellung gilt dann aber nicht nur für den aktuellen Paragraphen, sondern ab dem aktuellen Paragraphen bis zum Ende der aktuellen -Umgebung. Es ist auch möglich, die entsprechende Einstellung bereits vorab mit +Umgebung. Es ist auch möglich, die entsprechende Einstellung bereits vorab mit Hilfe von \begin{flushleft}\quad\small \textbf{\Macro{setkeys}}\PParameter{contract}% @@ -268,18 +285,18 @@ Hilfe von \normalsize\quad\small \hspace{11.5em}postskip=\PName{Abstand}} \end{flushleft} -unabhängig von einem konkreten Paragraphen und auch außerhalb einer +unabhängig von einem konkreten Paragraphen und auch außerhalb einer \DescRef{\LabelBase.env.contract}-Umgebung vorzunehmen. Auch das Setzen -innerhalb der Präambel nach dem Laden von \Package{scrjura} ist so -möglich. Dagegen ist es nicht möglich, diese beiden Optionen bereits beim +innerhalb der Präambel nach dem Laden von \Package{scrjura} ist so +möglich. Dagegen ist es nicht möglich, diese beiden Optionen bereits beim Laden des Pakets anzugeben oder sie per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} zu setzen. \BeginIndex{FontElement}{contract.Clause}\LabelFontElement{contract.Clause}% \BeginIndex{FontElement}{Clause}\LabelFontElement{Clause}% -In der Voreinstellung\textnote{Voreinstellung} wird für die Überschrift des +In der Voreinstellung\textnote{Voreinstellung} wird für die Ãœberschrift des Paragraphen als Schrift \Macro{sffamily}\Macro{bfseries}\Macro{large} -verwendet. Über das Element +verwendet. Ãœber das Element \FontElement{contract.Clause}\important{\FontElement{contract.Clause}} kann diese Schrift jederzeit mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont}% @@ -287,7 +304,7 @@ diese Schrift jederzeit mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.addtokomafont}} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -geändert werden. Innerhalb der \DescRef{\LabelBase.env.contract}-Umgebung kann +geändert werden. Innerhalb der \DescRef{\LabelBase.env.contract}-Umgebung kann statt \FontElement{contract.Clause} auch \FontElement{Clause}\important{\FontElement{Clause}} verwendet werden.% \EndIndex{FontElement}{Clause}% @@ -295,12 +312,12 @@ statt \FontElement{contract.Clause} auch Mit Hilfe der Einstellungen \Option{title}\important[i]{\Option{title}, \Option{head}, \Option{tocentry}}, \Option{head} und \Option{tocentry} -können Paragraphen zusätzlich zur Nummer mit einem Titel versehen +können Paragraphen zusätzlich zur Nummer mit einem Titel versehen werden. Dabei\textnote{Achtung!} wird empfohlen, den Wert der jeweiligen -Eigenschaft in geschweifte Klammern zu setzen. Anderenfalls führen +Eigenschaft in geschweifte Klammern zu setzen. Anderenfalls führen beispielsweise Kommata zu Verwechslungen mit den Trennzeichen zwischen -unterschiedlichen Eigenschaften. Leere Werte für \Option{head} und -\Option{tocentry} führen zu leeren Einträgen. Will man hingegen keine Einträge +unterschiedlichen Eigenschaften. Leere Werte für \Option{head} und +\Option{tocentry} führen zu leeren Einträgen. Will man hingegen keine Einträge vornehmen, so sind \Option{nohead}\important[i]{\Option{nohead}, \Option{notocentry}} und \Option{notocentry} zu verwenden. @@ -309,31 +326,31 @@ Statt der fortlaufenden Nummer kann mit Hilfe der Eigenschaft werden. Dies hat jedoch keinen Einfluss auf die Nummern der nachfolgenden Paragraphen. Die Angabe einer leeren Nummer ist nicht vorgesehen. Zerbrechliche Anweisungen in \PName{Nummer} sollten mit -\Macro{protect} geschützt werden. Es\textnote{Achtung!} wird empfohlen als +\Macro{protect} geschützt werden. Es\textnote{Achtung!} wird empfohlen als \PName{Nummer} nur Ziffern und Buchstaben anzugeben. Mit der Eigenschaft \Option{dummy}\important{\Option{dummy}} kann man die -Ausgabe der kompletten Überschrift des Paragraphen unterdrücken. In der -automatischen Zählung wird der Paragraph aber dennoch berücksichtigt. Auf +Ausgabe der kompletten Ãœberschrift des Paragraphen unterdrücken. In der +automatischen Zählung wird der Paragraph aber dennoch berücksichtigt. Auf diese Weise kann man beispielsweise\textnote{Beispiel} mit \begin{lstcode} \Clause{dummy} \end{lstcode} -einen Paragraphen in der automatischen Zählung überspringen, falls der -entsprechende Paragraph in einer späteren Fassung eines Vertrags gestrichen +einen Paragraphen in der automatischen Zählung überspringen, falls der +entsprechende Paragraph in einer späteren Fassung eines Vertrags gestrichen wurde. Es\textnote{Achtung!} ist zu beachten, dass Eigenschaft \Option{dummy} als Wert allenfalls \PValue{true} und \PValue{false} versteht. Alle anderen Werte -werden normalerweise ignoriert, können im ungünstigsten Fall aber auch zu -einer Fehlermeldung führen.% +werden normalerweise ignoriert, können im ungünstigsten Fall aber auch zu +einer Fehlermeldung führen.% \EndIndexGroup \begin{Declaration} \Macro{Clauseformat}\Parameter{Nummer} \end{Declaration} -Wie bereits in der vorausgehenden Erklärung erwähnt, werden juristische +Wie bereits in der vorausgehenden Erklärung erwähnt, werden juristische Paragraphen und Unterparagraphen normalerweise nummeriert. Die Formatierung der Nummer erfolgt dabei mit Hilfe der Anweisung \Macro{Clauseformat}, die als einziges Argument die Nummer erwartet. Bei der @@ -351,11 +368,11 @@ Expandierbarkeit zu achten!% \begin{Declaration} \OptionVName{juratitlepagebreak}{Ein-Aus-Wert} \end{Declaration}% -Normalerweise sind Seitenumbrüche innerhalb von Überschriften aller Art -verboten. Einige Juristen benötigen jedoch Seitenumbrüche innerhalb von +Normalerweise sind Seitenumbrüche innerhalb von Ãœberschriften aller Art +verboten. Einige Juristen benötigen jedoch Seitenumbrüche innerhalb von Paragraphentiteln. Daher kann ein solcher Umbruch mit \Option{juratitlepagebreak}\important{\Option{juratitlepagebreak}} erlaubt -werden. Die möglichen Einstellungen für \PName{Ein-Aus-Wert} sind +werden. Die möglichen Einstellungen für \PName{Ein-Aus-Wert} sind \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} zu entnehmen.% \EndIndexGroup @@ -364,19 +381,19 @@ entnehmen.% \begin{Declaration} \OptionVName{clausemark}{Einstellung} \end{Declaration}% -Da Paragraphen eine untergeordnete Gliederung mit unabhängiger Nummerierung +Da Paragraphen eine untergeordnete Gliederung mit unabhängiger Nummerierung sind, erzeugen sie in der Voreinstellung\textnote{Voreinstellung} keine -Kolumnentitel. Über alternative Einstellungen können jedoch auch Kolumnentitel -erzeugt werden. Die möglichen Werte und ihre Bedeutung sind +Kolumnentitel. Ãœber alternative Einstellungen können jedoch auch Kolumnentitel +erzeugt werden. Die möglichen Werte und ihre Bedeutung sind \autoref{tab:scrjura.clausemark} zu entnehmen.% % \begin{table} - \caption{Mögliche Werte für Option \Option{clausemark} zur Erzeugung von + \caption{Mögliche Werte für Option \Option{clausemark} zur Erzeugung von Kolumnentiteln durch Paragraphen} \label{tab:scrjura.clausemark}% \begin{desctabular} \entry{\PValue{both}}{% - Paragraphen erzeugen linke und rechte Marken für Kolumnentitel, wenn das + Paragraphen erzeugen linke und rechte Marken für Kolumnentitel, wenn das Dokument die Verwendung von lebenden Kolumnentiteln vorsieht.% \IndexOption{clausemark~=\textKValue{both}}% }% @@ -386,19 +403,19 @@ erzeugt werden. Die möglichen Werte und ihre Bedeutung sind }% \entry{\PValue{forceboth}}{% Paragraphen erzeugen mit \DescRef{maincls.cmd.markboth} linke und rechte - Marken für Kolumnentitel unabhängig davon, ob das Dokument - beispielsweise über den Seitenstil überhaupt lebende Kolumnentitel + Marken für Kolumnentitel unabhängig davon, ob das Dokument + beispielsweise über den Seitenstil überhaupt lebende Kolumnentitel verwendet.% \IndexOption{clausemark~=\textKValue{forceboth}}% }% \entry{\PValue{forceright}}{% Paragraphen erzeugen mit \DescRef{maincls.cmd.markright} rechte Marken - für Kolumnentitel unabhängig davon, ob das Dokument beispielsweise über - den Seitenstil überhaupt lebende Kolumnentitel verwendet.% + für Kolumnentitel unabhängig davon, ob das Dokument beispielsweise über + den Seitenstil überhaupt lebende Kolumnentitel verwendet.% \IndexOption{clausemark~=\textKValue{forceright}}% }% \entry{\PValue{right}}{% - Paragraphen erzeugen rechte Marken für Kolumnentitel, wenn das Dokument + Paragraphen erzeugen rechte Marken für Kolumnentitel, wenn das Dokument die Verwendung von lebenden Kolumnentiteln vorsieht.% \IndexOption{clausemark~=\textKValue{right}}% }% @@ -408,16 +425,16 @@ erzeugt werden. Die möglichen Werte und ihre Bedeutung sind \EndIndexGroup \EndIndexGroup -\subsection{Absätze} +\subsection{Absätze} \label{sec:scrjura.par} \BeginIndexGroup \BeginIndex{}{Absatz>Nummerierung}% -Innerhalb von Paragraphen werden Absätze von \Package{scrjura} normalerweise -automatisch nummeriert. Sie sind damit ein stark gliederndes Element, ähnlich +Innerhalb von Paragraphen werden Absätze von \Package{scrjura} normalerweise +automatisch nummeriert. Sie sind damit ein stark gliederndes Element, ähnlich \DescRef{maincls.cmd.paragraph} oder \DescRef{maincls.cmd.subparagraph} in -normalen Texten. Innerhalb von Verträgen wird deshalb häufig auch gerne mit -Abstand zwischen den Absätzen gearbeitet. Das Paket \Package{scrjura} bietet -keinen eigenen Mechanismus hierfür. Stattdessen sei auf die Option +normalen Texten. Innerhalb von Verträgen wird deshalb häufig auch gerne mit +Abstand zwischen den Absätzen gearbeitet. Das Paket \Package{scrjura} bietet +keinen eigenen Mechanismus hierfür. Stattdessen sei auf die Option \DescRef{maincls.option.parskip}% \IndexOption{parskip}\important{\DescRef{maincls.option.parskip}} der \KOMAScript-Klassen verwiesen (siehe \autoref{sec:maincls.parmarkup}, @@ -426,35 +443,35 @@ keinen eigenen Mechanismus hierfür. Stattdessen sei auf die Option \begin{Declaration} \OptionVName{parnumber}{Einstellung} \end{Declaration} -Die automatische\textnote{Voreinstellung} Nummerierung der Absätze entspricht +Die automatische\textnote{Voreinstellung} Nummerierung der Absätze entspricht den beiden Einstellungen \OptionValue{parnumber}{auto} und \OptionValue{parnumber}{true}. Manchmal ist es notwendig, die automatische Nummerierung abzuschalten. Das ist mit \OptionValue{parnumber}{false}% \important{\OptionValue{parnumber}{false}}% -\IndexOption{parnumber~=\textKValue{false}} möglich. In diesem Fall wird nur die -Satznummer automatisch zurück gesetzt. +\IndexOption{parnumber~=\textKValue{false}} möglich. In diesem Fall wird nur die +Satznummer automatisch zurück gesetzt. Zur Realisierung dieser Option war es notwendig, in den Absatzmechanismus von -\LaTeX{} einzugreifen. In einigen seltenen Fällen kann sich das negativ -auswirken. Dann bleibt nur, diese Änderung mit +\LaTeX{} einzugreifen. In einigen seltenen Fällen kann sich das negativ +auswirken. Dann bleibt nur, diese Änderung mit \OptionValue{parnumber}{manual}% \important{\OptionValue{parnumber}{manual}}% -\IndexOption{parnumber~=\textKValue{manual}} zurück zu nehmen. Umgekehrt hebt -\LaTeX{} selbst den Eingriff manchmal auf. In diesem Fällen kann er mit +\IndexOption{parnumber~=\textKValue{manual}} zurück zu nehmen. Umgekehrt hebt +\LaTeX{} selbst den Eingriff manchmal auf. In diesem Fällen kann er mit \OptionValue{parnumber}{auto}% \important{\OptionValue{parnumber}{auto}}% \IndexOption{parnumber~=\textKValue{auto}} erneut aktiviert werden. Paragraphen, die nur aus einem einzigen Absatz bestehen, werden normalerweise -nicht automatisch nummeriert. Damit dies funktioniert, dürfen sich keine zwei +nicht automatisch nummeriert. Damit dies funktioniert, dürfen sich keine zwei Paragraphen mit identischer Nummer in einem Dokument befinden. Sollten Sie -dies dennoch einmal benötigen, weichen Sie bitte auf eine weitere +dies dennoch einmal benötigen, weichen Sie bitte auf eine weitere Vertragsumgebung aus (siehe \DescRef{\LabelBase.cmd.DeclareNewJuraEnvironment}, \autoref{sec:\LabelBase.newenv}, \DescPageRef{\LabelBase.cmd.DeclareNewJuraEnvironment}). Da\textnote{Achtung!} -die Information erst am Ende eines Paragraphen zur Verfügung steht, werden in -der Regel zwei \LaTeX-Läufe benötigt, bis die automatische Absatznummerierung +die Information erst am Ende eines Paragraphen zur Verfügung steht, werden in +der Regel zwei \LaTeX-Läufe benötigt, bis die automatische Absatznummerierung korrekt erfolgt.% \EndIndexGroup @@ -464,7 +481,7 @@ korrekt erfolgt.% \Macro{parformat} \Macro{parformatseparation} \end{Declaration}% -Für die Nummerierung der Absätze wird der Zähler \Counter{par} +Für die Nummerierung der Absätze wird der Zähler \Counter{par} verwendet. Seine Darstellung, \Macro{thepar} ist mit \Macro{arabic}\PParameter{par} als arabische Zahl voreingestellt. Die\textnote{Voreinstellung} Ausgabe als automatische @@ -477,20 +494,20 @@ zumindest ein nicht trennbares Leerzeichen mit Bei\ChangedAt{v0.7}{\Package{scrjura}} der automatischen Nummerierung wird \Macro{parformat} ebenfalls noch \Macro{parformatseparation} als Trennzeichen -angehängt. Voreinstellt\textnote{Voreinstellung} ist derzeit mit +angehängt. Voreinstellt\textnote{Voreinstellung} ist derzeit mit \Macro{nobreakspace}\IndexCmd{nobreakspace} ein nicht umbrechbarer Wortabstand. \BeginIndex{FontElement}{parnumber}\LabelFontElement{parnumber}% Die Absatznummer wird normalerweise\textnote{Voreinstellung} in der -aktuellen Schrift gesetzt. Diese Voreinstellung für das Element +aktuellen Schrift gesetzt. Diese Voreinstellung für das Element \FontElement{parnumber} kann jederzeit mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont}% \important[i]{\DescRef{\LabelBase.cmd.setkomafont}, \DescRef{\LabelBase.cmd.addtokomafont}} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -geändert werden.% +geändert werden.% \EndIndex{FontElement}{parnumber}% Es\textnote{Achtung!} wird darauf hingewiesen, dass \Package{scrjura} intern @@ -504,9 +521,9 @@ diese Anweisung keinesfalls umdefiniert werden!% \end{Declaration} Wird keine Absatznummer ausgegeben, wird am Anfang des Absatzes ersatzweise die Anweisung \Macro{withoutparnumber} lokal -ausgeführt. Diese\textnote{Voreinstellung} ist in der Voreinstellung leer, tut +ausgeführt. Diese\textnote{Voreinstellung} ist in der Voreinstellung leer, tut also weiter nichts. Sie wurde auf speziellen Wunsch in \Package{scrjura} -eingebaut, ist für den normalen Anwender aber ohne Belang.% +eingebaut, ist für den normalen Anwender aber ohne Belang.% \EndIndexGroup @@ -515,30 +532,30 @@ eingebaut, ist für den normalen Anwender aber ohne Belang.% \Macro{parellipsis} \end{Declaration} Manchmal\ChangedAt{v0.7}{\Package{scrjura}} -- insbesondere in vergleichenden -Kommentaren -- ist es wünschenswert, wenn man Absätze in Gesetzen auslassen, +Kommentaren -- ist es wünschenswert, wenn man Absätze in Gesetzen auslassen, aber gleichzeitig die Auslassung\Index{Absatz>Auslassung} markieren kann. Die -Absätze sollen dann auch in der Zählung der übrigen Absätze berücksichtigt -werden. Das Paket \Package{scrjura} stellt dafür die Anweisung +Absätze sollen dann auch in der Zählung der übrigen Absätze berücksichtigt +werden. Das Paket \Package{scrjura} stellt dafür die Anweisung \Macro{ellipsispar} bereit. -In der Voreinstellung\textnote{Voreinstellung} lässt \Macro{ellipsispar} genau -einen Absatz aus. Über das optionale Argument \PName{Anzahl} können jedoch -auch mehrere Absätze ausgelassen werden. In jedem Fall erscheint in der +In der Voreinstellung\textnote{Voreinstellung} lässt \Macro{ellipsispar} genau +einen Absatz aus. Ãœber das optionale Argument \PName{Anzahl} können jedoch +auch mehrere Absätze ausgelassen werden. In jedem Fall erscheint in der Ausgabe stattdessen genau ein nicht nummerierter Absatz, der nur die -Auslassungszeichen \Macro{parellipsis} enthält. Bei der Entscheidung für eine -automatische Nummerierung der übrigen Absätze eines juristischen Paragraphen -werden die ausgelassenen Absätze jedoch mit gezählt. Dies gilt ebenso für die -Nummern etwaiger nachfolgender Absätze. +Auslassungszeichen \Macro{parellipsis} enthält. Bei der Entscheidung für eine +automatische Nummerierung der übrigen Absätze eines juristischen Paragraphen +werden die ausgelassenen Absätze jedoch mit gezählt. Dies gilt ebenso für die +Nummern etwaiger nachfolgender Absätze. \begin{Example} Angenommen, Sie kommentieren das Strafgesetzbuch, wollen aber in \S~2 nur - Absatz~3 kommentieren. Dennoch soll auf die übrigen Absätze indirekt + Absatz~3 kommentieren. Dennoch soll auf die übrigen Absätze indirekt hingewiesen werden. Sie erreichen das beispielsweise mit: \begin{lstcode} \documentclass[parskip=half]{scrartcl} \usepackage{scrjura} \usepackage{selinput} \SelectInputMappings{ - adieresis={ä},germandbls={ß}, + adieresis={ä},germandbls={ß}, } \begin{document} \begin{contract} @@ -546,7 +563,7 @@ Nummern etwaiger nachfolgender Absätze. \ellipsispar[2] Wird das Gesetz, das bei Beendigung der Tat - gilt, vor der Entscheidung geändert, so ist + gilt, vor der Entscheidung geändert, so ist das mildeste Gesetz anzuwenden. \ellipsispar[3] @@ -560,19 +577,19 @@ Die Auslassungszeichen sind so vordefiniert\textnote{Voreinstellung}, dass \Macro{textellipsis}\IndexCmd{textellipsis} verwendet wird, falls eine solche Anweisung definiert ist. Anderenfalls wird \Macro{dots}\IndexCmd{dots} verwendet. Eine Umdefinierung von \Macro{parellipsis} ist mit -\Macro{renewcommand} jederzeit möglich.% +\Macro{renewcommand} jederzeit möglich.% \EndIndexGroup -\subsection{Sätze} +\subsection{Sätze} \label{sec:scrjura.sentence} \BeginIndexGroup \BeginIndex{}{Satz>Nummerierung}% -Absätze in Verträgen bestehen aus einem oder mehreren Sätzen, die teilweise +Absätze in Verträgen bestehen aus einem oder mehreren Sätzen, die teilweise ebenfalls nummeriert werden. Da eine automatische Nummerierung jedoch -problematisch und fehleranfällig ist, wurde eine solche bisher nicht -implementiert. Eine halbautomatische Nummerierung wird jedoch unterstützt. +problematisch und fehleranfällig ist, wurde eine solche bisher nicht +implementiert. Eine halbautomatische Nummerierung wird jedoch unterstützt. \begin{Declaration} \Counter{sentence} @@ -580,8 +597,8 @@ implementiert. Eine halbautomatische Nummerierung wird jedoch unterstützt. \Macro{sentencenumberformat} \Macro{Sentence} \end{Declaration} -Die Nummerierung von Sätzen erfolgt manuell mit der Anweisung -\Macro{Sentence}. Dabei wird der Zähler \Counter{sentence} automatisch erhöht +Die Nummerierung von Sätzen erfolgt manuell mit der Anweisung +\Macro{Sentence}. Dabei wird der Zähler \Counter{sentence} automatisch erhöht und in der Voreinstellung von \Macro{sentencenumberformat}\ChangedAt{v3.26}{\Package{scrjura}} die arabische Zahl von \Macro{thesentence} hochgestellt ausgegeben. @@ -589,18 +606,18 @@ Zahl von \Macro{thesentence} hochgestellt ausgegeben. \BeginIndex{FontElement}{sentencenumber}\LabelFontElement{sentencenumber}% Die\ChangedAt{v3.26}{\Package{scrjura}} Satznummer wird normalerweise\textnote{Voreinstellung} in der aktuellen Schrift gesetzt. Diese -Voreinstellung für das Element \FontElement{sentencenumber} kann jederzeit mit +Voreinstellung für das Element \FontElement{sentencenumber} kann jederzeit mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont}% \important[i]{\DescRef{\LabelBase.cmd.setkomafont}, \DescRef{\LabelBase.cmd.addtokomafont}} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -geändert werden.% +geändert werden.% \EndIndex{FontElement}{sentencenumber} Bei\textnote{Tipp!} Verwendung von \Package{babel}\IndexPackage{babel}\important{\Package{babel}} ist es einfach -möglich, eine Abkürzung für \Macro{Sentence} zu definieren:% +möglich, eine Abkürzung für \Macro{Sentence} zu definieren:% \phantomsection\label{sec:scrjura.shorthandexample}% \begin{lstcode}[moretexcs={useshorthands,defineshorthand}] \useshorthands{'} @@ -608,11 +625,11 @@ möglich, eine Abkürzung für \Macro{Sentence} zu definieren:% \end{lstcode} Dabei werden Leerzeichen nach \lstinline|'S| ignoriert. Auch eine -Abkürzung für einen Punkt, gefolgt von einer neuen Satznummer ist möglich: +Abkürzung für einen Punkt, gefolgt von einer neuen Satznummer ist möglich: \begin{lstcode}[moretexcs={useshorthands,defineshorthand}] \defineshorthand{'.}{. \Sentence\ignorespaces} \end{lstcode} -Näheres zu \Macro{useshorthands}\IndexCmd{useshorthands} und +Näheres zu \Macro{useshorthands}\IndexCmd{useshorthands} und \Macro{defineshorthand}\IndexCmd{defineshorthands} ist der Anleitung zum Paket \Package{babel} zu entnehmen (siehe \cite{package:babel}). Ein Anwendungsbeispiel finden Sie in \autoref{sec:scrjura.example} ab @@ -629,10 +646,10 @@ Anwendungsbeispiel finden Sie in \autoref{sec:scrjura.example} ab \section{Querverweise} \label{sec:scrjura.ref} -Für Paragraphen, Absätze und Sätze reicht der normale Mechanismus für +Für Paragraphen, Absätze und Sätze reicht der normale Mechanismus für Querverweise mit \Macro{label}\IndexCmd{label}\important{\Macro{label}}, \Macro{ref} und \Macro{pageref} nicht mehr aus. Daher wird dieser von -\Package{scrjura} um weitere Anweisungen ergänzt. +\Package{scrjura} um weitere Anweisungen ergänzt. \begin{Declaration} \Macro{ref}\Parameter{Label} @@ -641,8 +658,8 @@ Querverweise mit \Macro{label}\IndexCmd{label}\important{\Macro{label}}, \Macro{refN}\Parameter{Label} \end{Declaration} Die Anweisungen \Macro{refL}, \Macro{refS} und \Macro{refN} -referenzieren Paragraph, Absatz und Satz immer vollständig. \Macro{refL} -verwendet dabei eine textuelle Langform, während \Macro{refS} eine textuelle +referenzieren Paragraph, Absatz und Satz immer vollständig. \Macro{refL} +verwendet dabei eine textuelle Langform, während \Macro{refS} eine textuelle Kurzform bietet. \Macro{refN} ist eine rein nummerische Kurzform. \Macro{ref} entspricht in der Voreinstellung \Macro{refL}.% \EndIndexGroup @@ -652,7 +669,7 @@ entspricht in der Voreinstellung \Macro{refL}.% \Macro{refClause}\Parameter{Label} \Macro{refClauseN}\Parameter{Label} \end{Declaration} -Für die Referenzierung von Paragraphen ohne Absatz und Satz, unterscheiden +Für die Referenzierung von Paragraphen ohne Absatz und Satz, unterscheiden sich \Macro{refClause} und \Macro{refClauseN} nur darin, dass ersteres automatisch ein Paragraphenzeichen voran stellt.% \EndIndexGroup @@ -666,12 +683,12 @@ automatisch ein Paragraphenzeichen voran stellt.% \end{Declaration} Nur den Absatz kann man mit \Macro{refParL}, \Macro{refParS} und \Macro{refParN} referenzieren. Die Formen unterscheiden sich dabei wie bereits -für \DescRef{\LabelBase.cmd.refL}, \DescRef{\LabelBase.cmd.refN} und +für \DescRef{\LabelBase.cmd.refL}, \DescRef{\LabelBase.cmd.refN} und \DescRef{\LabelBase.cmd.refS} angegeben. Eine Besonderheit stellt das -optionale Argument von \Macro{refParN} dar. Normalerweise werden Absätze in -rein nummerischer Form als römische Zahlen referenziert. Über das optionale +optionale Argument von \Macro{refParN} dar. Normalerweise werden Absätze in +rein nummerischer Form als römische Zahlen referenziert. Ãœber das optionale Argument kann jedoch auch ein anderes Format vorgegeben werden. Sinnvoll ist -hier in erster Linie das \PValue{Zahlenformat} \PValue{arabic} für eine +hier in erster Linie das \PValue{Zahlenformat} \PValue{arabic} für eine arabische Absatznummer. \Macro{refPar} entspricht in der Voreinstellung \Macro{refParL}. \EndIndexGroup @@ -696,26 +713,26 @@ nummerische Form. \Macro{refSentence} entspricht in der Voreinstellung \end{Declaration} Die Ergebnisse von \DescRef{\LabelBase.cmd.ref}, \DescRef{\LabelBase.cmd.refPar} und \DescRef{\LabelBase.cmd.refSentence} sind -von der \PName{Einstellung} für Option \Option{ref} abhängig. In der +von der \PName{Einstellung} für Option \Option{ref} abhängig. In der Voreinstellung entsprechen diese \DescRef{\LabelBase.cmd.refL}, \DescRef{\LabelBase.cmd.refParL} und -\DescRef{\LabelBase.cmd.refSentenceL}. Mögliche Werte und ihre Bedeutung sind +\DescRef{\LabelBase.cmd.refSentenceL}. Mögliche Werte und ihre Bedeutung sind \autoref{tab:scrjura.ref} zu entnehmen.% % \begin{table} %\begin{desclist} % \desccaption \caption[{% - Mögliche Werte für Option \Option{ref} zur Einstellung der + Mögliche Werte für Option \Option{ref} zur Einstellung der Referenzierungsformate% }]{% - Mögliche Werte für Option \Option{ref} zur Einstellung des Formats von + Mögliche Werte für Option \Option{ref} zur Einstellung des Formats von \DescRef{\LabelBase.cmd.ref}, \DescRef{\LabelBase.cmd.refPar} und \DescRef{\LabelBase.cmd.refSentence}% \label{tab:scrjura.ref}% }% % {% -% Mögliche Werte für Option \Option{ref} \emph{(Fortsetzung)}% +% Mögliche Werte für Option \Option{ref} \emph{(Fortsetzung)}% % }% \begin{desctabular} \entry{\PValue{long}}{% @@ -782,10 +799,10 @@ Voreinstellung entsprechen diese \DescRef{\LabelBase.cmd.refL}, \end{table} \begin{Example} - Angenommen, Sie wollen, dass auf Absätze immer in der Form »Absatz 1 in - Paragraph 1« verwiesen wird. Da es hierfür keine vordefinierte Anweisung - gibt, müssen Sie sich Ihre eigene Definition aus den vorhanden Möglichkeiten - zusammenbauen. Dies können Sie mit% + Angenommen, Sie wollen, dass auf Absätze immer in der Form »Absatz 1 in + Paragraph 1« verwiesen wird. Da es hierfür keine vordefinierte Anweisung + gibt, müssen Sie sich Ihre eigene Definition aus den vorhanden Möglichkeiten + zusammenbauen. Dies können Sie mit% \begin{lstcode} \newcommand*{\refParM}[1]{% Absatz~\refParN[arabic]{#1} @@ -796,22 +813,22 @@ Voreinstellung entsprechen diese \DescRef{\LabelBase.cmd.refL}, \DescRef{\LabelBase.cmd.refParL} zu verwenden.% \end{Example}% -Beispiele für die Ergebnisse der nicht konfigurierbaren, grundlegenden +Beispiele für die Ergebnisse der nicht konfigurierbaren, grundlegenden Anweisungen finden sich in \autoref{tab:scrjura.refexamples}. % \begin{table} \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside}{Beispielausgaben der von Option \Option{ref} - unabhängigen Anweisungen für Querverweise}[l] + unabhängigen Anweisungen für Querverweise}[l] \begin{tabular}[t]{ll} \toprule Anweisung & Beispielausgabe \\ \midrule - \DescRef{\LabelBase.cmd.refL}\Parameter{Label} & § 1 Absatz 1 Satz 1 \\ - \DescRef{\LabelBase.cmd.refS}\Parameter{Label} & § 1 Abs. 1 S. 1 \\ - \DescRef{\LabelBase.cmd.refN}\Parameter{Label} & § 1 I 1. \\ - \DescRef{\LabelBase.cmd.refClause}\Parameter{Label} & § 1 \\ + \DescRef{\LabelBase.cmd.refL}\Parameter{Label} & § 1 Absatz 1 Satz 1 \\ + \DescRef{\LabelBase.cmd.refS}\Parameter{Label} & § 1 Abs. 1 S. 1 \\ + \DescRef{\LabelBase.cmd.refN}\Parameter{Label} & § 1 I 1. \\ + \DescRef{\LabelBase.cmd.refClause}\Parameter{Label} & § 1 \\ \DescRef{\LabelBase.cmd.refClauseN}\Parameter{Label} & 1 \\ \DescRef{\LabelBase.cmd.refParL}\Parameter{Label} & Absatz 1 \\ \DescRef{\LabelBase.cmd.refParS}\Parameter{Label} & Abs. 1 \\ @@ -829,49 +846,49 @@ Anweisungen finden sich in \autoref{tab:scrjura.refexamples}. \EndIndexGroup -\section{Zusätzliche Vertragsumgebungen} +\section{Zusätzliche Vertragsumgebungen} \label{sec:scrjura.newenv} -Einige Anwender setzen mit \Package{scrjura} keine Verträge oder Kommentare +Einige Anwender setzen mit \Package{scrjura} keine Verträge oder Kommentare zu einzelnen Gesetzen, sondern Werke, in denen unterschiedliche Arten von Gesetzen behandelt werden. Es ist daher erforderlich, dass ein Paragraph -nicht immer mit demselben Präfix »\S« versehen wird, sondern beispielsweise -als »Art.« oder »IAS« oder was auch immer bezeichnet wird. Darüber hinaus wird -eine unabhängige Zählung der unterschiedlichen Paragraphen benötigt. +nicht immer mit demselben Präfix »\S« versehen wird, sondern beispielsweise +als »Art.« oder »IAS« oder was auch immer bezeichnet wird. Darüber hinaus wird +eine unabhängige Zählung der unterschiedlichen Paragraphen benötigt. \begin{Declaration} \Macro{DeclareNewJuraEnvironment}\Parameter{Name}\OParameter{Optionen} \Parameter{Start-Anweisungen} \Parameter{End-Anweisungen} \end{Declaration} -Über\ChangedAt{v0.9}{\Package{scrjura}} diese Anweisung können weitere, -voneinander unabhängige Umgebungen für Vertrags- oder Gesetzestexte deklariert +Ãœber\ChangedAt{v0.9}{\Package{scrjura}} diese Anweisung können weitere, +voneinander unabhängige Umgebungen für Vertrags- oder Gesetzestexte deklariert werden. Das Argument \PName{Name} ist dabei der Name der neuen Umgebung. \PName{Start-Anweisungen} sind Anweisungen, die immer am Anfang der -Umgebung ausgeführt werden, ganz als ob man sie jedes Mal unmittelbar hinter -\Macro{begin}\Parameter{Name} einfügen würde. Entsprechend werden -\PName{End-Anweisungen} immer am Ende der Umgebung ausgeführt, ganz als ob man -sie jedes Mal unmittelbar vor \Macro{end}\Parameter{Name} einfügen würde. Ohne +Umgebung ausgeführt werden, ganz als ob man sie jedes Mal unmittelbar hinter +\Macro{begin}\Parameter{Name} einfügen würde. Entsprechend werden +\PName{End-Anweisungen} immer am Ende der Umgebung ausgeführt, ganz als ob man +sie jedes Mal unmittelbar vor \Macro{end}\Parameter{Name} einfügen würde. Ohne \PName{Optionen} entspricht die neue Umgebung \PName{Name} einer -\DescRef{\LabelBase.env.contract}-Umgebung mit eigenen Zählern. Es besteht -jedoch die Möglichkeit über eine mit Komma separierte Liste an +\DescRef{\LabelBase.env.contract}-Umgebung mit eigenen Zählern. Es besteht +jedoch die Möglichkeit über eine mit Komma separierte Liste an \PName{Optionen} darauf Einfluss zu -nehmen. \autoref{tab:\LabelBase.DeclareNewJuraEnvironment} führt die derzeit -unterstützen \PName{Optionen} auf. +nehmen. \autoref{tab:\LabelBase.DeclareNewJuraEnvironment} führt die derzeit +unterstützen \PName{Optionen} auf. \begin{desclist} - \desccaption{Von \Macro{DeclareNewJuraEnvironment} unterstützte Optionen zur + \desccaption{Von \Macro{DeclareNewJuraEnvironment} unterstützte Optionen zur Konfigurierung neuer Vertragsumgebungen\label{tab:\LabelBase.DeclareNewJuraEnvironment}}% - {Optionen für \Macro{DeclareNewJuraEnvironment} (\emph{Fortsetzung})}% + {Optionen für \Macro{DeclareNewJuraEnvironment} (\emph{Fortsetzung})}% \entry{\OptionVName{Clause}{Anweisung}}{% \DescRef{\LabelBase.cmd.Clause} wird innerhalb der neuen Umgebung auf - \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für + \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für \DescRef{\LabelBase.env.contract} dokumentierte Anweisung genau ein - Argument erwarten. Für eine korrekte Anwendung dieser Option sind - erweiterte Kenntnisse über die interne Funktion von \Package{scrjura} - notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung} - von Version zu Version noch ändern. Daher wird derzeit empfohlen, die + Argument erwarten. Für eine korrekte Anwendung dieser Option sind + erweiterte Kenntnisse über die interne Funktion von \Package{scrjura} + notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung} + von Version zu Version noch ändern. Daher wird derzeit empfohlen, die Option nicht zu verwenden!% }% \entry{\OptionVName{ClauseFont}{Anweisungen}}{% @@ -880,40 +897,40 @@ unterstützen \PName{Optionen} auf. Ist diese Option angegeben, so wird eine neues Element \FontElement{\PName{Name}.Clause}\IndexFontElement{\PName{Name}.Clause} mit \DescRef{maincls-experts.cmd.newkomafont} definiert und - \PName{Anweisungen} für dessen Voreinstellung verwendet. Sollte das + \PName{Anweisungen} für dessen Voreinstellung verwendet. Sollte das Element bisher als Alias definiert gewesen sein (siehe \DescRef{maincls-experts.cmd.aliaskomafont} in - \autoref{sec:maincls-experts.experts}, + \autoref{sec:maincls-experts.fonts}, \DescPageRef{maincls-experts.cmd.aliaskomafont}) so wird es stattdessen zu - einem selbstständigen Element. Sollte das Element bereits definiert + einem selbstständigen Element. Sollte das Element bereits definiert gewesen sein, so werden lediglich die \PName{Anweisungen} mit \DescRef{\LabelBase.cmd.setkomafont} als neue Einstellung gesetzt. Bitte beachten Sie die in \autoref{sec:\LabelBase.textmarkup}, - \DescPageRef{\LabelBase.cmd.setkomafont} erklärten Einschränkungen - bezüglich der erlaubten \PName{Anweisungen}!% + \DescPageRef{\LabelBase.cmd.setkomafont} erklärten Einschränkungen + bezüglich der erlaubten \PName{Anweisungen}!% \EndIndex{FontElement}{\PName{Name}.Clause}% }% \entry{\OptionVName{SubClause}{Anweisung}}{% \DescRef{\LabelBase.cmd.SubClause} wird innerhalb der Umgebung auf - \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für + \PName{Anweisung} abgebildet. Die \PName{Anweisung} sollte wie die für \DescRef{\LabelBase.env.contract} dokumentierte Anweisung genau ein - Argument erwarten. Für eine korrekte Anwendung dieser Option sind - erweiterte Kenntnisse über die interne Funktion von \Package{scrjura} - notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung} - von Version zu Version noch ändern. Daher wird derzeit empfohlen, die + Argument erwarten. Für eine korrekte Anwendung dieser Option sind + erweiterte Kenntnisse über die interne Funktion von \Package{scrjura} + notwendig. Außerdem können sich die Anforderungen an die \PName{Anweisung} + von Version zu Version noch ändern. Daher wird derzeit empfohlen, die Option nicht zu verwenden!% }% \entry{\OptionVName{Sentence}{Anweisung}}{% \DescRef{\LabelBase.cmd.Sentence} wird innerhalb der Umgebung auf \PName{Anweisung} abgebildet. Die \Macro{Anweisung} sollte kein Argument - besitzen. Normalerweise sollte sie den Zähler + besitzen. Normalerweise sollte sie den Zähler \Counter{sentence}\IndexCounter{sentence} mit - \Macro{refstepcounter}\IndexCmd{refstepcounter} erhöhen und dann in + \Macro{refstepcounter}\IndexCmd{refstepcounter} erhöhen und dann in geeigneter Form ausgeben. Dabei ist besonders darauf zu achten, dass keine - unerwünschten Leerzeichen eingebaut werden!% + unerwünschten Leerzeichen eingebaut werden!% }% \entry{\OptionVName{ClauseNumberFormat}{Anweisung}}{% - \PName{Anweisung} legt die Formatierung für Paragraphen-Nummern innerhalb + \PName{Anweisung} legt die Formatierung für Paragraphen-Nummern innerhalb der Umgebung fest. Es wird eine \PName{Anweisung} mit genau einem Argument erwartet, der Nummer des Paragraphen. Falls diese Nummer das letzte Argument einer Kette von Anweisungen ist, so kann diese Kette an @@ -921,8 +938,8 @@ unterstützen \PName{Optionen} auf. }% \end{desclist} \begin{Example} - Um beispielsweise die in der Einleitung zu diesem Abschnitt erwähnte - Umgebung für Artikel zu definieren, genügt: + Um beispielsweise die in der Einleitung zu diesem Abschnitt erwähnte + Umgebung für Artikel zu definieren, genügt: \begin{lstcode} \DeclareNewJuraEnvironment{Artikel} [ClauseNumberFormat=Art.]{}{} @@ -934,16 +951,16 @@ unterstützen \PName{Optionen} auf. [ClauseNumberFormat=Art.~] {\KOMAoptions{parskip}}{} \end{lstcode} - verwendet werden. Natürlich wird dann auch bei der Referenzierung - automatisch »Art.« anstelle von »\S« vorangestellt.% + verwendet werden. Natürlich wird dann auch bei der Referenzierung + automatisch »Art.« anstelle von »\S« vorangestellt.% Angewendet wird die neue Umgebung wie \DescRef{\LabelBase.env.contract}: \begin{lstcode} \begin{Artikel} \Clause - Die Würde des Menschen ist unantastbar. Sie zu - achten und zu schützen ist Verpflichtung aller + Die Würde des Menschen ist unantastbar. Sie zu + achten und zu schützen ist Verpflichtung aller staatlichen Gewalt. \end{Artikel} \end{lstcode} @@ -951,23 +968,23 @@ unterstützen \PName{Optionen} auf. \EndIndexGroup -\section{Unterstützung verschiedener Sprachen} +\section{Unterstützung verschiedener Sprachen} \label{sec:scrjura.babel} -Das Paket \Package{scrjura} wurde in Zusammenarbeit mit einem Anwalt für -Deutsches Recht entwickelt. Daher unterstützte es zunächst auch nur die Sprachen +Das Paket \Package{scrjura} wurde in Zusammenarbeit mit einem Anwalt für +Deutsches Recht entwickelt. Daher unterstützte es zunächst auch nur die Sprachen \PValue{german}, \PValue{ngerman}, \PValue{austrian} und -\PValue{naustrian}. Das Paket wurde aber so entworfen, dass es mit üblichen +\PValue{naustrian}. Das Paket wurde aber so entworfen, dass es mit üblichen Sprachpaketen wie \Package{babel}\important{\Package{babel}}\IndexPackage{babel} zusammen -arbeitet. Anwender können solche Anpassungen einfach mit +arbeitet. Anwender können solche Anpassungen einfach mit \DescRef{scrbase.cmd.providecaptionname} (siehe \autoref{sec:scrbase.languageSupport}, -\DescPageRef{scrbase.cmd.providecaptionname}) vornehmen. Sollten Sie über -gesicherte Informationen zu den im juristischen Umfeld gebräuchlichen -Begriffen in anderen Sprachen verfügen, würde sich der Autor über -entsprechende Rückmeldungen freuen. Auf diesem Weg ist inzwischen auch -Unterstützung für \PValue{english}, \PValue{american}, \PValue{british}, +\DescPageRef{scrbase.cmd.providecaptionname}) vornehmen. Sollten Sie über +gesicherte Informationen zu den im juristischen Umfeld gebräuchlichen +Begriffen in anderen Sprachen verfügen, würde sich der Autor über +entsprechende Rückmeldungen freuen. Auf diesem Weg ist inzwischen auch +Unterstützung für \PValue{english}, \PValue{american}, \PValue{british}, \PValue{canadian}, \PValue{USenglish} und \PValue{UKenglish} hinzu gekommen. \begin{Declaration} @@ -976,12 +993,12 @@ Unterstützung für \PValue{english}, \PValue{american}, \PValue{british}, \Macro{sentencename} \Macro{sentenceshortname} \end{Declaration} -Dies sind die sprachabhängigen Bezeichnungen, die von \Package{scrjura} +Dies sind die sprachabhängigen Bezeichnungen, die von \Package{scrjura} verwendet werden. Die Bedeutung und die im Deutschen vordefinierten Werte sind \autoref{tab:scrjura.captionnames} zu entnehmen. Dabei nimmt \Package{scrjura} die entsprechenden Definitionen innerhalb von \Macro{begin}\PParameter{document} nur vor, wenn nicht bereits andere Vorgaben -getroffen wurden. Wird \Package{scrjura} mit einer nicht unterstützten Sprache +getroffen wurden. Wird \Package{scrjura} mit einer nicht unterstützten Sprache verwendet, so wird eine entsprechende Fehlermeldung ausgegeben.% % \begin{table} @@ -989,9 +1006,9 @@ verwendet, so wird eine entsprechende Fehlermeldung ausgegeben.% \setcapindent{0pt}% \begin{captionbeside} [{% - Bedeutungen und Voreinstellungen sprachabhängiger Begriffe% + Bedeutungen und Voreinstellungen sprachabhängiger Begriffe% }]{% - Bedeutungen und Voreinstellungen für die sprachabhängigen Begriffe + Bedeutungen und Voreinstellungen für die sprachabhängigen Begriffe soweit nicht bereits definiert% } [l] @@ -999,10 +1016,10 @@ verwendet, so wird eine entsprechende Fehlermeldung ausgegeben.% \toprule Anweisung & Bedeutung & Voreinstellung \\ \midrule - \Macro{parname} & Langform »Absatz« & Absatz \\ - \Macro{parshortname} & Kurzform »Absatz« & Abs. \\ - \Macro{sentencename} & Langform »Satz« & Satz \\ - \Macro{sentenceshortname} & Kurzform »Satz« & S. \\ + \Macro{parname} & Langform »Absatz« & Absatz \\ + \Macro{parshortname} & Kurzform »Absatz« & Abs. \\ + \Macro{sentencename} & Langform »Satz« & Satz \\ + \Macro{sentenceshortname} & Kurzform »Satz« & S. \\ \bottomrule \end{tabular} \end{captionbeside} @@ -1012,19 +1029,19 @@ verwendet, so wird eine entsprechende Fehlermeldung ausgegeben.% \EndIndexGroup -\section{Ein ausführliches Beispiel} +\section{Ein ausführliches Beispiel} \label{sec:scrjura.example} Erinnern wir uns an den Brief aus \autoref{cha:scrlttr2}, in dem ein -Vereinsmitglied die überfällige Mitgliederversammlung in Erinnerung bringen -wollte. Damit so etwas möglich ist, muss es auch einen Verein mit einer +Vereinsmitglied die überfällige Mitgliederversammlung in Erinnerung bringen +wollte. Damit so etwas möglich ist, muss es auch einen Verein mit einer Satzung geben, die das vorschreibt. Eine Vereinssatzung ist letztlich eine Art Vertrag und kann mit \Package{scrjura} gesetzt werden. \lstinputcode[{xleftmargin=2em,% linerange=1-2}]{scrjuraexample.tex}% -Als Klasse wird \Class{scrartcl} verwendet. Da es bei Satzungen eher üblich -ist, die Absätze mit einem Abstand zu setzen, wird Option +Als Klasse wird \Class{scrartcl} verwendet. Da es bei Satzungen eher üblich +ist, die Absätze mit einem Abstand zu setzen, wird Option \OptionValueRef{maincls}{parskip}{half} verwendet (siehe \autoref{sec:maincls.parmarkup}, \DescPageRef{maincls.option.parskip}). @@ -1035,44 +1052,44 @@ Die Satzung soll in Deutsch verfasst werden. Daher wird das Paket \lstinputcode[{xleftmargin=2em,% linerange={6-7,9-9}}]{scrjuraexample.tex}% -Es werden einige Standardeinstellungen für die Schrift vorgenommen. Dazu kommt -das Paket \Package{textcomp}, das neben einem brauchbaren Euro-Zeichen für +Es werden einige Standardeinstellungen für die Schrift vorgenommen. Dazu kommt +das Paket \Package{textcomp}, das neben einem brauchbaren Euro-Zeichen für einige Schriften auch ein verbessertes Paragraphenzeichen bereitstellt. \lstinputcode[{moretexcs=SelectInputMappings,xleftmargin=2em,% linerange=11-15}]{scrjuraexample.tex}% -Damit Sonderzeichen und Umlaute direkt eingegeben werden können, wird die -Eingabecodierung ermittelt. Alternativ könnte hier auch das Paket +Damit Sonderzeichen und Umlaute direkt eingegeben werden können, wird die +Eingabecodierung ermittelt. Alternativ könnte hier auch das Paket \Package{inputenc} zum Einsatz kommen. \lstinputcode[{xleftmargin=2em,% linerange=17-17}]{scrjuraexample.tex}% -Später sollen Listen nicht mit arabischen Zahlen, sondern mit Kleinbuchstaben +Später sollen Listen nicht mit arabischen Zahlen, sondern mit Kleinbuchstaben nummeriert werden. Dies ist beispielsweise mit dem Paket \Package{enumerate} -möglich. +möglich. \lstinputcode[{moretexcs={useshorthands,defineshorthand},% xleftmargin=2em,% linerange=19-27}]{scrjuraexample.tex}% -Nun ist es Zeit für \Package{scrjura}. Mit Option -\OptionValueRef{\LabelBase}{clausemark}{forceboth} wird für Paragraphen das -Setzen von linken und rechten Marken für Kolumnentitel erzwungen. Da -andererseits nicht erwünscht ist, dass \DescRef{maincls.cmd.section} +Nun ist es Zeit für \Package{scrjura}. Mit Option +\OptionValueRef{\LabelBase}{clausemark}{forceboth} wird für Paragraphen das +Setzen von linken und rechten Marken für Kolumnentitel erzwungen. Da +andererseits nicht erwünscht ist, dass \DescRef{maincls.cmd.section} Kolumnentitel erzeugen, wird Seitenstil \PageStyle{myheadings} verwendet, der normalerweise keine lebenden Kolumnentitel aktiviert. -Es soll später auch ein Inhaltsverzeichnis erstellt werden, in das die +Es soll später auch ein Inhaltsverzeichnis erstellt werden, in das die Paragraphen ebenfalls aufgenommen werden. Das wird mit -\DescRef{\LabelBase.option.juratotoc} erreicht. Später werden wir feststellen, -dass die voreingestellte Breite für die Paragraphennummern im -Inhaltsverzeichnis nicht genügt. Daher wird mit -\OptionValueRef{\LabelBase}{juratocnumberwidth}{2.5em} für etwas mehr Platz +\DescRef{\LabelBase.option.juratotoc} erreicht. Später werden wir feststellen, +dass die voreingestellte Breite für die Paragraphennummern im +Inhaltsverzeichnis nicht genügt. Daher wird mit +\OptionValueRef{\LabelBase}{juratocnumberwidth}{2.5em} für etwas mehr Platz gesorgt. -Die Definition der Abkürzungen wurde bereits in -\autoref{sec:scrjura.shorthandexample} erklärt. Im Beispiel wurde sie -übernommen, um später die Eingabe zu vereinfachen. +Die Definition der Abkürzungen wurde bereits in +\autoref{sec:scrjura.shorthandexample} erklärt. Im Beispiel wurde sie +übernommen, um später die Eingabe zu vereinfachen. \lstinputcode[{xleftmargin=2em,% linerange=29-29}]{scrjuraexample.tex}% @@ -1086,18 +1103,18 @@ gewohnten \KOMAScript-Mitteln (siehe \autoref{sec:maincls.titlepage}, ab \lstinputcode[{xleftmargin=2em,% linerange=37-37}]{scrjuraexample.tex}% -Wie bereits erwähnt, soll ein Inhaltsverzeichnis erstellt werden. +Wie bereits erwähnt, soll ein Inhaltsverzeichnis erstellt werden. \lstinputcode[{xleftmargin=2em,% linerange=39-43}]{scrjuraexample.tex}% -Präambeln sind in Satzungen nicht ungewöhnlich. Hier wird sie mit +Präambeln sind in Satzungen nicht ungewöhnlich. Hier wird sie mit \DescRef{maincls.cmd.addsec} gesetzt, damit sie auch einen Eintrag ins -Inhaltsverzeichnis erhält. +Inhaltsverzeichnis erhält. \lstinputcode[{xleftmargin=2em,% linerange=45-45}]{scrjuraexample.tex}% Hier wird ein kleiner Trick angewendet. Die einzelnen Artikel der Satzung -sollen nicht mit arabischen Zahlen, sondern mit Großbuchstaben nummeriert +sollen nicht mit arabischen Zahlen, sondern mit Großbuchstaben nummeriert werden -- genau wie dies auch im Anhang eines Artikels mit \Class{scrartcl} der Fall ist. @@ -1107,45 +1124,45 @@ Mit dem ersten Artikel beginnt auch der Vertrag. \lstinputcode[{xleftmargin=2em,% linerange=50-59}]{scrjuraexample.tex}% -Der erste Paragraph erhält neben der Nummer auch einen Titel. Dies wird auch +Der erste Paragraph erhält neben der Nummer auch einen Titel. Dies wird auch bei den nachfolgenden Paragraphen so sein. -Der erste Absatz des Vertrags enthält nichts ungewöhnliches. Da es nicht der +Der erste Absatz des Vertrags enthält nichts ungewöhnliches. Da es nicht der einzige Absatz ist, werden bei der Ausgabe jedem Absatz automatisch Absatznummern voran gestellt werden. Damit dies auch beim ersten Absatz -geschieht, sind allerdings zwei \LaTeX-Läufe notwendig. Da dies für das -Inhaltsverzeichnis ohnehin der Fall sein wird, stört das aber auch nicht +geschieht, sind allerdings zwei \LaTeX-Läufe notwendig. Da dies für das +Inhaltsverzeichnis ohnehin der Fall sein wird, stört das aber auch nicht weiter. -Im zweiten Absatz stehen zwei Sätze. Hier finden zum ersten Mal die -Abkürzungen \texttt{'S} und +Im zweiten Absatz stehen zwei Sätze. Hier finden zum ersten Mal die +Abkürzungen \texttt{'S} und \texttt{'.} Anwendung. Mit der ersten wird lediglich eine Satznummer erzeugt. Mit der zweiten wird nicht nur ein Punkt, sondern nachfolgend -auch eine Satznummer erzeugt. Beide Sätze des Absatzes sind somit nummeriert. +auch eine Satznummer erzeugt. Beide Sätze des Absatzes sind somit nummeriert. \lstinputcode[{xleftmargin=2em,% linerange=60-75}]{scrjuraexample.tex}% -Der zweite Paragraph: Auch dieser enthält wieder mehrere Absätze, die -teilweise auch mehrere Sätze umfassen. Im zweiten Absatz ist darüber hinaus -eine Aufzählung zu finden. Beim letzten Absatz wurde ein Label gesetzt, da auf -diesen später noch verwiesen werden soll. +Der zweite Paragraph: Auch dieser enthält wieder mehrere Absätze, die +teilweise auch mehrere Sätze umfassen. Im zweiten Absatz ist darüber hinaus +eine Aufzählung zu finden. Beim letzten Absatz wurde ein Label gesetzt, da auf +diesen später noch verwiesen werden soll. \lstinputcode[{xleftmargin=2em,% linerange=77-84}]{scrjuraexample.tex}% -Der dritte Paragraph enthält als Besonderheit einen Querverweis. In diesem +Der dritte Paragraph enthält als Besonderheit einen Querverweis. In diesem Fall wird in der Langform mit Paragraph, Absatz und Satz referenziert. Soll -der Satz später doch entfallen, so kann dies global durch Setzen der Option +der Satz später doch entfallen, so kann dies global durch Setzen der Option \OptionValueRef{\LabelBase}{ref}{nosentence} erreicht werden. \lstinputcode[{xleftmargin=2em,% linerange=86-87}]{scrjuraexample.tex}% Hier gibt es nun einen ersten Spezialfall eines Paragraphen. Dieser Paragraph -war in einer früheren Fassung der Satzung noch enthalten, wurde dann aber +war in einer früheren Fassung der Satzung noch enthalten, wurde dann aber entfernt. Dabei sollen jedoch die nachfolgenden Paragraphen nicht neu nummeriert werden, sondern ihre alte Nummer behalten. Deshalb wurde die \DescRef{\LabelBase.cmd.Clause}-Anweisung nicht entfernt, sondern lediglich um -die Eigenschaft \Option{dummy} erweitert. Außerdem kann so auch weiterhin ein -Label für diesen Paragraphen gesetzt werden, obwohl der Paragraph selbst nicht +die Eigenschaft \Option{dummy} erweitert. Außerdem kann so auch weiterhin ein +Label für diesen Paragraphen gesetzt werden, obwohl der Paragraph selbst nicht angezeigt wird. \lstinputcode[{xleftmargin=2em,% @@ -1156,7 +1173,7 @@ Absatznummerierung ausgeschlossen sind, wird dazu kurzzeitig die \lstinputcode[{xleftmargin=2em,% linerange=93-93}]{scrjuraexample.tex}% -Auch der erste Paragraph im nächsten Artikel wurde gestrichen. +Auch der erste Paragraph im nächsten Artikel wurde gestrichen. \lstinputcode[{xleftmargin=2em,% linerange=95-104}]{scrjuraexample.tex}% @@ -1167,15 +1184,15 @@ gesetzt. \lstinputcode[{xleftmargin=2em,% linerange=107-112}]{scrjuraexample.tex}% Hier haben wir den zweiten Spezialfall eines Paragraphen. In diesem Fall wurde -kein Paragraph gestrichen, sondern ein neuer Paragraph eingefügt, ohne dass +kein Paragraph gestrichen, sondern ein neuer Paragraph eingefügt, ohne dass nachfolgend Paragraphen neu nummeriert werden. Dazu wurde -\DescRef{\LabelBase.cmd.SubClause} verwendet. Somit erhält dieser Paragraph +\DescRef{\LabelBase.cmd.SubClause} verwendet. Somit erhält dieser Paragraph die Nummer des vorherigen Paragraphen, die zur Unterscheidung um ein kleines -»a« erweitert wurde. +»a« erweitert wurde. \lstinputcode[{xleftmargin=2em,% linerange=114-134}]{scrjuraexample.tex}% -Die übrigen Paragraphen dieses Artikels enthalten nur bereits bekannte +Die übrigen Paragraphen dieses Artikels enthalten nur bereits bekannte Anweisungen und keine neuen Besonderheiten. \lstinputcode[{xleftmargin=2em,% @@ -1238,24 +1255,24 @@ Seit \KOMAScript~3.24 teilt \Package{scrjura} die Versionsnummer der Klassen und anderer wichtiger Pakete. Dennoch sei auf einen wichtigen Punkt hingewiesen: Bisher ist weder das Zusammenspiel mit vielen anderen Paketen noch die Funktion der \DescRef{\LabelBase.env.contract}-Umgebung mit allen -möglichen \LaTeX-Umgebungen und Einstellungen verschiedener Klassen und Pakete +möglichen \LaTeX-Umgebungen und Einstellungen verschiedener Klassen und Pakete getestet. Dies liegt nicht zuletzt daran, dass es sich bei \Package{scrjura} -um ein sehr spezielles Paket handelt, das weit außerhalb der täglichen Praxis -des Autors liegt. Damit ist der Autor diesbezüglich in hohem Maße auf -ausführliche Rückmeldungen durch die Anwender angewiesen.% +um ein sehr spezielles Paket handelt, das weit außerhalb der täglichen Praxis +des Autors liegt. Damit ist der Autor diesbezüglich in hohem Maße auf +ausführliche Rückmeldungen durch die Anwender angewiesen.% \EndIndexGroup %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-PDF-mode: t %%% TeX-master: "guide.tex" %%% End: % LocalWords: Seitenstil bedarfsweise Ebenennummer Absatznummerierung -% LocalWords: Paragraphenüberschrift Präambeln renewcommand Gesetzestexte +% LocalWords: Paragraphenüberschrift Präambeln renewcommand Gesetzestexte % LocalWords: Grundgesetzartikel Absatzabstand umbrechbaren Wortabstand % LocalWords: Beispielsatzung Paragraphensymbol Vordefinierung Absatznummer % LocalWords: Expandierbarkeit umbrechbarer Satznummer Paragraphenzeichen diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrjuraexample.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrjuraexample.tex index c144117cf6..27141726ee 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrjuraexample.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrjuraexample.tex @@ -10,8 +10,8 @@ \usepackage{selinput} \SelectInputMappings{ - adieresis={ä}, - germandbls={ß}, + adieresis={ä}, + germandbls={ß}, } \usepackage{enumerate} @@ -30,15 +30,15 @@ \subject{Satzung} \title{VfVmai} -\subtitle{Verein für Vereinsmaierei mit ai n.e.V.} +\subtitle{Verein für Vereinsmaierei mit ai n.e.V.} \date{11.\,11.\,2011} \maketitle \tableofcontents -\addsec{Präambel} +\addsec{Präambel} -Die Vereinslandschaft in Deutschland ist vielfältig. +Die Vereinslandschaft in Deutschland ist vielfältig. Doch leider mussten wir feststellen, dass es dabei oft am ernsthaften Umgang mit der Ernsthaftigkeit krankt. @@ -49,13 +49,13 @@ am ernsthaften Umgang mit der Ernsthaftigkeit krankt. \begin{contract} \Clause{title={Name, Rechtsform, Sitz des Vereins}} -Der Verein führt den Namen »Verein für Vereinsmaierei mit -ai n.e.V.« und ist in keinem Vereinsregister eingetragen. +Der Verein führt den Namen »Verein für Vereinsmaierei mit +ai n.e.V.« und ist in keinem Vereinsregister eingetragen. -'S Der Verein ist ein nichtwirtschaftlicher, unnützer +'S Der Verein ist ein nichtwirtschaftlicher, unnützer Verein'. Er hat keinen Sitz und muss daher stehen. -Geschäftsjahr ist vom 31.~März bis zum 1.~April. +Geschäftsjahr ist vom 31.~März bis zum 1.~April. \Clause{title={Zweck des Vereins}} @@ -66,22 +66,22 @@ Ernsthaftigkeit auf eine gesunde Basis stellen. Zu diesem Zweck kann der Verein \begin{enumerate}[\qquad a)] \item in der Nase bohren, -\item Nüsse knacken, +\item Nüsse knacken, \item am Daumen lutschen. \end{enumerate} -Der Verein ist selbstsüchtig und steht dazu. +Der Verein ist selbstsüchtig und steht dazu. -Der Verein verfügt über keinerlei Mittel.\label{a:mittel} +Der Verein verfügt über keinerlei Mittel.\label{a:mittel} -\Clause{title={Vereinsämter}} +\Clause{title={Vereinsämter}} -Die Vereinsämter sind Ehrenämter. +Die Vereinsämter sind Ehrenämter. -'S Würde der Verein über Mittel verfügen -(siehe \ref{a:mittel}), so könnte er einen -hauptamtlichen Geschäftsführer bestellen'. Ohne -die notwendigen Mittel ist dies nicht möglich. +'S Würde der Verein über Mittel verfügen +(siehe \ref{a:mittel}), so könnte er einen +hauptamtlichen Geschäftsführer bestellen'. Ohne +die notwendigen Mittel ist dies nicht möglich. \Clause{title={Vereinsmaier},dummy} \label{p.maier} @@ -99,17 +99,17 @@ Preis von einem der in \refClause{p.maier} genannten Vereinsmaier erwerben.\label{a.preis} 'S Zum Erwerb der Mitgliedschaft ist ein formloser -Antrag erforderlich'. Dieser Antrag ist in grüner +Antrag erforderlich'. Dieser Antrag ist in grüner Tinte auf rosa Papier einzureichen. Die Mitgliedschaft kann nicht abgelehnt werden. -\SubClause{title={Ergänzung zu vorstehendem +\SubClause{title={Ergänzung zu vorstehendem Paragraphen}} 'S Mit Abschaffung von \refClause{p.maier} verliert \ref{a.preis} seine Umsetzbarkeit'. Mitgliedschaften -können ersatzweise vererbt werden. +können ersatzweise vererbt werden. \Clause{title={Ende der Mitgliedschaft}} @@ -118,22 +118,22 @@ lebenden Mitgliedern endet die Mitgliedschaft nicht. \Clause{title={Mitgliederversammlung}} -Zweimal jährlich findet eine Mitgliederversammlung statt. +Zweimal jährlich findet eine Mitgliederversammlung statt. Der Abstand zwischen zwei Mitgliederversammlungen -beträgt höchstens 6~Monate, 1~Woche und 2~Tage. +beträgt höchstens 6~Monate, 1~Woche und 2~Tage. -Frühestens 6~Monate nach der letzten Mitgliederversammlung -hat die Einladung zur nächsten Mitgliederversammlung zu +Frühestens 6~Monate nach der letzten Mitgliederversammlung +hat die Einladung zur nächsten Mitgliederversammlung zu erfolgen. -\SubClause{title={Ergänzung zur Mitgliederversammlung}} +\SubClause{title={Ergänzung zur Mitgliederversammlung}} -Die Mitgliederversammlung darf frühstens 2~Wochen nach +Die Mitgliederversammlung darf frühstens 2~Wochen nach letztem Eingang der Einladung abgehalten werden. \end{contract} -\section{Gültigkeit} +\section{Gültigkeit} \begin{contract} \Clause{title={In Kraft treten}} @@ -144,8 +144,8 @@ in Kraft. 'S Sollten irgendwelche Bestimmungen dieser Satzung im Widerspruch zueinander stehen, tritt die Satzung am 11.\,11.\,2011 um 11:11~Uhr und 11~Sekunden wieder -außer Kraft'. Der Verein ist in diesem Fall als -aufgelöst zu betrachten. +außer Kraft'. Der Verein ist in diesem Fall als +aufgelöst zu betrachten. \end{contract} diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-notecolumn.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-notecolumn.tex index 36ecd1a7e3..46451d4706 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-notecolumn.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-notecolumn.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-notecolumn.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-notecolumn.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrlayer-notecolumn in der KOMA-Script-Anleitung +% Kapitel über scrlayer-notecolumn in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrlayer-notecolumn.tex} - [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter:scrlayer-notecolumn)] \chapter{Notizspalten mit \Package{scrlayer-notecolumn}} @@ -54,89 +54,89 @@ \BeginIndexGroup \BeginIndex{Package}{scrlayer-notecolumn}% -Bis einschließlich Version~3.11b unterstützte \KOMAScript{} Notizspalten nur +Bis einschließlich Version~3.11b unterstützte \KOMAScript{} Notizspalten nur in Form der Marginalienspalte, die mit \DescRef{maincls.cmd.marginpar} und \DescRef{maincls.cmd.marginline} (siehe \autoref{sec:maincls.marginNotes}, \DescPageRef{maincls.cmd.marginline}) mit Inhalt versehen werden -können. Jene Art der Randnotizen hat allerdings einige Nachteile: +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\textnote{Seitenumbruch} innerhalb von Randnotizen - sind nicht möglich. Dies führt teilweise dazu, dass die Randnotizen bis in +\item Randnotizen können nur vollständig auf einer einzelnen Seite gesetzt + werden. Seitenumbrüche\textnote{Seitenumbruch} innerhalb von Randnotizen + sind nicht möglich. Dies führt teilweise dazu, dass die Randnotizen bis in den unteren Rand hineinragen. -\item Randnotizen in der Nähe des Seitenumbruchs können auf die nächste Seite +\item Randnotizen in der Nähe des Seitenumbruchs können auf die nächste Seite rutschen und dort im Falle des doppelseitigen Layouts mit alternierenden Marginalienspalten im falschen Rand\textnote{Zuordnung zum richtigen 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} (siehe - \cite{package:marginnote}) lösbar. + \cite{package:marginnote}) lösbar. \item Randnotizen innerhalb von Gleitumgebungen\textnote{Gleitumgebungen} oder - Fußnoten\textnote{Fußnoten} sind nicht möglich. Auch dieses Problem ist mit - \Package{marginnote} lösbar. + Fußnoten\textnote{Fußnoten} sind nicht möglich. Auch dieses Problem ist mit + \Package{marginnote} lösbar. \item Es gibt nur eine Marginalienspalte\textnote{mehrere Notizspalten} oder allenfalls zwei, wenn mit \Macro{reversemarginpar} und \Macro{normalmarginpar} gearbeitet wird, wobei \Macro{reversemarginpar} bei doppelseitigen Dokumenten kaum zu gebrauchen ist. \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. +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 +lösen. Dazu stützt es sich auf die Grundfunktionalität von \hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}% \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}. Damit einher geht -jedoch auch ein Nachteil:\textnote{Achtung!} Notizen können nur auf den Seiten +jedoch auch ein Nachteil:\textnote{Achtung!} Notizen können nur auf den Seiten ausgegeben werden, die einen auf \hyperref[cha:scrlayer]{\Package{scrlayer}} -basierenden Seitenstil besitzen. Dieser Nachteil lässt sich mit Hilfe von +basierenden Seitenstil besitzen. Dieser Nachteil lässt sich mit Hilfe von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}% \IndexPackage{scrlayer-scrpage} jedoch leicht -auf"|lösen oder sogar in einen Vorteil verwandeln. +auf"|lösen oder sogar in einen Vorteil verwandeln. \section{Hinweise zum Entwicklungsstand} \seclabel{draft} -Das Paket wurde ursprünglich zur Demonstration des Potentials von +Das Paket wurde ausschließlich zur Demonstration des Potentials von \hyperref[cha:scrlayer]{\Package{scrlayer}}\important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} als sogenannter\textnote{Proof of Concept} \emph{Proof of Concept} -entwickelt. Obwohl es sich derzeit noch in einem recht frühen -Entwicklungsstadium befindet, ist die Stabilität von weiten Teilen weniger +entwickelt. Obwohl es sich 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 \hyperref[cha:scrlayer]{\Package{scrlayer}}. Dennoch ist davon auszugehen, dass sich auch in \Package{scrlayer-notecolumn} noch Fehler befinden. Es wird darum gebeten, diese bei Auf"|finden 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 +\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 eher als experimentell\textnote{experimentell} gilt, findet sich die Anleitung hier im zweiten Teil \iffree{der \KOMAScript-Anleitung}{dieses Buches}. 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\textnote{für \LaTeX-Experten} befinden, mag daher einiges -in den nachfolgenden Erklärungen unklar oder gar unverständlich +Anwender. Für Anfänger oder Anwender, die sich bereits deutlich auf dem Weg +zum \LaTeX-Experten\textnote{für \LaTeX-Experten} befinden, mag daher einiges +in den nachfolgenden Erklärungen unklar oder gar unverständlich sein. \iffree{Ich bitte um Nachsicht, dass ich bei experimentellen Paketen den - Aufwand für die Anleitung halbwegs erträglich halten will.}{Sie sollten - jedoch genügen, um einfache Aufgaben mit \Package{scrlayer-notecolumn} lösen - zu können. Gleichzeitig finden Entwickler hoffentlich nützliche Anregungen - für eigene Ideen.} + Aufwand für die Anleitung halbwegs erträglich halten will.}{Sie sollten + jedoch genügen, um einfache Aufgaben mit \Package{scrlayer-notecolumn} lösen + zu können. Gleichzeitig finden Entwickler hoffentlich nützliche Anregungen + für eigene Ideen.} \iffalse% Umbruchoptimierung Es sei auch darauf\textnote{Achtung!} hingewiesen, dass der \KOMAScript-Autor -nicht für die Weiterentwicklung des Pakets garantiert und nur eingeschränkten -Support dafür bietet. Das liegt in der Natur eines Pakets, das nur zu +nicht für die Weiterentwicklung des Pakets garantiert und nur eingeschränkten +Support dafür bietet. Das liegt in der Natur eines Pakets, das nur zu Demonstrationszwecken geschrieben wurde.% \fi -\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options}% \section{Frühe oder späte Optionenwahl} \LoadCommonFile{textmarkup}% \section{Textauszeichnungen} @@ -148,17 +148,17 @@ Beim Laden des Pakets wird bereits automatisch eine Notizspalte namens im Bereich der normalen Marginalienspalte von \DescRef{maincls.cmd.marginpar} und \DescRef{maincls.cmd.marginline}. Dabei werden auch die Einstellungen \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 +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. Will man hingegen innerhalb einer Seite sowohl Notizen links als auch rechts neben dem Haupttext haben, so sollte man sich eine zweite Notizspalte definieren. -Die Voreinstellungen für alle neu deklarierten Notizspalten entsprechen im -Übrigen den erwähnten Einstellungen für die vordefinierte +Die Voreinstellungen für alle neu deklarierten Notizspalten entsprechen im +Ãœbrigen den erwähnten Einstellungen für die vordefinierte \PValue{marginpar}. % \iftrue% Umbruchoptimierung -Diese können bei der Deklaration jedoch leicht geändert werden.% +Diese können bei der Deklaration jedoch leicht geändert werden.% \fi Es ist zu beachten\textnote{Achtung!}, dass Notizspalten nur auf Seiten @@ -169,7 +169,7 @@ ausgegeben werden, deren Seitenstil auf dem Paket \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 +benötigt, wird zusätzlich das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} @@ -185,54 +185,54 @@ empfohlen. \Macro{RedeclareNoteColumn}\OParameter{Liste~der~Einstellungen} \Parameter{Name~der~Notizspalte}% \end{Declaration} -Mit Hilfe dieser Anweisungen können Notizspalten angelegt werden. Dabei +Mit Hilfe dieser Anweisungen können Notizspalten angelegt werden. Dabei erzeugt \Macro{DeclareNoteColumn} die Notizspalte ungeachtet der Tatsache, ob -sie bereits existiert, während \Macro{DeclareNewNoteColumn} einen -Fehler ausgibt, falls der \PName{Name der Notizspalte} bereits für eine andere +sie bereits existiert, 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 +\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 +Für neue Notizspalten wird immer ein Element zur Änderung der Schriftattribute mit \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} angelegt, -falls dieses noch nicht existiert. Als Name für das Element wird +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 +existiert für die vordefinierte Notizspalte \PValue{marginpar} das Element\textnote{Name des Elements} \PValue{notecolumn.marginpar}. Die -Voreinstellung kann bei der Deklaration einer Notizspalte direkt über 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 +Einstellungen oder Optionen. Die verfügbaren Optionen sind in \autoref{tab:scrlayer-notecolumn.note.column.options}, \autopageref{tab:scrlayer-notecolumn.note.column.options} zu finden. Als\textnote{Voreinstellung: Option \Option{marginpar}} Voreinstellung ist \Option{marginpar} immer gesetzt, kann aber durch individuelle -Einstellungen überschrieben werden. +Einstellungen überschrieben werden. Da die Notizspalten mit Hilfe von \hyperref[cha:scrlayer]{\Package{scrlayer}}% \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}} definiert werden, wird -auch für jede Notizspalte eine Ebene\Index{Ebenen} angelegt. Als -Name\textnote{Name der Ebene} für diese Ebene wird ebenfalls -\PValue{notecolumn.}\PName{Name der Notizspalte} verwendet. Näheres zu Ebenen +auch für jede Notizspalte eine Ebene\Index{Ebenen} angelegt. Als +Name\textnote{Name der Ebene} für diese Ebene wird ebenfalls +\PValue{notecolumn.}\PName{Name der Notizspalte} verwendet. Näheres zu Ebenen ist \autoref{sec:scrlayer.layers}, ab \autopageref{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 + 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. @@ -241,8 +241,8 @@ entnehmen. \usepackage[ngerman]{babel} \usepackage{selinput} \SelectInputMappings{ - adieresis={ä}, - germandbls={ß}, + adieresis={ä}, + germandbls={ß}, } \usepackage[T1]{fontenc} \usepackage{lmodern} @@ -277,11 +277,11 @@ entnehmen. 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 + 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\textnote{Gesetz mit + Bezüglich des Setzens von Gesetzestexten\textnote{Gesetz mit \hyperref[cha:scrjura]{\Package{scrjura}}} mit \hyperref[cha:scrjura]{\Package{scrjura}}\IndexPackage{scrjura} sei auf \iffree{dessen Anleitung}{\autoref{cha:scrjura}} verwiesen. @@ -290,12 +290,12 @@ entnehmen. \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} mit Seitenzahl verwendet werden soll, wird das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% - \IndexPackage{scrlayer-scrpage} geladen. Somit können Notizspalten auf allen + \IndexPackage{scrlayer-scrpage} geladen. Somit können Notizspalten auf allen Seiten ausgegeben werden. Dann wird das Paket \Package{scrlayer-notecolumn}\textnote{Notizspalte mit - \Package{scrlayer-notecolumn}} für die Notizspalten geladen. Die - gewünschte Breite der Notizspalte wird über + \Package{scrlayer-notecolumn}} für die Notizspalten geladen. Die + gewünschte Breite der Notizspalte wird über \DescRef{typearea-experts.cmd.AfterCalculatingTypearea}% \IndexPackage{typearea}% \IndexCmd{AfterCalculatingTypearea} nach jeder etwaigen Neuberechnung des @@ -310,64 +310,64 @@ entnehmen. \fi Mit dieser Information kann dann die neue Notizspalte definiert werden. Bei - der Festlegung der Position wird ein einfacher Längenausdruck genutzt. Dabei + 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. + 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. + Notizspalte bisher im Textbereich ausgegeben wird. Die Notizspalte würde + also den Text überschreiben. \begin{lstcode} \begin{document} - \title{Kommentar zum GüdaVaS} + \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 + 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 damaligen Spaßvesier - abgelehnt. Erst nach Umwandlung der spaßmanischen, - aberwitzigen Monarchie in eine repräsentative, + bereits am 11.\,11.~1111 im obersten spaßmanischen + Kongress statt, wurde aber vom damaligen 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 + den Urkomischen, am 9.\,9.~1999 war der Weg für dieses Gesetz endlich frei. \end{lstcode} Dadurch,\textnote{Achtung!} 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 +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. + ergänzen. \end{Example} % -Offen blieb in dem Beispiel die Frage, wie der Text für den Kommentar schmaler +Offen blieb in dem Beispiel die Frage, wie der Text für den Kommentar schmaler gesetzt werden kann. Dies werden Sie bei der Fortsetzung des Beispiels erfahren.% % %\begin{table}% Umbruchoptimierung: Tabelle hinter das Beispiel verschoben \begin{desclist} \desccaption{% -% \caption[Mögliche Einstellungen für die Deklaration von Notizspalten]{% - Mögliche Einstellungen für die Deklaration von Notizspalten% +% \caption[Mögliche Einstellungen für die Deklaration von Notizspalten]{% + 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 + Mögliche Einstellungen für die Deklaration von Notizspalten (\emph{Fortsetzung})% }% % \begin{desctabular} \entry{\OptionVName{font}{Schriftattribute}}{% Einstellung der \PName{Schriftattribute} der Notizspalte mit Hilfe von - \DescRef{\LabelBase.cmd.setkomafont}. Für erlaubte Werte sei auf + \DescRef{\LabelBase.cmd.setkomafont}. Für erlaubte Werte sei auf \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont} verwiesen.\par% Voreinstellung: \emph{leer}% @@ -390,12 +390,12 @@ erfahren.% }% \entry{\OptionVName{position}{Abstand}}{% Die Notizspalte wird mit \PName{Abstand} vom linken Rand des Papiers - gesetzt. Dabei sind für \PName{Abstand} auch komplexe Ausdrücke + 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% + 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{\Option{reversemarginpar}}{% @@ -406,12 +406,12 @@ erfahren.% Voreinstellung: \emph{nein}% }% \entry{\OptionVName{width}{Breite}}{% - Die Notizspalte wird mit der angegebenen Breite gesetzt. Dabei sind für - \PName{Breite} auch komplexe Ausdrücke gestattet, solange diese voll + 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ängenausdrücken.\par% + Länge oder 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}}% }% % \end{desctabular} @@ -423,16 +423,16 @@ erfahren.% \section{Erstellen einer Notiz} \seclabel{makenote} -Nachdem eine Notizspalte deklariert wurde, können Notizen für diese Spalte +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. Ganz genau werden die Notizen sogar zunächst in die +sondern zunächst nur in eine Hilfsdatei mit Endung »\File{.slnc}« +geschrieben. 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}\IndexCmd{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 werden die Notizen für die jeweilige Seite +übertragen. Dabei wird gegebenenfalls auch die Einstellung +\Macro{nofiles}\IndexCmd{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 werden die Notizen für die jeweilige Seite ausgegeben. \iffree{}{\pagebreak}% Umbruchoptimierung @@ -444,7 +444,7 @@ ausgegeben werden, deren Seitenstil auf dem Paket \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 +benötigt, wird zusätzlich das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} @@ -456,30 +456,30 @@ empfohlen. \Macro{makenote*}\OParameter{Name der Notizspalte}\Parameter{Notiz} \end{Declaration} Mit Hilfe dieser Anweisungen 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 +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}\IndexCmd{pdfsavepos}, \Macro{pdflastypos}\IndexCmd{pdflastypos} und \Macro{pdfpageheight}\IndexLength{pdfpageheight} beziehungsweise deren Entsprechungen bei neueren Lua\TeX-Versionen angewiesen. Ohne diese Befehle -funktioniert \Package{scrlayer-notecolumn} nicht. Dabei wird außerdem davon +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\textnote{Kollisionsauf"|lösung} mit einer früheren Notiz in derselben -Notizspalte erkannt, so wird die \PName{Notiz} bis unter diese frühere Notiz +Kollision\textnote{Kollisionsauf"|lösung} 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\textnote{Seitenumbruch}\Index{Seiten>Umbruch}, so wird sie ganz oder -teilweise auf die nächste Seite umbrochen. +teilweise auf die nächste Seite umbrochen. -Für welche Notizspalte die \PName{Notiz} erstellt werden soll, wird über das +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 + 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} @@ -503,17 +503,17 @@ verwendet.% dokumentierte Umgebung \DescRef{maincls.env.addmargin}\IndexEnv{addmargin}\textnote{Spaltenbreite mit \DescRef{maincls.env.addmargin}} wird genutzt, um den - Haupttext in der Breite um die Spalte für die Paragraphen zu + 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\textnote{zerbrechliche Befehle} innerhalb des Arguments + können Befehle\textnote{zerbrechliche 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. + Befehlen innerhalb dieses Arguments zu Fehlermeldungen führen. - Prinzipiell könnten Sie das Beispiel nun bereits mit + Prinzipiell könnten Sie das Beispiel nun bereits mit \begin{lstcode} \end{addmargin} \end{document} @@ -522,18 +522,42 @@ verwendet.% \end{Example}% Beim Testen des Beispiels, werden Sie feststellen, dass die Gesetzes\-spalte tiefer hinunter reicht als der Kommentartext. Wenn\textnote{Achtung!} Sie -zwecks Übung einen weiteren Abschnitt mit einem weiteren Paragraphen -hinzufügen, ergibt sich eventuell das Problem, dass der Kommentar nicht +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 +Kommentar fortgesetzt wird. Eine Lösung für dieses Problem, werden Sie gleich kennenlernen. -Das\ChangedAt{v0.1.2583}{\Package{scrlayer-notecolumn}} im Beispiel erwähnte +Das\ChangedAt{v0.1.2583}{\Package{scrlayer-notecolumn}} im Beispiel erwähnte Problem mit dem Zerbrechen von Befehlen tritt bei der Sternvariante\important{\Macro{makenote*}} normalerweise nicht auf. Diese verwendet \Macro{detokenize}, um die Expansion zu verhindern. Das bedeutet aber auch, dass man in der \PName{Notiz} keine Befehle verwenden sollte, die -ihre Bedeutung innerhalb des Dokuments verändern.% +ihre Bedeutung innerhalb des Dokuments verändern. + +Allerdings treten bei beiden Formen zwei andere Probleme\textnote{Achtung!} +auf. Das erste betrifft die Verwendung von Farbe mit Hilfe von +\Package{color}\IndexPackage{color} oder \Package{xcolor}\IndexPackage{xcolor} +innerhalb der Notizspalten. Um Farbumschaltungen innerhalb der Notizspalten zu +ermöglichen, wäre für jede Notizspalte eine eigene Farbverwaltung mit einem +sogenannten \emph{Color Stack} notwendig. Da das Paket lediglich als +Machbarkeitsstudie entworfen ist und \XeTeX{} nicht mehrere \emph{Color + Stacks} unterstützt, sind mit \XeTeX{} Farbumschaltungen nur eingeschränkt +über die Schriftattribute des Elements \FontElement{notecolumn.\PName{Name der + Notizspalte}} möglich, wodurch der Aufwand für die Implementierung einer +eigenen Farbverwaltung umgangen wurde. + +Das zweite, eher konzeptionelle Problem\textnote{Achtung!} ist, dass die +Hilfsdatei mit den Informationen zum Inhalt der Notizspalte während der +Verarbeitung der Kopfzeile einer Seite eingelesen wird. Das hat vor allem dann +Auswirkungen, wenn dies geschieht, während eine Umgebung wie +\Environment{verbatim} aktiv ist. In diesem Fall wären während des Einlesens +der Hilfsdatei die \Macro{catcode}-Einstellungen dieser Umgebung aktiv. Dies +würde zwangsläufig zu Fehlern in der Verarbeitung und Ausgabe führen. Um dies +abzumildern, werden während \Macro{begin}\PParameter{document} die +\Macro{catcode}-Einstellungen der in \Macro{dospecials}\IndexCmd{dospecials} +gespeicherten Zeichen gespeichert und während dem Einlesen der Hilfsdatei +explizit wiederhergestellt.% \EndIndexGroup @@ -551,25 +575,25 @@ 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. +einer späteren Seite, so wird im Haupttext bis zu der Stelle der Notizspalte +vorgerückt. In der Regel sollten Synchronisierungspunkte\textnote{Hinweis!} 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 +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}\IndexCmd{vspace}. -Dadurch, dass Synchronisierungspunkte in den Notizspalten erst beim nächsten -\LaTeX-Lauf\textnote{mehrere \LaTeX-Läufe} 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 +Dadurch, dass Synchronisierungspunkte in den Notizspalten erst beim nächsten +\LaTeX-Lauf\textnote{mehrere \LaTeX-Läufe} 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 +»\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, so wird an seiner Stelle @@ -581,17 +605,17 @@ optionalen Arguments ist! Es ist nicht\textnote{Achtung!} 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 auf"|treten, so dass nie ein endgültiger Zustand erreicht +nicht abgefangen werden und führt dazu, dass mit jedem \LaTeX-Lauf neue +Verschiebungen auf"|treten, 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 + Führen wir nun das obige Beispiel fort, indem wir zunächst einen Synchronisationspunkt und dann einen weiteren Paragraphen - mit Kommentar hinzufügen: + mit Kommentar hinzufügen: \begin{lstcode} \syncwithnotecolumn[paragraphs]\bigskip \makenote[paragraphs]{% @@ -599,7 +623,7 @@ wird nachfolgend beschrieben.% \protect\Clause{title={Komik der Kultur}} \setcounter{par}{0}% Die Komik eines Witzes kann durch das - kulturelle Umfeld, in dem er erzählt wird, + kulturelle Umfeld, in dem er erzählt wird, bestimmt sein. Die Komik eines Witzes kann durch das @@ -608,7 +632,7 @@ wird nachfolgend beschrieben.% \protect\end{contract} } Die kulturelle Komponente eines Witzes ist - tatsächlich nicht zu vernachlässigen. Über die + tatsächlich nicht zu vernachlässigen. Ãœber die politische Korrektheit der Nutzung des kulturellen Umfeldes kann zwar trefflich gestritten werden, nichtsdestotrotz ist die @@ -616,19 +640,19 @@ wird nachfolgend beschrieben.% entsprechenden 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. + 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 + 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\textnote{Achtung!} wird hier ein weiterer Punkt, der zu einem + Außerdem\textnote{Achtung!} 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\textnote{Zähler in + zusammengebaut und zerlegt werden, kann es bei Zählern\textnote{Zähler in Notizspalten} 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. + 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: @@ -636,19 +660,19 @@ wird nachfolgend beschrieben.% \end{addmargin} \end{document} \end{lstcode} - Tatsächlich wären natürlich auch noch die restlichen Paragraphen des + Tatsächlich wären natürlich auch noch die restlichen Paragraphen des Gesetzes 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. +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. \EndIndexGroup \begin{Declaration} \Macro{syncwithnotecolumns}\OParameter{Liste von Notizspalte} \end{Declaration} -Diese Anweisung führt eine Synchronisierung des Haupttextes mit allen in der +Diese Anweisung führt eine Synchronisierung des Haupttextes mit allen in der mit Komma separierten \PName{Liste von Notizspalten} durch. Dabei wird der Haupttext mit der Notizspalte synchronisiert, deren Marke am weitesten hinten im Dokument steht. Somit werden als Nebeneffekt auch die Notizspalten @@ -666,8 +690,8 @@ synchronisiert.% Neben der normalen Ausgabe der Notizspalten, wie sie im vorherigen Abschnitt 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 +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\Index{Ausgabe>erzwungene} ist beispielsweise das Ende eines Kapitels oder das Ende des Dokuments. @@ -675,35 +699,35 @@ Ende eines Kapitels oder das Ende des Dokuments. \Macro{clearnotecolumn}\OParameter{Name der Notizspalte} \end{Declaration} Mit dieser Anweisung werden alle Notizen einer bestimmen Notizspalte -ausgegeben, die\textnote{anhängige Notizen}\Index{Notiz>anhaengige=anhängige} +ausgegeben, die\textnote{anhängige Notizen}\Index{Notiz>anhaengige=anhängige} 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 +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 zur -Ausgabe der anhängigen Notizen der angegebenen Notizspalte notwendig ist. +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\textnote{irrtümliche - Notizen}\Index{Notiz>irrtuemliche=irrtümliche} ausgegeben werden, die im +Während der Ausgabe der anhängigen Notizen kann es auch geschehen, dass +irrtümlich Notizen\textnote{irrtümliche + Notizen}\Index{Notiz>irrtuemliche=irrtümliche} 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.« +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 +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\textnote{erzwungene Ausgabe vs. Synchronisation} 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 +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.% +letzten Ausgabe. Dafür terminiert die erzwungene Ausgabe in der Regel mit +weniger \LaTeX-Läufen.% \EndIndexGroup @@ -714,51 +738,51 @@ Diese Anweisung arbeitet vergleichbar mit \DescRef{\LabelBase.cmd.clearnotecolumn}. Allerdings kann hier als optionales Argument nicht nur eine Notizspalte angegeben werden, sondern es ist eine durch Komma getrennte Liste mehrerer Namen von Notizspalten erlaubt. Es werden -dann die anhängigen Notizen all dieser Spalten ausgegeben. +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.% +anhängigen Notizen aller Notizspalten ausgegeben.% \EndIndexGroup \begin{Declaration} \OptionVName{autoclearnotecolumns}{Ein-Aus-Wert} \end{Declaration} -In der Regel wird man anhängige Notizen immer dann ausgeben lassen, wenn im +In der Regel wird man anhängige Notizen immer dann ausgeben lassen, wenn im Dokument explizit oder implizit -- beispielsweise in Folge von \DescRef{maincls.cmd.chapter} -- die Anweisung \DescRef{maincls.cmd.clearpage} -ausgeführt wird. Dies ist auch am Ende eines Dokuments innerhalb von -\Macro{end}\PParameter{document} der Fall. Über die Option -\Option{autoclearnotecolumns} kann daher gesteuert werden, ob bei Ausführung +ausgeführt wird. Dies ist auch am Ende eines Dokuments innerhalb von +\Macro{end}\PParameter{document} der Fall. Ãœber die Option +\Option{autoclearnotecolumns} kann daher gesteuert werden, ob bei Ausführung von \DescRef{maincls.cmd.clearpage} automatisch auch -\DescRef{\LabelBase.cmd.clearnotecolumns} ohne Argument ausgeführt werden +\DescRef{\LabelBase.cmd.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 +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\textnote{Achtung!}, 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 +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 -\DescRef{\LabelBase.cmd.clearnotecolumns} einfügen. +\DescRef{\LabelBase.cmd.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 -\DescRef{maincls.env.addmargin}-Umgebung geschehen würde, könnte es eventuell -noch zu Überlappungen durch nachfolgenden Text kommen. Daher wäre es im +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 +\DescRef{maincls.env.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 \DescRef{maincls.env.addmargin}-Umgebung -einen weiteren Synchronisationspunkt einzufügen. +einen weiteren Synchronisationspunkt einzufügen. -Das Ergebnis des Beispiels ist übrigens in +Das Ergebnis des Beispiels ist übrigens in \autoref{fig:scrlayer-notecolumn.example} zu sehen.\iffree{}{ Dabei wurde - lediglich die Farbeinstellung für die \PValue{paragraphs}-Spalte von Blau in - Grau geändert.} + lediglich die Farbeinstellung für die \PValue{paragraphs}-Spalte von Blau in + Grau geändert.} \begin{figure} \KOMAoptions{captions=bottombeside}% @@ -778,7 +802,7 @@ Das Ergebnis des Beispiels ist übrigens in %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "scrlayer-de.tex" %%% TeX-PDF-mode: t @@ -786,7 +810,7 @@ Das Ergebnis des Beispiels ist übrigens in % LocalWords: Randnotizen Entwicklungsstadium Notizspalte Notizspalten % LocalWords: Neukonfigurierung Synchronisierungspunkt marginpar marginline -% LocalWords: Haupttext Demonstrationszwecken Längenausdruck Gesetzestexten -% LocalWords: Längenausdrücken Satzspiegels typearea scrlayer notecolumn +% LocalWords: Haupttext Demonstrationszwecken Längenausdruck Gesetzestexten +% LocalWords: Längenausdrücken Satzspiegels typearea scrlayer notecolumn % LocalWords: AfterCalculatingTypearea scrjura scrpage Farbeinstellung % LocalWords: Sternvariante diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage-experts.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage-experts.tex index 1c01b4598e..6e8741f6f3 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage-experts.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-scrpage-experts.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -39,30 +39,30 @@ % % ---------------------------------------------------------------------- % -% Expertenkapitel über scrlayer-scrpage in der KOMA-Script-Anleitung +% Expertenkapitel über scrlayer-scrpage in der KOMA-Script-Anleitung % % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage-experts.tex}% - [$Date: 2018-01-31 09:21:42 +0100 (Wed, 31 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlayer-scrpage for experts)] -\chapter[{Zusätzliche Möglichkeiten von \Package{scrlayer-scrpage}}] -{Zusätzliche Möglichkeiten des +\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} % \BeginIndexGroup \BeginIndex{Package}{scrlayer-scrpage}% -Über die Erklärungen in \autoref{cha:scrlayer-scrpage} von +Ãœ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 +das Paket \Package{scrlayer-scrpage} viele weitere Möglichkeiten. Diese stellen jedoch Erweiterungen dar, die der durchschnittliche Anwender -nicht zwingend benötigt oder die nur aus Gründen der Kompatibilität zu +nicht zwingend benötigt oder die nur aus Gründen der Kompatibilität zu \Package{scrpage2} existieren. Ihre Dokumentation hier in \autoref{part:forExperts} dient der Vertiefung und der Erweiterung des -Wissens. Ihre Beherrschung geht über grundlegende Fähigkeiten hinaus. +Wissens. Ihre Beherrschung geht über grundlegende Fähigkeiten hinaus. \LoadCommonFile{pagestylemanipulation}% \section{Beeinflussung von definierten Seitenstilen} @@ -72,23 +72,23 @@ Wissens. Ihre Beherrschung geht über grundlegende Fähigkeiten hinaus. 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 +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 +ohne Kolumnentitel aber üblicherweise mit Paginierung, also mit Seitenzahl ist. Neben der Konfiguration dieses vordefinierten Paares bietet -\Package{scrlayer-scrpage} auch die Möglichkeit, zusätzliche Paare zu +\Package{scrlayer-scrpage} auch die Möglichkeit, zusätzliche Paare zu definieren. Der Name des Haupt-Seitenstils, beispielsweise \PageStyle{scrheadings}, dient dabei quasi auch als Name des Seitenstil-Paares. \iffree{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 + 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.}{} + 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} @@ -100,13 +100,13 @@ definieren. Der Name des Haupt-Seitenstils, beispielsweise \Macro{providepairofpagestyles}\OParameter{Eltern-Paar} \Parameter{Name}\Parameter{Definition} \end{Declaration} -Mit diesen Anweisungen können Paare von Seitenstilen vergleichbar zu +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 +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 +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. @@ -116,10 +116,10 @@ werden soll. Das neue Paar erbt also quasi die Konfiguration des \PName{Eltern-Paar}s. {\setlength{\emergencystretch}{1em}% -Während in \autoref{sec:scrlayer-scrpage.predefined.pagestyles} der Eindruck -entstanden sein mag, dass sich die dort erläuterten Anweisungen nur auf +Während in \autoref{sec:scrlayer-scrpage.predefined.pagestyles} der Eindruck +entstanden sein mag, dass sich die dort erläuterten Anweisungen nur auf \PageStyle{scrheadings} und \PageStyle{plain.scrheadings} beziehen, gilt das -tatsächlich nur, solange diese beiden Seitenstile das einzige Seitenstil-Paar +tatsächlich nur, solange diese beiden Seitenstile das einzige Seitenstil-Paar darstellen. Sobald es mehrere Seitenstil-Paare gibt, beziehen sich \DescRef{scrlayer-scrpage.cmd.lehead}, \DescRef{scrlayer-scrpage.cmd.cehead}, \DescRef{scrlayer-scrpage.cmd.rehead}, \DescRef{scrlayer-scrpage.cmd.lohead}, @@ -137,10 +137,10 @@ auf das zuletzt aktive Paar.\par} dokumentierten Anweisungen \DescRef{scrlayer-scrpage-experts.cmd.clearmainofpairofpagestyles}, \DescRef{scrlayer-scrpage-experts.cmd.clearplainofpairofpagestyles} und - \DescRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles} für die + \DescRef{scrlayer-scrpage-experts.cmd.clearpairofpagestyles} für die Verwendung im letzten Parameter, \PName{Definition}, gedacht. In diesem Fall stellen sie eine Art Grundkonfiguration des Seitenstil-Paares dar, die immer - dann ausgeführt wird, wenn das Seitenstil-Paar aktiviert wird. Ein + 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 \DescRef{maincls.cmd.pagestyle}\IndexCmd{pagestyle}.\par} @@ -148,16 +148,16 @@ auf das zuletzt aktive Paar.\par} Es sei darauf hingewiesen, dass die Anweisungen aus \autoref{sec:scrlayer-scrpage.pagestyle.content} ab \autopageref{sec:scrlayer-scrpage.pagestyle.content} ohnehin allgemeiner Natur -sind und für alle mit \PageStyle{scrlayer-scrpage} definierten Seitenstile +sind und für alle mit \PageStyle{scrlayer-scrpage} definierten Seitenstile gelten. -Während\textnote{Unterschiede} \Macro{defpairofpagestyles} das Seitenstil-Paar -unabhängig davon, ob entsprechende Seitenstile bereits existieren, definiert, +Während\textnote{Unterschiede} \Macro{defpairofpagestyles} das Seitenstil-Paar +unabhängig davon, ob entsprechende Seitenstile bereits existieren, definiert, tun \Macro{newpairofpagestyles} und \Macro{providepairofpagestyles} dies 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, wohingegen sie bei -\Macro{newpairofpagestyles} zu einem Fehler führt. Für die Umdefinierung +\Macro{newpairofpagestyles} zu einem Fehler führt. 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.% @@ -173,18 +173,18 @@ Mit \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 +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! +ausgeführt! -Die Anweisungen können ebenfalls innerhalb von \PName{Definition} bei der -zuvor erklärten Definition eines Seitenstil-Paares verwendet werden. Sie -können aber auch jederzeit außerhalb der Definition eines Seitenstil-Paares +Die Anweisungen können ebenfalls innerhalb von \PName{Definition} bei der +zuvor erklärten Definition eines Seitenstil-Paares verwendet werden. Sie +können aber auch jederzeit außerhalb der Definition eines Seitenstil-Paares verwendet werden. In diesem Fall beziehen sie sich auf das zuletzt aktivierte Paar.% \EndIndexGroup @@ -195,50 +195,50 @@ Paar.% Neben den vordefinierten Seitenstilen bietet \Package{scrlayer-scrpage} auch noch eine eher grundlegende Schnittstelle zur Definition von Seitenstilen. Die -bisher erläuterten Konzepte greifen bei der Implementierung ebenso wie die von -\autoref{sec:\LabelBase.pagestyle.triple} auf diese Möglichkeit -zurück. Aufgrund ihrer hohen Komplexität wird sie 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. +bisher erläuterten Konzepte greifen bei der Implementierung ebenso wie die von +\autoref{sec:\LabelBase.pagestyle.triple} auf diese Möglichkeit +zurück. Aufgrund ihrer hohen Komplexität wird sie 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. \begin{Declaration} \Macro{defpagestyle}\Parameter{Name} \Parameter{Kopfdefinition} - \Parameter{Fußdefinition} + \Parameter{Fußdefinition} \Macro{newpagestyle}\Parameter{Name} \Parameter{Kopfdefinition} - \Parameter{Fußdefinition} + \Parameter{Fußdefinition} \Macro{providepagestyle}\Parameter{Name} \Parameter{Kopfdefinition} - \Parameter{Fußdefinition} + \Parameter{Fußdefinition} \Macro{renewpagestyle}\Parameter{Name} \Parameter{Kopfdefinition} - \Parameter{Fußdefinition} + \Parameter{Fußdefinition} \end{Declaration} Diese Anweisungen dienen der Definition eines einzelnen Seitenstils mit -maximaler Flexibilität. Dabei ist \PName{Name} der Name des Seitenstils, der +maximaler Flexibilität. Dabei ist \PName{Name} der Name des Seitenstils, der definiert werden soll. -Die beiden Parameter \PName{Kopfdefinition} und \PName{Fußdefinition} haben +Die beiden Parameter \PName{Kopfdefinition} und \PName{Fußdefinition} haben den identischen Aufbau: \begin{flushleft} \begin{addmargin}{1em}\raggedright\small - \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})% + \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{addmargin} \end{flushleft} -Dabei sind die Argumente in den runden Klammern optional, das heißt, sie -können zusammen mit den Klammern weggelassen +Dabei sind die Argumente in den runden Klammern optional, das heißt, sie +können zusammen mit den Klammern weggelassen werden. In\important[i]{\DescRef{scrlayer-scrpage.option.headtopline}\\ \DescRef{scrlayer-scrpage.option.headsepline}\\ \DescRef{scrlayer-scrpage.option.footsepline}\\ \DescRef{scrlayer-scrpage.option.footbotline}} diesem Fall richten sich die -Längen und Dicken je nach Linie nach den Angaben der Optionen +Längen und Dicken je nach Linie nach den Angaben der Optionen \DescRef{scrlayer-scrpage.option.headtopline}\IndexOption{headtopline}, \DescRef{scrlayer-scrpage.option.headsepline}\IndexOption{headsepline}, \DescRef{scrlayer-scrpage.option.footsepline}\IndexOption{footsepline} und @@ -248,30 +248,30 @@ Längen und Dicken je nach Linie nach den Angaben der Optionen 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 +wählbar. Für Seitenstile mit Kolumnentitel wird jedoch die Verwendung von \DescRef{scrlayer-scrpage.cmd.headmark}, \DescRef{scrlayer-scrpage.cmd.leftmark} oder \DescRef{scrlayer-scrpage.cmd.rightmark} innerhalb der Definitionen empfohlen. Keinesfalls sollte man hier direkt eine Gliederungsnummer oder -einen Überschriftentext als Kolumnentitel angeben. Aufgrund des asynchronen +einen Ãœberschriftentext als Kolumnentitel angeben. Aufgrund des asynchronen Seitenaufbaus von \LaTeX{} kann sonst die falsche Nummer oder der falsche Text -im Seitenkopf oder Seitenfuß erscheinen. +im Seitenkopf oder Seitenfuß erscheinen. -Bei\textnote{Unterschiede} \Macro{defpagestyle} wird der Seitenstil unabhängig -davon, ob er bereits existiert oder nicht, neu definiert. Demgegenüber meldet +Bei\textnote{Unterschiede} \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 +\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 +bereits vorhandener Seitenstil umdefiniert werden. Für einen neuen Namen meldet diese Anweisung dagegen einen Fehler. Alle vier Anweisungen basieren auf \DescRef{scrlayer.cmd.DeclarePageStyleByLayers}% \IndexCmd{DeclarePageStyleByLayers} des Pakets \hyperref[cha:scrlayer]{\Package{scrlayer}}\IndexPackage{scrlayer}. Die dabei -für einen Seitenstil \PName{Name} definierten Ebenen sind in -\autoref{tab:scrlayer-scrpage-experts.layersperstyle} aufgeführt. Näheres zu +für einen Seitenstil \PName{Name} definierten Ebenen sind in +\autoref{tab:scrlayer-scrpage-experts.layersperstyle} aufgeführt. Näheres zu Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab \autopageref{cha:scrlayer} zu entnehmen.% @@ -289,7 +289,7 @@ Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab \toprule Name der Ebene & Bedeutung der Ebene \\ \midrule - \PName{Name}\PValue{.head.above.line} & die Linie über dem Kopf\\ + \PName{Name}\PValue{.head.above.line} & die Linie über dem Kopf\\ \PName{Name}\PValue{.head.odd} & der Kopf von rechten Seiten im doppelseitigen Layout\\ \PName{Name}\PValue{.head.even} & der Kopf von linken Seiten im @@ -297,14 +297,14 @@ Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab \PName{Name}\PValue{.head.oneside} & der Kopf von Seiten im einseitigen Layout\\ \PName{Name}\PValue{.head.below.line} & die Linie unter dem Kopf\\ - \PName{Name}\PValue{.foot.above.line} & die Linie über dem Fuß\\ - \PName{Name}\PValue{.foot.odd} & der Fuß von rechten Seiten im + \PName{Name}\PValue{.foot.above.line} & die Linie über dem Fuß\\ + \PName{Name}\PValue{.foot.odd} & der Fuß von rechten Seiten im doppelseitigen Layout\\ - \PName{Name}\PValue{.foot.even} & der Fuß von linken Seiten im + \PName{Name}\PValue{.foot.even} & der Fuß von linken Seiten im doppelseitigen Layout\\ - \PName{Name}\PValue{.foot.oneside} & der Fuß von Seiten im + \PName{Name}\PValue{.foot.oneside} & der Fuß von Seiten im einseitigen Layout\\ - \PName{Name}\PValue{.foot.below.line} & die Linie unter dem Fuß\\ + \PName{Name}\PValue{.foot.below.line} & die Linie unter dem Fuß\\ \bottomrule \end{tabular} % \end{captionbeside} @@ -317,8 +317,8 @@ Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab wissen Sie, dass \PageStyle{scrheadings} ein Ebenen-Seitenstil ist, der unter anderem aus den Ebenen \PValue{scrheadings.head.oneside}, \PValue{scrheadings.head.odd} und \PValue{scrheadings.head.even} - besteht. Sie definieren nun drei weitere Ebenen für deren Hintergrund und - fügen diese am Anfang des Seitenstils ein: + 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} @@ -356,32 +356,32 @@ Ebenen und Ebenen-Seitenstilen ist \autoref{cha:scrlayer} ab \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}\important{\Option{clone}} einfach jeweils von der Ebene für + und Größe der Hintergrund-Ebenen per Option + \Option{clone}\important{\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 + 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{rule}-Anweisung gesetzt. Für die Größe wurde dabei mit \DescRef{scrlayer.cmd.layerwidth}\IndexCmd{layerwidth}% \important[i]{\DescRef{scrlayer.cmd.layerwidth}\\ \DescRef{scrlayer.cmd.layerheight}} und \DescRef{scrlayer.cmd.layerheight}\IndexCmd{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. + 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 -\DescRef{scrlayer-scrpage.cmd.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. Eine entsprechende Umsetzung -bietet sich als weitere Übung an.% +Statt wie im Beispiel für die Hintergrundfarbe neue Ebenen hinzuzufügen, hätte +man das Problem übrigens auch mit \Macro{colorbox} und +\DescRef{scrlayer-scrpage.cmd.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. Eine entsprechende Umsetzung +bietet sich als weitere Ãœbung an.% \EndIndexGroup -\section{Definition einfacher Seitenstile mit dreigeteiltem Kopf und Fuß} +\section{Definition einfacher Seitenstile mit dreigeteiltem Kopf und Fuß} \seclabel{pagestyle.triple} \LoadNonFree{scrlayer-scrpage-experts}{1} @@ -390,28 +390,28 @@ bietet sich als weitere Übung an.% \seclabel{obsolete} \begin{Explain} - Das Paket \Package{scrlayer-scrpage} enthält auch noch einige Altlasten, die - von \Package{scrpage2} stammen und nur existieren, um möglichst kompatibel - mit jenem Paket zu sein. Kenntnisse dazu benötigen Anwender nur, wenn sie + Das Paket \Package{scrlayer-scrpage} enthält auch noch einige Altlasten, die + von \Package{scrpage2} stammen und nur existieren, um möglichst kompatibel + mit jenem Paket zu sein. Kenntnisse dazu benötigen Anwender nur, wenn sie ein altes Dokument, das noch auf \Package{scrpage2} basiert, bearbeiten - wollen. Für\textnote{Achtung!} neue Dokumente sollten die hier dokumentieren + wollen. Für\textnote{Achtung!} neue Dokumente sollten die hier dokumentieren Dinge dagegen nicht verwendet werden! \end{Explain} \begin{Declaration} \OptionVName{hmode}{Ein-Aus-Wert} \end{Declaration} -Bei \Package{scrpage2} wurden die Köpfe und Füße der Seitenstile noch -grundsätzlich im horizontalen Modus ausgegeben. Bei \Package{scrlayer-scrpage} +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 +\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 +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.% \EndIndexGroup @@ -423,11 +423,11 @@ sind. In der Voreinstellung ist der Schalter deaktiviert.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: -% LocalWords: Hintergrundebene Seitenkopf Seitenstils Kopfelement Seitenfuß +% LocalWords: Hintergrundebene Seitenkopf Seitenstils Kopfelement Seitenfuß % LocalWords: Seitenstile Seitenstilen diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage.tex index 2a2adf3ad8..dd968107e3 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer-scrpage.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage.tex -% Copyright (c) Markus Kohm, 2014-2018 +% Copyright (c) Markus Kohm, 2014-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer-scrpage.tex -% Copyright (c) Markus Kohm, 2014-2018 +% Copyright (c) Markus Kohm, 2014-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -39,16 +39,16 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrlayer-scrpage in der KOMA-Script-Anleitung +% Kapitel über scrlayer-scrpage in der KOMA-Script-Anleitung % % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage.tex}% - [$Date: 2018-02-13 09:46:41 +0100 (Tue, 13 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ 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 +\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} % @@ -58,11 +58,11 @@ Bis \KOMAScript~3.11b war das Paket \Package{scrpage2}\IndexPackage[indexmain]{scrpage2}% \important{\Package{scrpage2}} das Mittel der Wahl, wenn es darum ging, den - Kopf und den Fuß der Seite über das hinaus zu verändern, was die + 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. \iffalse% - Bis 2001 gab es dafür auch noch das Paket + 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.\par \fi% @@ -70,14 +70,14 @@ \important{\hyperref[cha:scrlayer]{\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 + 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 + 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 + da sie für die Verwendung von \Package{scrlayer-scrpage} ebenfalls benötigt werden. Viele Anwender sind bereits mit den Anweisungen aus \Package{scrpage2} @@ -85,29 +85,29 @@ 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 + 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.% + ersetzen. Das gilt mit der genannten Einschränkung auch für die meisten + Beispiele in \LaTeX-Büchern oder im Internet.% \iffalse -\iffree{}{\par Mit Erscheinen dieses Buches wird \Package{scrlayer-scrpage} für - \KOMAScript{} das empfohlene Mittel der Wahl, wenn es um Änderungen der +\iffree{}{\par 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} + 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 + erwägen. Für alle Fälle finden Sie in diesem Kapitel auch einige Hinweise zur Verwendung von \Package{scrpage2}.} \fi \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 \DescRef{\LabelBase.cmd.setkomafont}, +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 \DescRef{\LabelBase.cmd.setkomafont}, \DescRef{\LabelBase.cmd.addtokomafont} und \DescRef{\LabelBase.cmd.usekomafont} in \autoref{sec:scrlayer-scrpage.textmarkup}, ab @@ -116,40 +116,40 @@ der Gliederungsnummern in Kolumnentiteln (siehe Option \DescRef{maincls.option.numbers} und beispielsweise Anweisung \DescRef{\LabelBase.cmd.chaptermarkformat} in \autoref{sec:maincls.structure}, \DescPageRef{maincls.option.numbers} und -\DescPageRef{maincls.cmd.chaptermarkformat}), nicht. Daher wird für die +\DescPageRef{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 + 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 +Ãœ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 +\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 nahegelegt. -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} -\LoadCommonFile{headfootheight} % \section{Höhe von Kopf und Fuß} +\LoadCommonFile{headfootheight} % \section{Höhe von Kopf und Fuß} \LoadCommonFile{textmarkup} % \section{Textauszeichnung} \section{Verwendung vordefinierter Seitenstile} \seclabel{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 +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 + 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 @@ -158,28 +158,28 @@ vorgefertigten Seitenstils. \PageStyle{scrheadings} \PageStyle{plain.scrheadings} \end{Declaration} -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 +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 +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 +\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 +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 +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 +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 +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 @@ -189,8 +189,8 @@ aktivierbar. Das hat den Vorteil, dass bei Klassen, die automatisch zwischen 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 +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.% \EndIndexGroup @@ -222,57 +222,57 @@ geschrieben wird, ist mit Hilfe dieser Befehle einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines Elements in \DescRef{\LabelBase.pagestyle.plain.scrheadings}% \iffalse% Umbruchvarianten -\iffree{}{ beziehungsweise \PageStyle{scrplain}} \fi , während das +\iffree{}{ beziehungsweise \PageStyle{scrplain}} \fi , während das obligatorische Argument jeweils einen Inhalt in \DescRef{\LabelBase.pagestyle.scrheadings} setzt. -Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den +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«). +»\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 +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«). +»\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. +unabhängig von ihrer Nummer als ungerade Seiten bezeichnet werden. -Jeder Kopf eines Seitenstils besitzt ein linksbündiges\textnote{linksbündig} +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«). +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{centered}« (engl. für »zentriert«). +werden kann. Das »\texttt{c}« am Anfang des Befehlsnamens steht hier für +»\emph{centered}« (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«). +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«). \BeginIndexGroup \BeginIndex{FontElement}{pagehead}\LabelFontElement{pagehead}% \BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}% -Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit +Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit Hilfe der Befehle \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:scrlayer-scrpage.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}), sondern alle zusammen -über das Element \FontElement{pagehead}\important{\FontElement{pagehead}}. Vor -diesem wird außerdem noch das Element +ü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 +angewandt. Die Voreinstellungen für diese beiden Elemente sind \autoref{tab:scrlayer-scrpage.fontelements}, \autopageref{tab:scrlayer-scrpage.fontelements} zu entnehmen.% \EndIndexGroup In \autoref{fig:scrlayer-scrpage.head} ist die Bedeutung der einzelnen Befehle -für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% +für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% % \begin{figure}[tp] \centering @@ -345,7 +345,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}% \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cohead}}}% }% - % Befehle für beide Seiten + % Befehle für beide Seiten \color{ImageBlue}% \put(.5\textwidth,0){\makebox(0,\baselineskip)[c]{\Macro{ihead}}}% \color{ImageGreen}% @@ -385,7 +385,7 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% \end{picture} \caption[Befehle zum Setzen des Seitenkopfes]% {Die Bedeutung der Befehle zum Setzen der Inhalte des Kopfes eines - Seitenstils für die Seitenköpfe einer schematischen Doppelseite} + Seitenstils für die Seitenköpfe einer schematischen Doppelseite} \label{fig:scrlayer-scrpage.head} \end{figure} % @@ -406,30 +406,30 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% \end{document} \end{lstcode} Doch, was ist das? Auf der ersten Seite erscheint nur eine Seitenzahl im - Fuß, der Kopf hingegen bleibt leer! + 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 + 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 - \DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} in der Präambel - unseres Beispiels führt dies tatsächlich zur Verwendung des Seitenstils - \DescRef{\LabelBase.pagestyle.plain.scrheadings} für die Seite mit dem + \DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} in der Präambel + unseres Beispiels führt dies tatsächlich zur Verwendung des Seitenstils + \DescRef{\LabelBase.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 + 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 \DescRef{\LabelBase.pagestyle.plain.scrheadings} - unverändert. Das Ergebnis ist für die erste Seite also tatsächlich korrekt. + unverändert. Das Ergebnis ist für die erste Seite also tatsächlich korrekt. - Fügen Sie jetzt im Beispiel nach \DescRef{maincls.cmd.maketitle} so viel - Text ein, dass eine zweite Seite ausgegeben wird. Sie können dazu auch + Fügen Sie jetzt im Beispiel nach \DescRef{maincls.cmd.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 - \DescRef{maincls.cmd.maketitle} ergänzen. Wie Sie sehen werden, enthält der - Kopf der zweiten Seite nun, genau wie gewünscht, den Namen des Autors und + Dokumentpräambel und \Macro{lipsum}\IndexCmd{lipsum} nach + \DescRef{maincls.cmd.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 + 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} @@ -448,17 +448,17 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% \end{document} \end{lstcode} Jetzt haben Sie den Kopf auch auf der ersten Seite \iffree{direkt}{\unskip} - über dem Titelkopf\iffree{ selbst}{}. Das kommt daher, dass Sie mit den + über dem Titelkopf\iffree{ selbst}{}. Das kommt daher, dass Sie mit den beiden optionalen Argumenten \iffree{den Seitenstil}{\unskip} \DescRef{\LabelBase.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. + 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 - \DescRef{\LabelBase.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 \DescRef{maincls.cmd.titlepagestyle}% + \DescRef{\LabelBase.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 \DescRef{maincls.cmd.titlepagestyle}% \important{\DescRef{maincls.cmd.titlepagestyle}}% \IndexCmd{titlepagestyle} in \autoref{sec:maincls.pagestyle}, \DescPageRef{maincls.cmd.titlepagestyle}. @@ -468,19 +468,19 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% \leavevmode\textnote{Achtung!}% \else Erlauben Sie mir einen wichtigen Hinweis:\textnote{Achtung!} % \fi% -Sie sollten niemals die Überschrift oder die Nummer einer +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 +Kopf der Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe kann % \iffalse% Umbruchoptimierung es sonst leicht geschehen, dass die falsche Nummer oder die falsche -Überschrift im Kolumnentitel ausgegeben wird% +Ãœberschrift im Kolumnentitel ausgegeben wird% \else% -sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel +sonst die falsche Nummer oder die falsche Ãœberschrift im Kolumnentitel ausgegeben werden% \fi% . Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den -Automatismen aus dem nächsten Abschnitt, zu verwenden.% +Automatismen aus dem nächsten Abschnitt, zu verwenden.% \EndIndexGroup @@ -499,20 +499,20 @@ Automatismen aus dem nächsten Abschnitt, zu verwenden.% \Parameter{Inhalt scrheadings} \end{Declaration} Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor -erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei +erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei Weglassen des optionalen Arguments \OParameter{Inhalt - plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt -von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird + plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt +von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird bei der Sternvariante dann das obligatorische Argument \PName{Inhalt - scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} + scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.% % \begin{Example} Mit der Sternform von \DescRef{\LabelBase.cmd.lohead} und - \DescRef{\LabelBase.cmd.rohead} lässt sich das - Beispiel aus der vorherigen Erklärung etwas verkürzen: - % Umbruchoptimierung durch Abstandsänderung + \DescRef{\LabelBase.cmd.rohead} lässt sich das + Beispiel aus der vorherigen Erklärung etwas verkürzen: + % Umbruchoptimierung durch Abstandsänderung \begin{lstcode}[belowskip=-\dp\strutbox] \documentclass{scrartcl} \usepackage{scrlayer-scrpage} @@ -546,61 +546,61 @@ Sternvariante mit nur einem Argument verwenden.% \Parameter{Inhalt scrheadings} \end{Declaration} Was bei \DescRef{\LabelBase.pagestyle.scrheadings} und -\DescRef{\LabelBase.pagestyle.plain.scrheadings} in den Fuß der Seite +\DescRef{\LabelBase.pagestyle.plain.scrheadings} in den Fuß der Seite geschrieben wird, ist mit Hilfe dieser Befehle einstellbar. Dabei setzt das optionale Argument jeweils den Inhalt eines Elements in -\DescRef{\LabelBase.pagestyle.plain.scrheadings}, während das obligatorische +\DescRef{\LabelBase.pagestyle.plain.scrheadings}, während das obligatorische Argument jeweils einen Inhalt in \DescRef{\LabelBase.pagestyle.scrheadings} setzt. -Die Inhalte für gerade, also linke Seiten\textnote{linke Seite} werden mit den +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«). +»\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 +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«). +»\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. +unabhängig von ihrer Nummer als ungerade Seiten gezeichnet werden. -Jeder Fuß eines Seitenstils besitzt ein linksbündiges\textnote{linksbündig} +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«). +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} +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«). +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«). +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«). \BeginIndexGroup \BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}% \BeginIndex{FontElement}{pageheadfoot}\LabelFontElement[.foot]{pageheadfoot}% -Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit +Diese Elemente besitzen jedoch nicht jedes für sich eine Schriftzuordnung mit Hilfe der Befehle \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:scrlayer-scrpage.textmarkup}, -\DescPageRef{\LabelBase.cmd.setkomafont}), sondern alle zusammen über das +\DescPageRef{\LabelBase.cmd.setkomafont}), sondern alle zusammen über das Element \FontElement{pagefoot}\important{\FontElement{pagefoot}}. Vor diesem -wird außerdem noch das Element +wird außerdem noch das Element \FontElement{pageheadfoot}\important{\FontElement{pageheadfoot}} -angewandt. Die Voreinstellungen für diese beiden Elemente sind +angewandt. Die Voreinstellungen für diese beiden Elemente sind \autoref{tab:scrlayer-scrpage.fontelements}, \autopageref{tab:scrlayer-scrpage.fontelements} zu entnehmen.% \EndIndexGroup In \autoref{fig:scrlayer-scrpage.foot} ist die Bedeutung der einzelnen Befehle -für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. +für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. % \begin{figure}[bp] \centering @@ -673,7 +673,7 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \multiput(-2em,\baselineskip)(-.25em,0){5}{\line(1,0){.125em}}% \put(-2em,0){\makebox(4em,5mm)[c]{\Macro{cofoot}}}% }% - % Befehle für beide Seiten + % Befehle für beide Seiten \color{ImageBlue}% \put(.5\textwidth,15mm){\makebox(0,\baselineskip)[c]{\Macro{ifoot}}}% \color{ImageGreen}% @@ -703,16 +703,16 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \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.} + \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ß \iffree{zusätzlich}{\unskip} den Verlag angegeben - haben. Daher ergänzen Sie das Beispiel zu: + Kommen wir zu dem Beispiel des kurzen Artikels zurück. Angenommen Sie wollen + nun links im Fuß \iffree{zusätzlich}{\unskip} den Verlag angegeben + haben. Daher ergänzen Sie das Beispiel zu: \begin{lstcode} \documentclass{scrartcl} \usepackage{scrlayer-scrpage} @@ -729,8 +729,8 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \end{document} \end{lstcode} Der Verlag wird Ihnen aber nicht auf der Seite mit dem - Titelkopf ausgegeben. Die Begründung ist dieselbe wie beim Beispiel zu - \DescRef{\LabelBase.cmd.lohead}. Ebenso ist die Lösung, um den Verlag auch + Titelkopf ausgegeben. Die Begründung ist dieselbe wie beim Beispiel zu + \DescRef{\LabelBase.cmd.lohead}. Ebenso ist die Lösung, um den Verlag auch auf diese Seite zu bekommen, entsprechend: \begin{lstcode} \lofoot[Verlag Naseblau, Irgendwo] @@ -738,32 +738,32 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \end{lstcode} \iffalse% Umbruchvarianten Nun entscheiden Sie noch, dass - statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}% - \IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine + 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% \else% Jetzt soll - statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}% - \IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine + statt\textnote{Fontänderung}\important{\FontElement{pageheadfoot}}% + \IndexFontElement{pageheadfoot} der schrägen Schrift in Kopf und Fuß eine aufrechte, aber kleinere Schrift verwendet werden% \fi% % Umbruchoptimierung: \iffalse% \iffree{}{. Dies erreichen - Sie, indem Sie in der Dokumentpräambel die folgende Codezeile ergänzen}% + Sie, indem Sie in der Dokumentpräambel die folgende Codezeile ergänzen}% \fi% \iftrue% - \iffree{}{. Dies erreichen Sie mit folgender Ergänzung:}% + \iffree{}{. Dies erreichen Sie mit folgender Ergänzung:}% \fi : \begin{lstcode} \setkomafont{pageheadfoot}{\small} \end{lstcode} - Darüber hinaus, soll + Darüber hinaus, soll \iftrue% Umbruchvarianten der Kopf\important{\FontElement{pagehead}}\IndexFontElement{pagehead}, nicht - jedoch der Fuß + jedoch der Fuß \else% nur der Kopf\important{\FontElement{pagehead}}\IndexFontElement{pagehead} \fi% @@ -775,36 +775,36 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. dem Laden von \Package{scrpage-scrlayer} erfolgt, weil davor \FontElement{pagehead} und \FontElement{pageheadfoot} \iffalse% Umbruchvarianten - zwar vorhanden sind, aber dasselbe Element, nämlich + zwar vorhanden sind, aber dasselbe Element, nämlich \FontElement{pageheadfoot}, % \else% dasselbe Element % \fi bezeichnen. Erst durch \iffree{Laden von }{}\Package{scrpage-scrlayer} - werden daraus \iffree{zwei }{}unabhängige Elemente. + werden daraus \iffree{zwei }{}unabhängige Elemente. - Ergänzen Sie nun das Beispiel einmal durch ein weiteres \Macro{lipsum} und - fügen Sie gleichzeitig Option + 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 + 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 \DescRef{\LabelBase.pagestyle.scrheadings} und - \DescRef{\LabelBase.pagestyle.plain.scrheadings} für doppelseitige Dokumente + \DescRef{\LabelBase.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 + 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} + 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}« mit »\texttt{r}« und umgekehrt: + »\texttt{l}« mit »\texttt{r}« und umgekehrt: \begin{lstcode} \documentclass[twoside]{scrartcl} \usepackage{scrlayer-scrpage} @@ -829,27 +829,27 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \end{lstcode} \end{Example}% -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. +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. \iftrue% Umbruchoptimierung \leavevmode\textnote{Achtung!}% \else Erlauben Sie mir erneut einen wichtigen Hinweis:\textnote{Achtung!} % \fi% -Sie sollten niemals die Überschrift oder die Nummer einer +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 +Fuß der Seite setzen. Aufgrund der Asynchronizität von Seitenaufbau und Seitenausgabe kann % \iffalse% Umbruchoptimierung es sonst leicht geschehen, dass die falsche Nummer oder die falsche -Überschrift im Kolumnentitel ausgegeben wird% +Ãœberschrift im Kolumnentitel ausgegeben wird% \else% -sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel +sonst die falsche Nummer oder die falsche Ãœberschrift im Kolumnentitel ausgegeben werden% \fi% . Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den -Automatismen aus dem nächsten Abschnitt, zu verwenden.% +Automatismen aus dem nächsten Abschnitt, zu verwenden.% \EndIndexGroup @@ -868,20 +868,20 @@ Automatismen aus dem nächsten Abschnitt, zu verwenden.% \Parameter{Inhalt scrheadings} \end{Declaration} Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor -erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei +erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei Weglassen des optionalen Arguments \OParameter{Inhalt - plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt -von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird + plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt +von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird bei der Sternvariante dann das obligatorische Argument \PName{Inhalt - scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} + scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.% % \begin{Example} Mit der Sternform von \DescRef{\LabelBase.cmd.lofoot} und - \DescRef{\LabelBase.cmd.rofoot} lässt sich das - Beispiel aus der vorherigen Erklärung etwas verkürzen: -% Umbruchoptimierung durch Abstandsänderung + \DescRef{\LabelBase.cmd.rofoot} lässt sich das + Beispiel aus der vorherigen Erklärung etwas verkürzen: +% Umbruchoptimierung durch Abstandsänderung \begin{lstcode}[belowskip=-\dp\strutbox] \documentclass[twoside]{scrartcl} \usepackage{scrlayer-scrpage} @@ -921,8 +921,8 @@ Sternvariante mit nur einem Argument verwenden.% \Macro{ifoot}\OParameter{Inhalt plain.scrheadings} \Parameter{Inhalt scrheadings} \end{Declaration} -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 +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% @@ -935,14 +935,14 @@ angeordnet.% \ und umgekehrt. Mittig bleibt mittig.% \fi% -Zur Vereinfachung der Einstellungen für diesen Standardfall gibt es bei -\Package{scrlayer-scrpage} sozusagen Abkürzungen. Der Befehl \Macro{ohead} +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 \DescRef{\LabelBase.cmd.lehead} als auch \DescRef{\LabelBase.cmd.rohead}. Der Befehl \Macro{chead} entspricht sowohl \DescRef{\LabelBase.cmd.cehead} als auch \DescRef{\LabelBase.cmd.cohead}. Und Befehl \Macro{ihead} entspricht \DescRef{\LabelBase.cmd.rehead} und -\DescRef{\LabelBase.cmd.lohead}. Gleiches gilt für die Anweisungen des -Fußes. In \autoref{fig:scrlayer-scrpage.head} auf +\DescRef{\LabelBase.cmd.lohead}. Gleiches 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 @@ -950,9 +950,9 @@ skizziert. % \begin{Example} \iftrue% Umbruchvarianten - Das letzte Beispiel lässt sich so vereinfachen: + Das letzte Beispiel lässt sich so vereinfachen: \else - Mit Hilfe der neuen Befehle, lässt sich das letzte Beispiel wie folgt + Mit Hilfe der neuen Befehle, lässt sich das letzte Beispiel wie folgt vereinfachen: \fi \begin{lstcode} @@ -974,41 +974,41 @@ skizziert. \end{document} \end{lstcode} \iffalse% Umbruchkorrekturtext - Wie zusehen ist, konnte die Hälfte der Befehle eingespart und trotzdem + Wie zusehen ist, konnte die Hälfte der Befehle eingespart und trotzdem dasselbe Ergebnis erzielt werden. \fi \end{Example}% \iffalse% Umbruchoptimierung Da im einseitigen Layout alle Seiten als ungerade oder rechte Seiten behandelt -werden, können \iffree{im einseitigen Layout}{dann} diese Befehle auch als -Synonyme für die entsprechenden Befehle für rechte Seiten verwendet werden.% +werden, können \iffree{im einseitigen Layout}{dann} diese Befehle auch als +Synonyme für die entsprechenden Befehle für rechte Seiten verwendet werden.% \else% -Im einseitigen Layout können diese Befehle auch als Synonym für die -entsprechenden Befehle für rechte Seiten verwendet werden, da dann alle Seiten +Im einseitigen Layout können diese Befehle auch als Synonym für die +entsprechenden Befehle für rechte Seiten verwendet werden, da dann alle Seiten rechte Seiten sind.% \fi% \iffalse% Umbruchoptimierung -In den meisten Fällen wird man daher eher diese sechs als die zwölf zuvor +In den meisten Fällen wird man daher eher diese sechs als die zwölf zuvor vorgestellten Befehle verwenden. \fi % Umbruchoptimierung \iffree{Erlauben Sie mir noch einmal einen wichtigen Hinweis:\textnote{Achtung!} }{\leavevmode\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 +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 % \iffalse% Umbruchoptimierung es sonst leicht geschehen, dass die falsche Nummer oder die falsche -Überschrift im Kolumnentitel ausgegeben wird% +Ãœberschrift im Kolumnentitel ausgegeben wird% \else% -sonst die falsche Nummer oder die falsche Überschrift im Kolumnentitel +sonst die falsche Nummer oder die falsche Ãœberschrift im Kolumnentitel ausgegeben werden% \fi% . Stattdessen ist der Mark-Mechanismus, idealer Weise in Verbindung mit den -Automatismen aus dem nächsten Abschnitt, zu verwenden.% +Automatismen aus dem nächsten Abschnitt, zu verwenden.% \EndIndexGroup @@ -1027,18 +1027,18 @@ Automatismen aus dem nächsten Abschnitt, zu verwenden.% \Parameter{Inhalt scrheadings} \end{Declaration} Die Sternvarianten\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} der zuvor -erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei +erklärten Befehle unterscheiden sich von der Form ohne Stern lediglich bei Weglassen des optionalen Arguments \OParameter{Inhalt - plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt -von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird + plain.scrheadings}. Während die Form ohne Stern in diesem Fall den Inhalt +von \DescRef{\LabelBase.pagestyle.plain.scrheadings} unangetastet lässt, wird bei der Sternvariante dann das obligatorische Argument \PName{Inhalt - scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} + scrheadings} auch für \DescRef{\LabelBase.pagestyle.plain.scrheadings} verwendet. Sollen also beide Argumente gleich sein, so kann man einfach die Sternvariante mit nur einem Argument verwenden.% % \begin{Example} - Mit der Sternform von \DescRef{\LabelBase.cmd.ifoot} lässt sich das - Beispiel aus der vorherigen Erklärung weiter verkürzen: + Mit der Sternform von \DescRef{\LabelBase.cmd.ifoot} lässt sich das + Beispiel aus der vorherigen Erklärung weiter verkürzen: \begin{lstcode} \documentclass[twoside]{scrartcl} \usepackage{scrlayer-scrpage} @@ -1065,26 +1065,26 @@ Sternvariante mit nur einem Argument verwenden.% \end{Declaration} \BeginIndex{Option}{pagestyleset~=KOMA-Script}% \BeginIndex{Option}{pagestyleset~=standard}% -In den zurückliegenden Beispielen wurde bereits mehrfach auf die +In den zurückliegenden Beispielen wurde bereits mehrfach auf die Voreinstellung der Seitenstile \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings} und \DescRef{\LabelBase.pagestyle.plain.scrheadings}% -\IndexPagestyle{plain.scrheadings} hingewiesen. Tatsächlich unterstützt +\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. +Voreinstellungen. Diese sind von Hand über Option \Option{pagestyleset} +auswählbar. Mit der \PName{Einstellung} \PValue{KOMA-Script}\important{\OptionValue{pagestyleset}{KOMA-Script}} wird -die Voreinstellung gewählt, die auch automatisch eingestellt wird, falls die +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 \DescRef{\LabelBase.pagestyle.scrheadings} im doppelseitigen Satz -Kolumnentitel außen im Kopf und Seitenzahlen außen im Fuß gesetzt. Im +werden für \DescRef{\LabelBase.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 wie vorgefunden verwendet. Dies entspricht Option +Seitenzahl mittig im Fuß platziert. Für die automatischen Kolumnentitel werden +Groß- und Kleinbuchstaben wie vorgefunden verwendet. Dies entspricht Option \OptionValueRef{\LabelBase}{markcase}{used}\IndexOption{markcase~=used}% -\important{\OptionValueRef{\LabelBase}{markcase}{used}}. Für +\important{\OptionValueRef{\LabelBase}{markcase}{used}}. Für \DescRef{\LabelBase.pagestyle.plain.scrheadings} entfallen die Kolumnentitel. Die Seitenzahlen werden jedoch identisch platziert. @@ -1096,34 +1096,34 @@ die Seitenstile jener Klasse angelehnt. Siehe dazu Mit der \PName{Einstellung} \PValue{standard}\important{\OptionValue{pagestyleset}{standard}} wird die -Voreinstellung gewählt, die den Standard-Klassen entspricht. Diese wird auch +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 +\KOMAScript-Klasse erkannt wurde. Dabei wird für \DescRef{\LabelBase.pagestyle.scrheadings} im doppelseitigen Satz der -Kolumnentitel im Kopf innen und die Seitenzahl -- ebenfalls im Kopf -- außen +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 +dann immer linksbündig im Kopf, die Seitenzahl entsprechend rechtsbündig. Die automatischen Kolumnentitel werden -- trotz erheblicher typografischer Bedenken -- entsprechend \OptionValueRef{\LabelBase}{markcase}{upper}\IndexOption{markcase~=upper}% -\important{\OptionValueRef{\LabelBase}{markcase}{upper}} in Großbuchstaben +\important{\OptionValueRef{\LabelBase}{markcase}{upper}} in Großbuchstaben umgewandelt. Von \DescRef{\LabelBase.pagestyle.scrheadings} deutlich abweichend hat \DescRef{\LabelBase.pagestyle.plain.scrheadings} die Seitenzahl -im einseitigen Satz mittig im Fuß. Im Unterschied\textnote{\KOMAScript{} +im einseitigen Satz mittig im Fuß. Im Unterschied\textnote{\KOMAScript{} vs. Standardklassen} zum 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. +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. \iffalse % Umbruchkorrekturtext -Wer die Seitenzahl zurück haben will, kann dies +Wer die Seitenzahl zurück haben will, kann dies mit \begin{lstcode} \cfoot[\pagemark]{} \end{lstcode} erreichen. % \fi% -Der Kolumnentitel entfällt bei +Der Kolumnentitel entfällt bei \DescRef{\LabelBase.pagestyle.plain.scrheadings}. Es ist zu beachten\textnote{Achtung!}, dass mit der Verwendung dieser Option @@ -1145,88 +1145,88 @@ Dies gilt auch, wenn die Option innerhalb eines Dokuments verwendet wird.% \OptionVName{footwidth}{Breite\textup{:}Offset\textup{:}Offset} \end{Declaration} In der Voreinstellung sind Kopf\Index{Kopf>Breite} und -Fuß\Index{Fuss=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 +Fuß\Index{Fuss=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 alle -drei\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} Werte optional, können also +drei\ChangedAt{v3.14}{\Package{scrlayer-scrpage}} Werte optional, können also auch weggelassen werden. Falls ein Wert weggelassen wird, kann auch ein -zugehöriger Doppelpunkt links davon entfallen. Ist nur ein \PName{Offset} -angegeben, so wird dieser sowohl für linke als auch für rechte Seiten -verwendet. Ansonsten wird im doppelseitigen Satz der erste \PName{Offset} für -ungerade, also rechte Seiten und der zweite für gerade, also linke Seiten +zugehöriger Doppelpunkt links davon entfallen. Ist nur ein \PName{Offset} +angegeben, so wird dieser sowohl für linke als auch für rechte Seiten +verwendet. Ansonsten wird im doppelseitigen Satz der erste \PName{Offset} für +ungerade, also rechte Seiten und der zweite für gerade, also linke Seiten verwendet. Ist insgesamt nur ein Wert und 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 +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 +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 +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 +ü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 +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 + \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} \entry{\PValue{foot}}{% - die aktuelle Breite des Fußes% + die aktuelle Breite des Fußes% }% \entry{\PValue{footbotline}}{% - die aktuelle Länge der horizontalen Linie unterhalb des Fußes% + die aktuelle Länge der horizontalen Linie unterhalb des Fußes% }% \entry{\PValue{footsepline}}{% - die aktuelle Länge der horizontalen Linie zwischen dem Textbereich und - dem Fuß% + die aktuelle Länge der horizontalen Linie zwischen dem Textbereich und + dem Fuß% } \entry{\PValue{head}}{% die aktuelle Breite des Kopfes% }% \entry{\PValue{headsepline}}{% - die aktuelle Länge der horizontalen Linie zwischen dem Kopf und dem + die aktuelle Länge der horizontalen Linie zwischen dem Kopf und dem Textbereich% }% \entry{\PValue{headtopline}}{% - die aktuelle Länge der horizontalen Linie über dem Kopf% + die aktuelle Länge der horizontalen Linie über dem Kopf% }% \entry{\PValue{marginpar}}{% - die Breite der Marginalienspalte einschließlich des Abstandes zwischen + die Breite der Marginalienspalte einschließlich des Abstandes zwischen dem Textbereich und der Marginalienspalte% }% \entry{\PValue{page}}{% - die Breite der Seite unter Berücksichtigung einer eventuell mit Hilfe + die Breite der Seite unter Berücksichtigung einer eventuell mit Hilfe des Pakets \Package{typearea} definierten Bindekorrektur (siehe Option \DescRef{typearea.option.BCOR} in \autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.BCOR})% }% \entry{\PValue{paper}}{% - die Breite des Papiers ohne Berücksichtigung einer etwaigen + die Breite des Papiers ohne Berücksichtigung einer etwaigen Bindekorrektur% }% \entry{\PValue{text}}{% die Breite des Textbereichs% }% \entry{\PValue{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)% + 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} @@ -1235,59 +1235,59 @@ immer Null. Falls Ihnen das zu kompliziert ist, sollten Sie den gewünschten \begin{Declaration} - \OptionVName{headtopline}{Dicke\textup{:}Länge} - \OptionVName{headsepline}{Dicke\textup{:}Länge} - \OptionVName{footsepline}{Dicke\textup{:}Länge} - \OptionVName{footbotline}{Dicke\textup{:}Länge} + \OptionVName{headtopline}{Dicke\textup{:}Länge} + \OptionVName{headsepline}{Dicke\textup{:}Länge} + \OptionVName{footsepline}{Dicke\textup{:}Länge} + \OptionVName{footbotline}{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 +\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. +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 +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 +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 +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 \DescRef{\LabelBase.option.ilines}\IndexOption{ilines}% \important{\DescRef{\LabelBase.option.ilines}, \DescRef{\LabelBase.option.clines}, \DescRef{\LabelBase.option.olines}}, \DescRef{\LabelBase.option.clines}\IndexOption{clines} und -\DescRef{\LabelBase.option.olines}\IndexOption{olines}, die später in diesem -Abschnitt erklärt werden. +\DescRef{\LabelBase.option.olines}\IndexOption{olines}, die später in diesem +Abschnitt erklärt werden. \BeginIndexGroup \BeginIndex{FontElement}{headtopline}\LabelFontElement{headtopline}% \BeginIndex{FontElement}{headsepline}\LabelFontElement{headsepline}% \BeginIndex{FontElement}{footsepline}\LabelFontElement{footsepline}% \BeginIndex{FontElement}{footbotline}\LabelFontElement{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 +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 \important[i]{\FontElement{headtopline}\\ \FontElement{headsepline}\\ \FontElement{footsepline}\\ \FontElement{footbotline}}Elemente \FontElement{headtopline}, \FontElement{headsepline}, \FontElement{footsepline} und -\FontElement{footbotline} angewendet. Diese können mit den Anweisungen +\FontElement{footbotline} angewendet. Diese können mit den Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und -\DescRef{\LabelBase.cmd.addtokomafont} geändert werden (siehe +\DescRef{\LabelBase.cmd.addtokomafont} geändert werden (siehe \autoref{sec:scrlayer-scrpage.textmarkup}, ab \DescPageRef{\LabelBase.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 +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.% \EndIndexGroup % @@ -1300,12 +1300,12 @@ empfohlen.% \OptionVName{plainfootsepline}{Ein-Aus-Wert} \OptionVName{plainfootbotline}{Ein-Aus-Wert} \end{Declaration} -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 +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 +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. % \EndIndexGroup @@ -1316,16 +1316,16 @@ entsprechende Linie im \PageStyle{plain}-Seitenstil hingegen nicht angezeigt. \Option{clines} \Option{olines} \end{Declaration} -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 +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.% +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.% \EndIndexGroup % \EndIndexGroup @@ -1333,12 +1333,12 @@ möglich.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: -% LocalWords: Paketoptionen Ebenenmodell Sternvariante Sternform Längenwert +% LocalWords: Paketoptionen Ebenenmodell Sternvariante Sternform Längenwert % LocalWords: Titelkopf Automatismen Bindekorrektur diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex index 9b755255d6..18a1c91b59 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlayer.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlayer.tex -% Copyright (c) Markus Kohm, 2013-2018 +% Copyright (c) Markus Kohm, 2013-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrlayer in der KOMA-Script-Anleitung +% Kapitel über scrlayer in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrlayer.tex}% - [$Date: 2018-12-15 15:01:34 +0100 (Sat, 15 Dec 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter:scrlayer)] \chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}] @@ -57,58 +57,58 @@ \BeginIndexGroup \BeginIndex{Package}{scrlayer}% \BeginIndex{}{Ebenen}% -Anwender von Grafikprogrammen sind mit dem Modell der Ebenen für eine Seite +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 +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 +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. +unterschiedlicher Ebenen durch die Umschaltung des Seitenstils möglich. -Um dies zu erreichen, stellt das Paket auf unterer Stufe zusätzlich eine +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 +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 +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 +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}. -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} \section{Einige grundlegende Informationen} \seclabel{generic.information} -Das Paket benötigt einige grundlegende Informationen über die -verwendete Klasse. Autoren von Klassen können \Package{scrlayer} helfen, indem +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 +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. +bereitstellen können. Anwender sollten sich im Normalfall nicht darum zu +kümmern brauchen. \begin{Declaration} \Macro{if@chapter}\ \PName{Dann-Code}\ % \textMacro{else}\ \PName{Sonst-Code}\ \textMacro{fi} \end{Declaration} Wenn \Macro{if@chapter} definiert ist und \Macro{iftrue}\IndexCmd{iftrue} -entspricht, berücksichtigt \Package{scrlayer} bei seiner Arbeit die +entspricht, berücksichtigt \Package{scrlayer} bei seiner Arbeit die Kapitel-Ebene beispielsweise bei Verwendung von Option \DescRef{\LabelBase.option.automark}. Wenn es definiert ist, aber nicht \Macro{iftrue} entspricht, behandelt \Package{scrlayer} nur die Ebenen der @@ -119,8 +119,8 @@ Befehle \DescRef{maincls.cmd.part}, \DescRef{maincls.cmd.section}, \Package{scrlayer} die Frage, ob auch die Kapitel-Ebene zu behandeln ist, an der Anweisung \DescRef{maincls.cmd.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 +\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}.% % \EndIndexGroup @@ -134,29 +134,29 @@ Klassen wie \Class{book} oder \Class{scrbook} bieten \DescRef{maincls.cmd.frontmatter}\IndexCmd{frontmatter}, \DescRef{maincls.cmd.mainmatter}\IndexCmd{mainmatter} und \DescRef{maincls.cmd.backmatter}\IndexCmd{backmatter}, um zwischen Vorderteil, -Hauptteil und Endteil eines Buches umschalten zu können. In der Regel +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 +können, ob gerade im Hauptteil des Dokuments gearbeitet wird oder nicht. Klassen wie \Class{report} oder \Class{article} haben kein \DescRef{maincls.cmd.frontmatter}, \DescRef{maincls.cmd.mainmatter} oder \DescRef{maincls.cmd.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 +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}. +es als Synonym für \Macro{iftrue}. Einige Klassen definieren jedoch \DescRef{maincls.cmd.frontmatter}, \DescRef{maincls.cmd.mainmatter} oder \DescRef{maincls.cmd.backmatter} und trotzdem kein \Macro{if@mainmatter}. In diesem Fall definiert -\Package{scrlayer} \Macro{if@mainmatter} ebenfalls als Synonym für -\Macro{iftrue} und erweitert darüber hinaus die gefundenen Definitionen von +\Package{scrlayer} \Macro{if@mainmatter} ebenfalls als Synonym für +\Macro{iftrue} und erweitert darüber hinaus die gefundenen Definitionen von \DescRef{maincls.cmd.frontmatter}, \DescRef{maincls.cmd.mainmatter} und \DescRef{maincls.cmd.backmatter} so, dass diese \Macro{if@mainmatter} passend umdefinieren. Falls es jedoch weitere, vergleichbare Befehle zur Umschaltung @@ -176,22 +176,22 @@ zugeordnet. Das ist notwendig, damit \LaTeX{} die Hierarchie der Gliederungsebenen verwalten kann. Allerdings sind die Werte 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. +zugehörigen Nummern ein. {\setlength{\emergencystretch}{1em}% -Das Paket \Package{scrlayer} benötigt ebenfalls Informationen über die +Das Paket \Package{scrlayer} benötigt ebenfalls Informationen über die Hierarchie. Mit Hilfe von \Macro{DeclareSectionNumberDepth} kann -\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige nummerische -Tiefe bekannt gemacht werden. Für die Standardklassen wäre \PName{Name der +\Package{scrlayer} zum Namen einer Gliederungsebene die zugehörige nummerische +Tiefe bekannt gemacht werden. Für die Standardklassen wäre \PName{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.\par} +\PValue{paragraph} oder \PValue{subparagraph} und die jeweils zugehörige +\PName{Tiefe der Gliederungsebene} wäre -1, 0, 1, 2, 3, 4 oder 5.\par} -Das Paket \Package{scrlayer} versucht, diese nummerischen Werte zunächst beim -Laden des Pakets und 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 +Das Paket \Package{scrlayer} versucht, diese nummerischen Werte zunächst beim +Laden des Pakets und 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.% % @@ -201,46 +201,46 @@ Gliederungsbefehle gibt, kann man die Zuordnung eben mit \section{Deklaration von Ebenen} \seclabel{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 +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 +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 +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 als Antworten auf grundlegende -Fragen verstanden werden können: +Fragen verstanden werden können: \iffree{\begin{description}}{% \begingroup \RedeclareSectionCommand[beforeskip=.5\baselineskip plus .25\baselineskip minus .1\baselineskip]{paragraph}% \renewcommand*\item[4][]{\paragraph*{#3{#4}#1}}% }% -\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?]% +\item[Gehört die Ebene zum Vordergrund oder zum Hintergrund?]% \leavevmode\textnote{Vorder- oder Hintergrund}\hskip 0pt 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 + 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. Normalerweise ist es - daher sinnvoll, dies explizit einzuschränken. + daher sinnvoll, dies explizit einzuschränken. \item[An welcher Position soll die Ebene ausgegeben werden?]% \leavevmode\textnote{horizontale und vertikale Position}\hskip 0pt Zur Beantwortung dieser Frage dienen Eigenschaften zur Festlegung der horizontalen und der vertikalen Position. -\item[Wie groß ist die Ebene?]% - \leavevmode\textnote{horizontale und vertikale Größe}\hskip 0pt - Ebenso wie für die Position gibt es auch für die horizontale und vertikale +\item[Wie groß ist die Ebene?]% + \leavevmode\textnote{horizontale und vertikale Größe}\hskip 0pt + Ebenso wie für die Position gibt es auch für die horizontale und vertikale Ausdehnung der Ebene Eigenschaften. Damit kann eine Ebene auch kleiner oder - größer als das Papier sein und an unterschiedlichen Positionen auf dem + größer als das Papier sein und an unterschiedlichen Positionen auf dem Papier liegen. \item[Wie werden die horizontale und die vertikale Position gemessen?]% @@ -250,60 +250,60 @@ Fragen verstanden werden können: 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. -\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?]% +\item[Ist die Ebene für Textausgabe oder für Grafik vorgesehen?]% \leavevmode\textnote{Text oder Grafik}\hskip 0pt - Auch diese Frage ist eng mit der Position verknüpft. Während der Anwender + Auch diese Frage ist eng mit der Position verknüpft. Während der Anwender bei der Grafikausgabe beispielsweise davon ausgeht, dass der Ursprung in der - linken unteren Ecke der Ebene liegt, wäre dies bei der Textausgabe eher - ungünstig. Daher liegt der Ursprung für Textebenen um die Höhe einer + linken unteren Ecke der Ebene liegt, wäre dies bei der Textausgabe eher + ungünstig. Daher liegt der Ursprung für Textebenen um die Höhe einer Standardtextzeile unterhalb der oberen, linken Ecke der Ebene. Grafikebenen wiederum spannen von sich aus bereits eine - \Environment{picture}-Umgebung\IndexEnv{picture} auf, in der zusätzliche - Befehle zur Positionierung zur Verfügung stehen. + \Environment{picture}-Umgebung\IndexEnv{picture} auf, in der zusätzliche + Befehle zur Positionierung zur Verfügung stehen. \item[Soll die Ebene auf linken oder rechten Seiten eines Dokuments gedruckt werden?]% \leavevmode\textnote{linke oder rechte Seite}\hskip 0pt 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 + 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. \item[Soll die Ebene in einseitigen oder in doppelseitigen Dokumenten verwendet werden?]% \leavevmode\textnote{einseitig oder doppelseitig}\hskip 0pt - In der Voreinstellung ist die Ebene diesbezüglich unbeschränkt, wird also + 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 + beschränkt ist, im einseitigen Modus niemals ausgegeben werden und ist daher auch keine einseitige Ebene. \item[Soll die Ebene auf Gleitseiten oder auf Normalseiten ausgegeben werden?]% \leavevmode\textnote{Gleitseiten oder Normalseiten}\hskip 0pt - \LaTeX{} erzeugt Gleitseiten für Objekte aus Umgebungen wie + \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 + 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 + 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. \item[Welchen Inhalt hat die Ebene?] \leavevmode\textnote{Inhalt}\hskip 0pt - Die zugehörige Eigenschaft gibt schlicht an, was gedruckt werden soll, wann + Die zugehörige Eigenschaft gibt schlicht an, was gedruckt werden soll, wann immer die Ebene ausgegeben wird. \iffree{\end{description}}{% \endgroup\par\bigskip\noindent\ignorespaces }% Damit haben wir derzeit acht Fragen an die Ebenen, aus denen sich unmittelbar -eine Reihe von Eigenschaften ergeben. Später +eine Reihe von Eigenschaften ergeben. Später \iffree{in dieser Anleitung }{}% Umbruchkorrektur -werden wir weitere Eigenschaften kennenlernen, die jedoch auf diese primären -Eigenschaften abgebildet werden können. +werden wir weitere Eigenschaften kennenlernen, die jedoch auf diese primären +Eigenschaften abgebildet werden können. \begin{Declaration} \Macro{DeclareLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene} @@ -312,102 +312,102 @@ Eigenschaften abgebildet werden können. \Macro{RedeclareLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene} \Macro{ModifyLayer}\OParameter{Optionenliste}\Parameter{Name der Ebene} \end{Declaration} -Diese Anweisungen können verwendet werden, um Ebenen zu definieren. Der +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 +ASCII-Buchstaben resultieren. Einige zusätzliche Zeichen werden ebenfalls akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern empfohlen. Bei Verwendung von \Macro{DeclareLayer}\important{\Macro{DeclareLayer}} spielt es keine Rolle, ob eine Ebene \PName{Name der Ebene} bereits existiert oder -nicht. Sie wird in jedem Fall mit den über die \PName{Optionenliste} +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 +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}. +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}\important{\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 +verwenden. Dies ist insbesondere auch dann nützlich, wenn Klassen oder Pakete intern ebenfalls Ebenen definieren. Dagegen definiert \Macro{ProvideLayer}\important{\Macro{ProvideLayer}} die Ebene nur, wenn nicht bereits eine Ebene mit dem angegebenen Namen -existiert. Wird der Name hingegen bereits für eine andere Ebene verwendet, so +existiert. Wird 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}\important{\Macro{RedeclareLayer}} die Ebene zunächst -auf die Grundeinstellungen zurückgesetzt und damit über die angegebene +\Macro{RedeclareLayer} oder \Macro{ModifyLayer} verwendet werden. Während mit +\Macro{RedeclareLayer}\important{\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}\important{\Macro{ModifyLayer}} das Zurücksetzen. Es werden -dann nur die Eigenschaften geändert, für die in der \PName{Optionenliste} auch +\Macro{ModifyLayer}\important{\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 + 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})% + Optionen für die Definition von Ebenen (\emph{Fortsetzung})% }% \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \OptionVName{addcontents}{Code}}{% Der angegebene Wert wird an den aktuellen Wert des Attributs - \Option{contents} angehängt. Es wird also ein zusätzlicher Inhalt - generiert. Zu näheren Informationen über die Behandlung von \PName{Code} + \Option{contents} angehängt. Es wird also ein zusätzlicher Inhalt + generiert. Zu näheren Informationen über die Behandlung von \PName{Code} siehe Option \Option{contents}.% }% \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% - \OptionVName{addheight}{zusätzliche Höhe}}{% + \OptionVName{addheight}{zusätzliche Höhe}}{% Der aktuelle Wert von Attribut \Option{height} wird um den Wert dieser - Option erhöht. Als Wert sind die gleichen Angaben wie bei - \Option{height} möglich.% + Option erhöht. Als Wert sind die gleichen Angaben wie bei + \Option{height} möglich.% }% \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% - \OptionVName{addhoffset}{zusätzlicher horizontaler Abstand}}{% + \OptionVName{addhoffset}{zusätzlicher horizontaler Abstand}}{% Der aktuelle Wert von Attribut \Option{hoffset} wird um den Wert dieser - Option erhöht. Als Wert sind die gleichen Angaben wie bei - \Option{hoffset} möglich.% + Option erhöht. Als Wert sind die gleichen Angaben wie bei + \Option{hoffset} möglich.% }% \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% - \OptionVName{addvoffset}{zusätzlicher vertikaler Abstand}}{% + \OptionVName{addvoffset}{zusätzlicher vertikaler Abstand}}{% Der aktuelle Wert von Attribut \Option{voffset} wird um den Wert dieser - Option erhöht. Als Wert sind die gleichen Angaben wie bei - \Option{voffset} möglich.% + Option erhöht. Als Wert sind die gleichen Angaben wie bei + \Option{voffset} möglich.% }% \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% - \OptionVName{addwidth}{zusätzliche Breite}}{% + \OptionVName{addwidth}{zusätzliche Breite}}{% Der aktuelle Wert von Attribut \Option{width} wird um den Wert dieser - Option erhöht. Als Wert sind die gleichen Angaben wie bei - \Option{width} möglich.% + Option erhöht. Als Wert sind die gleichen Angaben wie bei + \Option{width} möglich.% }% \nentry{\OptionVName{align}{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 + Ãœ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 + \PName{Ausrichtungszeichen} können ohne Leerzeichen oder Komma direkt hintereinander geschrieben werden und werden in der Reihenfolge ihres Auf"|tretens ausgewertet. Makros sind im Wert der Option jedoch - nicht zulässig. Zulässige \PName{Ausrichtungszeichen} sind: + 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 + \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. @@ -418,18 +418,18 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \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 + Abstand}\Parameter{Breite}\Parameter{Höhe}}{% + Die zusammengesetzte Eigenschaft resultiert in den primären Eigenschaften \OptionVName{hoffset}{horizontaler Abstand}, \OptionVName{voffset}{vertikaler Abstand}, - \OptionVName{width}{Breite}, \KOption{height}{Höhe}.% + \OptionVName{width}{Breite}, \KOption{height}{Höhe}.% }% \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% \Option{backandforeground}}{% - Mit dieser Option wird die Einschränkung der Ebene auf den Vorder- oder - Hintergrund wieder aufgehoben und diesbezüglich die Grundeinstellung + Mit dieser Option wird die Einschränkung der Ebene auf den Vorder- oder + Hintergrund wieder aufgehoben und diesbezüglich die Grundeinstellung wieder hergestellt. In der Regel ist dies wenig sinnvoll, daher existiert - die Option nur aus Gründen der Vollständigkeit. Diese Option erwartet und + die Option nur aus Gründen der Vollständigkeit. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{background}}{% @@ -439,34 +439,34 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{bottommargin}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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 + dem Seitenfuß bis zur unteren Papierkante abdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\OptionVName{clone}{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}. Bezüglich \PName{Name + Die zusammengesetzte Eigenschaft setzt alle primären Eigenschaften + entsprechend der aktuellen, primären Eigenschaften der Ebene mit dem + angegebenen \PName{Name einer Ebene}. Bezüglich \PName{Name einer Ebene} siehe die Hinweise zu \PName{Name der Ebene} am Anfang der - Erklärung zu \Macro{DeclareLayer}. Darüber hinaus muss die zu klonende + Erklärung zu \Macro{DeclareLayer}. Darüber hinaus muss die zu klonende Ebene bereits definiert sein.% }% \entry{\OptionVName{contents}{Code}}{% - Der angegebene \PName{Code} wird immer dann expandiert und ausgeführt, + 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 + 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 + 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 + doppelseitigen Satz gibt, schließt diese Eigenschaft quasi \Option{twoside} mit ein. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% @@ -477,38 +477,38 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. }% \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% \Option{everyside}}{% - Mit dieser Option wird die Einschränkung der Ebene auf den einseitigen + Mit dieser Option wird die Einschränkung der Ebene auf den einseitigen oder den doppelseitigen Satz aufgehoben. Sie wird damit wie in der Voreinstellung wieder sowohl im einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% \Option{floatornonfloatpage}}{% - Mit dieser Option wird die Einschränkung der Ebene auf Gleitseiten oder - Seiten, die keine Gleitseiten sind, aufgehoben und diesbezüglich die + Mit dieser Option wird die Einschränkung der Ebene auf Gleitseiten oder + Seiten, die keine Gleitseiten sind, aufgehoben und diesbezüglich die Voreinstellung wieder hergestellt. 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 + 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 + 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.% + \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 + 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 + 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}}{% @@ -518,57 +518,57 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{head}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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.% + Textbereichs überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{headsep}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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 + 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{\OptionVName{height}{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 + \entry{\OptionVName{height}{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.% + Längenausdrucks ist \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.% }% \entry{\OptionVName{hoffset}{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 + 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 + 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 + 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 + 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 + Papieroberkante bis zur Papierunterkante überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\ChangedAt{v3.19}{\Package{scrlayer}}% \OptionVName{mode}{Modus}}{% - Diese primäre Eigenschaft bestimmt, in welchem \PName{Modus} der Inhalt der + Diese primäre Eigenschaft bestimmt, in welchem \PName{Modus} der Inhalt der Ebene ausgegeben wird. Die Voreinstellung ist \PValue{text}. Dabei wird - die oberste Grundlinie um die Höhe einer Standardtextzeile unterhalb der + die oberste Grundlinie um die Höhe einer Standardtextzeile unterhalb der Oberkante der Ebene platziert. Damit ist Text normalerweise sauber am oberen Rand der Ebene ausgerichtet. Im \PValue{picture}-\PName{Modus} wird hingegen eine \Environment{picture}-Umgebung mit dem Ursprung in der @@ -576,117 +576,126 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \PName{Modus} \PValue{raw} entspricht in der Voreinstellung \PValue{text}. Die %\textnote{Achtung!} - Änderung des \PName{Modus} einer Ebene führt in der Regel zu einer - Verschiebung des Inhalts. Außerdem stehen beispielsweise im \PName{Modus} - \PValue{picture} zusätzliche Platzierungsbefehle zur Verfügung, die in - einem anderen \PName{Modus} zu Fehlermeldungen führen. Daher ist es - normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene nachträglich - zu ändern!% + Änderung des \PName{Modus} einer Ebene führt in der Regel zu einer + Verschiebung des Inhalts. Außerdem stehen beispielsweise im \PName{Modus} + \PValue{picture} zusätzliche Platzierungsbefehle zur Verfügung, die in + einem anderen \PName{Modus} zu Fehlermeldungen führen. Daher ist es + normalerweise nicht sinnvoll, den \PName{Modus} einer Ebene nachträglich + zu ändern!% }% \entry{\Option{nonfloatpage}}{% - Mit dieser Option wird die Ebene auf Seiten beschränkt, die keine + 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 + ausgegeben. Näheres zu Gleitseiten und Nichtgleitseiten ist der Einleitung zu diesem Abschnitt zu entnehmen. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% \Option{oddorevenpage}}{% - Mit dieser Option werden Beschränkungen der Ebene auf rechte oder linke + Mit dieser Option werden Beschränkungen der Ebene auf rechte oder linke Seiten aufgehoben. Damit wird die Ebene wie in der Voreinstellung sowohl auf linken als auch rechten Seiten ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{oddpage}}{% - Mit dieser Option wird die Ebene zu einer Ebene für rechte Seiten. Sie + 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 + 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 + 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 + 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 + \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 + 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{align} so, dass die Ebene die komplette Seite überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\ChangedAt{v3.16}{\Package{scrlayer}}% \OptionVName{pretocontents}{Code}}{% Der angegebene Wert wird dem aktuellen Wert des Attributs - \Option{contents} vorangestellt. Es wird also ein zusätzlicher Inhalt vor - dem bisherigen Inhalt generiert. Zu näheren Informationen über die + \Option{contents} vorangestellt. Es wird also ein zusätzlicher Inhalt vor + dem bisherigen Inhalt generiert. Zu näheren Informationen über die Behandlung von \PName{Code} siehe Option \Option{contents}.% }% \entry{\Option{rightmargin}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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 + Papieroberkante bis zur Papierunterkante überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{textarea}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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.% + überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{topmargin}}{% - Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften + 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 + 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 + 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{\ChangedAt{v3.18}{\Package{scrlayer}}% \Option{unrestricted}}{% - Hebt alle Ausgabebeschränkungen auf. Damit ist die Option eine Kombination + Hebt alle Ausgabebeschränkungen auf. Damit ist die Option eine Kombination von \Option{backandforeground}, \Option{everyside} und \Option{floatornonfloatpage}. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\OptionVName{voffset}{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 + \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{\OptionVName{width}{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 + 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.% + Längenausdrucks ist \cite[Abschnitt~3.5]{manual:eTeX} zu entnehmen.% }% \end{desclist} % \EndIndexGroup +\begin{Declaration} + \Macro{ModifyLayers}\OParameter{Optionenliste}\Parameter{Ebenenliste} +\end{Declaration} +Diese\ChangedAt{v3.26}{\Package{scrlayer}} Anweisung führt +\DescRef{\LabelBase.cmd.ModifyLayer} mit der angebenen \PName{Optionenliste} +für alle Ebenen aus, die in der durch Komma separierten \PName{Ebenenliste} +angegeben sind. Sie dient also dazu, die Eigenschaften einer ganzen Reihe von +Ebenen gleichzeitig zu ändern.% +\EndIndexGroup \begin{Declaration} \Macro{layerhalign} @@ -697,40 +706,40 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \Macro{layerheight} \end{Declaration} Diese Anweisungen sind nur im mit \Option{contents}, \Option{addcontents} oder -\Option{pretocontents} angegebenen \PName{Code} gültig. Sie enthalten die -tatsächlich verwendete Ausrichtung, Position und Ausdehnung der Ebene während -deren Ausgabe. 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. +\Option{pretocontents} angegebenen \PName{Code} gültig. Sie enthalten die +tatsächlich verwendete Ausrichtung, Position und Ausdehnung der Ebene während +deren Ausgabe. 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. -Die primäre Ebeneneigenschaft \PValue{align} wird auf +Die primäre Ebeneneigenschaft \PValue{align} wird auf \Macro{layerhalign}\ChangedAt{v3.19}{\Package{scrlayer}} und \Macro{layervalign} abgebildet. Dabei werden die horizontalen Werte \PValue{l} -und \PValue{r} nur in \Macro{layerhalign} übernommen, während die vertikalen -Werte \PValue{t} und \PValue{b} nur in \Macro{layervalign} übernommen +und \PValue{r} nur in \Macro{layerhalign} übernommen, während die vertikalen +Werte \PValue{t} und \PValue{b} nur in \Macro{layervalign} übernommen werden. \iffree{Der sowohl horizontale als auch vertikale }{}% Umbruchkorrektur Wert \PValue{c} wird in -beide Anweisungen übernommen. Sind bei \PValue{align} mehrere, -widersprüchliche Angaben zu finden, so gewinnt die jeweils letzte. Damit ist +beide Anweisungen übernommen. Sind bei \PValue{align} mehrere, +widersprüchliche Angaben zu finden, so gewinnt die jeweils letzte. Damit ist also \Macro{layerhalign} immer entweder \PValue{l}, \PValue{c} oder \PValue{r} und \Macro{layervalign} immer entweder \PValue{t}, \PValue{c} oder \PValue{b}. -Eine\textnote{Achtung!} Umdefinierung der Anweisungen und damit Änderung der in -ihnen gespeicherten Werte ist nicht gestattet und führt zu unvorhersehbaren +Eine\textnote{Achtung!} Umdefinierung der Anweisungen und damit Änderung der in +ihnen gespeicherten Werte ist nicht gestattet und führt zu unvorhersehbaren Ergebnissen.% \EndIndexGroup \begin{Declaration} - \Macro{LenToUnit}\Parameter{Länge} + \Macro{LenToUnit}\Parameter{Länge} \end{Declaration} -Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisung stammt ursprünglich von +Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisung stammt ursprünglich von \Package{eso-pic}\IndexPackage{eso-pic}\iffree{ ab Version~2.0f}{}%Umbruchkorrektur -. Sie rechnet Längen-Werte in Vielfache von \Length{unitlength} um und kann -daher anstelle von Koordinaten oder anderen von \Length{unitlength} abhängigen +. Sie rechnet Längen-Werte in Vielfache von \Length{unitlength} um und kann +daher anstelle von Koordinaten oder anderen von \Length{unitlength} abhängigen Werten einer \Environment{picture}-Umgebung verwendet werden. Siehe dazu auch -\cite{package:eso-pic} und die nachfolgende Erklärung zu \Macro{putUR}, +\cite{package:eso-pic} und die nachfolgende Erklärung zu \Macro{putUR}, \Macro{putLL} und \Macro{putLR}. Die Anweisung wird nur definiert, wenn sie nicht bereits beispielsweise durch das Laden von \Package{eso-pic} definiert ist.% @@ -739,8 +748,8 @@ ist.% Es sei an dieser Stelle darauf hingewiesen, dass man bei Verwendung von Paket \Package{picture}\IndexPackage{picture}\textnote{\Package{picture}} (siehe \cite{package:picture}) die Anweisung \Macro{LenToUnit} in der Regel nicht -mehr benötigt. Das Paket erweitert die \Environment{picture}-Umgebung und -deren Anweisung so, dass man für Koordinaten auch direkt \LaTeX-Längen +mehr benötigt. Das Paket erweitert die \Environment{picture}-Umgebung und +deren Anweisung so, dass man für Koordinaten auch direkt \LaTeX-Längen verwenden kann.% \fi \EndIndexGroup @@ -753,8 +762,8 @@ verwenden kann.% \Macro{putLR}\Parameter{Inhalt} \Macro{putC}\Parameter{Inhalt} \end{Declaration} -Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisungen können innerhalb der -primären Ebeneneigenschaft \PValue{contents} verwendet werden, wenn die Ebene +Diese\ChangedAt{v3.19}{\Package{scrlayer}} Anweisungen können innerhalb der +primären Ebeneneigenschaft \PValue{contents} verwendet werden, wenn die Ebene mit \OptionValue{mode}{picture} erstellt wurde. In diesem Fall platziert \Macro{putUL} den \PName{Inhalt} relativ zur oberen, linken Ecke der Ebene und entspricht damit @@ -773,8 +782,8 @@ damit schlussendlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.% % \begin{Example} - Sie wollen feststellen, wie genau die Höhe des Textbereichs bei - \OptionValueRef{typearea}{DIV}{classic} tatsächlich der Breite der Seite + Sie wollen feststellen, wie genau die Höhe des Textbereichs bei + \OptionValueRef{typearea}{DIV}{classic} tatsächlich der Breite der Seite entspricht, und erstellen dazu eine Ebene, die sowohl den Textbereich umrandet als auch einen Kreis mit der Papierbreite als Durchmesser im Zentrum des Textbereichs platziert: @@ -801,8 +810,8 @@ schlussendlich platziert \PName{Inhalt} relativ zur Mitte der Ebene.% Wie Sie sehen werden, passt die von \Package{typearea} vorgenommene Abbildung auf einen ganzzahligen \PName{DIV}-Wert im Beispiel sehr gut. \end{Example} -Näheres zu dem im Beispiel skizzierten spätmittelalterlichen Buchseitenkanon -finden Sie übrigens in \autoref{sec:typearea.circleConstruction}, +Näheres zu dem im Beispiel skizzierten spätmittelalterlichen Buchseitenkanon +finden Sie übrigens in \autoref{sec:typearea.circleConstruction}, \autopageref{sec:typearea.circleConstruction}. Die Anweisung @@ -810,7 +819,7 @@ Die Anweisung im Beispiel bereits verwendet wurde, dient der Definition eines Seitenstils, der die neu definiert Ebene ausgibt. Sie wird in \autoref{sec:scrlayer.pagestyles}, -\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt werden.% +\DescPageRef{scrlayer.cmd.DeclareNewPageStyleByLayers} erklärt werden.% \EndIndexGroup @@ -821,8 +830,8 @@ Mit\ChangedAt{v3.16}{\Package{scrlayer}} dieser Anweisung kann der aktuelle Inhalt einer Ebene ermittelt werden. Es\textnote{Achtung!} ist unbedingt zu beachten, dass bei Verwendung dieser Anweisung im \PName{Code} der Ebenen-Attribute \Option{contents}, \Option{addcontents} oder -\Option{pretocontents} unendliche Rekursionen entstehen können, wenn dabei auf -den Inhalt der aktuellen Ebene zugegriffen wird. Der Anwender ist selbst dafür +\Option{pretocontents} unendliche Rekursionen entstehen können, wenn dabei auf +den Inhalt der aktuellen Ebene zugegriffen wird. Der Anwender ist selbst dafür verantwortlich, solche Situationen zu vermeiden!% \EndIndexGroup @@ -831,21 +840,21 @@ verantwortlich, solche Situationen zu vermeiden!% \Macro{IfLayerExists}\Parameter{Name~der~Ebene} \Parameter{Dann-Code}\Parameter{Sonst-Code} \end{Declaration} -Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob -eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene \PName{Name der - Ebene} existiert, so wird der \PName{Dann-Code} ausgeführt, anderenfalls der +Diese Anweisung kann dazu verwendet werden, Code in Abhängigkeit davon, ob +eine Ebene existiert oder nicht, auszuführen. Wenn die Ebene \PName{Name der + Ebene} 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. % +die niemals falsch-negativ sein können, jedoch im Extremfall falsch-positiv +sein könnten. % \iffalse% Umbruchvarianten -Nichtsdestotrotz: 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 +Nichtsdestotrotz: 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.% \else Falsch-positive Entscheidungen weisen auf ein Problem, beispielsweise die -Verwendung eines inkompatiblen Pakets oder ungünstige Wahl von internen +Verwendung eines inkompatiblen Pakets oder ungünstige Wahl von internen Makronamen durch den Anwender.% \fi \EndIndexGroup @@ -855,20 +864,20 @@ Makronamen durch den Anwender.% \Macro{DestroyLayer}\Parameter{Name~der~Ebene} \end{Declaration} Existiert eine Ebene \PName{Name der Ebene}, so werden alle zu dieser Ebene -gehörenden Makros zu \Macro{relax}. Die Ebene kann nicht länger verwendet +gehörenden Makros zu \Macro{relax}. Die Ebene kann nicht länger verwendet werden. In bereits mit \Package{scrlayer} definierten Seitenstils werden -derart zerstörte Ebenen ignoriert. Zerstörte Ebenen können mit +derart zerstörte Ebenen ignoriert. Zerstörte Ebenen können mit \DescRef{\LabelBase.cmd.DeclareNewLayer} oder -\DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können jedoch -vor einer neuerlichen Definition nicht länger mit +\DescRef{\LabelBase.cmd.ProvideLayer} neu definiert werden. Sie können jedoch +vor einer neuerlichen Definition nicht länger mit \DescRef{\LabelBase.cmd.RedeclareLayer} oder -\DescRef{\LabelBase.cmd.ModifyLayer} verändert werden. +\DescRef{\LabelBase.cmd.ModifyLayer} verändert werden. Die Anweisung ist dazu bestimmt, innerhalb des Arguments \PName{Code} von \DescRef{\LabelBase.cmd.scrlayerOnAutoRemoveInterface} (siehe \autoref{sec:scrlayer.enduserinterfaces}, \DescPageRef{scrlayer.cmd.scrlayerOnAutoRemoveInterface}) verwendet zu -werden. Damit können Ebenen, die unter Verwendung von entfernbaren Anweisungen +werden. Damit können Ebenen, die unter Verwendung von entfernbaren Anweisungen einer entfernbaren Benutzerschnittstelle definiert wurden, zusammen mit dieser Benutzerschnittstelle entfernt werden.% \EndIndexGroup @@ -879,13 +888,13 @@ Benutzerschnittstelle entfernt werden.% \end{Declaration} Mit Hilfe der \KOMAScript-Option \DescRef{\LabelBase.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 +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.% % \EndIndexGroup @@ -898,37 +907,37 @@ verwendet werden.% \BeginIndex{}{Seiten>Stil}% 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. +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\textnote{gerade oder ungerade +Kopf und Fuß für ungerade oder rechte Seiten\textnote{gerade oder ungerade Seite} 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\important[i]{\Option{evenpage}\\\Option{oddpage}} \Option{oddpage} -und \Option{evenpage} für Ebenen vergleichbar. +und \Option{evenpage} für Ebenen vergleichbar. -Der Seitenkopf\textnote{Kopf oder Fuß} wird vor dem normalen Seiteninhalt -ausgegeben. Der Seitenfuß wird entsprechend nach dem normalen Seiteninhalt +Der Seitenkopf\textnote{Kopf oder Fuß} wird vor dem normalen Seiteninhalt +ausgegeben. Der Seitenfuß wird entsprechend nach dem normalen Seiteninhalt ausgegeben. Dies korrespondiert also unmittelbar mit den Optionen\important[i]{\Option{background}\\\Option{foreground}} -\Option{background} und \Option{foreground} für Ebenen. +\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 +statt nur die genannten vier Optionen können dabei alle Eigenschaften verwendet werden, die in \autoref{sec:scrlayer.layers}, \autoref{tab:scrlayer.layerkeys}, ab \autopageref{tab:scrlayer.layerkeys} -erklärt wurden. +erklärt wurden. -Als Ergebnis dieser Überlegungen ist eine Form von Seitenstilen, die +Als Ergebnis dieser Ãœberlegungen ist eine Form von Seitenstilen, die \Package{scrlayer} bietet, der Ebenen-Seitenstil\textnote{Ebenen-Seitenstil}% \Index{Seitenstil>Ebenen-}\Index{Ebenen>Seitenstil}\Index{Seiten>Stil}. Ein -solcher Ebenen-Seitenstil besteht aus Ebenen und zusätzlich aus mehreren Haken +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\Index[indexmain]{Haken}\textnote{Haken} sind Punkte in der Expansion -oder Anwendung von Seitenstilen, zu denen zusätzlicher Code hinzugefügt werden +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 \DescRef{scrlfile.cmd.BeforeClosingMainAux} (siehe @@ -938,17 +947,17 @@ Eine zweite Form von Seitenstilen, die \Package{scrlayer} bietet, ist der Alias-Seitenstil\textnote{Alias-Seitenstil}% \Index{Seitenstil>Alias-}\Index{Alias>Seitenstil}\Index{Seiten>Stil} 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 +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}\textnote{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 +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. @@ -961,33 +970,33 @@ Das Paket \Package{scrlayer} erweitert die \LaTeX-Anweisung \Macro{currentpagestyle} als den Namen des jeweils aktiven Seitenstils definiert. Es\textnote{Achtung!} ist zu beachten, dass \DescRef{maincls.cmd.thispagestyle}\IndexCmd{thispagestyle} selbst -\Macro{currentpagestyle} nicht verändert. Wird +\Macro{currentpagestyle} nicht verändert. Wird \DescRef{maincls.cmd.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 +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 +Es sei darauf hingewiesen, dass die später in diesem Abschnitt dokumentierten Ebenen-Seitenstile nicht auf diese Erweiterung von \DescRef{maincls.cmd.pagestyle} angewiesen sind, da sie selbst auch -\Macro{currentpagestyle} umdefinieren. Die Erweiterung wurde für die +\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 +basieren, vorgenommen. Es ist außerdem zu beachten\textnote{Achtung!}, dass \Macro{currentpagestyle} vor der ersten Verwendung von \DescRef{maincls.cmd.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 \DescRef{maincls.cmd.pagestyle}-Anweisung +ist. Bei der Definition einer Endanwender-Schnittstelle dürfte es daher +nützlich sein, mit einer impliziten \DescRef{maincls.cmd.pagestyle}-Anweisung den aktuellen Seitenstil auf eine Voreinstellung zu setzen.% Wird mit \DescRef{maincls.cmd.pagestyle} ein Alias-Seitenstils aktiviert, so liefert \Macro{currentpagestyle} nicht den Alias-Namen, sondern den des -originären Seitenstils. Den\ChangedAt{v3.16}{\Package{scrlayer}} Alias-Namen +originären Seitenstils. Den\ChangedAt{v3.16}{\Package{scrlayer}} Alias-Namen kann man in diesem Fall mit \Macro{toplevelpagestyle} erhalten. Es wird davon abgeraten, Seitenstile zu definieren, die beispielsweise per -\DescRef{scrbase.cmd.ifstr} abhängig von \Macro{toplevelpagestyle} +\DescRef{scrbase.cmd.ifstr} abhängig von \Macro{toplevelpagestyle} unterschiedliche Ergebnisse liefern, da dies bei Aktivierung per -\DescRef{maincls.cmd.thispagestyle} zu falschen Resultaten führen kann.% +\DescRef{maincls.cmd.thispagestyle} zu falschen Resultaten führen kann.% \EndIndexGroup @@ -995,49 +1004,49 @@ unterschiedliche Ergebnisse liefern, da dies bei Aktivierung per \Macro{BeforeSelectAnyPageStyle}\Parameter{Code} \Macro{AfterSelectAnyPageStyle}\Parameter{Code} \end{Declaration} -Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken\Index{Haken} -(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von +Die Anweisung \Macro{BeforeSelectAnyPageStyle} fügt einem Haken\Index{Haken} +(engl. \emph{hook}) \PName{Code} hinzu, der innerhalb der Ausführung von Anweisung \DescRef{maincls.cmd.pagestyle}% \important{\DescRef{maincls.cmd.pagestyle}}\IndexCmd{pagestyle}, unmittelbar -vor der Auswahl des Seitenstils ausgeführt wird. Innerhalb von \PName{Code} -kann \texttt{\#1} als Platzhalter für das Argument von +vor der Auswahl des Seitenstils ausgeführt wird. Innerhalb von \PName{Code} +kann \texttt{\#1} als Platzhalter für das Argument von \DescRef{maincls.cmd.pagestyle} verwendet werden. -Die Anweisung \Macro{AfterSelectAnyPageStyle} arbeitet ähnlich. Allerdings -wird hier \PName{Code} ausgeführt, nachdem der Seitenstil gewählt und +Die Anweisung \Macro{AfterSelectAnyPageStyle} arbeitet ähnlich. Allerdings +wird hier \PName{Code} ausgeführt, nachdem der Seitenstil gewählt und \DescRef{\LabelBase.cmd.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 \DescRef{maincls.cmd.pagestyle} -ausgeführt wird. Wird ein Seitenstil auf andere Art, beispielsweise mit Hilfe -von \DescRef{maincls.cmd.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.% +ausgeführt wird. Wird ein Seitenstil auf andere Art, beispielsweise mit Hilfe +von \DescRef{maincls.cmd.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.% \EndIndexGroup \begin{Declaration} \Macro{DeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name} - \Parameter{originärer~Seitenstil-Name} + \Parameter{originärer~Seitenstil-Name} \Macro{DeclareNewPageStyleAlias}\Parameter{Seitenstil-Alias-Name} - \Parameter{originärer~Seitenstil-Name} + \Parameter{originärer~Seitenstil-Name} \Macro{ProvidePageStyleAlias}\Parameter{Seitenstil-Alias-Name} - \Parameter{originärer~Seitenstil-Name} + \Parameter{originärer~Seitenstil-Name} \Macro{RedeclarePageStyleAlias}\Parameter{Seitenstil-Alias-Name} - \Parameter{originärer~Seitenstil-Name} + \Parameter{originärer~Seitenstil-Name} \end{Declaration} \BeginIndex{}{Seitenstil>Alias-}% \BeginIndex{}{Alias>Seitenstil}% -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 +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. +zerstört. Die Anweisung \Macro{DeclareNewPageStyleAlias} erzeugt eine Fehlermeldung, falls zuvor bereits ein Seitenstil \PName{Seitenstil-Alias-Name} @@ -1057,7 +1066,7 @@ eine Fehlermeldung. \iffree{\csname @tempswafalse\endcsname}{\csname @tempswatrue\endcsname}% \csname if@tempswa\endcsname% Umbruchkorrekturtext \begin{Example} - Angenommen, Sie schreiben eine Klasse und verwenden darin für + Angenommen, Sie schreiben eine Klasse und verwenden darin für Kapitelanfangsseiten den Seitenstil \PageStyle{chapter}. In der Voreinstellung soll dieser Seitenstil dem Seitenstil \PageStyle{plain} entsprechen. Daher verwenden Sie das Paket \Package{scrlayer} und definieren @@ -1065,8 +1074,8 @@ eine Fehlermeldung. \begin{lstcode} \DeclareNewPageStyleAlias{chapter}{plain} \end{lstcode} - den Seitenstil \PageStyle{chapter} als Alias für den Seitenstil - \PageStyle{plain}. Will hingegen der Anwender später, dass der Seitenstil + den Seitenstil \PageStyle{chapter} als Alias für den Seitenstil + \PageStyle{plain}. Will hingegen der Anwender später, dass der Seitenstil \PageStyle{chapter} dem Seitenstil \PageStyle{empty} entspricht, so erreicht er dies mit: \begin{lstcode} @@ -1083,8 +1092,8 @@ eine Fehlermeldung. \BeginIndex{}{Seitenstil>Alias-}% \BeginIndex{}{Alias>Seitenstil}% 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 +\PName{Seitenstil-Alias-Name} für \LaTeX{} wieder undefiniert, wenn es +tatsächlich einen Alias-Seitenstil dieses Namens gibt. Anschließend kann der Seitenstil auch mit \DescRef{\LabelBase.cmd.DeclareNewPageStyleAlias} oder \DescRef{\LabelBase.cmd.ProvidePageStyleAlias} neu definiert werden. @@ -1102,9 +1111,9 @@ wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.% \end{Declaration} \BeginIndex{}{Seitenstil>Alias-}% \BeginIndex{}{Alias>Seitenstil}% -Diese Anweisung sucht rekursiv nach dem tatsächlichen Namen eines +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-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 @@ -1132,132 +1141,132 @@ Diese Anweisungen deklarieren einen Seitenstil mit dem Namen \PName{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 müssen und die Expansion zu einer -Reihe von Buchstaben führen sollte. Einige zusätzliche Zeichen werden +\PName{Ebenenliste} voll expandierbar sein müssen und die Expansion zu einer +Reihe von Buchstaben führen sollte. Einige zusätzliche Zeichen werden ebenfalls akzeptiert, ihre Verwendung wird jedoch nur erfahrenden Anwendern empfohlen. Die \PName{Optionenliste} ist eine mit Komma separierte Liste von Optionen der -Form \texttt{\PName{Schlüssel}=\PName{Code}}. Diese Optionen können verwendet -werden, um zusätzliche Eigenschaften zu setzen und zusätzliche Möglichkeiten +Form \texttt{\PName{Schlüssel}=\PName{Code}}. Diese Optionen können verwendet +werden, um zusätzliche Eigenschaften zu setzen und zusätzliche Möglichkeiten zu nutzen. Derzeit werden sie verwendet, um \mbox{Code} an bestimmten Stellen -der Aktivierung oder Verwendung eines Seitenstils über Haken\Index{Haken} -(engl. \emph{hooks}) auszuführen. Für allgemeine Informationen zu Haken sei +der Aktivierung oder Verwendung eines Seitenstils über Haken\Index{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 + 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})% + Optionen für die Haken von Ebenen-Seitenstilen (\emph{Fortsetzung})% }% \entry{\OptionVName{onselect}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt, + Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt, wenn der Seitenstil beispielsweise mit \DescRef{maincls.cmd.pagestyle} - ausgewählt wird. Es ist zu beachten, dass + ausgewählt wird. Es ist zu beachten, dass \DescRef{maincls.cmd.thispagestyle} selbst keinen Seitenstil unmittelbar - auswählt, sondern der Seitenstil in diesem Fall erst innerhalb der + auswählt, sondern der Seitenstil in diesem Fall erst innerhalb der Ausgaberoutine von \LaTeX{} aktiviert wird.% }% \entry{\OptionVName{oninit}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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.% + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{ononeside}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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 + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{ontwoside}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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 + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{onoddpage}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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 + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{onevenpage}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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 + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{onfloatpage}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} 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 + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{onnonfloatpage}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt, - wenn die Ausgabe der Ebenen für den Seitenstil auf einer Seite + Der \PName{Code} dieses Hakens\Index{Haken} 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 + 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.% + Seiten sehr wohl t-, b- oder h-platzierte Gleitumgebungen stehen können.% }% \entry{\OptionVName{onbackground}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt, - wenn die Ausgabe der Ebenen für den Hintergrund einer Seite initialisiert + Der \PName{Code} dieses Hakens\Index{Haken} 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{\OptionVName{onforeground}{Code}}{% - Der \PName{Code} dieses Hakens\Index{Haken} wird immer dann ausgeführt, - wenn die Ausgabe der Ebenen für den Vordergrund einer Seite initialisiert + Der \PName{Code} dieses Hakens\Index{Haken} 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} \iffalse% Umbruchvarianten -Während die Anweisung +Während die Anweisung \Macro{DeclarePageStyleByLayers} %\important{\Macro{DeclarePageStyleByLayers}}% % Leider zu lang. Deshalb auch auf alle % weiteren verzichtet. den Seitenstil immer definiert, erzeugt \Macro{DeclareNewPageStyleByLayers} eine Fehlermeldung, falls bereits ein Seitenstil gleichen Namens existiert. Beachten\textnote{Achtung!} Sie, dass die Deklaration eines -Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe +Seitenstils, der bereits ein Alias für einen anderen Seitenstil ist (siehe beispielsweise \Macro{DeclareAliasPageStyle} zuvor in diesem Abschnitt) nicht zu der Umdefinierung des angegebenen Alias-Seitenstils, sondern des realen Seitenstils (siehe \DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem -Abschnitt) führt.% +Abschnitt) führt.% \else% Die Anweisung \Macro{DeclarePageStyleByLayers} definiert den Seitenstil -unabhängig davon, ob bereits ein Seitenstil des Namens \PName{Seitenstil-Name} +unabhängig davon, ob bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert. Gegebenenfalls wird der existierende Seitenstil komplett neu definiert. Falls bereits ein Alias-Seitenstil \PName{Seitenstil-Name} existiert wird jedoch nicht der Alias-Seitenstil selbst neu definiert, sondern -der zugehörige reale Seitenstil (siehe +der zugehörige reale Seitenstil (siehe \DescRef{\LabelBase.cmd.GetRealPageStyle} zuvor in diesem Abschnitt). Die Anweisung \Macro{DeclareNewPageStyleByLayers} unterscheidet sich in dem -Fall, dass bereits ein gleichnamiger Seitenstil existiert. Unabhängig davon, +Fall, dass bereits ein gleichnamiger Seitenstil existiert. Unabhängig davon, ob es sich um einen realen Seitenstil oder einen Alias-Seitenstil handelt, wird in diesem Fall ein Fehler gemeldet.% \fi Im Unterschied dazu wird bei \Macro{ProvidePageStyleByLayers} der Seitenstil -unverändert erhalten, wenn bereits ein Seitenstil des Namens +unverändert erhalten, wenn bereits ein Seitenstil des Namens \PName{Seitenstil-Name} existiert. Existiert kein solcher Seitenstil, so wird er wie bei \Macro{DeclarePageStyleByLayers} definiert. @@ -1286,28 +1295,28 @@ als Ziel eines Alias-Seitenstils verwendet werden. Stattdessen werden die Ebenen und Haken\Index{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. +jeweils vor den entsprechenden Ebenen des aktiven Seitenstils ausgeführt. -Damit ist das Hinzufügen einer Ebene zum Pseudo-Seitenstil +Damit ist das Hinzufügen einer Ebene zum Pseudo-Seitenstil \PageStyle{@everystyle@} oder von Code zu einem Haken dieses Seitenstils -vergleichbar mit dem Hinzufügen einer Ebene beziehungsweise von Haken-Code zu +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, das sind neben \DescRef{\LabelBase.cmd.ForEachLayerOfPageStyle} beispielsweise auch die Anweisungen \DescRef{\LabelBase.cmd.AddLayersToPageStyleBeforeLayer} oder \DescRef{\LabelBase.cmd.AddLayersToPageStyleAfterLayer}, lassen die Ebenen des -Seitenstils \PageStyle{@everystyle@} unberücksichtigt, wenn sie auf einen +Seitenstils \PageStyle{@everystyle@} unberücksichtigt, wenn sie auf einen anderen Ebenen-Seitenstil angewendet werden. Der zweite etwas andere Ebenen-Seitenstil ist \PageStyle{empty}\important{\PageStyle{empty}}. Bereits vom \LaTeX-Kern wird -ein Seitenstil dieses Namens definiert, der einen leeren Kopf und Fuß hat. Das +ein Seitenstil dieses Namens definiert, der einen leeren Kopf und Fuß hat. 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 +verwendet werden. Der Hauptvorteil dieses Ebenen-Seitenstils gegenüber dem +ursprünglichen Seitenstil aus dem \LaTeX-Kern ist, dass er ebenfalls die Haken\Index{Haken} und Ebenen des Pseudo-Seitenstils \PageStyle{@everystyle@} -ausführt.% +ausführt.% \EndIndexGroup @@ -1325,21 +1334,21 @@ ausführt.% \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Für jeden der Haken\Index{Haken} aus \autoref{tab:scrlayer.pagestyle.hooks} -existiert außerdem eine \KOMAScript-Option% +Für jeden der Haken\Index{Haken} aus \autoref{tab:scrlayer.pagestyle.hooks} +existiert außerdem eine \KOMAScript-Option% \iftrue% -. Die Namen der \KOMAScript-Optionen ähneln den Namen der Optionen für die +. 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% +»\texttt{ps}« nach dem »\texttt{on}« am Anfang des Namens eingefügt% \else% -, in deren Namen lediglich ein \texttt{ps} eingefügt wurde% +, in deren Namen lediglich ein \texttt{ps} eingefügt wurde% \fi% -. Die Werte dieser \KOMAScript-Optionen werden als Anfangswerte für die +. 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 \DescRef{\LabelBase.cmd.ModifyLayerPageStyleOptions}, die -später in diesem Abschnitt erklärt wird, entfernt werden.% +später in diesem Abschnitt erklärt wird, entfernt werden.% \EndIndexGroup @@ -1349,14 +1358,14 @@ später in diesem Abschnitt erklärt wird, entfernt werden.% Wird\ChangedAt{v3.24}{\Package{scrlayer}\and \Package{scrlayer-scrpage}} ein Dokument beispielsweise mit Hilfe von Paket \Package{setspace}\IndexPackage{setspace}\important{\Package{setspace}} mit -erhöhtem Zeilenabstand gesetzt, ist es oft dennoch nicht erwünscht, dass Kopf -und Fuß der Seite ebenfalls mit diesem erhöhten Zeilenabstand gesetzt -werden. Das gilt umso mehr, wenn Kopf und Fuß nur aus jeweils einer Zeile +erhöhtem Zeilenabstand gesetzt, ist es oft dennoch nicht erwünscht, dass Kopf +und Fuß der Seite ebenfalls mit diesem erhöhten Zeilenabstand gesetzt +werden. Das gilt umso mehr, wenn Kopf und Fuß nur aus jeweils einer Zeile bestehen. In diesem Fall kann man \KOMAScript-Option \Option{singlespacing} setzen. In der Voreinstellung\textnote{Voreinstellung} ist die Option jedoch -nicht gesetzt! Die Option wirkt generell für alle Ebenen-Seitenstile. Will man +nicht gesetzt! Die Option wirkt generell für alle Ebenen-Seitenstile. Will man hingegen nur einige Ebenen-Seitenstil einzeilig gesetzt haben, so sollte man -stattdessen für diese Seitenstile +stattdessen für diese Seitenstile \OptionValue{oninit}{\Macro{linespread}\PParameter{1}\Macro{selectfont}} verwenden.% \EndIndexGroup @@ -1372,13 +1381,13 @@ verwenden.% \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% Solange \KOMAScript-Option \Option{deactivatepagestylelayers} nicht -aktiviert ist, kann mit \Macro{ForEachLayerOfPageStyle} für jede Ebene des +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. +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 + \PValue{scrheadings} als Komma-separierte Liste, so können Sie dies mit \begin{lstcode} \newcommand*\commaatlist{} \ForEachLayerOfPageStyle{scrheadings}{% @@ -1389,23 +1398,23 @@ Platzhalter für den Namen der gerade abgearbeiteten Ebene. \end{Example} Die Verwendung von \Macro{gdef} anstelle von \Macro{def} ist im Beispiel notwendig\textnote{Achtung!}, weil \PName{Code} innerhalb einer Gruppe -ausgeführt wird, um unerwünschte Seiteneffekte zu minimieren. Die Anweisung +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. +Aufruf des Codes für die nächste Ebene die Änderung Bestand hat. -Alternativ\ChangedAt{v3.18}{\Package{scrlayer}} hätte man auch zwar mit -\Macro{def}, dafür aber mit der Sternvariante \Macro{ForEachLayerOfPageStyle*} -arbeiten können. Diese Form verzichtet bei der Ausführung von \PName{Code} auf +Alternativ\ChangedAt{v3.18}{\Package{scrlayer}} hätte man auch zwar mit +\Macro{def}, dafür aber mit der Sternvariante \Macro{ForEachLayerOfPageStyle*} +arbeiten können. Diese Form verzichtet bei der Ausführung von \PName{Code} auf eine Gruppe. Allerdings muss der Anwender dann selbst -sicherstellen, dass \PName{Code} keine unerwünschten Seiteneffekte -hat. Insbesondere würde die Deaktivierung der Ebenen mit +sicherstellen, dass \PName{Code} keine unerwünschten Seiteneffekte +hat. Insbesondere würde die Deaktivierung der Ebenen mit \OptionValue{deactivatepagestylelayers}{true} innerhalb von \PName{Code} dann -über den Aufruf von \Macro{ForEachLayerOfPageStyle*} hinaus Bestand haben. +über den Aufruf von \Macro{ForEachLayerOfPageStyle*} hinaus Bestand haben. Diverse Anweisungen von \Package{scrlayer} setzen intern selbst ebenfalls -\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die -\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese -Option kann also verwendet werden, um alle Ebenen aller Seitenstile temporär +\Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die +\KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese +Option kann also verwendet werden, um alle Ebenen aller Seitenstile temporär zu deaktivieren und damit zu verstecken.% \EndIndexGroup @@ -1422,23 +1431,23 @@ zu deaktivieren und damit zu verstecken.% \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Diese Anweisungen können verwendet werden, um Ebenen zu einem Seitenstil -hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über +Diese Anweisungen können verwendet werden, um Ebenen zu einem Seitenstil +hinzuzufügen oder davon zu entfernen. Der Seitenstil wird dabei über \PName{Seitenstil-Name} referenziert. Die Ebenen werden in einer durch Komma separierten \PName{Ebenenliste} angegeben. Sowohl die Anweisung \Macro{AddLayersToPageStyle} als auch die Anweisung -\Macro{AddLayersAtEndOfPageStyle}\textnote{hinzufügen am Ende} fügt die Ebenen +\Macro{AddLayersAtEndOfPageStyle}\textnote{hinzufügen am Ende} fügt 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 +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}\textnote{hinzufügen am - Anfang} 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 +Die Anweisung \Macro{AddLayersAtBeginOfPageStyle}\textnote{hinzufügen am + Anfang} 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 +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. @@ -1452,9 +1461,9 @@ Seitenstil.% Der Versuch, mit Hilfe von \Macro{RemoveLayersFromPageStyle}\textnote{entfernen} 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, +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 +Alias-Seitenstil, der zu einem Ebenen-Seitenstil führt, hinzuzufügen oder von einem solchen zu entfernen, ein Fehler und wird als solcher gemeldet.% \EndIndexGroup @@ -1470,26 +1479,26 @@ einem solchen zu entfernen, ein Fehler und wird als solcher gemeldet.% \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% \iffalse% Umbruchvarianten -Diese beiden Befehle ähneln den vorangegangenen. Allerdings wird hier -zusätzlich ein \PName{Referenzebenen-Name} angegeben. Die Ebenen des über den +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. % \else% -Die Befehle ähneln den vorherigen. Die existierenden Ebenen des Seitenstils +Die Befehle ähneln den vorherigen. Die existierenden Ebenen des Seitenstils werden jedoch nach \PName{Referenzebenen-Name} durchsucht. % \fi% Die Ebenen der \PName{Ebenenliste} werden dann -vor\textnote{hinzufügen vor/nach Ebene} +vor\textnote{hinzufügen vor/nach Ebene} respektive nach jedem Auf"|treten der Referenzebene % \iffalse% Umbruchkorrekturtext in die Ebenen des Seitenstils % \fi% -eingefügt. Dabei bleibt die Reihenfolge der Ebenen der +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 +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.% \EndIndexGroup @@ -1499,19 +1508,19 @@ gemeldet.% \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Bei den Befehlen zur Definition eines Seitenstils oder zum Hinzufügen von +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 +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 +\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. In einem solchen Fall ist +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. In einem solchen Fall ist \Macro{UnifyLayersAtPageStyle} also nicht geeignet.% \EndIndexGroup @@ -1524,23 +1533,23 @@ Reihenfolge neu hinzugefügt werden. In einem solchen Fall ist \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Mit diesen beiden Anweisungen können die Optionen und damit die -Haken\Index{Haken} eines Ebenen-Seitenstils nachträglich verändert werden. Bei -\Macro{ModifyLayerPageStyleOptions}\textnote{Seitenstil-Optionen ändern} +Mit diesen beiden Anweisungen können die Optionen und damit die +Haken\Index{Haken} eines Ebenen-Seitenstils nachträglich verändert werden. Bei +\Macro{ModifyLayerPageStyleOptions}\textnote{Seitenstil-Optionen ändern} 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 \iffree{beziehungsweise}{oder} Haken, die nicht in der \PName{Optionenliste} -angegeben sind, bleiben hingegen unverändert. Diese Anweisung ist +angegeben sind, bleiben hingegen unverändert. Diese Anweisung ist \iffree{damit auch }{}% Umbruchkorrektur -die einzige Möglichkeit, die globalen Voreinstellungen der +die einzige Möglichkeit, die globalen Voreinstellungen der \KOMAScript-Optionen von einem Seitenstil zu entfernen. Die Anweisung \Macro{AddToLayerPageStyleOptions}\textnote{Seitenstil-Optionen - erweitern} dagegen überschreibt die bisher vorhandenen Werte nicht, sondern -fügt die neuen zu den bisherigen hinzu oder -- genauer gesagt -- hängt die + erweitern} dagegen überschreibt die bisher vorhandenen Werte nicht, sondern +fügt die neuen zu den bisherigen hinzu oder -- genauer gesagt -- hängt die neuen Werte an die alten an.% \EndIndexGroup @@ -1555,20 +1564,20 @@ neuen Werte an die alten an.% \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Mit den Anweisungen kann Code in Abhängigkeit davon ausgeführt werden, ob -ein Seitenstil ein Ebenen-Seitenstil ist oder nicht. Dabei führt +Mit den 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. +Alias-Seitenstils ist, der zu einem Ebenen-Seitenstil führt. Anderenfalls +führt die Anweisung den \PName{Sonst-Code} aus. \iffree{Die Anweisung }{}%Umbruchvarianten -\Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und führt +\Macro{IfRealLayerPageStyleExists} geht einen Schritt weiter und führt \iffree{den }{}% Umbruchvarianten -\PName{Dann-Code} nur dann aus, wenn der über \PName{Seitenstil-Name} +\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.% +Alias-Seitenstils führt diese Anweisung also selbst dann \PName{Sonst-Code} +aus, wenn dieser Alias-Seitenstil zu einem Ebenen-Seitenstil führt.% \EndIndexGroup @@ -1588,23 +1597,23 @@ aus, wenn dieser Alias-Seitenstil zu einem Ebenen-Seitenstil führt.% \end{Declaration} \BeginIndex{}{Seitenstil>Ebenen-}% \BeginIndex{}{Ebenen>Seitenstil}% -Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen +Mit diesen Anweisungen kann überprüft werden, ob ein oder mehrere Ebenen Bestandteil eines Seitenstils sind. \Macro{IfLayerAtPageStyle} erwartet dabei nach dem \PName{Seitenstil-Name} im ersten Argument im zweiten Argument genau\textnote{genau eine Ebene} einen \PName{Ebenen-Name}. Ist die entsprechende Ebene Bestandteil des Seitenstils, so wird der \PName{Dann-Code} -ausgeführt, anderenfalls der \PName{Sonst-Code}. +ausgeführt, anderenfalls der \PName{Sonst-Code}. Im Unterschied dazu erlauben \Macro{IfSomeLayersAtPageStyle} und \Macro{IfLayersAtPageStyle} im zweiten Argument eine durch Komma separierte -\PName{Ebenenliste}. Dabei führt +\PName{Ebenenliste}. Dabei führt \Macro{IfSomeLayersAtPageStyle}\textnote{mindestens eine Ebene} den \PName{Dann-Code} bereits aus, wenn \emph{mindestens eine} der Ebenen -Bestandteil des Seitenstils ist. Dagegen führt +Bestandteil des Seitenstils ist. Dagegen führt \Macro{IfLayersAtPageStyle}\textnote{alle Ebenen} den \PName{Dann-Code} nur aus, wenn \emph{alle} Ebenen Bestandteil des Seitenstils sind. \iffree{Ist die - Bedingung nicht erfüllt, so}{Anderenfalls} wird jeweils \PName{Sonst-Code} -ausgeführt. + Bedingung nicht erfüllt, so}{Anderenfalls} 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, @@ -1625,9 +1634,9 @@ ignoriert.% \else% 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 +dem Namen \PName{Ebenen-Seitenstil-Name} auch tatsächlich gibt. Handelt es sich stattdessen um einen Alias-Seitenstil -- auch wenn dieser zu einem -Ebenen-Seitenstil führt -- oder um einen anderen Seitenstil oder ist gar kein +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.% \fi @@ -1636,12 +1645,12 @@ Falls \PName{Ebenen-Seitenstil-Name} der Name des aktuellen Seitenstils ist, so wird dieser auf eine Art leeren Seitenstil gesetzt. Falls der mit \DescRef{maincls.cmd.thispagestyle} gesetzte Seitenstil \PName{Ebenen-Seitenstil-Name} lautet, so wird dieser einfach nur -zurückgesetzt. Die vorherige Anweisung \DescRef{maincls.cmd.thispagestyle} +zurückgesetzt. Die vorherige Anweisung \DescRef{maincls.cmd.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 +möchten, so können Sie dies beispielsweise mit \begin{lstcode} \ForEachLayerOfPageStyle{...}{\DestroyLayer{#1}} \end{lstcode} @@ -1656,30 +1665,30 @@ wurden, beim automatischen Entfernen dieses Interfaces mit zu entfernen.% \EndIndexGroup \EndIndexGroup -\LoadCommonFile{headfootheight}% \section{Höhe von Kopf und Fuß} +\LoadCommonFile{headfootheight}% \section{Höhe von Kopf und Fuß} \LoadCommonFile{pagestylemanipulation}% \section{Beeinflussung der Inhalte von Seitenstilen} -\section{Definition und Verwaltung von Schnittstellen für Endanwender} +\section{Definition und Verwaltung von Schnittstellen für Endanwender} \seclabel{enduserinterfaces} Das Paket \Package{scrlayer} stellt eine experimentelle Benutzerschnittstelle -zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren -und verwalten zu können. \iffree{% Umbruchvarianten - Möglicherweise wird diese Schnittstelle langfristig wieder aus +zur Verfügung um (konkurrierende) Schnittstellen für Endanwender definieren +und verwalten zu können. \iffree{% Umbruchvarianten + Möglicherweise wird diese Schnittstelle langfristig wieder aus \Package{scrlayer} verschwinden und dann stattdessen von \Package{scrbase} - übernommen werden. }{}% + übernommen werden. }{}% Derzeit ist die Schnittstelle aber noch hoch experimentell\iffree{% Umbruchvariante - und wird daher von eigenen Befehlen innerhalb von \Package{scrlayer} nur für + und wird daher von eigenen Befehlen innerhalb von \Package{scrlayer} nur für Unterpakete von \Package{scrlayer} bereit gestellt}{}% . Es empfiehlt sich beim aktuellen Entwicklungsstand 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 er +Dieser Abschnitt beschreibt lediglich die Schnittstellen"=Anweisungen für die +Definition einer Endanwender-Schnittstelle. Für Endanwender selbst ist er 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 @@ -1697,11 +1706,11 @@ 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 -- weggelassen, so wird dafür -\PValue{\Macro{@currname}.\Macro{@currext}} verwendet. Für Klassen und +stehen. Daher wird sie hier auch zuerst erklärt. Wird das optionale Argument +-- einschließlich der eckigen Klammern -- weggelassen, 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} +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.% \EndIndexGroup @@ -1722,47 +1731,47 @@ kann mit \Macro{scrlayerAddToInterface} erfolgen. Das optionale Argument \PName{Schnittstellen-Name} entspricht hier dem Namen, der mit \DescRef{\LabelBase.cmd.scrlayerInitInterface} zuvor registriert wurde. -Werden\textnote{Achtung!} Anweisungen nicht nur während des Ladens einer +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. +\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 + 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 \emph{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 + einem Zeichen der Kategorie \emph{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 +ausgeführt. Innerhalb von \PName{Code} kann der \PName{Befehl} dann beispielsweise mit Hilfe von \Macro{newcommand} definiert werden. Wann aber kann ein \PName{Befehl}\textnote{definierbare Befehle} 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 auch die +für eine andere Endanwender-Schnittstelle registriert \emph{und} wurde auch die \KOMAScript-Option \Option{autoremoveinterfaces} aktiviert, so wird diese andere Endanwender-Schnittstelle automatisch entfernt, der \PName{Befehl} auf -\Macro{relax} gesetzt und für die angegebene neue Endanwender-Schnittstelle +\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 +\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 +allen anderen Fällen ist er jedoch nicht definierbar, also insbesondere, falls er bereits definiert ist und die \KOMAScript-Optionen \Option{autoremoveinterfaces} und \Option{forceoverwrite} deaktiviert sind. -Die Anweisung \Macro{scrlayerAddCsToInterface} arbeitet ganz ähnlich der +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.}.% + \emph{letter}, \emph{other} oder \emph{space} führen.}.% % \EndIndexGroup @@ -1771,16 +1780,16 @@ als erstes Argument keinen \PName{Befehl}, sondern eine \Macro{scrlayerOnAutoRemoveInterface}\OParameter{Schnittstellen-Name} \Parameter{Code} \end{Declaration} -Für den Fall, dass die Endanwender-Schnittstelle mit dem angegebenen +Für den Fall, dass die Endanwender-Schnittstelle mit dem angegebenen \PName{Schnittstellen-Name} automatisch entfernt wird (siehe \KOMAScript-Option \DescRef{\LabelBase.option.autoremoveinterfaces} zuvor in -diesem Abschnitt) kann zusätzlich \PName{Code} ausgeführt werden. Dies kann +diesem Abschnitt) kann zusätzlich \PName{Code} ausgeführt werden. Dies kann beispielsweise verwendet werden, um Ebenen oder Seitenstile automatisch mit zu vernichten (siehe \DescRef{\LabelBase.cmd.DestroyLayer}, \DescRef{\LabelBase.cmd.DestroyPageStyleAlias}, and \DescRef{\LabelBase.cmd.DestroyRealLayerPageStyle}), die auf Befehlen der -Endanwender-Schnittstelle beruhen. Bezüglich der Voreinstellung für das -optionale Argument sei auf die Erklärung zu +Endanwender-Schnittstelle beruhen. Bezüglich der Voreinstellung für das +optionale Argument sei auf die Erklärung zu \DescRef{\LabelBase.cmd.scrlayerInitInterface} verwiesen.% \EndIndexGroup % @@ -1790,7 +1799,7 @@ optionale Argument sei auf die Erklärung zu %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: @@ -1798,8 +1807,8 @@ optionale Argument sei auf die Erklärung zu % LocalWords: Vordergrundebene Sternvariante Gleitseiten Hintergrundebenen -% LocalWords: Ausgabebeschränkungen Grafikausgabe Textausgabe Textebenen -% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile überhoch +% LocalWords: Ausgabebeschränkungen Grafikausgabe Textausgabe Textebenen +% LocalWords: Standardgrundlinie Grafikebenen Standardtextzeile überhoch % LocalWords: Platzierungsbefehle Ebeneneigenschaft Satzspiegelkonstruktion -% LocalWords: Kreisschlagen Buchseitenkanon spätmittelalterlichen +% LocalWords: Kreisschlagen Buchseitenkanon spätmittelalterlichen % LocalWords: Makronamen diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlfile.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlfile.tex index 75c52600bf..3f1b293a7d 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlfile.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlfile.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlfile.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,94 +40,94 @@ % % ---------------------------------------------------------------------------- % -% Kapitel über scrlfile in der KOMA-Script-Anleitung +% Kapitel über scrlfile in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrlfile.tex}% - [$Date: 2018-02-16 04:42:17 +0100 (Fri, 16 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlfile)] -\chapter{Paketabhängigkeiten mit \Package{scrlfile} +\chapter{Paketabhängigkeiten mit \Package{scrlfile} beherrschen} \labelbase{scrlfile} \BeginIndexGroup \BeginIndex{Package}{scrlfile} -Die Einführung von \LaTeXe{} brachte 1994 eine Menge Neuerungen im Umgang mit +Die Einführung von \LaTeXe{} brachte 1994 eine Menge Neuerungen im Umgang mit \LaTeX-Erweiterungen. So stehen dem Paketautor heute eine ganze Reihe von -Befehlen zur Verfügung, um festzustellen, ob ein anderes Paket oder eine +Befehlen zur Verfügung, um festzustellen, ob ein anderes Paket oder eine bestimmte Klasse verwendet wird und ob dabei bestimmte Optionen zur Anwendung kommen. Der Paketautor kann selbst andere Pakete laden oder diesen Optionen -mit auf den Weg geben für den Fall, dass sie später noch geladen werden. Es -bestand daher die Hoffnung, dass es künftig unerheblich wäre, in welcher +mit auf den Weg geben für den Fall, dass sie später noch geladen werden. Es +bestand daher die Hoffnung, dass es künftig unerheblich wäre, in welcher Reihenfolge Pakete geladen werden. Diese Hoffnung hat sich leider nicht -erfüllt. +erfüllt. -\section{Die Sache mit den Paketabhängigkeiten} +\section{Die Sache mit den Paketabhängigkeiten} \seclabel{dependency} %\begin{Explain} - Immer häufiger definieren unterschiedliche Pakete den gleichen + Immer häufiger definieren unterschiedliche Pakete den gleichen Befehl neu oder um. Dabei ist es dann sehr entscheidend, in welcher - Reihenfolge die Pakete geladen werden. Manchmal ist das für den - Anwender kaum zu überschauen. Teilweise ist es auch + Reihenfolge die Pakete geladen werden. Manchmal ist das für den + Anwender kaum zu überschauen. Teilweise ist es auch notwendig, in irgendeiner Form auf das Laden eines anderen Pakets zu reagieren. Nehmen wir als einfaches Beispiel das Laden des \Package{longtable}-Pakets bei Verwendung von \KOMAScript{}. Das \Package{longtable}-Paket definiert seine eigene Form von - Tabellenüberschriften. Diese passen perfekt zu den - Standardklassen. Sie passen aber überhaupt - nicht zu den Voreinstellungen für die Tabellenüberschriften von + Tabellenüberschriften. Diese passen perfekt zu den + Standardklassen. Sie passen aber überhaupt + nicht zu den Voreinstellungen für die Tabellenüberschriften von \KOMAScript{} und reagieren auch nicht auf die entsprechenden - Möglichkeiten der Konfiguration. Um dieses Problem zu lösen, müssen - die Befehle von \Package{longtable}, die für die - Tabellenüberschriften zuständig sind, von \KOMAScript{} umdefiniert + Möglichkeiten der Konfiguration. Um dieses Problem zu lösen, müssen + die Befehle von \Package{longtable}, die für die + Tabellenüberschriften zuständig sind, von \KOMAScript{} umdefiniert werden. Allerdings sind die \KOMAScript{}-Klassen bereits abgearbeitet, wenn das Paket geladen wird. - Bisher bestand die einzige Möglichkeit, dieses Problem zu lösen + Bisher bestand die einzige Möglichkeit, dieses Problem zu lösen darin, die Umdefinierung mit Hilfe von \Macro{AtBeginDocument} auf - einen späteren Zeitpunkt zu verschieben. Will der Anwender die + einen späteren Zeitpunkt zu verschieben. Will der Anwender die entsprechende Anweisung jedoch selbst umdefinieren, so sollte er - dies eigentlich ebenfalls in der Präambel tun. Das kann er jedoch - nicht, weil \KOMAScript{} ihm dabei in die Quere kommt. Er müsste + dies eigentlich ebenfalls in der Präambel tun. Das kann er jedoch + nicht, weil \KOMAScript{} ihm dabei in die Quere kommt. Er müsste die Umdefinierung also ebenfalls mit Hilfe von - \Macro{AtBeginDocument} durchführen. + \Macro{AtBeginDocument} durchführen. - Aber eigentlich müsste \KOMAScript{} die Abarbeitung gar nicht auf + Aber eigentlich müsste \KOMAScript{} die Abarbeitung gar nicht auf den Zeitpunkt von \Macro{begin}\PParameter{document} verschieben. Es - würde genügen, wenn sie bis unmittelbar nach dem Laden von - \Package{longtable} verzögert werden könnte. Leider fehlen + würde genügen, wenn sie bis unmittelbar nach dem Laden von + \Package{longtable} verzögert werden könnte. Leider fehlen entsprechende Anweisungen im \LaTeX-Kern. Das Paket \Package{scrlfile} bringt hier Abhilfe. - Ebenso wäre es denkbar, dass man vor dem Laden eines bestimmten + Ebenso wäre es denkbar, dass man vor dem Laden eines bestimmten Pakets gerne die Bedeutung eines Makros in einem Hilfsmakro retten und nach dem Laden des Pakets wieder restaurieren will. Auch das geht mit \Package{scrlfile}. - Die Anwendung von \Package{scrlfile} ist nicht auf die Abhängigkeit - von Paketen beschränkt. Auch Abhängigkeiten von anderen Dateien - können berücksichtigt werden. So kann beispielsweise dafür gesorgt + Die Anwendung von \Package{scrlfile} ist nicht auf die Abhängigkeit + von Paketen beschränkt. Auch Abhängigkeiten von anderen Dateien + können berücksichtigt werden. So kann beispielsweise dafür gesorgt werden, dass das nicht unkritische Laden einer Datei wie - \File{french.ldf} automatisch zu einer Warnung führt. + \File{french.ldf} automatisch zu einer Warnung führt. - Obwohl das Paket in erster Linie für andere Paketautoren interessant - sein dürfte, gibt es durchaus auch Anwendungen für normale - \LaTeX-Benutzer. Deshalb sind in diesem Kapitel auch für beide - Gruppen Beispiele aufgeführt. + Obwohl das Paket in erster Linie für andere Paketautoren interessant + sein dürfte, gibt es durchaus auch Anwendungen für normale + \LaTeX-Benutzer. Deshalb sind in diesem Kapitel auch für beide + Gruppen Beispiele aufgeführt. %\end{Explain} \section{Aktionen vor und nach dem Laden} \seclabel{macros} -Mit \Package{scrlfile} können vor und nach dem Laden von Dateien Aktionen -ausgelöst werden. Bei den dazu verwendeten Befehlen wird zwischen allgemeinen +Mit \Package{scrlfile} können vor und nach dem Laden von Dateien Aktionen +ausgelöst werden. Bei den dazu verwendeten Befehlen wird zwischen allgemeinen Dateien, Klassen und Paketen unterschieden. @@ -135,24 +135,24 @@ Dateien, Klassen und Paketen unterschieden. \Macro{BeforeFile}\Parameter{Datei}\Parameter{Anweisungen} \Macro{AfterFile}\Parameter{Datei}\Parameter{Anweisungen} \end{Declaration}% -Mit Hilfe von \Macro{BeforeFile} kann dafür gesorgt werden, dass die -\PName{Anweisungen} vor dem nächsten Laden einer bestimmten \PName{Datei} -ausgeführt werden. Vergleichbar arbeitet \Macro{AfterFile}. Nur werden die +Mit Hilfe von \Macro{BeforeFile} kann dafür gesorgt werden, dass die +\PName{Anweisungen} vor dem nächsten Laden einer bestimmten \PName{Datei} +ausgeführt werden. Vergleichbar arbeitet \Macro{AfterFile}. Nur werden die \PName{Anweisungen} hier erst nach dem Laden der \PName{Datei} -ausgeführt. Wird die Datei nie geladen, so werden die \PName{Anweisungen} in -beiden Fällen natürlich auch nie ausgeführt. Bei \PName{Datei} sind etwaige +ausgeführt. Wird die Datei nie geladen, so werden die \PName{Anweisungen} in +beiden Fällen natürlich auch nie ausgeführt. Bei \PName{Datei} sind etwaige Dateiendungen wie bei \Macro{input} als Teil des Dateinamens anzugeben. -Um die Funktionalität bereitstellen zu können, bedient sich \Package{scrlfile} +Um die Funktionalität bereitstellen zu können, bedient sich \Package{scrlfile} der bekannten \LaTeX-Anweisung \Macro{InputIfFileExists}. Diese\textnote{Achtung!} wird hierzu umdefiniert. Falls die Anweisung nicht die erwartete Definition hat, gibt -\Package{scrlfile} eine Warnung aus. Dies geschieht für den Fall, dass die -Anweisung in späteren \LaTeX-Versionen geändert wird oder bereits von einem +\Package{scrlfile} eine Warnung aus. Dies geschieht für den Fall, dass die +Anweisung in späteren \LaTeX-Versionen geändert wird oder bereits von einem anderen Paket umdefiniert wurde. Die Anweisung \Macro{InputIfFileExists} wird von \LaTeX{} immer verwendet, -wenn eine Datei geladen werden soll. Dies geschieht unabhängig davon, ob die +wenn eine Datei geladen werden soll. Dies geschieht unabhängig davon, ob die Datei mit \Macro{LoadClass}, \Macro{documentclass}, \Macro{usepackage}, \Macro{RequirePackage}, \Macro{include} oder vergleichbaren Anweisungen geladen wird. Lediglich @@ -160,7 +160,7 @@ geladen wird. Lediglich \begin{lstcode} \input foo \end{lstcode} -lädt die Datei \texttt{foo} ohne Verwendung von \Macro{InputIfFileExists}. Sie +lädt die Datei \texttt{foo} ohne Verwendung von \Macro{InputIfFileExists}. Sie sollten daher stattdessen immer % Umbruchkorrektur: listings korrigieren \begin{lstcode} @@ -178,7 +178,7 @@ verwenden. Beachten Sie die Klammern um den Dateinamen!% Diese beiden Befehle arbeiten vergleichbar zu \DescRef{\LabelBase.cmd.BeforeFile} mit dem einen Unterschied, dass die \PName{Klasse} beziehungsweise das \PName{Paket} mit seinem Namen und nicht mit seinem Dateinamen angegeben wird. Die Endungen -»\File{.cls}« und »\File{.sty}« entfallen hier also.% +»\File{.cls}« und »\File{.sty}« entfallen hier also.% % \EndIndexGroup @@ -199,43 +199,43 @@ Die Anweisungen \Macro{AfterClass} und \Macro{AfterPackage} arbeiten weitgehend wie \DescRef{\LabelBase.cmd.AfterFile}, mit dem winzigen Unterschied, dass die \PName{Klasse} beziehungsweise das \PName{Paket} mit seinem Namen und nicht mit seinem Dateinamen angegeben wird. Die Endungen -»\File{.cls}« und »\File{.sty}« entfallen hier also. +»\File{.cls}« und »\File{.sty}« entfallen hier also. Bei\important[i]{\Macro{AfterClass*}\\\Macro{AfterPackage*}} den -Sternvarianten gibt es eine zusätzliche Funktionalität. Wurde oder wird die +Sternvarianten gibt es eine zusätzliche Funktionalität. Wurde oder wird die entsprechende Klasse oder das entsprechende Paket bereits geladen, so werden -die \PName{Anweisungen} nicht nach dem nächsten Laden, sondern unmittelbar -ausgeführt. +die \PName{Anweisungen} nicht nach dem nächsten Laden, sondern unmittelbar +ausgeführt. Bei\important[i]{\Macro{AfterClass+}\\\Macro{AfterPackage+}} der Plusvariante\ChangedAt{v3.09}{\Package{scrlfile}} werden die -\PName{Anweisungen} sicher erst dann ausgeführt, wenn die Klasse oder das -Paket vollständig geladen wurde. Der Unterschied zwischen der Stern- und der -Plusvariante kommt nur zum Tragen, falls die Anweisung verwendet wird, während +\PName{Anweisungen} sicher erst dann ausgeführt, wenn die Klasse oder das +Paket vollständig geladen wurde. Der Unterschied zwischen der Stern- und der +Plusvariante kommt nur zum Tragen, falls die Anweisung verwendet wird, während das Laden der Klassen bzw. des Pakets zwar bereits begonnen hat, aber noch nicht beendet wurde. Wenn das Laden der Klasse bzw. des Pakets noch nicht -abgeschlossen wurde, werden die \PName{Anweisungen} in allen Fällen vor den in +abgeschlossen wurde, werden die \PName{Anweisungen} in allen Fällen vor den in der Klasse bzw. dem Paket mit \Macro{AtEndOfClass} oder \Macro{AtEndOfPackage} -verzögerten Anweisungen ausgeführt. +verzögerten Anweisungen ausgeführt. -Um\important[i]{\Macro{AfterClass!}\\\Macro{AfterPackage!}} eine Ausführung +Um\important[i]{\Macro{AfterClass!}\\\Macro{AfterPackage!}} eine Ausführung nach den in der Klasse oder dem Paket selbst mit \Macro{AtEndOfClass} oder -\Macro{AtEndOfPackage} verzögerten Anweisungen sicherzustellen, ist die +\Macro{AtEndOfPackage} verzögerten Anweisungen sicherzustellen, ist die Variante mit Ausrufezeichen\ChangedAt{v3.09}{\Package{scrlfile}} zu verwenden. Bei dieser Spielart werden die \PName{Anweisungen} nicht mehr im -Kontext der angegebenen Klasse oder des angegebenen Pakets ausgeführt. +Kontext der angegebenen Klasse oder des angegebenen Pakets ausgeführt. Will\important[i]{\Macro{AfterAtEndOfClass}\\\Macro{AfterAtEndOfPackage}} man -nur für den Fall, dass die Klasse bzw. das Paket noch nicht geladen wurde, +nur für den Fall, dass die Klasse bzw. das Paket noch nicht geladen wurde, erreichen, dass \PName{Anweisungen} nach der Klasse bzw. dem Paket und -außerhalb des Kontextes der angegebenen Klasse bzw. des angegebenen Pakets -ausgeführt werden, so verwendet man für Klassen die Anweisung +außerhalb des Kontextes der angegebenen Klasse bzw. des angegebenen Pakets +ausgeführt werden, so verwendet man für Klassen die Anweisung \Macro{AfterAtEndOfClass}\ChangedAt{v3.09}{\Package{scrlfile}} -und für Pakete \Macro{AfterAtEndOfPackage}.% +und für Pakete \Macro{AfterAtEndOfPackage}.% % \begin{Example} - Als Beispiel für Paket- oder Klassenautoren will ich zunächst - erklären, wie \KOMAScript{} selbst Gebrauch von den neuen + Als Beispiel für Paket- oder Klassenautoren will ich zunächst + erklären, wie \KOMAScript{} selbst Gebrauch von den neuen Anweisungen macht. Dazu findet sich beispielsweise in \Class{scrbook} Folgendes: \begin{lstcode} @@ -257,10 +257,10 @@ und für Pakete \Macro{AfterAtEndOfPackage}.% \Class{scrbook} in einer Weise um, die mit neueren Versionen von \KOMAScript{} nicht mehr funktioniert. Neuere Versionen von \Package{hyperref} unterlassen dies, wenn sie eine neuere Version - von \KOMAScript{} erkennen. Für den Fall, dass \Package{hyperref} - zu einem späteren Zeitpunkt geladen wird, sorgt also \Class{scrbook} - dafür, dass unmittelbar nach dem Laden des Pakets überprüft wird, ob - es sich um eine verträgliche Version handelt. Falls dies nicht der + von \KOMAScript{} erkennen. Für den Fall, dass \Package{hyperref} + zu einem späteren Zeitpunkt geladen wird, sorgt also \Class{scrbook} + dafür, dass unmittelbar nach dem Laden des Pakets überprüft wird, ob + es sich um eine verträgliche Version handelt. Falls dies nicht der Fall ist, wird eine Warnung ausgegeben. An anderer Stelle findet sich in drei der \KOMAScript-Klassen Folgendes: @@ -271,29 +271,29 @@ und für Pakete \Macro{AfterAtEndOfPackage}.% Nach dem Laden von \Package{caption2} und nur falls das Paket geladen wird, wird hier die \KOMAScript{} eigene Anweisung \DescRef{maincls.cmd.setcapindent} umdefiniert. Der Inhalt der Umdefinierung - ist für dieses Beispiel unerheblich. Es sei nur erwähnt, dass - \Package{caption2} die Kontrolle über die - \DescRef{maincls.cmd.caption}-Anweisung übernimmt und daher die normale + ist für dieses Beispiel unerheblich. Es sei nur erwähnt, dass + \Package{caption2} die Kontrolle über die + \DescRef{maincls.cmd.caption}-Anweisung übernimmt und daher die normale Definition von \DescRef{maincls.cmd.setcapindent} keinerlei Wirkung mehr - hätte. Die Umdefinierung verbessert dann die Zusammenarbeit mit + hätte. Die Umdefinierung verbessert dann die Zusammenarbeit mit \Package{caption2}. - Es gibt aber auch Beispiele für den sinnvollen Einsatz der neuen + Es gibt aber auch Beispiele für den sinnvollen Einsatz der neuen Anweisungen durch normale Anwender. Angenommen, Sie erstellen ein Dokument, aus dem sowohl eine PS-Datei mit \LaTeX{} und dvips als auch eine PDF-Datei mit \mbox{pdf\LaTeX} erstellt werden soll. Das Dokument soll - außerdem Hyperlinks aufweisen. Im Tabellenverzeichnis haben Sie - Einträge, die über mehrere Zeilen gehen. Nun gibt es zwar mit + außerdem Hyperlinks aufweisen. Im Tabellenverzeichnis haben Sie + Einträge, die über mehrere Zeilen gehen. Nun gibt es zwar mit \mbox{pdf\LaTeX} bei der PDF-Ausgabe keine Probleme, da dort Links - umbrochen werden können. Bei Verwendung des - \Package{hyperref}-Treibers für dvips oder + umbrochen werden können. Bei Verwendung des + \Package{hyperref}-Treibers für dvips oder \mbox{hyper\TeX} ist dies jedoch nicht - möglich. In diesem Fall hätten Sie gerne, dass bei + möglich. In diesem Fall hätten Sie gerne, dass bei \Package{hyperref} die Einstellung \Option{linktocpage} verwendet wird. Die Entscheidung, welcher Treiber geladen wird, wird von \Package{hyperref} automatisch getroffen. - Alles weitere kann nun \DescRef{\LabelBase.cmd.AfterFile} überlassen werden: + Alles weitere kann nun \DescRef{\LabelBase.cmd.AfterFile} überlassen werden: \begin{lstcode}[moretexcs={hypersetup}] \documentclass{article} \usepackage[ngerman]{babel} @@ -314,7 +314,7 @@ und für Pakete \Macro{AfterAtEndOfPackage}.% \end{document} \end{lstcode} Egal, ob nun der \Package{hyperref}-Treiber \Option{hypertex} oder - \Option{dvips} zu Anwendung kommt, wird die dann nützliche Einstellung + \Option{dvips} zu Anwendung kommt, wird die dann nützliche Einstellung \Option{linktocpage} verwendet. Wenn Sie jedoch mit \mbox{pdf\LaTeX} eine PDF-Datei erstellen, wird darauf verzichtet, da dann der \Package{hyperref}-Treiber \File{hpdftex.def} verwendet wird. Das bedeutet, @@ -322,16 +322,16 @@ und für Pakete \Macro{AfterAtEndOfPackage}.% geladen wird. \end{Example} \iffalse% Umbruchkorrekturtext (der besser nicht mehr verwendet wird!) -Übrigens\textnote{Tipp!} können Sie das Laden von \Package{scrlfile} und die +Ãœbrigens\textnote{Tipp!} können Sie das Laden von \Package{scrlfile} und die obigen Anweisungen \DescRef{\LabelBase.cmd.AfterFile} auch in Ihre private -\File{hyperref.cfg} (siehe oben) einfügen. Verwenden Sie dabei jedoch zum +\File{hyperref.cfg} (siehe oben) einfügen. Verwenden Sie dabei jedoch zum Laden des Pakets besser \Macro{RequirePackage} anstelle von -\Macro{usepackage} (siehe \cite{latex:clsguide}). Die neuen Zeilen müssen in +\Macro{usepackage} (siehe \cite{latex:clsguide}). Die neuen Zeilen müssen in obigem Beispiel unmittelbar nach der \Macro{ProvidesFile}-Zeile, also -unbedingt vor der Ausführung der Optionen \Option{dvips} oder \Option{pdftex}, -eingefügt werden.% +unbedingt vor der Ausführung der Optionen \Option{dvips} oder \Option{pdftex}, +eingefügt werden.% \fi% -Übrigens\textnote{Tipp!} kann \Package{scrlfile} auch bereits vor +Ãœbrigens\textnote{Tipp!} kann \Package{scrlfile} auch bereits vor \DescRef{maincls.cmd.documentclass}\IndexCmd{documentclass} geladen werden. In diesem Fall ist allerdings \Macro{RequirePackage}\IndexCmd{RequirePackage} anstelle von \DescRef{maincls.cmd.usepackage} zu verwenden (siehe @@ -343,12 +343,12 @@ anstelle von \DescRef{maincls.cmd.usepackage} zu verwenden (siehe \Macro{BeforeClosingMainAux}\Parameter{Anweisungen} \Macro{AfterReadingMainAux}\Parameter{Anweisungen} \end{Declaration} -Diese Anweisungen unterscheiden sich in einem Detail von den zuvor erklärten -Anweisungen. Jene ermöglichen Aktionen vor und nach dem Laden von -Dateien. Das ist hier nicht der Fall. Paketautoren haben des Öfteren das +Diese Anweisungen unterscheiden sich in einem Detail von den zuvor erklärten +Anweisungen. Jene ermöglichen Aktionen vor und nach dem Laden von +Dateien. Das ist hier nicht der Fall. Paketautoren haben des Öfteren das Problem, dass sie Anweisungen in die \File{aux}-Datei schreiben wollen, nachdem die letzte Seite des Dokuments ausgegeben wurde. Dazu wird -- in -Unkenntnis der dadurch verursachten Probleme -- häufig Code +Unkenntnis der dadurch verursachten Probleme -- häufig Code wie der folgende eingesetzt: \begin{lstcode}[escapechar=\$] \AtEndDocument{%$\textnote{Nicht nachmachen!}$ @@ -359,14 +359,14 @@ wie der folgende eingesetzt: \fi } \end{lstcode} -Dies ist jedoch keine wirkliche Lösung. Wurde die letzte -Seite vor \Macro{end}\PParameter{document} bereits ausgegeben, so führt obiges -zu keiner Ausgabe in die \File{aux}-Datei. Würde man zur Lösung dieses -Problems nun ein \Macro{immediate} vor \Macro{write} setzen, so hätte man das +Dies ist jedoch keine wirkliche Lösung. Wurde die letzte +Seite vor \Macro{end}\PParameter{document} bereits ausgegeben, so führt obiges +zu keiner Ausgabe in die \File{aux}-Datei. Würde man zur Lösung dieses +Problems nun ein \Macro{immediate} vor \Macro{write} setzen, so hätte man das umgekehrte Problem: wurde die letzte Seite bei \Macro{end}\PParameter{document} noch nicht ausgegeben, so wird -\Macro{writethistoaux} zu früh in die \File{aux}-Datei geschrieben. Man sieht -daher häufig auch Lösungsversuche wie: +\Macro{writethistoaux} zu früh in die \File{aux}-Datei geschrieben. Man sieht +daher häufig auch Lösungsversuche wie: \begin{lstcode}[escapechar=\$] \AtEndDocument{%$\textnote{Nicht nachmachen!}$ \if@filesw @@ -377,7 +377,7 @@ daher häufig auch Lösungsversuche wie: \fi } \end{lstcode} -Diese Lösung hat jedoch den Nachteil, dass damit die Ausgabe der letzten Seite +Diese Lösung hat jedoch den Nachteil, dass damit die Ausgabe der letzten Seite erzwungen wird. Eine Anweisung wie \begin{lstcode} \AtEndDocument{% @@ -387,15 +387,15 @@ erzwungen wird. Eine Anweisung wie \par } \end{lstcode} -führt dann nicht mehr dazu, dass der Hinweis am Ende der letzten Seite des -Dokuments ausgegeben wird, sie würde stattdessen am Ende der nächsten Seite -ausgegeben. Gleichzeitig würde \Macro{writethistoaux} wieder eine Seite zu -früh in die \File{aux}-Datei geschrieben. +führt dann nicht mehr dazu, dass der Hinweis am Ende der letzten Seite des +Dokuments ausgegeben wird, sie würde stattdessen am Ende der nächsten Seite +ausgegeben. Gleichzeitig würde \Macro{writethistoaux} wieder eine Seite zu +früh in die \File{aux}-Datei geschrieben. -Die beste Lösung des Problems wäre nun, wenn man unmittelbar in die -\File{aux}-Datei schreiben könnte, nachdem das finale +Die beste Lösung des Problems wäre nun, wenn man unmittelbar in die +\File{aux}-Datei schreiben könnte, nachdem das finale \DescRef{maincls.cmd.clearpage} innerhalb von \Macro{end}\PParameter{document} -ausgeführt, aber bevor die \File{aux}-Datei geschlossen wird. Dies ist das +ausgeführt, aber bevor die \File{aux}-Datei geschlossen wird. Dies ist das Ziel von \Macro{BeforeClosingMainAux}: \begin{lstcode} \BeforeClosingMainAux{% @@ -407,25 +407,25 @@ Ziel von \Macro{BeforeClosingMainAux}: } \end{lstcode} Das ist auch dann erfolgreich, wenn das finale \DescRef{maincls.cmd.clearpage} -innerhalb von \Macro{end}\PParameter{document} tatsächlich zu keiner Ausgabe -einer Seite mehr führt oder wenn -- sei es korrekt verwendet oder in -Unkenntnis der oben erläuterten Probleme -- \DescRef{maincls.cmd.clearpage} +innerhalb von \Macro{end}\PParameter{document} tatsächlich zu keiner Ausgabe +einer Seite mehr führt oder wenn -- sei es korrekt verwendet oder in +Unkenntnis der oben erläuterten Probleme -- \DescRef{maincls.cmd.clearpage} innerhalb einer \Macro{AtEndDocument}-Anweisung zum Einsatz kam. -Es gibt jedoch für \Macro{BeforeClosingMainAux} eine Einschränkung: Im +Es gibt jedoch für \Macro{BeforeClosingMainAux} eine Einschränkung: Im Argument \PName{Anweisungen} sollte keine Satzanweisung verwendet -werden. Es darf also mit \Macro{BeforeClosingMainAux} kein zusätzliches -Material gesetzt werden! Wird diese Einschränkung nicht beachtet, so ist das +werden. Es darf also mit \Macro{BeforeClosingMainAux} kein zusätzliches +Material gesetzt werden! Wird diese Einschränkung nicht beachtet, so ist das Ergebnis ebenso unvorhersehbarer wie bei den gezeigten Problemen mit \Macro{AtEndDocument}. Die Anweisung \Macro{AfterReadingMainAux}\ChangedAt{v3.03}{\Package{scrlfile}} -führt sogar \PName{Anweisungen} nach dem Schließen und Einlesen der +führt sogar \PName{Anweisungen} nach dem Schließen und Einlesen der \File{aux}-Datei innerhalb von \Macro{end}\PParameter{document} aus. Dies ist -nur in einigen wenigen, sehr seltenen Fällen sinnvoll, beispielsweise, wenn +nur in einigen wenigen, sehr seltenen Fällen sinnvoll, beispielsweise, wenn man statistische Informationen in die \File{log}-Datei schreiben will, die -erst nach dem Einlesen der \File{aux}-Datei gültig sind, oder zur -Implementierung zusätzlicher \emph{Rerun}-Aufforderungen. Satzanweisungen sind +erst nach dem Einlesen der \File{aux}-Datei gültig sind, oder zur +Implementierung zusätzlicher \emph{Rerun}-Aufforderungen. Satzanweisungen sind an dieser Stelle noch kritischer zu betrachten als bei \Macro{BeforeClosingMainAux}.% % @@ -435,17 +435,17 @@ an dieser Stelle noch kritischer zu betrachten als bei \section{Dateien beim Einlesen ersetzen} \seclabel{replace} -In den bisherigen Abschnitten wurden Anweisungen erklärt, mit denen es möglich +In den bisherigen Abschnitten wurden Anweisungen erklärt, mit denen es möglich ist, vor oder nach dem Einlesen einer bestimmten Datei, eines bestimmten -Pakets oder einer Klasse Aktionen auszuführen. Es ist mit \Package{scrlfile} -aber auch möglich, eine ganz andere Datei als die angeforderte einzulesen. +Pakets oder einer Klasse Aktionen auszuführen. Es ist mit \Package{scrlfile} +aber auch möglich, eine ganz andere Datei als die angeforderte einzulesen. \begin{Declaration} \Macro{ReplaceInput}\Parameter{Dateiname}\Parameter{Ersatzdatei} \end{Declaration} Mit\ChangedAt{v2.96}{\Package{scrlfile}} dieser Anweisung wird eine Ersetzung der Datei mit dem als erstes angegebenen \PName{Dateiname} definiert. Wenn -\LaTeX{} anschließend angewiesen wird, diese Datei zu laden, wird stattdessen +\LaTeX{} anschließend angewiesen wird, diese Datei zu laden, wird stattdessen \PName{Ersatzdatei} geladen. Die Definition der Ersatzdatei wirkt sich auf alle Dateien aus, die vom Anwender oder intern von \LaTeX{} mit Hilfe von \Macro{InputIfFileExists} geladen werden. Dazu ist es allerdings erforderlich, @@ -457,7 +457,7 @@ dass \Package{scrlfile} diese Anweisung umdefiniert. \begin{lstcode} \ReplaceInput{\jobname.aux}{\jobname.xua} \end{lstcode} - Wenn Sie nun zusätzlich \File{\Macro{jobname}.xua} auch noch durch + Wenn Sie nun zusätzlich \File{\Macro{jobname}.xua} auch noch durch \File{\Macro{jobname}.uxa} ersetzen: \begin{lstcode} \ReplaceInput{\jobname.xua}{\jobname.uxa} @@ -471,14 +471,14 @@ dass \Package{scrlfile} diese Anweisung umdefiniert. \ReplaceInput{\jobname.aux}{\jobname.xua} \ReplaceInput{\jobname.xua}{\jobname.aux} \end{lstcode} - würde jedoch zu einem \emph{stack size error} führen. Es ist also nicht - möglich, eine einmal ersetzte Datei wieder durch ihren Ursprung zu ersetzen. + würde jedoch zu einem \emph{stack size error} führen. Es ist also nicht + möglich, eine einmal ersetzte Datei wieder durch ihren Ursprung zu ersetzen. \end{Example} -Theoretisch wäre es auch möglich, auf diesem Wege ein Paket durch ein anderes -oder eine Klasse durch eine andere zu ersetzen. Dabei würde \LaTeX{} aber +Theoretisch wäre es auch möglich, auf diesem Wege ein Paket durch ein anderes +oder eine Klasse durch eine andere zu ersetzen. Dabei würde \LaTeX{} aber erkennen, dass die angeforderten Dateinamen nicht zum Namen des Pakets oder -der Klasse passen. Eine Lösung dieses Problems finden Sie nachfolgend. +der Klasse passen. Eine Lösung dieses Problems finden Sie nachfolgend. % \EndIndexGroup @@ -488,10 +488,10 @@ der Klasse passen. Eine Lösung dieses Problems finden Sie nachfolgend. \Macro{ReplacePackage}\Parameter{Paket}\Parameter{Ersatzpaket} \end{Declaration} Eine\ChangedAt{v2.96}{\Package{scrlfile}}\textnote{Achtung!} Klasse oder ein -Paket sollte niemals mit Hilfe der oben erklärten Anweisung -\DescRef{\LabelBase.cmd.ReplaceInput} ersetzt werden. In diesem Fall würde -\LaTeX{} eine Warnung über nicht übereinstimmende Klassen- oder Paketnamen -melden. Auch echte Fehler sind möglich, wenn eine Klasse oder ein Paket unter +Paket sollte niemals mit Hilfe der oben erklärten Anweisung +\DescRef{\LabelBase.cmd.ReplaceInput} ersetzt werden. In diesem Fall würde +\LaTeX{} eine Warnung über nicht übereinstimmende Klassen- oder Paketnamen +melden. Auch echte Fehler sind möglich, wenn eine Klasse oder ein Paket unter einem falschen Dateinamen geladen wird. \begin{Example} Sie ersetzen das Paket \Package{scrpage2} durch dessen offiziellen @@ -505,28 +505,28 @@ einem falschen Dateinamen geladen wird. but the package provides `scrlayer-scrpage'. \end{lstcode} - führen. Für den Anwender wäre diese Warnung mehr als verwirrend, hat er doch - gar nicht \Package{scrlayer-scrpage}, sondern tatsächlich \Package{scrpage2} + führen. Für den Anwender wäre diese Warnung mehr als verwirrend, hat er doch + gar nicht \Package{scrlayer-scrpage}, sondern tatsächlich \Package{scrpage2} angefordert, das jedoch durch \Package{scrlayer-scrpage} ersetzt wurde. \end{Example} -Eine Lösung dieser Probleme besteht nun darin, statt +Eine Lösung dieser Probleme besteht nun darin, statt \DescRef{\LabelBase.cmd.ReplaceInput} eine der Anweisungen \Macro{ReplaceClass} oder \Macro{ReplacePackage} zu verwenden. Es ist zu beachten, dass wie bei \Macro{documentclass} und \Macro{usepackage} der Name der Klasse oder des Pakets und nicht deren kompletter Dateiname anzugeben ist. -Die Ersetzung funktioniert für Klassen, die mit +Die Ersetzung funktioniert für Klassen, die mit \Macro{documentclass}, \Macro{LoadClassWithOptions} oder \Macro{LoadClass} -geladen werden. Für Pakete funktioniert die Ersetzung beim Laden mit +geladen werden. Für Pakete funktioniert die Ersetzung beim Laden mit \Macro{usepackage}, \Macro{RequirePackageWithOptions} und \Macro{RequirePackage}. Es\textnote{Achtung!} ist zu beachten, dass die \PName{Ersatzklasse} oder das \PName{Ersatzpaket} mit denselben Optionen geladen wird, mit denen die -ursprünglich geforderte Klasse oder das ursprünglich geforderte Paket geladen -würden. Wird ein Paket oder eine Klasse durch ein Paket oder eine Klasse -ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den -üblichen Warnungen und Fehlern führen. Es ist jedoch möglich, solche in der +ursprünglich geforderte Klasse oder das ursprünglich geforderte Paket geladen +würden. Wird ein Paket oder eine Klasse durch ein Paket oder eine Klasse +ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den +üblichen Warnungen und Fehlern führen. Es ist jedoch möglich, solche in der \PName{Ersatzklasse} oder dem \PName{Ersatzpaket} fehlenden Optionen per \DescRef{\LabelBase.cmd.BeforeClass} oder \DescRef{\LabelBase.cmd.BeforePackage} neu zu definieren. @@ -547,9 +547,9 @@ ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den }% }% \end{lstcode} - wird diese Option nun für das Paket \Package{newfoo} nachdefiniert. Dadurch - wird vermieden, dass beim Laden des Pakets \Package{oldfoo} ein Fehler über - die im Paket \Package{newfoo} nicht unterstützte Option gemeldet wird. + wird diese Option nun für das Paket \Package{newfoo} nachdefiniert. Dadurch + wird vermieden, dass beim Laden des Pakets \Package{oldfoo} ein Fehler über + die im Paket \Package{newfoo} nicht unterstützte Option gemeldet wird. Existiert hingegen eine Option \Option{newopt}, die anstelle der Option \Option{oldopt} verwendet werden soll, so kann dies ebenfalls erreicht @@ -561,7 +561,7 @@ ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den }% }% \end{lstcode} - Es ist sogar möglich, festzulegen, dass beim Laden des neuen Pakets + Es ist sogar möglich, festzulegen, dass beim Laden des neuen Pakets andere Voreinstellung gelten sollen: \begin{lstcode} \BeforePackage{newfoo}{% @@ -587,7 +587,7 @@ ersetzt, die eine geforderte Option nicht unterstützt, würde das zu den \Macro{BeforePackage} erfolgt. \end{Example} -Damit Klassen ersetzt werden können, ist es natürlich erforderlich +Damit Klassen ersetzt werden können, ist es natürlich erforderlich \Package{scrlfile} vor der Klasse zu laden. Dazu ist \Macro{RequirePackage}\IndexCmd{RequirePackage} anstelle von \DescRef{maincls.cmd.usepackage} zu verwenden (siehe \cite{latex:clsguide}).% @@ -603,7 +603,7 @@ 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 +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 anstelle der Ersatzdatei, des Ersatzpakets oder der Ersatzklasse @@ -615,11 +615,11 @@ geladen wird.% \seclabel{prevent} Gerade\ChangedAt{v3.08}{\Package{scrlfile}} in Klassen und Paketen, die -innerhalb von Firmen oder Instituten verwendet werden, findet man häufig, dass +innerhalb von Firmen oder Instituten verwendet werden, findet man häufig, dass sehr viele Pakete nur deshalb geladen werden, weil die Anwender diese Pakete oft verwenden. Wenn es dann mit einem dieser automatisch geladenen Paketen zu einem Problem kommt, muss man irgendwie das Laden des problematischen Pakets -verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung. +verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung. \begin{Declaration} \Macro{PreventPackageFromLoading}\OParameter{Stattdessencode} @@ -646,7 +646,7 @@ der \PName{Paketliste} zu finden ist. X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\LaTeX{} oder Lua\LaTeX{} setzen. Da beim hierbei empfohlenen Paket \Package{fontspec} ohnehin Latin-Modern voreingestellt ist und das Laden von \Package{fontenc} eher - störend wäre, wollen Sie das Laden beider Pakete verhindern. Sie laden die + störend wäre, wollen Sie das Laden beider Pakete verhindern. Sie laden die Klasse deshalb nun in Ihrem eigenen Dokument wie folgt: \begin{lstcode} \RequirePackage{scrlfile} @@ -662,17 +662,17 @@ Hilfe von \Macro{RequirePackage}\IndexCmd{RequirePackage} erfolgen, da Wird eine leere \PName{Paketliste} angegeben oder wird ein Paket angegeben, das bereits geladen ist, gibt \Macro{PreventPackageFromLoading} eine -Warnung aus, während +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 anstelle des Ladens des Pakets etwas anderes getan werden -soll. Innerhalb des \PName{Stattdessencode}s dürfen jedoch keine anderen +soll. Innerhalb des \PName{Stattdessencode}s dürfen jedoch keine anderen Pakete und keine Dateien geladen werden. Zum Laden eines anderen Pakets siehe \DescRef{\LabelBase.cmd.ReplacePackage} in \autoref{sec:scrlfile.replace} auf \DescPageRef{\LabelBase.cmd.ReplacePackage}. Beachten\textnote{Achtung!} Sie -bitte auch, dass der \PName{Stattdessencode} mehrfach ausgeführt wird, falls +bitte auch, dass der \PName{Stattdessencode} mehrfach ausgeführt wird, falls Sie versuchen, das Paket mehrfach zu laden!% \EndIndexGroup @@ -683,26 +683,26 @@ Sie versuchen, das Paket mehrfach zu laden!% \end{Declaration} \Macro{Anweisung} wird mit \Macro{StorePreventPackageFromLoading}\ChangedAt{v3.08}{\Package{scrlfile}} -als die aktuelle Liste der Pakete definiert, für die das Laden verhindert +als die aktuelle Liste der Pakete definiert, für die das Laden verhindert werden soll. Dagegen setzt \Macro{ResetPreventPackageFromLoading}\ChangedAt{v3.08}{\Package{scrlfile}} -die Liste der Pakete, für die das Laden verhindert werden soll, zurück. Danach -können wieder alle Pakete geladen werden. +die Liste der Pakete, für die das Laden verhindert werden soll, zurück. Danach +können wieder alle Pakete geladen werden. \begin{Example} Angenommen, Sie sind innerhalb eines Pakets unbedingt auf das Laden eines anderen Pakets angewiesen und wollen nicht, dass der Anwender das Laden dieses Pakets mit \DescRef{\LabelBase.cmd.PreventPackageFromLoading}% \IndexCmd{PreventPackageFromLoading} - verhindern kann. Also setzen Sie die Paketliste für die Ausnahmen zuvor - zurück: + verhindern kann. Also setzen Sie die Paketliste für die Ausnahmen zuvor + zurück: \begin{lstcode} \ResetPreventPackageFromLoading \RequirePackage{foo} \end{lstcode} Allerdings hat dies den Nachteil, dass ab diesem Zeitpunkt die komplette Ausnahmeliste des Anwenders verloren ist. Also speichern Sie die Liste - zunächst zwischen und reaktivieren sie später wieder: + zunächst zwischen und reaktivieren sie später wieder: \begin{lstcode} \newcommand*{\Users@PreventList}{}% \StorePreventPackageFromLoading\Users@PreventList @@ -712,21 +712,21 @@ können wieder alle Pakete geladen werden. \end{lstcode} Es ist zu beachten, dass\textnote{Achtung!} \Macro{Users@PreventList} durch die Anweisung \Macro{StorePreventPackageFromLoading} auch definiert - werden würde, wenn diese bereits anderweitig definiert wäre. Eine vorhandene - Definition würde also ohne Rücksicht überschrieben werden. In diesem + werden würde, wenn diese bereits anderweitig definiert wäre. Eine vorhandene + Definition würde also ohne Rücksicht überschrieben werden. In diesem Beispiel wurde deshalb mit einem vorherigen \Macro{newcommand*} sichergestellt, dass in dem Fall zur Sicherheit eine Fehlermeldung ausgegeben wird. \end{Example} 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 +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.% Beachten\textnote{Achtung!} Sie bitte, dass -\Macro{ResetPreventPackageFromLoading} den \PName{Stattdessencode} für ein -Paket nicht löscht, sondern nur vorübergehend dessen Ausführung nicht mehr +\Macro{ResetPreventPackageFromLoading} den \PName{Stattdessencode} für ein +Paket nicht löscht, sondern nur vorübergehend dessen Ausführung nicht mehr erfolgt.% \EndIndexGroup @@ -735,30 +735,30 @@ erfolgt.% \Macro{UnPreventPackageFromLoading}\Parameter{Paketliste} \Macro{UnPreventPackageFromLoading*}\Parameter{Paketliste} \end{Declaration} -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 +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 +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.% +\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: + \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} - Für die Anweisung \Macro{UnPreventPackageFromLoading*} ist es unerheblich, - ob das Paket zuvor überhaupt vom Laden ausgenommen war. + Für die Anweisung \Macro{UnPreventPackageFromLoading*} ist es unerheblich, + ob das Paket zuvor überhaupt vom Laden ausgenommen war. - Natürlich können Sie die Anweisung indirekt auch nutzen, um den - \PName{Stattdessencode} aller Pakete zu löschen: + 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} @@ -766,7 +766,7 @@ einer gespeicherten Liste wiederhergestellt wird, wird dann der \end{lstcode} Die Pakete werden dann zwar noch immer nicht geladen, ihr \PName{Stattdessencode} existiert aber nicht mehr und wird nicht mehr - ausgeführt.% + ausgeführt.% \end{Example}% \EndIndexGroup % @@ -774,6 +774,6 @@ einer gespeicherten Liste wiederhergestellt wird, wird dann der %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2-experts.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2-experts.tex index 45ea423af3..82f6060104 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlttr2-experts.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,9 +18,9 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrlttr2-experts.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % -% Diese Datei ist Teil der KOMA-Script-Sammlung für LaTeX2e. +% Diese Datei ist Teil der KOMA-Script-Sammlung für LaTeX2e. % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -42,113 +42,113 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrlttr2 im Experten-Teil der KOMA-Script-Anleitung +% Kapitel über scrlttr2 im Experten-Teil der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrlttr2-experts.tex}% - [$Date: 2018-04-26 14:55:38 +0200 (Thu, 26 Apr 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (chapter: scrlttr2 for experts)] -\chapter{Zusätzliche Informationen zur +\chapter{Zusätzliche Informationen zur Klasse \Class{scrlttr2} und Paket \Package{scrletter}} \labelbase{scrlttr2-experts} \BeginIndexGroup \BeginIndex{Class}{scrlttr2} In diesem Kapitel finden Sie -zusätzliche Informationen zu der \KOMAScript-Klasse \Class{scrlttr2}. % +zusätzliche Informationen zu der \KOMAScript-Klasse \Class{scrlttr2}. % \iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch \cite{book:komascript} vorbehalten. Dies sollte kein Problem sein, denn der}{Der} % Anwender, der die Klasse einfach nur verwenden will, wird diese Informationen -normalerweise nicht benötigen. Ein Teil der Informationen richtet sich an -Anwender, denen die vordefinierten Möglichkeiten nicht mehr genügen. So -befasst sich beispielsweise der erste Abschnitt ausführlich mit den -Pseudolängen, die den Briefbogen bestimmen und die für Anpassungen an eigene +normalerweise nicht benötigen. Ein Teil der Informationen richtet sich an +Anwender, denen die vordefinierten Möglichkeiten nicht mehr genügen. So +befasst sich beispielsweise der erste Abschnitt ausführlich mit den +Pseudolängen, die den Briefbogen bestimmen und die für Anpassungen an eigene Briefbogenlayouts abweichend zu setzen sind.% \iffalse% Es wird Zeit das komplett rauszuwerfen! -\ Darüber hinaus finden - sich in diesem Kapitel auch Informationen über Möglichkeiten, die aus - Gründen der Verbesserung der Kompatibilität zur obsoleten \KOMAScript-Klasse - \Class{scrlettr} geschaffen wurden. Es wird auch ausführlich erklärt, wie +\ Darüber hinaus finden + sich in diesem Kapitel auch Informationen über Möglichkeiten, die aus + Gründen der Verbesserung der Kompatibilität zur obsoleten \KOMAScript-Klasse + \Class{scrlettr} geschaffen wurden. Es wird auch ausführlich erklärt, wie man einen Brief dieser veralteten Klasse auf die aktuelle Briefklasse - übertragen kann. + übertragen kann. \fi \BeginIndex{Package}{scrletter}% -Darüber hinaus gibt es seit +Darüber hinaus gibt es seit \KOMAScript~3.15\ChangedAt[2014/11]{v3.15}{\Package{scrletter}} das Paket \Package{scrletter}, das zusammen mit einer der \KOMAScript-Klassen \Class{scrartcl}, \Class{scrreprt} oder \Class{scrbook} verwendet werden -kann. Es stellt nahezu die komplette Funktionalität von \Class{scrlttr2} für -die drei genannten Klassen zur Verfügung. Einige wenige Unterschiede gibt es +kann. Es stellt nahezu die komplette Funktionalität von \Class{scrlttr2} für +die drei genannten Klassen zur Verfügung. Einige wenige Unterschiede gibt es jedoch, die ebenfalls in diesem Kapitel genannt werden.% -\section{Pseudolängen für fortgeschrittene Anwender} +\section{Pseudolängen für fortgeschrittene Anwender} \seclabel{pseudoLengths} \BeginIndexGroup -\BeginIndex{}{Pseudolängen} +\BeginIndex{}{Pseudolängen} -\TeX{} arbeitet mit einem festen Satz an Registern. Es gibt Register für -Token, für Boxen, für Zähler, für Abstände (englisch: \emph{skip}) und für -Größen (englisch: \emph{dimension}). Von all diesen Registern gibt es jeweils -256~Stück. Für \LaTeX{}-Längen, die mit \Macro{newlength} angefordert werden, +\TeX{} arbeitet mit einem festen Satz an Registern. Es gibt Register für +Token, für Boxen, für Zähler, für Abstände (englisch: \emph{skip}) und für +Größen (englisch: \emph{dimension}). Von all diesen Registern gibt es jeweils +256~Stück. Für \LaTeX{}-Längen, die mit \Macro{newlength} angefordert werden, werden Abstandsregister belegt. Sind alle diese Register verbraucht, kann man -keine weiteren Längen definieren. Sowohl \Class{scrlttr2} als auch -\Package{scrletter} würden normalerweise allein für die erste Seite mehr als +keine weiteren Längen definieren. Sowohl \Class{scrlttr2} als auch +\Package{scrletter} würden normalerweise allein für die erste Seite mehr als 20 solche Register verbrauchen. \LaTeX{} selbst belegt bereits 40 dieser Register. Das \hyperref[cha:typearea]{\Package{typearea}}% -\IndexPackage{typearea}-Paket benötigt ebenfalls einige, so dass ein Viertel -der kostbaren Register verbraucht wäre. Aus diesem Grund werden -briefspezifische Längen bei \KOMAScript{} eben nicht in Längen, sondern in -Makros abgelegt, den Pseudolängen. Der Nachteil dieses Vorgehens besteht +\IndexPackage{typearea}-Paket benötigt ebenfalls einige, so dass ein Viertel +der kostbaren Register verbraucht wäre. Aus diesem Grund werden +briefspezifische Längen bei \KOMAScript{} 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. +Längen. -Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar +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! +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 -Entscheidung für \Class{scrlttr2} ein wenig zu spät. Bei \Package{scrletter} -wurde das Konzept der Pseudolängen aus Gründen der Kompatibilität übernommen. +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 +Entscheidung für \Class{scrlttr2} ein wenig zu spät. Bei \Package{scrletter} +wurde das Konzept der Pseudolängen aus Gründen der Kompatibilität übernommen. Eine Auf"|listung aller von \KOMAScript{} definierten und verwendeten -Pseudolängen ist \autoref{tab:scrlttr2-experts.pseudoLengths} zu +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 +nähere Erklärungen zu der jeweiligen Pseudolänge zu finden sind.%| \autoref{fig:scrlttr2-experts.pseudoLengths} auf \autopageref{fig:scrlttr2-experts.pseudoLengths} zeigt eine schematische -Darstellung der wichtigsten Abstände auf dem Briefbogen. Dabei sind neben den -Pseudolängen für die veränderbaren Abstände zusätzlich in heller Schrift auch -die Längen angegeben, die für einige, wenige fest programmierte Abstände -verwendet werden. Aus Gründen der Übersichtlichkeit wurde in der Darstellung -auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. +Darstellung der wichtigsten Abstände auf dem Briefbogen. Dabei sind neben den +Pseudolängen für die veränderbaren Abstände zusätzlich in heller Schrift auch +die Längen angegeben, die für einige, wenige fest programmierte Abstände +verwendet werden. Aus Gründen der Ãœbersichtlichkeit wurde in der Darstellung +auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. % \iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!! \begin{desclist} \renewcommand{\abovecaptionskipcorrection}{-\normalbaselineskip}% \desccaption{% - Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen% + Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen% \label{tab:scrlttr2-experts.pseudoLengths}% }{% - Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen + Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen (\emph{Fortsetzung})% }% \pentry{backaddrheight}{% - Höhe der Rücksendeadresse am oberen Rand des Anschriftfeldes + Höhe der Rücksendeadresse am oberen Rand des Anschriftfeldes (\autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.backaddrheight})% }% \pentry{bfoldmarklength}{% - Länge der unteren horizontalen Faltmarke + Länge der unteren horizontalen Faltmarke (\autoref{sec:scrlttr2-experts.foldmarks}, \DescPageRef{scrlttr2-experts.plength.bfoldmarkvpos})% }% @@ -159,24 +159,24 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.bfoldmarkvpos})% }% \pentry{firstfoothpos}{% - Abstand des Brief"|fußes von der linken Kante des Papiers; Werte - größer der Breite oder kleiner der negativen Breite des Papiers werden + 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}, \DescPageRef{scrlttr2-experts.plength.firstfoothpos})%| }% \pentry{firstfootvpos}{% - Abstand des Brief"|fußes von der oberen Kante des Papiers + Abstand des Brief"|fußes von der oberen Kante des Papiers (\autoref{sec:scrlttr2-experts.firstFoot}, \DescPageRef{scrlttr2-experts.plength.firstfootvpos})%| }% \pentry{firstfootwidth}{% - Breite des Brief"|fußes + Breite des Brief"|fußes (\autoref{sec:scrlttr2-experts.firstFoot}, \DescPageRef{scrlttr2-experts.plength.firstfootwidth})%| }% \pentry{firstheadhpos}{% Abstand des Briefkopfes von der linken Kante des Papiers; Werte - größer der Breite oder kleiner der negativen Breite des Papiers werden + größer der Breite oder kleiner der negativen Breite des Papiers werden gesondert behandelt (\autoref{sec:scrlttr2-experts.firstHead}, \DescPageRef{scrlttr2-experts.plength.firstheadhpos})% }%\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!! @@ -208,7 +208,7 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.fromrulethickness})% }% \pentry{fromrulewidth}{% - Länge einer optionalen + Länge einer optionalen \iffalse horizontalen \fi% Umbruchkorrektur Linie im Briefkopf (\autoref{sec:scrlttr2-experts.firstHead}, @@ -220,32 +220,32 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.lfoldmarkhpos})% }% \pentry{lfoldmarklength}{% - Länge der vertikalen Faltmarke + Länge der vertikalen Faltmarke (\autoref{sec:scrlttr2-experts.foldmarks}, \DescPageRef{scrlttr2-experts.plength.lfoldmarklength})% }% \pentry{locheight}{% - Höhe der Absenderergänzung, falls der Wert nicht 0 ist; bei 0 wird + Höhe der Absenderergänzung, falls der Wert nicht 0 ist; bei 0 wird stattdessen \PLength{toaddrheight} verwendet (\autoref{sec:scrlttr2-experts.locationField}, \DescPageRef{scrlttr2-experts.plength.locheight})% }% \pentry{lochpos}{% - Abstand der Absenderergänzung von der rechten Papierkante, falls der Wert - positiv ist, oder negativer Abstand der Absenderergänzung von der linken + Abstand der Absenderergänzung von der rechten Papierkante, falls der Wert + positiv ist, oder negativer Abstand der Absenderergänzung von der linken Papierkante, falls der Wert negativ ist; bei 0 wird stattdessen der negative Wert von \PLength{toaddrhpos} verwendet (\autoref{sec:scrlttr2-experts.locationField}, \DescPageRef{scrlttr2-experts.plength.lochpos})% }% \pentry{locvpos}{% - Abstand der Absenderergänzung von der oberen Papierkante, falls der Wert + Abstand der Absenderergänzung von der oberen Papierkante, falls der Wert nicht 0 ist; bei 0 wird stattdessen \PLength{toaddrvpos} verwendet (\autoref{sec:scrlttr2-experts.locationField}, \DescPageRef{scrlttr2-experts.plength.locvpos})% }% \pentry{locwidth}{% - Breite des Feldes für die Absenderergänzung, wobei bei einem Wert von 0 + Breite des Feldes für die Absenderergänzung, wobei bei einem Wert von 0 die Breite automatisch aufgrund der in \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield} beschriebenen Option \DescRef{scrlttr2.option.locfield} berechnet wird @@ -253,7 +253,7 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.locwidth})% }\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!!% \pentry{mfoldmarklength}{% - Länge der mittleren horizontalen Faltmarke + Länge der mittleren horizontalen Faltmarke (\autoref{sec:scrlttr2-experts.foldmarks}, \DescPageRef{scrlttr2-experts.plength.mfoldmarklength})% }% @@ -264,55 +264,55 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.mfoldmarkvpos})% }% \pentry{pfoldmarklength}{% - Länge der Lochermarke + Länge der Lochermarke (\autoref{sec:scrlttr2-experts.foldmarks}, \DescPageRef{scrlttr2-experts.plength.pfoldmarklength})% }% \pentry{PPdatamatrixvskip}{% - vertikaler Abstand zwischen Port-Payé-Kopf und Data-Matrix bei + vertikaler Abstand zwischen Port-Payé-Kopf und Data-Matrix bei \OptionValueRef{scrlttr2}{addrfield}{PP} (\autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.PPdatamatrixvskip})% }% \pentry{PPheadheight}{% - Höhe für den Port-Payé-Kopf + Höhe für den Port-Payé-Kopf (\autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.PPheadheight})% }% \pentry{PPheadwidth}{% - Breite des linken Port-Payé-Feldes bei + Breite des linken Port-Payé-Feldes bei \OptionValueRef{scrlttr2}{addrfield}{PP} (\autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.PPheadwidth})% }% \pentry{refaftervskip}{% - vertikaler Abstand nach der Geschäftszeile + vertikaler Abstand nach der Geschäftszeile (\autoref{sec:scrlttr2-experts.refLine}, \DescPageRef{scrlttr2-experts.plength.refaftervskip})% }% \pentry{refhpos}{% - Abstand der Geschäftszeile von der linken Papierkante, wobei bei einem + Abstand der Geschäftszeile von der linken Papierkante, wobei bei einem Wert von 0 automatisch relativ zur Papierbreite zentriert wird (\autoref{sec:scrlttr2-experts.refLine}, \DescPageRef{scrlttr2-experts.plength.refhpos})% }% \pentry{refvpos}{% - Abstand der Geschäftszeile von der oberen Kante des Papiers + Abstand der Geschäftszeile von der oberen Kante des Papiers (\autoref{sec:scrlttr2-experts.refLine}, \DescPageRef{scrlttr2-experts.plength.refvpos})% }% \pentry{refwidth}{% - Breite der Geschäftszeile + Breite der Geschäftszeile (\autoref{sec:scrlttr2-experts.refLine}, \DescPageRef{scrlttr2-experts.plength.refwidth})% }% \pentry{sigbeforevskip}{% - vertikaler Abstand zwischen Gruß und Signatur + vertikaler Abstand zwischen Gruß und Signatur (\autoref{sec:scrlttr2-experts.closing}, \DescPageRef{scrlttr2-experts.plength.sigbeforevskip})% }% \pentry{sigindent}{% - Einzug der Signatur gegenüber dem Textkörper + Einzug der Signatur gegenüber dem Textkörper (\autoref{sec:scrlttr2-experts.closing}, \DescPageRef{scrlttr2-experts.plength.sigindent})% }% @@ -332,18 +332,18 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.subjectaftervskip})% }% \pentry{subjectbeforevskip}{% - zusätzlicher vertikaler Abstand vor dem Betreff + zusätzlicher vertikaler Abstand vor dem Betreff (\autoref{sec:scrlttr2-experts.subject}, \DescPageRef{scrlttr2-experts.plength.subjectbeforevskip})% }% \pentry{subjectvpos}{% Abstand des Betreffs von der oberen Kante des Papiers, wobei ein Wert von - 0 stattdessen den Betreff gemäß Option \DescRef{scrlttr2.option.subject} setzt + 0 stattdessen den Betreff gemäß Option \DescRef{scrlttr2.option.subject} setzt (\autoref{sec:scrlttr2-experts.subject}, \DescPageRef{scrlttr2-experts.plength.subjectaftervskip})% }% \pentry{tfoldmarklength}{% - Länge der oberen horizontalen Faltmarke + Länge der oberen horizontalen Faltmarke (\autoref{sec:scrlttr2-experts.foldmarks}, \DescPageRef{scrlttr2-experts.plength.tfoldmarklength})% }% @@ -353,7 +353,7 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \DescPageRef{scrlttr2-experts.plength.tfoldmarkvpos})% }% \pentry{toaddrheight}{% - Höhe des Anschriftfeldes + Höhe des Anschriftfeldes (\autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.toaddrheight})% }% @@ -385,7 +385,7 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \begin{figure} \centering \includegraphics{plenDIN} - \caption{Schematische Darstellung der wichtigsten Pseudolängen für den + \caption{Schematische Darstellung der wichtigsten Pseudolängen für den Briefbogen} \label{fig:scrlttr2-experts.pseudoLengths} \end{figure} @@ -394,8 +394,8 @@ auf einige weniger häufig benötigte Pseudolängen jedoch auch verzichtet. \Macro{newplength}\Parameter{Name} \end{Declaration} Mit\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} Hilfe dieser -Anweisung wird eine neue Pseudolänge definiert. Die neue Pseudolänge ist dann -über ihren \PName{Namen} eindeutig identifiziert. Jeder Name kann also nur +Anweisung wird eine neue Pseudolänge definiert. Die neue Pseudolänge ist dann +über ihren \PName{Namen} eindeutig identifiziert. Jeder Name kann also nur einmal vergeben werden. % \iffalse % Umbruchoptimierungstext @@ -403,77 +403,93 @@ Es wird sichergestellt, dass jeder \PName{Name} nur einmal vergeben wird.% \else \iffalse -Wird versucht, eine bereits vorhandene Pseudolänge erneut +Wird versucht, eine bereits vorhandene Pseudolänge erneut zu definieren, so wird dies mit einer Fehlermeldung quittiert.% \fi % \fi \BeginIndex{Cmd}{@newplength}% -Da der Anwender selbst normalerweise keine eigenen Pseudolängen definieren +Da der Anwender selbst normalerweise keine eigenen Pseudolängen definieren muss, handelte es sich bei diesem Befehl bis \KOMAScript~3.25 um keine Benutzeranweisung. Stattdessen existierte bis dahin nur \Macro{@newplength} -mit derselben Funktionalität. Für Paketautoren existieren diese Anweisungen +mit derselben Funktionalität. Für Paketautoren existieren diese Anweisungen noch immer.% \EndIndexGroup \begin{Declaration} + \Macro{Ifplength}\Parameter{Pseudolänge}% + \Parameter{Dann-Code}\Parameter{Sonst-Code} +\end{Declaration} +Mit\ChangedAt{v3.27}{\Class{scrlttr2}\and \Class{scrletter}} dieser Anweisung +kann geprüft werden, ob eine \PName{Pseudolänge} definiert ist. Ist dies der +Fall, so wird der \PName{Dann-Code} ausgeführt, anderenfalls wird der +\PName{Sonst-Code} ausgeführt.% +\iffree{}{\par% + \BeginIndex{Cmd}{if@plength}% + Ausschließlich aus Konsistenzgründen existiert für Paketautoren auch die + interne Anweisung \Macro{if@plength} mit identischer Bedeutung.% +}% +\EndIndexGroup + + +\begin{Declaration} \Macro{setplength}% - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} \Macro{addtoplength}% - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} \end{Declaration} Mit\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} Hilfe von -\Macro{setplength} kann einer \PName{Pseudolänge} das Vielfache eines +\Macro{setplength} kann einer \PName{Pseudolänge} das Vielfache eines \PName{Wertes} zugewiesen werden. Der \PName{Faktor} wird dabei als optionales -Argument übergeben (siehe auch \DescRef{scrlttr2.cmd.setlengthtoplength}, +Argument übergeben (siehe auch \DescRef{scrlttr2.cmd.setlengthtoplength}, \autoref{sec:scrlttr2.pseudoLength}, \DescPageRef{scrlttr2.cmd.setlengthtoplength}). -Mit \Macro{addtoplength} kann man zu einer \PName{Pseudolänge} das Vielfache +Mit \Macro{addtoplength} kann man zu einer \PName{Pseudolänge} das Vielfache eines \PName{Wertes} addieren. Auch dabei wird der \PName{Faktor} als -optionales Argument übergeben. +optionales Argument übergeben. -Um einer \PName{Pseudolänge} das Vielfache einer anderen Pseudolänge +Um einer \PName{Pseudolänge} das Vielfache einer anderen Pseudolänge zuzuweisen oder zu ihr zu addieren, verwendet man innerhalb von \PName{Wert} die Anweisung \Macro{useplength} (siehe \autoref{sec:scrlttr2.pseudoLength}, -\DescPageRef{scrlttr2.cmd.useplength}). Um von einer \PName{Pseudolänge} -den Wert einer anderen \PName{Pseudolänge} zu subtrahieren, verwendet man +\DescPageRef{scrlttr2.cmd.useplength}). Um von einer \PName{Pseudolänge} +den Wert einer anderen \PName{Pseudolänge} zu subtrahieren, verwendet man gleichzeitig als \PName{Faktor} ein Minuszeichen oder \PValue{-1} oder einen anderen negativen Faktor. \BeginIndex{Cmd}{@setplength}% \BeginIndex{Cmd}{@addtoplength}% -Da der Anwender selbst normalerweise keine Pseudolängen ändern muss, handelte +Da der Anwender selbst normalerweise keine Pseudolängen ändern muss, handelte es sich bis \KOMAScript~3.25 bei diesen Befehlen um keine Benutzeranweisungen. Stattdessen existierten bis dahin nur \Macro{@setplength} und \Macro{@addtoplength} mit derselben -Funktionalität. Für Paketautoren existieren diese Anweisungen noch immer.% +Funktionalität. Für Paketautoren existieren diese Anweisungen noch immer.% \EndIndexGroup \begin{Declaration} \Macro{setplengthtowidth} - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} \Macro{setplengthtoheight} - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} \Macro{setplengthtodepth} - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} \Macro{setplengthtototalheight} - \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} \end{Declaration} Die\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} ersten drei Anweisungen entsprechen im Wesentlichen \Macro{settowidth}, \Macro{settoheight} und \Macro{settodepth} aus dem \LaTeX-Kern, setzen aber -keine Länge, sondern eine \PName{Pseudolänge}. Entsprechend +keine Länge, sondern eine \PName{Pseudolänge}. Entsprechend \DescRef{\LabelBase.cmd.setplength} sind sie ebenfalls um einen optionalen -\PName{Faktor} erweitert. Sie setzen also eine \PName{Pseudolänge} auf die -Breite, Höhe oder Tiefe von \PName{Inhalt} multipliziert mit dem optional -angegebenen \PName{Faktor}. Die zusätzliche Anweisung -\Macro{setplengthtototalheight} setzt die \PName{Pseudolänge} auf die Summe -der Höhe und Tiefe von \PName{Inhalt} multipliziert mit dem optionalen +\PName{Faktor} erweitert. Sie setzen also eine \PName{Pseudolänge} auf die +Breite, Höhe oder Tiefe von \PName{Inhalt} multipliziert mit dem optional +angegebenen \PName{Faktor}. Die zusätzliche Anweisung +\Macro{setplengthtototalheight} setzt die \PName{Pseudolänge} auf die Summe +der Höhe und Tiefe von \PName{Inhalt} multipliziert mit dem optionalen \PName{Faktor}.% \EndIndexGroup @@ -484,10 +500,10 @@ der Höhe und Tiefe von \PName{Inhalt} multipliziert mit dem optionalen \BeginIndex{}{Faltmarke}% Falt- oder Falzmarken sind kleine horizontale Striche am linken und kleine -vertikale Striche am oberen Rand. \KOMAScript{} unterstützt für den Briefbogen +vertikale Striche am oberen Rand. \KOMAScript{} unterstützt für den Briefbogen derzeit drei konfigurierbare horizontale und eine konfigurierbare vertikale Faltmarke. Dazu wird noch eine horizontale Loch- oder Seitenmittenmarke -unterstützt, die nicht in der Vertikalen verschoben werden kann. +unterstützt, die nicht in der Vertikalen verschoben werden kann. \begin{Declaration} @@ -495,40 +511,40 @@ unterstützt, die nicht in der Vertikalen verschoben werden kann. \PLength{mfoldmarkvpos} \PLength{bfoldmarkvpos} \end{Declaration} -\KOMAScript{} kennt für Briefe \Class{scrlttr2} insgesamt drei in der vertikalen +\KOMAScript{} kennt für Briefe \Class{scrlttr2} insgesamt drei in der vertikalen Platzierung konfigurierbare Faltmarken. Die Position der oberen Faltmarke vom -oberen Papierrand wird von der Pseudolänge \PLength{tfoldmarkvpos} -bestimmt. Für die Position der mittleren Faltmarke ist Pseudolänge -\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}, für die unteren -Faltmarke \PLength{bfoldmarkvpos} zuständig. Mit der +oberen Papierrand wird von der Pseudolänge \PLength{tfoldmarkvpos} +bestimmt. Für die Position der mittleren Faltmarke ist Pseudolänge +\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}, für die unteren +Faltmarke \PLength{bfoldmarkvpos} zuständig. Mit der Locher-\Index{Lochermarke} oder Seitenmittenmarke kommt noch eine weitere horizontale Marke dazu. Diese wird jedoch immer in der vertikalen Seitenmitte platziert. \iftrue% Umbruchkorrekturtext! Da ihre vertikale Position also nicht konfigurierbar ist, existiert -auch keine Pseudolänge dafür. +auch keine Pseudolänge dafür. \fi Die\important{Achtung!} obere und untere Faltmarke dienen nicht der exakten Drittelung des Papiers beim Falten. Stattdessen soll das Papier mit ihrer -Hilfe so geknickt werden können, dass das Feld für die Anschrift in einem +Hilfe so geknickt werden können, dass das Feld für die Anschrift in einem Fensterbriefumschlag zu sehen ist. Die Einstellungen sind daher in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}% -\Index{lco-Datei=\File{lco}-Datei} unterschiedlich gewählt. Eine +\Index{lco-Datei=\File{lco}-Datei} unterschiedlich gewählt. Eine Besonderheit\textnote{Achtung!} stellt \Option{DINmtext} dar. Hier wird -zwingend von einem Briefumschlag im Format C6/5 (auch »C6 lang« genannt) +zwingend von einem Briefumschlag im Format C6/5 (auch »C6 lang« genannt) ausgegangen. Briefe, die mit dieser Option erstellt wurden, sind normalerweise -weder für Umschläge im Format C5 noch für Umschläge im Format C4 geeignet. +weder für Umschläge im Format C5 noch für Umschläge im Format C4 geeignet. -Die mittlere Faltmarke wird für abendländische Briefe normalerweise nicht -benötigt. Beispielsweise in Japan gibt es jedoch so unterschiedliche -Briefumschläge, dass eine weitere Faltmarke benötigt wurde (siehe die +Die mittlere Faltmarke wird für abendländische Briefe normalerweise nicht +benötigt. Beispielsweise in Japan gibt es jedoch so unterschiedliche +Briefumschläge, dass eine weitere Faltmarke benötigt wurde (siehe die japanischen \File{lco}-Dateien). An dieser Stelle sei darauf hingewiesen, dass -die Bezeichnungen »obere«, »mittlere« und »untere« Faltmarke lediglich eine -Sprachkonvention darstellen. Tatsächlich ist nicht festgelegt, dass +die Bezeichnungen »obere«, »mittlere« und »untere« Faltmarke lediglich eine +Sprachkonvention darstellen. Tatsächlich ist nicht festgelegt, dass \PLength{tfoldmarkvpos} kleiner als \PLength{mfoldmarkvpos} und dieses kleiner als \PLength{bfoldmarkvpos} sein muss. Ist\textnote{Achtung!} eine der -Pseudolängen hingegen Null, so wird die entsprechende Faltmarke auch dann +Pseudolängen hingegen Null, so wird die entsprechende Faltmarke auch dann nicht gesetzt, wenn sie per Option \DescRef{scrlttr2.option.foldmarks}% \IndexOption{foldmarks~=\PName{Einstellung}}% \important{\DescRef{scrlttr2.option.foldmarks}} (siehe @@ -544,13 +560,13 @@ explizit aktiviert wurde.% \PLength{bfoldmarklength} \PLength{pfoldmarklength} \end{Declaration} -Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} vier Pseudolängen bestimmen die -Länge der vier horizontalen Marken. Dabei gilt eine -Besonderheit. Ist\textnote{Achtung!} die Länge nämlich mit Null angegeben, so -werden bei den Pseudolängen \PLength{tfoldmarklength}, -\PLength{mfoldmarklength} und \PLength{bfoldmarklength} für die drei in der +Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} vier Pseudolängen bestimmen die +Länge der vier horizontalen Marken. Dabei gilt eine +Besonderheit. Ist\textnote{Achtung!} die Länge nämlich mit Null angegeben, so +werden bei den Pseudolängen \PLength{tfoldmarklength}, +\PLength{mfoldmarklength} und \PLength{bfoldmarklength} für die drei in der vertikalen Position konfigurierbaren Faltmarken stattdessen 2\Unit{mm} als -Länge verwendet. Die Länge der Lochermarke, \PLength{pfoldmarklength}, wird +Länge verwendet. Die Länge der Lochermarke, \PLength{pfoldmarklength}, wird hingegen auf 4\Unit{mm} gesetzt.% \EndIndexGroup @@ -558,11 +574,11 @@ hingegen auf 4\Unit{mm} gesetzt.% \begin{Declaration} \PLength{foldmarkhpos} \end{Declaration} -Diese Pseudolänge gibt den Abstand aller horizontalen Faltmarken vom linken +Diese Pseudolänge gibt den Abstand aller horizontalen Faltmarken vom linken Papier\-rand an. Normalerweise sind das 3{,}5\Unit{mm}. Sie\textnote{Tipp!} -können den Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie +können den Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie einen Drucker verwenden, der einen breiteren unbedruckbaren linken Rand -hat. Ob die Faltmarken überhaupt gesetzt werden, hängt außerdem von der Option +hat. Ob die Faltmarken überhaupt gesetzt werden, hängt außerdem von der Option \DescRef{scrlttr2.option.foldmarks}\important{\DescRef{scrlttr2.option.foldmarks}}% \IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.foldmarks}).% @@ -575,32 +591,32 @@ hat. Ob die Faltmarken überhaupt gesetzt werden, hängt außerdem von der Option \end{Declaration} Neben\ChangedAt{v2.97e}{\Class{scrlttr2}} den horizontalen Faltmarken gibt es auch noch eine vertikale Faltmarke. Deren Abstand von der linken Papierkante -wird über die Pseudolänge \PLength{lfoldmarkhpos} bestimmt. Diese Faltmarke -wird beispielsweise bei Briefen für einige japanische Chou- oder You-Umschläge -benötigt, wenn man diese für A4-Papier verwenden will. Auch für Umschläge im -C6-Format kann sie nützlich sein.% +wird über die Pseudolänge \PLength{lfoldmarkhpos} bestimmt. Diese Faltmarke +wird beispielsweise bei Briefen für einige japanische Chou- oder You-Umschläge +benötigt, wenn man diese für A4-Papier verwenden will. Auch für Umschläge im +C6-Format kann sie nützlich sein.% \EndIndexGroup \begin{Declaration} \PLength{lfoldmarklength} \end{Declaration} -Die Pseudolänge \PLength{lfoldmarklength} bestimmt -die\ChangedAt{v2.97e}{\Class{scrlttr2}} Länge der vertikalen +Die Pseudolänge \PLength{lfoldmarklength} bestimmt +die\ChangedAt{v2.97e}{\Class{scrlttr2}} Länge der vertikalen Faltmarke. Auch\textnote{Achtung!} hier gibt es die Besonderheit, dass bei -einer angegebenen Länge von Null stattdessen 4\Unit{mm} verwendet werden.% +einer angegebenen Länge von Null stattdessen 4\Unit{mm} verwendet werden.% \EndIndexGroup \begin{Declaration} \PLength{foldmarkvpos} \end{Declaration} -Die\ChangedAt{v2.97e}{\Class{scrlttr2}} Pseudolänge gibt den Abstand +Die\ChangedAt{v2.97e}{\Class{scrlttr2}} Pseudolänge gibt den Abstand \iffree{aller}{der} vertikalen Faltmarke\iffree{n}{} vom oberen Papier\-rand -an. Normalerweise sind das 3{,}5\Unit{mm}. Sie\textnote{Tipp!} können den -Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie einen +an. Normalerweise sind das 3{,}5\Unit{mm}. Sie\textnote{Tipp!} können den +Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie einen Drucker verwenden, der einen breiteren unbedruckbaren oberen Rand hat. Ob die -Faltmarke\iffree{n}{} überhaupt gesetzt \iffree{werden}{wird}, hängt außerdem +Faltmarke\iffree{n}{} überhaupt gesetzt \iffree{werden}{wird}, hängt außerdem von der Option \DescRef{scrlttr2.option.foldmarks}% \important{\DescRef{scrlttr2.option.foldmarks}}% \IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe @@ -614,10 +630,10 @@ von der Option \DescRef{scrlttr2.option.foldmarks}% \begin{Declaration} \PLength{foldmarkthickness} \end{Declaration} -Diese\ChangedAt{v2.97c}{\Class{scrlttr2}} Pseudolänge gibt die Dicke aller -Faltmarken an. Voreingestellt sind 0,2\Unit{pt}, also eine sehr dünne +Diese\ChangedAt{v2.97c}{\Class{scrlttr2}} Pseudolänge gibt die Dicke aller +Faltmarken an. Voreingestellt sind 0,2\Unit{pt}, also eine sehr dünne Haarlinie. Insbesondere\textnote{Tipp!}, wenn die Farbe der Faltmarken -geändert wird, kann dies zu wenig sein!% +geändert wird, kann dies zu wenig sein!% \EndIndexGroup % \EndIndexGroup @@ -629,16 +645,16 @@ geändert wird, kann dies zu wenig sein!% \BeginIndex{}{Briefkopf}% Unter dem Briefkopf verstehen wir alle Angaben, die den Absender betreffen und -die über der Anschrift stehen. Normalerweise würde man erwarten, dass diese -über den Seitenstil gesetzt werden. Bei der alten Briefklasse \Class{scrlettr} +die über der Anschrift stehen. Normalerweise würde man erwarten, dass diese +über den Seitenstil gesetzt werden. Bei der alten Briefklasse \Class{scrlettr} war dies auch so. Bei\textnote{Achtung!} \Class{scrlttr2} und -\Package{scrletter} wird der Briefkopf jedoch unabhängig vom Seitenstil von +\Package{scrletter} wird der Briefkopf jedoch unabhängig vom Seitenstil von der Anweisung \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ausgegeben. % Fuellmaterial \iftrue% Dabei wird der Briefkopf absolut positioniert, ist also vom Satzspiegel -unabhängig. Die erste Seite eines Briefes, also die Seite mit dem Briefkopf, -wird tatsächlich mit dem Seitenstil +unabhängig. Die erste Seite eines Briefes, also die Seite mit dem Briefkopf, +wird tatsächlich mit dem Seitenstil \DescRef{scrlttr2.pagestyle.empty}\IndexPagestyle{empty} gesetzt.% \fi % Ende des Fuellmaterials @@ -647,7 +663,7 @@ wird tatsächlich mit dem Seitenstil \begin{Declaration} \PLength{firstheadvpos} \end{Declaration} -Die Pseudolänge \PLength{firstheadvpos} gibt den Abstand des Briefkopfes von +Die Pseudolänge \PLength{firstheadvpos} gibt den Abstand des Briefkopfes von der oberen Papierkante an. Der Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} unterschiedlich gesetzt. Ein typischer Wert ist 8\Unit{mm}.% @@ -657,30 +673,30 @@ unterschiedlich gesetzt. Ein typischer Wert ist 8\Unit{mm}.% \begin{Declaration} \PLength{firstheadhpos} \end{Declaration} -Die Pseudolänge \PLength{firstheadhpos}\ChangedAt{v3.05}{\Class{scrlttr2}} +Die Pseudolänge \PLength{firstheadhpos}\ChangedAt{v3.05}{\Class{scrlttr2}} gibt bei einem positiven Wert den Abstand des Briefkopfes von der linken -Papierkante an. Ist\textnote{Achtung!} der Wert sogar größer oder gleich der +Papierkante an. Ist\textnote{Achtung!} der Wert sogar größer oder gleich der Breite des Papiers, \Length{paperwidth}\important{\Length{paperwidth}}\IndexLength{paperwidth}, so wird der Briefkopf horizontal zentriert auf dem Briefbogen platziert. Ein negativer Wert gibt den Abstand des Briefkopfes von der rechten Papierkante an. Ist der Wert jedoch kleiner oder gleich der negativen Breite des Papiers, -so wird der Briefkopf bündig zum linken Rand des Satzspiegels platziert. +so wird der Briefkopf bündig zum linken Rand des Satzspiegels platziert. Voreingestellt\textnote{Achtung!} ist typischerweise ein Wert von -\Length{maxdimen}\IndexLength{maxdimen}, also der größtmögliche Wert für eine -Länge. Die Folge ist eine horizontale Zentrierung.% +\Length{maxdimen}\IndexLength{maxdimen}, also der größtmögliche Wert für eine +Länge. Die Folge ist eine horizontale Zentrierung.% \EndIndexGroup \begin{Declaration} \PLength{firstheadwidth} \end{Declaration} -Die Pseudolänge \PLength{firstheadwidth} gibt die Breite des Briefkopfes +Die Pseudolänge \PLength{firstheadwidth} gibt die Breite des Briefkopfes an. Der Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} -unterschiedlich gesetzt. Während er normalerweise von der Papierbreite und dem -horizontalen Abstand der Empfängeradresse vom linken Papierrand abhängt, +unterschiedlich gesetzt. Während er normalerweise von der Papierbreite und dem +horizontalen Abstand der Empfängeradresse vom linken Papierrand abhängt, entspricht er bei \Option{KOMAold} der Breite des Satzspiegels und ist bei \Option{NF} fest auf 170\Unit{mm} eingestellt.% \EndIndexGroup @@ -693,9 +709,9 @@ entspricht er bei \Option{KOMAold} der Breite des Satzspiegels und ist bei Wie bereits bei Option \DescRef{scrlttr2.option.fromrule}\IndexOption{fromrule} in \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.fromrule} -erwähnt wurde, kann in den vordefinierten Briefköpfen eine Linie im oder unter -dem Absender gesetzt werden. Hat\textnote{Achtung!} die Pseudolänge -\PLength{fromrulewidth} die Länge 0, so wird dabei die Länge dieser Linie +erwähnt wurde, kann in den vordefinierten Briefköpfen eine Linie im oder unter +dem Absender gesetzt werden. Hat\textnote{Achtung!} die Pseudolänge +\PLength{fromrulewidth} die Länge 0, so wird dabei die Länge dieser Linie automatisch bestimmt. Dies ist die Voreinstellung bei den vordefinierten \File{lco}-Dateien. % \iffalse % Umbruchkorrekturtext @@ -704,7 +720,7 @@ Der Wert kann mit \DescRef{\LabelBase.cmd.setplength} (siehe aber auch abweichend gesetzt werden. % \fi% Die voreingestellte Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, -\PLength{fromrulethickness}, der Linie beträgt 0,4\Unit{pt}.% +\PLength{fromrulethickness}, der Linie beträgt 0,4\Unit{pt}.% \EndIndexGroup % \EndIndexGroup @@ -717,17 +733,17 @@ Die voreingestellte Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, % Verschiedene Umbruchvarianten Unter der Anschrift versteht man normalerweise nur den Namen und die Adresse -des Empfängers. % +des Empfängers. % \iffalse% Als \iffree{erste }{}Erweiterung zur Anschrift kann die Versandart betrachtet werden, die etwa bei \iffree{Einschreiben oder -}{}Infobriefen zur Anwendung kommt. Bei Fensterbriefumschlägen wird auch die -sogenannte Rücksendeadresse \iffree{zur Anschrift}{dazu} gezählt, da sie im +}{}Infobriefen zur Anwendung kommt. Bei Fensterbriefumschlägen wird auch die +sogenannte Rücksendeadresse \iffree{zur Anschrift}{dazu} gezählt, da sie im Anschriftfenster zu sehen \iffree{sein wird}{ist}. Die Anschrift folgt unmittelbar auf den Briefkopf.% \else% Aber auch die Versandart, beispielsweise bei Infobriefen, oder die -Rücksendeadresse werden als Teil des Anschriftfeldes gesetzt.% +Rücksendeadresse werden als Teil des Anschriftfeldes gesetzt.% \fi @@ -735,11 +751,11 @@ Rücksendeadresse werden als Teil des Anschriftfeldes gesetzt.% \PLength{toaddrvpos} \PLength{toaddrhpos} \end{Declaration} -Diese Pseudolängen geben den Abstand des Anschriftfensters eines +Diese Pseudolängen geben den Abstand des Anschriftfensters eines Fensterbriefumschlags vom oberen und vom linken Rand des Papiers an. Sie werden in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} -unterschiedlich eingestellt. Für \PLength{toaddrhpos} gilt außerdem eine +unterschiedlich eingestellt. Für \PLength{toaddrhpos} gilt außerdem eine Besonderheit. Ist\textnote{Achtung!} der Wert \iffree{}{wie bei \Option{SN} oder \Option{NF} }negativ, so ist sein Betrag der Abstand des Anschriftfeldes vom rechten Rand des Papiers. % @@ -749,9 +765,9 @@ Anschriftfeldes vom rechten Rand des Papiers. % \Option{DINmtext}. Hier kann es schnell passieren, dass der Briefkopf in das Anschriftfenster ragt.% }{% - Große Briefköpfe\textnote{Achtung!} können bei kleinem \PLength{toaddrvpos}, + Große Briefköpfe\textnote{Achtung!} können bei kleinem \PLength{toaddrvpos}, beispielsweise bei \Option{DINmtext}, bis in das Anschriftfeld ragen.% -} Ob das Anschriftfenster überhaupt gesetzt wird, hängt von der Option +} Ob das Anschriftfenster überhaupt gesetzt wird, hängt von der Option \Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}).% \EndIndexGroup @@ -760,9 +776,9 @@ Anschriftfeldes vom rechten Rand des Papiers. % \begin{Declaration} \PLength{toaddrheight} \end{Declaration} -Diese Pseudolänge gibt die Höhe des Anschriftfeldes einschließlich der -Versandart an. Ob Name und Adresse des Empfängers unter Berücksichtigung der -Versandart im Anschriftfeld vertikal zentriert werden hängt von Option +Diese Pseudolänge gibt die Höhe des Anschriftfeldes einschließlich der +Versandart an. Ob Name und Adresse des Empfängers unter Berücksichtigung der +Versandart im Anschriftfeld vertikal zentriert werden hängt von Option \DescRef{scrlttr2.option.addrfield} ab.% \EndIndexGroup @@ -770,7 +786,7 @@ Versandart im Anschriftfeld vertikal zentriert werden hängt von Option \begin{Declaration} \PLength{toaddrwidth} \end{Declaration} -Diese Pseudolänge gibt die Breite des Anschriftfensters an. Diese wird in den +Diese Pseudolänge gibt die Breite des Anschriftfensters an. Diese wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} entsprechend der unterschiedlichen Normen unterschiedlich @@ -780,7 +796,7 @@ eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und 100\Unit{mm}. Angenommen, Sie haben das Problem, dass Ihr Drucker einen \iffree{sehr breiten }{}unbedruckbaren rechten \iffree{oder linken }{}Rand von 15\Unit{mm} besitzt. Dadurch kann bei Option \Option{SN} der Briefkopf, die - Absenderergänzung und die Anschrift nicht komplett gedruckt werden. Sie + Absenderergänzung und die Anschrift nicht komplett gedruckt werden. Sie erstellen daher eine neue \iffree{\File{lco}-Datei mit folgendem Inhalt}{Datei \File{SNmmarg.lco}, die Sie anstelle von \Option{SN} verwenden}: \begin{lstcode} @@ -794,10 +810,10 @@ eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und 100\Unit{mm}. \useplength{toaddrhpos}} \endinput \end{lstcode}% - \iffree{ Bis Sie sich einen Drucker mit kleineren Rändern zugelegt haben, + \iffree{ Bis Sie sich einen Drucker mit kleineren Rändern zugelegt haben, verwenden Sie \Option{SNmmarg} anstelle von \Option{SN}.}{}% Umbruchoptimierung -\end{Example}\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung +\end{Example}\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung % \EndIndexGroup @@ -807,8 +823,8 @@ eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und 100\Unit{mm}. \end{Declaration} Manchmal will man, dass die Anschrift nicht am linken Rand des Anschriftfensters beginnt und bis zum rechten Rand des Fensters reicht, -sondern ein wenig eingezogen wird. Der Wert dieses Einzugs kann über die -Pseudolänge \PLength{toaddrindent} festgelegt werden. Typischerweise ist +sondern ein wenig eingezogen wird. Der Wert dieses Einzugs kann über die +Pseudolänge \PLength{toaddrindent} festgelegt werden. Typischerweise ist dieser Wert jedoch 0\Unit{pt}. Bei\textnote{Achtung!} jeder der @@ -824,10 +840,10 @@ Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}} \IndexOption{addrfield~=\textKValue{backgroundimage}} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) wird beim Wert 0\Unit{pt} -stattdessen ein Einzug von 8\Unit{mm} verwendet. Soll hier tatsächlich kein -Einzug verwendet werden, so kann mit 1\Unit{sp} ein vernachlässigbar kleiner +stattdessen ein Einzug von 8\Unit{mm} verwendet. Soll hier tatsächlich kein +Einzug verwendet werden, so kann mit 1\Unit{sp} ein vernachlässigbar kleiner Einzug gesetzt werden. Des Weiteren wird \PLength{toaddrindent} bei den -genannten Einstellungen für \Option{addrfield} auch für den Abstand zum +genannten Einstellungen für \Option{addrfield} auch für den Abstand zum rechten Rand des Anschriftfensters verwendet.% \EndIndexGroup @@ -835,18 +851,18 @@ rechten Rand des Anschriftfensters verwendet.% \begin{Declaration} \PLength{backaddrheight} \end{Declaration} -Bei Fensterbriefumschlägen wird der Absender häufig in einer kleinen Schrift -einzeilig über der Empfängeradresse ausgegeben. Diese Absenderangabe nennt man -Rücksendeadresse\textnote{Rücksendeadresse}% -\Index{Ruecksendeadresse=Rücksendeadresse}, da sie \iffree{im Anschriftfenster - sichtbar ist und }{}der Post bei unzustellbaren Briefen für die Rücksendung +Bei Fensterbriefumschlägen wird der Absender häufig in einer kleinen Schrift +einzeilig über der Empfängeradresse ausgegeben. Diese Absenderangabe nennt man +Rücksendeadresse\textnote{Rücksendeadresse}% +\Index{Ruecksendeadresse=Rücksendeadresse}, da sie \iffree{im Anschriftfenster + sichtbar ist und }{}der Post bei unzustellbaren Briefen für die Rücksendung an den Absender dient. In dieser Adresse muss daher auch nur die Information -enthalten sein, die zur Rücksendung notwendig ist. +enthalten sein, die zur Rücksendung notwendig ist. -Die Höhe, die innerhalb des Anschriftfensters für die Rücksendeadresse zur -Verfügung steht, ist in der Pseudolänge \PLength{backaddrheight} abgelegt. Der +Die Höhe, die innerhalb des Anschriftfensters für die Rücksendeadresse zur +Verfügung steht, ist in der Pseudolänge \PLength{backaddrheight} abgelegt. Der Wert wird in den vordefinierten \File{lco}-Dateien typischerweise auf -5\Unit{mm} eingestellt. Ob die Rücksendeadresse überhaupt gesetzt wird, +5\Unit{mm} eingestellt. Ob die Rücksendeadresse überhaupt gesetzt wird, bestimmt der Anwender mit den Optionen \Option{addrfield} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) und \DescRef{scrlttr2.option.backaddress} (siehe \autoref{sec:scrlttr2.firstpage}, @@ -858,14 +874,14 @@ bestimmt der Anwender mit den Optionen \Option{addrfield} (siehe \PLength{specialmailindent} \PLength{specialmailrightindent} \end{Declaration} -Zwischen Rücksendeadresse und Empfängeradresse kann noch eine optionale +Zwischen Rücksendeadresse und Empfängeradresse kann noch eine optionale Versandart\Index{Versandart} gesetzt werden\iffree{. Diese wird genau dann gesetzt}{}, wenn die Variable \DescRef{scrlttr2.variable.specialmail} einen -Inhalt hat. Die Ausrichtung wird mit Hilfe der Pseudolängen +Inhalt hat. Die Ausrichtung wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und \PLength{specialmailrightindent} festgelegt. Diese geben den linken und rechten Einzug der Zeile an. In den vordefinierten \File{lco}-Dateien ist \PLength{specialmailindent} auf den -dehnbaren Wert \Macro{fill} gesetzt, während \PLength{specialmailrightindent} +dehnbaren Wert \Macro{fill} gesetzt, während \PLength{specialmailrightindent} auf 1\Unit{em} eingestellt ist. Damit wird die Versandart 1\Unit{em} vom rechten Rand des Anschriftfensters gesetzt.% \EndIndexGroup @@ -875,26 +891,26 @@ rechten Rand des Anschriftfensters gesetzt.% \PLength{PPheadheight} \PLength{PPheadwidth} \end{Declaration} -Die Pseudolänge \PLength{PPheadheight} gibt bei den beiden +Die Pseudolänge \PLength{PPheadheight} gibt bei den beiden Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}} \OptionValueRef{scrlttr2}{addrfield}{PP}\important{% \OptionValueRef{scrlttr2}{addrfield}{PP}\\ \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}}% \IndexOption{addrfield~=\textKValue{PP}} und \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}% -\IndexOption{addrfield~=\textKValue{backgroundimage}} die Höhe an, die am Anfang -des Adressfeldes für den Port-Payé-Kopf reserviert wird. Die Pseudolänge +\IndexOption{addrfield~=\textKValue{backgroundimage}} die Höhe an, die am Anfang +des Adressfeldes für den Port-Payé-Kopf reserviert wird. Die Pseudolänge \PLength{PPheadwidth} wird nur bei \OptionValueRef{scrlttr2}{addrfield}{PP} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) verwendet und gibt die Breite des -linken Feldes des Port-Payé-Kopf mit dem P.\,P.-Logo, der Postleitzahl und dem -Ort an. Die Breite des rechten Feldes mit dem Code für den Absender und der -Priorität ist durch die Restbreite bestimmt. - -Den\textnote{Achtung!} normalerweise voreingestellten Wert von 0\Unit{mm} für -Pseudolänge \PLength{PPheadheight} ändert \KOMAScript{} selbstständig in -20,74\Unit{pt}. Den normalerweise voreingestellten Wert von 0\Unit{mm} für -\PLength{PPheadwidth} ändert \KOMAScript{} selbstständig in 42\Unit{mm}.% +linken Feldes des Port-Payé-Kopf mit dem P.\,P.-Logo, der Postleitzahl und dem +Ort an. Die Breite des rechten Feldes mit dem Code für den Absender und der +Priorität ist durch die Restbreite bestimmt. + +Den\textnote{Achtung!} normalerweise voreingestellten Wert von 0\Unit{mm} für +Pseudolänge \PLength{PPheadheight} ändert \KOMAScript{} selbstständig in +20,74\Unit{pt}. Den normalerweise voreingestellten Wert von 0\Unit{mm} für +\PLength{PPheadwidth} ändert \KOMAScript{} selbstständig in 42\Unit{mm}.% % \EndIndexGroup @@ -902,35 +918,35 @@ Pseudolänge \PLength{PPheadheight} ändert \KOMAScript{} selbstständig in \begin{Declaration} \PLength{PPdatamatrixvskip} \end{Declaration} -Durch\ChangedAt{v3.03}{\Class{scrlttr2}} diese Pseudolänge wird der vertikale -Abstand zwischen dem Port-Payé-Kopf und der Data-Matrix bei +Durch\ChangedAt{v3.03}{\Class{scrlttr2}} diese Pseudolänge wird der vertikale +Abstand zwischen dem Port-Payé-Kopf und der Data-Matrix bei \OptionValueRef{scrlttr2}{addrfield}{PP}% \important{\OptionValueRef{scrlttr2}{addrfield}{PP}}% \IndexOption{addrfield~=\textKValue{PP}} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.addrfield}) festgelegt. Den\textnote{Achtung!} normalerweise voreingestellten Wert von -0\Unit{mm} ändert \KOMAScript{} selbstständig in 9\Unit{mm}. Die Data-Matrix -wird rechtsbündig zum Port-Payé-Kopf gesetzt.% +0\Unit{mm} ändert \KOMAScript{} selbstständig in 9\Unit{mm}. Die Data-Matrix +wird rechtsbündig zum Port-Payé-Kopf gesetzt.% \EndIndexGroup % \EndIndexGroup -\subsection{Absenderergänzungen} +\subsection{Absenderergänzungen} \seclabel{locationField} \BeginIndexGroup -\BeginIndex{}{Absenderergaenzung=Absenderergänzung}% +\BeginIndex{}{Absenderergaenzung=Absenderergänzung}% \iffalse% Umbruchvarianten -Insbesondere bei Geschäftsbriefen reicht der Platz im Briefkopf und im -Seitenfuß oftmals nicht aus, um alle Angaben des Absenders unterzubringen. Für -die zusätzlichen Informationen kann der Platz neben der Anschrift -genutzt werden. In dieser Anleitung wird dieses Feld \emph{Absenderergänzung} +Insbesondere bei Geschäftsbriefen reicht der Platz im Briefkopf und im +Seitenfuß oftmals nicht aus, um alle Angaben des Absenders unterzubringen. Für +die zusätzlichen Informationen kann der Platz neben der Anschrift +genutzt werden. In dieser Anleitung wird dieses Feld \emph{Absenderergänzung} genannt.% \else% -Reicht der Raum in Briefkopf und Seitenfuß nicht aus, um alle Angaben zum +Reicht der Raum in Briefkopf und Seitenfuß nicht aus, um alle Angaben zum Absender unterzubringen, kann der Platz neben der Anschrift als -\emph{Absenderergänzung} genutzt werden.% +\emph{Absenderergänzung} genutzt werden.% \fi @@ -940,10 +956,10 @@ Absender unterzubringen, kann der Platz neben der Anschrift als \PLength{locvpos} \PLength{locwidth} \end{Declaration} -Die Pseudolängen \PLength{locwidth} und +Die Pseudolängen \PLength{locwidth} und \PLength{locheight}\ChangedAt{v2.97d}{\Class{scrlttr2}} geben die Breite und -Höhe der Absenderergänzung an. Die Pseudolängen \PLength{lochpos} und -\PLength{locvpos} geben die Abstände von der rechten, oberen +Höhe der Absenderergänzung an. Die Pseudolängen \PLength{lochpos} und +\PLength{locvpos} geben die Abstände von der rechten, oberen Papierkante an. Die Werte werden in den vordefinierten \File{lco}-Dateien typischerweise auf 0\Unit{pt} gesetzt. Dieser\textnote{Achtung!} Wert nimmt eine Sonderstellung ein. Er bedeutet, dass die Werte erst bei @@ -953,7 +969,7 @@ Anschriftfensters von der linken, oberen Papierkante und Option \DescRef{scrlttr2.option.locfield} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.locfield}) gesetzt werden. Wie\textnote{Achtung!} bei \PLength{toaddrhpos} nehmen -negative Werte für \PLength{lochpos} eine Sonderstellung ein. Es wird dann +negative Werte für \PLength{lochpos} eine Sonderstellung ein. Es wird dann statt des Abstandes vom rechten Papierrand der Betrag von \PLength{lochpos} als Abstand vom linken Papierrand verwendet. Die Bedeutung ist also genau umgekehrt zu der bei \PLength{toaddrhpos} (siehe @@ -964,20 +980,20 @@ umgekehrt zu der bei \PLength{toaddrhpos} (siehe \EndIndexGroup -\subsection{Geschäftszeile} +\subsection{Geschäftszeile} \seclabel{refLine}% \BeginIndexGroup -\BeginIndex{}{Geschaeftszeile=Geschäftszeile}% +\BeginIndex{}{Geschaeftszeile=Geschäftszeile}% -Die Geschäftszeile kann auch länger als eine Zeile sein. Sie wird nur gesetzt, -wenn mindestens eine der Variablen für die Geschäftszeile nicht leer ist. Es +Die Geschäftszeile kann auch länger als eine Zeile sein. Sie wird nur gesetzt, +wenn mindestens eine der Variablen für die Geschäftszeile nicht leer ist. Es werden nur nicht leere Felder gesetzt. Um\textnote{Tipp!} ein scheinbar leeres Feld zu setzen, kann man einen scheinbar leeren Variableninhalt wie -\Macro{mbox}\Parameter{} verwenden. Wird auf die Geschäftszeile verzichtet, so +\Macro{mbox}\Parameter{} verwenden. Wird auf die Geschäftszeile verzichtet, so werden an ihrer Stelle Bezeichnung und Inhalt der Variablen \DescRef{scrlttr2.variable.date} ausgegeben. % \iffalse% Umbruchoptimierung -Informationen, wie Variablen zur Geschäftszeile hinzugefügt oder entfernt +Informationen, wie Variablen zur Geschäftszeile hinzugefügt oder entfernt werden, sind in \autoref{sec:scrlttr2-experts.variables}, \DescPageRef{scrlttr2-experts.cmd.removereffields} zu finden.% \fi @@ -986,7 +1002,7 @@ werden, sind in \autoref{sec:scrlttr2-experts.variables}, \begin{Declaration} \PLength{refvpos} \end{Declaration} -Diese Pseudolänge gibt den Abstand der Geschäftszeile von der Oberkante des +Diese Pseudolänge gibt den Abstand der Geschäftszeile von der Oberkante des Papiers an. Ihr Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} unterschiedlich eingestellt. % \iffalse% @@ -999,17 +1015,17 @@ Typische Werte liegen zwischen 80{,}5\Unit{mm} und 98{,}5\Unit{mm}.% \PLength{refwidth} \PLength{refhpos} \end{Declaration} -Die Pseudolänge \PLength{refwidth} gibt die Breite an, die für die -Geschäftszeile zur Verfügung steht. Ihr Wert wird in den vordefinierten +Die Pseudolänge \PLength{refwidth} gibt die Breite an, die für die +Geschäftszeile zur Verfügung steht. Ihr Wert wird in den vordefinierten \File{lco}-Dateien typischerweise auf 0\Unit{pt} gesetzt. Dieser\textnote{Achtung!} Wert hat eine besondere Bedeutung. % \iffalse% Umbruchoptimierung -Es wird damit keineswegs festgelegt, dass für die Geschäftszeile keine Breite -zur Verfügung steht. Vielmehr bedeutet der Wert% +Es wird damit keineswegs festgelegt, dass für die Geschäftszeile keine Breite +zur Verfügung steht. Vielmehr bedeutet der Wert% \else% Damit wird festgelegt% \fi% -, dass die verfügbare Breite erst innerhalb von +, dass die verfügbare Breite erst innerhalb von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} ermittelt wird. Die% \iffalse% Umbruchoptimierung \ dort ermittelte % @@ -1023,26 +1039,26 @@ Breite richtet sich \iffree{dann }{}nach der Einstellung der Option \DescPageRef{scrlttr2.option.refline}). Gleichzeitig wird dann auch \PLength{refhpos} entsprechend der Option gesetzt. Bei \OptionValueRef{scrlttr2}{refline}{wide}% -\IndexOption{refline~=\textKValue{wide}} wird die Geschäftszeile zentriert, +\IndexOption{refline~=\textKValue{wide}} wird die Geschäftszeile zentriert, wohingegen sie bei \OptionValueRef{scrlttr2}{refline}{narrow}% \IndexOption{refline~=\textKValue{narrow}} am Satzspiegel links ausgerichtet wird. Ist \PLength{refwidth} von Null verschieden, wird die Breite der -Geschäftszeile also nicht von der Option \DescRef{scrlttr2.option.refline} -bestimmt, so gibt \PLength{refhpos} den Abstand der Geschäftszeile von der +Geschäftszeile also nicht von der Option \DescRef{scrlttr2.option.refline} +bestimmt, so gibt \PLength{refhpos} den Abstand der Geschäftszeile von der linken Papierkante an. Ist\textnote{Achtung!} dieser Abstand Null, so wird die -Geschäftszeile so ausgerichtet, dass das Verhältnis zwischen ihrem Abstand von +Geschäftszeile so ausgerichtet, dass das Verhältnis zwischen ihrem Abstand von der linken Papierkante zu ihrem Abstand von der rechten Papierkante dem -Verhältnis zwischen dem Abstand des Satzspiegels von der linken Papierkante zu +Verhältnis zwischen dem Abstand des Satzspiegels von der linken Papierkante zu seinem Abstand von der rechten Papierkante entspricht. Bei auf dem Papier -horizontal zentriertem Satzspiegel wird also auch die Geschäftszeile +horizontal zentriertem Satzspiegel wird also auch die Geschäftszeile zentriert. -In der Regel werden diese Sonderfälle für die häufigsten Anwendungen von +In der Regel werden diese Sonderfälle für die häufigsten Anwendungen von geringem Interesse sein. Die\textnote{Tipp!} einfachste Regel lautet hier: Entweder wird \PLength{refwidth} auf Null belassen und die Breite und -Ausrichtung der Geschäftszeile über die Option +Ausrichtung der Geschäftszeile über die Option \DescRef{scrlttr2.option.refline} bestimmt oder sowohl \PLength{refwidth} als auch \PLength{refhpos} werden vom Anwender vorgegeben.% \EndIndexGroup @@ -1051,10 +1067,10 @@ auch \PLength{refhpos} werden vom Anwender vorgegeben.% \begin{Declaration} \PLength{refaftervskip} \end{Declaration} -Diese Pseudolänge gibt den vertikalen Abstand an, der nach der Geschäftszeile -eingefügt werden soll. Der Wert wird in den vordefinierten +Diese Pseudolänge gibt den vertikalen Abstand an, der nach der Geschäftszeile +eingefügt werden soll. Der Wert wird in den vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} -eingestellt. Er wirkt sich unmittelbar auf die Höhe des Textbereichs der +eingestellt. Er wirkt sich unmittelbar auf die Höhe des Textbereichs der ersten Seite aus. Der typische Wert liegt zwischen einer und zwei Zeilen.% \EndIndexGroup % @@ -1066,30 +1082,30 @@ ersten Seite aus. Der typische Wert liegt zwischen einer und zwei Zeilen.% \BeginIndexGroup \BeginIndex{}{Betreff} -Der Betreff eine Briefes wird in unterschiedlichen Ländern unterschiedlich +Der Betreff eine Briefes wird in unterschiedlichen Ländern unterschiedlich gesetzt. Die einen haben ihn gerne vor der Anrede, die anderen setzen ihn -danach. Einige Berufsgruppen wollen ihn teilweise sogar vor der Geschäftszeile +danach. Einige Berufsgruppen wollen ihn teilweise sogar vor der Geschäftszeile haben. \begin{Declaration} \PLength{subjectvpos} \end{Declaration} \ChangedAt{v3.01}{\Class{scrlttr2}}% -Ist\textnote{Achtung!} der Wert dieser Pseudolänge 0\Unit{pt}, so bestimmt die +Ist\textnote{Achtung!} der Wert dieser Pseudolänge 0\Unit{pt}, so bestimmt die Option \DescRef{scrlttr2.option.subject}\important{\DescRef{scrlttr2.option.subject}}% \IndexOption{subject~=\PName{Einstellung}} (siehe \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.subject}) die -Position des Betreffs. Dabei spielen dann auch die nachfolgend erklärten -Pseudolängen \PLength{subjectbeforevskip} und \PLength{subjectaftervskip} ihre +Position des Betreffs. Dabei spielen dann auch die nachfolgend erklärten +Pseudolängen \PLength{subjectbeforevskip} und \PLength{subjectaftervskip} ihre Rolle. Bei allen anderen Werten wird der Betreff mit dem entsprechenden Abstand von der oberen Papierkante platziert. Es\textnote{Tipp!} wird -empfohlen in diesem Fall darauf zu achten, dass genügend Platz zur Verfügung -steht, damit Überschneidungen mit anderen Elementen unwahrscheinlich sind. +empfohlen in diesem Fall darauf zu achten, dass genügend Platz zur Verfügung +steht, damit Ãœberschneidungen mit anderen Elementen unwahrscheinlich sind. \begin{Example} Einige wenige Berufsgruppen ziehen es vor, wenn der Betreff noch vor der - Geschäftszeile steht. Hierzu kann man die Position wie folgt wählen, wobei - auch die Position der Geschäftszeile angepasst wird: + Geschäftszeile steht. Hierzu kann man die Position wie folgt wählen, wobei + auch die Position der Geschäftszeile angepasst wird: \begin{lstcode} \ProvidesFile{lawsubj.lco} [2008/11/03 lawyers lco file] @@ -1097,8 +1113,8 @@ steht, damit Überschneidungen mit anderen Elementen unwahrscheinlich sind. \addtoplength{refvpos}{3\baselineskip} \endinput \end{lstcode} - Will man, dass zwischen Betreff und Geschäftszeile noch mindestens eine - Zeile frei bleibt, hat man so Platz für maximal zwei Zeilen Betreff. + Will man, dass zwischen Betreff und Geschäftszeile noch mindestens eine + Zeile frei bleibt, hat man so Platz für maximal zwei Zeilen Betreff. \end{Example} \EndIndexGroup @@ -1109,67 +1125,67 @@ steht, damit Überschneidungen mit anderen Elementen unwahrscheinlich sind. \end{Declaration} \ChangedAt{v3.01}{\Class{scrlttr2}}% Wird der Betreff nicht absolut platziert, sondern vor oder nach der Anrede, so -kann vor und nach dem Betreff ein zusätzlicher Abstand eingefügt werden. Der -Abstand vor dem Betreff trifft dabei gegebenenfalls mit anderen Abständen, +kann vor und nach dem Betreff ein zusätzlicher Abstand eingefügt werden. Der +Abstand vor dem Betreff trifft dabei gegebenenfalls mit anderen Abständen, etwa dem automatischen Abstand von einer Zeile nach dem Titel, zusammen. In der Voreinstellung wird daher in der Regel kein weiterer Abstand an dieser -Stelle eingefügt. Der Abstand nach dem Betreff beträgt in der Voreinstellung +Stelle eingefügt. Der Abstand nach dem Betreff beträgt in der Voreinstellung von Klasse und Paket zwei Zeilen.% \EndIndexGroup \EndIndexGroup -\subsection{Schlussgruß} +\subsection{Schlussgruß} \seclabel{closing} \BeginIndexGroup -\BeginIndex{}{Schlussgruss=Schlussgruß} +\BeginIndex{}{Schlussgruss=Schlussgruß} -Der Schlussgruß\Index{Gruss=Gruß} eines Briefes besteht aus mehreren Teilen. -Neben der Grußformel selbst gibt es noch die Unterschrift und die Signatur, -eine Art Erläuterung zur Unterschrift. +Der Schlussgruß\Index{Gruss=Gruß} eines Briefes besteht aus mehreren Teilen. +Neben der Grußformel selbst gibt es noch die Unterschrift und die Signatur, +eine Art Erläuterung zur Unterschrift. \begin{Declaration} \PLength{sigindent} \PLength{sigbeforevskip} \end{Declaration} -Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der +Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der Unterschrift\Index{Unterschrift} werden innerhalb einer Box gesetzt. Die -Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und -Erläuterung bestimmt. +Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und +Erläuterung bestimmt. -Die Box wird mit dem durch die Pseudolänge \PLength{sigindent} bestimmten +Die Box wird mit dem durch die Pseudolänge \PLength{sigindent} bestimmten Einzug gesetzt. In den vordefinierten \File{lco}-Dateien ist der Einzug auf 0\Unit{mm} gesetzt. -Zwischen Grußfloskel und Erläuterung wird ein vertikaler Abstand eingefügt, -der mit der Pseudolänge \PLength{sigbeforevskip} festgelegt ist. In den +Zwischen Grußfloskel und Erläuterung wird ein vertikaler Abstand eingefügt, +der mit der Pseudolänge \PLength{sigbeforevskip} festgelegt ist. In den vordefinierten \File{lco}-Dateien ist der Wert auf zwei Zeilen eingestellt. In -diese Lücke setzen Sie dann Ihre Unterschrift.% +diese Lücke setzen Sie dann Ihre Unterschrift.% \iffalse% Umbruchkorrekturtext -\ Sollten\textnote{Tipp!} Sie sich dazu entschließen in die Variable +\ Sollten\textnote{Tipp!} Sie sich dazu entschließen in die Variable \DescRef{scrlttr2.variable.signature}\IndexVariable{signature}% \important{\DescRef{scrlttr2.variable.signature}} mit Paket \Package{graphicx}\IndexPackage{graphicx} ein Faksimile Ihrer Unterschrift -einzufügen, wäre es also sinnvoll den Wert von \PLength{sigbeforevskip} und -damit die Lücke zwischen Schlussgruß und Signatur zu verringern.% +einzufügen, wäre es also sinnvoll den Wert von \PLength{sigbeforevskip} und +damit die Lücke zwischen Schlussgruß und Signatur zu verringern.% \fi% \EndIndexGroup % \EndIndexGroup -\subsection{Briefbogenfuß} +\subsection{Briefbogenfuß} \seclabel{firstFoot}% \BeginIndexGroup -\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% +\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% -Die erste Seite eines Briefes, der Briefbogen, enthält nicht nur einen eigenen -Kopf, den Briefkopf. Diese Seite enthält auch einen eigenen -Fuß\Index{Fuss=Fuß}, den Briefbogenfuß. % +Die erste Seite eines Briefes, der Briefbogen, enthält nicht nur einen eigenen +Kopf, den Briefkopf. Diese Seite enthält auch einen eigenen +Fuß\Index{Fuss=Fuß}, den Briefbogenfuß. % \iftrue% Umbruchvarianten -Auch dieser wird nicht über den Seitenstil% +Auch dieser wird nicht über den Seitenstil% \else% -Genau wie der Briefkopf wird der Briefbogenfuß nicht über den Seitenstil% +Genau wie der Briefkopf wird der Briefbogenfuß nicht über den Seitenstil% \fi% , sondern unmittelbar von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening}% \important{\DescRef{scrlttr2.cmd.opening}} ausgegeben. @@ -1178,37 +1194,37 @@ Genau wie der Briefkopf wird der Briefbogenfuß nicht über den Seitenstil% \begin{Declaration} \PLength{firstfootvpos} \end{Declaration} -Diese Pseudolänge gibt den Abstand des Fußes der ersten Briefseite von der -Oberkante des Papiers an. Es wird außerdem dafür gesorgt, dass der Textbereich -nicht in den Fuß hineinragt. Hierzu wird auf der ersten Seite gegebenenfalls -die Höhe des Textbereichs mit Hilfe von +Diese Pseudolänge gibt den Abstand des Fußes der ersten Briefseite von der +Oberkante des Papiers an. Es wird außerdem dafür gesorgt, dass der Textbereich +nicht in den Fuß hineinragt. Hierzu wird auf der ersten Seite gegebenenfalls +die Höhe des Textbereichs mit Hilfe von \Macro{enlargethispage}\IndexCmd{enlargethispage}% \important{\Macro{enlargethispage}} verkleinert. Mit Hilfe der Option \DescRef{scrlttr2.option.enlargefirstpage}% \important{\DescRef{scrlttr2.option.enlargefirstpage}} (siehe \autoref{sec:scrlttr2.firstpage}, -\DescPageRef{scrlttr2.option.enlargefirstpage}) kann dafür gesorgt werden, -dass die Höhe des Textbereichs umgekehrt gegebenenfalls auch vergrößert -wird. Damit kann dann der Abstand zwischen Textbereich und Fuß der ersten -Seite auf den Wert der Länge +\DescPageRef{scrlttr2.option.enlargefirstpage}) kann dafür gesorgt werden, +dass die Höhe des Textbereichs umgekehrt gegebenenfalls auch vergrößert +wird. Damit kann dann der Abstand zwischen Textbereich und Fuß der ersten +Seite auf den Wert der Länge \Length{footskip}\IndexLength{footskip}\important{\Length{footskip}} verringert werden. Bei\textnote{Achtung!} -Kompatibilitätseinstellungen\ChangedAt{v2.9t}{\Class{scrlttr2}} bis +Kompatibilitätseinstellungen\ChangedAt{v2.9t}{\Class{scrlttr2}} bis Version~2.9t (siehe \DescRef{scrlttr2.option.version} in \autoref{sec:scrlttr2.compatibilityOptions}, -\DescPageRef{scrlttr2.option.version}) wird außer bei \Option{KOMAold} und +\DescPageRef{scrlttr2.option.version}) wird außer bei \Option{KOMAold} und \Option{NF} in allen vordefinierten \File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} -(siehe \autoref{sec:scrlttr2.lcoFile}) der Fuß abhängig vom Satzspiegel +(siehe \autoref{sec:scrlttr2.lcoFile}) der Fuß abhängig vom Satzspiegel gesetzt. Damit hat dann auch \DescRef{scrlttr2.option.enlargefirstpage}% \important{\DescRef{scrlttr2.option.enlargefirstpage}} keine Wirkung. Ab -Version 2.9u bekommt der Fuß eine Position am unteren Ende des Papiers. Damit -ist dann die Höhe des Satzspiegels des Briefbogens eventuell auch von der -Option \DescRef{scrlttr2.option.enlargefirstpage} abhängig. +Version 2.9u bekommt der Fuß eine Position am unteren Ende des Papiers. Damit +ist dann die Höhe des Satzspiegels des Briefbogens eventuell auch von der +Option \DescRef{scrlttr2.option.enlargefirstpage} abhängig. -Sollte der Briefbogenfuß mittels Option +Sollte der Briefbogenfuß mittels Option \OptionValueRef{scrlttr2}{firstfoot}{false}% \important{\OptionValueRef{scrlttr2}{firstfoot}{false}}% \IndexOption{firstfoot~=\textKValue{false}}\ChangedAt{v2.97e}{\Class{scrlttr2}} @@ -1223,29 +1239,29 @@ ein minimaler unterer Rand von \Length{footskip}\IndexLength{footskip}.% \begin{Declaration} \PLength{firstfoothpos} \end{Declaration} -Die\textnote{Achtung!} Pseudolänge +Die\textnote{Achtung!} Pseudolänge \PLength{firstfoothpos}\ChangedAt{v3.05}{\Class{scrlttr2}} gibt bei einem -positiven Wert den Abstand des Briefbogenfußes von der linken Papierkante -an. Ist der Wert sogar größer oder gleich der Breite des Papiers, -\Length{paperwidth}\IndexLength{paperwidth}, so wird der Fuß horizontal +positiven Wert den Abstand des Briefbogenfußes von der linken Papierkante +an. Ist der Wert sogar größer oder gleich der Breite des Papiers, +\Length{paperwidth}\IndexLength{paperwidth}, so wird der Fuß horizontal zentriert auf dem Briefbogen platziert. Ein negativer Wert gibt den Abstand -des Fußes von der rechten Papierkante an. Ist der Wert jedoch kleiner oder -gleich der negativen Breite des Papiers, so wird der Fuß bündig zum linken +des Fußes von der rechten Papierkante an. Ist der Wert jedoch kleiner oder +gleich der negativen Breite des Papiers, so wird der Fuß bündig zum linken Rand des Satzspiegels platziert. Voreingestellt ist typischerweise ein Wert von -\Length{maxdimen}\IndexLength{maxdimen}, also der größtmögliche Wert für eine -Länge. Die Folge ist eine horizontale Zentrierung.% +\Length{maxdimen}\IndexLength{maxdimen}, also der größtmögliche Wert für eine +Länge. Die Folge ist eine horizontale Zentrierung.% \EndIndexGroup \begin{Declaration} \PLength{firstfootwidth} \end{Declaration} -Diese Pseudolänge gibt die Breite des Fußes der ersten Briefseite, also des +Diese Pseudolänge gibt die Breite des Fußes der ersten Briefseite, also des Briefbogens, an. Der Wert stimmt in den vordefinierten \File{lco}-Dateien mit \PLength{firstheadwidth}\important{\PLength{firstheadwidth}}% -\IndexPLength{firstheadwidth} überein.% +\IndexPLength{firstheadwidth} überein.% % \EndIndexGroup % @@ -1254,14 +1270,14 @@ Briefbogens, an. Der Wert stimmt in den vordefinierten \File{lco}-Dateien mit \EndIndexGroup -\section{Variablen für fortgeschrittene Anwender} +\section{Variablen für fortgeschrittene Anwender} \seclabel{variables} \BeginIndexGroup \BeginIndex{}{Variablen} -Neben der Möglichkeit, vordefinierte Variablen zu verwenden, bietet +Neben der Möglichkeit, vordefinierte Variablen zu verwenden, bietet \KOMAScript{} auch Anweisungen, um neue Variablen zu definieren oder deren -automatische Verwendung innerhalb der Geschäftszeile zu beeinflussen. +automatische Verwendung innerhalb der Geschäftszeile zu beeinflussen. \begin{Declaration} @@ -1272,49 +1288,49 @@ automatische Verwendung innerhalb der Geschäftszeile zu beeinflussen. \Macro{addtoreffields}\Parameter{Name} \end{Declaration} Mit \Macro{newkomavar} wird eine neue Variable definiert. Diese Variable wird -über \PName{Name} angesprochen. Optional kann eine \PName{Bezeichnung} für die +über \PName{Name} angesprochen. Optional kann eine \PName{Bezeichnung} für die Variable \PName{Name} angegeben werden. Eine \PName{Bezeichnung} wird dabei im Unterschied zum \PName{Name} nicht verwendet, um auf eine Variable -zuzugreifen. Vielmehr ist die \PName{Bezeichnung} eine Ergänzung zum Inhalt -einer Variable, die ähnlich ihrem Inhalt ausgegeben werden kann. +zuzugreifen. Vielmehr ist die \PName{Bezeichnung} eine Ergänzung zum Inhalt +einer Variable, die ähnlich ihrem Inhalt ausgegeben werden kann. Mit der Anweisung \Macro{addtoreffields} kann die Variable \PName{Name} der -Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}\textnote{Geschäftszeile} +Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}\textnote{Geschäftszeile} (siehe \autoref{sec:scrlttr2.firstpage}, -\DescPageRef{scrlttr2.option.refline}) hinzugefügt werden. Dabei wird die +\DescPageRef{scrlttr2.option.refline}) hinzugefügt werden. Dabei wird die \PName{Bezeichnung} und der Inhalt der Variablen an das Ende der -Geschäftszeile angehängt, falls ihr Inhalt nicht leer ist. Die Sternvariante -\Macro{newkomavar*} entspricht der Variante ohne Stern mit anschließendem +Geschäftszeile angehängt, falls ihr Inhalt nicht leer ist. Die Sternvariante +\Macro{newkomavar*} entspricht der Variante ohne Stern mit anschließendem Aufruf der Anweisung \Macro{addtoreffields}. Bei der Sternvariante wird die -Variable also automatisch zur Geschäftszeile hinzugefügt. +Variable also automatisch zur Geschäftszeile hinzugefügt. \begin{Example} - Angenommen, Sie benötigen in der Geschäftszeile ein zusätzliches Feld - für eine Durchwahl. Sie können das Feld dann wahlweise mit + Angenommen, Sie benötigen in der Geschäftszeile ein zusätzliches Feld + für eine Durchwahl. Sie können das Feld dann wahlweise mit \begin{lstcode} \newkomavar[Durchwahl]{myphone} \addtoreffields{myphone} \end{lstcode} - oder kürzer mit + oder kürzer mit \begin{lstcode} \newkomavar*[Durchwahl]{myphone} \end{lstcode} definieren. \end{Example} -Im\textnote{Achtung!} Fall, dass eine Variable für die Geschäftszeile -definiert wird, sollten Sie immer eine Bezeichnung dafür angeben. +Im\textnote{Achtung!} Fall, dass eine Variable für die Geschäftszeile +definiert wird, sollten Sie immer eine Bezeichnung dafür angeben. -Mit der Anweisung \Macro{removereffields} können alle Variablen aus der -Geschäftszeile entfernt werden. Dies betrifft auch die in der Klasse -vordefinierten Variablen. Die Geschäftszeile ist dann leer. Sie können dies +Mit der Anweisung \Macro{removereffields} können alle Variablen aus der +Geschäftszeile entfernt werden. Dies betrifft auch die in der Klasse +vordefinierten Variablen. Die Geschäftszeile ist dann leer. Sie können dies beispielsweise nutzen, wenn Sie die Reihenfolge der Variablen in der -Geschäftszeile ändern wollen. +Geschäftszeile ändern wollen. Zur Wiederherstellung der Reihenfolge der vordefinierten Variablen in der -Geschäftszeile dient \Macro{defaultreffields}. Dabei werden auch alle -selbst definierten Variablen aus der Geschäftszeile entfernt. +Geschäftszeile dient \Macro{defaultreffields}. Dabei werden auch alle +selbst definierten Variablen aus der Geschäftszeile entfernt. -Das\textnote{Achtung!} Datum sollte der Geschäftszeile nicht über die -Anweisung \Macro{addtoreffields} hinzugefügt werden. Stattdessen stellt man +Das\textnote{Achtung!} Datum sollte der Geschäftszeile nicht über die +Anweisung \Macro{addtoreffields} hinzugefügt werden. Stattdessen stellt man mit Option \DescRef{scrlttr2.option.refline}% \important{\OptionValueRef{scrlttr2}{refline}{dateleft}\\ \OptionValueRef{scrlttr2}{refline}{dateright}\\ @@ -1322,9 +1338,9 @@ mit Option \DescRef{scrlttr2.option.refline}% \IndexOption{refline~=\textKValue{dateleft}}% \IndexOption{refline~=\textKValue{dateright}}% \IndexOption{refline~=\textKValue{nodate}} ein, ob das Datum links, rechts oder -gar nicht in der Geschäftszeile erscheinen soll. Diese Einstellungen haben -darüber hinaus auch einen Einfluss auf die Position des Datums, wenn gar keine -Geschäftszeile verwendet wird.% +gar nicht in der Geschäftszeile erscheinen soll. Diese Einstellungen haben +darüber hinaus auch einen Einfluss auf die Position des Datums, wenn gar keine +Geschäftszeile verwendet wird.% % \EndIndexGroup @@ -1338,22 +1354,22 @@ Die Anweisungen \DescRef{scrlttr2.cmd.usekomavar} und eine Sternvariante gibt oder die ein optionales Argument besitzen, nicht voll expandierbar. Bei Verwendung innerhalb von \DescRef{scrlttr2.cmd.markboth}\IndexCmd{markboth}, -\DescRef{scrlttr2.cmd.markright}\IndexCmd{markright} oder ähnlichen +\DescRef{scrlttr2.cmd.markright}\IndexCmd{markright} oder ähnlichen Anweisungen muss dennoch kein \Macro{protect}\IndexCmd{protect} vorangestellt -werden. Selbstverständlich gilt dies bei Verwendung von +werden. Selbstverständlich gilt dies bei Verwendung von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% -\IndexPackage{scrlayer-scrpage} auch für +\IndexPackage{scrlayer-scrpage} auch für \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.cmd.markleft}). Allerdings\textnote{Achtung!} -können die Anweisungen nicht innerhalb von +können die Anweisungen nicht innerhalb von \Macro{MakeUppercase}\important{\Macro{MakeUppercase}}\IndexCmd{MakeUppercase} -und ähnlichen Anweisungen verwendet werden, die direkten Einfluss auf ihr -Argument haben. Diese Anweisungen können jedoch als optionales Argument -angegeben werden. So erhält man beispielsweise den Inhalt einer Variable in -Großbuchstaben mit: -\begin{lstcode}[escapeinside=»«] - \usekomavar[\MakeUppercase]{»\PName{Name}«} +und ähnlichen Anweisungen verwendet werden, die direkten Einfluss auf ihr +Argument haben. Diese Anweisungen können jedoch als optionales Argument +angegeben werden. So erhält man beispielsweise den Inhalt einer Variable in +Großbuchstaben mit: +\begin{lstcode}[escapeinside=><] + \usekomavar[\MakeUppercase]{>\PName{Name}<} \end{lstcode} % \EndIndexGroup @@ -1363,24 +1379,54 @@ Großbuchstaben mit: \Macro{ifkomavarempty}\Parameter{Name}\Parameter{Wahr}\Parameter{Falsch} \Macro{ifkomavarempty*}\Parameter{Name}\Parameter{Wahr}\Parameter{Falsch} \end{Declaration} -Für die exakte Funktion ist wichtig, dass der Inhalt der Variablen soweit -expandiert wird, wie dies mit \Macro{edef} möglich ist. Bleiben dabei -Leerzeichen oder unexpandierbare Makros wie \Macro{relax} übrig, so gilt der +Für die exakte Funktion ist wichtig, dass der Inhalt der Variablen soweit +expandiert wird, wie dies mit \Macro{edef} möglich ist. Bleiben dabei +Leerzeichen oder unexpandierbare Makros wie \Macro{relax} übrig, so gilt der Inhalt auch dann als nicht leer, wenn die Verwendung der Variablen zu keiner -Ausgabe führen würde. +Ausgabe führen würde. Auch\textnote{Achtung!} diese Anweisung kann nicht innerhalb von -\Macro{MakeUppercase} oder ähnlichen Anweisungen verwendet werden. Sie ist +\Macro{MakeUppercase} oder ähnlichen Anweisungen verwendet werden. Sie ist jedoch robust genug, um beispielsweise als Argument von \DescRef{scrlttr2.cmd.markboth} oder \DescRef{scrlttr2.cmd.footnote} zu -funktionieren. -% +funktionieren.% +\EndIndexGroup + + +\begin{Declaration} + \Macro{foreachkomavar}\Parameter{Variablenliste}\Parameter{Befehl} + \Macro{foreachnonemptykomavar}\Parameter{Variablenliste}\Parameter{Befehl} + \Macro{foreachemptykomavar}\Parameter{Variablenliste}\Parameter{Befehl} + \Macro{foreachkomavarifempty}\Parameter{Variablenliste} + \Parameter{Dann-Befehl}\Parameter{Sonst-Befehl} +\end{Declaration} +Mit\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} der Anweisung +\Macro{foreachkomavar} wird der angegebene \PName{Befehl} für jede Variable +aus der durch Komma separierten \PName{Variablenliste} ausgeführt. Dabei wird +der Name der jeweiligen Variablen als Argument an den \PName{Befehl} +angehängt. + +Die Anweisung \Macro{foreachnonemptykomavar} führt im Unterschied dazu +\PName{Befehl} nur aus, wenn die Variable im Sinne von +\DescRef{\LabelBase.cmd.ifkomavarempty} nicht leer ist. Leere Variablen in der +\PName{Variablenliste} haben dagegen keine Auswirkungen. + +Dagegen führt \Macro{foreachemptykomavar} den \PName{Befehl} aus, wenn die +Variable im Sinne von \DescRef{\LabelBase.cmd.ifkomavarempty} leer ist. Nicht +leere Variablen in der \PName{Variablenliste} haben entsprechend keine +Auswirkungen. + +Die Anweisung \Macro{foreachkomavarifempty} ist quasi eine Verschmelzung +beider vorgenannten. Sie führt \PName{Dann-Befehl} für alle leeren Variablen +aus, während \PName{Sonst-Befehl} für die nicht leeren Variablen zur Anwendung +kommt. Wie bei \PName{Befehl} wird in beiden Fällen der Name der jeweiligen +Variable als Argument angehängt.% \EndIndexGroup % \EndIndexGroup -\section{Ergänzende Informationen zu den Seitenstilen} +\section{Ergänzende Informationen zu den Seitenstilen} \seclabel{pagestyleatscrletter} \BeginIndexGroup \BeginIndex{}{Seiten>Stil} @@ -1397,18 +1443,18 @@ funktionieren. \BeginIndex{}{lco-Datei=\File{lco}-Datei} In\ChangedAt{v3.15}{\Package{scrletter}} \autoref{sec:scrlttr2.lcoFile} wurde -erklärt, dass man \File{lco}-Dateien direkt über \Macro{documentclass} laden -kann. Für \Package{scrletter}\OnlyAt{\Package{scrlttr2}} wurde auf diese -Möglichkeit verzichtet. +erklärt, dass man \File{lco}-Dateien direkt über \Macro{documentclass} laden +kann. Für \Package{scrletter}\OnlyAt{\Package{scrlttr2}} wurde auf diese +Möglichkeit verzichtet. \begin{Declaration} \Macro{LoadLetterOption}\Parameter{Name} \Macro{LoadLetterOptions}\Parameter{Liste von Namen} \end{Declaration} -Während für \Class{scrlttr2} lediglich empfohlen wird, \File{lco}-Dateien über +Während für \Class{scrlttr2} lediglich empfohlen wird, \File{lco}-Dateien über \DescRef{scrlttr2.cmd.LoadLetterOption} oder -\DescRef{scrlttr2.cmd.LoadLetterOptions} zu laden, ist dies für -\Package{scrletter} zwingend. Natürlich können die \File{lco}-Dateien auch +\DescRef{scrlttr2.cmd.LoadLetterOptions} zu laden, ist dies für +\Package{scrletter} zwingend. Natürlich können die \File{lco}-Dateien auch erst nach \Package{scrletter} geladen werden. % \EndIndexGroup @@ -1418,7 +1464,7 @@ erst nach \Package{scrletter} geladen werden. \fi -\section{\File{lco}-Dateien für fortgeschrittene Anwender} +\section{\File{lco}-Dateien für fortgeschrittene Anwender} \seclabel{lcoFile} \BeginIndexGroup \BeginIndex{File}{lco} @@ -1428,55 +1474,55 @@ erst nach \Package{scrletter} geladen werden. \BeginIndex{}{Papier>Format}% Obwohl jedes von \hyperref[cha:typearea]{\Package{typearea}}% \IndexPackage{typearea} einstellbare Format verwendbar ist, kann es bei der -Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten +Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten Ergebnissen kommen. Leider gibt es -keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und -Ähnlichem für beliebige Papierformate zu berechnen. Vielmehr werden für -unterschiedliche Papierformate unterschiedliche Parameter benötigt.% +keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und +Ähnlichem für beliebige Papierformate zu berechnen. Vielmehr werden für +unterschiedliche Papierformate unterschiedliche Parameter benötigt.% -%\subsection{Überwachung des Papierformats} +%\subsection{Ãœberwachung des Papierformats} %\seclabel{papersize} -Derzeit existieren Parametersätze und \File{lco}-Dateien für A4-Papier und +Derzeit existieren Parametersätze und \File{lco}-Dateien für A4-Papier und letter-Papier. Die Klasse \Class{scrlttr2} versteht aber theoretisch sehr viel -mehr Papierformate. Daher ist es notwendig zu überwachen, ob die korrekte -Papiergröße eingestellt ist. Dies gilt umso mehr, wenn \Package{scrletter} -verwendet wird, da die Einstellung der Papiergröße dann in erster Linie von -der verwendeten Klasse abhängt. +mehr Papierformate. Daher ist es notwendig zu überwachen, ob die korrekte +Papiergröße eingestellt ist. Dies gilt umso mehr, wenn \Package{scrletter} +verwendet wird, da die Einstellung der Papiergröße dann in erster Linie von +der verwendeten Klasse abhängt. \begin{Declaration} \Macro{LetterOptionNeedsPapersize}% - \Parameter{Optionsname}\Parameter{Papiergröße} + \Parameter{Optionsname}\Parameter{Papiergröße} \end{Declaration} Damit man bei Verwendung einer in der \File{lco}-Datei nicht vorgesehenen -\PName{Papiergröße} zumindest gewarnt wird, sind in den +\PName{Papiergröße} zumindest gewarnt wird, sind in den mit \KOMAScript{} ausgelieferten \File{lco}-Dateien \Macro{LetterOptionNeedsPapersize}-Anweisungen zu finden. Als erstes Argument -wird dabei der Name der \File{lco}-Datei ohne die Endung »\File{.lco}« -übergeben. Als zweites Argument wird die Papiergröße übergeben, für die diese +wird dabei der Name der \File{lco}-Datei ohne die Endung »\File{.lco}« +übergeben. Als zweites Argument wird die Papiergröße übergeben, für die diese \File{lco}-Datei gedacht ist. Werden nacheinander mehrere \File{lco}-Dateien geladen, so kann jede dieser \File{lco}-Dateien eine Anweisung \Macro{LetterOptionNeedsPapersize} enthalten. Innerhalb von \DescRef{scrlttr2.cmd.opening}\IndexCmd{opening} wird -jedoch nur auf die jeweils letzte angegebene \PName{Papiergröße} geprüft. Wie -das nachfolgende Beispiel zeigt, ist es daher für den versierten Anwender -leicht möglich, \File{lco}-Dateien mit Parametersätzen für andere +jedoch nur auf die jeweils letzte angegebene \PName{Papiergröße} geprüft. Wie +das nachfolgende Beispiel zeigt, ist es daher für den versierten Anwender +leicht möglich, \File{lco}-Dateien mit Parametersätzen für andere Papierformate zu schreiben. % \iffalse% Umbruchoptimierung!!! Wer allerdings nicht vor hat, selbst solche \File{lco}-Dateien zu schreiben, -der kann die Erklärung zu dieser Anweisung gleich wieder vergessen und auch -das Beispiel überspringen.% +der kann die Erklärung zu dieser Anweisung gleich wieder vergessen und auch +das Beispiel überspringen.% \fi \begin{Example} Nehmen wir einmal an, dass Sie A5-Papier in normaler Ausrichtung, also - hochkant oder portrait, für Ihre Briefe verwenden. Nehmen wir weiter an, - dass Sie diese in normale Fensterbriefumschläge im Format C6 stecken. Damit - wäre prinzipiell die Position des Adressfeldes die gleiche wie bei einem + hochkant oder portrait, für Ihre Briefe verwenden. Nehmen wir weiter an, + dass Sie diese in normale Fensterbriefumschläge im Format C6 stecken. Damit + wäre prinzipiell die Position des Adressfeldes die gleiche wie bei einem normalen Brief in A4 nach DIN. Der Unterschied besteht im Wesentlichen darin, dass das A5-Papier nur einmal gefaltet werden muss. Sie wollen deshalb verhindern, dass die obere und die untere Faltmarke gesetzt - wird. Dies erreichen Sie beispielsweise, indem Sie die Marken außerhalb des + wird. Dies erreichen Sie beispielsweise, indem Sie die Marken außerhalb des Papiers platzieren. \begin{lstcode} \ProvidesFile{a5.lco} @@ -1486,18 +1532,18 @@ das Beispiel überspringen.% \setplength{bfoldmarkvpos}{\paperheight} \endinput \end{lstcode} - Eleganter wäre es natürlich, die Marken mit Hilfe der Option - \DescRef{scrlttr2.option.foldmarks} abzuschalten. Außerdem muss auch noch - die Position des Seitenfußes, also die Pseudolänge \PLength{firstfootvpos}, - angepasst werden. Ich überlasse es dem Leser, dafür einen geeigneten Wert zu + Eleganter wäre es natürlich, die Marken mit Hilfe der Option + \DescRef{scrlttr2.option.foldmarks} abzuschalten. Außerdem muss auch noch + die Position des Seitenfußes, also die Pseudolänge \PLength{firstfootvpos}, + angepasst werden. Ich überlasse es dem Leser, dafür einen geeigneten Wert zu ermitteln. Mit einer solchen \File{lco}-Datei ist es lediglich wichtig, dass andere \File{lco}-Dateioptionen wie \File{SN} vor dem Laden von - »\File{a5.lco}«, angegeben werden. + »\File{a5.lco}«, angegeben werden. \end{Example} % \EndIndexGroup% \EndIndexGroup% -\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung +\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung %\subsection{Positionen sichtbar machen} @@ -1508,19 +1554,19 @@ das Beispiel überspringen.% \end{Declaration} \BeginIndex{Option}{visualize}% Wenn man selbst \File{lco}-Dateien entwickelt, beispielsweise um die -Positionen von verschiedenen Feldern des Briefbogens an eigene Wünsche oder +Positionen von verschiedenen Feldern des Briefbogens an eigene Wünsche oder Notwendigkeiten anzupassen, ist es hilfreich, wenn zumindest einige Elemente -direkt sichtbar gemacht werden können. Zu diesem Zweck existiert die +direkt sichtbar gemacht werden können. Zu diesem Zweck existiert die \File{lco}-Datei \File{visualize.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}. Diese kann wie jede \File{lco}-Datei geladen werden. Allerdings ist das Laden dieser \emph{Letter - Class Option} auf die Dokumentpräambel beschränkt und seine Auswirkungen -können nicht wieder rückgängig gemacht werden. Die \File{lco}-Datei bedient + Class Option} auf die Dokumentpräambel beschränkt und seine Auswirkungen +können nicht wieder rückgängig gemacht werden. Die \File{lco}-Datei bedient sich der Pakete \Package{eso-pic}\IndexPackage{eso-pic}% \important[i]{\Package{eso-pic}\\\Package{graphicx}} und \Package{graphicx}\IndexPackage{graphicx}, die nicht zu \KOMAScript{} -gehören. +gehören. \begin{Declaration} \Macro{showfields}\Parameter{Feldliste} @@ -1528,27 +1574,27 @@ gehören. Mit dieser Anweisung kann bei Verwendung von \File{visualize.lco} die Visualisierung von Feldern des Briefbogens aktiviert werden. Das Argument \PName{Feldliste} ist dabei eine durch Komma separierte Liste der Feldern, die -visualisiert werden sollen. Folgende Felder werden derzeit unterstützt: +visualisiert werden sollen. Folgende Felder werden derzeit unterstützt: \begin{labeling}[~--]{\PValue{location}} -\item[\PValue{test}] ist ein Testfeld der Größe 10\Unit{cm} auf 15\Unit{cm}, +\item[\PValue{test}] ist ein Testfeld der Größe 10\Unit{cm} auf 15\Unit{cm}, das jeweils 1\Unit{cm} vom oberen und linken Papierrand entfernt ist. Dieses - Testfeld existiert zu Debuggingzwecken. Es dient als Vergleichsmaß für den - Fall, dass im Dokumenterstellungsprozess die Maße verfälscht werden. + Testfeld existiert zu Debuggingzwecken. Es dient als Vergleichsmaß für den + Fall, dass im Dokumenterstellungsprozess die Maße verfälscht werden. \item[\PValue{head}] ist der Kopfbereich des Briefbogens. Es handelt sich hier um ein nach unten offenes Feld. -\item[\PValue{foot}] ist der Fußbereich des Briefbogens. Es handelt sich hier +\item[\PValue{foot}] ist der Fußbereich des Briefbogens. Es handelt sich hier um ein nach unten offenes Feld. \item[\PValue{address}] ist das Anschriftfenster. -\item[\PValue{location}] ist das Feld der Absenderergänzung. -\item[\PValue{refline}] ist die Geschäftszeile. Es handelt sich hier um ein +\item[\PValue{location}] ist das Feld der Absenderergänzung. +\item[\PValue{refline}] ist die Geschäftszeile. Es handelt sich hier um ein nach unten offenes Feld. \end{labeling}% \BeginIndex{FontElement}{field}\LabelFontElement{field}% Mit den Anweisungen \DescRef{scrlttr2.cmd.setkomafont} und \DescRef{scrlttr2.cmd.addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup}, -\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element +\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element \FontElement{field}\important{\FontElement{field}} kann die Farbe der -Visualisierung geändert werden. Voreingestellt ist \Macro{normalcolor}.% +Visualisierung geändert werden. Voreingestellt ist \Macro{normalcolor}.% \EndIndex{FontElement}{field}% % \EndIndexGroup @@ -1563,19 +1609,19 @@ durch Rahmen\important{\PValue{frame}} markiert. Dies entspricht dem \PName{Stil} \PValue{frame}. Nach unten offene Felder werden dabei nicht komplett umrahmt, sondern unten offen mit kleinen Pfeilen nach unten dargestellt. Als Alternative\important{\PValue{rule}} hierzu steht auch der -\PName{Stil} \PValue{rule} zur Verfügung. Dabei wird das Feld farbig +\PName{Stil} \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{edges}} verfügbare +einer Mindesthöhe dargestellt. Der dritte\important{\PValue{edges}} verfügbare \PName{Stil} 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} +Eckmarkierungen. Die Größe der Eckmarkierungen ist im Makro \Macro{edgesize} abgelegt und mit 1\Unit{ex} voreingestellt.% \EndIndexGroup \begin{Declaration} - \Macro{showenvelope}\AParameter{Breite\textup{,}Höhe} + \Macro{showenvelope}\AParameter{Breite\textup{,}Höhe} \AParameter{HOffset\textup{,}VOffset} \OParameter{Zusatz} \Macro{showISOenvelope}\Parameter{Format}\OParameter{Zusatz} @@ -1585,57 +1631,57 @@ abgelegt und mit 1\Unit{ex} voreingestellt.% \end{Declaration} Diese Anweisungen dienen bei Verwendung von \File{visualize.lco} dazu, eine Seite mit einer Zeichnung eines Umschlags auszugeben. Der Umschlag wird dabei -immer um 90° gedreht auf einer eigenen Seite im Maßstab~1:1 ausgegeben. Das -Anschriftfenster wird automatisch aus den aktuellen Daten für die +immer um 90° gedreht auf einer eigenen Seite im Maßstab~1:1 ausgegeben. Das +Anschriftfenster wird automatisch aus den aktuellen Daten für die Anschriftposition auf dem Briefbogen: \PLength{toaddrvpos}, \PLength{toaddrheight}, \PLength{toaddrwidth} und \PLength{toaddrhpos}, -erzeugt. Hierfür ist es notwendig zu wissen, um welchen Wert der gefaltete -Briefbogen auf jeder Seite kleiner als die \PName{Breite} und \PName{Höhe} des +erzeugt. Hierfür ist es notwendig zu wissen, um welchen Wert der gefaltete +Briefbogen auf jeder Seite kleiner als die \PName{Breite} und \PName{Höhe} des Briefbogens ist. Sind diese beiden Werte, \PName{HOffset} und \PName{VOffset}, bei \Macro{showenvelope} nicht angegeben, so wird versucht, sie aus den -Faltmarken und der Papiergröße selbst zu berechnen. +Faltmarken und der Papiergröße selbst zu berechnen. Die Anweisungen \Macro{showISOenvelope}, \Macro{showUScommercial} und \Macro{showUScheck} basieren auf \Macro{showenvelope}. Mit \Macro{showISOenvelope} kann ein ISO-Umschlag im \PName{Format} C4, C5, C5/6, DL\iffree{ (auch bekannt als C5/6)}{} oder C6 erzeugt werden. Mit \Macro{showUScommercial} wird hingegen ein US-Commercial-Umschlag im -\PName{Format} 9 oder 10 ausgegeben. \Macro{showUScheck} schließlich ist für -Umschläge im US-Check-Format zuständig. +\PName{Format} 9 oder 10 ausgegeben. \Macro{showUScheck} schließlich ist für +Umschläge im US-Check-Format zuständig. \BeginIndex{FontElement}{letter}\LabelFontElement{letter}% Innerhalb des Umschlags wird die Lage des Briefbogens gestrichelt angedeutet. Die dabei verwendete Farbe kann mit Hilfe der Anweisungen \DescRef{scrlttr2.cmd.setkomafont} und \DescRef{scrlttr2.cmd.addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup}, -\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element -\FontElement{letter}\important{\FontElement{letter}} verändert +\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element +\FontElement{letter}\important{\FontElement{letter}} verändert werden. Voreingestellt ist \Macro{normalcolor}.% \EndIndex{FontElement}{letter} \BeginIndex{FontElement}{measure}\LabelFontElement{measure}% -Die Umschlagzeichnung wird automatisch bemaßt. Die Farbe der Bemaßung und die -Größe deren Beschriftung kann mit Hilfe der Anweisungen +Die Umschlagzeichnung wird automatisch bemaßt. Die Farbe der Bemaßung und die +Größe deren Beschriftung kann mit Hilfe der Anweisungen \DescRef{scrlttr2.cmd.setkomafont} und \DescRef{scrlttr2.cmd.addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup}, -\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element -\FontElement{measure}\important{\FontElement{measure}} verändert -werden. Voreingestellt ist hier \Macro{normalcolor}. Die Bemaßung erfolgt in +\DescPageRef{scrlttr2.cmd.setkomafont}) für das Element +\FontElement{measure}\important{\FontElement{measure}} verändert +werden. Voreingestellt ist hier \Macro{normalcolor}. Die Bemaßung erfolgt in Vielfachen von \Length{unitlength} mit einer maximalen Genauigkeit von $1/\Macro{unitfactor}$, wobei die Genauigkeit der \TeX-Arithmetik die -tatsächliche Grenze darstellt. Voreingestellt ist 1. Eine Umdefinierung ist -mit \Macro{renewcommand} möglich.% +tatsächliche Grenze darstellt. Voreingestellt ist 1. Eine Umdefinierung ist +mit \Macro{renewcommand} möglich.% \EndIndex{FontElement}{measure} \begin{Example} - Es wird ein Beispielbrief im Format ISO~A4 erzeugt. Die unterstützten Felder - sollen zwecks Überprüfung ihrer Position mit gelben Rahmenlinien markiert + Es wird ein Beispielbrief im Format ISO~A4 erzeugt. Die unterstützten Felder + sollen zwecks Ãœberprüfung ihrer Position mit gelben Rahmenlinien markiert werden. Des Weiteren soll die Position des Fensters in einem Umschlag der - Größe~DL mit Hilfe einer Zeichnung überprüft werden. Die Maßlinien in dieser - Zeichnung sollen rot und die Maßzahlen in kleinerer Schrift ausgegeben - werden, wobei die Maßzahlen in cm mit einer Genauigkeit von 1\Unit{mm} + Größe~DL mit Hilfe einer Zeichnung überprüft werden. Die Maßlinien in dieser + Zeichnung sollen rot und die Maßzahlen in kleinerer Schrift ausgegeben + werden, wobei die Maßzahlen in cm mit einer Genauigkeit von 1\Unit{mm} ausgegeben werden sollen. Der gestrichelte Briefbogen im Umschlag soll - hingegen grün eingefärbt werden. + hingegen grün eingefärbt werden. \begin{lstcode} \documentclass[visualize]{scrlttr2} \usepackage{xcolor} @@ -1667,10 +1713,10 @@ mit \Macro{renewcommand} möglich.% wird die Zeichnung des Umschlags ausgegeben. \end{Example} -Bezüglich der Bemaßung ist zu beachten, dass ungünstige Kombinationen von +Bezüglich der Bemaßung ist zu beachten, dass ungünstige Kombinationen von \Length{unitlength} und \Macro{unitfactor} sehr schnell einen \TeX-Fehler der Art \emph{arithmetic overflow} provozieren. Ebenso kann es geschehen, dass -ausgegebene Maßzahlen geringfügig vom tatsächlichen Wert abweichen. Beides +ausgegebene Maßzahlen geringfügig vom tatsächlichen Wert abweichen. Beides sind keine Fehler von \Option{visualize}, sondern lediglich Implementierungsgrenzen. % @@ -1681,22 +1727,22 @@ Implementierungsgrenzen. \EndIndexGroup -\section{Unterstützung verschiedener Sprachen} +\section{Unterstützung verschiedener Sprachen} \seclabel{languages}% \BeginIndexGroup% \BeginIndex{}{Sprachen}% -Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} unterstützen -viele Sprachen. Dazu zählen Deutsch (\PValue{german} für alte deutsche -Rechtschreibung, \PValue{ngerman} für neue deutsche Rechtschreibung, -\PValue{austrian} für Österreichisch mit alter deutscher Rechtschreibung und -\PValue{naustrian}\ChangedAt{v3.09}{\Class{scrlttr2}} für Österreichisch mit +Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} unterstützen +viele Sprachen. Dazu zählen Deutsch (\PValue{german} für alte deutsche +Rechtschreibung, \PValue{ngerman} für neue deutsche Rechtschreibung, +\PValue{austrian} für Österreichisch mit alter deutscher Rechtschreibung und +\PValue{naustrian}\ChangedAt{v3.09}{\Class{scrlttr2}} für Österreichisch mit neuer deutscher Rechtschreibung), -\PValue{nswissgerman}\ChangedAt{v3.13}{\Class{scrlttr2}} für Schweizer Deutsch -mit neuer Rechtschreibung und \PValue{swissgerman} für Schweizer Deutsch mit +\PValue{nswissgerman}\ChangedAt{v3.13}{\Class{scrlttr2}} für Schweizer Deutsch +mit neuer Rechtschreibung und \PValue{swissgerman} für Schweizer Deutsch mit alter Rechtschreibung, Englisch (unter anderem \PValue{english} ohne Angabe, ob amerikanisches oder britisches Englisch, \PValue{american} und -\PValue{USenglish} für Amerikanisch, \PValue{british} und \PValue{UKenglish} -für Britisch), Französisch, Italienisch, Spanisch, Niederländisch, Kroatisch, +\PValue{USenglish} für Amerikanisch, \PValue{british} und \PValue{UKenglish} +für Britisch), Französisch, Italienisch, Spanisch, Niederländisch, Kroatisch, Finnisch, Norwegisch\ChangedAt{v3.02}{\Class{scrlttr2}}, Schwedisch\ChangedAt{v3.08}{\Class{scrlttr2}}, Polnisch\ChangedAt{v3.13}{\Class{scrlttr2}}, @@ -1710,7 +1756,7 @@ und \Package{ngerman}\IndexPackage{ngerman} (siehe \cite{package:ngerman}) besitzen diese Anweisung ebenfalls. In der Regel erfolgt eine Sprachumschaltung jedoch bereits aufgrund des Ladens eines solchen Pakets. \iffalse% Umbruchkorrekturtext!!! -Näheres entnehmen Sie bitte der jeweiligen Anleitung. +Näheres entnehmen Sie bitte der jeweiligen Anleitung. \fi Erlauben\textnote{Achtung!} Sie mir noch einen Hinweis zu den @@ -1718,20 +1764,20 @@ Sprachumschaltpaketen. Das Paket \Package{french}\IndexPackage{french}\important{\Package{french}} (siehe \cite{package:french}) nimmt neben der Umdefinierung der Begriffe aus \autoref{tab:scrlttr2-experts.languageTerms}, -\autopageref{tab:scrlttr2-experts.languageTerms} weitere Änderungen vor. So +\autopageref{tab:scrlttr2-experts.languageTerms} weitere Änderungen vor. So definiert es etwa die Anweisung \DescRef{scrlttr2.cmd.opening} um. Dabei geht es einfach davon aus, dass \DescRef{scrlttr2.cmd.opening} immer wie in der Standardbriefklasse \Class{letter} definiert ist. Dies ist bei \KOMAScript{} -jedoch nicht der Fall. Das Paket \Package{french} zerstört deshalb die +jedoch nicht der Fall. Das Paket \Package{french} zerstört deshalb die Definition und arbeitet nicht korrekt mir \KOMAScript{} zusammen. Ich betrachte dies als Fehler des Pakets \Package{french}, der obwohl schon vor Jahrzehnten gemeldet, leider nie beseitigt wurde. -Wird das Paket \Package{babel}\IndexPackage{babel} für die -Umschaltung auf die Sprache verwendet, können vereinzelt ebenfalls -Probleme auftreten. Bei \Package{babel} lassen sich problematisch Änderungen +Wird das Paket \Package{babel}\IndexPackage{babel} für die +Umschaltung auf die Sprache verwendet, können vereinzelt ebenfalls +Probleme auftreten. Bei \Package{babel} lassen sich problematisch Änderungen einer Sprache jedoch meist gezielt abschalten.% -\iffalse% Das ist eigentlich überholt! +\iffalse% Das ist eigentlich überholt! \ Ist das Paket \Package{french} nicht installiert, ergibt sich das Problem mit \Package{babel} nicht. Ebenfalls existiert das Problem normalerweise nicht, wenn man bei \Package{babel} anstelle der Sprache \PValue{french} @@ -1739,7 +1785,7 @@ einer Sprache jedoch meist gezielt abschalten.% verwendet. \fi -\iffalse% Das ist ebenfalls überholt! +\iffalse% Das ist ebenfalls überholt! Mit Babel ab Version 3.7j tritt dieses Problem jedoch nur noch auf, wenn per Option explizit angegeben wird, dass \Package{babel} das \Package{french}-Paket verwenden soll. @@ -1753,10 +1799,10 @@ Option explizit angegeben wird, dass \Package{babel} das \begin{lstcode} \usepackage[...,francais,...]{babel} \end{lstcode} - französische Sprache auszuwählen. + französische Sprache auszuwählen. \iffalse % Gegebenenfalls ist dann aber trotzdem mit - \Macro{selectlanguage}\PParameter{french} auf Französisch umzuschalten.% + \Macro{selectlanguage}\PParameter{french} auf Französisch umzuschalten.% \fi% \else % \space bei \Package{babel} die Option \Option{frenchb}.% @@ -1766,15 +1812,15 @@ Option explizit angegeben wird, dass \Package{babel} das \iftrue %\enlargethispage*{\baselineskip}% - Es ist nicht auszuschließen, dass mit anderen Sprachen und Paketen ähnliche + Es ist nicht auszuschließen, dass mit anderen Sprachen und Paketen ähnliche Probleme auf"|treten. % \iffalse \iftrue - Für Deutsch sind solche Probleme jedoch nicht bekannt und treten weder + Für Deutsch sind solche Probleme jedoch nicht bekannt und treten weder mit den Paketen \Package{german}\IndexPackage{german} oder \Package{ngerman}\IndexPackage{ngerman} noch mit \Package{babel} auf. \else - Für Deutsch treten solche Probleme mit den Paketen + Für Deutsch treten solche Probleme mit den Paketen \Package{german}\IndexPackage{german}, \Package{ngerman}\IndexPackage{ngerman} oder \Package{babel} jedoch nicht auf. @@ -1804,19 +1850,19 @@ Option explizit angegeben wird, dass \Package{babel} das \Macro{wwwname} \Macro{bankname} \end{Declaration} -Die aufgeführten Anweisungen enthalten die jeweiligen sprachtypischen +Die aufgeführten Anweisungen enthalten die jeweiligen sprachtypischen Begriffe. Diese\important[i]{% \DescRef{scrbase.cmd.newcaptionname}\\ \DescRef{scrbase.cmd.renewcaptionname}\\ - \DescRef{scrbase.cmd.providecaptionname}} können für die Realisierung einer + \DescRef{scrbase.cmd.providecaptionname}} können für die Realisierung einer weiteren Sprache oder aber auch zur eigenen freien Gestaltung wie in -\autoref{sec:scrbase.languageSupport} erklärt angepasst werden. Von -\KOMAScript{} werden die Begriffe erst nach der Präambel, also bei +\autoref{sec:scrbase.languageSupport} erklärt angepasst werden. Von +\KOMAScript{} werden die Begriffe erst nach der Präambel, also bei \Macro{begin}\PParameter{document} gesetzt. Sie sind daher vorher nicht -verfügbar und können vorher auch nicht geändert werden. In +verfügbar und können vorher auch nicht geändert werden. In \autoref{tab:scrlttr2-experts.languageTerms}, \autopageref{tab:scrlttr2-experts.languageTerms} sind die Voreinstellungen -für \Option{english} und \Option{ngerman} zu finden.% +für \Option{english} und \Option{ngerman} zu finden.% \EndIndexGroup %\iffree{}{\clearpage}% Siehe Kommentar zur Tabelle @@ -1850,10 +1896,10 @@ für \Option{english} und \Option{ngerman} zu finden.% \Macro{captionsUKenglish} \Macro{captionsUSenglish} \end{Declaration} -Wird die Sprache eines Briefes gewechselt, so werden über diese +Wird die Sprache eines Briefes gewechselt, so werden über diese Anweisungen die Begriffe aus \autoref{tab:scrlttr2-experts.languageTerms}, \autopageref{tab:scrlttr2-experts.languageTerms} umdefiniert. Sollte das -verwendete Sprachumschaltpaket dies nicht unterstützen, so können obige +verwendete Sprachumschaltpaket dies nicht unterstützen, so können obige Anweisungen notfalls auch direkt verwendet werden.% % \begin{table}% @@ -1863,10 +1909,10 @@ Anweisungen notfalls auch direkt verwendet werden.% \setcapindent{0pt}% %\caption \begin{captionbeside}[{% - Voreinstellungen für die sprachabhängigen Begriffe% + Voreinstellungen für die sprachabhängigen Begriffe% }]{% Voreinstellungen - für die sprachabhängigen Begriffe bei \iffalse Verwendung der \else + für die sprachabhängigen Begriffe bei \iffalse Verwendung der \else den \fi Sprachen \Option{english} und \Option{ngerman} soweit nicht durch die Pakete zur Sprachumschaltung bereits definiert% @@ -1899,8 +1945,8 @@ Anweisungen notfalls auch direkt verwendet werden.% \deffootnote{1em}{1em}{1\ }% brutal aber effektiv \footnotetext[1000]{Diese Begriffe werden normalerweise bereits von Sprachpaketen wie \Package{babel} definiert und dann von - \KOMAScript{} nicht überschrieben. Abweichungen im Wortlaut sind - daher möglich und der Anleitung des verwendeten Sprachpakets zu + \KOMAScript{} nicht überschrieben. Abweichungen im Wortlaut sind + daher möglich und der Anleitung des verwendeten Sprachpakets zu entnehmen.} \end{captionbeside} \end{minipage} @@ -1943,7 +1989,7 @@ Anweisungen notfalls auch direkt verwendet werden.% Je nach verwendeter Sprache werden auch die Datumsangaben\Index{Datum} des nummerischen Datums (siehe Option \DescRef{scrlttr2.option.numericaldate} in \autoref{sec:scrlttr2.firstpage}, \DescPageRef{scrlttr2.option.numericaldate}) -in unterschiedlicher Form umgesetzt. Die genauen Angaben können +in unterschiedlicher Form umgesetzt. Die genauen Angaben können \autoref{tab:date}, \autopageref{tab:date} entnommen werden.% \EndIndexGroup % @@ -1955,7 +2001,7 @@ in unterschiedlicher Form umgesetzt. Die genauen Angaben können \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% % \caption - \begin{captionbeside}{Sprachabhängige Ausgabeformate für das Datum}[l] + \begin{captionbeside}{Sprachabhängige Ausgabeformate für das Datum}[l] \begin{tabular}[t]{ll} \toprule Anweisung & Ausgabebeispiel \\ @@ -2008,17 +2054,17 @@ aktuellen \Class{scrlttr2}} \BeginIndexGroup \BeginIndex{Class}{scrlettr} -Die\textnote{Achtung!} alte Briefklasse \Class{scrlettr} wurde mit Einführung +Die\textnote{Achtung!} alte Briefklasse \Class{scrlettr} wurde mit Einführung von \Class{scrlttr2} (siehe \autoref{cha:scrlttr2}) 2002 obsolet und ist auch nicht mehr Bestandteil von \KOMAScript{}. Wer die Klasse -oder Informationen dazu dennoch benötigt, findet sie in +oder Informationen dazu dennoch benötigt, findet sie in \cite{package:koma-script-obsolete}. Um den Umstieg von der alten auf die neue Klasse zu erleichtern, existiert mit -\Option{KOMAold} eine Kompatibilitätseinstellung. Grundsätzlich ist in der -neuen Klasse die gesamte alte Funktionalität enthalten. Ohne \Option{KOMAold} +\Option{KOMAold} eine Kompatibilitätseinstellung. Grundsätzlich ist in der +neuen Klasse die gesamte alte Funktionalität enthalten. Ohne \Option{KOMAold} ist jedoch die Benutzerschnittstelle eine andere und auch die Voreinstellungen -stimmen nicht überein. Näheres dazu ist \autoref{sec:scrlttr2.lcoFile}, +stimmen nicht überein. Näheres dazu ist \autoref{sec:scrlttr2.lcoFile}, \autoref{tab:lcoFiles} zu entnehmen. \LoadNonFree{scrlttr2-experts}{2} @@ -2033,16 +2079,16 @@ stimmen nicht überein. Näheres dazu ist \autoref{sec:scrlttr2.lcoFile}, %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "guide.tex" %%% End: -% LocalWords: Pseudolänge Pseudolängen Rücksendeadresse Faltmarke Briefseite -% LocalWords: Sternvariante Geschäftszeile Testfeld Kopfbereich Vergleichsmaß -% LocalWords: Dokumenterstellungsprozess Fußbereich Anschriftfenster Falt -% LocalWords: Absenderergänzung Kundennummer Rechnungsnummer Falzmarken +% LocalWords: Pseudolänge Pseudolängen Rücksendeadresse Faltmarke Briefseite +% LocalWords: Sternvariante Geschäftszeile Testfeld Kopfbereich Vergleichsmaß +% LocalWords: Dokumenterstellungsprozess Fußbereich Anschriftfenster Falt +% LocalWords: Absenderergänzung Kundennummer Rechnungsnummer Falzmarken % LocalWords: Sprachumschaltpaketen Standardbriefklasse Seitenstilen -% LocalWords: Paginierung Paginierungen Papiergröße Anschriftfeldes -% LocalWords: Versandart Anschriftfensters Anschriftfeld Briefköpfe -% LocalWords: Variableninhalt Schlussgruß Briefbogenfuß +% LocalWords: Paginierung Paginierungen Papiergröße Anschriftfeldes +% LocalWords: Versandart Anschriftfensters Anschriftfeld Briefköpfe +% LocalWords: Variableninhalt Schlussgruß Briefbogenfuß diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex index aa710572be..0e558f33bb 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlttr2.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrlttr2 in der KOMA-Script-Anleitung +% Kapitel über scrlttr2 in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrlttr2.tex}% - [$Date: 2018-04-26 14:55:38 +0200 (Thu, 26 Apr 2018) $ + [$Date: 2019-10-10 10:25:29 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrlttr2)] \chapter{Briefe mit Klasse \Class{scrlttr2} oder Paket \Package{scrletter}} @@ -56,41 +56,41 @@ \BeginIndex{Class}{scrlttr2}\BeginIndex{Package}{scrletter}% \BeginIndex{}{Briefe}% Briefe sind in vielerlei Hinsicht etwas ganz anderes als Artikel, Berichte, -Bücher oder Ähnliches. Schon allein deshalb gibt es für Briefe ein eigenes -Kapitel. Aber auch aus weiteren Gründen ist ein eigenes Kapitel für +Bücher oder Ähnliches. Schon allein deshalb gibt es für Briefe ein eigenes +Kapitel. Aber auch aus weiteren Gründen ist ein eigenes Kapitel für \Class{scrlttr2} und \Package{scrletter} gerechtfertigt. Die Klasse \Class{scrlttr2}\important{\Class{scrlttr2}} wurde 2002 von Grund auf neu entwickelt. Sie hat daher auch ein komplett anderes Bedienkonzept als -alle übrigen mir bekannten Klassen. Die neue Art der Bedienung ist -möglicherweise etwas ungewohnt, bietet jedoch nicht nur dem geübten Anwender +alle übrigen mir bekannten Klassen. Die neue Art der Bedienung ist +möglicherweise etwas ungewohnt, bietet jedoch nicht nur dem geübten Anwender einige Vorteile. Das Paket \Package{scrletter}\important{\Package{scrletter}}% -\ChangedAt{v3.15}{\Package{scrletter}} wiederum verstärkt \KOMAScript{} seit -Version 3.15. Es stellt die gesamte auf Briefe ausgelegte Funktionalität von -\Class{scrlttr2} auch für andere Klassen bereit. Empfohlen wird die Verwendung +\ChangedAt{v3.15}{\Package{scrletter}} wiederum verstärkt \KOMAScript{} seit +Version 3.15. Es stellt die gesamte auf Briefe ausgelegte Funktionalität von +\Class{scrlttr2} auch für andere Klassen bereit. Empfohlen wird die Verwendung mit einer der \KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} oder -\Class{scrartcl}, die im vorherigen Kapitel erklärt sind. Mit geringfügigen -Einschränkungen funktioniert \Package{scrletter} aber auch mit den +\Class{scrartcl}, die im vorherigen Kapitel erklärt sind. Mit geringfügigen +Einschränkungen funktioniert \Package{scrletter} aber auch mit den Standardklassen. -Ausgangspunkt für die Entwicklung von \Package{scrletter} waren einerseits +Ausgangspunkt für die Entwicklung von \Package{scrletter} waren einerseits Nachfragen von Anwendern, die Elemente wie -Gliederungsüberschriften,\textnote{Überschriften, Gleitumgebungen, +Gliederungsüberschriften,\textnote{Ãœberschriften, Gleitumgebungen, Verzeichnisse} Gleitumgebungen oder ein Literaturverzeichnis auch in Briefen -haben wollten. Umgekehrt gab es auch Wünsche nach der Verwendung der Variablen -von \Class{scrlttr2} in den übrigen \KOMAScript-Klassen. Beides ist durch eine -Kombination der gewünschten \KOMAScript-Klasse mit \Package{scrletter} -möglich. +haben wollten. Umgekehrt gab es auch Wünsche nach der Verwendung der Variablen +von \Class{scrlttr2} in den übrigen \KOMAScript-Klassen. Beides ist durch eine +Kombination der gewünschten \KOMAScript-Klasse mit \Package{scrletter} +möglich. -Gegenüber der Briefklasse hat das Briefpaket einige, kleine Änderungen, die +Gegenüber der Briefklasse hat das Briefpaket einige, kleine Änderungen, die notwendig waren, um Konflikte mit den anderen Klassen zu vermeiden. Diese betreffen vor allem die Seitenstile und sind explizit dokumentiert (siehe \autoref{sec:\LabelBase.pagestyle}, ab \autopageref{sec:\LabelBase.pagestyle}). Wo \Package{scrletter} nicht explizit -erwähnt ist, gilt dafür alles, was für \Class{scrlttr2} dokumentiert ist, ohne -Änderung. +erwähnt ist, gilt dafür alles, was für \Class{scrlttr2} dokumentiert ist, ohne +Änderung. \section{Variablen} @@ -98,52 +98,52 @@ erwähnt ist, gilt dafür alles, was für \Class{scrlttr2} dokumentiert ist, ohne \BeginIndexGroup \BeginIndex{}{Variablen}% -Neben Optionen, Anweisungen (oder Befehlen), Umgebungen, Zählern und Längen -wurden in \autoref{cha:maincls} für \KOMAScript{} bereits zusätzlich Elemente -eingeführt. Eine typische Eigenschaft eines Elements ist seine Schriftart und -die Möglichkeit, diese zu ändern (siehe \autoref{sec:\LabelBase.textmarkup}, +Neben Optionen, Anweisungen (oder Befehlen), Umgebungen, Zählern und Längen +wurden in \autoref{cha:maincls} für \KOMAScript{} bereits zusätzlich Elemente +eingeführt. Eine typische Eigenschaft eines Elements ist seine Schriftart und +die Möglichkeit, diese zu ändern (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}). An dieser Stelle werden nun -zusätzlich Variablen eingeführt. Variablen haben einen -Namen\Index{Variablen>Name}\textnote{Namen}, über den sie angesprochen werden, +zusätzlich Variablen eingeführt. Variablen haben einen +Namen\Index{Variablen>Name}\textnote{Namen}, über den sie angesprochen werden, und einen Inhalt\Index{Variablen>Inhalt}\textnote{Inhalt}. Der Inhalt einer -Variablen kann zeitlich bzw. räumlich getrennt von ihrer Verwendung gesetzt -werden, so wie der Inhalt einer Anweisung getrennt von ihrer Ausführung +Variablen kann zeitlich bzw. räumlich getrennt von ihrer Verwendung gesetzt +werden, so wie der Inhalt einer Anweisung getrennt von ihrer Ausführung definiert werden kann. Ein Hauptunterschied einer Variablen zu einer Anweisung -besteht darin, dass eine Anweisung normalerweise eine Aktion auslöst, während +besteht darin, dass eine Anweisung normalerweise eine Aktion auslöst, während der Inhalt einer Variablen normalerweise aus einem Text besteht, der dann von -einer Anweisung ausgegeben wird. Außerdem kann eine Variable zusätzlich eine +einer Anweisung ausgegeben wird. Außerdem kann eine Variable zusätzlich eine Bezeichnung\Index{Variablen>Bezeichnung}\textnote{Bezeichnung} besitzen, die ebenfalls gesetzt und ausgegeben werden kann. -Dieser Abschnitt beschränkt sich bewusst auf die Einführung des Begriffs der +Dieser Abschnitt beschränkt sich bewusst auf die Einführung des Begriffs der Variablen. Die zur Verdeutlichung verwendeten Beispiele sind ohne tiefere -Bedeutung. Konkretere Anwendungsbeispiele gibt es bei der Erläuterung der in +Bedeutung. Konkretere Anwendungsbeispiele gibt es bei der Erläuterung der in der Klasse und Paket bereits definierten und von ihnen verwendeten Variablen in den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine -Übersicht über alle definierten Variablen. +Ãœbersicht über alle definierten Variablen. % \begin{desclist} - \desccaption{Von \Class{scrlttr2} und \Package{scrletter} unterstützte + \desccaption{Von \Class{scrlttr2} und \Package{scrletter} unterstützte Variablen\label{tab:\LabelBase.variables}}% - {Von \Class{scrlttr2} und \Package{scrletter} unterstützte Variablen + {Von \Class{scrlttr2} und \Package{scrletter} unterstützte Variablen (\emph{Fortsetzung})}% \ventry{addresseeimage}{Anweisungen, die zum Setzen - des Port-Payé-Kopfes bei der Einstellung + des Port-Payé-Kopfes bei der Einstellung \OptionValueRef{\LabelBase}{addrfield}{backgroundimage} oder der - Port-Payé-Anschrift bei der Einstellung + Port-Payé-Anschrift bei der Einstellung \OptionValueRef{\LabelBase}{addrfield}{image}, verwendet werden (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.addresseeimage})}% - \ventry{backaddress}{Rücksendeadresse für Fensterbriefumschläge + \ventry{backaddress}{Rücksendeadresse für Fensterbriefumschläge (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.backaddress})}% - \ventry{backaddressseparator}{Trennzeichen innerhalb der Rücksendeadresse + \ventry{backaddressseparator}{Trennzeichen innerhalb der Rücksendeadresse (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.backaddressseparator})}% \ventry{ccseparator}{Trennzeichen zwischen Verteilertitel und Verteiler (\autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.variable.ccseparator})}% - \ventry{customer}{Geschäftszeilenfeld »Kundennummer« + \ventry{customer}{Geschäftszeilenfeld »Kundennummer« (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.customer})}% \ventry{date}{Datum (\autoref{sec:\LabelBase.firstpage}, @@ -158,7 +158,7 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.faxseparator})}% \ventry{firstfoot}{% - Seitenfuß\ChangedAt{v3.08}{\Class{scrlttr2}} des Briefbogens + Seitenfuß\ChangedAt{v3.08}{\Class{scrlttr2}} des Briefbogens (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.firstfoot})}% \ventry{firsthead}{% @@ -184,7 +184,7 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \ChangedAt{v3.12}{\Class{scrlttr2}}% Handynummer des Absenders (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.frommobilephone})}% - \ventry{fromname}{vollständiger Absendername + \ventry{fromname}{vollständiger Absendername (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.fromname})}% \ventry{fromphone}{Telefonnummer des Absenders @@ -192,11 +192,11 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \DescPageRef{\LabelBase.variable.fromphone})}% \ventry{fromurl}{eine URL des Absenders (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.fromurl})}% - \ventry{fromzipcode}{Postleitzahl des Absenders für den Port-Payé-Kopf bei + \ventry{fromzipcode}{Postleitzahl des Absenders für den Port-Payé-Kopf bei \OptionValueRef{\LabelBase}{addrfield}{PP} (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.fromzipcode})}% - \ventry{invoice}{Geschäftszeilenfeld »Rechnungsnummer« + \ventry{invoice}{Geschäftszeilenfeld »Rechnungsnummer« (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.invoice})}% \ventry{location}{erweiterte Absenderangabe @@ -205,10 +205,10 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \ventry{mobilephoneseparator}{Trennzeichen zwischen Handybezeichner und Handynummer (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.mobilephoneseparator})}% - \ventry{myref}{Geschäftszeilenfeld »Mein Zeichen« + \ventry{myref}{Geschäftszeilenfeld »Mein Zeichen« (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.myref})}% - \ventry{nextfoot}{Seitenfuß\ChangedAt{v3.08}{\Class{scrlttr2}} im Seitenstil + \ventry{nextfoot}{Seitenfuß\ChangedAt{v3.08}{\Class{scrlttr2}} im Seitenstil \PageStyle{headings}\IndexPagestyle{headings} oder \PageStyle{myheadings}\IndexPagestyle{myheadings} (\autoref{sec:\LabelBase.pagestyle}, @@ -234,7 +234,7 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \OptionValueRef{\LabelBase}{addrfield}{PP} (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.PPcode})}% - \ventry{signature}{Signatur unter Unterschrift und Grußformel + \ventry{signature}{Signatur unter Unterschrift und Grußformel (\autoref{sec:\LabelBase.closing}, \DescPageRef{\LabelBase.variable.signature})}% \ventry{specialmail}{Versandart (\autoref{sec:\LabelBase.firstpage}, @@ -246,16 +246,16 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \DescPageRef{\LabelBase.variable.subjectseparator})}% \ventry{title}{Brief"|titel (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.title})}% - \ventry{toaddress}{Empfängeradresse ohne Empfängername + \ventry{toaddress}{Empfängeradresse ohne Empfängername (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.toaddress})}% - \ventry{toname}{vollständiger Empfängername + \ventry{toname}{vollständiger Empfängername (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.toname})}% - \ventry{yourmail}{Geschäftszeilenfeld »Ihr Schreiben« + \ventry{yourmail}{Geschäftszeilenfeld »Ihr Schreiben« (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.yourmail})}% - \ventry{yourref}{Geschäftszeilenfeld »Ihr Zeichen« + \ventry{yourref}{Geschäftszeilenfeld »Ihr Zeichen« (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.yourref})}% \ventry{zipcodeseparator}{Trennzeichen zwischen der Bezeichnung und dem @@ -272,20 +272,20 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \end{Declaration} Mit der Anweisung \Macro{setkomavar} wird der \PName{Inhalt} der Variablen \PName{Name} gesetzt. Dabei kann per optionalem Argument gleichzeitig auch die -\PName{Bezeichnung} der Variablen geändert werden. Demgegenüber kann mit der +\PName{Bezeichnung} der Variablen geändert werden. Demgegenüber kann mit der Sternvariante \Macro{setkomavar*} auch nur die \PName{Bezeichnung} der Variablen \PName{Name} gesetzt werden. \begin{Example} - In Briefen ist es üblich, den Absender im Briefkopf stehen zu haben. Dazu - muss \KOMAScript{} den Absender aber erst einmal mit Namen kennen. Für - »Peter Musterfrau« ginge das einfach mit: + In Briefen ist es üblich, den Absender im Briefkopf stehen zu haben. Dazu + muss \KOMAScript{} den Absender aber erst einmal mit Namen kennen. Für + »Peter Musterfrau« ginge das einfach mit: \begin{lstcode} \setkomavar{fromname}{Peter Musterfrau} \end{lstcode} - Die voreingestellte Bezeichnung für den Namen des Absenders ist - »Von«. Angenommen, Herr Musterfrau will aber an den Stellen, an denen - \KOMAScript{} diese Bezeichnung verwendet, lieber »Absender« haben, so - müsste er zusätzlich + Die voreingestellte Bezeichnung für den Namen des Absenders ist + »Von«. Angenommen, Herr Musterfrau will aber an den Stellen, an denen + \KOMAScript{} diese Bezeichnung verwendet, lieber »Absender« haben, so + müsste er zusätzlich \begin{lstcode} \setkomavar*{fromname}{Absender} \end{lstcode} @@ -293,25 +293,25 @@ Variablen \PName{Name} gesetzt werden. \begin{lstcode} \setkomavar{fromname}[Absender]{Peter Musterfrau} \end{lstcode} - Damit schlägt er sozusagen zwei Fliegen mit einer Klappe. + Damit schlägt er sozusagen zwei Fliegen mit einer Klappe. \end{Example} -Übrigens kann mit einem leeren obligatorischen Argument \PName{Inhalt} -der Inhalt der Variable gelöscht werden. Selbstverständlich kann in +Ãœbrigens kann mit einem leeren obligatorischen Argument \PName{Inhalt} +der Inhalt der Variable gelöscht werden. Selbstverständlich kann in gleicher Weise mit einem leeren Argument \PName{Bezeichnung} auch die -Bezeichnung der Variablen gelöscht werden. +Bezeichnung der Variablen gelöscht werden. \begin{Example} - Angenommen, Herr Musterfrau will gar keine Bezeichnung für den Namen des - Absenders haben. Dann könnte er diese entweder für sich mit: + Angenommen, Herr Musterfrau will gar keine Bezeichnung für den Namen des + Absenders haben. Dann könnte er diese entweder für sich mit: \begin{lstcode} \setkomavar*{fromname}{} \end{lstcode} - löschen. Er könnte aber auch wieder zwei Fliegen mit einer Klappe + löschen. Er könnte aber auch wieder zwei Fliegen mit einer Klappe schlagen und \begin{lstcode} \setkomavar{fromname}[]{Peter Musterfrau} \end{lstcode} verwenden. Dadurch wird gleichzeitig der Inhalt der Variablen gesetzt und - ihre Bezeichnung gelöscht. + ihre Bezeichnung gelöscht. \end{Example} % \EndIndexGroup @@ -321,13 +321,13 @@ Bezeichnung der Variablen gelöscht werden. \Macro{usekomavar}\OParameter{Anweisung}\Parameter{Name} \Macro{usekomavar*}\OParameter{Anweisung}\Parameter{Name} \end{Declaration} -In\ChangedAt{v2.9i}{\Class{scrlttr2}} manchen Fällen wird es notwendig sein, +In\ChangedAt{v2.9i}{\Class{scrlttr2}} manchen Fällen wird es notwendig sein, selbst auf den Inhalt oder die Bezeichnung einer Variablen zuzugreifen, dies -also nicht allein der Klasse zu überlassen. Das gilt insbesondere dann, wenn -Sie eigene Variablen definiert haben, die nicht zur Geschäftszeile -hinzugefügt werden. Mit der Anweisung \Macro{usekomavar} können Sie auf den -Inhalt der Variablen \PName{Name} zugreifen, während Sie mit der Sternvariante -\Macro{usekomavar*} ihre Bezeichnung erhalten. Näheres zur Definition eigener +also nicht allein der Klasse zu überlassen. Das gilt insbesondere dann, wenn +Sie eigene Variablen definiert haben, die nicht zur Geschäftszeile +hinzugefügt werden. Mit der Anweisung \Macro{usekomavar} können Sie auf den +Inhalt der Variablen \PName{Name} zugreifen, während Sie mit der Sternvariante +\Macro{usekomavar*} ihre Bezeichnung erhalten. Näheres zur Definition eigener Variablen ist \autoref{sec:scrlttr2-experts.variables}, \DescPageRef{scrlttr2-experts.cmd.newkomavar} zu entnehmen.% \EndIndexGroup @@ -338,9 +338,9 @@ Variablen ist \autoref{sec:scrlttr2-experts.variables}, \end{Declaration} Mit\ChangedAt{v3.03}{\Class{scrlttr2}} dieser Anweisung kann man feststellen, ob eine Variable definiert ist. Der \PName{Dann-Teil} wird nur dann -ausgeführt, wenn die Variable existiert. Dabei wird der Inhalt der Variablen +ausgeführt, wenn die Variable existiert. Dabei wird der Inhalt der Variablen nicht getestet, kann also auch leer sein. Der \PName{Sonst-Teil} wird hingegen -ausgeführt, wenn die Variable nicht existiert. Solche Tests können +ausgeführt, wenn die Variable nicht existiert. Solche Tests können beispielsweise dann sinnvoll sein, wenn eigene Variablen in einer \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} (siehe \autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) @@ -357,61 +357,61 @@ verwendet werden soll, wenn sie existiert. \end{Declaration} Mit\ChangedAt{v2.9i}{\Class{scrlttr2}} Hilfe dieser Anweisungen kann man feststellen, ob der Inhalt oder die Bezeichnung einer Variablen leer -ist oder nicht. Der \PName{Dann-Teil} wird nur dann ausgeführt, +ist oder nicht. Der \PName{Dann-Teil} wird nur dann ausgeführt, wenn der expandierte Inhalt oder die expandierte Bezeichnung der Variablen \PName{Name} leer ist. Anderenfalls wird der -\PName{Sonst-Teil} ausgeführt. Die Sternvariante der Anweisung -bezieht sich dabei auf die Bezeichnung der Variablen, während die +\PName{Sonst-Teil} ausgeführt. Die Sternvariante der Anweisung +bezieht sich dabei auf die Bezeichnung der Variablen, während die normale Variante den Inhalt behandelt.% \EndIndexGroup % \EndIndexGroup -\section{Pseudolängen} +\section{Pseudolängen} \seclabel{pseudoLength} \BeginIndexGroup -\BeginIndex{}{Pseudolängen} +\BeginIndex{}{Pseudolängen} -Längen werden bei \LaTeX{} mit den drei Anweisungen +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. +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 +Eine Liste aller in \Class{scrlttr2} definierten Pseudolängen findet sich in \autoref{tab:scrlttr2-experts.pseudoLengths}, \autopageref{tab:scrlttr2-experts.pseudoLengths}. Eine grafische Darstellung -der Bedeutungen der wichtigsten Pseudolängen des Briefbogens ist +der Bedeutungen der wichtigsten Pseudolängen des Briefbogens ist \autoref{fig:scrlttr2-experts.pseudoLengths}, \autopageref{fig:scrlttr2-experts.pseudoLengths} zu entnehmen. Die verwendeten -Maße sind dabei an die Voreinstellungen von \Class{scrlttr2} angelehnt. Nähere -Beschreibungen zu den einzelnen Pseudolängen finden sich in den einzelnen +Maße sind dabei an die Voreinstellungen von \Class{scrlttr2} angelehnt. Nähere +Beschreibungen zu den einzelnen Pseudolängen finden sich in den einzelnen Abschnitten dieses Kapitels. -Da der Anwender normalerweise keine eigenen Pseudolängen definieren muss, wird +Da der Anwender normalerweise keine eigenen Pseudolängen definieren muss, wird dieser Teil nicht hier, sondern im Expertenteil in \autoref{sec:scrlttr2-experts.pseudoLengths}, \DescPageRef{scrlttr2-experts.cmd.newplength} behandelt. Ebenso ist das -Setzen von Pseudolängen eher dem fortgeschrittenen Anwender vorbehalten. Also -wird auch dies im Abschnitt für Experten ab -\DescPageRef{scrlttr2-experts.cmd.setplength} erklärt. +Setzen von Pseudolängen eher dem fortgeschrittenen Anwender vorbehalten. Also +wird auch dies im Abschnitt für Experten ab +\DescPageRef{scrlttr2-experts.cmd.setplength} erklärt. -Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar +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! +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} \end{Declaration} -Mit Hilfe dieser Anweisung wird auf den Wert der Pseudolänge mit dem +Mit Hilfe dieser Anweisung wird auf den Wert der Pseudolänge mit dem angegebenen \PName{Namen} zugegriffen. Dies ist eine der wenigen -Benutzeranweisung rund um Pseudolängen. Natürlich kann diese Anweisung dennoch +Benutzeranweisung rund um Pseudolängen. Natürlich kann diese Anweisung dennoch auch innerhalb einer \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} (siehe \autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) verwendet werden.% @@ -421,17 +421,17 @@ verwendet werden.% \begin{Declaration} \Macro{setlengthtoplength} - \OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge} + \OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge} \Macro{addtolengthplength} - \OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge} + \OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge} \end{Declaration} 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. % +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. @@ -442,16 +442,16 @@ einer \PName{Pseudolänge} zuweisen will. % \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.% +arbeitet ähnlich. Nur wird die mit \PName{Faktor} multiplizierte +\PName{Pseudolänge} zur \PName{Länge} addiert.% % \EndIndexGroup % \EndIndexGroup -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} -\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} +\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} %\iffree{}{\vfill}% Umbruchoptimierung! @@ -461,18 +461,18 @@ arbeitet ähnlich. Nur wird die mit \PName{Faktor} multiplizierte Die Unterscheidung zwischen ein- und doppelseitigem Satz ist bei Briefen jedoch in der Regel nicht sinnvoll. Da Briefe normalerweise nicht gebunden -werden, betrachtet man bei Briefen jede Seite für sich. Das gilt auch dann, -wenn ausnahmsweise Vorder- oder Rückseite bedruckt werden. Daher spielt bei +werden, betrachtet man bei Briefen jede Seite für sich. Das gilt auch dann, +wenn ausnahmsweise Vorder- oder Rückseite bedruckt werden. Daher spielt bei Briefen normalerweise auch der vertikale Ausgleich keine Rolle. Sollten Sie -diesen trotzdem benötigen +diesen trotzdem benötigen \iffalse% % Umbruchkorrekturtext oder wissen wollen, was das ist, % \fi% sei auf die in \autoref{sec:maincls.typearea}, -\DescPageRef{maincls.cmd.flushbottom} erklärten Anweisungen -\DescRef{maincls.cmd.raggedbottom} und \DescRef{maincls.cmd.flushbottom} -verwiesen.% +\DescPageRef{maincls.cmd.flushbottom} erklärten Anweisungen +\DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} und +\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} verwiesen.% % \EndIndexGroup @@ -483,8 +483,8 @@ verwiesen.% \BeginIndex{}{Briefe>Aufbau} Der generelle Aufbau eines Briefdokuments weicht etwas vom Aufbau eines -normalen Dokuments ab. Während ein Buchdokument normalerweise nur ein Buch -enthält, kann ein einzelnes Briefdokument mehrere Briefe enthalten. Wie in +normalen Dokuments ab. Während ein Buchdokument normalerweise nur ein Buch +enthält, kann ein einzelnes Briefdokument mehrere Briefe enthalten. Wie in \autoref{fig:\LabelBase.document} veranschaulicht wird, besteht ein Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. @@ -503,15 +503,15 @@ Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. \fbox{\parbox{\linewidth}{\raggedright% \Macro{documentclass}\OParameter{\dots}\PParameter{scrlttr2}\\ \dots\\ - {\centering\emph{Einstellungen für alle Briefe}\\} + {\centering\emph{Einstellungen für alle Briefe}\\} \dots\\ \Macro{begin}\PParameter{document}\\ \dots\\ - {\centering\emph{Einstellungen für alle Briefe}\\} + {\centering\emph{Einstellungen für alle Briefe}\\} \dots\\ }}\\ \fbox{\parbox{\linewidth}{\raggedright% - \Macro{begin}\PParameter{letter}\Parameter{Empfänger}\\ + \Macro{begin}\PParameter{letter}\Parameter{Empfänger}\\ \dots\\ {\centering\emph{Inhalt eines einzelnen Briefes}\\} \dots\\ @@ -526,18 +526,18 @@ Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. \end{figure} Der Vorspann beinhaltet dabei alle Einstellungen, die generell alle Briefe -betreffen. Diese können in den Einstellungen der einzelnen Briefe jedoch -zumindest teilweise überschrieben werden. Die einzige Einstellung, die derzeit -nicht innerhalb eines einzelnen Briefes überschrieben werden kann, ist die -Version von \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}, zu der Kompatibilität +betreffen. Diese können in den Einstellungen der einzelnen Briefe jedoch +zumindest teilweise überschrieben werden. Die einzige Einstellung, die derzeit +nicht innerhalb eines einzelnen Briefes überschrieben werden kann, ist die +Version von \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}, zu der Kompatibilität erreicht werden soll (siehe Option \DescRef{\LabelBase.option.version} in \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}). -Bei Verwendung von \Package{scrletter}\important{scrletter} ändert sich -lediglich, dass eine andere Klasse geladen und dafür zusätzlich +Bei Verwendung von \Package{scrletter}\important{scrletter} ändert sich +lediglich, dass eine andere Klasse geladen und dafür zusätzlich \DescRef{\LabelBase.cmd.usepackage}\PParameter{scrletter} noch vor den -Einstellungen für alle Briefe einzufügen ist. Für das Setzen von Optionen für +Einstellungen für alle Briefe einzufügen ist. Für das Setzen von Optionen für \Package{scrletter} sei auf \autoref{sec:\LabelBase.options}, ab \autopageref{sec:\LabelBase.options} verwiesen. @@ -547,12 +547,12 @@ vorzunehmen. Alle Einstellungen, die das Setzen einer Variablen oder sonstige Textangaben beinhalten, sollten nach \Macro{begin}\PParameter{document} vorgenommen werden. Dies empfiehlt\textnote{Tipp!} sich umso mehr, wenn das Babel-Paket\IndexPackage{babel} (siehe \cite{package:babel}) verwendet wird -oder sprachabhängige Variablen von \Class{scrlttr2} oder \Package{scrletter} -verändert werden sollen. +oder sprachabhängige Variablen von \Class{scrlttr2} oder \Package{scrletter} +verändert werden sollen. Der Abschluss besteht in der Regel nur aus -\Macro{end}\PParameter{document}. Natürlich können Sie dort aber auch -zusätzliche Kommentare einfügen. +\Macro{end}\PParameter{document}. Natürlich können Sie dort aber auch +zusätzliche Kommentare einfügen. \begin{figure} \KOMAoptions{captions=bottombeside}% @@ -567,9 +567,9 @@ zusätzliche Kommentare einfügen. \addtolength{\linewidth}{-\dimexpr2\fboxrule+2\fboxsep\relax}% \fbox{\parbox{\linewidth}{\raggedright% \Macro{begin}\PParameter{letter}% - \OParameter{Optionen}\Parameter{Empfänger}\\ + \OParameter{Optionen}\Parameter{Empfänger}\\ \dots\\[\dp\strutbox] - {\centering\emph{Einstellungen für diesen Brief}\\} + {\centering\emph{Einstellungen für diesen Brief}\\} \dots\\ \DescRef{\LabelBase.cmd.opening}\Parameter{Anrede}\\ }}\\[1pt] @@ -579,7 +579,7 @@ zusätzliche Kommentare einfügen. \dots\\ }}\\[1pt] \fbox{\parbox{\linewidth}{\raggedright% - \DescRef{\LabelBase.cmd.closing}\Parameter{Grußformel}\\ + \DescRef{\LabelBase.cmd.closing}\Parameter{Grußformel}\\ \DescRef{\LabelBase.cmd.ps}\\ \dots\\[\dp\strutbox] {\centering\emph{Postscriptum}\\} @@ -595,57 +595,57 @@ zusätzliche Kommentare einfügen. Wie in \autoref{fig:\LabelBase.letter} verdeutlicht wird, bestehen die einzelnen Briefe wiederum aus einer Einleitung, dem eigentlichen Brief"|text und einem Schlussteil. In der Einleitung werden alle Einstellungen -vorgenommen, die nur für diesen einen Brief gelten sollen. Entscheidend ist +vorgenommen, die nur für diesen einen Brief gelten sollen. Entscheidend ist hierbei, dass diese Einleitung immer mit \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} endet. Ebenso beginnt der Schlussteil immer mit -\DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Gegebenenfalls können die -Argumente \PName{Anrede} und \PName{Grußformel} der beiden Anweisungen leer -bleiben, die Anweisungen müssen jedoch gesetzt werden und haben immer ein +\DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Gegebenenfalls können die +Argumente \PName{Anrede} und \PName{Grußformel} der beiden Anweisungen leer +bleiben, die Anweisungen müssen jedoch gesetzt werden und haben immer ein Argument. Es soll an dieser Stelle nicht verschwiegen werden, dass zwischen den -einzelnen Briefen weitere Einstellungen getroffen werden können. Diese -gelten dann für alle nachfolgenden Briefe. Um Briefdokumente -übersichtlich und wartbar zu halten, sollte man sich jedoch gut -überlegen, ob man zwischen die Briefe tatsächlich weitere generelle -Einstellungen mit beschränkter Gültigkeit setzen will. Ich kann dies +einzelnen Briefen weitere Einstellungen getroffen werden können. Diese +gelten dann für alle nachfolgenden Briefe. Um Briefdokumente +übersichtlich und wartbar zu halten, sollte man sich jedoch gut +überlegen, ob man zwischen die Briefe tatsächlich weitere generelle +Einstellungen mit beschränkter Gültigkeit setzen will. Ich kann dies nicht empfehlen% \iffalse -% Umbruchergänzungstext +% Umbruchergänzungstext , da die Suche nach Einstellungen dadurch erschwert wird% \fi % . Dagegen spricht bei Verwendung von \Package{scrletter2} nichts dagegen, vor, -zwischen oder nach Briefen weitere Dokumentteile einzufügen, die nicht im +zwischen oder nach Briefen weitere Dokumentteile einzufügen, die nicht im Briefkontext stehen sollen. So kann man beispielsweise Anschreiben und Lebenslauf in einem Dokument zusammenfassen. \begin{Declaration} - \begin{Environment}{letter}\OParameter{Optionen}\Parameter{Empfänger} + \begin{Environment}{letter}\OParameter{Optionen}\Parameter{Empfänger} \end{Environment} \end{Declaration} \BeginIndex{}{Anschrift}% Die Briefumgebung \Environment{letter} ist einer der zentralen Dreh- und Angelpunkte der Briefklasse und des Briefpakets. Als Besonderheit\textnote{\KOMAScript{} vs. Standardklassen} kann man bei -\Class{scrlttr2} und \Package{scrletter} der Briefumgebung zusätzliche +\Class{scrlttr2} und \Package{scrletter} der Briefumgebung zusätzliche \PName{Optionen} mit auf den Weg geben. Diese werden dann intern per -\DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt. +\DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt. -Der \PName{Empfänger} wird als obligatorischer Parameter an die Umgebung -übergeben. Dabei\textnote{Achtung!} dient der doppelte Backslash als +Der \PName{Empfänger} wird als obligatorischer Parameter an die Umgebung +übergeben. Dabei\textnote{Achtung!} dient der doppelte Backslash als Trennzeichen zwischen einzelnen Teilen der Anschrift. Diese einzelnen Teile werden im Anschriftfeld als einzelne Zeilen ausgegeben. Dennoch sollte der doppelte Backslash hier nicht als fester Zeilenumbruch verstanden -werden. Absätze, vertikaler Leerraum und Ähnliches sind in der Anschrift nicht -erlaubt. Sie können zu unerwarteten Effekten und Fehlermeldungen führen. Dies -ist übrigens bei der Standardbriefklasse genauso. +werden. Absätze, vertikaler Leerraum und Ähnliches sind in der Anschrift nicht +erlaubt. Sie können zu unerwarteten Effekten und Fehlermeldungen führen. Dies +ist übrigens bei der Standardbriefklasse genauso. \begin{Example} \phantomsection\label{desc:\LabelBase.env.letter.example}% Angenommen, jemand wollte einen Brief an Petra Mustermann schreiben. - Ein minimalistisches Briefdokument dafür würde so aussehen: + Ein minimalistisches Briefdokument dafür würde so aussehen: \begin{lstcode} \documentclass[version=last]{scrlttr2} \usepackage[ngerman]{babel} @@ -656,12 +656,18 @@ ist übrigens bei der Standardbriefklasse genauso. \end{letter} \end{document} \end{lstcode} - Allerdings\textnote{Achtung!} würde dabei noch keinerlei Ausgabe - entstehen. Es würde noch nicht einmal die Anschrift auf dem Briefbogen - ausgegeben. Warum das so ist, erfahren Sie bei der Erklärung zur Anweisung + Allerdings\textnote{Achtung!} würde dabei noch keinerlei Ausgabe + entstehen. Es würde noch nicht einmal die Anschrift auf dem Briefbogen + ausgegeben. Warum das so ist, erfahren Sie bei der Erklärung zur Anweisung \DescRef{\LabelBase.cmd.opening} auf \DescPageRef{\LabelBase.cmd.opening}. \end{Example} -% + +Briefe\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} werden immer +einspaltig und ohne vertikalen Ausgleich gesetzt. Letzteres kann man mit Hilfe +von \DescRef{\LabelBase.cmd.AtBeginLetter} und der in +\autoref{sec:maincls.typearea}, \DescPageRef{maincls.cmd.flushbottom} +erklärten Anweisungen \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} +ändern.% \EndIndexGroup @@ -670,33 +676,33 @@ ist übrigens bei der Standardbriefklasse genauso. \Macro{AtEndLetter}\Parameter{Anweisungen} \end{Declaration} \iftrue% Umbruchvarianten -Wie\textnote{Haken}\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, -gibt es bei \LaTeX{} die Möglichkeit, zu bestimmten Gelegenheiten während des -\LaTeX-Laufs eines Dokuments zusätzliche \PName{Anweisungen} ausführen zu +Wie\textnote{Haken}\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, +gibt es bei \LaTeX{} die Möglichkeit, zu bestimmten Gelegenheiten während des +\LaTeX-Laufs eines Dokuments zusätzliche \PName{Anweisungen} ausführen zu lassen. Zu diesem Zweck stellt der \LaTeX-Kern beispielsweise die Anweisungen \Macro{AtEndOfClass}\IndexCmd{AtEndOfClass} und -\Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt +\Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt solche Eingriffspunkte auch \emph{hooks}\Index{hook=\emph{hook}}, also -Haken. Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} fügen +Haken. Die Klasse \Class{scrlttr2} und das Paket \Package{scrletter} fügen zwei weitere Haken hinzu, die mit \Macro{AtBeginLetter} und \Macro{AtEndLetter}\ChangedAt{v2.95}{\Class{scrlttr2}} mit Inhalt versehen -werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen -für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide} -dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und +werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen +für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide} +dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und Klassenautoren gedacht. Bei der Briefklasse und dem Briefpaket kann es jedoch -sinnvolle Anwendungen für die beiden neuen Haken auch auf Benutzerebene +sinnvolle Anwendungen für die beiden neuen Haken auch auf Benutzerebene geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.% % \begin{Example} Angenommen, Sie haben mehrere Briefe in einem Dokument. Sie verwenden - außerdem eine eigene Anweisung, um in den Briefen einen Fragebogen + außerdem eine eigene Anweisung, um in den Briefen einen Fragebogen zu setzen. Dabei werden die Fragen automatisch mit Hilfe eines - Zählers nummeriert. Da \KOMAScript{} dieser Zähler nicht bekannt - ist, würde er auch im Gegensatz etwa zur Seitenzahl am Anfang eines - neuen Briefes nicht zurückgesetzt. Wenn jeder Brief zehn Fragen - beinhaltet, hätte damit die erste Frage im fünften Brief die Nummer - 41 statt der Nummer 1. Sie lösen das, indem Sie \KOMAScript{} - mitteilen, dass am Anfang jedes Briefes der Zähler zurückgesetzt + Zählers nummeriert. Da \KOMAScript{} dieser Zähler nicht bekannt + ist, würde er auch im Gegensatz etwa zur Seitenzahl am Anfang eines + neuen Briefes nicht zurückgesetzt. Wenn jeder Brief zehn Fragen + beinhaltet, hätte damit die erste Frage im fünften Brief die Nummer + 41 statt der Nummer 1. Sie lösen das, indem Sie \KOMAScript{} + mitteilen, dass am Anfang jedes Briefes der Zähler zurückgesetzt werden soll: \begin{lstcode} \newcounter{Frage} @@ -711,35 +717,35 @@ geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.% \AtBeginLetter{\setcounter{Frage}{0}} \end{lstcode} Damit hat dann auch die erste Frage im 1001.~Brief wieder die Nummer - Eins. Die hier angegebene Definition benötigt übrigens das + Eins. Die hier angegebene Definition benötigt übrigens das \Package{tabularx}-Paket\IndexPackage{tabularx} (siehe \cite{package:tabularx}). \end{Example} \else% - Wie\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, gibt es bei - \LaTeX{} die Möglichkeit, während des \LaTeX-Laufs eines Dokuments zusätzliche - \PName{Anweisungen} ausführen zu lassen. Zu diesem Zweck stellt der + Wie\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, gibt es bei + \LaTeX{} die Möglichkeit, während des \LaTeX-Laufs eines Dokuments zusätzliche + \PName{Anweisungen} ausführen zu lassen. Zu diesem Zweck stellt der \LaTeX-Kern die Anweisungen \Macro{AtEndOfClass}\IndexCmd{AtEndOfClass} und - \Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt + \Macro{AtBeginDocument}\IndexCmd{AtBeginDocument} zur Verfügung. Man nennt solche Eingriffspunkte auch \emph{hooks}\Index{hook=\emph{hook}}, also - Haken. \KOMAScript{} fügt zwei weitere Haken hinzu, die mit + Haken. \KOMAScript{} fügt zwei weitere Haken hinzu, die mit \Macro{AtBeginLetter} und \Macro{AtEndLetter}\ChangedAt{v2.95}{\Class{scrlttr2}} mit Inhalt versehen - werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen - für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide} - dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und - Klassenautoren gedacht. Bei Briefen kann es jedoch sinnvolle Anwendungen für + werden können. Wie man schon daran erkennt, dass die \LaTeX-Kern-Anweisungen + für Haken nicht in \cite{latex:usrguide} sondern in \cite{latex:clsguide} + dokumentiert sind, sind diese Anweisungen eigentlich eher für Paket- und + Klassenautoren gedacht. Bei Briefen kann es jedoch sinnvolle Anwendungen für die beiden neuen Haken auch auf Benutzerebene geben.\Index[indexmain]{Haken}% % \begin{Example} Angenommen, Sie haben mehrere Briefe in einem Dokument und verwenden eine eigene Anweisung, um in den Briefen einen Fragebogen zu setzen. Die Fragen werden mit Hilfe eines - Zählers nummeriert. Da \KOMAScript{} diesen Zähler nicht kennt, - würde er auch im Gegensatz zur Seitenzahl am Anfang eines - neuen Briefes nicht zurückgesetzt. Bei 10 Fragen je Brief, hätte damit die - erste Frage im fünften Brief die Nummer 41 statt der Nummer 1. Sie lösen - das, indem Sie am Anfang jedes Briefes den Zähler zurücksetzen lassen: + Zählers nummeriert. Da \KOMAScript{} diesen Zähler nicht kennt, + würde er auch im Gegensatz zur Seitenzahl am Anfang eines + neuen Briefes nicht zurückgesetzt. Bei 10 Fragen je Brief, hätte damit die + erste Frage im fünften Brief die Nummer 41 statt der Nummer 1. Sie lösen + das, indem Sie am Anfang jedes Briefes den Zähler zurücksetzen lassen: \begin{lstcode} \newcounter{Frage} \newcommand{\Frage}[1]{% @@ -751,7 +757,7 @@ geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.% \AtBeginLetter{\setcounter{Frage}{0}} \end{lstcode} Damit hat dann auch die erste Frage im 1001.~Brief wieder die Nummer - Eins. Die hier angegebene Definition benötigt übrigens das + Eins. Die hier angegebene Definition benötigt übrigens das \Package{tabularx}-Paket\IndexPackage{tabularx} (siehe \cite{package:tabularx}). \end{Example}% @@ -765,16 +771,16 @@ geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.% \Macro{thisletter} \Macro{letterlastpage} \end{Declaration} -Für\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} den Fall, dass +Für\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} den Fall, dass sich mehrere Briefe in einem Dokument befinden, werden die Briefe intern von -\KOMAScript{} durchnummeriert. Hierfür ist seit Version~3.19 der Zähler +\KOMAScript{} durchnummeriert. Hierfür ist seit Version~3.19 der Zähler \Counter{letter} definiert, der mit jedem \Macro{begin}\PParameter{letter} -referenzierbar um eins erhöht wird. +referenzierbar um eins erhöht wird. \begin{Example} Kommen wir auf das Beispiel zu \DescRef{\LabelBase.cmd.AtBeginLetter} - zurück. Statt den Zähler explizit innerhalb von - \Macro{begin}\PParameter{letter} zurückzusetzen, kann dies auch implizit - erfolgen, indem der Zähler \Counter{Frage} abhängig von \Counter{letter} + zurück. Statt den Zähler explizit innerhalb von + \Macro{begin}\PParameter{letter} zurückzusetzen, kann dies auch implizit + erfolgen, indem der Zähler \Counter{Frage} abhängig von \Counter{letter} definiert wird: \begin{lstcode} \newcounter{Frage}[letter] @@ -787,29 +793,29 @@ referenzierbar um eins erhöht wird. \end{tabularx}% }% \end{lstcode} - Damit wird der Zähler automatisch zu Beginn jedes Briefs wieder auf Null - zurück gesetzt, so dass die erste Frage in jedem Brief wieder mit der Nummer + Damit wird der Zähler automatisch zu Beginn jedes Briefs wieder auf Null + zurück gesetzt, so dass die erste Frage in jedem Brief wieder mit der Nummer Eins beginnt. \end{Example} Will man sich den aktuellen Wert von \Counter{letter} ausgeben lassen, so ist -das wie gewohnt mit \Macro{theletter} möglich. Wie bereits erwähnt, ist der -Zähler aber auch referenzierbar. Das bedeutet, man könnte am Anfang eines +das wie gewohnt mit \Macro{theletter} möglich. Wie bereits erwähnt, ist der +Zähler aber auch referenzierbar. Das bedeutet, man könnte am Anfang eines Briefes mit \Macro{label}\Parameter{Labelname} ein Label setzen und mit \Macro{ref}\Parameter{Labelname} dann an beliebiger Stelle im -Dokument darauf verweisen. Innerhalb des Briefes selbst erhält man dasselbe +Dokument darauf verweisen. Innerhalb des Briefes selbst erhält man dasselbe Ergebnis auch ganz ohne Label mit \Macro{thisletter}. -Für Label innerhalb von Serienbriefen ist es notwendig, diesen einen über alle -Briefe hinweg eindeutigen Namen zu geben. Auch dafür kann \Macro{thisletter} -verwendet werden. Intern arbeitet \KOMAScript{} für diesen Zweck ebenfalls mit +Für Label innerhalb von Serienbriefen ist es notwendig, diesen einen über alle +Briefe hinweg eindeutigen Namen zu geben. Auch dafür kann \Macro{thisletter} +verwendet werden. Intern arbeitet \KOMAScript{} für diesen Zweck ebenfalls mit \Macro{thisletter}, um auf der letzten Seite eines jeden Briefes ein Label zu -setzen. Dadurch ist es möglich, mit +setzen. Dadurch ist es möglich, mit \Macro{letterlastpage}\IndexCmd{label}\IndexCmd{pageref} jederzeit innerhalb des Briefes die Nummer der letzten Seite des Briefes auszugeben. Da -\Macro{letterlastpage} über \Macro{label} und \Macro{pageref} arbeitet, ist -die Ausgabe allerdings erst nach mehreren \LaTeX-Läufen -- meist zwei oder -drei -- gültig. Achten Sie gegebenenfalls auf entsprechende +\Macro{letterlastpage} über \Macro{label} und \Macro{pageref} arbeitet, ist +die Ausgabe allerdings erst nach mehreren \LaTeX-Läufen -- meist zwei oder +drei -- gültig. Achten Sie gegebenenfalls auf entsprechende \emph{Rerun}-Meldungen in der Terminal-Ausgabe oder der \File{log}-Datei.% \EndIndexGroup @@ -817,22 +823,22 @@ drei -- gültig. Achten Sie gegebenenfalls auf entsprechende \begin{Declaration} \Macro{opening}\Parameter{Anrede} \end{Declaration} -Dies ist eine der wichtigsten Anweisungen in Briefen. Vordergründig -wird damit die \PName{Anrede}\Index{Anrede}, beispielsweise »Sehr -geehrte Frau~\dots«, gesetzt. Tatsächlich\textnote{Achtung!} setzt diese +Dies ist eine der wichtigsten Anweisungen in Briefen. Vordergründig +wird damit die \PName{Anrede}\Index{Anrede}, beispielsweise »Sehr +geehrte Frau~\dots«, gesetzt. Tatsächlich\textnote{Achtung!} setzt diese Anweisung aber auch alle Elemente des Briefbogens wie die Faltmarken\Index{Faltmarke}, den Briefkopf\Index{Briefkopf}, die -Anschrift\Index{Anschrift}, die Absenderergänzung, die -Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}, den Titel\Index{Titel}, +Anschrift\Index{Anschrift}, die Absenderergänzung, die +Geschäftszeile\Index{Geschaeftszeile=Geschäftszeile}, den Titel\Index{Titel}, den Betreff\Index{Betreff} und den -Seitenfuß\Index{Kopf}\Index{Fuss=Fuß}. Kurz\textnote{Ohne Anrede kein Brief!} -gesagt: ohne Anrede kein Brief. Soll tatsächlich einmal ein Brief ohne Anrede +Seitenfuß\Index{Kopf}\Index{Fuss=Fuß}. Kurz\textnote{Ohne Anrede kein Brief!} +gesagt: ohne Anrede kein Brief. Soll tatsächlich einmal ein Brief ohne Anrede gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben. \begin{Example} Kommen wir auf das Beispiel von - \DescPageRef{\LabelBase.env.letter.example} zurück. Wird dieses - um eine Anrede ergänzt, dann ergibt sich aus + \DescPageRef{\LabelBase.env.letter.example} zurück. Wird dieses + um eine Anrede ergänzt, dann ergibt sich aus \lstinputcode[xleftmargin=1em]{letter-0.tex} der Briefbogen von \autoref{fig:\LabelBase.letter-0}. \begin{figure} @@ -840,7 +846,7 @@ gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben. \begin{captionbeside}[{Beispiel: Brief mit Anschrift und Anrede}]{Ergebnis eines minimalistischen Briefes nur mit Anschrift und Anrede (Datum und Faltmarken entstammen den - Voreinstellungen für DIN-Briefe)}[l] + Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-0}} \end{captionbeside} \label{fig:\LabelBase.letter-0} @@ -848,39 +854,39 @@ gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben. \end{Example} \iffalse % 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.% + 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 \EndIndexGroup \begin{Declaration} - \Macro{closing}\Parameter{Grußfloskel} + \Macro{closing}\Parameter{Grußfloskel} \end{Declaration} Mit der Anweisung \Macro{closing} wird in erster Linie die -\PName{Grußfloskel}\Index{Gruss=Gruß}\Index{Schlussgruss=Schlussgruß} +\PName{Grußfloskel}\Index{Gruss=Gruß}\Index{Schlussgruss=Schlussgruß} gesetzt. Diese kann auch mehrzeilig sein. Die einzelnen Zeilen sollten dann -mit doppeltem Backslash voneinander getrennt werden. Absätze innerhalb der -\PName{Grußfloskel} sind jedoch nicht gestattet. +mit doppeltem Backslash voneinander getrennt werden. Absätze innerhalb der +\PName{Grußfloskel} sind jedoch nicht gestattet. -Darüber hinaus setzt diese Anweisung aber auch noch gleich den Inhalt der -Variablen \DescRef{\LabelBase.variable.signature} als Signatur. Näheres zur +Darüber hinaus setzt diese Anweisung aber auch noch gleich den Inhalt der +Variablen \DescRef{\LabelBase.variable.signature} als Signatur. Näheres zur Signatur und deren Konfiguration ist \autoref{sec:\LabelBase.closing} ab \DescPageRef{\LabelBase.variable.signature} zu entnehmen. \begin{Example} - Erweitern wir unser Beispiel um einige Zeilen Brieftext und eine Grußfloskel + Erweitern wir unser Beispiel um einige Zeilen Brieftext und eine Grußfloskel zu: \lstinputcode[xleftmargin=1em]{letter-1.tex} Damit sieht das Ergebnis wie in \autoref{fig:\LabelBase.letter-1} aus. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, - Anrede, Text und Grußfloskel}]{Ergebnis eines kleinen - Briefes mit Anschrift, Anrede, Text und Grußfloskel (Datum und - Faltmarken entstammen den Voreinstellungen für DIN-Briefe)}[l] + Anrede, Text und Grußfloskel}]{Ergebnis eines kleinen + Briefes mit Anschrift, Anrede, Text und Grußfloskel (Datum und + Faltmarken entstammen den Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-1}} \end{captionbeside} \label{fig:\LabelBase.letter-1} @@ -896,10 +902,10 @@ Signatur und deren Konfiguration ist \autoref{sec:\LabelBase.closing} ab Diese Anweisung schaltet lediglich auf das Postskriptum\Index{Postskriptum} um. Dazu wird ein neuer Absatz begonnen und ein vertikaler Abstand -- in der Regel zur Signatur -- -eingefügt. Auf die Anweisung \Macro{ps} kann beliebiger Text folgen. +eingefügt. Auf die Anweisung \Macro{ps} kann beliebiger Text folgen. Dabei muss der Anwender auch selbst entscheiden, ob er den Nachsatz -etwa mit der Abkürzung »PS:«, die übrigens ohne Punkt gesetzt wird, -beginnen will. \KOMAScript{} setzt diese Abkürzung weder +etwa mit der Abkürzung »PS:«, die übrigens ohne Punkt gesetzt wird, +beginnen will. \KOMAScript{} setzt diese Abkürzung weder automatisch noch optional. \begin{Example} @@ -909,9 +915,9 @@ automatisch noch optional. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, - Anrede, Text, Grußfloskel und Postskriptum}]{Ergebnis eines kleinen - Briefes mit Anschrift, Anrede, Text, Grußfloskel und Postskriptum - (Datum und Faltmarken entstammen den Voreinstellungen für + Anrede, Text, Grußfloskel und Postskriptum}]{Ergebnis eines kleinen + Briefes mit Anschrift, Anrede, Text, Grußfloskel und Postskriptum + (Datum und Faltmarken entstammen den Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-2}} \end{captionbeside} @@ -921,17 +927,17 @@ automatisch noch optional. \begin{Explain}% Als Briefe noch von Hand geschrieben wurden, war das Postskriptum - sehr beliebt. Es handelte sich bei diesen Nachsätzen ursprünglich um + 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. % + die mit \LaTeX{} geschrieben werden, ist es natürlich einfach, + 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 + sehr schön noch einmal auf ganz andere äußerst wichtige oder eigentlich ganz unwichtige Dinge hinweisen.% \fi \iftrue % Umbruchkorrektur - Heutzutage verwendet man das Postskriptum dagegen eher für + Heutzutage verwendet man das Postskriptum dagegen eher für Hinweise, die mit dem eigentlichen Briefinhalt wenig zu tun haben. \fi \end{Explain} @@ -945,11 +951,11 @@ automatisch noch optional. \end{Declaration} Ein \PName{Verteiler}\Index{Verteiler} kann mit der Anweisung \Macro{cc} gesetzt werden. Der \PName{Verteiler} wird der Anweisung dabei als Argument -übergeben. Wenn der \PName{Inhalt} der Variablen +übergeben. Wenn der \PName{Inhalt} der Variablen \Variable{ccseparator}\Index{Trennzeichen} nicht leer ist, wird dem \PName{Verteiler} die \PName{Bezeichnung} und der \PName{Inhalt} dieser Variablen vorangestellt. Der \PName{Verteiler} selbst wird dann um die -entsprechende Breite eingerückt ausgegeben. Es empfiehlt\textnote{Tipp!} +entsprechende Breite eingerückt ausgegeben. Es empfiehlt\textnote{Tipp!} sich, den \PName{Verteiler} \Macro{raggedright}\IndexCmd{raggedright} zu setzen und die einzelnen Angaben durch doppelten Backslash voneinander zu trennen. @@ -961,16 +967,16 @@ trennen. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, - Anrede, Text, Grußfloskel, Postskriptum und Verteiler}]{Ergebnis eines - kleinen Briefes mit Anschrift, Anrede, Text, Grußfloskel, Postskriptum + Anrede, Text, Grußfloskel, Postskriptum und Verteiler}]{Ergebnis eines + kleinen Briefes mit Anschrift, Anrede, Text, Grußfloskel, Postskriptum und Verteiler (Datum und Faltmarken entstammen den Voreinstellungen - für DIN-Briefe)}[l] + für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-3}} \end{captionbeside} \label{fig:\LabelBase.letter-3} \end{figure} \end{Example} -Vor dem Verteiler wird automatisch ein Abstand eingefügt.% +Vor dem Verteiler wird automatisch ein Abstand eingefügt.% % \EndIndexGroup @@ -985,17 +991,17 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen \Variable{enclseparator}\Index{Trennzeichen} bestimmt wird. \begin{Example} Dem Beispielbrief wird nun als Anlage noch ein Auszug aus der Satzung - beigefügt. Da es nur eine Anlage gibt, wird auch die voreingestellte - Bezeichnung passend geändert: + beigefügt. Da es nur eine Anlage gibt, wird auch die voreingestellte + Bezeichnung passend geändert: \lstinputcode[xleftmargin=1em]{letter-4.tex} Das Ergebnis ist in \autoref{fig:\LabelBase.letter-4} zu sehen. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, - Anrede, Text, Grußfloskel, Postskriptum, Anlagen und + Anrede, Text, Grußfloskel, Postskriptum, Anlagen und Verteiler}]{Ergebnis eines kleinen Briefes mit Anschrift, Anrede, - Text, Grußfloskel, Postskriptum, Anlagen und Verteiler (Datum und - Faltmarken entstammen den Voreinstellungen für DIN-Briefe)}[l] + Text, Grußfloskel, Postskriptum, Anlagen und Verteiler (Datum und + Faltmarken entstammen den Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-4}} \end{captionbeside} \label{fig:\LabelBase.letter-4} @@ -1007,7 +1013,7 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen \EndIndexGroup -\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} +\LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} \LoadCommonFile{textmarkup} % \section{Textauszeichnungen} @@ -1016,16 +1022,16 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen \BeginIndexGroup \BeginIndex{}{Briefbogen} -Der Briefbogen ist die erste Seite und damit das Aushängeschild jedes -Briefes. Im geschäftlichen Bereich handelt es sich dabei oft um einen +Der Briefbogen ist die erste Seite und damit das Aushängeschild jedes +Briefes. Im geschäftlichen Bereich handelt es sich dabei oft um einen Vordruck, auf dem viele Elemente, wie ein Briefkopf mit Absenderinformationen und Logo, bereits enthalten sind. Bei \KOMAScript{} sind diese Elemente frei -positionierbar. Damit ist es nicht nur möglich, einen Briefbogen direkt +positionierbar. Damit ist es nicht nur möglich, einen Briefbogen direkt nachzubilden, sondern auch vorgesehene Felder, wie die Anschrift, unmittelbar -auszufüllen. Die freie Positionierbarkeit wird über Pseudolängen (siehe +auszufüllen. Die freie Positionierbarkeit wird über Pseudolängen (siehe \autoref{sec:\LabelBase.pseudoLength} ab \autopageref{sec:\LabelBase.pseudoLength}) erreicht. Eine schematische -Darstellung des Briefbogens und der dafür verwendeten Variablen ist in +Darstellung des Briefbogens und der dafür verwendeten Variablen ist in \autoref{fig:\LabelBase.variables} zu finden. Dabei sind die Namen der Variablen zur besseren Unterscheidung von Anweisungen und deren Argumenten fett gedruckt. @@ -1039,7 +1045,7 @@ Briefseiten abgesehen von der ersten. \centering \includegraphics[scale=0.99]{varDIN} \caption{Schematische Darstellung des Briefbogens mit den wichtigsten - Anweisungen und Variablen für die skizzierten Elemente} + Anweisungen und Variablen für die skizzierten Elemente} \label{fig:\LabelBase.variables} \end{figure} @@ -1049,20 +1055,20 @@ Briefseiten abgesehen von der ersten. \end{Declaration} Falt- oder Falzmarken\Index{Faltmarken}\textnote{Faltmarken} sind kleine horizontale Striche am linken und kleine vertikale Striche am oberen -Rand. \KOMAScript{} unterstützt für den Briefbogen derzeit drei +Rand. \KOMAScript{} unterstützt für den Briefbogen derzeit drei konfigurierbare horizontale und eine konfigurierbare vertikale Faltmarke. Dazu -wird noch eine horizontale Loch- oder Seitenmittenmarke unterstützt, die nicht +wird noch eine horizontale Loch- oder Seitenmittenmarke unterstützt, die nicht in der Vertikalen verschoben werden kann. -Mit der Option \Option{foldmarks} können Faltmarken\Index{Faltmarke} für eine +Mit der Option \Option{foldmarks} können Faltmarken\Index{Faltmarke} für eine vertikale Zwei"~, Drei- oder Vierteilung und eine horizontale Zweiteilung -aktiviert oder deaktiviert werden. Die einzelnen Teile müssen dabei nicht -äquidistant sein. Die Positionen von drei der vier horizontalen und der -vertikalen Marke sind über Pseudolängen konfigurierbar (siehe +aktiviert oder deaktiviert werden. Die einzelnen Teile müssen dabei nicht +äquidistant sein. Die Positionen von drei der vier horizontalen und der +vertikalen Marke sind über Pseudolängen konfigurierbar (siehe \autoref{sec:scrlttr2-experts.foldmarks} ab \DescPageRef{scrlttr2-experts.plength.foldmarkvpos}). -Über die Option \Option{foldmarks} können entweder mit den Standardwerten für +Ãœber die Option \Option{foldmarks} können entweder mit den Standardwerten für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind, alle konfigurierten Faltmarken am linken und oberen Rand ein- und ausgeschaltet werden, @@ -1074,7 +1080,7 @@ die Faltmarken nur dann angezeigt, wenn die Faltmarken nicht mit wurden. Die genaue Position der Faltmarken ist von den Einstellungen des Anwenders beziehungsweise der \File{lco}-Dateien (siehe \autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) -abhängig. Voreingestellt sind \PValue{true} und +abhängig. Voreingestellt sind \PValue{true} und \PValue{TBMPL}.\textnote{Voreinstellung} % \begin{table} @@ -1083,11 +1089,11 @@ abhängig. Voreingestellt sind \PValue{true} und \setcapindent{0pt}% % \caption \begin{captionbeside}[{% - Kombinierbare Werte für die Konfiguration der Faltmarken mit der + Kombinierbare Werte für die Konfiguration der Faltmarken mit der Option \Option{foldmarks}% }]{% \hspace{0pt plus 1ex}% - Kombinierbare Werte für die Konfiguration der Faltmarken mit der + Kombinierbare Werte für die Konfiguration der Faltmarken mit der Option \Option{foldmarks}\label{tab:\LabelBase.foldmark}% }[l] \begin{tabular}[t]{ll} @@ -1111,36 +1117,36 @@ abhängig. Voreingestellt sind \PValue{true} und \end{captionbeside} \end{table} \begin{Example} - Angenommen, Sie wollen alle Faltmarken außer der Lochermarke - abschalten. Wenn die Voreinstellung zuvor noch nicht geändert wurde, können + Angenommen, Sie wollen alle Faltmarken außer der Lochermarke + abschalten. Wenn die Voreinstellung zuvor noch nicht geändert wurde, können Sie das Abschalten wie folgt erreichen: \begin{lstcode} \KOMAoptions{foldmarks=blmt} \end{lstcode} - Besteht die Möglichkeit, dass die Voreinstellung bereits geändert wurde, so + Besteht die Möglichkeit, dass die Voreinstellung bereits geändert wurde, so sollten Sie lieber auf Nummer Sicher gehen. Unser Beispiel ist dann - entsprechend abzuändern.% + entsprechend abzuändern.% \lstinputcode[xleftmargin=1em]{letter-7}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-7} zu sehen. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, - Anrede, Text, Grußfloskel, Postskriptum, Anlagen, Verteiler und + Anrede, Text, Grußfloskel, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit Anschrift, Anrede, - Text, Grußfloskel, Postskriptum, Anlagen, Verteiler und Lochermarke - (das Datum entstammt den Voreinstellungen für DIN-Briefe)}[l] + Text, Grußfloskel, Postskriptum, Anlagen, Verteiler und Lochermarke + (das Datum entstammt den Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-7}} \end{captionbeside} \label{fig:\LabelBase.letter-7} \end{figure} \end{Example} \BeginIndex{FontElement}{foldmark}\LabelFontElement{foldmark}% -Über\ChangedAt{v2.97c}{\Class{scrlttr2}} das Element \FontElement{foldmark} -kann die Farbe der Faltmarken geändert werden. Dazu werden die Anweisungen +Ãœber\ChangedAt{v2.97c}{\Class{scrlttr2}} das Element \FontElement{foldmark} +kann die Farbe der Faltmarken geändert werden. Dazu werden die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) verwendet. Voreingestellt ist -keine Änderung.% +keine Änderung.% \EndIndexGroup @@ -1148,26 +1154,26 @@ keine Änderung.% \OptionVName{enlargefirstpage}{Ein-Aus-Wert} \end{Declaration} \begin{Explain} - Die erste Seite eines Briefes fällt % + 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 + 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 +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 +erste Seite. Siehe hierzu auch die Erklärung zur Pseudolänge \PLength{firstfootvpos} auf \DescPageRef{scrlttr2-experts.plength.firstfootvpos}. Als -\PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter +\PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist \PValue{false}.\textnote{Voreinstellung}% % @@ -1184,9 +1190,9 @@ normalerweise der Briefkopf. Bei Bei\ChangedAt{v2.97e}{\Class{scrlttr2}} \fi% \KOMAScript{} kann mit der Option -\Option{firsthead} gewählt werden, ob der Briefkopf auf dem Briefbogen -überhaupt gesetzt werden soll. Als \PName{Ein-Aus-Wert} kann dabei einer der -Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +\Option{firsthead} gewählt werden, ob der Briefkopf auf dem Briefbogen +überhaupt 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. In der Voreinstellung ist der Briefkopf aktiviert.\textnote{Voreinstellung}%% % @@ -1200,22 +1206,22 @@ der Briefkopf aktiviert.\textnote{Voreinstellung}%% Die\important{\Option{fromalign}} Option \Option{fromalign} bestimmt, wo der Absender\Index{Absender} auf der ersten Seite platziert werden soll. Neben verschiedenen Platzierungen im Briefkopf gibt es -auch\ChangedAt{v2.97e}{\Class{scrlttr2}} die Möglichkeit, den Absender in der -Absenderergänzung\Index{Absenderergaenzung=Absenderergänzung} +auch\ChangedAt{v2.97e}{\Class{scrlttr2}} die Möglichkeit, den Absender in der +Absenderergänzung\Index{Absenderergaenzung=Absenderergänzung} unterzubringen. Gleichzeitig\textnote{Achtung!} dient diese Option als -zentraler Schalter, um die Erweiterungen der Briefkopfgestaltung überhaupt zu +zentraler Schalter, um die Erweiterungen der Briefkopfgestaltung überhaupt zu aktivieren oder zu deaktivieren. Sind die Erweiterungen deaktiviert, so -bleiben die übrigen nachfolgend angegebenen Optionen ohne Wirkung. Mögliche -Werte für \Option{fromalign} sind \autoref{tab:\LabelBase.fromalign} zu +bleiben die übrigen nachfolgend angegebenen Optionen ohne Wirkung. Mögliche +Werte für \Option{fromalign} sind \autoref{tab:\LabelBase.fromalign} zu entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}% % \EndIndexGroup \begin{table} \Index{Briefkopf}% - \caption[{Mögliche Werte für Option + \caption[{Mögliche Werte für Option \Option{fromalign} zur Platzierung des Absenders auf dem Briefbogen}] - {Mögliche Werte für Option + {Mögliche Werte für Option \Option{fromalign} zur Platzierung des Absenders auf dem Briefbogen} \label{tab:\LabelBase.fromalign} \begin{desctabular} @@ -1224,26 +1230,26 @@ entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}% gegebenenfalls am Anfang der erweiterten Absenderangabe platziert; die Erweiterungen der Briefkopfgestaltung werden aktiviert.}% \entry{\PValue{false}, \PValue{no}, \PValue{off}}{% - Standardgestalt für den Absender wird verwendet; die Erweiterungen der + Standardgestalt für den Absender wird verwendet; die Erweiterungen der Briefkopfgestaltung werden deaktiviert.}% \entry{\PValue{left}}{% - Absender steht linksbündig im Briefkopf; ein Logo wird gegebenenfalls - rechtsbündig platziert; die Erweiterungen der Briefkopfgestaltung werden + Absender steht linksbündig im Briefkopf; ein Logo wird gegebenenfalls + rechtsbündig platziert; die Erweiterungen der Briefkopfgestaltung werden aktiviert.}% \entry{\PValue{locationleft}, \PValue{leftlocation}}{% - Absender steht linksbündig in der Absenderergänzung; ein Logo wird - gegebenenfalls darüber platziert; der Briefkopf wird automatisch - deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} + Absender steht linksbündig in der Absenderergänzung; ein Logo wird + gegebenenfalls darüber platziert; der Briefkopf wird automatisch + deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} wieder aktiviert werden.}% \entry{\PValue{locationright}, \PValue{rightlocation}, \PValue{location}}{% - Absender steht rechtsbündig in der Absenderergänzung; ein Logo wird - gegebenenfalls darüber platziert; der Briefkopf wird automatisch - deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} + Absender steht rechtsbündig in der Absenderergänzung; ein Logo wird + gegebenenfalls darüber platziert; der Briefkopf wird automatisch + deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} wieder aktiviert werden.}% \entry{\PValue{right}}{% - Absender steht rechtsbündig im Briefkopf; ein Logo wird gegebenenfalls - linksbündig platziert; die Erweiterungen der Briefkopfgestaltung werden + Absender steht rechtsbündig im Briefkopf; ein Logo wird gegebenenfalls + linksbündig platziert; die Erweiterungen der Briefkopfgestaltung werden aktiviert.}% \end{desctabular} \end{table} @@ -1254,7 +1260,7 @@ entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}% \Variable{fromname} \Variable{fromaddress} \end{Declaration} -Der\important{\Variable{fromname}} Name des Absenders wird über die Variable +Der\important{\Variable{fromname}} Name des Absenders wird über die Variable \Variable{fromname} bestimmt. Im Briefkopf wird dabei die \PName{Bezeichnung} (siehe auch \autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}) nicht gesetzt. @@ -1264,9 +1270,9 @@ Optional\important{\OptionValue{fromrule}{aftername}} kann mit Einstellung horizontale Linie folgen. Alternativ\important{\OptionValue{fromrule}{afteraddress}} kann die Linie mit \OptionValue{fromrule}{afteraddress} auch unterhalb des kompletten -Absenders gesetzt werden. Eine Übersicht über alle möglichen Einstellungen für -die Linie bietet \autoref{tab:\LabelBase.fromrule}. Die Länge der Linie wird -über die Pseudolänge \PLength{fromrulewidth}\IndexPLength{fromrulewidth} +Absenders gesetzt werden. Eine Ãœbersicht über alle möglichen Einstellungen für +die Linie bietet \autoref{tab:\LabelBase.fromrule}. Die Länge der Linie wird +über die Pseudolänge \PLength{fromrulewidth}\IndexPLength{fromrulewidth} bestimmt. \begin{table} @@ -1275,11 +1281,11 @@ bestimmt. % \caption \begin{captionbeside} [{% - Mögliche Werte für Option \Option{fromrule} bei + Mögliche Werte für Option \Option{fromrule} bei \Class{scrlttr2} und \Package{scrletter}% }]{% \label{tab:\LabelBase.fromrule}% - Mögliche Werte für Option \Option{fromrule} zur + Mögliche Werte für Option \Option{fromrule} zur Platzierung einer horizontalen Linie im Absender des erweiterten Briefkopfes von \Class{scrlttr2} und \Package{scrletter}% }% @@ -1305,7 +1311,7 @@ Briefkopf nicht aktiviert. Im Standardbriefkopf wird die Linie immer nach dem Namen gesetzt. Unter\important{\Variable{fromaddress}} dem Namen folgt die Anschrift des -Absenders. Diese wird über die Variable \Variable{fromaddress} bestimmt. Im +Absenders. Diese wird über die Variable \Variable{fromaddress} bestimmt. Im Briefkopf wird dabei die \PName{Bezeichnung} (siehe auch \autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}) nicht gesetzt. @@ -1314,17 +1320,17 @@ gesetzt. \BeginIndex{FontElement}{fromaddress}\LabelFontElement{fromaddress}% \BeginIndex{FontElement}{fromname}\LabelFontElement{fromname}% \BeginIndex{FontElement}{fromrule}\LabelFontElement{fromrule}% -Die Schrift, die für den kompletten Absender verwendet wird, kann über das +Die Schrift, die für den kompletten Absender verwendet wird, kann über das Element \FontElement{fromaddress}\IndexFontElement{fromaddress}% \important{\FontElement{fromaddress}} eingestellt werden. Abweichungen davon -können für den Absendernamen über das Element +können für den Absendernamen über das Element \FontElement{fromname}\IndexFontElement{fromname}% -\important{\FontElement{fromname}} und für die mit \Option{fromrule} gesetzte -Linie über das Element \FontElement{fromrule}\IndexFontElement{fromrule}% +\important{\FontElement{fromname}} und für die mit \Option{fromrule} gesetzte +Linie über das Element \FontElement{fromrule}\IndexFontElement{fromrule}% \important{\FontElement{fromrule}} eingestellt werden. In der Voreinstellung -erfolgt keinerlei Schriftumschaltung. Bei der Linie ist die Möglichkeit der -Schriftumschaltung hauptsächlich dazu gedacht, die Farbe der Linie ändern zu -können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu +erfolgt keinerlei Schriftumschaltung. Bei der Linie ist die Möglichkeit der +Schriftumschaltung hauptsächlich dazu gedacht, die Farbe der Linie ändern zu +können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu \cite{package:xcolor}.% % \EndIndexGroup @@ -1341,36 +1347,36 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu \frame{\includegraphics[width=.4\textwidth]{letter-8}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-9}} \caption[{Beispiel: Brief mit Absender, Anschrift, Anrede, - Text, Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler}] + Text, Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler}] {Ergebnis eines kleinen Briefes mit Absender, Anschrift, Anrede, Text, - Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler (Datum und - Faltmarken entstammen den Voreinstellungen für DIN-Briefe); links der + Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler (Datum und + Faltmarken entstammen den Voreinstellungen für DIN-Briefe); links der Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} \label{fig:\LabelBase.letter-8-9} \end{figure} - Dabei wird zunächst einmal nicht der erweiterte Briefkopf, sondern nur der + Dabei wird zunächst einmal nicht der erweiterte Briefkopf, sondern nur der Standardbriefkopf verwendet. Das Ergebnis ist in \autoref{fig:\LabelBase.letter-8-9} links zu sehen. Im Vergleich dazu ist rechts daneben das gleiche Beispiel, jedoch mit Option \OptionValueRef{\LabelBase}{fromalign}{center}, also mit den aktivierten - Erweiterungen für den Briefkopf, abgebildet. Wie zu sehen ist, hat diese - Variante zunächst einmal keine Linie. + Erweiterungen für den Briefkopf, abgebildet. Wie zu sehen ist, hat diese + Variante zunächst einmal keine Linie. In \autoref{fig:\LabelBase.letter-8-9} taucht nun auch erstmals eine Signatur - unter dem Gruß auf. Diese wird automatisch aus dem Absendername + unter dem Gruß auf. Diese wird automatisch aus dem Absendername gewonnen. Wie sie konfiguriert werden kann, ist in \autoref{sec:\LabelBase.closing} ab \autopageref{sec:\LabelBase.closing} zu finden. - Nun soll der Brief mit aktivierter Erweiterung für den Briefkopf mit Hilfe + 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:\LabelBase.letter-10-11} rechts zu sehen. % \iftrue % Umbruchkorrektur Im Vergleich dazu ist links daneben das gleiche Beispiel noch einmal mit dem - Standardbriefkopf und ohne Reaktion auf die zusätzliche Option. + Standardbriefkopf und ohne Reaktion auf die zusätzliche Option. % \else % Links steht zum Vergleich ein Beispiel mit Standardbriefkopf. @@ -1382,10 +1388,10 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu \frame{\includegraphics[width=.4\textwidth]{letter-10}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-11}} \caption[{Beispiel: Brief mit Absender, Trennlinie, Anschrift, Anrede, Text, - Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit Absender, Trennlinie, - Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, - Verteiler und Lochermarke (das Datum entstammt den Voreinstellungen für + Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, + Verteiler und Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); links der Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} @@ -1396,21 +1402,21 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu 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 +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% \iftrue % Umbruchkorrektur . Man muss \KOMAScript{} 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 +gegebenenfalls sinnvoll im Absender einsetzen zu können. Außerdem sollte man +in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable \DescRef{\LabelBase.variable.backaddress}, \DescPageRef{\LabelBase.variable.backaddress}) und Signatur (siehe Variable \DescRef{\LabelBase.variable.signature}, \DescPageRef{\LabelBase.variable.signature}) selbst setzen.% \else % -\ und hätten außerdem gegebenenfalls Auswirkungen auf die Rücksendeadresse +\ und hätten außerdem gegebenenfalls Auswirkungen auf die Rücksendeadresse (siehe Variable \DescRef{\LabelBase.variable.backaddress}, \DescPageRef{\LabelBase.variable.backaddress}) und Signatur (siehe Variable \DescRef{\LabelBase.variable.signature}, @@ -1421,7 +1427,7 @@ in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable \begin{Declaration} - \OptionVName{symbolicnames}{Ein-Aus-Wert} + \OptionVName{symbolicnames}{Wert} \OptionVName{fromphone}{Ein-Aus-Wert} \OptionVName{frommobilephone}{Ein-Aus-Wert} \OptionVName{fromfax}{Ein-Aus-Wert} @@ -1438,44 +1444,51 @@ in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable \Variable{emailseparator} \Variable{urlseparator} \end{Declaration}% -Mit Hilfe der fünf Optionen \Option{fromphone}, +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 +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\textnote{Voreinstellung} ist jeweils -\PValue{false}. Die Inhalte selbst werden über die gleichnamigen Variablen -bestimmt. Die Voreinstellungen für die dabei verwendeten Bezeichnungen sind +\PValue{false}. Die Inhalte selbst werden über die gleichnamigen Variablen +bestimmt. Die Voreinstellungen für die dabei verwendeten Bezeichnungen sind \autoref{tab:\LabelBase.fromTerm} zu entnehmen, die verwendeten Trennzeichen, die zwischen der \PName{Bezeichnung} und dem \PName{Inhalt} einer Variablen -eingefügt werden, \autoref{tab:\LabelBase.fromSeparator}. +eingefügt werden, \autoref{tab:\LabelBase.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 +geändert werden. Die Option versteht als \PName{Wert} die +\PName{Ein-Aus-Werte} für einfache Schalter, wie sie in +\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben +sind. Die\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} +Aktivierung der Option entspricht dabei dem \PName{Wert} \PValue{marvosym}, +wodurch statt der sprachabhängigen Bezeichner \DescRef{scrlttr2-experts.cmd.emailname}, \DescRef{scrlttr2-experts.cmd.faxname}, \DescRef{scrlttr2-experts.cmd.mobilephonename} und \DescRef{scrlttr2-experts.cmd.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. +\Package{marvosym}\IndexPackage{marvosym}-Paket verwendet werden. 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. Mit \OptionValue{symbolicnames}{fontawsome} oder +\OptionValue{symbolicnames}{awesome} werden stattdessen Symbole von Paket +\Package{fontawesome}\IndexPackage{fontawesome} verwendet. Dabei wird auch für +die URL ein passendes Symbol aktiviert. Es ist zu beachten\textnote{Achtung!}, +dass das Paket \Package{marvosym} oder \Package{fontawesome} gegebenenfalls +selbst in der Dokumentpräambel zu laden ist, falls mit der Option erst nach +\Macro{begin}\PParameter{document} die Verwendung eines dieser Pakete +aktiviert wird. \begin{table} \centering - \caption[{Vordefinierte Bezeichnungen der Variablen für die\newline + \caption[{Vordefinierte Bezeichnungen der Variablen für die\newline Absenderangaben im Briefkopf}]{Vordefinierte Bezeichnungen der Variablen - für die Absenderangaben im Briefkopf (die Bezeichnungen und Inhalte der - verwendeten Variablen für Trennzeichen ist + für die Absenderangaben im Briefkopf (die Bezeichnungen und Inhalte der + verwendeten Variablen für Trennzeichen ist \autoref{tab:\LabelBase.fromSeparator} zu entnehmen)} \begin{desctabular}[1.8em] \ventry{fromemail}{% @@ -1505,7 +1518,7 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \caption % \begin{captionbeside} {Vordefinierte Bezeichnungen und Inhalte der Trennzeichen - für die Absenderangaben im Briefkopf ohne Option + für die Absenderangaben im Briefkopf ohne Option \Option{symbolicnumbers}} % [l] \begin{tabularx}{\textwidth}{llX} @@ -1526,13 +1539,13 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \begin{Example} Herr Musterfrau aus unserem Beispiel hat auch Telefon und eine - E-Mail-Adresse. Diese möchte er ebenfalls im Briefkopf haben. Gleichzeitig + E-Mail-Adresse. Diese möchte er ebenfalls im Briefkopf haben. Gleichzeitig soll die Trennlinie nun nach dem Briefkopf stehen. Also gibt er die - entsprechenden Optionen an und setzt auch die zugehörigen Variablen:% + entsprechenden Optionen an und setzt auch die zugehörigen Variablen:% \lstinputcode[xleftmargin=1em]{letter-12.tex}% Das Ergebnis aus \autoref{fig:\LabelBase.letter-12-13} links ist jedoch - ernüchternd. Die Optionen werden ignoriert. Das liegt daran, dass diese - zusätzlichen Variablen und Optionen nur im erweiterten Briefkopf verwendet + ernüchternd. Die Optionen werden ignoriert. Das liegt daran, dass diese + zusätzlichen Variablen und Optionen nur im erweiterten Briefkopf verwendet werden. Es muss also, wie in \autoref{fig:\LabelBase.letter-12-13}, rechts die Option \DescRef{\LabelBase.option.fromalign} verwendet werden: \begin{figure} @@ -1540,11 +1553,11 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \frame{\includegraphics[width=.4\textwidth]{letter-12}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-13}} \caption[{Beispiel: Brief mit erweitertem Absender, Trennlinie, Anschrift, - Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler + Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke; Standard- vs. erweiterter Briefkopf}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, Trennlinie, Anschrift, Anrede, - Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und - Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); + Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); links der Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} @@ -1552,8 +1565,8 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \end{figure} \lstinputcode[xleftmargin=1em]{letter-13.tex} - Den Vergleich zweier weiterer Alternativen mit linksbündigem Absender durch - Einstellung \OptionValueRef{\LabelBase}{fromalign}{left} und rechtsbündigem + Den Vergleich zweier weiterer Alternativen mit linksbündigem Absender durch + Einstellung \OptionValueRef{\LabelBase}{fromalign}{left} und rechtsbündigem Absender durch Einstellung \OptionValueRef{\LabelBase}{fromalign}{right} zeigt \autoref{fig:\LabelBase.letter-14-15}. \begin{figure} @@ -1561,14 +1574,14 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \frame{\includegraphics[width=.4\textwidth]{letter-14}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-15}} \caption[{Beispiel: Brief mit erweitertem Absender, Trennlinie, Anschrift, - Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler - und Lochermarke; links- vs. rechtsbündiger Briefkopf}]{Ergebnis eines + Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler + und Lochermarke; links- vs. rechtsbündiger Briefkopf}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, Trennlinie, Anschrift, Anrede, - Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und - Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); - links mit linksbündigem Kopf durch + Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); + links mit linksbündigem Kopf durch \OptionValueRef{\LabelBase}{fromalign}{left}, rechts mit Option - \OptionValueRef{\LabelBase}{fromalign}{right} und damit rechtsbündigem + \OptionValueRef{\LabelBase}{fromalign}{right} und damit rechtsbündigem Kopf} \label{fig:\LabelBase.letter-14-15} \end{figure} @@ -1585,23 +1598,23 @@ nach \Macro{begin}\PParameter{document} aktiviert wird. \BeginIndex{Variable}{fromlogo}% Mit der Option \Option{fromlogo} kann bestimmt werden, ob ein Logo\Index{Logo} im Briefkopf gesetzt werden soll. Als \PName{Ein-Aus-Wert} kann dabei einer -der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt\textnote{Voreinstellung} ist \PValue{false}, also kein -Logo. Das Logo selbst wird über die Variable \Variable{fromlogo} -definiert. Die \PName{Bezeichnung} für das Logo ist in der Voreinstellung leer +Logo. Das Logo selbst wird über die Variable \Variable{fromlogo} +definiert. Die \PName{Bezeichnung} für das Logo ist in der Voreinstellung leer und wird von \KOMAScript{} auch nicht verwendet (siehe auch \autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}).% \begin{Example} Herr Musterfrau findet es besonders schick, wenn er seine Briefe mit einem Logo versieht. Sein Logo hat er als Grafikdatei gespeichert, die er gerne - mit Hilfe der Anweisung \Macro{includegraphics} laden würde. Dazu bindet er - zusätzlich das Paket \Package{graphics}\IndexPackage{graphics} (siehe + mit Hilfe der Anweisung \Macro{includegraphics} laden würde. Dazu bindet er + zusätzlich das Paket \Package{graphics}\IndexPackage{graphics} (siehe \cite{package:graphics}) ein.% \lstinputcode[xleftmargin=1em]{letter-16}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-16-18}, \autopageref{fig:\LabelBase.letter-16-18} links oben zu sehen. Die beiden - anderen Bilder in dieser Abbildung zeigen das Ergebnis bei rechtsbündigem + anderen Bilder in dieser Abbildung zeigen das Ergebnis bei rechtsbündigem und bei zentriertem Absender. \begin{figure} \setcapindent{0pt}% @@ -1609,14 +1622,14 @@ und wird von \KOMAScript{} auch nicht verwendet (siehe auch \frame{\includegraphics[width=.4\textwidth]{letter-16}}\quad \frame{\includegraphics[width=.4\textwidth]{letter-17}}\par\bigskip} \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Trennlinie, Anschrift, Anrede, Text, Grußfloskel, Signatur, + Trennlinie, Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke; Absender links vs. rechts vs. zentriert}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, Logo, Trennlinie, Anschrift, Anrede, Text, - Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und - Lochermarke (das Datum entstammt den Voreinstellungen für - DIN-Briefe); links, oben mit linksbündigem Absender, rechts daneben - mit zentriertem Absender und rechts mit rechtsbündigem Absender}[l] + Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Lochermarke (das Datum entstammt den Voreinstellungen für + DIN-Briefe); links, oben mit linksbündigem Absender, rechts daneben + mit zentriertem Absender und rechts mit rechtsbündigem Absender}[l] \frame{\includegraphics[width=.4\textwidth]{letter-18}}\quad \end{captionbeside} \label{fig:\LabelBase.letter-16-18} @@ -1629,21 +1642,21 @@ und wird von \KOMAScript{} auch nicht verwendet (siehe auch \begin{Declaration} \Variable{firsthead} \end{Declaration} -In vielen Fällen reichen die Möglichkeiten aus, die \Class{scrlttr2} über -Optionen und obige Variablen für die Gestaltung des Briefkopfes bietet. In -einigen Fällen will man jedoch den Briefkopf freier gestalten können. In -diesen Fällen muss man auf die Möglichkeiten der vordefinierten Briefköpfe, -die über die oben erwähnten Option ausgewählt werden können, +In vielen Fällen reichen die Möglichkeiten aus, die \Class{scrlttr2} über +Optionen und obige Variablen für die Gestaltung des Briefkopfes bietet. In +einigen Fällen will man jedoch den Briefkopf freier gestalten können. In +diesen Fällen muss man auf die Möglichkeiten der vordefinierten Briefköpfe, +die über die oben erwähnten Option ausgewählt werden können, verzichten. Stattdessen gestaltet man sich seinen Briefkopf frei. Dazu -definiert man den gewünschten Aufbau über den \PName{Inhalt} der Variablen -\Variable{firsthead}. Dabei können beispielsweise mit Hilfe der +definiert man den gewünschten Aufbau über den \PName{Inhalt} der Variablen +\Variable{firsthead}. Dabei können beispielsweise mit Hilfe der \Macro{parbox}-Anweisung (siehe \cite{latex:usrguide}) mehrere Boxen neben- und untereinander gesetzt werden. Einem versierten Anwender sollte es so -möglich sein, seinen eigenen Briefkopf zu gestalten. Natürlich kann und sollte +möglich sein, seinen eigenen Briefkopf zu gestalten. Natürlich kann und sollte man dabei auch Zugriffe auf andere Variablen mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} nehmen. Die \PName{Bezeichnung} der Variablen \Variable{firsthead} wird von \KOMAScript{} nicht verwendet. -\iffree{}{Ein ausführliches Beispiel für Definition eines Briefkopfes wird in +\iffree{}{Ein ausführliches Beispiel für Definition eines Briefkopfes wird in \autoref{cha:modernletters} behandelt.}% \EndIndexGroup @@ -1651,7 +1664,7 @@ Variablen \Variable{firsthead} wird von \KOMAScript{} nicht verwendet. \begin{Declaration} \OptionVName{addrfield}{Modus} \OptionVName{backaddress}{Wert} - \OptionVName{priority}{Priorität} + \OptionVName{priority}{Priorität} \Variable{toname} \Variable{toaddress} \Variable{backaddress} @@ -1665,45 +1678,45 @@ Variablen \Variable{firsthead} wird von \KOMAScript{} nicht verwendet. \Variable{addresseeimage} \end{Declaration}% \BeginIndex{}{Anschrift}% -Mit der Option \Option{addrfield} kann gewählt werden, ob ein Anschriftfeld +Mit der Option \Option{addrfield} kann gewählt werden, ob ein Anschriftfeld gesetzt werden soll oder nicht. Voreingestellt\textnote{Voreinstellung} ist mit \PValue{true} die Verwendung eines Anschriftfeldes. Die Option versteht die in \autoref{tab:\LabelBase.addrfield}\ChangedAt{v3.03}{\Class{scrlttr2}} %, \autopageref{tab:\LabelBase.addrfield} -angegebenen Werte für den \PName{Modus}. Bei den Werten \PValue{true}, +angegebenen Werte für den \PName{Modus}. Bei den Werten \PValue{true}, \PValue{topaligned}\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}, \PValue{PP} und \PValue{backgroundimage} werden Name -und Adresse des Empfängers, die im Anschriftfeld gesetzt werden, über das +und Adresse des Empfängers, die im Anschriftfeld gesetzt werden, über das Argument der Umgebung \DescRef{\LabelBase.env.letter} (siehe \autoref{sec:\LabelBase.document}, \DescPageRef{\LabelBase.env.letter}) -bestimmt. Diese Angaben werden außerdem in die Variablen \Variable{toname} und +bestimmt. Diese Angaben werden außerdem in die Variablen \Variable{toname} und \Variable{toaddress} kopiert. \BeginIndexGroup \BeginIndex{FontElement}{addressee}\LabelFontElement{addressee}% \BeginIndex{FontElement}{toname}\LabelFontElement{toname}% \BeginIndex{FontElement}{toaddress}\LabelFontElement{toaddress}% -Die voreingestellten Schriftarten können\ChangedAt{v2.97c}{\Class{scrlttr2}} -über die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und +Die voreingestellten Schriftarten können\ChangedAt{v2.97c}{\Class{scrlttr2}} +über die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, ab -\DescPageRef{\LabelBase.cmd.setkomafont}) verändert werden. Dabei existieren -drei Elemente. Zunächst gibt es das Element +\DescPageRef{\LabelBase.cmd.setkomafont}) verändert werden. Dabei existieren +drei Elemente. Zunächst gibt es das Element \FontElement{addressee}\IndexFontElement{addressee}% -\important{\FontElement{addressee}}, das generell für die Anschrift zuständig +\important{\FontElement{addressee}}, das generell für die Anschrift zuständig ist. Dazu gibt es die Elemente \FontElement{toname}\IndexFontElement{toname}\important{\FontElement{toname}} und \FontElement{toaddress}\IndexFontElement{toaddress}% \important{\FontElement{toaddress}}, die sich nur auf den Namen bzw. die -Adresse des Empfängers beziehen. Für \FontElement{toname} und -\FontElement{toaddress} können also Abweichungen von der Einstellung für +Adresse des Empfängers beziehen. Für \FontElement{toname} und +\FontElement{toaddress} können also Abweichungen von der Einstellung für \FontElement{addressee} definiert werden.% \EndIndexGroup % \begin{table} - \caption[{Mögliche Werte für Option \Option{addrfield} bei + \caption[{Mögliche Werte für Option \Option{addrfield} bei \Class{scrlttr2} und \Package{scrletter}}] - {Mögliche Werte für Option \Option{addrfield} zur + {Mögliche Werte für Option \Option{addrfield} zur Auswahl der Art der Anschrift% \label{tab:\LabelBase.addrfield}}% \begin{desctabular} @@ -1712,74 +1725,74 @@ Adresse des Empfängers beziehen. Für \FontElement{toname} und \PValue{ppbackgroundimage}, \PValue{ppBackgroundImage}, \PValue{ppBackGroundImage}}{% Es wird eine Anschrift mit einer in Variable \Variable{addresseeimage} - abgelegten Hintergrundgrafik als Port-Payé-Kopf (P.\,P.-Kopf), aber ohne - Rücksendeadresse und Versandart gesetzt.}% + abgelegten Hintergrundgrafik als Port-Payé-Kopf (P.\,P.-Kopf), aber ohne + Rücksendeadresse und Versandart gesetzt.}% \entry{\PValue{false}, \PValue{off}, \PValue{no}}{% Es wird keine Anschrift gesetzt.}% \entry{\PValue{image}, \PValue{Image}, \PValue{PPimage}, \PValue{PPImage}, \PValue{ppimage}, \PValue{ppImage}}{% Eine in Variable \Variable{addresseeimage} abgelegte Abbildung wird als - Anschrift mit Port-Payé gesetzt. Adressinformationen und Angaben für - Rücksendeadresse, Versandart oder Priorität werden ignoriert.}% + Anschrift mit Port-Payé gesetzt. Adressinformationen und Angaben für + Rücksendeadresse, Versandart oder Priorität werden ignoriert.}% \entry{\PValue{PP}, \PValue{pp}, \PValue{PPexplicite}, \PValue{PPExplicite}, \PValue{ppexplicite}, \PValue{ppExplicite}}{% - Es wird eine Anschrift mit explizit über die Variablen + Es wird eine Anschrift mit explizit über die Variablen \Variable{fromzipcode}, \Variable{place} und \Variable{PPcode} - ausgefülltem Port-Payé-Kopf (P.\,P.-Kopf), gegebenenfalls mit Priorität - und über Variable \Variable{PPdatamatrix} gesetzter Data-Matrix, aber - ohne Rücksendeadresse und Versandart gesetzt.}% + ausgefülltem Port-Payé-Kopf (P.\,P.-Kopf), gegebenenfalls mit Priorität + und über Variable \Variable{PPdatamatrix} gesetzter Data-Matrix, aber + ohne Rücksendeadresse und Versandart gesetzt.}% \entry{\PValue{topaligned}, \PValue{alignedtop}% \ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}}{% - Es wird eine Anschrift mit Rücksendeadresse und Versandart oder - Priorität gesetzt. Die Anschrift wird dabei unter der Versandart nicht + Es wird eine Anschrift mit Rücksendeadresse und Versandart oder + Priorität gesetzt. Die Anschrift wird dabei unter der Versandart nicht vertikal zentriert.}% \entry{\PValue{true}, \PValue{on}, \PValue{yes}}{% - Es wird eine Anschrift mit Rücksendeadresse und Versandart oder - Priorität gesetzt.}% + Es wird eine Anschrift mit Rücksendeadresse und Versandart oder + Priorität gesetzt.}% \end{desctabular} \end{table}% Im Anschriftfeld wird in der Voreinstellung \OptionValue{addrfield}{true} -zusätzlich noch die unterstrichene Rücksendeadresse gesetzt. Mit Option -\Option{backaddress} kann gewählt werden, ob und in welcher Form die -Rücksendeadresse\Index{Ruecksendeadresse=Rücksendeadresse} für -Fensterbriefumschläge im Anschriftfeld gesetzt werden soll. Die +zusätzlich noch die unterstrichene Rücksendeadresse gesetzt. Mit Option +\Option{backaddress} kann gewählt werden, ob und in welcher Form die +Rücksendeadresse\Index{Ruecksendeadresse=Rücksendeadresse} für +Fensterbriefumschläge im Anschriftfeld gesetzt werden soll. Die Option\important{\OptionValue{backaddress}{false}} versteht dazu einerseits -die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, +die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Dabei bleibt der Stil der -Rücksendeadresse unverändert. Beim Einschalten der Rücksendeadresse kann +Rücksendeadresse unverändert. Beim Einschalten der Rücksendeadresse kann andererseits\ChangedAt{v2.96}{\Class{scrlttr2}} gleichzeitig auch der Stil der -Rücksendeadresse gewählt werden. So aktiviert der Wert +Rücksendeadresse gewählt werden. So aktiviert der Wert \PValue{underlined}\important{\OptionValue{backaddress}{underlined}} die -unterstrichene Rücksendeadresse, während +unterstrichene Rücksendeadresse, während \PValue{plain}\important{\OptionValue{backaddress}{plain}} den Stil ohne -Unterstreichung auswählt. Voreingestellt\textnote{Voreinstellung} ist -\PValue{underlined}, also das Setzen der unterstrichenen Rücksendeadresse. +Unterstreichung auswählt. Voreingestellt\textnote{Voreinstellung} ist +\PValue{underlined}, also das Setzen der unterstrichenen Rücksendeadresse. -Die Rücksendeadresse selbst wird über den \PName{Inhalt} der Variable -\Variable{backaddress} bestimmt. Voreingestellt ist hier der über -\DescRef{\LabelBase.variable.fromname} angegebene Name und die über +Die Rücksendeadresse selbst wird über den \PName{Inhalt} der Variable +\Variable{backaddress} bestimmt. Voreingestellt ist hier der über +\DescRef{\LabelBase.variable.fromname} angegebene Name und die über \DescRef{\LabelBase.variable.fromaddress} angegebene Adresse, wobei der Doppelbackslash in diesem Fall durch den Inhalt der Variablen -\Variable{backaddressseparator} ersetzt wird. Für diese ist ein Komma, gefolgt +\Variable{backaddressseparator} ersetzt wird. Für diese ist ein Komma, gefolgt von einem nicht umbrechbaren Leerzeichen vordefiniert. Die \PName{Bezeichnung} der Variablen \Variable{backaddress} wird von \KOMAScript{} nicht genutzt. \BeginIndexGroup\BeginIndex{FontElement}{backaddress}% \LabelFontElement{backaddress}% -Die Schriftart der Rücksendeadresse ist über das Element +Die Schriftart der Rücksendeadresse ist über das Element \FontElement{backaddress}\important{\FontElement{backaddress}} konfigurierbar. Voreingestellt ist hierbei \Macro{sffamily} (siehe \autoref{tab:\LabelBase.AddresseeElements}). Vor der Anwendung der -konfigurierten Schriftumschaltung wird noch \Macro{scriptsize} ausgeführt.% +konfigurierten Schriftumschaltung wird noch \Macro{scriptsize} ausgeführt.% \EndIndexGroup -Während die Adresse in der Voreinstellung +Während die Adresse in der Voreinstellung \OptionValue{addrfield}{true}\ChangedAt{v3.17}{\Class{scrlttr2}\and - \Package{scrletter}} im für die Anschrift verfügbaren Platz vertikal -zentriert wird, entfällt die Zentrierung mit + \Package{scrletter}} im für die Anschrift verfügbaren Platz vertikal +zentriert wird, entfällt die Zentrierung mit \OptionValue{addrfield}{topaligned}% -\important{\OptionValue{addrfield}{topaligned}}. Sie wird dann oben bündig im -verfügbaren Platz gesetzt. +\important{\OptionValue{addrfield}{topaligned}}. Sie wird dann oben bündig im +verfügbaren Platz gesetzt. \begin{table} % \centering @@ -1787,10 +1800,10 @@ verfügbaren Platz gesetzt. \setcapindent{0pt}% % \caption \begin{captionbeside}[{% - Schriftvoreinstellungen für die Elemente des Anschriftfensters% + Schriftvoreinstellungen für die Elemente des Anschriftfensters% }]{% \hspace{0pt plus 1ex}% - Voreinstellungen für die Schrift der Elemente des Anschriftfensters% + Voreinstellungen für die Schrift der Elemente des Anschriftfensters% \label{tab:\LabelBase.AddresseeElements}% }% [l] @@ -1830,23 +1843,23 @@ verfügbaren Platz gesetzt. \BeginIndexGroup \BeginIndex{FontElement}{specialmail}\LabelFontElement{specialmail} -Zwischen Rücksendeadresse und Empfängeradresse kann bei \iffree{der +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 +\OptionValue{priority}{manual}\ChangedAt{v3.03}{\Class{scrlttr2}} gewählt wird, was der Voreinstellung entspricht. Die \PName{Bezeichnung} von \Variable{specialmail} wird durch \Class{scrlttr2} nicht genutzt. Die -Ausrichtung wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und +Ausrichtung wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und \PLength{specialmailrightindent} (siehe \DescPageRef{scrlttr2-experts.plength.specialmailindent}) festgelegt. Die voreingestellte Schriftart des Elements\ChangedAt{v2.97c}{\Class{scrlttr2}} \FontElement{specialmail}\important{\FontElement{specialmail}}, die Sie -\autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe +\autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -verändert werden.% +verändert werden.% \EndIndexGroup \BeginIndexGroup @@ -1856,85 +1869,85 @@ Wird\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\normalcolor \OptionValue{priority}{A}\\ \normalcolor\OptionValue{priority}{B}} hingegen mit \OptionValue{priority}{A} oder \OptionValue{priority}{B} (siehe -\autoref{tab:\LabelBase.priority}) eine internationale Priorität ausgewählt, +\autoref{tab:\LabelBase.priority}) eine internationale Priorität ausgewählt, so wird diese bei \OptionValue{addrfield}{true} als Versandart und bei \OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} an -entsprechender Stelle im Port-Payé-Kopf gesetzt. Dabei wird die +entsprechender Stelle im Port-Payé-Kopf gesetzt. Dabei wird die Grundschrift\important{\FontElement{priority}\\ - \FontElement{prioritykey}} über das Element \FontElement{priority} und die -davon abweichende Schrift für den Prioritätsschlüssel, »A« oder »B«, über das + \FontElement{prioritykey}} über das Element \FontElement{priority} und die +davon abweichende Schrift für den Prioritätsschlüssel, »A« oder »B«, über das Element \FontElement{prioritykey} bestimmt. Die voreingestellten Schriftarten der beiden Elemente, die Sie \autoref{tab:\LabelBase.AddresseeElements} -entnehmen können, kann mit Hilfe der Anweisungen +entnehmen können, kann mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -verändert werden.% +verändert werden.% \EndIndexGroup \begin{table} - \caption[{Mögliche Werte für Option \Option{priority} bei + \caption[{Mögliche Werte für Option \Option{priority} bei \Class{scrlttr2} und \Class{scrletter}}] - {Mögliche Werte für Option \Option{priority} zur - Auswahl einer internationalen Priorität im Adressfeld} + {Mögliche Werte für Option \Option{priority} zur + Auswahl einer internationalen Priorität im Adressfeld} \label{tab:\LabelBase.priority} \begin{desctabular} \entry{\PValue{false}, \PValue{off}, \PValue{no}, \PValue{manual}}{% - Es wird keine Priorität gesetzt.}% + Es wird keine Priorität gesetzt.}% \entry{\PValue{B}, \PValue{b}, \PValue{economy}, \PValue{Economy}, \PValue{ECONOMY}, \PValue{B-ECONOMY}, \PValue{B-Economy}, \PValue{b-economy}}{% - Es wird die internationale Priorität B-Economy gesetzt. Bei + Es wird die internationale Priorität B-Economy gesetzt. Bei \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}% \entry{\PValue{A}, \PValue{a}, \PValue{priority}, \PValue{Priority}, \PValue{PRIORITY}, \PValue{A-PRIORITY}, \PValue{A-Priority}, \PValue{a-priority}}{% - Es wird die internationale Priorität A-Priority gesetzt. Bei + Es wird die internationale Priorität A-Priority gesetzt. Bei \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}% \end{desctabular} \end{table} Bei\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\OptionValue{addrfield}{PP}} -\OptionValue{addrfield}{PP} wird im Port-Payé-Kopf die Postleitzahl aus der +\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 +\Variable{zipcodeseparator} vorangestellt. Für diese \PName{Bezeichnung} hängt die Voreinstellung von der verwendeten \File{lco}-Datei (siehe \autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) -ab. Für den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen +ab. Für den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen \iffalse % Umbruchvarianten ein kleiner Abstand, gefolgt von einem Streckenstrich, gefolgt von einem kleinen Abstand (\Macro{,}\texttt{-{}-}\Macro{,}) % \else% -»\Macro{,}\texttt{-{}-}\Macro{,}« % +»\Macro{,}\texttt{-{}-}\Macro{,}« % \fi% voreingestellt. -Darüber\ChangedAt{v3.03}{\Class{scrlttr2}} hinaus wird bei +Darüber\ChangedAt{v3.03}{\Class{scrlttr2}} hinaus wird bei \OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} im -Port-Payé-Kopf auch noch ein Code gesetzt, der den Absender eindeutig +Port-Payé-Kopf auch noch ein Code gesetzt, der den Absender eindeutig identifiziert. Dieser ist in Variable \Variable{PPcode} abgelegt. Rechts von -der Anschrift kann zusätzlich eine Data-Matrix gesetzt werden, die in Variable +der Anschrift kann zusätzlich eine Data-Matrix gesetzt werden, die in Variable \Variable{PPdatamatrix} abgelegt ist. \BeginIndexGroup \BeginIndex{FontElement}{PPdata}\LabelFontElement{PPdata} Postleitzahl\ChangedAt{v3.03}{\Class{scrlttr2}}, Ort und Code werden in der -Voreinstellung mit einer Schrift der Größe 8\,pt gesetzt. Dabei wird die +Voreinstellung mit einer Schrift der Größe 8\,pt gesetzt. Dabei wird die Schrift des Elements \FontElement{PPdata}% \important{\FontElement{PPdata}} verwendet. Dessen Voreinstellung ist \autoref{tab:\LabelBase.AddresseeElements} zu entnehmen und kann mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -verändert werden.% +verändert werden.% \EndIndexGroup \BeginIndexGroup \BeginIndex{FontElement}{PPlogo}\LabelFontElement{PPlogo} -Für den Port-Payé-Schriftzug »P.P.« kommt dagegen die Schrift des Elements +Für den Port-Payé-Schriftzug »P.P.« kommt dagegen die Schrift des Elements \FontElement{PPlogo}\important{\FontElement{PPlogo}} zur Anwendung. Dessen Voreinstellung ist ebenfalls Tabelle \autoref{tab:\LabelBase.AddresseeElements} zu entnehmen.% @@ -1946,24 +1959,24 @@ Bei\important{\OptionValue{addrfield}{backgroundimage}\\ und \OptionValue{addrfield}{image} wird eine Abbildung in das Adressfenster gesetzt. Diese ist im \PName{Inhalt} der Variablen \Variable{addresseeimage} abgelegt. Die \PName{Bezeichnung} dieser Variablen wird von \KOMAScript{} -nicht genutzt. Während bei Einstellung \OptionValue{addrfield}{image} außer der +nicht genutzt. Während bei Einstellung \OptionValue{addrfield}{image} außer der Abbildung nichts gesetzt wird, wird bei -\OptionValue{addrfield}{backgroundimage} zusätzlich noch die Anschrift aus dem +\OptionValue{addrfield}{backgroundimage} zusätzlich noch die Anschrift aus dem obligatorischen Argument der \DescRef{\LabelBase.env.letter}-Umgebung ausgegeben. -Die Anordnung des Port-Payé-Kopfes wird ebenso wie die Anordnung der -Port-Payé-Anschrift über die Pseudolängen \PLength{toaddrindent} (siehe +Die Anordnung des Port-Payé-Kopfes wird ebenso wie die Anordnung der +Port-Payé-Anschrift über die Pseudolängen \PLength{toaddrindent} (siehe \DescPageRef{scrlttr2-experts.plength.toaddrindent}) sowie \PLength{PPheadwidth} und \PLength{PPheadheight} (siehe -\DescPageRef{scrlttr2-experts.plength.PPheadheight}) bestimmt. Für die -Anordnung der Data-Matrix ist die Pseudolänge \PLength{PPdatamatrixvskip} +\DescPageRef{scrlttr2-experts.plength.PPheadheight}) bestimmt. Für die +Anordnung der Data-Matrix ist die Pseudolänge \PLength{PPdatamatrixvskip} (siehe \DescPageRef{scrlttr2-experts.plength.PPdatamatrixvskip}) -zuständig. +zuständig. -Es\textnote{Achtung!} wird an dieser Stelle ausdrücklich darauf hingewiesen, +Es\textnote{Achtung!} wird an dieser Stelle ausdrücklich darauf hingewiesen, dass \KOMAScript{} selbst keine externen Abbildungen setzen kann, sollen also -über die Variablen \Variable{addresseeimage} oder \Variable{PPdatamatrix} +über die Variablen \Variable{addresseeimage} oder \Variable{PPdatamatrix} externe Abbildungen gesetzt werden, so ist beispielsweise das Grafikpaket \Package{graphics}\IndexPackage{graphics} oder \Package{graphicx}\IndexPackage{graphicx} zu laden und in den Variablen dessen @@ -1974,22 +1987,22 @@ Anweisung \Macro{includegraphics} zu verwenden.% \begin{Declaration} \OptionVName{locfield}{Einstellung} \end{Declaration} -\BeginIndex{}{Absenderergaenzung=Absenderergänzung}% +\BeginIndex{}{Absenderergaenzung=Absenderergänzung}% Neben dem Anschriftfeld setzt \Class{scrlttr2} noch ein Feld mit erweiterter -Absenderangabe. Der Inhalt ist frei wählbar. Je\important{% +Absenderangabe. Der Inhalt ist frei wählbar. Je\important{% \OptionValueRef{\LabelBase}{fromalign}{locationleft}\\ \OptionValueRef{\LabelBase}{fromalign}{center}\\ \OptionValueRef{\LabelBase}{fromalign}{locationright}} nach Einstellung der -oben erklärten Option \DescRef{\LabelBase.option.fromalign} wird es außerdem -für das Logo des Absenders oder den Absender selbst mitverwendet. Die Breite +oben erklärten Option \DescRef{\LabelBase.option.fromalign} wird es außerdem +für das Logo des Absenders oder den Absender selbst mitverwendet. Die Breite dieses Feldes kann beispielsweise in einer \File{lco}-Datei (siehe \autoref{sec:\LabelBase.lcoFile}) gesetzt werden. Wird dort die Breite 0 -gesetzt, so kann über die Option \Option{locfield} zwischen zwei -unterschiedlichen Voreinstellungen für die Breite dieses Feldes gewählt +gesetzt, so kann über die Option \Option{locfield} zwischen zwei +unterschiedlichen Voreinstellungen für die Breite dieses Feldes gewählt werden. Dies ist bei der Mehrzahl der \File{lco}-Dateien der Fall, die -\KOMAScript{} beiliegen. Siehe hierzu auch die Erklärungen zur Pseudolänge +\KOMAScript{} beiliegen. Siehe hierzu auch die Erklärungen zur Pseudolänge \PLength{locwidth} in \autoref{sec:scrlttr2-experts.locationField}, -\DescPageRef{scrlttr2-experts.plength.locwidth}. Mögliche Werte für die Option +\DescPageRef{scrlttr2-experts.plength.locwidth}. Mögliche Werte für die Option sind \autoref{tab:\LabelBase.locfield} zu entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}. % @@ -1998,16 +2011,16 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}. \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside} - [{Mögliche Werte für Option \Option{locfield} bei + [{Mögliche Werte für Option \Option{locfield} bei \Class{scrlttr2}}] - {Mögliche Werte für Option \Option{locfield} zur Wahl der Breite des - Feldes für die Absenderergänzung bei \Class{scrlttr2}% + {Mögliche Werte für Option \Option{locfield} zur Wahl der Breite des + Feldes für die Absenderergänzung bei \Class{scrlttr2}% \label{tab:\LabelBase.locfield}}% [l] \begin{minipage}[t]{.55\linewidth} \begin{desctabular}[t] - \pventry{narrow}{schmales Feld für Absenderergänzungen}% - \pventry{wide}{breites Feld für Absenderergänzungen}% + \pventry{narrow}{schmales Feld für Absenderergänzungen}% + \pventry{wide}{breites Feld für Absenderergänzungen}% \end{desctabular} \end{minipage} \end{captionbeside} @@ -2016,27 +2029,27 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}. \begin{Declaration} \Variable{location} \end{Declaration} -Der Inhalt der Absenderergänzung, soweit er nicht durch Logo oder den Absender -selbst belegt ist, wird mit der Variablen \Variable{location} festgelegt. Für -den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen, wie +Der Inhalt der Absenderergänzung, soweit er nicht durch Logo oder den Absender +selbst belegt ist, wird mit der Variablen \Variable{location} festgelegt. Für +den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen, wie \Macro{raggedright}, verwendet werden. Die \PName{Bezeichnung} dieser Variablen wird von \KOMAScript{} nicht genutzt. \begin{Example} - Herr Musterfrau möchte ein paar zusätzliche Informationen zu seiner - Mitgliedschaft angeben. Er wählt dazu die Absenderergänzung:% + Herr Musterfrau möchte ein paar zusätzliche Informationen zu seiner + Mitgliedschaft angeben. Er wählt dazu die Absenderergänzung:% \lstinputcode[xleftmargin=1em]{letter-19.tex}% Das entsprechende Feld neben der Anschrift wird dann wie in \autoref{fig:\LabelBase.letter-19} gesetzt. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Anrede, Text, Grußfloskel, + Anschrift, Absenderergänzung, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Anrede, Text, Grußfloskel, Signatur, + Anschrift, Absenderergänzung, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke (das Datum entstammt - den Voreinstellungen für DIN-Briefe)}[l] + den Voreinstellungen für DIN-Briefe)}[l] \frame{\includegraphics[width=.4\textwidth]{letter-19}} \end{captionbeside} \label{fig:\LabelBase.letter-19} @@ -2050,16 +2063,16 @@ wird von \KOMAScript{} nicht genutzt. \begin{Declaration} \OptionVName{numericaldate}{Ein-Aus-Wert} \end{Declaration} -Mit dieser Option kann zwischen der sprachabhängigen Standarddarstellung des -Datums\Index{Datum}\Index{Geschaeftszeile=Geschäftszeile} und einem ebenfalls -sprachabhängigen, kurzen, rein nummerischen Datum umgeschaltet werden. Die +Mit dieser Option kann zwischen der sprachabhängigen Standarddarstellung des +Datums\Index{Datum}\Index{Geschaeftszeile=Geschäftszeile} und einem ebenfalls +sprachabhängigen, kurzen, rein nummerischen Datum umgeschaltet werden. Die Standarddarstellung wird nicht von \KOMAScript{} bereitgestellt. Sie kann wahlweise von einem Paket wie \Package{ngerman}\IndexPackage{ngerman}, \Package{babel}\IndexPackage{babel} oder auch \Package{isodate}\IndexPackage{isodate} stammen. Das\important{\OptionValue{numericaldate}{true}} kurze nummerische Datum wird hingegen von \Class{scrlttr2} selbst erzeugt. Die Option versteht -die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, +die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Voreingestellt\textnote{Voreinstellung} ist mit \PValue{false} die Verwendung der Standarddarstellung. @@ -2067,12 +2080,12 @@ Verwendung der Standarddarstellung. \begin{Declaration} \Variable{date} \end{Declaration} -Das Datum in der gewählten Darstellung wird im \PName{Inhalt} der Variablen +Das Datum in der gewählten Darstellung wird im \PName{Inhalt} der Variablen \Variable{date} abgelegt. Die Einstellung von \DescRef{\LabelBase.option.numericaldate}% \important{\DescRef{\LabelBase.option.numericaldate}} hat keine Auswirkung, -wenn diese Variable überschrieben wird. Gesetzt wird das Datum normalerweise -als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten leer bleibt +wenn diese Variable überschrieben wird. Gesetzt wird das Datum 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 \DescRef{\LabelBase.option.refline} Auswirkungen auf @@ -2088,41 +2101,41 @@ Beschreibung zur Variablen \begin{Declaration} \OptionVName{refline}{Einstellung} \end{Declaration} -\BeginIndex{}{Geschaeftszeile=Geschäftszeile}% -Insbesondere bei Geschäftsbriefen findet sich häufig eine Zeile mit Angaben -wie Namenskürzeln\Index{Kuerzel=Kürzel}, Durchwahl\Index{Durchwahl}, +\BeginIndex{}{Geschaeftszeile=Geschäftszeile}% +Insbesondere bei Geschäftsbriefen findet sich häufig eine Zeile mit Angaben +wie Namenskürzeln\Index{Kuerzel=Kürzel}, Durchwahl\Index{Durchwahl}, Kunden-\Index{Kundennummer} und Rechnungsnummer\Index{Rechnungsnummer} oder -zur Bezugnahme auf ein früheres Schreiben. Diese Zeile wird in dieser -Anleitung \emph{Geschäftszeile}\textnote{Geschäftszeile} genannt. +zur Bezugnahme auf ein früheres Schreiben. Diese Zeile wird in dieser +Anleitung \emph{Geschäftszeile}\textnote{Geschäftszeile} genannt. -Bei \Class{scrlttr2} und \Package{scrletter} können Kopf, Fuß, Anschrift und -das Feld mit der Absenderergänzung links und rechts aus dem normalen -Satzspiegel herausragen. Über +Bei \Class{scrlttr2} und \Package{scrletter} können Kopf, Fuß, Anschrift und +das Feld mit der Absenderergänzung links und rechts aus dem normalen +Satzspiegel herausragen. Ãœber \OptionValue{refline}{wide}\important{\OptionValue{refline}{wide}} kann -gewählt werden, dass dies auch für die Geschäftszeile gelten soll. Die -Geschäftszeile enthält normalerweise zumindest das Datum, kann aber auch -weitere Angaben aufnehmen. Mögliche Werte für diese Option sind +gewählt werden, dass dies auch für die Geschäftszeile gelten soll. Die +Geschäftszeile enthält normalerweise zumindest das Datum, kann aber auch +weitere Angaben aufnehmen. Mögliche Werte für diese Option sind \autoref{tab:\LabelBase.refline} zu entnehmen. Voreingestellt\textnote{Voreinstellung} sind \PValue{narrow} und \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.% % \begin{table} - \caption[{Mögliche Werte für Option \Option{refline} bei + \caption[{Mögliche Werte für Option \Option{refline} bei \Class{scrlttr2} und \Package{scrletter}}] - {Mögliche Werte für Option \Option{refline} zur - Konfiguration der Geschäftszeile} + {Mögliche Werte für Option \Option{refline} zur + Konfiguration der Geschäftszeile} \label{tab:\LabelBase.refline} \begin{desctabular} \pventry{dateleft}{\ChangedAt{v3.09}{\Class{scrlttr2}}% - Das Datum steht automatisch links in der Geschäftszeile.}% + Das Datum steht automatisch links in der Geschäftszeile.}% \pventry{dateright}{\ChangedAt{v3.09}{\Class{scrlttr2}}% - Das Datum steht automatisch rechts in der Geschäftszeile.}% - \pventry{narrow}{Die Breite der Geschäftszeile richtet sich nach dem + Das Datum steht automatisch rechts in der Geschäftszeile.}% + \pventry{narrow}{Die Breite der Geschäftszeile richtet sich nach dem Satzspiegel.}% \pventry{nodate}{\ChangedAt{v3.09}{\Class{scrlttr2}}% - Das Datum wird nicht automatisch in die Geschäftszeile gesetzt.}% - \pventry{wide}{Die Breite der Geschäftszeile richtet sich nach Anschrift - und Absenderergänzung.}% + Das Datum wird nicht automatisch in die Geschäftszeile gesetzt.}% + \pventry{wide}{Die Breite der Geschäftszeile richtet sich nach Anschrift + und Absenderergänzung.}% \end{desctabular} \end{table} @@ -2133,7 +2146,7 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} sind \PValue{narrow} und \Variable{customer} \Variable{invoice} \end{Declaration} -Typische Felder der Geschäftszeile werden über die fünf Variablen +Typische Felder der Geschäftszeile werden über die fünf Variablen \Variable{yourref}, \Variable{yourmail}, \Variable{myref}, \Variable{customer} und \Variable{invoice} verwaltet. % \iffalse % Umbruchkorrektur @@ -2144,9 +2157,9 @@ Ihre Bedeutung % ist \autoref{tab:\LabelBase.variables}, \autopageref{tab:\LabelBase.variables} zu entnehmen. Jede dieser Variablen hat auch eine vordefinierte \PName{Bezeichnung}, die in \autoref{tab:\LabelBase.reflineTerm} zu finden -ist. Wie weitere Variablen zur Geschäftszeile hinzugefügt werden können, ist +ist. Wie weitere Variablen zur Geschäftszeile hinzugefügt werden können, ist in \autoref{sec:scrlttr2-experts.variables} ab -\DescPageRef{scrlttr2-experts.cmd.newkomavar} erklärt. +\DescPageRef{scrlttr2-experts.cmd.newkomavar} erklärt. \begin{table} % \centering @@ -2155,9 +2168,9 @@ in \autoref{sec:scrlttr2-experts.variables} ab % \caption \begin{captionbeside} [{Vordefinierte Bezeichnungen der Variablen der - Geschäftszeile}] + Geschäftszeile}] {Vordefinierte Bezeichnungen der typischen Variablen der - Geschäftszeile unter Verwendung sprachabhängiger Anweisungen% + Geschäftszeile unter Verwendung sprachabhängiger Anweisungen% \label{tab:\LabelBase.reflineTerm}% } [l] @@ -2180,9 +2193,9 @@ in \autoref{sec:scrlttr2-experts.variables} ab \BeginIndex{FontElement}{refname}\LabelFontElement{refname}% \BeginIndex{FontElement}{refvalue}\LabelFontElement{refvalue}% Schriftart und Farbe\ChangedAt{v2.97c}{\Class{scrlttr2}} der Feldbezeichnung -und des Feldinhalts können über die beiden Elemente +und des Feldinhalts können über die beiden Elemente \FontElement{refname}\important{\FontElement{refname}, \FontElement{refvalue}} -und \FontElement{refvalue} geändert werden. Dazu werden die Anweisungen +und \FontElement{refvalue} geändert werden. Dazu werden die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) @@ -2194,8 +2207,8 @@ verwendet. Die Voreinstellungen der \iffree{beiden }{}Elemente sind \setcapindent{0pt}% % \caption \begin{captionbeside} - [{Schriftvoreinstellungen für die Elemente der Geschäftszeile}] - {Voreinstellungen für die Schrift der Elemente der Geschäftszeile% + [{Schriftvoreinstellungen für die Elemente der Geschäftszeile}] + {Voreinstellungen für die Schrift der Elemente der Geschäftszeile% \label{tab:\LabelBase.refnamerefvalue}} [l] \begin{tabular}[t]{ll} @@ -2217,24 +2230,24 @@ verwendet. Die Voreinstellungen der \iffree{beiden }{}Elemente sind \end{Declaration}% Sind bis auf \DescRef{\LabelBase.variable.date}% \important{\DescRef{\LabelBase.variable.date}}\IndexVariable{date} alle -Variablen der Geschäftszeile leer, so wird keine eigentliche Geschäftszeile +Variablen der Geschäftszeile leer, so wird keine eigentliche Geschäftszeile gesetzt. Stattdessen werden dann nur Ort\Index{Ort} und Datum\Index{Datum} ausgegeben. Dabei bestimmt der \PName{Inhalt} der Variablen -\DescRef{\LabelBase.variable.place} den Ort. Für das Trennzeichen, das in +\DescRef{\LabelBase.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 +\Variable{placeseparator} zuständig. Der vordefinierte\textnote{Voreinstellung} \PName{Inhalt} des Trennzeichens ist dabei ein Komma, gefolgt von einem nicht umbrechbaren Leerzeichen. Ist der Ort leer, so wird auch das Trennzeichen nicht gesetzt. Der vordefinierte \PName{Inhalt} der Variablen \DescRef{\LabelBase.variable.date} ist -\Macro{today}\IndexCmd{today}\important{\Macro{today}} und hängt von der +\Macro{today}\IndexCmd{today}\important{\Macro{today}} und hängt von der Einstellung der Option \DescRef{\LabelBase.option.numericaldate}% \important{\DescRef{\LabelBase.option.numericaldate}}% \IndexOption{numericaldate} ab (siehe \DescPageRef{\LabelBase.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 +nicht mehr zwingend rechtsbündig ausgegeben. Stattdessen findet auch im Falle der Datumszeile die Datumseinstellung von Option \DescRef{\LabelBase.option.refline}\IndexOption{refline}% \important{\DescRef{\LabelBase.option.refline}}, wie sie in @@ -2242,7 +2255,7 @@ der Datumszeile die Datumseinstellung von Option \BeginIndexGroup \BeginIndex{FontElement}{placeanddate}\LabelFontElement{placeanddate}% -Falls\ChangedAt{v3.12}{\Class{scrlttr2}} statt der Geschäftszeile eine solche +Falls\ChangedAt{v3.12}{\Class{scrlttr2}} statt der Geschäftszeile eine solche Datumszeile mit Ort gesetzt wird, so findet nicht die Schrifteinstellung des Elements \DescRef{\LabelBase.fontelement.refvalue} Anwendung. Stattdessen wird in diesem Fall das Element @@ -2251,27 +2264,27 @@ dessen leere Voreinstellung wie gewohnt mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -geändert werden kann.% +geändert werden kann.% \EndIndexGroup \begin{Example} - Herr Musterfrau setzt nun auch die Variable für den Ort: + 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:\LabelBase.letter-20}, \autopageref{fig:\LabelBase.letter-20} zu sehen, der Ort, gefolgt von den automatischen Trennzeichen vor dem Datum. Dieses Datum wurde im Beispielcode - über Variable \DescRef{\LabelBase.variable.date} ebenfalls explizit gesetzt, - damit bei einem späteren \LaTeX-Durchlauf des Briefes das ursprüngliche + über Variable \DescRef{\LabelBase.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, - Anschrift, Absenderergänzung, Ort, Datum, Anrede, Text, - Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Anschrift, Absenderergänzung, Ort, Datum, Anrede, Text, + Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, - Logo, Anschrift, Absenderergänzung, Ort, Datum, Anrede, - Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Logo, Anschrift, Absenderergänzung, Ort, Datum, Anrede, + Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}[l] \frame{\includegraphics[width=.4\textwidth]{letter-20}} \end{captionbeside} @@ -2287,29 +2300,29 @@ geändert werden kann.% \begin{Declaration} \Variable{title} \end{Declaration} -Bei \KOMAScript{} kann ein Brief zusätzlich mit einem Titel\Index{Titel} -versehen werden. Der Titel wird zentriert in der Schriftgröße \Macro{LARGE} -unterhalb der Geschäftszeile ausgegeben. +Bei \KOMAScript{} kann ein Brief zusätzlich mit einem Titel\Index{Titel} +versehen werden. Der Titel wird zentriert in der Schriftgröße \Macro{LARGE} +unterhalb der Geschäftszeile ausgegeben. \BeginIndex{FontElement}{lettertitle}\LabelFontElement{lettertitle}% \BeginIndex{FontElement}{title}\LabelFontElement{title}% -Die Schriftart für das Element\ChangedAt{v3.17}{\Class{scrlttr2}\and +Die Schriftart für das Element\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}} \FontElement{lettertitle}% \important{\FontElement{lettertitle}} kann mit den Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup} ab -\DescPageRef{\LabelBase.cmd.setkomafont}) geändert werden. Dabei sind auch -Größenangaben erlaubt. Die Größe \Macro{LARGE} wird der Schriftauswahl +\DescPageRef{\LabelBase.cmd.setkomafont}) geändert werden. Dabei sind auch +Größenangaben erlaubt. Die Größe \Macro{LARGE} wird der Schriftauswahl innerhalb von \KOMAScript{} immer vorangestellt und ist daher auch nicht Teil\textnote{Voreinstellung} der Voreinstellung \Macro{normalcolor}\Macro{sffamily}\Macro{bfseries}. Bei -\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für +\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für \FontElement{lettertitle} auch \FontElement{title}\important{\FontElement{title}} verwendet werden. Bei Verwendung von \Package{scrletter} mit einer \KOMAScript-Klasse ist das -nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element -\FontElement{title} mit abweichender Einstellung für den Dokumenttitel +nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element +\FontElement{title} mit abweichender Einstellung für den Dokumenttitel existiert.% \EndIndex{FontElement}{title}% \EndIndex{FontElement}{lettertitle}% @@ -2319,9 +2332,9 @@ existiert.% \begin{lstcode} \setkomavar{title}{Mahnung} \end{lstcode} - Damit sollte der Empfänger die Mahnung als solche erkennen. + Damit sollte der Empfänger die Mahnung als solche erkennen. \end{Example} -Während der \PName{Inhalt} der Variablen, wie im Beispiel gezeigt, den Titel +Während der \PName{Inhalt} der Variablen, wie im Beispiel gezeigt, den Titel definiert, wird die \PName{Bezeichnung} der Variablen \Variable{title} von \KOMAScript{} nicht genutzt. % @@ -2337,8 +2350,8 @@ definiert, wird die \PName{Bezeichnung} der Variablen \Variable{title} von Um einen Betreff zu setzen, legt man den \PName{Inhalt} der Variablen \Variable{subject} entsprechend fest. Mit Option \OptionValue{subject}{titled}\important{\OptionValue{subject}{titled}} kann -dann zum einen gewählt werden, dass der Betreff mit einem Titel versehen -werden soll oder nicht. Der Titel wird über die Bezeichnung der Variablen +dann zum einen gewählt werden, dass der Betreff mit einem Titel versehen +werden soll oder nicht. Der Titel wird über die Bezeichnung der Variablen \Variable{subject} bestimmt (siehe \autoref{tab:\LabelBase.subjectTerm}). Der\textnote{Voreinstellung} vordefinierte Inhalt des Trennzeichens\Index{Trennzeichen} \Variable{subjectseparator} besteht aus @@ -2350,9 +2363,9 @@ einem Doppelpunkt, gefolgt von einem Leerzeichen. \setcapindent{0pt}% % \caption \begin{captionbeside} - [{Vordefinierte Bezeichnungen der Variablen für den Betreff}] + [{Vordefinierte Bezeichnungen der Variablen für den Betreff}] {\hspace{0pt plus 1ex}% - Vordefinierte Bezeichnungen der Variablen für den Betreff} + Vordefinierte Bezeichnungen der Variablen für den Betreff} [l] \begin{tabular}[t]{lll} \toprule @@ -2369,9 +2382,9 @@ einem Doppelpunkt, gefolgt von einem Leerzeichen. \label{tab:\LabelBase.subjectTerm} \end{table} -Zum anderen kann über \OptionValue{subject}{afteropening}% +Zum anderen kann über \OptionValue{subject}{afteropening}% \important{\OptionValue{subject}{afteropening}\\ - \OptionValue{subject}{beforeopening}} gewählt werden, dass der Betreff + \OptionValue{subject}{beforeopening}} gewählt werden, dass der Betreff abweichend von der Voreinstellung \OptionValue{subject}{beforeopening} erst nach der Anrede gesetzt werden soll. Eine andere Formatierung% @@ -2380,9 +2393,9 @@ soll. Eine andere Formatierung% \OptionValue{subject}{right}} kann mit \OptionValue{subject}{underlined} und \OptionValue{subject}{centered} oder \OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}} eingestellt -werden. Mögliche Werte für Option \Option{subject} sind +werden. Mögliche Werte für Option \Option{subject} sind \autoref{tab:\LabelBase.subject} zu entnehmen. Es\textnote{Achtung!} wird -ausdrücklich darauf hingewiesen, dass bei der Einstellung +ausdrücklich darauf hingewiesen, dass bei der Einstellung \OptionValue{subject}{underlined} der Betreff komplett in eine Zeile passen muss! Voreingestellt\textnote{Voreinstellung} sind \OptionValue{subject}{left}, \OptionValue{subject}{beforeopening} und @@ -2394,9 +2407,9 @@ muss! Voreingestellt\textnote{Voreinstellung} sind \setcapindent{0pt}% % \caption \begin{captionbeside} - [{Mögliche Werte für Option \Option{subject} bei \Class{scrlttr2}}] + [{Mögliche Werte für Option \Option{subject} bei \Class{scrlttr2}}] {\hspace{0pt plus 1ex}% - Mögliche Werte für Option \Option{subject} zur Platzierung und + Mögliche Werte für Option \Option{subject} zur Platzierung und Formatierung eines Betreffs bei \Class{scrlttr2}% \label{tab:\LabelBase.subject}} [l] @@ -2405,8 +2418,8 @@ muss! Voreingestellt\textnote{Voreinstellung} sind \pventry{afteropening}{Betreff nach der Anrede setzen}% \pventry{beforeopening}{Betreff vor der Anrede setzen}% \pventry{centered}{Betreff zentrieren}% - \pventry{left}{Betreff linksbündig setzen}% - \pventry{right}{Betreff rechtsbündig setzen}% + \pventry{left}{Betreff linksbündig setzen}% + \pventry{right}{Betreff rechtsbündig setzen}% \pventry{titled}{Betreff mit Titel versehen}% \pventry{underlined}{Betreff unterstreichen (Hinweis im Text beachten!)}% @@ -2420,38 +2433,38 @@ muss! Voreingestellt\textnote{Voreinstellung} sind \BeginIndex{FontElement}{lettersubject}\LabelFontElement{lettersubject}% \BeginIndex{FontElement}{subject}\LabelFontElement{subject}% Der Betreff wird in einer eigenen Schriftart\Index{Schrift>Art} gesetzt. Um -diese zu ändern, verwenden Sie die Anweisungen +diese zu ändern, verwenden Sie die Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup} ab -\DescPageRef{\LabelBase.cmd.setkomafont}). Für das +\DescPageRef{\LabelBase.cmd.setkomafont}). Für das Element\ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}} \FontElement{lettersubject}\important{\FontElement{lettersubject}} ist als Schrift \Macro{normalcolor}\Macro{bfseries} voreingestellt. Bei Klasse -\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für +\Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} kann als Alias für \FontElement{lettersubject} auch \FontElement{subject}\important{\FontElement{subject}} verwendet werden. Bei Verwendung von Paket \Package{scrletter} mit einer \KOMAScript-Klasse ist das -nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element -\FontElement{subject} mit abweichender Einstellung für den Dokumenttitel +nicht\textnote{Achtung!} möglich, da bei diesen Klassen bereits ein Element +\FontElement{subject} mit abweichender Einstellung für den Dokumenttitel existiert. \EndIndexGroup \begin{Example} Herr Musterfrau setzt nun auch den Betreff. Als eher traditioneller - veranlagter Mensch möchte er außerdem, dass der Betreff mit einer + veranlagter Mensch möchte er außerdem, dass der Betreff mit einer entsprechenden Spitzmarke versehen wird, und setzt deshalb auch die - zugehörige Option:% + zugehörige Option:% \lstinputcode[xleftmargin=1em]{letter-21.tex}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-21} zu sehen. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, - Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und + Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, + Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, - Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, - Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler + Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, + Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}[l] \frame{\includegraphics[width=.4\textwidth]{letter-21}} \end{captionbeside} @@ -2465,21 +2478,21 @@ existiert. \begin{Declaration} \OptionVName{firstfoot}{Ein-Aus-Wert} \end{Declaration} -\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% +\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} Option bestimmt, ob der -Briefbogenfuß überhaupt gesetzt wird. Das Abschalten mit +Briefbogenfuß überhaupt gesetzt wird. Das Abschalten mit \OptionValue{firstfoot}{false}\important{\OptionValue{firstfoot}{false}} hat Auswirkungen wenn gleichzeitig Option \DescRef{\LabelBase.option.enlargefirstpage} (siehe \DescPageRef{\LabelBase.option.enlargefirstpage}) verwendet wird, da sich -dadurch die Seite logisch nach unten verlängert. Zwischen dem Ende des +dadurch die Seite logisch nach unten verlängert. Zwischen dem Ende des Satzspiegels und dem Seitenende bleibt dann nur der normale Abstand zwischen -Satzspiegel und Seitenfuß. +Satzspiegel und Seitenfuß. -Die Option versteht die Standardwerte für einfache Schalter, die in +Die Option versteht die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Voreingestellt\textnote{Voreinstellung} ist das Setzen des -Briefbogenfußes.% +Briefbogenfußes.% % \EndIndexGroup @@ -2487,9 +2500,9 @@ Briefbogenfußes.% \begin{Declaration} \Variable{firstfoot} \end{Declaration}% -\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% -Der Fuß der ersten Seite ist in der Voreinstellung leer. Es besteht jedoch die -Möglichkeit, über den \PName{Inhalt} der +\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% +Der Fuß der ersten Seite ist in der Voreinstellung leer. Es besteht jedoch die +Möglichkeit, über den \PName{Inhalt} der Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{firstfoot} einen neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von \KOMAScript{} nicht genutzt. @@ -2497,7 +2510,7 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von \BeginIndex{Variable}{frombank}% \begin{Example} Sie wollen den Inhalt der Variablen \DescRef{\LabelBase.variable.frombank}, also die - Bankverbindung im Fuß der ersten Seite ausgeben. Der doppelte + Bankverbindung im Fuß der ersten Seite ausgeben. Der doppelte Backslash soll dabei durch ein Komma ersetzt werden: \begin{lstcode} \setkomavar{firstfoot}{% @@ -2506,10 +2519,10 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von }% } \end{lstcode} - Natürlich können Sie für das Trennzeichen auch eine eigene Variable - definieren. Ich überlasse dem Leser dies als Übung. + Natürlich können Sie für das Trennzeichen auch eine eigene Variable + definieren. Ich überlasse dem Leser dies als Ãœbung. - Will man eine Art Brief"|fuß als Gegengewicht zum Briefkopf verwenden, so + Will man eine Art Brief"|fuß als Gegengewicht zum Briefkopf verwenden, so kann dieser beispielsweise wie folgt definiert werden: \begin{lstcode} \setkomavar{firstfoot}{% @@ -2517,11 +2530,11 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von \begin{tabular}[t]{l@{}}% \multicolumn{1}{@{}l@{}}{Gesellschafter:}\\ Hugo Mayer\\ - Bernd Müller + Bernd Müller \end{tabular}% \hfill \begin{tabular}[t]{l@{}}% - \multicolumn{1}{@{}l@{}}{Geschäftsführung:}\\ + \multicolumn{1}{@{}l@{}}{Geschäftsführung:}\\ Liselotte Mayer\\[1ex] \multicolumn{1}{@{}l@{}}{Gerichtsstand:}\\ Hinterdupfeldingen @@ -2537,8 +2550,8 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von }% } \end{lstcode} - Das Beispiel stammt ursprünglich von Torsten Krüger. Es wird empfohlen, eine - solche Definition für die mehrfache Verwendung in unterschiedlichen + Das Beispiel stammt ursprünglich von Torsten Krüger. Es wird empfohlen, eine + solche Definition für die mehrfache Verwendung in unterschiedlichen Dokumenten in einer eigenen \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} abzulegen. Mit \begin{lstcode} @@ -2547,23 +2560,23 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von BIC GRMLDEHD000} \end{lstcode} kann die Bankverbindung dann im Dokument passend dazu gesetzt werden.% -\iffalse% Umbruchkorrekturmöglichkeit - \ Abhängig\textnote{Achtung!} von den Voreinstellungen ist ein solch hoher - Fuß jedoch eventuell nicht vorgesehen und wird deshalb möglicherweise zu - tief platziert. In einem solchen Fall kann die vertikale Position über die - Pseudolänge \DescRef{scrlttr2-experts.plength.firstfootvpos}% +\iffalse% Umbruchkorrekturmöglichkeit + \ Abhängig\textnote{Achtung!} von den Voreinstellungen ist ein solch hoher + Fuß jedoch eventuell nicht vorgesehen und wird deshalb möglicherweise zu + tief platziert. In einem solchen Fall kann die vertikale Position über die + Pseudolänge \DescRef{scrlttr2-experts.plength.firstfootvpos}% \important{\DescRef{scrlttr2-experts.plength.firstfootvpos}}% \IndexPLength{firstfootvpos} angepasst werden (siehe \DescPageRef{scrlttr2-experts.plength.firstfootvpos}).% \fi \end{Example} -Im\textnote{Achtung!} Beispiel wurde ein mehrzeiliger Fuß gesetzt. Bei einer -Kompatibilitätseinstellung ab Version +Im\textnote{Achtung!} Beispiel wurde ein mehrzeiliger Fuß gesetzt. Bei einer +Kompatibilitätseinstellung ab Version 2.9u\important{\OptionValueRef{\LabelBase}{version}{2.9u}} (siehe \DescRef{\LabelBase.option.version} in \autoref{sec:\LabelBase.compatibilityOptions}, -\DescPageRef{\LabelBase.option.version}) reicht der Platz dafür in der Regel +\DescPageRef{\LabelBase.option.version}) reicht der Platz dafür in der Regel nicht aus. Sie sollten dann \PLength{firstfootvpos} (siehe \DescPageRef{scrlttr2-experts.plength.firstfootvpos}) entsprechend verringern.% @@ -2572,12 +2585,12 @@ verringern.% \begin{Declaration} \Variable{frombank} \end{Declaration}% -\BeginIndex{}{Briefbogenfuss=Briefbogenfuß} Die im vorherigen Beispiel +\BeginIndex{}{Briefbogenfuss=Briefbogenfuß} Die im vorherigen Beispiel verwendete Variable \Variable{frombank} nimmt derzeit eine Sonderstellung ein. Sie wird intern bisher nicht verwendet. Sie kann jedoch vom Anwender verwendet werden, um die Bankverbindung\Index{Bankverbindung} in das -Absenderergänzungsfeld (siehe Variable \DescRef{\LabelBase.variable.location}, -\DescPageRef{\LabelBase.variable.location}) oder wie im Beispiel in den Fuß zu +Absenderergänzungsfeld (siehe Variable \DescRef{\LabelBase.variable.location}, +\DescPageRef{\LabelBase.variable.location}) oder wie im Beispiel in den Fuß zu setzen.% % \EndIndexGroup @@ -2589,61 +2602,61 @@ setzen.% \LoadCommonFile{oddorevenpage}% \section{Erkennung von rechten und linken Seiten} -\section{Kopf und Fuß bei vordefinierten Seitenstilen} +\section{Kopf und Fuß bei vordefinierten Seitenstilen} \seclabel{pagestyle} \BeginIndexGroup \BeginIndex{}{Seiten>Stil} Eine der allgemeinen Eigenschaften eines Dokuments ist der Seitenstil. Bei {\LaTeX} versteht man unter dem Seitenstil in erster Linie den Inhalt der -Kopf- und Fußzeilen. Wie\textnote{Achtung!} bereits in -\autoref{sec:\LabelBase.firstpage} erwähnt, werden Kopf und Fuß des Briefbogens +Kopf- und Fußzeilen. Wie\textnote{Achtung!} bereits in +\autoref{sec:\LabelBase.firstpage} erwähnt, werden Kopf und Fuß des Briefbogens als Elemente des Briefbogens betrachtet und unterliegen damit nicht den -Einstellungen für den Seitenstil. Es geht also hier im Wesentlichen um den +Einstellungen für den Seitenstil. Es geht also hier im Wesentlichen um den Seitenstil der weiteren Briefseiten nach dem Briefbogen. Bei einseitigen Briefen ist das der Seitenstil des Zweitbogens. Bei doppelseitigen Briefen ist -auch der Seitenstil aller Rückseiten betroffen. +auch der Seitenstil aller Rückseiten betroffen. \begin{Declaration} \Macro{letterpagestyle} \end{Declaration} -Der\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} für Briefe +Der\ChangedAt{v3.19}{\Class{scrlttr2}\and \Package{scrletter}} für Briefe voreingestellte Seitenstil wird durch den Inhalt dieser Anweisung bestimmt. In der Voreinstellung\textnote{Voreinstellung} von \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} ist die Anweisung leer definiert. Das bedeutet, dass der Seitenstil von Briefen dem des restlichen -Dokuments entspricht. Dies ist deshalb sinnvoll, weil \Class{scrlttr2} für -reine Briefdokumente gedacht ist und es dafür einfacher ist, den Seitenstil +Dokuments entspricht. Dies ist deshalb sinnvoll, weil \Class{scrlttr2} für +reine Briefdokumente gedacht ist und es dafür einfacher ist, den Seitenstil wie gewohnt mit \DescRef{\LabelBase.cmd.pagestyle} global einzustellen. Da sowohl Seitenstil \DescRef{\LabelBase.pagestyle.plain} als auch der Stil -\DescRef{\LabelBase.pagestyle.headings} anderer Klassen vom gewünschten -Seitenstil für Briefe abweicht, ist für das Paket +\DescRef{\LabelBase.pagestyle.headings} anderer Klassen vom gewünschten +Seitenstil für Briefe abweicht, ist für das Paket \Package{scrletter}\OnlyAt{\Package{scrletter}}\textnote{Voreinstellung} der Seitenstil \DescRef{\LabelBase.pagestyle.plain.letter}\IndexPagestyle{plain.letter}% \important{\DescRef{\LabelBase.pagestyle.plain.letter}} in der Anweisung \Macro{letterpagestyle} gespeichert. Damit werden alle Briefe mit dem zum Seitenstil \DescRef{\LabelBase.pagestyle.letter}\IndexPagestyle{letter} -gehörenden +gehörenden \hyperref[desc:\LabelBase.pagestyle.plain.letter]{\PageStyle{plain}}-Seitenstil -gesetzt unabhängig davon, was für das restliche Dokument als Seitenstil +gesetzt unabhängig davon, was für das restliche Dokument als Seitenstil eingestellt ist. \begin{Example} Sie wollen auch bei Verwendung von Paket \Package{scrletter}, dass die - Briefe in dem Seitenstil gesetzt werden, der für das Dokument selbst mit + Briefe in dem Seitenstil gesetzt werden, der für das Dokument selbst mit \DescRef{\LabelBase.cmd.pagestyle} eingestellt wurde. Dazu schreiben sie die Anweisung \begin{lstcode} \renewcommand*{\letterpagestyle}{} \end{lstcode} - in die Dokumentpräambel. Dabei ist übrigens der Stern bei + in die Dokumentpräambel. Dabei ist übrigens der Stern bei \Macro{renewcommand*} wichtig!% \end{Example} -Natürlich haben die Anweisung \DescRef{\LabelBase.cmd.pagestyle} und +Natürlich haben die Anweisung \DescRef{\LabelBase.cmd.pagestyle} und \DescRef{\LabelBase.cmd.thispagestyle} innerhalb eines Briefes Vorrang vor dem -innerhalb von \Macro{begin}\PParameter{letter} über \Macro{letterpagestyle} +innerhalb von \Macro{begin}\PParameter{letter} über \Macro{letterpagestyle} eingestellten Seitenstil.% \EndIndexGroup @@ -2654,40 +2667,40 @@ eingestellten Seitenstil.% \end{Declaration}% Mit diesen Optionen kann bei \Class{scrlttr2}\OnlyAt{scrlttr2} eingestellt werden, ob eine Trennlinie\Index{Trennlinie}\Index{Linie} unter dem -Kopf\Index{Seiten>Kopf} oder über dem Fuß\Index{Seiten>Fuss=Fuß} von -Folgeseiten gewünscht wird. Als \PName{Ein-Aus-Wert} kann einer der -Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +Kopf\Index{Seiten>Kopf} oder über dem Fuß\Index{Seiten>Fuss=Fuß} von +Folgeseiten gewünscht wird. Als \PName{Ein-Aus-Wert} kann einer der +Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet werden. Ein\important{\OptionValue{headsepline}{true}} Aktivieren der Option \Option{headsepline} schaltet die Linie unter dem Kopf ein. Ein\important{\OptionValue{footsepline}{true}} Aktivieren der Option -\Option{footsepline} schaltet die Linie über dem Fuß ein. Die Deaktivierung +\Option{footsepline} schaltet die Linie über dem Fuß ein. Die Deaktivierung der Optionen schaltet die jeweilige Linie aus. Beim Seitenstil \DescRef{\LabelBase.pagestyle.empty}% -\important{\DescRef{\LabelBase.pagestyle.empty}} (siehe später in +\important{\DescRef{\LabelBase.pagestyle.empty}} (siehe später in diesem Abschnitt) haben die Optionen \Option{headsepline} und -\Option{footsepline} selbstverständlich keine Auswirkung. Bei diesem +\Option{footsepline} selbstverständlich keine Auswirkung. Bei diesem Seitenstil soll ja auf Seitenkopf\Index{Seiten>Kopf} und -Seitenfuß\Index{Seiten>Fuss=Fuß} ausdrücklich verzichtet werden. +Seitenfuß\Index{Seiten>Fuss=Fuß} ausdrücklich verzichtet werden. Typografisch\important{\DescRef{\LabelBase.pagestyle.headings}\\ \DescRef{\LabelBase.pagestyle.myheadings}\\ \DescRef{\LabelBase.pagestyle.plain}} betrachtet hat eine solche Linie immer -die Auswirkung, dass der Kopf oder Fuß optisch näher an den Text heranrückt. -Dies bedeutet nun nicht, dass Kopf oder Fuß räumlich weiter vom -Textkörper\Index{Text>Bereich} weggerückt werden müssten. Stattdessen sollten -sie dann bei der Berechnung des Satzspiegels als zum Textkörper gehörend +die Auswirkung, dass der Kopf oder Fuß optisch näher an den Text heranrückt. +Dies bedeutet nun nicht, dass Kopf oder Fuß räumlich weiter vom +Textkörper\Index{Text>Bereich} weggerückt werden müssten. Stattdessen sollten +sie dann bei der Berechnung des Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei \Class{scrlttr2} dadurch erreicht, dass bei Verwendung der Klassenoption \Option{headsepline} automatisch die Paketoption \DescRef{typearea.option.headinclude}% \important{\DescRef{typearea.option.headinclude}} mit gleichem Wert an das \hyperref[cha:typearea]{\Package{typearea}}-Paket weitergereicht -wird. Entsprechendes gilt bei \DescRef{\LabelBase.option.footsepline} für +wird. Entsprechendes gilt bei \DescRef{\LabelBase.option.footsepline} für \DescRef{typearea.option.footinclude}% \important{\DescRef{typearea.option.footinclude}}. -Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels +Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe Option \DescRef{typearea.option.DIV} mit den Werten \PValue{last} oder \PValue{current} (siehe \DescPageRef{typearea.option.DIV.last}) oder die @@ -2697,8 +2710,8 @@ Anweisung \DescRef{typearea.cmd.recalctypearea} (siehe Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe -\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für -Linien im Kopf und Fuß und kann auch mit \Class{scrlttr2} kombiniert +\autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für +Linien im Kopf und Fuß und kann auch mit \Class{scrlttr2} kombiniert werden. Das Paket \Package{scrletter} verwendet hingegen automatisch \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} zur Definition der Seitenstile \DescRef{\LabelBase.pagestyle.letter} und @@ -2708,7 +2721,7 @@ Die von \Package{scrletter}\OnlyAt{\Package{scrletter}} definierten Seitenstile \DescRef{\LabelBase.pagestyle.letter} und \DescRef{\LabelBase.pagestyle.plain.letter} unterliegen den Regeln von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. Dies betrifft -insbesondere das Setzen der Linien in Kopf und Fuß des +insbesondere das Setzen der Linien in Kopf und Fuß des \PageStyle{plain}-Seitenstils \DescRef{\LabelBase.pagestyle.plain.letter}. Siehe dazu in \autoref{sec:scrlayer-scrpage.pagestyle.content}, @@ -2716,7 +2729,7 @@ insbesondere das Setzen der Linien in Kopf und Fuß des \DescPageRef{scrlayer-scrpage.option.plainheadsepline} die Optionen \DescRef{scrlayer-scrpage.option.headsepline} und \DescRef{scrlayer-scrpage.option.plainheadsepline}. Auch Einstellungen wie -\DescRef{scrlayer-scrpage.option.automark} sind für den Seitenstil +\DescRef{scrlayer-scrpage.option.automark} sind für den Seitenstil \DescRef{\LabelBase.pagestyle.letter} von einiger Bedeutung.% % \EndIndexGroup @@ -2736,7 +2749,7 @@ Seitenstile\important{\DescRef{\LabelBase.pagestyle.headings}\\ \DescRef{\LabelBase.pagestyle.plain} und bei \Package{scrletter}\OnlyAt{\Package{scrletter}} auf \DescRef{\LabelBase.pagestyle.letter} und -\DescRef{\LabelBase.pagestyle.plain.letter} aus. Sie beeinflusst außerdem die +\DescRef{\LabelBase.pagestyle.plain.letter} aus. Sie beeinflusst außerdem die Voreinstellung der Seitenstile des Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}% @@ -2744,29 +2757,29 @@ Voreinstellung der Seitenstile des Pakets wird (siehe \autoref{cha:scrlayer-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:\LabelBase.pagenumber} zu +Position festlegen. Mögliche Werte sind \autoref{tab:\LabelBase.pagenumber} zu entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{botcenter}. \begin{table}[t!]% Umbruchkorrektur - \caption[{Mögliche Werte für Option \Option{pagenumber} bei \Class{scrlttr2} - und \Package{scrletter}}]{Mögliche Werte für Option \Option{pagenumber} + \caption[{Mögliche Werte für Option \Option{pagenumber} bei \Class{scrlttr2} + und \Package{scrletter}}]{Mögliche Werte für Option \Option{pagenumber} zur Positionierung der Paginierung innerhalb der Seitenstile} \label{tab:\LabelBase.pagenumber} \begin{desctabular} \entry{\PValue{bot}, \PValue{foot}}{% - Seitenzahl im Fuß ohne Änderung der horizontalen Position}% + Seitenzahl im Fuß ohne Änderung der horizontalen Position}% \entry{\PValue{botcenter}, \PValue{botcentered}, \PValue{botmittle}, \PValue{footcenter}, \PValue{footcentered}, \PValue{footmiddle}}{% - Seitenzahl zentriert innerhalb des Fußes}% + Seitenzahl zentriert innerhalb des Fußes}% \entry{\PValue{botleft}, \PValue{footleft}}{% - Seitenzahl links im Fuß}% - \entry{\PValue{botright}, \PValue{footright}}{ Seitenzahl rechts im Fuß}% + Seitenzahl links im Fuß}% + \entry{\PValue{botright}, \PValue{footright}}{ Seitenzahl rechts im Fuß}% \entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{% - Seitenzahl zentriert ohne Änderung der vertikalen Position}% + Seitenzahl zentriert ohne Änderung der vertikalen Position}% \entry{\PValue{false}, \PValue{no}, \PValue{off}}{% keine Seitenzahl}% \entry{\PValue{head}, \PValue{top}}{% - Seitenzahl im Kopf ohne Änderung der horizontalen Position}% + Seitenzahl im Kopf ohne Änderung der horizontalen Position}% \entry{\PValue{headcenter}, \PValue{headcentered}, \PValue{headmiddle}, \PValue{topcenter}, \PValue{topcentered}, \PValue{topmiddle}}{% Seitenzahl zentriert innerhalb des Kopfes}% @@ -2775,9 +2788,9 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{botcenter}. \entry{\PValue{headright}, \PValue{topright}}{% Seitenzahl rechts im Kopf}% \entry{\PValue{left}}{% - Seitenzahl links ohne Änderung der vertikalen Position}% + Seitenzahl links ohne Änderung der vertikalen Position}% \entry{\PValue{right}}{% - Seitenzahl rechts ohne Änderung der vertikalen Position}% + Seitenzahl rechts ohne Änderung der vertikalen Position}% \end{desctabular} \end{table} % @@ -2798,15 +2811,15 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \begin{description}\setkomafont{descriptionlabel}{} \item[{\PageStyle{empty}}] \LabelPageStyle{empty}% - ist der Seitenstil, bei dem Kopf- und Fußzeile von - Folgeseiten vollständig leer bleiben. Dieser Seitenstil wird auch - automatisch für die erste Briefseite verwendet, da auf dieser Seite Kopf und - Fuß über \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} (siehe + ist der Seitenstil, bei dem Kopf- und Fußzeile von + Folgeseiten vollständig leer bleiben. Dieser Seitenstil wird auch + automatisch für die erste Briefseite verwendet, da auf dieser Seite Kopf und + Fuß über \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} (siehe \autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.cmd.opening}) mit anderen Mitteln gesetzt werden. \item[{\PageStyle{headings}}] \LabelPageStyle{headings}% - ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für + ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für automatische Kolumnentitel auf Folgeseiten. Dabei werden als automatisch gesetzte Marken der Absendername aus der Variablen \DescRef{\LabelBase.variable.fromname}\IndexVariable{fromname} und der @@ -2815,12 +2828,12 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert (siehe \autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.fromname} und \DescPageRef{\LabelBase.variable.subject}). Wo genau diese Marken und die - Seitenangabe ausgegeben werden, hängt von der oben erklärten Option + Seitenangabe ausgegeben werden, hängt von der oben erklärten Option \DescRef{\LabelBase.option.pagenumber} und dem Inhalt der Variablen \DescRef{\LabelBase.variable.nexthead}\IndexVariable{nexthead} und \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} ab. Der Autor kann die Marken aber auch noch nach \DescRef{\LabelBase.cmd.opening} manuell - beeinflussen. Hierzu stehen wie üblich die Anweisungen + beeinflussen. Hierzu stehen wie üblich die Anweisungen \DescRef{\LabelBase.cmd.markboth} und \DescRef{\LabelBase.cmd.markright}, bei Verwendung von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% @@ -2828,13 +2841,13 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} auch \DescRef{scrlayer-scrpage.cmd.markleft} (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, - \DescPageRef{scrlayer-scrpage.cmd.markleft}), zur Verfügung. + \DescPageRef{scrlayer-scrpage.cmd.markleft}), zur Verfügung. Da \Package{scrletter}\OnlyAt{scrletter} intern \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} verwendet, wird ein eventuell von der Klasse bereitgestellter Seitenstil \DescRef{maincls.pagestyle.headings} als Alias von - \DescRef{scrlayer-scrpage.pagestyle.scrheadings} umdefiniert. Näheres zu + \DescRef{scrlayer-scrpage.pagestyle.scrheadings} umdefiniert. Näheres zu diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren. \item[{\PageStyle{letter}}] @@ -2847,11 +2860,11 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \autoref{cha:scrlayer-scrpage}, \autopageref{cha:scrlayer-scrpage}. Bei der Einstellung \OptionValueRef{scrlayer-scrpage}{automark}{true}% \important{\OptionValueRef{scrlayer-scrpage}{automark}{true}}% - \IndexOption{automark} übernimmt \PageStyle{letter} dann die Rolle, die bei - \Class{scrlttr2} von \PageStyle{headings} ausgefüllt wird. Bei + \IndexOption{automark} übernimmt \PageStyle{letter} dann die Rolle, die bei + \Class{scrlttr2} von \PageStyle{headings} ausgefüllt wird. Bei \OptionValueRef{scrlayer-scrpage}{automark}{false}% \important{\OptionValueRef{scrlayer-scrpage}{automark}{false}}% - \IndexOption{automark} übernimmt \PageStyle{letter} dagegen die Rolle von + \IndexOption{automark} übernimmt \PageStyle{letter} dagegen die Rolle von \PageStyle{myheadings}. Durch\textnote{Achtung!} die Verwendung von @@ -2862,15 +2875,15 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \Package{scrletter} verwendet werden. \item[{\PageStyle{myheadings}}] \LabelPageStyle{myheadings}% - ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für + ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} 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 + müssen die Marken vom Anwender gesetzt werden. Er verwendet dazu die Anweisungen \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} und \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}. Bei Verwendung von - \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} steht außerdem - \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} zur Verfügung. + \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} steht außerdem + \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} zur Verfügung. - Beim Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} übernimmt der + Beim Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} übernimmt der Seitenstil \PageStyle{letter} ebenfalls die Rolle von \PageStyle{myheadings}. \item[{\PageStyle{plain}}] @@ -2878,13 +2891,13 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der voreingestellte Seitenstil, bei dem auf Folgeseiten keinerlei Kolumnentitel verwendet, sondern nur eine Seitenangabe ausgegeben wird. Wo - diese gesetzt wird, hängt von der oben erklärten Option + diese gesetzt wird, hängt von der oben erklärten Option \DescRef{\LabelBase.option.pagenumber} ab. Da \Package{scrletter}\OnlyAt{scrletter} intern \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} verwendet, wird der Seitenstil \DescRef{maincls.pagestyle.plain} als Alias von - \DescRef{scrlayer-scrpage.pagestyle.plain.scrheadings} umdefiniert. Näheres + \DescRef{scrlayer-scrpage.pagestyle.plain.scrheadings} umdefiniert. Näheres zu diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren. \item[{\PageStyle{plain.letter}}] @@ -2901,30 +2914,30 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \Package{scrletter} verwendet werden. \end{description} -Die Form der Seitenstile wird außerdem durch die oben erklärten +Die Form der Seitenstile wird außerdem durch die oben erklärten Optionen\important{\DescRef{\LabelBase.option.headsepline}\\ \DescRef{\LabelBase.option.footsepline}} \DescRef{\LabelBase.option.headsepline}\IndexOption{headsepline} und \DescRef{\LabelBase.option.footsepline}\IndexOption{footsepline} beeinflusst. Der Seitenstil ab der aktuellen Seite wird mit \Macro{pagestyle} -umgeschaltet. Demgegenüber verändert \Macro{thispagestyle} nur den Seitenstil +umgeschaltet. Demgegenüber verändert \Macro{thispagestyle} nur den Seitenstil der aktuellen Seite. \KOMAScript\textnote{Achtung!} verwendet \Macro{thispagestyle}\PParameter{empty} selbst innerhalb von -\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} für die erste Briefseite. +\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} für die erste Briefseite. \BeginIndexGroup \BeginIndex[indexother]{}{Schrift>Art}% \BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}% \BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}% \BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}% -Um die Schriftart von Kopf und Fuß der Seite oder der Seitenangabe zu ändern, +Um die Schriftart von Kopf und Fuß der Seite oder der Seitenangabe zu ändern, verwenden Sie die Benutzerschnittstelle, die in -\autoref{sec:\LabelBase.textmarkup} beschrieben ist. Für den Kopf und den Fuß -ist dabei das gleiche Element zuständig, das Sie wahlweise mit +\autoref{sec:\LabelBase.textmarkup} beschrieben ist. Für den Kopf und den Fuß +ist dabei das gleiche Element zuständig, das Sie wahlweise mit \FontElement{pageheadfoot}\important{\FontElement{pagehead}} oder -\FontElement{pagehead} benennen können. Für den -Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist zusätzlich auch noch das Element -\FontElement{pagefoot}\important{\FontElement{pagefoot}} zuständig, das nach +\FontElement{pagehead} benennen können. Für den +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 \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} oder per Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% @@ -2932,8 +2945,8 @@ Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist zusätzlich auch noch das Element \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} (siehe \autoref{cha:scrlayer-scrpage}, \DescPageRef{scrlayer-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 +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}, @@ -2948,36 +2961,36 @@ auch das Beispiel aus \autoref{sec:maincls.pagestyle}, \Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke} \Macro{markright}\Parameter{rechte Marke} \end{Declaration} -In den meisten Fällen werden die Möglichkeiten, die \KOMAScript{} über -Optionen und Variablen für die Gestaltung des Seitenkopfes\Index{Kopf} und --fußes\Index{Fuss=Fuß} auf Folgeseiten\Index{Folgeseite} zur Verfügung stellt, -vollkommen ausreichen. Dies gilt umso mehr, als man zusätzlich mit -\Macro{markboth} und \Macro{markright} die Möglichkeit hat, die Angaben zu -ändern, die \Class{scrlttr2} oder \Package{scrletter} in den Kopf setzt. Die +In den meisten Fällen werden die Möglichkeiten, die \KOMAScript{} über +Optionen und Variablen für die Gestaltung des Seitenkopfes\Index{Kopf} und +-fußes\Index{Fuss=Fuß} auf Folgeseiten\Index{Folgeseite} zur Verfügung stellt, +vollkommen ausreichen. Dies gilt umso mehr, als man zusätzlich mit +\Macro{markboth} und \Macro{markright} die Möglichkeit hat, die Angaben zu +ändern, die \Class{scrlttr2} oder \Package{scrletter} in den Kopf setzt. Die Anweisungen \Macro{markboth}\IndexCmd{markboth} und -\Macro{markright}\IndexCmd{markright} können insbesondere mit dem Seitenstil +\Macro{markright}\IndexCmd{markright} können insbesondere mit dem Seitenstil \PageStyle{myheadings}% \IndexPagestyle{myheadings}\important{\PageStyle{myheadings}} verwendet werden. Bei Verwendung des Pakets \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} gilt -dies natürlich auch für den Seitenstil \PageStyle{scrheadings}% +dies natürlich auch für den Seitenstil \PageStyle{scrheadings}% \IndexPagestyle{scrheadings}\important{\PageStyle{scrheadings}}. Dort steht -außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}% +außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}% \IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} zur -Verfügung (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, +Verfügung (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.cmd.markleft}). \begin{Declaration} \Variable{nexthead} \Variable{nextfoot} \end{Declaration} -In einigen wenigen Fällen will man jedoch den Kopf oder Fuß der Folgeseiten -ähnlich dem Briefbogen freier gestalten. In\textnote{Achtung!} diesen Fällen -muss auf die vordefinierten Möglichkeiten, die per oben erklärter Option -\DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber} auswählbar -sind, verzichtet werden. Stattdessen gestaltet man sich den Kopf und Fuß der +In einigen wenigen Fällen will man jedoch den Kopf oder Fuß der Folgeseiten +ähnlich dem Briefbogen freier gestalten. In\textnote{Achtung!} diesen Fällen +muss auf die vordefinierten Möglichkeiten, die per oben erklärter Option +\DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber} auswählbar +sind, verzichtet werden. Stattdessen gestaltet man sich den Kopf und Fuß der Folgeseiten bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} im Seitenstil \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings}% \important{\DescRef{\LabelBase.pagestyle.headings}, @@ -2986,13 +2999,13 @@ Folgeseiten bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} im Seitenstil \Package{scrletter}\OnlyAt{\Package{scrletter}} im Seitenstil \DescRef{\LabelBase.pagestyle.letter}% \IndexPagestyle{letter}\important{\DescRef{\LabelBase.pagestyle.letter}} -frei. Dazu setzt man den gewünschten Aufbau als \PName{Inhalt} der +frei. Dazu setzt man den gewünschten Aufbau als \PName{Inhalt} der Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{nexthead} beziehungsweise \Variable{nextfoot}. Innerhalb des Inhalts von -\Variable{nexthead} und \Variable{nextfoot} können beispielsweise mit Hilfe +\Variable{nexthead} und \Variable{nextfoot} können beispielsweise mit Hilfe der \Macro{parbox}-Anweisung (siehe \cite{latex:usrguide}) mehrere Boxen neben- und untereinander gesetzt werden. Einem versierten Anwender sollte es -so möglich sein, eigene Seitenköpfe und "~füße zu gestalten. Natürlich kann +so möglich sein, eigene Seitenköpfe und "~füße zu gestalten. Natürlich kann und sollte im Wert mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} auch auf weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von \KOMAScript{} bei beiden Variablen nicht genutzt.% @@ -3004,7 +3017,7 @@ weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von \LoadCommonFile{interleafpage}% \section{Vakatseiten} -\LoadCommonFile{footnotes}% \section{Fußnoten} +\LoadCommonFile{footnotes}% \section{Fußnoten} \LoadCommonFile{lists}% \section{Listen} @@ -3016,14 +3029,14 @@ weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von \BeginIndex{}{Formeln}% \BeginIndex{}{Gleichungen}% -Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische -Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik -bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll +Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische +Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik +bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll und ganz auf den \LaTeX-Kern. Da\textnote{Achtung!} jedoch Mathematik in Form -von nummerierten Gleichungen und Formeln in Briefen eher ungewöhnlich ist, -unterstützt \KOMAScript{} dies nicht aktiv. Daher gibt es auch nicht die +von nummerierten Gleichungen und Formeln in Briefen eher ungewöhnlich ist, +unterstützt \KOMAScript{} dies nicht aktiv. Daher gibt es auch nicht die Optionen \DescRef{maincls.option.leqno} und \DescRef{maincls.option.fleqn}, -die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für +die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} dokumentiert sind.% \iffalse% Umbruchkorrekturtext \par @@ -3031,7 +3044,7 @@ die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für \Environment{displaymath}\IndexEnv{displaymath}, \Environment{equation}\IndexEnv{equation} und \Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle - verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für + verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die Verwendung von \Package{amsmath}\IndexPackage{amsmath} empfohlen (siehe \cite{package:amsmath}).% @@ -3040,44 +3053,44 @@ die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für \EndIndexGroup -\section{Gleitumgebungen für Tabellen und Abbildungen} +\section{Gleitumgebungen für Tabellen und Abbildungen} \seclabel{floats} -Gleitumgebungen für Tabellen und Abbildungen sind in Briefen normalerweise +Gleitumgebungen für Tabellen und Abbildungen sind in Briefen normalerweise fehl am Platz. Daher\textnote{Achtung!} werden sie von \Class{scrlttr2} auch -nicht unterstützt. Wenn solche dennoch benötigt werden, deutet dies häufig auf -einen Missbrauch der Briefklasse hin. In solchen Fällen ist stattdessen zu +nicht unterstützt. Wenn solche dennoch benötigt werden, deutet dies häufig auf +einen Missbrauch der Briefklasse hin. In solchen Fällen ist stattdessen zu raten, eine der \KOMAScript-Klassen aus \autoref{cha:maincls} mit dem Paket \Package{scrletter}\important{\Package{scrletter}} zu kombinieren. In diesem -Fall können Gleitumgebungen, wie für die Klasse dokumentiert, auch in Briefen -verwendet werden. Die Möglichkeiten zur Definition eigener Gleitumgebungen mit +Fall können Gleitumgebungen, wie für die Klasse dokumentiert, auch in Briefen +verwendet werden. Die Möglichkeiten zur Definition eigener Gleitumgebungen mit Hilfe von \hyperref[cha:tocbasic]{\Package{tocbasic}}\IndexPackage{tocbasic}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}, wie sie in -\autoref{cha:tocbasic} dokumentiert sind, können ebenfalls genutzt werden. +\autoref{cha:tocbasic} dokumentiert sind, können ebenfalls genutzt werden. \LoadCommonFile{marginpar}% \section{Randnotizen} -\section{Schlussgruß} +\section{Schlussgruß} \seclabel{closing} \BeginIndexGroup -\BeginIndex{}{Schlussgruss=Schlussgruß} +\BeginIndex{}{Schlussgruss=Schlussgruß} -Dass der Schlussgruß mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing} +Dass der Schlussgruß mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing} gesetzt wird, wurde bereits in \autoref{sec:\LabelBase.document}, -\DescPageRef{\LabelBase.cmd.closing} erklärt. Unter dem Schlussgruß wird häufig -noch eine Signatur, eine Art Erläuterung zur Unterschrift, gesetzt. Die -Unterschrift wiederum findet Platz zwischen dem Schlussgruß und der Signatur. +\DescPageRef{\LabelBase.cmd.closing} erklärt. Unter dem Schlussgruß wird häufig +noch eine Signatur, eine Art Erläuterung zur Unterschrift, gesetzt. Die +Unterschrift wiederum findet Platz zwischen dem Schlussgruß und der Signatur. \begin{Declaration} \Variable{signature} \end{Declaration} -Die Variable \Variable{signature}\Index{Signatur} nimmt eine Art Erläuterung +Die Variable \Variable{signature}\Index{Signatur} nimmt eine Art Erläuterung zur Unterschrift\Index{Unterschrift} auf. Ihr \PName{Inhalt} ist mit \DescRef{\LabelBase.cmd.usekomavar}\PParameter{fromname} vordefiniert. Eine -solche Erläuterung kann auch mehrzeilig sein. Die einzelnen Zeilen sollten +solche Erläuterung kann auch mehrzeilig sein. Die einzelnen Zeilen sollten dann mit doppeltem Backslash voneinander getrennt -werden. Absätze\textnote{Achtung!} innerhalb der Erläuterung sind jedoch nicht +werden. Absätze\textnote{Achtung!} innerhalb der Erläuterung sind jedoch nicht gestattet.% % \EndIndexGroup @@ -3086,21 +3099,21 @@ gestattet.% \begin{Declaration} \Macro{raggedsignature} \end{Declaration} -Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der +Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der Unterschrift\Index{Unterschrift} werden innerhalb einer Box gesetzt. Die -Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und -Erläuterung bestimmt. +Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und +Erläuterung bestimmt. -Wo genau diese Box platziert wird, ist durch die Pseudolängen +Wo genau diese Box platziert wird, ist durch die Pseudolängen \PLength{sigindent}\IndexPLength{sigindent} und \PLength{sigbeforevskip}\IndexPLength{sigbeforevskip} (siehe \autoref{sec:scrlttr2-experts.closing}, \DescPageRef{scrlttr2-experts.plength.sigindent}) bestimmt. Durch den Befehl \Macro{raggedsignature} wird die Ausrichtung innerhalb der Box bestimmt. In den vordefinierten \File{lco}-Dateien ist die Anweisung entweder auf -\Macro{centering} (alle außer \Option{KOMAold}) oder auf \Macro{raggedright} +\Macro{centering} (alle außer \Option{KOMAold}) oder auf \Macro{raggedright} (\Option{KOMAold}) gesetzt. Um innerhalb der Box beispielsweise eine -linksbündige oder rechtsbündige Ausrichtung zu erhalten, kann der Befehl in +linksbündige oder rechtsbündige Ausrichtung zu erhalten, kann der Befehl in gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection} (siehe das entsprechende Beispiel in \autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.raggedsection}). @@ -3108,20 +3121,20 @@ gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection} \begin{Example} Herr Musterfrau will sich nun wirklich wichtig machen und deshalb in der Signatur nochmals darauf hinweisen, dass er selbst auch mal - Vereinsvorsitzender war. Deshalb ändert er die Variable - \DescRef{\LabelBase.variable.signature}. Außerdem will er, dass die Signatur - linksbündig unter dem Schlussgruß steht, und definiert daher auch noch + Vereinsvorsitzender war. Deshalb ändert er die Variable + \DescRef{\LabelBase.variable.signature}. Außerdem will er, dass die Signatur + linksbündig unter dem Schlussgruß steht, und definiert daher auch noch \Macro{raggedsignature} um:% \lstinputcode[xleftmargin=1em]{letter-22}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-22} zu sehen. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, - Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und + Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, + Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, - Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, - Anrede, Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, + Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, + Anrede, Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke}[l] \frame{\includegraphics[width=.4\textwidth]{letter-22}} \end{captionbeside} @@ -3130,7 +3143,7 @@ gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection} \end{Example} \iftrue% Umbruchkorrekturtext - Das vorausgehende Beispiel zeigt die wichtigsten, aber nicht alle möglichen + Das vorausgehende Beispiel zeigt die wichtigsten, aber nicht alle möglichen Elemente eines Briefes. Es kann jedoch sehr gut als allgemeines Muster dienen.% \fi @@ -3146,19 +3159,19 @@ gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection} \BeginIndex{}{Letter-Class-Option}% Normalerweise wird man Einstellungen wie den Absender nicht in jedem Brief neu -wählen, sondern diverse Parameter für bestimmte Gelegenheiten immer wieder -verwenden. Ganz Ähnliches gilt für die verwendeten Briefköpfe und den -Fußbereich der ersten Seite. Es ist deshalb sinnvoll, diese Einstellungen in +wählen, sondern diverse Parameter für bestimmte Gelegenheiten immer wieder +verwenden. Ganz Ähnliches gilt für die verwendeten Briefköpfe und den +Fußbereich der ersten Seite. Es ist deshalb sinnvoll, diese Einstellungen in einer eigenen Datei zu speichern. \KOMAScript{} bietet -hierfür die \File{lco}-Dateien an. Die Endung \File{lco} steht -für \emph{\emph{l}etter \emph{c}lass \emph{o}ption}, also -Briefklassenoption. Dennoch finden diese Dateien für \Package{scrletter} +hierfür die \File{lco}-Dateien an. Die Endung \File{lco} steht +für \emph{\emph{l}etter \emph{c}lass \emph{o}ption}, also +Briefklassenoption. Dennoch finden diese Dateien für \Package{scrletter} ebenso Anwendung. -In \File{lco}-Dateien können alle Anweisungen verwendet werden, die auch an -der Stelle im Dokument verwendet werden könnten, an der %die \File{lco}-Datei +In \File{lco}-Dateien können alle Anweisungen verwendet werden, die auch an +der Stelle im Dokument verwendet werden könnten, an der %die \File{lco}-Datei sie mit \DescRef{\LabelBase.cmd.LoadLetterOption} -geladen werden. Außerdem können interne Anweisungen verwendet werden, die für +geladen werden. Außerdem können interne Anweisungen verwendet werden, die für Paketautoren freigegeben sind. Bei \Class{scrlttr2} und \Package{scrletter} sind dies insbesondere die Anweisungen \DescRef{scrlttr2-experts.cmd.newplength}\IndexCmd{newplength}, @@ -3171,27 +3184,27 @@ sind dies insbesondere die Anweisungen \File{UScommercial9}, \File{UScommercial9DW} und \File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} dienen dazu, \Class{scrlttr2} und \Package{scrletter} an verschiedene Normen\Index{Norm} anzupassen. Sie -können von angehenden Experten sehr gut als Vorlage für eigene Parametersätze +können von angehenden Experten sehr gut als Vorlage für eigene Parametersätze verwendet werden. Die Datei \File{KOMAold.lco} dient hingegen dazu, die -Kompatibilität zu \Class{scrlettr}\IndexClass{scrlettr} zu verbessern. Diese -Klasse wurde schon vor über 15~Jahren aus \KOMAScript{} entfernt. Es wird -daher nicht mehr näher darauf eingegangen. Da hierbei auch auf Anweisungen -zurückgegriffen wird, die nicht für Paketautoren freigegeben sind, sollte man -sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine Liste +Kompatibilität zu \Class{scrlettr}\IndexClass{scrlettr} zu verbessern. Diese +Klasse wurde schon vor über 15~Jahren aus \KOMAScript{} entfernt. Es wird +daher nicht mehr näher darauf eingegangen. Da hierbei auch auf Anweisungen +zurückgegriffen wird, die nicht für Paketautoren freigegeben sind, sollte man +sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine Liste aller vordefinierten \File{lco}-Dateien ist in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles} zu finden. -Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von -\KOMAScript{} unterstützt wird, erstellt haben, so sind Sie ausdrücklich +Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von +\KOMAScript{} unterstützt wird, erstellt haben, so sind Sie ausdrücklich gebeten, diesen Parametersatz an die Supportadresse von \KOMAScript{} zu schicken. Bitte geben Sie dabei auch die Erlaubnis zur Weiterverbreitung unter den Lizenzbedingungen von \KOMAScript{} (siehe dazu die Datei \href{http://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/lppl-de.txt}% -{\File{lppl-de.txt}} im \KOMAScript-Paket). Wenn Sie zwar über die notwendigen -Maße aus einer bisher nicht unterstützen Briefnorm verfügen, sich jedoch nicht +{\File{lppl-de.txt}} im \KOMAScript-Paket). Wenn Sie zwar über die notwendigen +Maße aus einer bisher nicht unterstützen Briefnorm verfügen, sich jedoch nicht in der Lage sehen, selbst eine passende \File{lco}-Datei zu erstellen, so -können Sie sich ebenfalls mit dem \KOMAScript-Autor in Verbindung -setzen. Beispiele für teilweise sehr komplexe \File{lco}-Dateien finden sich +können Sie sich ebenfalls mit dem \KOMAScript-Autor in Verbindung +setzen. Beispiele für teilweise sehr komplexe \File{lco}-Dateien finden sich unter anderem unter \cite{homepage} und in \cite{DANTE:TK0203:MJK}. @@ -3199,24 +3212,24 @@ unter anderem unter \cite{homepage} und in \cite{DANTE:TK0203:MJK}. \Macro{LoadLetterOption}\Parameter{Name} \Macro{LoadLetterOptions}\Parameter{Liste von Namen} \end{Declaration} -Bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} können \File{lco}-Dateien direkt -über \DescRef{\LabelBase.cmd.documentclass} geladen werden. Dazu gibt man den +Bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} können \File{lco}-Dateien direkt +über \DescRef{\LabelBase.cmd.documentclass} geladen werden. Dazu gibt man den Namen der \File{lco}-Datei ohne die Endung als Option\Index{Optionen} an. Das Laden der \File{lco}-Datei erfolgt dann direkt nach der Klasse. Das Paket -\Package{scrletter}\textnote{Achtung!} bietet diese Möglichkeit nicht! Hier -bleibt nur \File{lco}-Dateien über \Macro{LoadLetterOption} +\Package{scrletter}\textnote{Achtung!} bietet diese Möglichkeit nicht! Hier +bleibt nur \File{lco}-Dateien über \Macro{LoadLetterOption} oder \Macro{LoadLetterOptions}\ChangedAt{v3.14}{\Class{scrlttr2}} zu -laden. Für\textnote{Empfehlung!} \Class{scrlttr2} wird dies ebenfalls -ausdrücklich empfohlen! +laden. Für\textnote{Empfehlung!} \Class{scrlttr2} wird dies ebenfalls +ausdrücklich empfohlen! -\Macro{LoadLetterOption} und \Macro{LoadLetterOptions} können auch zu einem -späteren Zeitpunkt, selbst nach \Macro{begin}\PParameter{document} und sogar +\Macro{LoadLetterOption} und \Macro{LoadLetterOptions} können auch zu einem +späteren Zeitpunkt, selbst nach \Macro{begin}\PParameter{document} und sogar innerhalb einer anderen \File{lco}-Datei verwendet werden. Der \PName{Name} -der \File{lco}-Datei wird in diesen Fällen ebenfalls ohne Endung -übergeben. Während als Argument von \Macro{LoadLetterOption} der \PName{Name} +der \File{lco}-Datei wird in diesen Fällen ebenfalls ohne Endung +übergeben. Während als Argument von \Macro{LoadLetterOption} der \PName{Name} von genau einer \File{lco}-Datei erwartet wird, versteht \Macro{LoadLetterOptions} eine durch Komma separierte \PName{Liste von - Namen}. Die zu den Namen gehörenden \File{lco}-Dateien werden dann in der + Namen}. Die zu den Namen gehörenden \File{lco}-Dateien werden dann in der Reihenfolge der Angabe in der Liste geladen. \begin{Example} Peter Musterfrau erstellt auch ein Dokument, in dem mehrere Briefe enthalten @@ -3227,9 +3240,9 @@ Reihenfolge der Angabe in der Liste geladen. \end{lstcode} Allerdings soll bei einem Brief stattdessen die Variante \File{DINmtext} verwendet werden. Bei dieser steht das Adressfeld - weiter oben, damit mehr Text auf die erste Seite passt. Dafür ist + weiter oben, damit mehr Text auf die erste Seite passt. Dafür ist die Faltung so angepasst, dass das Adressfeld bei - DIN~C6/5-Umschlägen trotzdem in das Adressfenster passt. Sie + DIN~C6/5-Umschlägen trotzdem in das Adressfenster passt. Sie erreichen das so: \begin{lstcode} \begin{letter}{% @@ -3240,36 +3253,36 @@ Reihenfolge der Angabe in der Liste geladen. \opening{Hallo,} \end{lstcode} Da der Aufbau der ersten Seite erst mit - \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} wirklich beginnt, genügt + \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} wirklich beginnt, genügt es, wenn die \File{lco}-Datei vor \DescRef{\LabelBase.cmd.opening} geladen wird. Dies muss also nicht vor \Macro{begin}\PParameter{letter} - erfolgen. Die Änderungen durch das Laden der \File{lco}-Datei sind dann auch + erfolgen. Die Änderungen durch das Laden der \File{lco}-Datei sind dann auch lokal zu dem entsprechenden Brief. \end{Example} -Wird\ChangedAt{v2.97}{\Class{scrlttr2}} eine \File{lco}-Datei über +Wird\ChangedAt{v2.97}{\Class{scrlttr2}} eine \File{lco}-Datei über \Macro{documentclass} geladen, so darf sie nicht den Namen einer Option haben. \begin{Example} - Da Herr Musterfrau regelmäßig Briefe mit immer gleichen Einstellungen - schreibt, findet er es ziemlich lästig, diese Angaben immer wieder in jeden - neuen Brief kopieren zu müssen. Zu seiner Erleichterung schreibt er deshalb + Da Herr Musterfrau regelmäßig Briefe mit immer gleichen Einstellungen + schreibt, findet er es ziemlich lästig, diese Angaben immer wieder in jeden + neuen Brief kopieren zu müssen. Zu seiner Erleichterung schreibt er deshalb eine \File{lco}-Datei, die ihm die Arbeit erleichtert:% \lstinputcode[xleftmargin=1em]{ich.lco}% Damit schrumpft sein Brief aus dem letzten Beispiel erheblich zusammen: \lstinputcode[xleftmargin=1em]{letter-23.tex}% - Das Ergebnis ändert sich jedoch nicht, wie \autoref{fig:\LabelBase.letter-23} + Das Ergebnis ändert sich jedoch nicht, wie \autoref{fig:\LabelBase.letter-23} zeigt. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, - Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, + Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, + Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke mit \File{lco}-Datei}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, Logo, Anschrift, - Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, Grußfloskel, - geänderter Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke + Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, Grußfloskel, + geänderter Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke bei Verwendung einer \File{lco}-Datei}[l] \frame{\includegraphics[width=.4\textwidth]{letter-23}} \end{captionbeside} @@ -3278,39 +3291,39 @@ haben. \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. +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 zur Sprachumschaltung, beispielsweise für die neue, deutsche +Rechtschreibung mit \Macro{usepackage}\POParameter{ngerman}\PParameter{babel}, +noch bei älteren \LaTeX-Versionen ein Paket für die Eingabecodierung, +beispielsweise mit \Macro{usepackage}\POParameter{utf8}\PParameter{inputenc} +für moderne Editoren, 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 -mit der Option \Option{SN}\IndexOption{SN} möglicherweise Probleme +einen sehr großen unbedruckbaren Rand links oder rechts besitzt, werden Sie +mit der Option \Option{SN}\IndexOption{SN} möglicherweise Probleme bekommen. Da die Schweizer Norm SN~101\,130 vorsieht, dass das Adressfeld 8\Unit{mm} vom rechten Papierrand gesetzt wird, werden bei Schweizer Briefen -auch die Kopfzeile und die Absenderergänzung mit einem entsprechend geringen -Abstand zum Papierrand gesetzt. Dies betrifft ebenfalls die Geschäftszeile bei +auch die Kopfzeile und die Absenderergänzung mit einem entsprechend geringen +Abstand zum Papierrand gesetzt. Dies betrifft ebenfalls die Geschäftszeile bei der Einstellung \OptionValueRef{\LabelBase}{refline}{wide}% \IndexOption{refline~=\textKValue{wide}} (siehe \autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.option.refline}). Sollten\textnote{Tipp!} Sie damit ein Problem haben, erstellen Sie sich eine eigene \File{lco}-Datei, die -zunächst \Option{SN} lädt und in der +zunächst \Option{SN} lädt und in der \DescRef{scrlttr2-experts.plength.toaddrhpos}\IndexPLength{toaddrhpos} (siehe \autoref{sec:scrlttr2-experts.addressee}, \DescPageRef{scrlttr2-experts.plength.toaddrvpos}) dann auf einen kleineren -Wert gesetzt wird. Verringern Sie dann außerdem +Wert gesetzt wird. Verringern Sie dann außerdem \DescRef{scrlttr2-experts.plength.toaddrwidth}\IndexPLength{toaddrwidth} entsprechend.% Die\textnote{Tipp!}\phantomsection\label{tipp:\LabelBase.DIN} \File{lco}-Datei -\File{DIN}\important{\Option{DIN}} wird übrigens immer als erste -\File{lco}-Datei automatisch geladen, damit alle Pseudolängen mehr oder +\File{DIN}\important{\Option{DIN}} wird übrigens immer als erste +\File{lco}-Datei automatisch geladen, damit alle Pseudolängen mehr oder weniger sinnvoll vordefiniert sind. Es ist daher nicht notwendig diese voreingestellte Datei selbst zu laden. @@ -3324,19 +3337,19 @@ voreingestellte Datei selbst zu laden. \oentry{DIN}{% \leavevmode% \IndexOption[indexmain]{DIN}\IndexFile[indexmain]{DIN.lco}% - Parametersatz für Briefe im Format A4 nach DIN~676; geeignet für - Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% + Parametersatz für Briefe im Format A4 nach DIN~676; geeignet für + Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% \oentry{DINmtext}{% \leavevmode% \IndexOption[indexmain]{DINmtext}\IndexFile[indexmain]{DINmtext.lco}% - Parametersatz für Briefe im Format A4 nach DIN~676, wobei die Alternative - für mehr Text auf der ersten Briefseite verwendet wird; nur geeignet für - Fensterbriefumschläge in den Formaten C6 und C6/5 (C6 lang)}% + Parametersatz für Briefe im Format A4 nach DIN~676, wobei die Alternative + für mehr Text auf der ersten Briefseite verwendet wird; nur geeignet für + Fensterbriefumschläge in den Formaten C6 und C6/5 (C6 lang)}% \oentry{KakuLL}{% \leavevmode% \IndexOption[indexmain]{KakuLL}\IndexFile[indexmain]{KakuLL.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge des Typs Kaku A4, bei denen das Fenster in etwa + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge des Typs Kaku A4, bei denen das Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom linken und 24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% @@ -3344,33 +3357,33 @@ voreingestellte Datei selbst zu laden. \leavevmode% \IndexOption[indexmain]{KOMAold}\IndexFile[indexmain]{KOMAold.lco}% \iffalse - existiert nur noch aus Kompatibilitätsgründen; die Verwendung wird nicht + existiert nur noch aus Kompatibilitätsgründen; die Verwendung wird nicht mehr empfohlen% \else - Parametersatz für Briefe im Format A4 mit Annäherung an das Aussehen von - Briefen der obsoleten Briefklasse \Class{scrlettr}; geeignet für - Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang); es - werden einige zusätzliche Anweisungen zur Verbesserung der Kompatibilität + Parametersatz für Briefe im Format A4 mit Annäherung an das Aussehen von + Briefen der obsoleten Briefklasse \Class{scrlettr}; geeignet für + Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang); es + werden einige zusätzliche Anweisungen zur Verbesserung der Kompatibilität mit der obsoleten Briefklasse \Class{scrlettr}\IndexClass{scrlettr} - definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei - möglicherweise nicht genau wie bei Verwendung der übrigen + definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei + möglicherweise nicht genau wie bei Verwendung der übrigen \File{lco}-Dateien% \fi }% \oentry{NF}{% \leavevmode% \IndexOption[indexmain]{NF}\IndexFile[indexmain]{NF.lco}% - Parametersatz für französische Briefe nach NF~Z~11-001; geeignet für - Fensterbriefumschläge im Format DL (110\Unit{mm} auf 220\Unit{mm}) mit - einem Fenster von 45\Unit{mm} Breite und 100\Unit{mm} Höhe ca. jeweils + Parametersatz für französische Briefe nach NF~Z~11-001; geeignet für + Fensterbriefumschläge im Format DL (110\Unit{mm} auf 220\Unit{mm}) mit + einem Fenster von 45\Unit{mm} Breite und 100\Unit{mm} Höhe ca. jeweils 20\Unit{mm} entfernt vom rechten unteren Rand; diese Datei wurde - ursprünglich von Jean-Marie Pacquet entwickelt, der auf \cite{www:NF.lco} + ursprünglich von Jean-Marie Pacquet entwickelt, der auf \cite{www:NF.lco} neben einer Erweiterung auch eine LyX-Einbindung bereitstellt.}% \oentry{NipponEH}{% \leavevmode% \IndexOption[indexmain]{NipponEH}\IndexFile[indexmain]{NipponEH.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm} vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen @@ -3378,8 +3391,8 @@ voreingestellte Datei selbst zu laden. \oentry{NipponEL}{% \leavevmode% \IndexOption[indexmain]{NipponEL}\IndexFile[indexmain]{NipponEL.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen @@ -3387,8 +3400,8 @@ voreingestellte Datei selbst zu laden. \oentry{NipponLH}{% \leavevmode% \IndexOption[indexmain]{NipponLH}\IndexFile[indexmain]{NipponLH.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm} vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen @@ -3396,8 +3409,8 @@ voreingestellte Datei selbst zu laden. \oentry{NipponLL}{% \leavevmode% \IndexOption[indexmain]{NipponLL}\IndexFile[indexmain]{NipponLL.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen @@ -3405,8 +3418,8 @@ voreingestellte Datei selbst zu laden. \oentry{NipponRL}{% \leavevmode% \IndexOption[indexmain]{NipponRL}\IndexFile[indexmain]{NipponRL.lco}% - Parametersatz für japanische Briefe im Format A4; geeignet für japanische - Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das + Parametersatz für japanische Briefe im Format A4; geeignet für japanische + Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom rechten und 28\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen @@ -3414,46 +3427,46 @@ voreingestellte Datei selbst zu laden. \oentry{SN}{% \leavevmode% \IndexOption[indexmain]{SN}\IndexFile[indexmain]{SN.lco}% - Parametersatz für Schweizer Briefe nach SN~010\,130 mit Anschrift rechts; - geeignet für Schweizer Fensterbriefumschläge in den Formaten C4, C5, C6 + Parametersatz für Schweizer Briefe nach SN~010\,130 mit Anschrift rechts; + geeignet für Schweizer Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% \oentry{SNleft}{% \leavevmode% \IndexOption[indexmain]{SNleft}\IndexFile[indexmain]{SNleft.lco}% - Parametersatz für Schweizer Briefe mit Anschrift links; geeignet für - Schweizer Fensterbriefumschläge mit dem Fenster links in den Formaten C4, + Parametersatz für Schweizer Briefe mit Anschrift links; geeignet für + Schweizer Fensterbriefumschläge mit dem Fenster links in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% \oentry{UScommercial9}{% \leavevmode% \IndexOption[indexmain]{UScommercial9}% \IndexFile[indexmain]{UScommercial9.lco}% - Parametersatz für US-amerikanische Briefe im Format letter; - geeignet für US-amerikanische Fensterbriefumschläge der Größe + Parametersatz für US-amerikanische Briefe im Format letter; + geeignet für US-amerikanische Fensterbriefumschläge der Größe \emph{commercial~No.\,9} mit einem - Anschriftfenster der Breite 4\,1/2\Unit{in} und Höhe 1\,1/8\Unit{in} an + Anschriftfenster der Breite 4\,1/2\Unit{in} und Höhe 1\,1/8\Unit{in} an einer Position 7/8\Unit{in} von links und 1/2\Unit{in} von unten ohne - Rücksendeadresse im Fenster; bei Faltung zunächst an der Mittelmarke und + Rücksendeadresse im Fenster; bei Faltung zunächst an der Mittelmarke und dann an der oberen Faltmarke kann auch Papier im Format legal verwendet - werden, führt dann jedoch zu einer Papiergrößen-Warnung}% + werden, führt dann jedoch zu einer Papiergrößen-Warnung}% \oentry{UScommercial9DW}{% \leavevmode% \IndexOption[indexmain]{UScommercial9DW}% \IndexFile[indexmain]{UScommercial9DW.lco}% - Parametersatz für US-amerikanische Briefe im Format letter; - geeignet für US-amerikanische Fensterbriefumschläge der Größe + Parametersatz für US-amerikanische Briefe im Format letter; + geeignet für US-amerikanische Fensterbriefumschläge der Größe \emph{commercial~No.\,9} mit einem - Anschriftfenster der Breite 3\,5/8\Unit{in} und Höhe 1\,1/8\Unit{in} an + Anschriftfenster der Breite 3\,5/8\Unit{in} und Höhe 1\,1/8\Unit{in} an einer Position 3/4\Unit{in} von links und 1/2\Unit{in} von unten mit - einem Absenderfenster der Breite 3\,1/2\Unit{in} und Höhe 7/8\Unit{in} an + einem Absenderfenster der Breite 3\,1/2\Unit{in} und Höhe 7/8\Unit{in} an einer Position 5/16\Unit{in} von links und 2\,1/2\Unit{in} von unten, - jedoch ohne Rücksendeadresse im Fenster; bei Faltung zunächst an der + jedoch ohne Rücksendeadresse im Fenster; bei Faltung zunächst an der Mittelmarke und dann an der oberen Faltmarke kann auch Papier im Format - legal verwendet werden, führt dann jedoch zu einer Papiergrößen-Warnung}% + legal verwendet werden, führt dann jedoch zu einer Papiergrößen-Warnung}% \end{desclist} -Beachten\textnote{Achtung!} Sie bitte noch, dass es nicht möglich ist, +Beachten\textnote{Achtung!} Sie bitte noch, dass es nicht möglich ist, innerhalb einer \File{lco}-Datei mittels \Macro{PassOptionsToPackage} Optionen -an Pakete zu übergeben, die von der Klasse bereits geladen sind. Normalerweise +an Pakete zu übergeben, die von der Klasse bereits geladen sind. Normalerweise betrifft dies nur die Pakete \hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}, \hyperref[cha:scrlfile]{\Package{scrlfile}}\IndexPackage{scrlfile}, @@ -3470,28 +3483,28 @@ betrifft dies nur die Pakete \BeginIndexGroup \BeginIndex{}{Adressdatei}\BeginIndex{}{Serienbriefe}% -Als besonders lästig wird bei Briefen immer das Eintippen der Adressen und das +Als besonders lästig wird bei Briefen immer das Eintippen der Adressen und das Erstellen von Serienbriefen betrachtet. \KOMAScript{} bietet -hierfür% +hierfür% \iffalse% Umbruchkorrekturtext , wie schon die obsolete Klasse \Class{scrlettr},% \fi% -\ eine minimalistische Unterstützung.% +\ eine minimalistische Unterstützung.% \iffalse% Umbruchkorrekturtext - \ Eine stark verbesserte Serienbrief"|funktion ist bereits seit längerem in + \ Eine stark verbesserte Serienbrief"|funktion ist bereits seit längerem in Planung.% \fi \begin{Declaration} \Macro{adrentry}\Parameter{Name}\Parameter{Vorname}\Parameter{Adresse} \Parameter{Tel.}\Parameter{F1}\Parameter{F2}\Parameter{Kommentar} - \Parameter{Kürzel} + \Parameter{Kürzel} \end{Declaration} -Mit \Class{scrlttr2} und \Package{scrletter} können +Mit \Class{scrlttr2} und \Package{scrletter} können Adressdateien\Index[indexmain]{Adressdatei} ausgewertet werden. Dies ist -beispielsweise für Serienbriefe sehr nützlich. Eine Adressdatei muss +beispielsweise für Serienbriefe sehr nützlich. Eine Adressdatei muss die Endung \File{.adr} haben und besteht aus einer Reihe von -\Macro{adrentry}-Einträgen. Ein solcher Eintrag besteht aus acht +\Macro{adrentry}-Einträgen. Ein solcher Eintrag besteht aus acht Elementen und kann beispielsweise wie folgt aussehen: \begin{lstcode} \adrentry{Maier} @@ -3503,20 +3516,20 @@ Elementen und kann beispielsweise wie folgt aussehen: {kauft alles} {MAIER} \end{lstcode} -Die Elemente fünf und sechs, \PName{F1} und \PName{F2}, können frei -bestimmt werden. Denkbar wären neben Hinweisen auf das Geschlecht oder +Die Elemente fünf und sechs, \PName{F1} und \PName{F2}, können frei +bestimmt werden. Denkbar wären neben Hinweisen auf das Geschlecht oder akademische Grade auch der Geburtstag oder das Eintrittsdatum in einen -Verein. Um das Überschreiben von \TeX- oder \LaTeX-Anweisungen zu -vermeiden, ist es empfehlenswert, für \PName{Kürzel} ausschließlich -Großbuchstaben zu verwenden. +Verein. Um das Ãœberschreiben von \TeX- oder \LaTeX-Anweisungen zu +vermeiden, ist es empfehlenswert, für \PName{Kürzel} ausschließlich +Großbuchstaben zu verwenden. \begin{Example} - Herr Maier gehört zu Ihren engeren Geschäftspartnern. Da Sie eine + Herr Maier gehört zu Ihren engeren Geschäftspartnern. Da Sie eine rege Korrespondenz mit ihm pflegen, ist es Ihnen auf Dauer zu - mühsam, jedesmal alle Empfängerdaten aufs Neue einzugeben. + mühsam, jedesmal alle Empfängerdaten aufs Neue einzugeben. \KOMAScript{} nimmt Ihnen diese Arbeit ab. Angenommen, Sie haben Ihre Kundenkontakte in der Datei \File{partner.adr} gespeichert und - Sie möchten Herrn Maier einen Brief schreiben, dann sparen Sie sich + Sie möchten Herrn Maier einen Brief schreiben, dann sparen Sie sich viel Tipparbeit, wenn Sie Folgendes eingeben: \begin{lstcode} \input{partner.adr} @@ -3532,21 +3545,21 @@ Großbuchstaben zu verwenden. \end{Example} % \EndIndexGroup -\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung +\vskip-\ht\strutbox% Wegen Beispiel am Ende der Erklärung \begin{Declaration} \Macro{addrentry}\Parameter{Name}\Parameter{Vorname}\Parameter{Adresse} \Parameter{Telefon}\Parameter{F1}\Parameter{F2}\Parameter{F3} - \Parameter{F4}\Parameter{Kürzel} + \Parameter{F4}\Parameter{Kürzel} \end{Declaration} Bevor Klagen aufkommen, dass insgesamt nur zwei freie Felder zu wenig seien: -\KOMAScript{} verfügt alternativ über die Anweisung \Macro{addrentry}. Mit dem -zusätzlichen »\texttt{d}« im Namen sind hier auch zwei weitere freie Felder -hinzugekommen, dafür ist jedoch der Kommentar entfallen. Ansonsten kann die +\KOMAScript{} verfügt alternativ über die Anweisung \Macro{addrentry}. Mit dem +zusätzlichen »\texttt{d}« im Namen sind hier auch zwei weitere freie Felder +hinzugekommen, dafür ist jedoch der Kommentar entfallen. Ansonsten kann die Anweisung genau wie \DescRef{\LabelBase.cmd.adrentry} verwendet werden. -In einer \File{adr}-Datei können die beiden Anweisungen +In einer \File{adr}-Datei können die beiden Anweisungen \DescRef{\LabelBase.cmd.adrentry} und \Macro{addrentry} nebeneinander verwendet werden. Ich\textnote{Achtung!} weise jedoch darauf hin, dass Zusatzpakete wie das \Package{adrconv}-Paket\IndexPackage{adrconv} von Axel @@ -3557,14 +3570,14 @@ Erweiterungen vornehmen.% \EndIndexGroup -Neben dem vereinfachten Zugriff auf Kundendaten können die -\File{.adr}-Dateien auch für Serienbriefe\Index[indexmain]{Serienbriefe} +Neben dem vereinfachten Zugriff auf Kundendaten können die +\File{.adr}-Dateien auch für Serienbriefe\Index[indexmain]{Serienbriefe} genutzt werden. So ist es ohne die komplizierte Anbindung an -Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen. +Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen. % \begin{Example} Sie wollen einen Serienbrief an alle Mitglieder Ihres - Anglervereins schicken, um zur nächsten Mitgliederversammlung + Anglervereins schicken, um zur nächsten Mitgliederversammlung einzuladen. \begin{lstcode} \documentclass{scrlttr2} @@ -3575,10 +3588,10 @@ Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen. \renewcommand*{\adrentry}[8]{% \begin{letter}{#2 #1\\#3} \opening{Liebe Vereinsmitglieder,} - unsere nächste Mitgliederversammlung findet am + unsere nächste Mitgliederversammlung findet am Montag, dem 12.~August 2002, statt. - Folgende Punkte müssen besprochen werden... + Folgende Punkte müssen besprochen werden... \closing{Petri Heil,} \end{letter} } @@ -3588,44 +3601,44 @@ Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen. \end{lstcode} Sind in Ihrer \File{adr}-Datei auch \DescRef{\LabelBase.cmd.addrentry}-Anweisungen - enthalten, müssen Sie dafür eine entsprechende Definition vor dem - Einladen der Adressdatei ergänzen: + enthalten, müssen Sie dafür eine entsprechende Definition vor dem + Einladen der Adressdatei ergänzen: \begin{lstcode} \renewcommand*{\addrentry}[9]{% \adrentry{#1}{#2}{#3}{#4}{#5}{#6}{#7}{#9}% } \end{lstcode} - Bei diesem Beispiel wird kein Gebrauch von dem zusätzlichen freien + Bei diesem Beispiel wird kein Gebrauch von dem zusätzlichen freien Feld gemacht und deshalb \DescRef{\LabelBase.cmd.addrentry} mit Hilfe von \DescRef{\LabelBase.cmd.adrentry} definiert. \end{Example} -Natürlich kann der Brief"|inhalt auch von den Adressatenmerkmalen -abhängig gemacht werden. Als Bedingungsfelder können die frei -bestimmbaren Elemente fünf oder sechs eines +Natürlich kann der Brief"|inhalt auch von den Adressatenmerkmalen +abhängig gemacht werden. Als Bedingungsfelder können die frei +bestimmbaren Elemente fünf oder sechs eines \DescRef{\LabelBase.cmd.adrentry}-Eintrages oder die frei bestimmbaren -Elemente fünf bis acht eines \DescRef{\LabelBase.cmd.addrentry}-Eintrags +Elemente fünf bis acht eines \DescRef{\LabelBase.cmd.addrentry}-Eintrags genutzt werden. \begin{Example} - Angenommen, Sie verwenden das Element fünf, um das Geschlecht eines + Angenommen, Sie verwenden das Element fünf, um das Geschlecht eines Vereinsmitgliedes zu hinterlegen (\PValue{m/w}) und das sechste - Element weist auf einen Rückstand der Mitgliedsbeiträge hin. Wollen - Sie nun alle säumigen Mitglieder anschreiben und persönlich anreden, + Element weist auf einen Rückstand der Mitgliedsbeiträge hin. Wollen + Sie nun alle säumigen Mitglieder anschreiben und persönlich anreden, so hilft Ihnen folgendes Beispiel weiter: \begin{lstcode} \renewcommand*{\adrentry}[8]{ \ifdim #6pt>0pt\relax - % #6 ist ein Betrag (Gleitkommazahl) größer 0. - % Es werden also die Säumigen erfasst. + % #6 ist ein Betrag (Gleitkommazahl) größer 0. + % Es werden also die Säumigen erfasst. \begin{letter}{#2 #1\\#3} \if #5m \opening{Lieber #2,} \fi \if #5w \opening{Liebe #2,} \fi Leider mussten wir feststellen, dass du mit - der Zahlung deiner Mitgliedsbeiträge im - Rückstand bist. + der Zahlung deiner Mitgliedsbeiträge im + Rückstand bist. - Wir möchten Dich bitten, den offenen Betrag + Wir möchten Dich bitten, den offenen Betrag von #6~EUR auf das Vereinskonto einzuzahlen. \closing{Petri Heil,} \end{letter} @@ -3633,8 +3646,8 @@ genutzt werden. } \end{lstcode} \end{Example} -Es ist also möglich, den Brieftext auf bestimmte Empfängermerkmale -gezielt abzustimmen und so den Eindruck eines persönlichen +Es ist also möglich, den Brieftext auf bestimmte Empfängermerkmale +gezielt abzustimmen und so den Eindruck eines persönlichen Schreibens zu erwecken. Die Anwendungsbreite ist lediglich durch die maximale Anzahl von zwei freien \DescRef{\LabelBase.cmd.adrentry}-Elementen beziehungsweise vier freien \DescRef{\LabelBase.cmd.addrentry}-Elementen @@ -3646,24 +3659,24 @@ begrenzt. \Macro{addrchar}\Parameter{Anfangsbuchstaben} \end{Declaration} \Index[indexmain]{Adressverzeichnis}\Index[indexmain]{Telefonliste}% -Es ist auch möglich, die Informationen einer \File{.adr}-Datei in -Adressverzeichnisse oder Telefonlisten umzuwandeln. Sie benötigen dazu -zusätzlich das \Package{adrconv}\IndexPackage{adrconv}-Paket von Axel Kielhorn +Es ist auch möglich, die Informationen einer \File{.adr}-Datei in +Adressverzeichnisse oder Telefonlisten umzuwandeln. Sie benötigen dazu +zusätzlich das \Package{adrconv}\IndexPackage{adrconv}-Paket von Axel Kielhorn (siehe \cite{package:adrconv}). In diesem Paket sind interaktive \LaTeX-Dokumente enthalten, mit deren Hilfe sehr einfach entsprechende Listen -erstellt werden können. +erstellt werden können. Damit die Listen alphabetisch sortiert ausgegeben werden, muss bereits die Adressdatei sortiert gewesen sein. Es empfiehlt sich dabei, vor jedem neuen Anfangsbuchstaben eine Anweisung \Macro{adrchar} mit diesem Buchstaben als -Argument einzufügen. \Class{scrlttr2} und \Package{scrletter} selbst +Argument einzufügen. \Class{scrlttr2} und \Package{scrletter} selbst ignorieren diese Anweisung ebenso wie \Macro{addrchar}. % \begin{Example} - Angenommen Sie haben folgende, eher winzige Adressdatei für die ein + Angenommen Sie haben folgende, eher winzige Adressdatei für die ein Adressbuch erstellt werden soll: % In der folgenden lstcode-Umgebung je nach Umbruchbedarf einzelne -% Elemente löschen oder hinzufügen. MICHAEL und GABRIEL sollten jedoch +% Elemente löschen oder hinzufügen. MICHAEL und GABRIEL sollten jedoch % erhalten bleiben. % Umbruchkorrektur: Dies kann noch dazu: % \adrentry{Engel}{Raphael} @@ -3696,11 +3709,11 @@ ignorieren diese Anweisung ebenso wie \Macro{addrchar}. \end{lstcode} Diese verarbeiten Sie nun unter Verwendung des Dokuments \File{adrdir.tex} aus \cite{package:adrconv}. Ein Problem dabei ist, dass \File{adrdir.tex} - bis einschließlich Version~1.3 sowohl das veraltete Paket \Package{scrpage} + bis einschließlich Version~1.3 sowohl das veraltete Paket \Package{scrpage} als auch veraltete Schriftbefehle verwendet, die von \KOMAScript{} schon - seit einiger Zeit nicht mehr unterstützt werden. Sollten Sie entsprechende - Fehlermeldungen erhalten und keine neuere Version installieren können, - finden Sie unter \cite{https://komascript.de/node/2154} eine Lösung für + seit einiger Zeit nicht mehr unterstützt werden. Sollten Sie entsprechende + Fehlermeldungen erhalten und keine neuere Version installieren können, + finden Sie unter \cite{https://komascript.de/node/2154} eine Lösung für dieses Problem. Eine Seite des Ergebnisses sieht dann etwa so aus: @@ -3729,14 +3742,14 @@ ignorieren diese Anweisung ebenso wie \Macro{addrchar}. \end{picture} \end{center} Dabei wird der Buchstabe in der Kopfzeile von \Macro{adrchar} - erzeugt, wenn man die Frage »Namen in der Kopfzeile?« verneint. Siehe dazu + erzeugt, wenn man die Frage »Namen in der Kopfzeile?« verneint. Siehe dazu die Definition in \File{adrdir.tex}.% \end{Example}% \iffalse% Umbruchkorrektur -Näheres zum \Package{adrconv}\IndexPackage{adrconv}-Paket ist der zugehörigen -Anleitung zu entnehmen. Dort finden Sie auch Angaben darüber, ob die aktuelle +Näheres zum \Package{adrconv}\IndexPackage{adrconv}-Paket ist der zugehörigen +Anleitung zu entnehmen. Dort finden Sie auch Angaben darüber, ob die aktuelle Version von \Package{adrconv} bereits mit \DescRef{\LabelBase.cmd.addrentry} -und \Macro{addrchar} umgehen kann. Frühere Versionen kannten nur +und \Macro{addrchar} umgehen kann. Frühere Versionen kannten nur \DescRef{\LabelBase.cmd.adrentry} und \Macro{adrchar}.% \fi % @@ -3751,18 +3764,18 @@ und \Macro{addrchar} umgehen kann. Frühere Versionen kannten nur %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide.tex" %%% End: -% LocalWords: Paketoption Satzspiegels Briefklasse Seitenkopf Seitenfuß +% LocalWords: Paketoption Satzspiegels Briefklasse Seitenkopf Seitenfuß % LocalWords: Versandart Zentrierung Dokumenttitel Serienbriefen Seitenstil -% LocalWords: Dokumentpräambel Grafikpaket Briefbogenfuß Briefbogenfußes +% LocalWords: Dokumentpräambel Grafikpaket Briefbogenfuß Briefbogenfußes % LocalWords: Standardklassen Briefpaket Dokumentteile Briefkontext Torsten % LocalWords: Briefumgebung neckische Briefinhalt Absenderinformationen -% LocalWords: Falzmarken Faltmarken Adressfeld Geschäftszeile Feldinhalts +% LocalWords: Falzmarken Faltmarken Adressfeld Geschäftszeile Feldinhalts % LocalWords: Feldbezeichnung Seitenstilen Paginierung Briefklassenoption % LocalWords: Bedingungsfelder Schriftauswahl Spitzmarke diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrwfile.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrwfile.tex index 4e27aa22eb..4dfd43f8a6 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrwfile.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrwfile.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrwfile.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrwfile.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------------- % -% Kapitel über scrwfile in der KOMA-Script-Anleitung +% Kapitel über scrwfile in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ============================================================================ \KOMAProvidesFile{scrwfile.tex} - [$Date: 2018-02-16 04:42:17 +0100 (Fri, 16 Feb 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrwfile)] \chapter{Dateien mit \Package{scrwfile} sparen und ersetzen} @@ -54,10 +54,10 @@ \BeginIndexGroup \BeginIndex{Package}{scrwfile} -Eines der Probleme, die auch durch die Einführung von \eTeX{} nicht gelöst +Eines der Probleme, die auch durch die Einführung von \eTeX{} nicht gelöst wurden, ist die Tatsache, dass \TeX{} nur 18 Dateien gleichzeitig zum Schreiben -geöffnet haben kann. Diese Zahl erscheint zunächst recht groß. Allerdings ist -zu berücksichtigen, dass bereits \LaTeX{} selbst einige dieser Dateien +geöffnet haben kann. Diese Zahl erscheint zunächst recht groß. Allerdings ist +zu berücksichtigen, dass bereits \LaTeX{} selbst einige dieser Dateien belegt. Inhaltsverzeichnis, Tabellenverzeichnis, Abbildungsverzeichnis, Index, Glossar und jedes weitere Verzeichnis, das von \LaTeX{} aus erzeugt wird, belegt in der Regel eine weitere Datei. Dazu kommen Hilfsdateien von Paketen @@ -69,54 +69,54 @@ Im Endeffekt kann es daher geschehen, dass irgendwann die Meldung \ch@ck ...\else \errmessage {No room for a new #3} \fi \end{lstcode} -erscheint. Seit einiger Zeit ist die einfachste Lösung dieses Problems die +erscheint. Seit einiger Zeit ist die einfachste Lösung dieses Problems die Verwendung von Lua\LaTeX{} anstelle von PDF\LaTeX{} oder \XeLaTeX. Damit -entfällt die Beschränkung und die maximale Anzahl der gleichzeitig zum -Schreiben geöffneten Dateien wird nur noch durch das Betriebssystem -bestimmt. In der Realität braucht man sich darüber dann normalerweise keine +entfällt die Beschränkung und die maximale Anzahl der gleichzeitig zum +Schreiben geöffneten Dateien wird nur noch durch das Betriebssystem +bestimmt. In der Realität braucht man sich darüber dann normalerweise keine Gedanken mehr zu machen. Dass \LaTeX{} bei Verzeichnissen wie dem Inhaltsverzeichnis, dem Tabellenverzeichnis und dem Abbildungsverzeichnis immer sofort eine neue Datei -zum Schreiben öffnet, hat aber auch noch einen weiteren Nachteil. Solche -Verzeichnisse werden durch deren Befehle nicht nur direkt gesetzt, sie können -auch kein weiteres Mal gesetzt werden, da die zugehörige Hilfsdatei nach dem +zum Schreiben öffnet, hat aber auch noch einen weiteren Nachteil. Solche +Verzeichnisse werden durch deren Befehle nicht nur direkt gesetzt, sie können +auch kein weiteres Mal gesetzt werden, da die zugehörige Hilfsdatei nach dem jeweiligen Befehl bis zum Ende des Dokuments leer ist. -Das Paket \Package{scrwfile} bietet hier eine grundsätzliche Änderung im -\LaTeX-Kern, durch die beide Probleme nicht nur für Lua\LaTeX{} sondern auch bei -Verwendung von PDF\LaTeX{} oder \XeLaTeX{} gelöst werden können. +Das Paket \Package{scrwfile} bietet hier eine grundsätzliche Änderung im +\LaTeX-Kern, durch die beide Probleme nicht nur für Lua\LaTeX{} sondern auch bei +Verwendung von PDF\LaTeX{} oder \XeLaTeX{} gelöst werden können. -\section{Grundsätzliche Änderungen am \LaTeX-Kern} +\section{Grundsätzliche Änderungen am \LaTeX-Kern} \seclabel{kernelpatches} -\LaTeX-Klassen verwenden zum Öffnen eines Verzeichnisses beispielsweise mit +\LaTeX-Klassen verwenden zum Öffnen eines Verzeichnisses beispielsweise mit \Macro{tableofcontents} oder \Macro{listoffigure} die \LaTeX-Kern-Anweisung -\Macro{@starttoc}\IndexCmd{@starttoc}. \LaTeX{} selbst lädt bei dieser -Anweisung nicht nur die zugehörige Hilfsdatei, sondern öffnet diese Hilfsdatei -auch neu zum Schreiben. Werden anschließend mit \Macro{addtocontents} oder -\Macro{addcontentsline} Einträge in dieses Verzeichnis vorgenommen, so wird -jedoch nicht direkt in die geöffnete Hilfsdatei geschrieben. Stattdessen +\Macro{@starttoc}\IndexCmd{@starttoc}. \LaTeX{} selbst lädt bei dieser +Anweisung nicht nur die zugehörige Hilfsdatei, sondern öffnet diese Hilfsdatei +auch neu zum Schreiben. Werden anschließend mit \Macro{addtocontents} oder +\Macro{addcontentsline} Einträge in dieses Verzeichnis vorgenommen, so wird +jedoch nicht direkt in die geöffnete Hilfsdatei geschrieben. Stattdessen schreibt \LaTeX{} \Macro{@writefile}-Anweisungen\IndexCmd{@writefile} in die \File{aux}-Datei. Erst beim Einlesen der \File{aux}-Dateien am Ende des -Dokuments wird dann über diese \Macro{@writefile}-Anweisungen in die -tatsächlichen Hilfsdateien geschrieben. Die Hilfsdateien werden von \LaTeX{} -auch nicht explizit geschlossen. Stattdessen verlässt sich \LaTeX{} hier -darauf, dass \TeX{} die Dateien am Ende ohnehin schließt. - -Dieses Vorgehen sorgt dafür, dass die Hilfsdateien zwar erst innerhalb von -\Macro{end}\PParameter{document} tatsächlich beschrieben werden, aber trotzdem -während des gesamten \LaTeX-Laufs gleichzeitig offen sind. \Package{scrwfile} +Dokuments wird dann über diese \Macro{@writefile}-Anweisungen in die +tatsächlichen Hilfsdateien geschrieben. Die Hilfsdateien werden von \LaTeX{} +auch nicht explizit geschlossen. Stattdessen verlässt sich \LaTeX{} hier +darauf, dass \TeX{} die Dateien am Ende ohnehin schließt. + +Dieses Vorgehen sorgt dafür, dass die Hilfsdateien zwar erst innerhalb von +\Macro{end}\PParameter{document} tatsächlich beschrieben werden, aber trotzdem +während des gesamten \LaTeX-Laufs gleichzeitig offen sind. \Package{scrwfile} hat nun genau hier einen Ansatzpunkt: die Umdefinierung von \Macro{@starttoc} und \Macro{@writefile}. -Natürlich\textnote{Achtung!} besitzen Änderungen am \LaTeX-Kern immer das -Potential, dass es zu Unverträglichkeiten mit anderen Paketen kommen -kann. Betroffen können in erster Linie Pakete sein, die ebenfalls -\Macro{@starttoc} oder \Macro{@writefile} umdefinieren. In einigen Fällen kann -es helfen, die Reihenfolge der Pakete zu ändern. Wenn Sie auf -ein solches Problem stoßen, sollten Sie sich an den \KOMAScript-Autor wenden. +Natürlich\textnote{Achtung!} besitzen Änderungen am \LaTeX-Kern immer das +Potential, dass es zu Unverträglichkeiten mit anderen Paketen kommen +kann. Betroffen können in erster Linie Pakete sein, die ebenfalls +\Macro{@starttoc} oder \Macro{@writefile} umdefinieren. In einigen Fällen kann +es helfen, die Reihenfolge der Pakete zu ändern. Wenn Sie auf +ein solches Problem stoßen, sollten Sie sich an den \KOMAScript-Autor wenden. \section{Das Eindateiensystem} @@ -129,45 +129,45 @@ Bereits beim Laden des Pakets mit \end{lstcode} wird \Macro{@starttoc}\IndexCmd{@starttoc} von \Package{scrwfile} so umdefiniert, dass davon selbst keine Datei mehr zum Schreiben angefordert und -geöffnet wird. Unmittelbar vor dem Schließen der \File{aux}-Datei in +geöffnet wird. Unmittelbar vor dem Schließen der \File{aux}-Datei in \Macro{end}\PParameter{document} wird dann \Macro{@writefile} so umdefiniert, dass diese Anweisung statt in die eigentlichen Hilfsdateien in eine neue Hilfsdatei mit der Endung \File{wrt} schreibt. Nach dem Einlesen der -\File{aux}-Dateien wird schließlich die \File{wrt}-Datei abgearbeitet und zwar -ein Mal für jede der Hilfsdateien, in die mit \Macro{@writefile} geschrieben +\File{aux}-Dateien wird schließlich die \File{wrt}-Datei abgearbeitet und zwar +ein Mal für jede der Hilfsdateien, in die mit \Macro{@writefile} geschrieben wird. Dabei muss aber nicht jede dieser Hilfsdateien gleichzeitig -geöffnet sein. Stattdessen ist immer nur eine zum Schreiben geöffnet und wird +geöffnet sein. Stattdessen ist immer nur eine zum Schreiben geöffnet und wird auch wieder explizit geschlossen. Da dabei eine interne Schreibdatei von -\LaTeX{} wiederverwendet wird, benötigt \Package{scrwfile} keine einzige -eigene Schreibdatei für diese Art von Verzeichnissen. +\LaTeX{} wiederverwendet wird, benötigt \Package{scrwfile} keine einzige +eigene Schreibdatei für diese Art von Verzeichnissen. Selbst wenn bisher nur mit einem Inhaltsverzeichnis gearbeitet wird, steht -nach dem Laden des Pakets bereits eine Schreibdatei mehr für -Literaturverzeichnisse, Stichwortverzeichnisse, Glossare und ähnliche +nach dem Laden des Pakets bereits eine Schreibdatei mehr für +Literaturverzeichnisse, Stichwortverzeichnisse, Glossare und ähnliche Verzeichnisse, die nicht mit \Macro{@starttoc} arbeiten, zur -Verfügung. Darüber hinaus können beliebig viele Verzeichnisse, die mit +Verfügung. Darüber hinaus können beliebig viele Verzeichnisse, die mit \Macro{@starttoc}\IndexCmd{@starttoc} arbeiten, angelegt werden.% % -\section{Das Klonen von Dateieinträgen} +\section{Das Klonen von Dateieinträgen} \seclabel{clonefilefeature} -Nachdem \Macro{@writefile}\IndexCmd{@writefile} für das Eindateiensystem aus -dem vorherigen Abschnitt bereits so geändert wurde, dass es nicht direkt in +Nachdem \Macro{@writefile}\IndexCmd{@writefile} für das Eindateiensystem aus +dem vorherigen Abschnitt bereits so geändert wurde, dass es nicht direkt in die entsprechende Hilfsdatei schreibt, lag eine weitere Idee nahe. Beim -Kopieren der \Macro{@writefile}-Anweisungen in die \File{wrt}-Datei können -diese auch für andere Zielendungen übernommen werden. +Kopieren der \Macro{@writefile}-Anweisungen in die \File{wrt}-Datei können +diese auch für andere Zielendungen übernommen werden. \begin{Declaration} - \Macro{TOCclone}\OParameter{Verzeichnisüberschrift} + \Macro{TOCclone}\OParameter{Verzeichnisüberschrift} \Parameter{Quellendung}\Parameter{Zielendung} \Macro{listof\PName{Zielendung}} \end{Declaration}% -Durch dieses Klonen von Dateieinträgen werden so ganze Verzeichnisse +Durch dieses Klonen von Dateieinträgen werden so ganze Verzeichnisse geklont. Dazu muss man nur die Endung der Hilfsdatei des Verzeichnisses -kennen, dessen Einträge kopiert werden sollen. Zusätzlich muss man die Endung -einer Zieldatei angeben. In diese werden die Einträge dann kopiert. Natürlich -kann man in dieses geklonte Verzeichnis auch zusätzliche Einträge +kennen, dessen Einträge kopiert werden sollen. Zusätzlich muss man die Endung +einer Zieldatei angeben. In diese werden die Einträge dann kopiert. Natürlich +kann man in dieses geklonte Verzeichnis auch zusätzliche Einträge schreiben. Die \PName{Zielendung} der Zieldatei wird mit Hilfe von @@ -176,32 +176,32 @@ Die \PName{Zielendung} der Zieldatei wird mit Hilfe von \autoref{cha:tocbasic}) verwaltet. Steht eine solche Datei bereits unter Kontrolle von \hyperref[cha:tocbasic]{\Package{tocbasic}} wird eine Warnung ausgegeben. Anderenfalls wird mit Hilfe von -\hyperref[cha:tocbasic]{\Package{tocbasic}} ein neues Verzeichnis für diese -Endung angelegt. Die Überschrift dieses Verzeichnisses kann man über das -optionale Argument \PName{Verzeichnisüberschrift} bestimmen. +\hyperref[cha:tocbasic]{\Package{tocbasic}} ein neues Verzeichnis für diese +Endung angelegt. Die Ãœberschrift dieses Verzeichnisses kann man über das +optionale Argument \PName{Verzeichnisüberschrift} bestimmen. -Ausgeben kann man dieses neue Verzeichnis dann beispielsweise über die +Ausgeben kann man dieses neue Verzeichnis dann beispielsweise über die Anweisung \Macro{listof\PName{Zielendung}}. Die Verzeichniseigenschaften\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} \PValue{leveldown}, \PValue{numbered}, \PValue{onecolumn} und \PValue{totoc} (siehe Anweisung \DescRef{tocbasic.cmd.setuptoc} in \autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.setuptoc}) werden -automatisch in das Zielverzeichnis übernommen, falls sie für das +automatisch in das Zielverzeichnis übernommen, falls sie für das Quellverzeichnis bereits gesetzt waren. Die Eigenschaft \PValue{nobabel} wird -für geklonte Verzeichnisse immer gesetzt, da die entsprechenden -\Package{babel}-Einträge in das Quellverzeichnis ohnehin bereits kopiert +für geklonte Verzeichnisse immer gesetzt, da die entsprechenden +\Package{babel}-Einträge in das Quellverzeichnis ohnehin bereits kopiert werden. \begin{Example} - Angenommen, Sie wollen zusätzlich zum normalen Inhaltsverzeichnis eine - Gliederungsübersicht, in der nur die Kapitel angezeigt werden. + Angenommen, Sie wollen zusätzlich zum normalen Inhaltsverzeichnis eine + Gliederungsübersicht, in der nur die Kapitel angezeigt werden. \begin{lstcode} \usepackage{scrwfile} - \TOCclone[Gliederungsübersicht]{toc}{stoc} + \TOCclone[Gliederungsübersicht]{toc}{stoc} \end{lstcode} - Hierdurch wird zunächst ein neues Verzeichnis mit der Überschrift - »Gliederungsübersicht« angelegt. Das neue Verzeichnis verwendet die - Dateiendung \File{stoc}. Alle Einträge in die Datei mit der Endung + Hierdurch wird zunächst ein neues Verzeichnis mit der Ãœberschrift + »Gliederungsübersicht« angelegt. Das neue Verzeichnis verwendet die + Dateiendung \File{stoc}. Alle Einträge in die Datei mit der Endung \File{toc} werden auch in dieses Verzeichnis kopiert. Damit dieses neue Verzeichnis nun nur die Kapitelebene ausgibt, verwenden @@ -209,14 +209,14 @@ werden. \begin{lstcode} \addtocontents{stoc}{\protect\value{tocdepth}=0} \end{lstcode} - Während\textnote{Achtung!} normalerweise erst ab - \Macro{begin}\PParameter{document} Einträge in ein Verzeichnis vorgenommen - werden können, funktioniert dies nach Laden von \Package{scrwfile} bereits - in der Dokumentpräambel. Durch die hier gezeigte unkonventionelle Art, den - Zähler \DescRef{maincls.counter.tocdepth} innerhalb der Verzeichnisdatei zu - ändern, bleibt diese Änderung nur für dieses Verzeichnis wirksam. - - Später im Dokument wird das Verzeichnis mit der Endung \File{stoc} dann + Während\textnote{Achtung!} normalerweise erst ab + \Macro{begin}\PParameter{document} Einträge in ein Verzeichnis vorgenommen + werden können, funktioniert dies nach Laden von \Package{scrwfile} bereits + in der Dokumentpräambel. Durch die hier gezeigte unkonventionelle Art, den + Zähler \DescRef{maincls.counter.tocdepth} innerhalb der Verzeichnisdatei zu + ändern, bleibt diese Änderung nur für dieses Verzeichnis wirksam. + + Später im Dokument wird das Verzeichnis mit der Endung \File{stoc} dann durch \begin{lstcode}[moretexcs={listofstoc}] \listofstoc @@ -224,16 +224,16 @@ werden. ausgegeben und zeigt nur die Teile und Kapitel des Dokuments. Etwas schwieriger wird es, wenn das Inhaltsverzeichnis in der - Gliederungsübersicht angezeigt werden soll. Dies wäre zwar mit + Gliederungsübersicht angezeigt werden soll. Dies wäre zwar mit \begin{lstcode} \addtocontents{toc}{% \protect\addxcontentsline {stoc}{chapter}{\protect\contentsname}% } \end{lstcode} - möglich. Da jedoch alle Einträge in \File{toc} auch nach \File{stoc} kopiert - werden, würde so von der Gliederungsübersicht dieser Eintrag ebenfalls - übernommen. Also darf der Eintrag nicht aus der Verzeichnisdatei heraus + möglich. Da jedoch alle Einträge in \File{toc} auch nach \File{stoc} kopiert + werden, würde so von der Gliederungsübersicht dieser Eintrag ebenfalls + übernommen. Also darf der Eintrag nicht aus der Verzeichnisdatei heraus erzeugt werden. Da das Paket \hyperref[cha:tocbasic]{\Package{tocbasic}}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} zum Einsatz kommt, kann aber% @@ -243,16 +243,16 @@ werden. \addxcontentsline{stoc}{chapter} {\protect\contentsname}} \end{lstcode} - verwendet werden. Natürlich\textnote{Achtung!} setzt dies voraus, dass die + verwendet werden. Natürlich\textnote{Achtung!} setzt dies voraus, dass die Datei mit Endung \File{toc} auch unter der Kontrolle von \hyperref[cha:tocbasic]{\Package{tocbasic}} steht. Dies ist bei allen - \KOMAScript-Klassen der Fall. Näheres zur Anweisung + \KOMAScript-Klassen der Fall. Näheres zur Anweisung \DescRef{tocbasic.cmd.BeforeStartingTOC} ist in \autoref{sec:tocbasic.toc} auf \DescPageRef{tocbasic.cmd.BeforeStartingTOC} zu finden.% \end{Example}% % Die in den Beispielen verwendete Anweisung -\DescRef{tocbasic.cmd.addxcontentsline} ist übrigens ebenfalls in +\DescRef{tocbasic.cmd.addxcontentsline} ist übrigens ebenfalls in \autoref{cha:tocbasic}, \DescPageRef{tocbasic.cmd.addxcontentsline} dokumentiert.% \EndIndexGroup @@ -263,31 +263,31 @@ dokumentiert.% Obwohl das Paket bereits von mehreren Anwendern getestet wurde und vielfach im Einsatz ist, ist seine Entwicklung noch nicht abgeschlossen. Deshalb ist es -theoretisch möglich, dass insbesondere an der internen Funktionsweise des -Pakets noch Änderungen vorgenommen werden. Sehr wahrscheinlich sind auch -künftige Erweiterungen. Teilweise befindet sich bereits Code für solche +theoretisch möglich, dass insbesondere an der internen Funktionsweise des +Pakets noch Änderungen vorgenommen werden. Sehr wahrscheinlich sind auch +künftige Erweiterungen. Teilweise befindet sich bereits Code für solche Erweiterungen im Paket. Da jedoch noch keine Benutzeranweisungen existieren, -mit denen diese Möglichkeiten genutzt werden könnten, wurde hier auf eine +mit denen diese Möglichkeiten genutzt werden könnten, wurde hier auf eine Dokumentation derselben verzichtet. -\section{Bekannte Paketunverträglichkeiten} +\section{Bekannte Paketunverträglichkeiten} \seclabel{incompatible} -Wie in \autoref{sec:scrwfile.kernelpatches} bereits erwähnt, muss +Wie in \autoref{sec:scrwfile.kernelpatches} bereits erwähnt, muss \Package{scrwfile} einige wenige Anweisungen des \LaTeX-Kerns -umdefinieren. Dies geschieht nicht allein während des Ladens des Pakets, -sondern vielmehr zu verschiedenen Zeitpunkten während der Abarbeitung eines +umdefinieren. Dies geschieht nicht allein während des Ladens des Pakets, +sondern vielmehr zu verschiedenen Zeitpunkten während der Abarbeitung eines Dokuments, beispielsweise vor dem Einlesen der -\File{aux}-Datei. Dies\textnote{Achtung!} führt dazu, dass \Package{scrwfile} -sich nicht mit anderen Paketen verträgt, die diese Anweisungen ebenfalls zur +\File{aux}-Datei. Dies\textnote{Achtung!} führt dazu, dass \Package{scrwfile} +sich nicht mit anderen Paketen verträgt, die diese Anweisungen ebenfalls zur Laufzeit umdefinieren. -Ein Beispiel für eine solche Unverträglichkeit ist +Ein Beispiel für eine solche Unverträglichkeit ist \Package{titletoc}\important{\Package{titletoc}}\IndexPackage{titletoc}. Das -Paket definiert unter gewissen Umständen \Macro{@writefile} zur Laufzeit +Paket definiert unter gewissen Umständen \Macro{@writefile} zur Laufzeit um. Werden \Package{scrwfile} und \Package{titletoc} zusammen verwendet, ist -die Funktion beider Paket nicht mehr gewährleistet. Dies ist weder ein Fehler +die Funktion beider Paket nicht mehr gewährleistet. Dies ist weder ein Fehler in \Package{titletoc} noch in \Package{scrwfile}.% % \EndIndexGroup @@ -295,13 +295,13 @@ in \Package{titletoc} noch in \Package{scrwfile}.% %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: % LocalWords: Eindateiensystem Schreibdatei Zieldatei Zielendung Quellendung -% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei -% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene -% LocalWords: Paketunverträglichkeiten Verzeichniseigenschaften +% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei +% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene +% LocalWords: Paketunverträglichkeiten Verzeichniseigenschaften diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/tocbasic.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/tocbasic.tex index ebc8861e1f..da1b344524 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/tocbasic.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/tocbasic.tex @@ -1,6 +1,6 @@ % ====================================================================== % tocbasic.tex -% Copyright (c) Markus Kohm, 2002-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2002-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,13 +40,13 @@ % % ---------------------------------------------------------------------- % -% Paket tocbasic für Paket- und Klassenautoren +% Paket tocbasic für Paket- und Klassenautoren % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{tocbasic.tex} - [$Date: 2018-08-31 09:11:20 +0200 (Fri, 31 Aug 2018) $ + [$Date: 2019-10-09 15:19:04 +0200 (Wed, 09 Oct 2019) $ KOMA-Script guide (package tocbasic)] \chapter{Verzeichnisse verwalten mit Hilfe von \Package{tocbasic}} @@ -58,60 +58,60 @@ \BeginIndex{}{Dateierweiterung}% \index{Dateiendung|see{Dateierweiterung}}%| Der Hauptzweck des Pakets \Package{tocbasic} besteht darin, Paket- und -Klassenautoren die Möglichkeit zu geben, eigene Verzeichnisse vergleichbar mit +Klassenautoren die Möglichkeit zu geben, eigene Verzeichnisse vergleichbar mit dem Abbildungs- und Tabellenverzeichnis zu erstellen und dabei Klassen und -anderen Paketen einen Teil der Kontrolle über diese Verzeichnisse zu -erlauben. Dabei sorgt das Paket \Package{tocbasic} auch dafür, dass diese +anderen Paketen einen Teil der Kontrolle über diese Verzeichnisse zu +erlauben. Dabei sorgt das Paket \Package{tocbasic} auch dafür, dass diese Verzeichnisse von \Package{babel}\IndexPackage{babel} (siehe -\cite{package:babel}) bei der Sprachumschaltung mit berücksichtigt -werden. Durch Verwendung von \Package{tocbasic} soll dem Paketautor die Mühe +\cite{package:babel}) bei der Sprachumschaltung mit berücksichtigt +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. +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 wird nach der Erklärung +Gleitumgebungen oder den Gleitumgebungen ähnliche nicht gleitende Umgebungen +für Konsultationsobjekte zu definieren. Näheres dazu wird nach der Erklärung der grundlegenden Anweisungen in den folgenden vier Abschnitten durch ein Beispiel in \autoref{sec:tocbasic.example} verdeutlicht, das in kompakter Form noch einmal in \autoref{sec:tocbasic.declarenewtoc} aufgegriffen wird. -\KOMAScript{} verwendet \Package{tocbasic} sowohl für das Inhaltsverzeichnis -als auch für die bereits erwähnten Verzeichnisse für Abbildungen und Tabellen. +\KOMAScript{} verwendet \Package{tocbasic} sowohl für das Inhaltsverzeichnis +als auch für die bereits erwähnten Verzeichnisse für Abbildungen und Tabellen. \section{Grundlegende Anweisungen} \seclabel{basics} Die grundlegenden Anweisungen dienen in erster Linie dazu, eine Liste aller -bekannten Dateierweiterungen\textnote{Dateierweiterung, Verzeichnis}, die für -Verzeichnisse stehen, zu verwalten. Einträge in Dateien mit solchen +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}, \DescRef{\LabelBase.cmd.addxcontentsline}} oder -\DescRef{\LabelBase.cmd.addxcontentsline} vorgenommen. Darüber hinaus gibt es -Anweisungen, mit denen Aktionen 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 Dateierweiterung gehört. Typischerweise +\DescRef{\LabelBase.cmd.addxcontentsline} vorgenommen. Darüber hinaus gibt es +Anweisungen, mit denen Aktionen 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 Dateierweiterung gehört. Typischerweise hat so eine Dateierweiterung auch einen Besitzer\textnote{Dateibesitzer}. Dieser Besitzer kann eine Klasse oder ein -Paket oder ein Bezeichner sein, den der Autor der Klasse oder des Pakets, das -\Package{tocbasic} verwendet, frei gewählt hat. \KOMAScript{} selbst verwendet -beispielsweise den Besitzer \PValue{float} für die Dateierweiterungen -\File{lof} und \File{lot}, die für das Abbildungs- und das Tabellenverzeichnis -stehen. Für das Inhaltsverzeichnis verwendet \KOMAScript{} als Besitzer den -Dateinamen der Klasse. +Paket oder die Bezeichnung einer Kategorie sein, die der Autor der Klasse oder +des Pakets, das \Package{tocbasic} verwendet, frei gewählt hat. \KOMAScript{} +selbst verwendet beispielsweise die Kategorie \PValue{float} für die +Dateierweiterungen \File{lof} und \File{lot}, die für das Abbildungs- und das +Tabellenverzeichnis stehen. Für das Inhaltsverzeichnis verwendet \KOMAScript{} +als Besitzer den Dateinamen der Klasse. \begin{Declaration} \Macro{ifattoclist}\Parameter{Dateierweiterung} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Mit dieser Anweisung wird überprüft, ob die \PName{Dateierweiterung} bereits +Mit dieser Anweisung wird überprüft, ob die \PName{Dateierweiterung} bereits in der Liste der bekannten Dateierweiterungen vorhanden ist oder nicht. Ist -die \PName{Dateierweiterung} bereits über diese Liste bekannt, so wird der -\PName{Dann-Teil} ausgeführt. Anderenfalls wird der \PName{Sonst-Teil} -ausgeführt. +die \PName{Dateierweiterung} bereits über diese Liste bekannt, so wird der +\PName{Dann-Teil} ausgeführt. Anderenfalls wird der \PName{Sonst-Teil} +ausgeführt. \begin{Example} - Angenommen, Sie wollen wissen, ob die Dateierweiterung »\File{foo}« bereits + Angenommen, Sie wollen wissen, ob die Dateierweiterung »\File{foo}« bereits verwendet wird, um in diesem Fall eine Fehlermeldung auszugeben, weil diese damit nicht mehr verwendet werden kann: \begin{lstcode} @@ -136,34 +136,34 @@ ausgeführt. \begin{Declaration} \Macro{addtotoclist}\OParameter{Besitzer}\Parameter{Dateierweiterung} \end{Declaration} -Diese Anweisung fügt die \PName{Dateierweiterung} der Liste der bekannten +Diese Anweisung fügt die \PName{Dateierweiterung} der Liste der bekannten Dateierweiterungen hinzu. Ist die \PName{Dateierweiterung} bereits bekannt, so wird hingegen ein Fehler gemeldet, um die doppelte Verwendung derselben \PName{Dateierweiterung} zu verhindern. Wenn das optionale Argument \OParameter{Besitzer} angegeben wurde, wird der -angegebene \PName{Besitzer} für diese Dateierweiterung mit gespeichert. Wurde +angegebene \PName{Besitzer} für diese Dateierweiterung mit gespeichert. Wurde das optionale Argument weggelassen, dann versucht \Package{tocbasic} den Dateinamen der aktuell abgearbeiteten Klasse oder des Pakets herauszufinden und als \PName{Besitzer} zu speichern. Dies\textnote{Achtung!} funktioniert -nur, wenn \Macro{addtotoclist} während des Ladens der Klasse oder des Pakets -aufgerufen wird. Es funktioniert nicht, wenn \Macro{addtotoclist} erst später +nur, wenn \Macro{addtotoclist} während des Ladens der Klasse oder des Pakets +aufgerufen wird. Es funktioniert nicht, wenn \Macro{addtotoclist} erst später aufgrund der Verwendung einer Anweisung durch den Benutzer aufgerufen wird. In -diesem Fall wird als \PName{Besitzer} »\PValue{.}« eingetragen. +diesem Fall wird als \PName{Besitzer} »\PValue{.}« eingetragen. Beachten\textnote{Achtung!} Sie, dass ein leeres Argument \PName{Besitzer} nicht das Gleiche ist wie das Weglassen des kompletten optionalen Arguments -einschließlich der eckigen Klammern. Ein leeres Argument würde auch einen +einschließlich der eckigen Klammern. Ein leeres Argument würde auch einen leeren \PName{Besitzer} ergeben. \begin{Example} - Angenommen, Sie wollen die Dateierweiterung »\File{foo}« der Liste der - bekannten Dateierweiterungen hinzufügen, während Ihr Paket mit dem - Dateinamen »\File{bar.sty}« geladen wird: + Angenommen, Sie wollen die Dateierweiterung »\File{foo}« der Liste der + bekannten Dateierweiterungen hinzufügen, während Ihr Paket mit dem + Dateinamen »\File{bar.sty}« geladen wird: \begin{lstcode} \addtotoclist{foo} \end{lstcode} - Dies fügt die Dateierweiterung »\PValue{foo}« mit dem Besitzer - »\PValue{bar.sty}« der Liste der bekannten Dateierweiterung hinzu, wenn diese + Dies fügt die Dateierweiterung »\PValue{foo}« mit dem Besitzer + »\PValue{bar.sty}« der Liste der bekannten Dateierweiterung hinzu, wenn diese Erweiterung nicht bereits in der Liste ist. Wenn die verwendete Klasse oder ein anderes Paket diese Dateierweiterung schon angemeldet hat, erhalten Sie den Fehler: @@ -173,8 +173,8 @@ leeren \PName{Besitzer} ergeben. See the tocbasic package documentation for explanation. Type H <return> for immediate help. \end{lstoutput} - Wenn Sie dann tatsächlich die Taste »\texttt{H}«, gefolgt von der - Return-Taste drücken, erhalten Sie als Hilfe: + Wenn Sie dann tatsächlich die Taste »\texttt{H}«, gefolgt von der + Return-Taste drücken, erhalten Sie als Hilfe: \begin{lstoutput} File extension `foo' is already used by a toc-file, while bar.sty tried to use it again for a toc-file. @@ -190,75 +190,75 @@ leeren \PName{Besitzer} ergeben. \newcommand*{\createnewlistofsomething}[1]{% \addtotoclist[bar.sty]{#1}% % Weitere Aktionen, um dieses Verzeichnis - % verfügbar zu machen + % verfügbar zu machen } \end{lstcode} Wenn jetzt der Anwender diese Anweisung aufruft, beispielsweise mit \begin{lstcode} \createnewlistofsomething{foo} \end{lstcode} - dann wird die Dateierweiterung »\PValue{foo}« ebenfalls mit dem Besitzer - »\PValue{bar.sty}« zur Liste der bekannten Dateierweiterungen hinzugefügt + dann wird die Dateierweiterung »\PValue{foo}« ebenfalls mit dem Besitzer + »\PValue{bar.sty}« zur Liste der bekannten Dateierweiterungen hinzugefügt oder aber ein Fehler gemeldet, wenn diese Dateierweiterung bereits verwendet wird. \end{Example} -Sie können als \PName{Besitzer} angeben, was immer Sie wollen, aber es sollte +Sie können als \PName{Besitzer} angeben, was immer Sie wollen, aber es sollte eindeutig sein! Wenn Sie beispielsweise der Autor des Pakets \Package{float} -wären, könnten Sie als \PName{Besitzer} auch »\PValue{float}« anstelle von -»\PValue{float.sty}« angeben. In diesem Fall würden die +wären, könnten Sie als \PName{Besitzer} auch die Kategorie »\PValue{float}« +anstelle von »\PValue{float.sty}« angeben. In diesem Fall würden die \KOMAScript-Optionen\important{\DescRef{maincls.option.listof}}% -\IndexOption{listof~=\PName{Einstellung}} für das Verzeichnis der Abbildungen +\IndexOption{listof~=\PName{Einstellung}} für das Verzeichnis der Abbildungen und das Verzeichnis der Tabellen auch Ihre Verzeichnisse betreffen, die zum Zeitpunkt der Verwendung der jeweiligen Option bereits zur Liste der bekannten -Dateierweiterungen hinzugefügt sind. Das liegt daran, dass \KOMAScript{} die -Dateierweiterungen »\PValue{lof}« für das Abbildungsverzeichnis und -»\PValue{lot}« für das Tabellenverzeichnis mit dem Besitzer »\PValue{float}« -anmeldet und die Optionen für diese Besitzer setzt. +Dateierweiterungen hinzugefügt sind. Das liegt daran, dass \KOMAScript{} die +Dateierweiterungen »\PValue{lof}« für das Abbildungsverzeichnis und +»\PValue{lot}« für das Tabellenverzeichnis mit der Kategorie »\PValue{float}« +als \PName{Besitzer} anmeldet und die Optionen für diesen Besitzer setzt. Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% -\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens -Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, die +\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens +Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, die eigene Verzeichnisse bereitstellen. Bei Verwendung von \hyperref[cha:scrhack]{\Package{scrhack}} wird dann unter anderem die jeweilige Dateierweiterung der Liste der bekannten Dateierweiterungen -hinzugefügt. Dabei wird als \PName{Besitzer} ebenfalls »\PValue{float}« -verwendet. Dies ist sozusagen der grundlegende Baustein, um die Möglichkeiten -von \Package{tocbasic} und der \KOMAScript-Klassen auch für diese -Verzeichnisse nutzen zu können.% +hinzugefügt. Dabei wird als \PName{Besitzer} ebenfalls »\PValue{float}« +verwendet. Dies ist sozusagen der grundlegende Baustein, um die Möglichkeiten +von \Package{tocbasic} und der \KOMAScript-Klassen auch für diese +Verzeichnisse nutzen zu können.% \EndIndexGroup \begin{Declaration} \Macro{AtAddToTocList}\OParameter{Besitzer}\Parameter{Anweisungen} \end{Declaration} -Auf diese Weise können die \PName{Anweisungen} zu einer internen Liste von -Anweisungen hinzugefügt werden, die immer dann auszuführen sind, wenn eine +Auf diese Weise können die \PName{Anweisungen} zu einer internen Liste von +Anweisungen hinzugefügt werden, die immer dann auszuführen sind, wenn eine Dateierweiterung mit dem angegebenen \PName{Besitzer} zur Liste der bekannten -Dateierweiterungen hinzugefügt wird. Bezüglich des optionalen Arguments wird -wie in der Erklärung von \DescRef{\LabelBase.cmd.addtotoclist} beschrieben +Dateierweiterungen hinzugefügt wird. Bezüglich des optionalen Arguments wird +wie in der Erklärung von \DescRef{\LabelBase.cmd.addtotoclist} beschrieben verfahren. Wird das optionale Argument leer gelassen, werden in diesem Fall -die Aktionen unabhängig vom Besitzer immer ausgeführt, wenn die -Dateierweiterung zu der Liste der bekannten Dateierweiterungen hinzugefügt -wird. Während der Ausführung der \PName{Anweisungen} ist außerdem +die Aktionen unabhängig vom Besitzer immer ausgeführt, wenn die +Dateierweiterung zu der Liste der bekannten Dateierweiterungen hinzugefügt +wird. Während der Ausführung der \PName{Anweisungen} ist außerdem \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die -Dateierweiterung, die gerade hinzugefügt wird. +Dateierweiterung, die gerade hinzugefügt wird. \begin{Example} \Package{tocbasic} selbst verwendet - % Umbruchkorrektur (schließende Klammer verschoben) + % Umbruchkorrektur (schließende Klammer verschoben) \begin{lstcode} \AtAddToTocList[]{% \expandafter\tocbasic@extend@babel \expandafter{\@currext}} \end{lstcode} um jede Dateierweiterung zu der in \Package{tocbasic} vorhandenen - Erweiterung für das Paket \Package{babel} hinzuzufügen. + Erweiterung für das Paket \Package{babel} hinzuzufügen. \end{Example} Die\textnote{Achtung!} zweimalige Verwendung von \Macro{expandafter} ist im Beispiel erforderlich, weil das Argument von \DescRef{\LabelBase.cmd.tocbasic@extend@babel} zwingend bereits expandiert -sein muss. Siehe dazu auch die Erklärung zu +sein muss. Siehe dazu auch die Erklärung zu \DescRef{\LabelBase.cmd.tocbasic@extend@babel} in \autoref{sec:tocbasic.internals}, \DescPageRef{\LabelBase.cmd.tocbasic@extend@babel}. @@ -271,28 +271,28 @@ sein muss. Siehe dazu auch die Erklärung zu \end{Declaration} Man kann eine \PName{Dateierweiterung} auch wieder aus der Liste der bekannten Dateierweiterungen entfernen. Ist das optionale Argument \OParameter{Besitzer} -angegeben, so wird die Dateierweiterung nur entfernt, wenn sie für den +angegeben, so wird die Dateierweiterung nur entfernt, wenn sie für den angegebenen \PName{Besitzer} angemeldet wurde. Wie der Besitzer beim Weglassen -des optionalen Argument bestimmt wird, ist der Erklärung zu +des optionalen Argument bestimmt wird, ist der Erklärung zu \DescRef{\LabelBase.cmd.addtotoclist} zu entnehmen. Wird ein leerer \PName{Besitzer} angegeben, findet kein Besitzertest statt, sondern die -\PName{Dateierweiterung} wird unabhängig vom Besitzer entfernt.% +\PName{Dateierweiterung} wird unabhängig vom Besitzer entfernt.% \EndIndexGroup \begin{Declaration} \Macro{doforeachtocfile}\OParameter{Besitzer}\Parameter{Anweisungen} \end{Declaration} -Bisher haben Sie nur Anweisungen kennengelernt, die für Klassen- und -Paketautoren zwar zusätzliche Sicherheit, aber auch eher zusätzlichen Aufwand -bedeuten. Mit \Macro{doforeachtocfile} kann man die erste Ernte dafür -einfahren. Diese Anweisung erlaubt es die angegebenen \PName{Anweisungen} für -jede von dem \PName{Besitzer} angemeldete Dateierweiterung -auszuführen. Während der Ausführung der \PName{Anweisungen} ist +Bisher haben Sie nur Anweisungen kennengelernt, die für Klassen- und +Paketautoren zwar zusätzliche Sicherheit, aber auch eher zusätzlichen Aufwand +bedeuten. Mit \Macro{doforeachtocfile} kann man die erste Ernte dafür +einfahren. Diese Anweisung erlaubt es die angegebenen \PName{Anweisungen} für +jede mit dem \PName{Besitzer} angemeldete Dateierweiterung +auszuführen. Während der Ausführung der \PName{Anweisungen} ist \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die aktuell verarbeitete Dateierweiterung. Wird das optionale Argument \OParameter{Besitzer} weggelassen, so werden alle Dateierweiterungen -unabhängig vom Besitzer abgearbeitet. Ein leeres optionales Argument würde +unabhängig vom Besitzer abgearbeitet. Ein leeres optionales Argument würde hingegen nur die Dateierweiterungen mit leerem Besitzer verarbeiten. \begin{Example} Wenn Sie die Liste aller bekannten Dateierweiterungen auf das Terminal und @@ -300,16 +300,16 @@ hingegen nur die Dateierweiterungen mit leerem Besitzer verarbeiten. \begin{lstcode} \doforeachtocfile{\typeout{\@currext}} \end{lstcode} - möglich. Sollen hingegen nur die Dateierweiterungen des Besitzer - »\PValue{foo}« ausgegeben werden, geht das einfach mit: + möglich. Sollen hingegen nur die Dateierweiterungen des Besitzer + »\PValue{foo}« ausgegeben werden, geht das einfach mit: \begin{lstcode} \doforeachtocfile[foo]{\typeout{\@currext}} \end{lstcode} \end{Example} Die \KOMAScript-Klassen \Class{scrbook} und \Class{scrreprt} verwenden die -Anweisung, um für Verzeichnisse, für die Eigenschaft \PValue{chapteratlist} -gesetzt ist, optional einen vertikalen Abstand oder die Kapitelüberschrift in -das Verzeichnis einzutragen. Wie Sie diese Eigenschaft setzen können, ist +Anweisung, um für Verzeichnisse, für die Eigenschaft \PValue{chapteratlist} +gesetzt ist, optional einen vertikalen Abstand oder die Kapitelüberschrift in +das Verzeichnis einzutragen. Wie Sie diese Eigenschaft setzen können, ist in \autoref{sec:tocbasic.toc} ab \DescPageRef{\LabelBase.cmd.setuptoc} zu finden.% \EndIndexGroup @@ -318,22 +318,22 @@ finden.% \begin{Declaration} \Macro{tocbasicautomode} \end{Declaration} -Diese Anweisung definiert das vom \LaTeX-Kern für Klassen- und Paketautoren +Diese Anweisung definiert das vom \LaTeX-Kern für Klassen- und Paketautoren bereitgestellte \Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{\@starttoc}} so um, dass bei jedem Aufruf von \Macro{@starttoc} die dabei angegebene -Dateierweiterung in die Liste der bekannten Dateierweiterungen eingefügt wird, -soweit sie dort noch nicht vorhanden ist. Außerdem wird dann +Dateierweiterung in die Liste der bekannten Dateierweiterungen eingefügt wird, +soweit sie dort noch nicht vorhanden ist. Außerdem wird dann \DescRef{\LabelBase.cmd.tocbasic@starttoc} anstelle von \Macro{@starttoc} -verwendet. Näheres zu \DescRef{\LabelBase.cmd.tocbasic@starttoc} und +verwendet. Näheres zu \DescRef{\LabelBase.cmd.tocbasic@starttoc} und \Macro{@starttoc} ist \autoref{sec:tocbasic.internals}, \DescPageRef{\LabelBase.cmd.tocbasic@starttoc} zu entnehmen. Mit Hilfe von \Macro{tocbasicautomode} wird also jedes Verzeichnis, das mit Hilfe von \Macro{@starttoc} erstellt wird, automatisch unter die Kontrolle von -\Package{tocbasic} gestellt. Ob das zum gewünschten Ergebnis führt, hängt +\Package{tocbasic} gestellt. Ob das zum gewünschten Ergebnis führt, hängt jedoch sehr von den jeweiligen Verzeichnissen ab. Immerhin funktioniert damit -schon einmal die Erweiterung für das \Package{babel}-Paket für alle +schon einmal die Erweiterung für das \Package{babel}-Paket für alle Verzeichnisse. Es ist jedoch vorzuziehen, wenn der Paketautor selbst \Package{tocbasic} explizit verwendet. Er kann dann auch die weiteren Vorteile nutzen, die ihm das Paket bietet und die in den nachfolgenden Abschnitten @@ -346,10 +346,10 @@ beschrieben werden.% Im vorherigen Abschnitt haben Sie erfahren, wie eine Liste bekannter Dateierweiterungen verwaltet werden kann\iffree{ und wie automatisch Anweisungen - beim Hinzufügen von Dateierweiterungen zu dieser Liste ausgeführt werden - können}{}. Des Weiteren haben Sie eine Anweisung kennengelernt, mit der man -für jede einzelne bekannte Dateierweiterung oder einen spezifischen Teil davon -Anweisungen ausführen kann. In diesem Abschnitt werden Sie Anweisungen + beim Hinzufügen von Dateierweiterungen zu dieser Liste ausgeführt werden + können}{}. Des Weiteren haben Sie eine Anweisung kennengelernt, mit der man +für jede einzelne bekannte Dateierweiterung oder einen spezifischen Teil davon +Anweisungen ausführen kann. In diesem Abschnitt werden Sie Anweisungen kennenlernen, die sich auf die Datei beziehen, die mit dieser Dateierweiterung verbunden ist. @@ -363,8 +363,8 @@ Die Anweisung \Macro{addtoeachtocfile} schreibt \PName{Inhalt} mit Hilfe von \PName{Besitzer} in der Liste der bekannten Dateierweiterungen \iffree{zu finden ist}{steht}. Wird das optionale Argument weggelassen, wird in jede Datei aus der Liste der bekannten Dateierweiterungen geschrieben.\iffree{ Der - konkrete Dateiname setzt sich dabei übrigens aus \Macro{jobname} und der - Dateierweiterung zusammen.}{} Während des Schreibens von \PName{Inhalt} ist + konkrete Dateiname setzt sich dabei übrigens aus \Macro{jobname} und der + Dateierweiterung zusammen.}{} Während des Schreibens von \PName{Inhalt} ist \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die Dateierweiterung der Datei, in die aktuell geschrieben wird. \begin{Example} @@ -375,8 +375,8 @@ Dateierweiterung der Datei, in die aktuell geschrieben wird. \protect\addvspace{\protect\baselineskip}% }% \end{lstcode} - Wenn Sie das hingegen nur für die Dateien mit dem definierten Besitzer - »\PValue{foo}« machen wollen, verwenden Sie: + Wenn Sie das hingegen nur für die Dateien mit dem definierten Besitzer + »\PValue{foo}« machen wollen, verwenden Sie: \begin{lstcode} \addtoeachtocfile[foo]{% \protect\addvspace{\protect\baselineskip}% @@ -385,7 +385,7 @@ Dateierweiterung der Datei, in die aktuell geschrieben wird. \end{Example}% \iffree{Anweisungen, die nicht bereits beim Schreiben expandiert werden sollen, sind wie bei \Macro{addtocontents} mit \Macro{protect} zu - schützen.}{}% + schützen.}{}% \EndIndexGroup @@ -393,38 +393,38 @@ Dateierweiterung der Datei, in die aktuell geschrieben wird. \Macro{addxcontentsline}\Parameter{Dateierweiterung}\Parameter{Ebene} \OParameter{Gliederungsnummer}\Parameter{Inhalt} \end{Declaration} -Diese\ChangedAt{v3.12}{\Package{tocbasic}} Anweisung ähnelt sehr der Anweisung +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 +\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. Sie -wird verwendet, um nummerierte oder nicht nummerierte Einträge in das über die +wird verwendet, um nummerierte oder nicht nummerierte Einträge in das über die \PName{Dateierweiterung} spezifizierte Verzeichnis aufzunehmen. Dabei ist \PName{Ebene} der symbolische Name der Gliederungsebene und \PName{Inhalt} der entsprechende Eintrag. Die Seitenzahl wird automatisch bestimmt. Im Unterschied zu \Macro{addcontentsline} testet \Macro{addxcontentsline} -zunächst, ob Anweisung \Macro{add\PName{Ebene}\PName{Dateierweiterung}entry} -definiert ist. In diesem Fall wird sie für den Eintrag verwendet, wobei +zunächst, ob Anweisung \Macro{add\PName{Ebene}\PName{Dateierweiterung}entry} +definiert ist. In diesem Fall wird sie für den Eintrag verwendet, wobei \PName{Gliederungsnummer} als optionales Argument und \PName{Inhalt} als -obligatorisches Argument übergeben wird. Ein Beispiel für eine solche -Anweisung, die von den \KOMAScript-Klassen bereitgestellt wird, wäre +obligatorisches Argument übergeben wird. Ein Beispiel für eine solche +Anweisung, die von den \KOMAScript-Klassen bereitgestellt wird, wäre \DescRef{maincls-experts.cmd.addparttocentry} (siehe -\autoref{sec:maincls-experts.experts}, +\autoref{sec:maincls-experts.toc}, \DescPageRef{maincls-experts.cmd.addparttocentry}). Ist die entsprechende Anweisung nicht definiert, wird stattdessen die interne Anweisung -\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} verwendet. Diese erhält +\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} verwendet. Diese erhält alle vier Argumente als obligatorische Argumente und verwendet dann -seinerseits \Macro{addcontentsline}, um den gewünschten Eintrag -vorzunehmen. Näheres zu \DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} ist +seinerseits \Macro{addcontentsline}, um den gewünschten Eintrag +vorzunehmen. Näheres zu \DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} ist \autoref{sec:tocbasic.internals}, \DescPageRef{\LabelBase.cmd.tocbasic@addxcontentsline} zu entnehmen. -Ein Vorteil der Verwendung von \Macro{addxcontentsline} gegenüber +Ein Vorteil der Verwendung von \Macro{addxcontentsline} gegenüber \Macro{addcontentsline} ist zum einen, dass die Eigenschaft \PValue{numberline} (siehe \DescPageRef{\LabelBase.cmd.setuptoc}) beachtet -wird. Zum anderen kann die Form der Einträge über die Definition -entsprechender, für die \PName{Ebene} und \PName{Dateierweiterung} +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.% % \EndIndexGroup @@ -438,7 +438,7 @@ spezifischer Anweisungen konfiguriert werden.% \Macro{addcontentslinetoeachtocfile}\OParameter{Besitzer} \Parameter{Ebene}\Parameter{Inhalt}% \end{Declaration} -Diese beiden Anweisungen stehen in direkter Beziehung zu dem oben erklärten +Diese beiden Anweisungen stehen in direkter Beziehung zu dem oben erklärten \DescRef{\LabelBase.cmd.addxcontentsline}\ChangedAt{v3.12}{\Package{tocbasic}} beziehungsweise zum im \LaTeX-Kern definierten \Macro{addcontentsline}. Der Unterschied besteht darin, dass diese Anweisungen \PName{Inhalt} nicht nur in @@ -448,26 +448,26 @@ 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 \PValue{\#1} den Titel enthält, der geschrieben + wir weiter an, dass aktuell \PValue{\#1} den Titel enthält, der geschrieben werden soll. \begin{lstcode} \addxcontentslinetoeachtocfile{chapter}% [\thechapter]{#1} \end{lstcode} - In diesem Fall soll natürlich die aktuelle Kapitelnummer direkt beim + In diesem Fall soll natürlich die aktuelle Kapitelnummer direkt beim Schreiben in die Verzeichnisdatei expandiert werden, weshalb sie nicht mit - \Macro{protect} vor der Expansion geschützt wurde. + \Macro{protect} vor der Expansion geschützt wurde. \end{Example} -Während des Schreibens von \PName{Inhalt} ist auch hier, wie schon bei +Während des Schreibens von \PName{Inhalt} ist auch hier, wie schon bei \DescRef{\LabelBase.cmd.addtoeachtocfile}, \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die Dateierweiterung der Datei, in die aktuell geschrieben wird.% Die Anweisung\ChangedAt{v3.12}{\Package{tocbasic}} -\Macro{addxcontentslinetoeachtocfile} ist wann immer möglich gegenüber +\Macro{addxcontentslinetoeachtocfile} ist wann immer möglich gegenüber \Macro{addcontentslinetoeachtocfile} vorzuziehen, da die Erweiterungen von -\DescRef{\LabelBase.cmd.addxcontentsline} nur damit Anwendung finden. Näheres -zu diesen Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung von +\DescRef{\LabelBase.cmd.addxcontentsline} nur damit Anwendung finden. Näheres +zu diesen Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung von \DescRef{\LabelBase.cmd.addxcontentsline} zu finden.% % \EndIndexGroup @@ -481,12 +481,12 @@ zu diesen Erweiterungen und Vorteilen ist in der vorausgehenden Erklärung von \end{Declaration} Mit diesen Anweisungen werden die Verzeichnisse ausgegeben. Die\important{\Macro{listoftoc*}} Sternvariante \Macro{listoftoc*} -benötigt als einziges Argument die \PName{Dateierweiterung} der Datei mit den -Daten zu dem Verzeichnis. Die Anweisung setzt zunächst die vertikalen und -horizontalen Abstände, die innerhalb von Verzeichnissen gelten sollen, führt -die Anweisungen aus, die vor dem Einlesen der Datei ausgeführt werden sollen, -liest dann die Datei und führt zum Schluss die Anweisungen aus, die nach dem -Einlesen der Datei ausgeführt werden sollen. Damit kann \Macro{listoftoc*} als +benötigt als einziges Argument die \PName{Dateierweiterung} der Datei mit den +Daten zu dem Verzeichnis. Die Anweisung setzt zunächst die vertikalen und +horizontalen Abstände, die innerhalb von Verzeichnissen gelten sollen, führt +die Anweisungen aus, die vor dem Einlesen der Datei ausgeführt werden sollen, +liest dann die Datei und führt zum Schluss die Anweisungen aus, die nach dem +Einlesen der Datei ausgeführt werden sollen. Damit kann \Macro{listoftoc*} als direkter Ersatz der \LaTeX-Kern-Anweisung \Macro{@starttoc}\IndexCmd{@starttoc}\important{\Macro{@starttoc}} verstanden werden. @@ -494,38 +494,38 @@ werden. Die\important{\Macro{listoftoc}} Version von \Macro{listoftoc} ohne Stern setzt das komplette Verzeichnis und veranlasst auch einen optionalen Eintrag in das Inhaltsverzeichnis und den Kolumnentitel. Ist das optionale Argument -\OParameter{Titel} gegeben, so wird diese Angabe sowohl als Überschrift als +\OParameter{Titel} gegeben, so wird diese Angabe sowohl als Ãœberschrift als auch als optionaler Eintrag in das Inhaltsverzeichnis und den Kolumnentitel verwendet. Ist das Argument \PName{Titel} lediglich leer, so wird auch eine leere Angabe verwendet. Wird\textnote{Achtung!} hingegen das komplette -Argument einschließlich der eckigen Klammern weggelassen, so wird die +Argument einschließlich der eckigen Klammern weggelassen, so wird die Anweisung \Macro{listof\PName{Dateierweiterung}name} verwendet, wenn diese definiert ist. Ist sie nicht definiert, wird ein Standard-Ersatzname verwendet und eine Warnung ausgegeben. Die\important{\Macro{listofeachtoc}} Anweisung \Macro{listofeachtoc} gibt alle -Verzeichnisse des angegebenen Besitzers oder alle Verzeichnisse aller +Verzeichnisse mit dem angegebenen Besitzer oder alle Verzeichnisse aller bekannten Dateinamenerweiterungen aus. Dabei\textnote{Achtung!} sollte \Macro{listof\PName{Dateierweiterung}name} definiert sein, damit der korrekte Titel ausgegeben werden kann. Da\textnote{Tipp!} eventuell auch der Anwender selbst \Macro{listoftoc} ohne optionales Argument oder \Macro{listofeachtoc} verwenden -könnte, wird empfohlen \Macro{listof\PName{Dateierweiterung}name} immer +könnte, wird empfohlen \Macro{listof\PName{Dateierweiterung}name} immer passend zu definieren. \begin{Example} - Angenommen, Sie haben ein neues »Verzeichnis der Algorithmen« mit der - Dateierweiterung »\PValue{loa}« und wollen dieses anzeigen lassen: + Angenommen, Sie haben ein neues »Verzeichnis der Algorithmen« mit der + Dateierweiterung »\PValue{loa}« und wollen dieses anzeigen lassen: \begin{lstcode} \listoftoc[Verzeichnis der Algorithmen]{loa} \end{lstcode} - erledigt das für Sie. Wollen Sie das Verzeichnis hingegen ohne Überschrift - ausgegeben haben, dann genügt: + erledigt das für Sie. Wollen Sie das Verzeichnis hingegen ohne Ãœberschrift + ausgegeben haben, dann genügt: \begin{lstcode} \listoftoc*{loa} \end{lstcode} - Im zweiten Fall würde natürlich auch ein optional aktivierter Eintrag in das - Inhaltsverzeichnis nicht gesetzt. Näheres zur Eigenschaft des Eintrags in + Im zweiten Fall würde natürlich auch ein optional aktivierter Eintrag in das + Inhaltsverzeichnis nicht gesetzt. Näheres zur Eigenschaft des Eintrags in das Inhaltsverzeichnis ist bei der Anweisung \DescRef{\LabelBase.cmd.setuptoc}, \DescPageRef{\LabelBase.cmd.setuptoc} zu finden. @@ -536,12 +536,12 @@ passend zu definieren. Verzeichnis der Algorithmen% } \end{lstcode} - definiert haben, genügt auch: + definiert haben, genügt auch: \begin{lstcode} \listoftoc{loa} \end{lstcode} - um ein Verzeichnis mit der gewünschten Überschrift zu erzeugen. Für den - Anwender ist es eventuell einprägsamer, wenn Sie dann außerdem noch + um ein Verzeichnis mit der gewünschten Ãœberschrift zu erzeugen. Für den + Anwender ist es eventuell einprägsamer, wenn Sie dann außerdem noch \begin{lstcode} \newcommand*{\listofalgorithms}{\listoftoc{loa}} \end{lstcode} @@ -549,24 +549,24 @@ passend zu definieren. \end{Example} Da\textnote{Achtung!} \LaTeX{} bei der Ausgabe eines Verzeichnisses auch -gleich eine neue Verzeichnisdatei zum Schreiben öffnet, kann der Aufruf jeder +gleich eine neue Verzeichnisdatei zum Schreiben öffnet, kann der Aufruf jeder dieser Anweisungen zu einer Fehlermeldung der Art \begin{lstoutput} ! No room for a new \write . \ch@ck ...\else \errmessage {No room for a new #3} \fi \end{lstoutput} -führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in +führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} bieten. Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% -\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens -Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, damit +\important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens +Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, damit deren Verzeichnisbefehle \Macro{listoftoc} verwenden. Dadurch stehen viele -Möglichkeiten von \Package{tocbasic} und den \KOMAScript-Klassen auch für -deren Verzeichnisse zur Verfügung.% +Möglichkeiten von \Package{tocbasic} und den \KOMAScript-Klassen auch für +deren Verzeichnisse zur Verfügung.% \EndIndexGroup @@ -575,15 +575,15 @@ deren Verzeichnisse zur Verfügung.% \Parameter{Anweisungen} \Macro{AfterStartingTOC}\OParameter{Dateierweiterung}\Parameter{Anweisungen} \end{Declaration} -Manchmal ist es nützlich, wenn unmittelbar vor dem Einlesen der Datei mit den -Verzeichnisdaten \PName{Anweisungen} ausgeführt werden können. Mit Hilfe von -\Macro{BeforeStartingTOC} können Sie eine solche Ausführung -wahlweise für eine einzelne \PName{Dateierweiterung} oder alle Dateien, die +Manchmal ist es nützlich, wenn unmittelbar vor dem Einlesen der Datei mit den +Verzeichnisdaten \PName{Anweisungen} ausgeführt werden können. Mit Hilfe von +\Macro{BeforeStartingTOC} können Sie eine solche Ausführung +wahlweise für eine einzelne \PName{Dateierweiterung} oder alle Dateien, die mit Hilfe von \DescRef{\LabelBase.cmd.listoftoc*}, \DescRef{\LabelBase.cmd.listoftoc} oder \DescRef{\LabelBase.cmd.listofeachtoc} -eingelesen werden, erreichen. Ebenso können Sie \PName{Anweisungen} nach dem -Einlesen der Datei ausführen, wenn Sie diese mit \Macro{AfterStartingTOC} -definieren. Während der Ausführung der \PName{Anweisungen} ist +eingelesen werden, erreichen. Ebenso können Sie \PName{Anweisungen} nach dem +Einlesen der Datei ausführen, wenn Sie diese mit \Macro{AfterStartingTOC} +definieren. Während der Ausführung der \PName{Anweisungen} ist \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die Dateierweiterung der Datei, die eingelesen wird bzw. gerade eingelesen wurde. @@ -598,35 +598,35 @@ ist in \autoref{sec:scrwfile.clonefilefeature} auf \Macro{BeforeTOCHead}\OParameter{Dateierweiterung}\Parameter{Anweisungen} \Macro{AfterTOCHead}\OParameter{Dateierweiterung}\Parameter{Anweisungen} \end{Declaration} -Es können auch \PName{Anweisungen} definiert werden, die unmittelbar vor oder -nach dem Setzen der Überschrift bei Verwendung von +Es können auch \PName{Anweisungen} definiert werden, die unmittelbar vor oder +nach dem Setzen der Ãœberschrift bei Verwendung von \DescRef{\LabelBase.cmd.listoftoc} oder \DescRef{\LabelBase.cmd.listofeachtoc} -ausgeführt werden. Bezüglich des optionalen Arguments und der Bedeutung von +ausgeführt werden. Bezüglich des optionalen Arguments und der Bedeutung von \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} gilt, was bereits bei \DescRef{\LabelBase.cmd.BeforeStartingTOC} und -\DescRef{\LabelBase.cmd.AfterStartingTOC} oben erklärt wurde.% +\DescRef{\LabelBase.cmd.AfterStartingTOC} oben erklärt wurde.% \EndIndexGroup \begin{Declaration} \Macro{MakeMarkcase} \end{Declaration} -Wann immer \Package{tocbasic} eine Marke für einen Kolumnentitel setzt, +Wann immer \Package{tocbasic} eine Marke für einen Kolumnentitel setzt, erfolgt dies als Argument der Anweisung \Macro{MakeMarkcase}. Diese Anweisung -ist dazu gedacht, bei Bedarf die Groß-/Kleinschreibung des Kolumnentitels zu -ändern. In der Voreinstellung ist diese Anweisung bei Verwendung einer +ist dazu gedacht, bei Bedarf die Groß-/Kleinschreibung des Kolumnentitels zu +ändern. In der Voreinstellung ist diese Anweisung bei Verwendung einer \KOMAScript-Klasse \Macro{@firstofone}\IndexCmd{@firstofone}\important{\Macro{@firstofone}}, also -das unveränderte Argument selbst. Bei Verwendung einer anderen Klasse ist +das unveränderte Argument selbst. Bei Verwendung einer anderen Klasse ist \Macro{MakeMarkcase} im Gegensatz dazu \Macro{MakeUppercase}\IndexCmd{MakeUppercase}\important{\Macro{MakeUppercase}}. Die Anweisung wird von \Package{tocbasic} jedoch nur definiert, wenn sie -nicht bereits definiert ist. Sie kann also in einer Klasse in der gewünschten +nicht bereits definiert ist. Sie kann also in einer Klasse in der gewünschten Weise vorbelegt werden und wird dann von \Package{tocbasic} nicht umdefiniert, sondern verwendet wie vorgefunden. \begin{Example} - Sie wollen aus unerfindlichen Gründen, dass die Kolumnentitel in Ihrer - Klasse in Kleinbuchstaben ausgegeben werden. Damit dies auch für die + Sie wollen aus unerfindlichen Gründen, dass die Kolumnentitel in Ihrer + Klasse in Kleinbuchstaben ausgegeben werden. Damit dies auch für die Kolumnentitel gilt, die von \Package{tocbasic} gesetzt werden, definieren Sie: \begin{lstcode} @@ -636,20 +636,20 @@ sondern verwendet wie vorgefunden. Erlauben\textnote{Tipp!} Sie mir einen Hinweis zu \Macro{MakeUppercase}. Diese Anweisung ist zum einen nicht voll expandierbar. Das bedeutet, dass sie im -Zusammenspiel mit anderen Anweisungen zu Problemen führen kann. Zum anderen +Zusammenspiel mit anderen Anweisungen zu Problemen führen kann. Zum anderen sind sich alle Typografen einig, dass beim Versalsatz, also beim Satz -kompletter Wörter oder Passagen in Großbuchstaben, Sperrung unbedingt +kompletter Wörter oder Passagen in Großbuchstaben, Sperrung unbedingt notwendig ist. Dabei darf jedoch kein fester Abstand zwischen den Buchstaben verwendet werden. Vielmehr muss zwischen unterschiedlichen Buchstaben auch ein unterschiedlicher Abstand gesetzt werden, weil sich unterschiedliche Buchstabenkombinationen unterschiedlich verhalten. Gleichzeitig bilden einige -Buchstaben von sich aus bereits Löcher, was bei der Sperrung ebenfalls zu -berücksichtigen ist. Pakete wie \Package{ulem} oder \Package{soul} können das +Buchstaben von sich aus bereits Löcher, was bei der Sperrung ebenfalls zu +berücksichtigen ist. Pakete wie \Package{ulem} oder \Package{soul} können das ebenso wenig leisten wie der Befehl \Macro{MakeUppercase} selbst. Auch die automatische Sperrung mit Hilfe des \Package{microtype}-Pakets ist -diesbezüglich nur eine näherungsweise Notlösung, da die von der konkreten -Schrift abhängige Form der Buchstaben auch hier nicht näher betrachtet -wird. Da\textnote{Empfehlung} Versalsatz also eher etwas für absolute +diesbezüglich nur eine näherungsweise Notlösung, da die von der konkreten +Schrift abhängige Form der Buchstaben auch hier nicht näher betrachtet +wird. Da\textnote{Empfehlung} Versalsatz also eher etwas für absolute Experten ist und fast immer Handarbeit bedeutet, wird Laien empfohlen, darauf zu verzichten oder ihn nur vorsichtig und nicht an so exponierter Stelle wie dem Kolumnentitel zu verwenden.% @@ -659,17 +659,22 @@ wie dem Kolumnentitel zu verwenden.% \begin{Declaration} \Macro{deftocheading}\Parameter{Dateierweiterung}\Parameter{Definition} \end{Declaration} -Das Paket \Package{tocbasic} enthält eine Standarddefinition für das Setzen -von Überschriften von Verzeichnissen. Diese Standarddefinition ist durch +Das Paket \Package{tocbasic} enthält eine Standarddefinition für das Setzen +von Ãœberschriften von Verzeichnissen. Diese Standarddefinition ist durch verschiedene Eigenschaften, die bei der Anweisung -\DescRef{\LabelBase.cmd.setuptoc} erläutert werden, konfigurierbar. Sollte -diese Möglichkeit einmal nicht ausreichen, so besteht die Möglichkeit, mit -\Macro{deftocheading} eine alternative Überschriftenanweisung für ein +\DescRef{\LabelBase.cmd.setuptoc} erläutert werden, konfigurierbar. Sollte +diese Möglichkeit einmal nicht ausreichen, so besteht die Möglichkeit, mit +\Macro{deftocheading} eine alternative Ãœberschriftenanweisung für ein Verzeichnis mit einer bestimmten \PName{Dateierweiterung} zu definieren. Die Definition kann als einzigen Parameter \PValue{\#1} enthalten. Beim Aufruf der Anweisung innerhalb von \DescRef{\LabelBase.cmd.listoftoc} oder -\DescRef{\LabelBase.cmd.listofeachtoc} wird für dieses Argument dann der Titel -für das Verzeichnis übergeben.% +\DescRef{\LabelBase.cmd.listofeachtoc} wird für dieses Argument dann der Titel +für das Verzeichnis übergeben. + +Die \PName{Definition} ist dann selbstverständlich auch für die Auswertung +weiterer Eigenschaften, die sich auf die Ãœberschrift beziehen, +verantwortlich. Das gilt insbesondere für die nachfolgend erklärten +Eigenschaften \PValue{leveldown}, \PValue{numbered} und \PValue{totoc}.% \EndIndexGroup @@ -679,77 +684,82 @@ für das Verzeichnis übergeben.% \Macro{unsettoc}\Parameter{Dateierweiterung} \Parameter{Liste von Eigenschaften} \end{Declaration} -Mit diesen beiden Anweisungen können \PName{Eigenschaften} für eine -\PName{Dateierweiterung} bzw. das Verzeichnis, das dazu gehört, gesetzt und -gelöscht werden. Die \PName{Liste von Eigenschaften} ist dabei eine durch +Mit diesen beiden Anweisungen können \PName{Eigenschaften} für eine +\PName{Dateierweiterung} bzw. das Verzeichnis, das dazu gehört, gesetzt und +gelöscht werden. Die \PName{Liste von Eigenschaften} ist dabei eine durch Komma getrennte Folge von \PName{Eigenschaften}. Das Paket \Package{tocbasic} wertet folgende Eigenschaften aus: \begin{description}\setkomafont{descriptionlabel}{}% \item[\PValue{leveldown}] bedeutet, dass das Verzeichnis nicht mit der obersten Gliederungsebene unterhalb von \DescRef{maincls.cmd.part} -- wenn vorhanden \DescRef{maincls.cmd.chapter}, sonst \DescRef{maincls.cmd.section} - -- erstellt wird, sondern mit einer Überschrift der nächst tieferen + -- erstellt wird, sondern mit einer Ãœberschrift der nächst tieferen Gliederungsebene. Diese Eigenschaft wird von der internen - Überschriftenanweisung ausgewertet. Wird\textnote{Achtung!} hingegen eine - eigene Überschriftenanweisung mit \DescRef{\LabelBase.cmd.deftocheading} + Ãœberschriftenanweisung ausgewertet. Wird\textnote{Achtung!} hingegen eine + eigene Ãœberschriftenanweisung mit \DescRef{\LabelBase.cmd.deftocheading} definiert, liegt die Auswertung der Eigenschaft in der Verantwortung dessen, der die Definition vornimmt. Die \KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option \OptionValueRef{maincls}{listof}{leveldown}% \important{\OptionValueRef{maincls}{listof}{leveldown}}% - \IndexOption{listof~=\textKValue{leveldown}} für alle Dateierweiterungen des - Besitzers \PValue{float}. + \IndexOption{listof~=\textKValue{leveldown}} für alle Dateierweiterungen mit + dem Besitzer \PValue{float}. \item[\PValue{nobabel}] bedeutet, dass die normalerweise automatisch - verwendete Erweiterung für die Sprachumschaltung mit - \Package{babel}\IndexPackage{babel} für diese Dateierweiterung nicht - verwendet wird. Diese Eigenschaft sollte nur für Verzeichnisse verwendet + verwendete Erweiterung für die Sprachumschaltung mit + \Package{babel}\IndexPackage{babel} für diese Dateierweiterung nicht + verwendet wird. Diese Eigenschaft sollte nur für Verzeichnisse verwendet werden, die nur in einer festen Sprache erstellt werden, in denen also - Sprachumschaltungen im Dokument nicht zu berücksichtigen sind. Sie wird - außerdem vom Paket - \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} für + Sprachumschaltungen im Dokument nicht zu berücksichtigen sind. Sie wird + außerdem vom Paket + \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} für Klonziele verwendet, da die Erweiterungen dort bereits durch das Klonen - selbst aus der Klonquelle übernommen werden. + selbst aus der Klonquelle übernommen werden. Es ist zu beachten\textnote{Achtung!}, dass die Eigenschaft bereits vor dem - Hinzufügen der Dateierweiterung zu der Liste der bekannten + Hinzufügen der Dateierweiterung zu der Liste der bekannten Dateierweiterungen gesetzt sein muss, damit sie eine Wirkung hat. +\item[\PValue{noindent}]\ChangedAt{v3.27}{\Package{tocbasic}} veranlasst alle + von \KOMAScript{} bereitgestellten Verzeichniseintragsstile die Eigenschaft + \PValue{indent} (siehe \autoref{tab:tocbasic.tocstyle.attributes}, + \autopageref{tab:tocbasic.tocstyle.attributes.indent}) zu ignorieren und + stattdessen den Einzug zu deaktivieren. \item[\PValue{noparskipfake}] verhindert\ChangedAt{v3.17}{\Package{tocbasic}}, - dass vor dem Abschalten des Absatzabstandes für die Verzeichnisse ein - letztes Mal ein expliziter Absatzabstand eingefügt wird. Dies führt in der + dass vor dem Abschalten des Absatzabstandes für die Verzeichnisse ein + letztes Mal ein expliziter Absatzabstand eingefügt wird. Dies führt in der Regel dazu, dass bei Dokumenten mit Absatzabstand der Abstand zwischen - Überschrift und ersten Verzeichniseintrag\index{Verzeichnis>Eintrag} kleiner - wird als zwischen Überschriften und normalem Text. Normalerweise erhält man + Ãœberschrift und ersten Verzeichniseintrag\index{Verzeichnis>Eintrag} kleiner + wird als zwischen Ãœberschriften und normalem Text. Normalerweise erhält man daher ohne diese Eigenschaft eine einheitlichere Formatierung. \item[\PValue{noprotrusion}] verhindert\ChangedAt{v3.10}{\Package{tocbasic}} das Abschalten des optischen Randausgleichs in den Verzeichnissen. Optischer - Randausgleich wird standardmäßig abgeschaltet, wenn das Paket + Randausgleich wird standardmäßig abgeschaltet, wenn das Paket \Package{microtype}\IndexPackage{microtype} oder ein anderes Paket, das die Anweisung \Macro{microtypesetup}\IndexCmd{microtypesetup} bereitstellt, geladen ist. Wenn also optischer Randausgleich in den Verzeichnissen - gewünscht wird, dann muss diese Eigenschaft aktiviert + gewünscht wird, dann muss diese Eigenschaft aktiviert werden. Es\textnote{Achtung!} ist jedoch zu beachten, dass der optische - Randausgleich in Verzeichnissen häufig zu einem falschen Ergebnis - führt. Dies ist ein bekanntes Problem des optischen Randausgleichs. + Randausgleich in Verzeichnissen häufig zu einem falschen Ergebnis + führt. Dies ist ein bekanntes Problem des optischen Randausgleichs. \item[\PValue{numbered}] bedeutet, dass das Verzeichnis nummeriert und damit ebenfalls in das Inhaltsverzeichnis aufgenommen werden soll. Diese - Eigenschaft wird von der internen Überschriftenanweisung ausgewertet. Wird - hingegen eine eigene Überschriftenanweisung mit + Eigenschaft wird von der internen Ãœberschriftenanweisung ausgewertet. Wird + hingegen eine eigene Ãœberschriftenanweisung mit \DescRef{\LabelBase.cmd.deftocheading} definiert, liegt die Auswertung der Eigenschaft in der Verantwortung dessen, der die Definition vornimmt. Die \KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option \OptionValueRef{maincls}{listof}{numbered}% \important{\OptionValueRef{maincls}{listof}{numbered}}% - \IndexOption{listof~=\textKValue{numbered}} für alle Dateierweiterungen des - Besitzers \Package{float}. + \IndexOption{listof~=\textKValue{numbered}} für alle Dateierweiterungen mit + dem Besitzer \Package{float}. \item[\PValue{numberline}] \ChangedAt{v3.12}{\Package{tocbasic}}% - bedeutet, dass all diejenigen Einträge, die mit Hilfe der Anweisung + bedeutet, dass all diejenigen Einträge, die mit Hilfe der Anweisung \DescRef{\LabelBase.cmd.addxcontentsline} oder der Anweisung - \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile} vorgenommen werden, wobei das optionale Argument für die Nummer fehlt - oder leer ist, mit einer leeren - \DescRef{\LabelBase.cmd.numberline}-Anweisung versehen 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. Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung des + \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile} vorgenommen werden, + wobei das optionale Argument für die Nummer fehlt oder leer ist, mit einer + leeren \DescRef{\LabelBase.cmd.numberline}-Anweisung versehen 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. Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung des Verzeichniseintragsstils \PValue{tocline} kann die Eigenschaft weitere Auswirkungen haben. Siehe dazu die Stil-Eigenschaften \Option{breakafternumber} und \Option{entrynumberformat} in @@ -759,20 +769,20 @@ Komma getrennte Folge von \PName{Eigenschaften}. Das Paket Die \KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option \OptionValueRef{maincls}{listof}{numberline}% \important{\OptionValueRef{maincls}{listof}{numberline}}% - \IndexOption{listof~=\textKValue{numberline}} für die Dateierweiterungen des - Besitzers \PValue{float} und bei Verwendung der Option + \IndexOption{listof~=\textKValue{numberline}} für die Dateierweiterungen mit + dem Besitzer \PValue{float} und bei Verwendung der Option \OptionValueRef{maincls}{toc}{numberline}% \important{\OptionValueRef{maincls}{toc}{numberline}}% - \IndexOption{toc~=\textKValue{numberline}} für die Dateierweiterung + \IndexOption{toc~=\textKValue{numberline}} für die Dateierweiterung \PValue{toc}. Entsprechend wird die Eigenschaft bei Verwendung von Option \OptionValueRef{maincls}{listof}{nonumberline}% \important{\OptionValueRef{maincls}{listof}{nonumberline}}% \IndexOption{listof~=\textKValue{nonumberline}} oder \OptionValueRef{maincls}{toc}{nonumberline}% \important{\OptionValueRef{maincls}{toc}{nonumberline}}% - \IndexOption{toc~=\textKValue{nonumberline}} wieder zurückgesetzt. + \IndexOption{toc~=\textKValue{nonumberline}} wieder zurückgesetzt. \item[\PValue{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}% - bedeutet, dass für dieses Verzeichnis automatisch der \LaTeX-interne + bedeutet, dass für dieses Verzeichnis automatisch der \LaTeX-interne Einspaltenmodus mit \Macro{onecolumn}\IndexCmd{onecolumn} verwendet wird. Dies\textnote{Achtung!} gilt jedoch nur, falls dieses Verzeichnis nicht mit der oben beschriebenen Eigenschaft @@ -780,32 +790,32 @@ Komma getrennte Folge von \PName{Eigenschaften}. Das Paket nach unten verschoben wurde. Die \KOMAScript-Klassen \Class{scrbook} und \Class{scrreprt} setzen diese Eigenschaft per \DescRef{\LabelBase.cmd.AtAddToTocList} (siehe - \DescPageRef{\LabelBase.cmd.AtAddToTocList}) für alle Verzeichnisse mit dem + \DescPageRef{\LabelBase.cmd.AtAddToTocList}) für alle Verzeichnisse mit dem Besitzer \PValue{float} oder mit sich selbst als Besitzer. Damit werden beispielsweise das Inhaltsverzeichnis, das Abbildungsverzeichnis und das Tabellenverzeichnis bei diesen beiden Klassen automatisch einspaltig gesetzt. Der Mehrspaltenmodus des \Package{multicol}-Pakets\IndexPackage{multicol} ist von der Eigenschaft - ausdrücklich nicht betroffen. + ausdrücklich nicht betroffen. \item[\PValue{totoc}] bedeutet, dass der Titel des Verzeichnisses in das Inhaltsverzeichnis aufgenommen werden soll. Diese Eigenschaft wird von der - internen Überschriftenanweisung ausgewertet. Wird\textnote{Achtung!} mit + internen Ãœberschriftenanweisung ausgewertet. Wird\textnote{Achtung!} mit \DescRef{\LabelBase.cmd.deftocheading}\important{\DescRef{\LabelBase.cmd.deftocheading}}% - \IndexCmd{deftocheading} hingegen eine eigene Überschriftenanweisung + \IndexCmd{deftocheading} hingegen eine eigene Ãœberschriftenanweisung definiert, liegt die Auswertung der Eigenschaft in der Verantwortung dessen, der die Definition vornimmt. Die \KOMAScript-Klassen setzen diese Eigenschaft bei Verwendung der Option \OptionValueRef{maincls}{listof}{totoc}% \important{\OptionValueRef{maincls}{listof}{totoc}}% - \IndexOption{listof~=\textKValue{totoc}} für alle Dateierweiterungen des - Besitzers \Package{float}. + \IndexOption{listof~=\textKValue{totoc}} für alle Dateierweiterungen mit dem + Besitzer \Package{float}. \end{description} Die \KOMAScript-Klassen kennen eine weitere Eigenschaft: \begin{description}\setkomafont{descriptionlabel}{} -\item[\PValue{chapteratlist}] sorgt dafür, dass in dieses Verzeichnis bei - jedem neuen Kapitel eine optionale Gliederung eingefügt wird. In der +\item[\PValue{chapteratlist}] sorgt dafür, dass in dieses Verzeichnis bei + jedem neuen Kapitel eine optionale Gliederung eingefügt wird. In der Voreinstellung ist diese Untergliederung dann ein vertikaler - Abstand. Näheres zu den Möglichkeiten ist Option + Abstand. Näheres zu den Möglichkeiten ist Option \DescRef{maincls.option.listof}% \IndexOption{listof~=\PName{Einstellung}}% \important{\DescRef{maincls.option.listof}} in @@ -813,8 +823,8 @@ Die \KOMAScript-Klassen kennen eine weitere Eigenschaft: entnehmen. \end{description} \begin{Example} - Da \KOMAScript{} für das Abbildungs- und das Tabellenverzeichnis auf - \Package{tocbasic} aufbaut, gibt es nun eine weitere Möglichkeit, jegliche + Da \KOMAScript{} für das Abbildungs- und das Tabellenverzeichnis auf + \Package{tocbasic} aufbaut, gibt es nun eine weitere Möglichkeit, jegliche Kapiteluntergliederung dieser Verzeichnisse zu verhindern: \begin{lstcode} \unsettoc{lof}{chapteratlist} @@ -822,14 +832,14 @@ Die \KOMAScript-Klassen kennen eine weitere Eigenschaft: \end{lstcode} Wollen Sie hingegen, dass das von Ihnen definierte Verzeichnis mit der - Dateierweiterung »\PValue{loa}« ebenfalls von der Kapiteluntergliederung der + Dateierweiterung »\PValue{loa}« ebenfalls von der Kapiteluntergliederung der \KOMAScript-Klassen betroffen ist, so verwenden Sie \begin{lstcode} \setuptoc{loa}{chapteratlist} \end{lstcode} -Wollen Sie außerdem, dass bei Klassen, die \DescRef{maincls.cmd.chapter} als +Wollen Sie außerdem, dass bei Klassen, die \DescRef{maincls.cmd.chapter} als oberste Gliederungsebene verwenden, das Verzeichnis automatisch einspaltig -gesetzt wird, so verwenden Sie zusätzlich +gesetzt wird, so verwenden Sie zusätzlich \begin{lstcode} \ifundefinedorrelax{chapter}{}{% \setuptoc{loa}{onecolumn}% @@ -843,12 +853,12 @@ gesetzt wird, so verwenden Sie zusätzlich Sollte\textnote{Tipp!} Ihr Paket mit einer anderen Klasse verwendet werden, so schadet es trotzdem nicht, dass Sie diese Eigenschaften setzen, im Gegenteil: Wertet eine andere Klasse diese Eigenschaften ebenfalls aus, so - nutzt Ihr Paket automatisch die Möglichkeiten jener Klasse. + nutzt Ihr Paket automatisch die Möglichkeiten jener Klasse. \end{Example} -Wie Sie hier sehen, unterstützt ein Paket, das \Package{tocbasic} verwendet, -bereits ohne nennenswerten Aufwand diverse Möglichkeiten für die dadurch +Wie Sie hier sehen, unterstützt ein Paket, das \Package{tocbasic} verwendet, +bereits ohne nennenswerten Aufwand diverse Möglichkeiten für die dadurch realisierten Verzeichnisse, die sonst einigen Implementierungsaufwand -bedeuten würden und deshalb in vielen Paketen leider fehlen.% +bedeuten würden und deshalb in vielen Paketen leider fehlen.% \EndIndexGroup @@ -856,46 +866,46 @@ bedeuten würden und deshalb in vielen Paketen leider fehlen.% \Macro{iftocfeature}\Parameter{Dateierweiterung}\Parameter{Eigenschaft} \Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Hiermit kann man für jede \PName{Eigenschaft} feststellen, ob sie für eine +Hiermit kann man für jede \PName{Eigenschaft} feststellen, ob sie für eine \PName{Dateierweiterung} gesetzt ist. Ist dies der Fall, wird der -\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Das kann -beispielsweise nützlich sein, wenn Sie eigene Überschriftenanweisungen mit +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Das kann +beispielsweise nützlich sein, wenn Sie eigene Ãœberschriftenanweisungen mit \DescRef{\LabelBase.cmd.deftocheading} definieren, aber die oben beschriebenen Eigenschaften \PValue{totoc}, \PValue{numbered} oder \PValue{leveldown} -unterstützen wollen. +unterstützen wollen. % \EndIndexGroup -\section{Konfiguration von Verzeichniseinträgen} +\section{Konfiguration von Verzeichniseinträgen} \seclabel{tocstyle} \BeginIndexGroup \BeginIndex{}{Verzeichnis>Eintrag} -Neben\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} den eigentlichen -Verzeichnissen und den zugehörigen Hilfsdateien kann man mit dem Paket -\Package{tocbasic} ab Version~3.20 auch Einfluss auf die Verzeichniseinträge -nehmen. Dazu können neue Stile definiert werden. Es stehen aber auch mehrere -vordefinierte Stile zur Verfügung. Mittelfristig wird \Package{tocbasic} das -nie offiziell gewordene \KOMAScript-Paket \Package{tocstyle} ablösen. Die -\KOMAScript-Klassen selbst bauen seit Version~3.20 ebenfalls vollständig auf -die von \Package{tocbasic} bereitgestellten Stile für Verzeichniseinträge. +Neben\ChangedAt{v3.20}{\Package{tocbasic}} den eigentlichen +Verzeichnissen und den zugehörigen Hilfsdateien kann man mit dem Paket +\Package{tocbasic} ab Version~3.20 auch Einfluss auf die Verzeichniseinträge +nehmen. Dazu können neue Stile definiert werden. Es stehen aber auch mehrere +vordefinierte Stile zur Verfügung. Mittelfristig wird \Package{tocbasic} das +nie offiziell gewordene \KOMAScript-Paket \Package{tocstyle} ablösen. Die +\KOMAScript-Klassen selbst bauen seit Version~3.20 ebenfalls vollständig auf +die von \Package{tocbasic} bereitgestellten Stile für Verzeichniseinträge. \begin{Declaration} \Counter{tocdepth} \end{Declaration} -Verzeichniseinträge sind normalerweise hierarchisch geordnet. Dazu wird jeder -Eintragsebene ein nummerischer Wert zu geordnet. Je höher dieser Wert, desto +Verzeichniseinträge sind normalerweise hierarchisch geordnet. Dazu wird jeder +Eintragsebene ein nummerischer Wert zu geordnet. Je höher dieser Wert, desto tiefer in der Hierarchie liegt die Ebene. Bei den Standardklassen hat die -Ebene für Teile beispielsweise den Wert -1 und die Ebene für Kapitel den Wert -0. Über den \LaTeX-Zähler \Counter{tocdepth} wird bestimmt, bis zu welcher -Ebene Einträge im Verzeichnis ausgegeben werden. +Ebene für Teile beispielsweise den Wert -1 und die Ebene für Kapitel den Wert +0. Ãœber den \LaTeX-Zähler \Counter{tocdepth} wird bestimmt, bis zu welcher +Ebene Einträge im Verzeichnis ausgegeben werden. Bei \Class{book} ist \Counter{tocdepth} beispielsweise mit 2 voreingestellt, -es werden also die Einträge der Ebenen \PValue{part}, \PValue{chapter}, +es werden also die Einträge der Ebenen \PValue{part}, \PValue{chapter}, \PValue{section} und \PValue{subsection} ausgeben. Tiefere Ebenen wie \PValue{subsubsection}, deren nummerischer Wert 3 ist, werden nicht -ausgegeben. Trotzdem sind die Einträge in der Hilfsdatei für das +ausgegeben. Trotzdem sind die Einträge in der Hilfsdatei für das Inhaltsverzeichnis vorhanden. Die von \Package{tocbasic} definierten Eintragsstile beachten, abgesehen von @@ -909,27 +919,27 @@ Die von \Package{tocbasic} definierten Eintragsstile beachten, abgesehen von \Macro{numberline}\Parameter{Gliederungsnummer} \Macro{usetocbasicnumberline}\OParameter{Code} \end{Declaration} -Zwar\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} definiert bereits der -\LaTeX-Kern eine Anweisung \Macro{numberline}, diese ist allerdings für die +Zwar\ChangedAt{v3.20}{\Package{tocbasic}} definiert bereits der +\LaTeX-Kern eine Anweisung \Macro{numberline}, diese ist allerdings für die Anforderungen von \Package{tocbasic} nicht ausreichend. Deshalb definiert \Package{tocbasic} eigene Anweisungen und setzt \Macro{numberline} bei Bedarf -mit Hilfe von \Macro{usetocbasicnumberline} für die einzelnen -Verzeichniseinträge entsprechend. Eine Umdefinierung von \Macro{numberline} -ist daher bei Verwendung von \Package{tocbasic} oftmals wirkungslos und führt +mit Hilfe von \Macro{usetocbasicnumberline} für die einzelnen +Verzeichniseinträge entsprechend. Eine Umdefinierung von \Macro{numberline} +ist daher bei Verwendung von \Package{tocbasic} oftmals wirkungslos und führt teilweise auch zu Warnungen. Man kann auch die Definition von \Package{tocbasic} generell nutzen, indem man -bereits in der Dokumentpräambel \Macro{usetocbasicnumberline} aufruft. Die -Anweisung versucht zunächst zu ermitteln, ob in der aktuellen Definition +bereits in der Dokumentpräambel \Macro{usetocbasicnumberline} aufruft. Die +Anweisung versucht zunächst zu ermitteln, ob in der aktuellen Definition wichtige interne Anweisungen von \Package{tocbasic} verwendet werden. Ist dies -nicht der Fall, wird \Macro{numberline} entsprechend umdefiniert und zusätzlich -\PName{Code} ausgeführt. Ist kein optionales Arguments angegeben, wird -stattdessen via \Macro{PackageInfo} eine Meldung über die erfolgte -Umdefinierung ausgegeben. Diese Meldung kann man einfach unterdrücken, indem +nicht der Fall, wird \Macro{numberline} entsprechend umdefiniert und zusätzlich +\PName{Code} ausgeführt. Ist kein optionales Arguments angegeben, wird +stattdessen via \Macro{PackageInfo} eine Meldung über die erfolgte +Umdefinierung ausgegeben. Diese Meldung kann man einfach unterdrücken, indem ein leeres optionales Argument angegeben wird. Es\textnote{Achtung!} ist zu beachten, dass \Macro{usetocbasicnumberline} den -internen Schalter \Macro{if@tempswa} global verändern kann!% +internen Schalter \Macro{if@tempswa} global verändern kann!% \EndIndexGroup @@ -939,16 +949,16 @@ internen Schalter \Macro{if@tempswa} global verändern kann!% \Macro{DeclareTOCStyleEntries}\OParameter{Optionenliste}\Parameter{Stil} \Parameter{Liste von Eintragsebenen} \end{Declaration} -Über\ChangedAt{v3.20}{\Package{tocbasic}} diese Anweisungen werden -die Verzeichniseinträge für bestimmte \PName{Eintragsebenen} deklariert +Ãœber\ChangedAt{v3.20}{\Package{tocbasic}} diese Anweisungen werden +die Verzeichniseinträge für bestimmte \PName{Eintragsebenen} deklariert oder konfiguriert. Dabei ist die \PName{Eintragsebene} der Name der jeweiligen -Eintragsebene, beispielsweise \PValue{section} für einen zur gleichnamigen -Gliederungsebene gehörenden Eintrag ins Inhaltsverzeichnis oder -\PValue{figure} für den Eintrag einer Abbildung ins +Eintragsebene, beispielsweise \PValue{section} für einen zur gleichnamigen +Gliederungsebene gehörenden Eintrag ins Inhaltsverzeichnis oder +\PValue{figure} für den Eintrag einer Abbildung ins Abbildungsverzeichnis. Jeder \PName{Eintragsebene} wird ein bestimmter \PName{Stil} zugeordnet, der zum Zeitpunkt der Deklaration bereits definiert -sein muss. Über die \PName{Optionenliste} können die verschiedenen, meist vom -\PName{Stil} abhängenden Eigenschaften des Eintrags festgelegt werden. +sein muss. Ãœber die \PName{Optionenliste} können die verschiedenen, meist vom +\PName{Stil} abhängenden Eigenschaften des Eintrags festgelegt werden. Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \begin{description}\setkomafont{descriptionlabel}{} @@ -956,20 +966,20 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \PValue{dottedtocline}. Klassenautoren, die \Package{tocbasic} verwenden, wird empfohlen, diesen Stil mit Hilfe von \DescRef{\LabelBase.cmd.CloneTOCEntryStyle} auf den - Standardverzeichniseintragsstil der Klasse zu ändern. Bei den + Standardverzeichniseintragsstil der Klasse zu ändern. Bei den \KOMAScript-Klassen wird \PValue{default} beispielsweise zu einem Klon von Stil \PValue{tocline}. \item[\PValue{dottedtocline}] entspricht dem Stil, der von den Standardklassen - \Class{book} und \Class{report} für die Inhaltsverzeichniseinträge der + \Class{book} und \Class{report} für die Inhaltsverzeichniseinträge der Ebenen \PValue{section} bis \PValue{subparagraph} und bei allen - Standardklassen für die Einträge in das Abbildungs- und das + Standardklassen für die Einträge in das Abbildungs- und das Tabellenverzeichnis bekannt ist. Er kennt nur drei\important{\PValue{level}, - \PValue{indent}, \PValue{numwidth}} Eigenschaften. Die Einträge werden + \PValue{indent}, \PValue{numwidth}} Eigenschaften. Die Einträge werden um \PValue{indent} von links eingezogen in der aktuellen Schrift ausgegeben. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die Breite der Nummer wird von \PValue{numwidth} bestimmt. Bei mehrzeiligen - Einträgen wird der Einzug ab der zweiten Zeile um \PValue{numwidth} - erhöht. Die Seitenzahl wird mit \Macro{normalfont} ausgegeben. Eintragstext + Einträgen wird der Einzug ab der zweiten Zeile um \PValue{numwidth} + erhöht. Die Seitenzahl wird mit \Macro{normalfont} ausgegeben. Eintragstext und Seitenzahl werden durch eine punktierte Linie verbunden. \autoref{fig:tocbasic.dottedtocline} illustriert die Eigenschaften des Stils. @@ -987,7 +997,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \setlength{\parindent}{-3.2em}% \addtolength{\parfillskip}{-2.55em}% \makebox[3.2em][l]{1.1.10}% - Überschrift im Verzeichniseintragsstil \PValue{dottedtocline} mit + Ãœberschrift im Verzeichniseintragsstil \PValue{dottedtocline} mit mehr als einer Zeile% \leaders\hbox{$\csname m@th\endcsname \mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak @@ -1020,39 +1030,39 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \PValue{dottedtocline}} \label{fig:tocbasic.dottedtocline} \end{figure} -\item[\PValue{gobble}] ist der denkbar einfachste Stil. Einträge in diesem - Stil werden unabhängig von allen Einstellungen für +\item[\PValue{gobble}] ist der denkbar einfachste Stil. Einträge in diesem + Stil werden unabhängig von allen Einstellungen für \DescRef{\LabelBase.counter.tocdepth}% \IndexCounter{tocdepth}\important{\DescRef{\LabelBase.counter.tocdepth}} - nicht ausgegeben sondern sozusagen verschluckt. Dennoch verfügt er über die + nicht ausgegeben sondern sozusagen verschluckt. Dennoch verfügt er über die Standardeigenschaft \PValue{level}, die jedoch nie ausgewertet wird. \item[\PValue{largetocline}] entspricht dem Stil, der von den Standardklassen - für die Ebene \PValue{part} bekannt ist. Er kennt + für die Ebene \PValue{part} bekannt ist. Er kennt nur\important{\PValue{level}, \PValue{indent}} die Eigenschaften \PName{level} und \PName{indent}. Letzteres ist gleichsam eine Abweichung - von den Standardklassen, die selbst keinen Einzug der \PValue{part}-Einträge - unterstützen. + von den Standardklassen, die selbst keinen Einzug der \PValue{part}-Einträge + unterstützen. - Vor dem Eintrag wird ein Seitenumbruch erleichtert. Die Einträge werden um + Vor dem Eintrag wird ein Seitenumbruch erleichtert. Die Einträge werden um \PValue{indent} von links eingezogen und mit den Schrifteinstellungen \Macro{large}\Macro{bfseries} ausgegeben. Sollte \DescRef{\LabelBase.cmd.numberline} verwendet werden, so ist die Nummernbreite fest auf 3\Unit{em} eingestellt. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die - Standardklassen verwenden für \PName{part}-Einträge kein - \DescRef{\LabelBase.cmd.numberline}. Der Wert hat bei mehrzeiligen Einträgen + Standardklassen verwenden für \PName{part}-Einträge kein + \DescRef{\LabelBase.cmd.numberline}. Der Wert hat bei mehrzeiligen Einträgen auch keine Auswirkung auf den Einzug ab der zweiten Zeile. \autoref{fig:tocbasic.largetocline} illustriert die Eigenschaften - des Stils. Dabei wird auch auf"|fällig, dass der Stil einige Ungereimtheiten - der Standardklassen übernommen hat, beispielsweise der fehlende Einzug ab - der zweiten Zeile bei mehrzeiligen Einträgen und zwei unterschiedliche Werte - für \Macro{@pnumwidth}, die aus einer Abhängigkeit von der Schriftgröße + des Stils. Dabei wird auch auf"|fällig, dass der Stil einige Ungereimtheiten + der Standardklassen übernommen hat, beispielsweise der fehlende Einzug ab + der zweiten Zeile bei mehrzeiligen Einträgen und zwei unterschiedliche Werte + für \Macro{@pnumwidth}, die aus einer Abhängigkeit von der Schriftgröße resultieren. Daraus resultiert auch der Umstand, dass im Extremfall der Text - der Überschrift der Seitenzahl zu nahe kommen kann. Es ist zu beachten, dass + der Ãœberschrift der Seitenzahl zu nahe kommen kann. Es ist zu beachten, dass die in der Abbildung gezeigte Breite der Gliederungsnummer nur dann - Verwendung findet, wenn auch tatsächlich \DescRef{\LabelBase.cmd.numberline} + Verwendung findet, wenn auch tatsächlich \DescRef{\LabelBase.cmd.numberline} verwendet wird. Die Standardklassen setzen hingegen einen festen Abstand von 1\Unit{em} nach der Nummer. \begin{figure} @@ -1066,7 +1076,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \parbox[t]{\dimexpr \linewidth-1.55em\relax}{% \makebox[3em][l]{\large\bfseries I}% \large\bfseries - Überschrift im Verzeichniseintragsstil \PValue{largetocline} mit + Ãœberschrift im Verzeichniseintragsstil \PValue{largetocline} mit mehr als einer Zeile\hfill \makebox[0pt][l]{\normalsize\normalfont \makebox[1.55em][r]{\large\bfseries 1}}% @@ -1090,39 +1100,40 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \PValue{largetocline}} \label{fig:tocbasic.largetocline} \end{figure} -\item[\PValue{tocline}] ist ein flexibler Stil, der in der Voreinstellung für - alle Einträge der \KOMAScript-Klassen verwendet wird. Entsprechend +\item[\PValue{tocline}] ist ein flexibler Stil, der in der Voreinstellung für + alle Einträge der \KOMAScript-Klassen verwendet wird. Entsprechend definieren diese Klassen auch die Klone \PValue{part}, \PValue{chapter} und \PValue{section} beziehungsweise \PValue{section} und \PValue{subsection} - mit Hilfe dieses Stils, ändern dann jedoch den \PName{Initialisierungscode} + mit Hilfe dieses Stils, ändern dann jedoch den \PName{Initialisierungscode} der Klone so ab, dass sie unterschiedliche Voreinstellungen besitzen. Der Stil kennt neben der Standardeigenschaft \PValue{level} noch - 16\important{\PValue{level}, \PValue{beforeskip}, \PValue{breakafternumber}, + 18\important{\PValue{level}, \PValue{beforeskip}, \PValue{breakafternumber}, \PValue{dynnumwidth}, \PValue{entryformat}, \PValue{entrynumberformat}, \PValue{indent}, \PValue{linefill}, \PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel}, \PValue{onstartlowerlevel}, \PValue{onstartsamelevel}, \PValue{pagenumberbox}, - \PValue{pagenumberformat}, \PValue{raggedentrytext}, - \PValue{raggedpagenumber}} weitere Eigenschaften. Die Voreinstellungen all - dieser Eigenschaften werden abhängig vom Namen der \PName{Eintragsebene} - bestimmt und orientieren sich dann an den Ergebnissen der - Standardklassen. Es ist daher möglich, nach Laden von \Package{tocbasic} den - Stil der Inhaltsverzeichniseinträge der Standardklassen mit - \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} in \PValue{tocline} zu ändern, - ohne dass dies unmittelbar zu größeren Veränderungen im Aussehen der - Inhaltsverzeichniseinträge führt. So kann man gezielt nur die Eigenschaften - ändern, die für erwünschte Änderungen notwendig sind. Dasselbe gilt für - Abbildungs- und Tabellenverzeichnis der Standardklassen.% - - Aufgrund der hohen Flexibilität kann dieser Stil prinzipiell die Stile + \PValue{pagenumberformat}, \PValue{pagenumberwidth}, + \PValue{raggedentrytext}, \PValue{raggedpagenumber}, \PValue{rightindent}} + weitere Eigenschaften. Die Voreinstellungen all dieser Eigenschaften werden + abhängig vom Namen der \PName{Eintragsebene} bestimmt und orientieren sich + dann an den Ergebnissen der Standardklassen. Es ist daher möglich, nach + Laden von \Package{tocbasic} den Stil der Inhaltsverzeichniseinträge der + Standardklassen mit \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} in + \PValue{tocline} zu ändern, ohne dass dies unmittelbar zu größeren + Veränderungen im Aussehen der Inhaltsverzeichniseinträge führt. So kann man + gezielt nur die Eigenschaften ändern, die für erwünschte Änderungen + notwendig sind. Dasselbe gilt für Abbildungs- und Tabellenverzeichnis der + Standardklassen.% + + Aufgrund der hohen Flexibilität kann dieser Stil prinzipiell die Stile \PValue{dottedtocline}, \PValue{undottedtocline} und \PValue{largetocline} - ersetzen, bedarf dann jedoch teilweise eines höheren Aufwands bei der + ersetzen, bedarf dann jedoch teilweise eines höheren Aufwands bei der Konfiguration. - \autoref{fig:tocbasic.tocline} illustriert einige Längen-Eigenschaften des + \autoref{fig:tocbasic.tocline} illustriert einige Längen-Eigenschaften des Stils. Die weiteren sind in \autoref{tab:tocbasic.tocstyle.attributes}, ab - \autopageref{tab:tocbasic.tocstyle.attributes} erklärt. + \autopageref{tab:tocbasic.tocstyle.attributes} erklärt. \begin{figure} \centering \resizebox{.8\linewidth}{!}{% @@ -1148,7 +1159,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \setlength{\parindent}{-3em}% \addtolength{\parfillskip}{-2.55em}% \makebox[3em][l]{\large\bfseries I.}% - \textbf{\large Überschrift eines Teil-Eintrags im Stil + \textbf{\large Ãœberschrift eines Teil-Eintrags im Stil \PValue{tocline} zur Demonstration mit mehr als einer Zeile}% \hfill \makebox[1.55em][r]{\bfseries 12}\large @@ -1179,7 +1190,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \setlength{\parindent}{-1.5em}% \addtolength{\parfillskip}{-2.55em}% \makebox[1.5em][l]{\bfseries 1.}% - \textbf{Überschrift eines Kapiteleintrags im Stil + \textbf{Ãœberschrift eines Kapiteleintrags im Stil \PValue{tocline} zur Demonstration mit mehr als einer Zeile}% \hfill \makebox[1.55em][r]{\bfseries 12}% @@ -1216,7 +1227,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \setlength{\parindent}{-2.3em}% \addtolength{\parfillskip}{-2.55em}% \makebox[2.3em][l]{1.1.}% - Überschrift eines Abschnitteintrags im Stil + Ãœberschrift eines Abschnitteintrags im Stil \PValue{tocline} zur Demonstration mit mehr als einer Zeile% \leaders\hbox{$\csname m@th\endcsname \mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak @@ -1230,7 +1241,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \setlength{\parindent}{-3.2em}% \addtolength{\parfillskip}{-2.55em}% \makebox[3.2em][l]{1.1.10.}% - Überschrift eines Unterabschnitteintrags im Stil + Ãœberschrift eines Unterabschnitteintrags im Stil \PValue{tocline} mit mehr als einer Zeile% \leaders\hbox{$\csname m@th\endcsname \mkern 4.5mu\hbox{.}\mkern 4.5mu$}\hfill\nobreak @@ -1267,19 +1278,35 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \PValue{tocline}} \label{fig:tocbasic.tocline} \end{figure} +\item[\PValue{toctext}]\ChangedAt{v3.27}{\Package{tocbasic}}% + stellt eine Besonderheit dar. Während alle anderen Stile je Eintrag einen + Absatz erzeugen, wird hier für alle aufeinanderfolgenden Einträge dieses + Stils nur ein einziger Absatz erzeugt. Für die Konfigurierung stehen neben + der Standardeigenschaft \PValue{level} mit 13\important{\PValue{afterpar}, + \PValue{entryformat}, \PValue{entrynumberformat}, \PValue{indent}, + \PValue{numsep}, \PValue{onendentry}, \PValue{onendlastentry}, + \PValue{onstartentry}, \PValue{onstartfirstentry}, + \PValue{pagenumberformat}, \PValue{prepagenumber}, \PValue{raggedright}, + \PValue{rightindent}} weiteren Eigenschaften fast so viele Möglichkeiten + wie bei \PValue{tocline} zur Verfügung. Dieser Stil ist aber zwingend darauf + angewiesen, dass am Anfang aller anderen Stile und auch am Ende des + Verzeichnisses ein noch nicht beendeter Absatz tasächlich beendet + wird. Daher sollten Einträge dieses Stils nicht mit Einträgen oder + Verzeichnissen kombiniert werden, die an \Package{tocbasic} vorbei erzeugt + werden. \item[\PValue{undottedtocline}] entspricht dem Stil, der von den - Standardklassen \Class{book} und \Class{report} für die Ebene - \PValue{chapter} und von \Class{article} für die Ebene \PValue{section} + Standardklassen \Class{book} und \Class{report} für die Ebene + \PValue{chapter} und von \Class{article} für die Ebene \PValue{section} bekannt ist. Er kennt\important{\PValue{level}, \PValue{indent}, \PValue{numwidth}} nur drei Eigenschaften. Vor dem Eintrag wird ein Seitenumbruch erleichtert und ein vertikaler - Abstand eingefügt. Die Einträge werden um \PValue{indent} von links + Abstand eingefügt. Die Einträge werden um \PValue{indent} von links eingezogen in \Macro{bfseries} ausgegeben. Dies ist gleichsam eine - Abweichung von den Standardklassen, die selbst keinen Einzug für Einträge + Abweichung von den Standardklassen, die selbst keinen Einzug für Einträge der genannten Ebenen bieten. \DescRef{\LabelBase.cmd.numberline} wird nicht umdefiniert. Die Breite der Nummer wird von \PValue{numwidth} bestimmt. Bei - mehrzeiligen Einträgen wird der Einzug ab der zweiten Zeile um - \PValue{numwidth} erhöht. \autoref{fig:tocbasic.undottedtocline} illustriert + mehrzeiligen Einträgen wird der Einzug ab der zweiten Zeile um + \PValue{numwidth} erhöht. \autoref{fig:tocbasic.undottedtocline} illustriert die Eigenschaften des Stils. \begin{figure} \centering @@ -1293,7 +1320,7 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \makebox[1.5em][l]{\bfseries 1}% \parbox[t]{\dimexpr \linewidth-4.05em\relax}{% \bfseries - Überschrift im Verzeichniseintragsstil \PValue{undottedtocline} mit + Ãœberschrift im Verzeichniseintragsstil \PValue{undottedtocline} mit mehr als einer Zeile% }% \raisebox{-\baselineskip}{\makebox[2.55em][r]{\bfseries 3}}% @@ -1316,220 +1343,293 @@ Derzeit werden von \Package{tocbasic} die folgenden Eintragsstile definiert: \end{tikzpicture}% } \caption{Illustration einiger Attribute des Verzeichniseintragsstils - \PValue{undottedtocline} am Beispiel einer Kapitelüberschrift} + \PValue{undottedtocline} am Beispiel einer Kapitelüberschrift} \label{fig:tocbasic.undottedtocline} \end{figure} \end{description} -Eine Erklärung zu den Eigenschaften der von \Package{tocbasic} definierten +Eine Erklärung zu den Eigenschaften der von \Package{tocbasic} definierten Stile findet sich in \autoref{tab:tocbasic.tocstyle.attributes}. -Bei\ChangedAt{v3.21}{\Package{tocbasic}} Verwendung der Eigenschaften -als Optionen für -\DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC} (siehe -\DescPageRef{\LabelBase.cmd.DeclareNewTOC}) sind die Namen der Eigenschaften -mit dem Präfix \PValue{tocentry}, also beispielsweise \Option{tocentrylevel} -anstelle von \PValue{level}, zu -verwenden. Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung als -Optionen für \DescRef{maincls-experts.cmd.DeclareSectionCommand}% +Neben\ChangedAt{v3.27}{\Package{tocbasic}} der normalen Zuweisung eines Wertes +in der Form \Option{\PName{Schlüssel}=\PName{Wert}} verstehen beide Befehle für +die durch \KOMAScript{} definierten Stile für alle Optionen auch die +Zuweisungen in der Form \Option{\PName{Schlüssel}:=\PName{Eintragsebene}}. In +diesem Fall wird die aktuell gültige Einstellung für \PName{Eintragsebene} +kopiert, soweit diese verfügbar ist. Es kann also beispielsweise mit +\OptionValue{indent:}{figure} der Einzug für \PValue{figure}-Einträge kopiert +werden. Für Optionen, die eine Länge oder einen Integer als \PName{Wert} +erwarten, gibt es außerdem die Möglichkeit mit +\Option{\PName{Schlüssel}+=\PName{Wert}} den \PName{Wert} zur aktuell gültigen +Einstellung zu addieren. Für eine Substraktion kann ein negativer \PName{Wert} +verwendet werden. Mit \OptionValue{indent+}{1cm} könnte so beispielsweise der +Einzug um 1\Unit{cm} erhöht werden. + +Bei\ChangedAt{v3.21}{\Package{tocbasic}} Verwendung der Eigenschaften als +Optionen für \DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC} +(siehe \DescPageRef{\LabelBase.cmd.DeclareNewTOC}) sind die Namen der +Eigenschaften mit dem Präfix \PValue{tocentry}, also beispielsweise +\Option{tocentrylevel} anstelle von \PValue{level}, zu verwenden. Die zuvor +beschriebene Kopiermöglichkeit mit \Option{:=} ist hierbei ebenfalls +verfügbar. Die Addition mit Hilfe von \Option{+=} wird derzeit jedoch nicht +unterstützt. + +Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung als Optionen +für \DescRef{maincls-experts.cmd.DeclareSectionCommand}% \IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}% \IndexCmd{RedeclareSectionCommand}\IndexCmd{ProvideSectionCommand} (siehe \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) und verwandten -Anweisungen sind die Namen der Eigenschaften mit dem Präfix \PValue{toc} zu +Anweisungen sind die Namen der Eigenschaften mit dem Präfix \PValue{toc} zu versehen, also beispielsweise \Option{toclevel} anstelle von \PValue{level} zu -verwenden. +verwenden. Hierbei existiert derzeit weder die Kopiermöglichkeit mit +\Option{:=} noch die Addition mit \Option{+=}. -Letztlich führt der Aufruf von \Macro{DeclareTOCStyleEntry} zur Definition der +Letztlich führt der Aufruf von \Macro{DeclareTOCStyleEntry} zur Definition der Anweisung \Macro{l@\PName{Eintragsebene}}. \begin{desclist} \desccaption{% - Attribute für die vordefinierten Verzeichniseintragsstile von + Attribute für die vordefinierten Verzeichniseintragsstile von \Package{tocbasic}% \label{tab:tocbasic.tocstyle.attributes}% }{% Attribute der Verzeichniseintragsstile (\emph{Fortsetzung})% }% - \entry{\OptionVName{beforeskip}{Länge}}{% + \entry{\OptionVName{afterpar}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Der angegebene \PName{Code} wird nach dem Ende des Absatzes ausgeführt, in + dem ein Eintrag mit dem Stil \PValue{toctext} ausgegeben wird. Verfügen + mehrere Einträge über solche Einstellungen, so werden diese in der + Reihenfolge der Einträge ausgeführt.% + }% + \entry{\OptionVName{beforeskip}{Länge}}{% Vertikaler Abstand, der vor einem Eintrag dieser Ebene im Stil - \PValue{tocline} eingefügt wird (siehe \autoref{fig:tocbasic.tocline}). Der - Abstand wird je nach Ebene mit \Macro{vskip} oder \Macro{addvspace} - eingefügt, so dass diesbezüglich möglichst Kompatibilität zu den - Standardklassen und früheren Versionen von \KOMAScript{} besteht. + \PValue{tocline} eingefügt wird (siehe + \autoref{fig:tocbasic.tocline}). Der Abstand wird je nach Ebene mit + \Macro{vskip} oder \Macro{addvspace} eingefügt, so dass diesbezüglich + möglichst Kompatibilität zu den Standardklassen und früheren Versionen von + \KOMAScript{} besteht. Bei der \PName{Eintragsebene} \PValue{part} wird das Attribut mit \texttt{2.25em plus 1pt} initialisiert, bei \PValue{chapter} mit \texttt{1em plus 1pt}. Ist noch keine \PName{Eintragsebene} - \PValue{chapter} bekannt, wird stattdessen für \PValue{section} + \PValue{chapter} bekannt, wird stattdessen für \PValue{section} \texttt{1em plus 1pt} verwendet. Ansonsten wird \PValue{section} wie alle anderen Ebenen mit \texttt{0pt plus .2pt} initialisiert.% }% \entry{\OptionVName{breakafternumber}{Schalter}}{% - \PName{Schalter} ist einer der Werte für einfache Schalter aus + \PName{Schalter} ist einer der Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Ist der Schalter beim Stil \PValue{tocline} aktiviert, so wird nach der mit \DescRef{\LabelBase.cmd.numberline}\IndexCmd{numberline} gesetzten Nummer - eine neue Zeile begonnen, die erneut linksbündig mit der Nummer beginnt. + eine neue Zeile begonnen, die erneut linksbündig mit der Nummer beginnt. In der Voreinstellung ist die Eigenschaft im Stil \PValue{tocline} nicht gesetzt. Ist %\textnote{Achtung!} - für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft + für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft \Option{numberline} gesetzt (siehe \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), wie dies bei den \KOMAScript-Klassen und Verwendung deren Option \OptionValueRef{maincls}{toc}{numberline}% - \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch - dazu, dass bei nicht nummerierten Einträgen dennoch die Zeile mit der dann + \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch + dazu, dass bei nicht nummerierten Einträgen dennoch die Zeile mit der dann leeren Nummer in der Formatierung von \Option{entrynumberformat} gesetzt wird.% }% \entry{\OptionVName{dynnumwidth}{Schalter}}{% - \PName{Schalter} ist einer der Werte für einfache Schalter aus + \PName{Schalter} ist einer der Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Ist der Schalter beim Stil \PValue{tocline} aktiviert, gibt die Eigenschaft - \PValue{numwidth} nur noch einen Minimalwert an. Übertrifft die beim + \PValue{numwidth} nur noch einen Minimalwert an. Ãœbertrifft die beim letzten \LaTeX-Lauf ermittelte maximale Breite der Eintragsnummern - gleicher Ebene zuzüglich des Wertes von \PValue{numsep} diesen + gleicher Ebene zuzüglich des Wertes von \PValue{numsep} diesen Minimalwert, so wird stattdessen der ermittelte Wert verwendet.% }% \entry{\OptionVName{entryformat}{Befehl}}{% - Über diese Eigenschaft kann die Formatierung des gesamten Eintrags - verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau + Ãœber diese Eigenschaft kann die Formatierung des gesamten Eintrags + verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau ein Argument zu erwarten. Dieses Argument ist nicht zwingend voll expandierbar. Befehle wie \Macro{MakeUppercase}, die ein voll - expandierbares Argument erwarten, dürfen an dieser Stelle also nicht - verwendet werden. Font-Änderungen über \Option{entryformat} erfolgen + expandierbares Argument erwarten, dürfen an dieser Stelle also nicht + verwendet werden. Font-Änderungen über \Option{entryformat} erfolgen ausgehend von \Macro{normalfont}\Macro{normalsize}. Es wird darauf hingewiesen, dass die Ausgabe von \Option{linefill} und der Seitenzahl - unabhängig von \Option{entryformat} sind. Siehe dazu auch die Eigenschaft + unabhängig von \Option{entryformat} sind. Siehe dazu auch die Eigenschaft \Option{pagenumberformat}. - Initialisiert wird die Eigenschaft für die \PName{Eintragsebene} - \PValue{part} mit der Ausgabe des übergebenen Argument in - \Macro{large}\Macro{bfseries} und für \PValue{chapter} in + Initialisiert wird die Eigenschaft für die \PName{Eintragsebene} + \PValue{part} mit der Ausgabe des übergebenen Argument in + \Macro{large}\Macro{bfseries} und für \PValue{chapter} in \Macro{bfseries}. Falls bei der Initialisierung von \PValue{section} noch - keine Ebene \PValue{chapter} existiert, wird auch für diese Ebene + keine Ebene \PValue{chapter} existiert, wird auch für diese Ebene \Macro{bfseries} verwendet. Bei allen anderen Ebenen wird das Argument - unverändert ausgegeben.% + unverändert ausgegeben.% }% \entry{\OptionVName{entrynumberformat}{Befehl}}{% - Über diese Eigenschaft kann die Formatierung der mit - \DescRef{\LabelBase.cmd.numberline} gesetzten Eintragsnummer verändert + Ãœber diese Eigenschaft kann die Formatierung der mit + \DescRef{\LabelBase.cmd.numberline} gesetzten Eintragsnummer verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau ein - Argument zu erwarten. Font-Änderungen erfolgen ausgehend von der + Argument zu erwarten. Font-Änderungen erfolgen ausgehend von der Eigenschaft \Option{entryformat}. - Initialisiert wird die Eigenschaft mit Ausgabe des übergebenen - Arguments. Die Eintragsnummer wird also unverändert ausgegeben. + Initialisiert wird die Eigenschaft mit Ausgabe des übergebenen + Arguments. Die Eintragsnummer wird also unverändert ausgegeben. Ist %\textnote{Achtung!} - für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft + für ein Verzeichnis mit \DescRef{\LabelBase.cmd.setuptoc} die Eigenschaft \Option{numberline} gesetzt (siehe \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}), wie dies bei den \KOMAScript-Klassen und Verwendung deren Option \OptionValueRef{maincls}{toc}{numberline}% - \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch - dazu, dass bei nicht nummerierten Einträgen \PName{Befehl} dennoch - ausgeführt wird.% + \IndexOption{toc~=\textKValue{numberline}} der Fall ist, führt dies auch + dazu, dass bei nicht nummerierten Einträgen \PName{Befehl} dennoch + ausgeführt wird.% }% - \entry{\OptionVName{indent}{Länge}}{% - Horizontaler Abstand des Eintrags vom linken Rand (siehe - \autoref{fig:tocbasic.dottedtocline} und \autoref{fig:tocbasic.tocline}). - - Beim Stil \PValue{tocline} wird für alle Eintragsebenen, deren Name mit - »\texttt{sub}« beginnt, eine Initialisierung mit - \PValue{indent}+\PValue{numwidth} der gleichnamigen Eintragsebene ohne - diesen Präfix vorgenommen, falls eine solche Ebene mit entsprechenden - Eigenschaften existiert. Bei den Stilen \PValue{dottedtocline}, - \PValue{undottedtocline} und \PValue{tocline} findet für die - Eintragsebenen \PValue{part} bis \PValue{subparagraph} sowie - \PValue{figure} und \PValue{table} eine Initialisierung mit Werten + \entry{% + \OptionVName{indent}{Länge}% + {\phantomsection\label{tab:tocbasic.tocstyle.attributes.indent}}% + }{% + Beim\ChangedAt{v3.27}{\Package{tocbasic}} Stil \PValue{toctext} ist + \PName{Länge} der horizontale Abstand des Absatzes vom linken Rand. Haben + die unterschiedlichen Einträge des Absatzes unterschiedliche + Einstellungen, so gewinnt der letzte Eintrag. Bei den übrigen Stilen ist + \PValue{Länge} entsprechend der horizontale Abstand des Eintrags vom + linken Rand (siehe \autoref{fig:tocbasic.dottedtocline} und + \autoref{fig:tocbasic.tocline}). + + Bei den Stilen \PValue{tocline} und \PValue{toctext} wird für alle + Eintragsebenen, deren Name mit »\texttt{sub}« beginnt, eine + Initialisierung mit \PValue{indent}+\PValue{numwidth} der gleichnamigen + Eintragsebene ohne diesen Präfix vorgenommen, falls eine solche Ebene mit + entsprechenden Eigenschaften existiert. Bei den Stilen + \PValue{dottedtocline}, \PValue{undottedtocline} und \PValue{tocline} + findet für die Eintragsebenen \PValue{part} bis \PValue{subparagraph} + sowie \PValue{figure} und \PValue{table} eine Initialisierung mit Werten entsprechend der Standardklassen statt. Alle anderen Ebenen erhalten keine - Initialisierung. Für sie ist eine explizite Angabe daher bei der ersten - Verwendung zwingend.% + Initialisierung. Für sie ist eine explizite Angabe daher bei der ersten + Verwendung zwingend. + + Ist für ein Verzeichnis die Eigenschaft \PValue{noindent} via + \DescRef{\LabelBase.cmd.setuptoc} gesetzt, so ignorieren die Einträge bei + allen von \KOMAScript{} bereitgestellten Stilen diesen Wert und verwenden + stattdessen 0\Unit{pt}. Der Einzug wird also deaktiviert.% }% \entry{\OptionVName{level}{Integer}}{% - Nummerischer Wert der \PName{Eintragsebene}. Tatsächlich angezeigt werden - nur Einträge, deren nummerische Ebene nicht größer als Zähler + Nummerischer Wert der \PName{Eintragsebene}. Tatsächlich angezeigt werden + nur Einträge, deren nummerische Ebene nicht größer als Zähler \DescRef{\LabelBase.counter.tocdepth}% %\important{\DescRef{\LabelBase.counter.tocdepth}} \IndexCounter{tocdepth} ist. - Diese Eigenschaft ist für alle Stile zwingend und wird bei der + Diese Eigenschaft ist für alle Stile zwingend und wird bei der Definition eines Stils automatisch definiert. - Beim Stil \PValue{tocline} findet für alle Eintragsebenen, deren Name - mit »\texttt{sub}« beginnt, eine Initialisierung entsprechend dem - um eins erhöhten Wert einer gleichnamigen Eintragsebene ohne - diesen Präfix statt, falls eine solche Ebene existiert. Bei den Stilen - \PValue{dottedtocline}, \PValue{largetocline}, \PValue{tocline} und - \PValue{undottedtocline} findet für die \PName{Eintragsebene} - \PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection}, - \PValue{subsubsection}, \PValue{paragraph}, \PValue{subparagraph}, - \PValue{figure} und \PValue{table} automatisch eine Initialisierung - aufgrund des Namens statt. Für andere Ebenen findet eine Initialisierung - mit dem Wert der Gliederungsebene statt, falls kompatibel zu den - \KOMAScript-Klassen \Macro{\PName{Eintragsebene}numdepth} definiert - ist.% + Beim Stil \PValue{tocline} und \PValue{toctext} findet für alle + Eintragsebenen, deren Name mit »\texttt{sub}« beginnt, eine + Initialisierung entsprechend dem um eins erhöhten Wert einer gleichnamigen + Eintragsebene ohne diesen Präfix statt, falls eine solche Ebene + existiert. Bei den Stilen \PValue{dottedtocline}, \PValue{largetocline}, + \PValue{tocline}, \PValue{toctext} und \PValue{undottedtocline} findet für + die \PName{Eintragsebene} \PValue{part}, \PValue{chapter}, + \PValue{section}, \PValue{subsection}, \PValue{subsubsection}, + \PValue{paragraph}, \PValue{subparagraph}, \PValue{figure} und + \PValue{table} automatisch eine Initialisierung aufgrund des Namens + statt. Für andere Ebenen findet eine Initialisierung mit dem Wert der + Gliederungsebene statt, falls kompatibel zu den \KOMAScript-Klassen + \Macro{\PName{Eintragsebene}numdepth} definiert ist.% }% \entry{\OptionVName{linefill}{Code}}{% Beim Stil \PValue{tocline} kann zwischen dem Ende des Eintragstextes und - der Seitenzahl die Art der Füllung verändert werden. Die Eigenschaft - \PName{linefill} erhält als Wert direkt den gewünschten \PName{Code}. - Für \PName{Eintragsebene} \PValue{part} und \PValue{chapter} wird die - Eigenschaft mit \Macro{hfill} initialisiert. Dadurch rückt die Seitenzahl + der Seitenzahl die Art der Füllung verändert werden. Die Eigenschaft + \PName{linefill} erhält als Wert direkt den gewünschten \PName{Code}. Für + \PName{Eintragsebene} \PValue{part} und \PValue{chapter} wird die + Eigenschaft mit \Macro{hfill} initialisiert. Dadurch rückt die Seitenzahl an den rechten Rand. Ist bisher keine \PName{Eintragsebene} - \PValue{chapter} definiert, so gilt dies auch für \PValue{section}. Alle - anderen Ebenen werden mit \DescRef{\LabelBase.cmd.TOCLineLeaderFill} (siehe - \DescPageRef{\LabelBase.cmd.TOCLineLeaderFill}) initialisiert. + \PValue{chapter} definiert, so gilt dies auch für \PValue{section}. Alle + anderen Ebenen werden mit \DescRef{\LabelBase.cmd.TOCLineLeaderFill} + (siehe \DescPageRef{\LabelBase.cmd.TOCLineLeaderFill}) initialisiert. - Wird \PName{Code} angegeben, der nicht automatisch zu einer Füllung des - Abstandes führt, sollte übrigens auch die Eigenschaft + Wird \PName{Code} angegeben, der nicht automatisch zu einer Füllung des + Abstandes führt, sollte übrigens auch die Eigenschaft \PValue{raggedpagenumber} gesetzt werden, damit es nicht zu - »\texttt{underfull \Macro{hbox}}«-Meldungen kommt.% + »\texttt{underfull \Macro{hbox}}«-Meldungen kommt.% }% - \entry{\OptionVName{numsep}{Länge}}{% + \entry{\OptionVName{numsep}{Länge}}{% Der Stil \PValue{tocline} versucht sicherzustellen, dass zwischen der Nummer und dem Text eines Eintrags mindestens ein Abstand von - \PName{Länge} eingehalten wird. Bei aktiviertem \PValue{dynnumwidth} kann - die für die Nummer reservierte Breite \PValue{numwidth} entsprechend + \PName{Länge} eingehalten wird. Bei aktiviertem \PValue{dynnumwidth} kann + die für die Nummer reservierte Breite \PValue{numwidth} entsprechend korrigiert werden. Bei nicht aktiviertem \PValue{dynnumwidth} wird hingegen lediglich eine Warnung ausgegeben, wenn diese Bedingung nicht eingehalten wird. + Der\ChangedAt{v3.27}{\Package{tocbasic}} Stil \PValue{toctext} fügt + dagegen immer einen Abstand dieser \PName{Länge} nach der Nummer des + Eintrags ein. + Die Eigenschaft wird mit einem Wert von 0,4\Unit{em} initialisiert.% }% - \entry{\OptionVName{numwidth}{Länge}}{% - Für die Nummer eines Eintrags reservierte Breite (siehe + \entry{\OptionVName{numwidth}{Länge}}{% + Für die Nummer eines Eintrags reservierte Breite (siehe \autoref{fig:tocbasic.dottedtocline} bis \autoref{fig:tocbasic.undottedtocline}). Dieser Wert wird bei den Stilen \PValue{dottedtocline}, \PValue{tocline} und \PValue{undottedtocline} ab der zweiten Zeile eines Eintrags zum linken Einzug hinzugerechnet. - Beim Stil \PValue{tocline} wird für alle Eintragsebenen, deren Name mit - »\texttt{sub}« beginnt, eine Initialisierung mit dem Wert der - gleichnamigen Eintragsebene ohne diesen Präfix zuzüglich 0,9\Unit{em} - vorgenommen, falls eine solche Ebene mit entsprechender - Eigenschaften existiert. Bei den Stilen \PValue{dottedtocline}, - \PValue{undottedtocline} und \PValue{tocline} findet für die - Eintragsebenen \PValue{part} bis \PValue{subparagraph} sowie - \PValue{figure} und \PValue{table} eine Initialisierung mit Werten - entsprechend der Standardklassen statt. Alle anderen Ebenen erhalten keine - Initialisierung. Für sie ist eine explizite Angabe daher bei der - ersten Verwendung zwingend.% + Beim Stil \PValue{tocline} wird für alle Eintragsebenen, deren Name mit + »\texttt{sub}« beginnt, eine Initialisierung mit dem Wert der + gleichnamigen Eintragsebene ohne diesen Präfix zuzüglich 0,9\Unit{em} + vorgenommen, falls eine solche Ebene mit entsprechender Eigenschaft + existiert. Bei den Stilen \PValue{dottedtocline}, \PValue{undottedtocline} + und \PValue{tocline} findet für die Eintragsebenen \PValue{part} bis + \PValue{subparagraph} sowie \PValue{figure} und \PValue{table} eine + Initialisierung mit Werten entsprechend der Standardklassen statt. Alle + anderen Ebenen erhalten keine Initialisierung. Für sie ist eine explizite + Angabe daher bei der ersten Verwendung zwingend.% + }% + \entry{\OptionVName{onendentry}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Führt den angegebenen \PName{Code} unmittelbar nach einem Eintrag im Stil + \PValue{toctext} aus, sofern es nicht der letzte Eintrag im Absatz + ist. Der Anwender muss unbedingt sicherstellen, dass \PName{Code} auf + keinen Fall zum Beenden des Absatzes führt. + + Hinweis: Tatsächlich wird der \PName{Code} gar nicht am Ende des Eintrags, + sondern vor dem nächsten Eintrag im Stil \PValue{toctext} ausgeführt.% + }% + \entry{\OptionVName{onendlastentry}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Führt den angegebenen \PName{Code} unmittelbar vor dem Ende des Absatzes + mit dem Eintrag im Stil \PValue{toctext} aus, sofern es sich um den + letzten Eintrag im Absatz handelt. Der Anwender sollte sicherstellen, dass + \PName{Code} nicht zum Beenden des Absatzes führt.% + }% + \entry{\OptionVName{onstartentry}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Führt den angegebenen \PName{Code} unmittelbar vor dem Eintrag im Stil + \PValue{toctext} aus, sofern es sich nicht um den ersten Eintrag im Absatz + handelt. Der Anwender muss unbedingt sicherstellen, dass \PName{Code} auf + keinen Fall zum Beenden des Absatzes führt.% + }% + \entry{\OptionVName{onstartfirstentry}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Führt den angegebenen \PName{Code} unmittelbar vor dem Eintrag im Stil + \PValue{toctext} aus, sofern es sich um den ersten Eintrag im Absatz + handelt. Der Anwender sollte sicherstellen, dass \PName{Code} den + Absatz nicht bereits beginnt.% }% \entry{\OptionVName{onstarthigherlevel}{Code}}{% Der Stil \PValue{tocline} kann zu Beginn eines Eintrags eine Aktion in - Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen - höheren, denselben oder einen niedrigeren \PName{level}-Wert - hatte. Im Falle, dass der aktuelle Eintrag einen größeren - \PName{level}-Wert besitzt, in der Hierarchie der Einträge also tiefer - steht, wird der über diese Eigenschaft angegebene \PName{Code} ausgeführt. + Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen + höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im + Falle, dass der aktuelle Eintrag einen größeren \PName{level}-Wert + besitzt, in der Hierarchie der Einträge also tiefer steht, wird der über + diese Eigenschaft angegebene \PName{Code} ausgeführt. - Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} - seit dem letzten Eintrag nicht geändert hat. + Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} + seit dem letzten Eintrag nicht geändert hat. Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} (siehe @@ -1537,90 +1637,123 @@ Anweisung \Macro{l@\PName{Eintragsebene}}. }% \entry{\OptionVName{onstartlowerlevel}{Code}}{% Der Stil \PValue{tocline} kann zu Beginn eines Eintrags eine Aktion in - Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen - höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im + Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen + höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im Falle, dass der aktuelle Eintrag einen kleineren \PName{level}-Wert - besitzt, in der Hierarchie der Einträge also höher steht, wird der über - diese Eigenschaft angegebene \PName{Code} ausgeführt. + besitzt, in der Hierarchie der Einträge also höher steht, wird der über + diese Eigenschaft angegebene \PName{Code} ausgeführt. - Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} - seit dem letzten Eintrag nicht geändert hat. + Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} + seit dem letzten Eintrag nicht geändert hat. Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasHigher} (siehe \DescPageRef{\LabelBase.cmd.LastTOCLevelWasHigher}), was normalerweise - dazu führt, dass ein Umbruch vor dem Eintrag begünstigt wird.% + dazu führt, dass ein Umbruch vor dem Eintrag begünstigt wird.% }% \entry{\OptionVName{onstartsamelevel}{Code}}{% Der Stil \PValue{tocline} kann zu Beginn eines Eintrags eine Aktion in - Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen - höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im + Abhängigkeit davon ausführen, ob der zuletzt gesetzte Eintrag einen + höheren, denselben oder einen niedrigeren \PName{level}-Wert hatte. Im Falle, dass der aktuelle Eintrag denselben \PName{level}-Wert besitzt, in - der Hierarchie der Einträge also gleich gestellt ist, wird der über diese - Eigenschaft angegebene \PName{Code} ausgeführt. + der Hierarchie der Einträge also gleich gestellt ist, wird der über diese + Eigenschaft angegebene \PName{Code} ausgeführt. - Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} - seit dem letzten Eintrag nicht geändert hat. + Die Erkennung funktioniert übrigens nur, solange sich \Macro{lastpenalty} + seit dem letzten Eintrag nicht geändert hat. Initialisiert wird die Eigenschaft mit \DescRef{\LabelBase.cmd.LastTOCLevelWasSame} (siehe \DescPageRef{\LabelBase.cmd.LastTOCLevelWasSame}), was normalerweise dazu - führt, dass ein Umbruch vor dem Eintrag begünstigt wird.% + führt, dass ein Umbruch vor dem Eintrag begünstigt wird.% }% \entry{\OptionVName{pagenumberbox}{Befehl}}{% - Normalerweise wird die zu einem Eintrag gehörende Seitenzahl rechtsbündig + Normalerweise wird die zu einem Eintrag gehörende Seitenzahl rechtsbündig in eine Box der Breite \Macro{@pnumwidth} gesetzt. Beim Stil - \PValue{tocline} kann der Befehl, der dazu verwendet wird, über diese + \PValue{tocline} kann der Befehl, der dazu verwendet wird, über diese Eigenschaft konfiguriert werden. Der dabei anzugebende \PName{Befehl} hat genau ein Argument zu erwarten. - Initialisiert wird die Eigenschaft mit der bereits erwähnten Box.% + Initialisiert wird die Eigenschaft mit der bereits erwähnten Box.% }% \entry{\OptionVName{pagenumberformat}{Befehl}}{% - Über diese Eigenschaft kann die Formatierung der Seitenzahl des Eintrags - verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau - ein Argument zu erwarten. Font-Änderungen über \Option{entryformat} + Ãœber diese Eigenschaft kann die Formatierung der Seitenzahl des Eintrags + verändert werden. Der dabei als Wert angegebene \PName{Befehl} hat genau + ein Argument zu erwarten. Font-Änderungen über \Option{entryformat} erfolgen ausgehend von \Option{entryformat}, gefolgt von \Macro{normalfont}\Macro{normalsize}. - Initialisiert wird die Eigenschaft für die \PName{Eintragsebene} - \PValue{part} mit der Ausgabe des übergebenen Arguments in - \Macro{large}\Macro{bfseries}. Für alle anderen Ebenen erfolgt die Ausgabe + Initialisiert wird die Eigenschaft für die \PName{Eintragsebene} + \PValue{part} mit der Ausgabe des übergebenen Arguments in + \Macro{large}\Macro{bfseries}. Für alle anderen Ebenen erfolgt die Ausgabe in \Macro{normalfont}\Macro{normalcolor}.% }% + \entry{\OptionVName{pagenumberwidth}{Länge}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Mit dieser Eigenschaft kann die Breite der Standardbox für die Seitenzahl + eines Eintrags im Stil \PValue{tocline} von \Macro{@pnumwidth} in die + angegebene \PName{Länge} geändert werden. Es ist zu beachten, dass bei + Änderung des Befehls für die Box über die Eigenschaft + \Option{pagenumberbox} die angegebene \PName{Länge} nicht mehr automatisch + Anwendung findet.% + }% + \entry{\OptionVName{prepagenumber}{Code}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Im Stil \PValue{toctext} wird zwischen dem Eintragstext und der Seitenzahl + \PName{Code} ausgeführt. Dies dient in erster Linie dazu, Abstand oder + Trennzeichen zwischen Text und Seitenzahl einzufügen.% + + Voreingestellt ist mit \Macro{nonbreakspace} ein nicht umbrechbares + Leerzeichen.% + }% \entry{\OptionVName{raggedentrytext}{Schalter}}{% \ChangedAt{v3.21}{\Package{tocbasic}}% - \PName{Schalter} ist einer der Werte für einfache Schalter aus + \PName{Schalter} ist einer der Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Ist der Schalter beim Stil \PValue{tocline} aktiviert, so wird der Text des Eintrags nicht im Blocksatz, sondern im Flattersatz gesetzt. Dabei - werden nur noch Wörter getrennt, die länger als eine Zeile sind. + werden nur noch Wörter getrennt, die länger als eine Zeile sind. In der Voreinstellung ist dieser Schalter nicht gesetzt.% }% \entry{\OptionVName{raggedpagenumber}{Schalter}}{% - \PName{Schalter} ist einer der Werte für einfache Schalter aus + \PName{Schalter} ist einer der Werte für einfache Schalter aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. Ist der Schalter beim Stil \PValue{tocline} aktiviert, so wird die - Seitenzahl nicht zwingend rechtsbündig gesetzt. + Seitenzahl nicht zwingend rechtsbündig gesetzt. Je nach Wert der Eigenschaft \PValue{linefill} kann sich das Setzen dieses Schalters nur im Erscheinen oder Verschwinden einer Warnung - oder auch konkret in der Formatierung der Einträge auswirken. Es ist also + oder auch konkret in der Formatierung der Einträge auswirken. Es ist also wichtig, diese beiden Eigenschaften zueinander passend zu setzen. In der Voreinstellung ist dieser Schalter nicht gesetzt und passt damit zur Initialisierung von \PValue{linefill} sowohl mit \Macro{hfill} als auch mit \DescRef{\LabelBase.cmd.TOCLineLeaderFill}.% }% + \entry{\OptionVName{raggedright}{Schalter}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + \PName{Schalter} ist einer der Werte für einfache Schalter aus + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. + Ist der Schalter innerhalb eines Absatzes bei irgend einem Eintrag im Stil + \PValue{toctext} gesetzt, so wird der komplette Absatz in linksbündigem + Flattersatz gesetzt.% + }% + \entry{\OptionVName{rightindent}{Länge}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Mit dieser Eigenschaft kann der rechte Rand für den Text eines Eintrags im + Stil \PValue{tocline} von \Macro{@tocrmarg} in die angegebene + \PName{Länge} geändert werden. Beim Stil \PValue{toctext} wird + entsprechend der rechte Rand für den kompletten Absatz eingestellt.% + }% \end{desclist} -Während \Macro{DeclareTOCStyleEntry} nur genau eine \PName{Eintragsebene} -definiert, kann über +Während \Macro{DeclareTOCStyleEntry} nur genau eine \PName{Eintragsebene} +definiert, kann über \Macro{DeclareTOCStyeEntries}\ChangedAt{v3.26}{\Package{tocbasic}} auf einen Schlag eine ganze \PName{Liste von Eintragsebenen} definiert werden. Die durch Komma voneinander getrennt angegebenen Eintragsebenen der Liste werden dabei -alle mit demselben \PName{Stil} und den über \PName{Optionenliste} +alle mit demselben \PName{Stil} und den über \PName{Optionenliste} angegebenen Einstellungen definiert.% \EndIndexGroup @@ -1629,76 +1762,76 @@ angegebenen Einstellungen definiert.% \OParameter{Initialisierungscode} \Parameter{Befehlscode} \Macro{DefineTOCEntryOption}\Parameter{Option} - \OParameter{Säumniswert} + \OParameter{Säumniswert} \Parameter{Code} \Macro{DefineTOCEntryBooleanOption}\Parameter{Option} - \OParameter{Säumniswert} - \Parameter{Präfix} + \OParameter{Säumniswert} + \Parameter{Präfix} \Parameter{Postfix} - \Parameter{Erklärung} + \Parameter{Erklärung} %\OParameter{Initialisierungscode} \Macro{DefineTOCEntryCommandOption}\Parameter{Option} - \OParameter{Säumniswert} - \Parameter{Präfix} + \OParameter{Säumniswert} + \Parameter{Präfix} \Parameter{Postfix} - \Parameter{Erklärung} + \Parameter{Erklärung} %\OParameter{Initialisierungscode} \Macro{DefineTOCEntryIfOption}\Parameter{Option} - \OParameter{Säumniswert} - \Parameter{Präfix}% + \OParameter{Säumniswert} + \Parameter{Präfix}% \Parameter{Postfix} - \Parameter{Erklärung} + \Parameter{Erklärung} % \OParameter{Initialisierungscode} \Macro{DefineTOCEntryLengthOption}\Parameter{Option} - \OParameter{Säumniswert} - \Parameter{Präfix} + \OParameter{Säumniswert} + \Parameter{Präfix} \Parameter{Postfix} - \Parameter{Erklärung} + \Parameter{Erklärung} % \OParameter{Initialisierungscode} \Macro{DefineTOCEntryNumberOption}\Parameter{Option} - \OParameter{Säumniswert} - \Parameter{Präfix} + \OParameter{Säumniswert} + \Parameter{Präfix} \Parameter{Postfix} - \Parameter{Erklärung} + \Parameter{Erklärung} % \OParameter{Initialisierungscode} \end{Declaration} -\Macro{DeclareTOCEntryStyle}\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} ist +\Macro{DeclareTOCEntryStyle}\ChangedAt{v3.20}{\Package{tocbasic}} ist eine der komplexesten Anweisungen in \KOMAScript. Sie richtet sich daher -ausdrücklich an \LaTeX-Entwickler und nicht an \LaTeX-Anwender. Mit ihrer -Hilfe ist es möglich, einen neuen \PName{Stil} für Verzeichniseinträge zu -definieren. Üblicherweise werden Verzeichniseinträge mit +ausdrücklich an \LaTeX-Entwickler und nicht an \LaTeX-Anwender. Mit ihrer +Hilfe ist es möglich, einen neuen \PName{Stil} für Verzeichniseinträge zu +definieren. Ãœblicherweise werden Verzeichniseinträge mit \Macro{addcontentsline}\IndexCmd{addcontentsline} oder bei Verwendung von \Package{tocbasic} vorzugsweise mit \DescRef{\LabelBase.cmd.addxcontentsline}\IndexCmd{addxcontentsline} (siehe \autoref{sec:tocbasic.basics}, \DescPageRef{\LabelBase.cmd.addxcontentsline}) -erzeugt. Dabei schreibt \LaTeX{} eine zugehörige Anweisung +erzeugt. Dabei schreibt \LaTeX{} eine zugehörige Anweisung \Macro{contentsline}\IndexCmd{contentsline} in die jeweilige Hilfsdatei. Bei -Einlesen dieser Hilfsdatei führt \LaTeX{} dann für jedes \Macro{contentsline} +Einlesen dieser Hilfsdatei führt \LaTeX{} dann für jedes \Macro{contentsline} eine Anweisung \Macro{l@\PName{Eintragsebene}} aus. -Wird später einer \PName{Eintragsebene} über +Wird später einer \PName{Eintragsebene} über \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} ein \PName{Stil} zugewiesen, so -wird zunächst \PName{Initialisierungscode} ausgeführt falls angegeben und dann -\PName{Befehlscode} für die Definition von \Macro{l@\PName{Eintragsebene}} +wird zunächst \PName{Initialisierungscode} ausgeführt falls angegeben und dann +\PName{Befehlscode} für die Definition von \Macro{l@\PName{Eintragsebene}} verwendet. \PName{Befehlscode} ist also letztlich der Code, der bei -\Macro{l@\PName{Eintragsebene}} ausgeführt wird. Dabei ist \texttt{\#1} der -Name der Eintragsebene, während \texttt{\#\#1} und \texttt{\#\#2} Platzhalter -für die beiden Argumente von \Macro{l@\PName{Eintragsebene}} sind. +\Macro{l@\PName{Eintragsebene}} ausgeführt wird. Dabei ist \texttt{\#1} der +Name der Eintragsebene, während \texttt{\#\#1} und \texttt{\#\#2} Platzhalter +für die beiden Argumente von \Macro{l@\PName{Eintragsebene}} sind. Der \PName{Initialisierungscode} dient einerseits dazu, die Einstellungen eines Stils zu initialisieren. Entwickler\textnote{Empfehlung!} sollten darauf achten, dass wirklich alle Einstellungen hier bereits einen Wert erhalten. Nur dann funktioniert \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry} auch ohne -Angabe einer \PName{Optionenliste} fehlerfrei. Darüber hinaus hat der +Angabe einer \PName{Optionenliste} fehlerfrei. Darüber hinaus hat der \PName{Initialisierungscode} auch alle Optionen, die der jeweilige Stil versteht, zu definieren. Zwingend vordefiniert wird lediglich -\Option{level}. Der eingestellte Wert für \Option{level} kann in +\Option{level}. Der eingestellte Wert für \Option{level} kann in \PName{Befehlscode} mit \Macro{@nameuse}\PParameter{\#1tocdepth}% \important{\Macro{\PName{Eintragsebene}tocdepth}} abgefragt werden, um ihn -beispielsweise mit dem Wert des Zählers +beispielsweise mit dem Wert des Zählers \DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth} zu vergleichen. -Zur Definition neuer Optionen für die Eigenschaften einer +Zur Definition neuer Optionen für die Eigenschaften einer Eintragsebene existieren nur innerhalb von \PName{Initialisierungscode} die Anweisungen \iffree{\Macro{DefineTOCEntryBooleanOption}, \Macro{DefineTOCEntryCommandOption}, \Macro{DefineTOCEntryIfOption}, @@ -1706,17 +1839,31 @@ Anweisungen \iffree{\Macro{DefineTOCEntryBooleanOption}, \Macro{DefineTOCEntryNumberOption}}{\Macro{DefineTOCEntry\dots Option}}. Diese Anweisungen definieren jeweils eine \PName{Option}, die bei ihrem Aufruf eine Anweisung -\Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} mit dem übergebenen -Wert oder bei Fehlen einer Wertzuweisung mit dem \PName{Säumniswert} +\Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} mit dem übergebenen +Wert oder bei Fehlen einer Wertzuweisung mit dem \PName{Säumniswert} definieren. Eine Besonderheit stellt \Macro{DefineTOCEntryIfOption} dar. Diese -definiert \Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} immer als -Anweisung mit zwei Argumenten. Ist der an die Option übergebene Wert einer der +definiert \Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} immer als +Anweisung mit zwei Argumenten. Ist der an die Option übergebene Wert einer der Aktivierungswerte aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}, so expandiert die Anweisung zum ersten -Argument. Ist der an die Option übergebene Wert hingegen ein +Argument. Ist der an die Option übergebene Wert hingegen ein Deaktivierungswert, so expandiert die Anweisung zum zweiten Argument. -Die \PName{Erklärung} sollte ein möglichst kurzer Text sein, der den Sinn der +Neben\ChangedAt{v3.27}{\Package{tocbasic}} den normalen Optionen der Form +\Option{\PName{Schlüssel}=\PName{Wert}} werden von allen fünf +\Macro{DefineTOCEntry\dots Option}-Anweisungen automatisch Optionen der Form +\Option{\PName{Schlüssel}:=\PName{Eintragsebene}} definiert. Diese dienen +dazu, den Wert einer anderen \PName{Eintragsebene} zu kopieren, sofern der +Wert in einem Makro mit gleichem \PName{Präfix} und \PName{Postfix} +gespeichert ist. Bei den von \Package{tocbasic} vordefinierten Stilen ist das +für gleichnamige Optionen über Stilgrenzen hinweg der Fall. Von +\Macro{DefineTOCEntryLengthOption} und \Macro{DefineTOCEntryNumberOption} +werden außerdem Optionen der Form \Option{\PName{Schlüssel}+=\PName{Wert}} mit +definiert, die dazu dienen, zu dem in +\Macro{\PName{Präfix}\PName{Eintragsebene}\PName{Postfix}} bereits +gespeicherten Wert den neuen \PName{Wert} zu addieren. + +Die \PName{Erklärung} sollte ein möglichst kurzer Text sein, der den Sinn der Option mit wenigen Schlagworten beschreibt. Er wird von \Package{tocbasic} bei Fehlermeldungen, Warnungen und Informationen auf dem Terminal und in der \File{log}-Datei ausgegeben. @@ -1725,11 +1872,11 @@ Der einfachste Stil von \Package{tocbasic}, \PValue{gobble}, wurde mit \begin{lstcode} \DeclareTOCEntryStyle{gobble}{}% \end{lstcode} -definiert. Würde man nun mit +definiert. Würde man nun mit \begin{lstcode} \DeclareTOCStyleEntry[level=1]{gobble}{dummy} \end{lstcode} -eine Eintragsebene \PValue{dummy} in diesem Stil definieren, so würde das +eine Eintragsebene \PValue{dummy} in diesem Stil definieren, so würde das unter anderem \begin{lstcode} \def\dummytocdepth{1} @@ -1744,7 +1891,7 @@ Innerhalb von Stil \PValue{tocline} wird beispielsweise {filling between text and page number}% \end{lstcode} verwendet, um Option \Option{linefill} zu definieren. Durch die Angabe von -\DescRef{\LabelBase.cmd.TOCLineLeaderFill} als \PName{Säumniswert} würde ein +\DescRef{\LabelBase.cmd.TOCLineLeaderFill} als \PName{Säumniswert} würde ein Aufruf wie \begin{lstcode} \DeclareTOCStyleEntry[linefill]{tocline}{part} @@ -1755,29 +1902,29 @@ unter anderem die Definition \end{lstcode} vornehmen. -Wer\textnote{Tipp!} sich selbst einen Stil definieren möchte, dem sei -empfohlen, zunächst die Definition des Stils \PValue{dottedtocline} zu +Wer\textnote{Tipp!} sich selbst einen Stil definieren möchte, dem sei +empfohlen, zunächst die Definition des Stils \PValue{dottedtocline} zu studieren. Nachdem dessen Definition verstanden wurde, gibt dann die deutlich komplexere Definition von Stil \PValue{tocline} viele Hinweise darauf, wie die Anweisungen sinnvoll zu verwenden sind. -In\textnote{Tipp!} vielen Fällen wird es jedoch auch ausreichen, einen der +In\textnote{Tipp!} vielen Fällen wird es jedoch auch ausreichen, einen der vorhandenen Stile mit \DescRef{\LabelBase.cmd.CloneTOCEntryStyle} zu klonen und dann dessen Initialisierungscode mit Anweisung \DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} oder -\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern. +\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern. -\Macro{DefineTOCEntryOption} dient eher der Definition der übrigen +\Macro{DefineTOCEntryOption} dient eher der Definition der übrigen Anweisungen und sollte in der Regel nicht direkt verwendet -werden. Normalerweise besteht dafür auch keine Notwendigkeit. Sie sei hier -nur der Vollständigkeit halber erwähnt.% +werden. Normalerweise besteht dafür auch keine Notwendigkeit. Sie sei hier +nur der Vollständigkeit halber erwähnt.% \EndIndexGroup \begin{Declaration} \Macro{CloneTOCEntryStyle}\Parameter{Stil}\Parameter{neuer Stil}% \end{Declaration} -Mit\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} dieser Anweisung kann ein +Mit\ChangedAt{v3.20}{\Package{tocbasic}} dieser Anweisung kann ein existierender \PName{Stil} geklont werden. Dabei wird ein \PName{neuer Stil} mit denselben Eigenschaften und Voreinstellungen wie der existierende \PName{Stil} deklariert. Das Paket selbst verwendet @@ -1786,7 +1933,7 @@ mit denselben Eigenschaften und Voreinstellungen wie der existierende Anweisung um die Stile \PValue{part}, \PValue{section} und \PValue{chapter} oder \PValue{subsection} als Klon von \PValue{tocline} zu deklarieren und dann mit \DescRef{\LabelBase.cmd.TOCEntryStyleInitCode} und -\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern. Der Stil +\DescRef{\LabelBase.cmd.TOCEntryStyleStartInitCode} abzuändern. Der Stil \PValue{default} wird von \Class{scrbook} und \Class{scrreprt} neu als Klon von \PValue{section} und von \Class{scrartcl} als Klon von \PValue{subsection} deklariert.% @@ -1799,26 +1946,26 @@ deklariert.% \Macro{TOCEntryStyleStartInitCode}\Parameter{Stil}% \Parameter{Initialisierungscode} \end{Declaration} -Jeder\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil -verfügt über einen Initialisierungscode. Dieser wird immer dann aufgerufen, +Jeder\ChangedAt{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil +verfügt über einen Initialisierungscode. Dieser wird immer dann aufgerufen, wenn einer Verzeichnisebene der entsprechende \PName{Stil} mit \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}\IndexCmd{DeclareTOCEntryStyle} zugewiesen wird. Dieser\textnote{Achtung!} \PName{Initialisierungscode} sollte -keine globalen Seiteneffekte aufweisen, da er auch für lokale +keine globalen Seiteneffekte aufweisen, da er auch für lokale Initialisierungen innerhalb anderer Anweisungen wie \DescRef{\LabelBase.cmd.DeclareNewTOC}\IndexCmd{DeclareNewTOC} verwendet wird. Der \PName{Initialisierungscode} dient einerseits dazu, Eigenschaften -für den jeweiligen \PName{Stil} zu definieren. Er setzt aber auch die -Standardeinstellungen für diese Eigenschaften. +für den jeweiligen \PName{Stil} zu definieren. Er setzt aber auch die +Standardeinstellungen für diese Eigenschaften. Mit Hilfe der Anweisungen \Macro{TOCEntryStyleStartInitCode} und -\Macro{TOCEntryStyleInitCode} kann der für einen \PName{Stil} bereits +\Macro{TOCEntryStyleInitCode} kann der für einen \PName{Stil} bereits definierte Initialisierungscode um weiteren \PName{Initialisierungscode} -erweitert werden. Dabei fügt \Macro{TOCEntryStyleStartInitCode} den neuen -\PName{Intialisierungscode} vorn an, während \Macro{TOCEntryStyleInitCode} den -\PName{Initialisierungscode} hinten an den vorhandenen Code anfügt. Dies wird -beispielsweise von den \KOMAScript-Klassen verwendet, um für den von -\PValue{tocline} geklonten Stil \PValue{part} Füllung, Schrift und vertikalen +erweitert werden. Dabei fügt \Macro{TOCEntryStyleStartInitCode} den neuen +\PName{Intialisierungscode} vorn an, während \Macro{TOCEntryStyleInitCode} den +\PName{Initialisierungscode} hinten an den vorhandenen Code anfügt. Dies wird +beispielsweise von den \KOMAScript-Klassen verwendet, um für den von +\PValue{tocline} geklonten Stil \PValue{part} Füllung, Schrift und vertikalen Abstand passend zu initialisieren. Die Klassen \Class{scrbook} und \Class{scrreprt} verwenden beispielsweise \begin{lstcode} @@ -1839,54 +1986,54 @@ definieren.% \Macro{LastTOCLevelWasSame} \Macro{LastTOCLevelWasLower} \end{Declaration} -Bei\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Einträgen im Stil -\PValue{tocline} wird am Anfang abhängig vom Wert von +Bei\ChangedAt{v3.20}{\Package{tocbasic}} Einträgen im Stil +\PValue{tocline} wird am Anfang abhängig vom Wert von \Macro{lastpenalty}\IndexCmd{lastpenalty} eine dieser drei Anweisungen -ausgeführt. Dabei fügen \Macro{LastTOCLevelWasHigher} und +ausgeführt. Dabei fügen \Macro{LastTOCLevelWasHigher} und \Macro{LastTOCLevelWasSame} im vertikalen Modus -\Macro{addpenalty}\PParameter{\Macro{@lowpenalty}} ein und ermöglichen so -einen Umbruch vor Einträgen gleicher oder übergeordneter +\Macro{addpenalty}\PParameter{\Macro{@lowpenalty}} ein und ermöglichen so +einen Umbruch vor Einträgen gleicher oder übergeordneter Ebene. \Macro{LastTOCLevelWasLower} ist hingegen bisher leer definiert, so dass zwischen einem Eintrag und seinem ersten Untereintrag normalerweise ein Umbruch untersagt ist. -Anwender sollten diese Anweisungen nicht umdefinieren. Stattdessen können und -sollten Änderungen bei Zuweisung des Stils an eine Eintragsebene gezielt über +Anwender sollten diese Anweisungen nicht umdefinieren. Stattdessen können und +sollten Änderungen bei Zuweisung des Stils an eine Eintragsebene gezielt über die Eigenschaften \PValue{onstartlowerlevel}, \PValue{onstartsamelevel} und \PValue{onstarthigherlevel} vorgenommen werden.% \EndIndexGroup \begin{Declaration} - \Macro{TOCLineLeaderFill}\OParameter{Füllzeichen} + \Macro{TOCLineLeaderFill}\OParameter{Füllzeichen} \end{Declaration} -Die\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Anweisung ist dazu gedacht -als Wert für die Eigenschaft \Option{linefill} des Verzeichniseintragsstils +Die\ChangedAt{v3.20}{\Package{tocbasic}} Anweisung ist dazu gedacht +als Wert für die Eigenschaft \Option{linefill} des Verzeichniseintragsstils \PName{tocline} verwendet zu werden. Sie erzeugt dann eine Verbindung zwischen -dem Ende des Textes eines Eintrags und der zugehörigen Seitenzahl. Das -\PName{Füllzeichen}, das dazu in regelmäßigem Abstand wiederholt wird, kann +dem Ende des Textes eines Eintrags und der zugehörigen Seitenzahl. Das +\PName{Füllzeichen}, das dazu in regelmäßigem Abstand wiederholt wird, kann als optionales Argument angegeben werden. Voreinstellung ist ein Punkt.\textnote{Voreinstellung} -Wie der Name schon vermuten lässt, werden die Füllzeichen mit Hilfe von +Wie der Name schon vermuten lässt, werden die Füllzeichen mit Hilfe von \Macro{leaders} gesetzt. Als Abstand wird wie bei der \LaTeX-Kern-Anweisung -\Macro{@dottedtocline} vor und nach dem Füllzeichen +\Macro{@dottedtocline} vor und nach dem Füllzeichen \Macro{mkern}\Macro{@dotsep}\Unit{\texttt{mu}} verwendet.% \EndIndexGroup % \EndIndexGroup -\section{Interne Anweisungen für Klassen- und Paketautoren} +\section{Interne Anweisungen für Klassen- und Paketautoren} \seclabel{internals} Das Paket \Package{tocbasic} bietet einige interne Anweisungen, deren Benutzung durch Klassen- und Paketautoren freigegeben ist. Diese Anweisungen beginnen alle mit \Macro{tocbasic@}. Aber\textnote{Achtung!} auch Klassen- und Paketautoren sollten diese Anweisungen nur verwenden und nicht etwa -umdefinieren! Ihre interne Funktion kann jederzeit geändert oder erweitert +umdefinieren! Ihre interne Funktion kann jederzeit geändert oder erweitert werden, so dass jede Umdefinierung der Anweisungen die Funktion von -\Package{tocbasic} erheblich beschädigen könnte! +\Package{tocbasic} erheblich beschädigen könnte! \begin{Declaration} @@ -1897,35 +2044,35 @@ bzw. ein \LaTeX-Kern, der um die Sprachverwaltung von \Package{babel} erweitert wurde, schreibt bei jeder Sprachumschaltung am Anfang oder innerhalb eines Dokuments in die Dateien mit den Dateierweiterungen \File{toc}, \File{lof} und \File{lot} Anweisungen, um diese Sprachumschaltung in diesen -Dateien mit zu führen. \Package{tocbasic} erweitert diesen Mechanismus so, +Dateien mit zu führen. \Package{tocbasic} erweitert diesen Mechanismus so, dass mit Hilfe von \Macro{tocbasic@extend@babel} auch andere \PName{Dateierweiterungen} davon profitieren. Das Argument -\PName{Dateierweiterung} sollte dabei vollständig expandiert sein! +\PName{Dateierweiterung} sollte dabei vollständig expandiert sein! Anderenfalls besteht die Gefahr, dass etwa die Bedeutung eines Makros zum -Zeitpunkt der tatsächlichen Auswertung bereits geändert wurde. +Zeitpunkt der tatsächlichen Auswertung bereits geändert wurde. -In der Voreinstellung wird diese Anweisung normalerweise für alle +In der Voreinstellung wird diese Anweisung normalerweise für alle \PName{Dateierweiterungen}, die mit \DescRef{\LabelBase.cmd.addtotoclist} zur -Liste der bekannten Dateierweiterungen hinzugefügt werden, aufgerufen. Über +Liste der bekannten Dateierweiterungen hinzugefügt werden, aufgerufen. Ãœber die Eigenschaft \PValue{nobabel}\important{\PValue{nobabel}} (siehe \DescRef{\LabelBase.cmd.setuptoc}, \autoref{sec:tocbasic.toc}, -\DescPageRef{\LabelBase.cmd.setuptoc}) kann dies unterdrückt werden. Für die -Dateinamenerweiterungen \File{toc}, \File{lof} und \File{lot} unterdrückt +\DescPageRef{\LabelBase.cmd.setuptoc}) kann dies unterdrückt werden. Für die +Dateinamenerweiterungen \File{toc}, \File{lof} und \File{lot} unterdrückt \Package{tocbasic} dies bereits selbst, % \iftrue% Umbruchvarianten da \Package{babel} sie von sich aus vornimmt.% \else% -damit die Umschaltung nicht mehrfach in die zugehörigen Dateien +damit die Umschaltung nicht mehrfach in die zugehörigen Dateien eingetragen wird.% \fi Normalerweise gibt es keinen Grund, diese Anweisung selbst aufzurufen. Es sind allerdings Verzeichnisse denkbar, die nicht unter der Kontrolle von \Package{tocbasic} stehen, also nicht in der Liste der bekannten -Dateierweiterungen geführt werden, aber trotzdem die Spracherweiterung für -\Package{babel} nutzen sollen. Für derartige Verzeichnisse wäre die Anweisung +Dateierweiterungen geführt werden, aber trotzdem die Spracherweiterung für +\Package{babel} nutzen sollen. Für derartige Verzeichnisse wäre die Anweisung explizit aufzurufen. Bitte\textnote{Achtung!} achten Sie jedoch darauf, dass -dies für jede Dateierweiterung nur einmal geschieht!% +dies für jede Dateierweiterung nur einmal geschieht!% \EndIndexGroup @@ -1943,21 +2090,21 @@ Anweisung baut selbst auf \Macro{@starttoc} auf, setzt allerdings zuvor \Length{parskip}\IndexLength{parskip}\important[i]{\Length{parskip}, \Length{parindent}, \Length{parfillskip}} und \Length{parindent}\IndexLength{parindent} auf 0 und -\Length{parfillskip}\IndexLength{parfillskip} auf 0 bis unendlich. Außerdem +\Length{parfillskip}\IndexLength{parfillskip} auf 0 bis unendlich. Außerdem wird \Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} auf die -aktuelle Dateierweiterung gesetzt, damit diese in den nachfolgend ausgeführten -Haken\Index{Haken} ausgewertet werden kann. Die Erklärungen der Haken finden +aktuelle Dateierweiterung gesetzt, damit diese in den nachfolgend ausgeführten +Haken\Index{Haken} ausgewertet werden kann. Die Erklärungen der Haken finden Sie im Anschluss. Da\textnote{Achtung!} \LaTeX{} bei der Ausgabe eines Verzeichnisses auch -gleich eine neue Verzeichnisdatei zum Schreiben öffnet, kann der Aufruf dieser +gleich eine neue Verzeichnisdatei zum Schreiben öffnet, kann der Aufruf dieser Anweisung zu einer Fehlermeldung der Art \begin{lstoutput} ! No room for a new \write . \ch@ck ...\else \errmessage {No room for a new #3} \fi \end{lstoutput} -führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in +führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} oder die Verwendung von Lua\LaTeX{} bieten.% @@ -1971,27 +2118,27 @@ oder die Verwendung von Lua\LaTeX{} bieten.% Der Haken\Index{Haken} \Macro{tocbasic@@before@hook} wird unmittelbar vor dem Einlesen der Verzeichnisdatei, noch vor den mit \DescRef{\LabelBase.cmd.BeforeStartingTOC} definierten Anweisungen -ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von +ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von \Macro{g@addto@macro}\IndexCmd{g@addto@macro} zu erweitern. Ebenso wird \Macro{tocbasic@@after@hook} unmittelbar nach der Verzeichnisdatei, aber noch vor den mit \DescRef{\LabelBase.cmd.AfterStartingTOC} definierten Anweisungen -ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von +ausgeführt. Es ist erlaubt, diesen Haken mit Hilfe von \Macro{g@addto@macro}\IndexCmd{g@addto@macro} zu erweitern. \KOMAScript{} nutzt diese Haken, um Verzeichnisse mit dynamischer Anpassung an -die Breite der Gliederungsnummern zu ermöglichen. Ihre Verwendung ist Klassen +die Breite der Gliederungsnummern zu ermöglichen. Ihre Verwendung ist Klassen und Paketen vorbehalten. Anwender\textnote{Achtung!} sollten sich auf \DescRef{\LabelBase.cmd.BeforeStartingTOC} und -\DescRef{\LabelBase.cmd.AfterStartingTOC} beschränken. Paketautoren sollten +\DescRef{\LabelBase.cmd.AfterStartingTOC} beschränken. Paketautoren sollten ebenfalls vorzugsweise diese beiden Anwenderanweisungen verwenden! Ausgaben innerhalb der beiden Haken sind nicht gestattet! Wird keine\textnote{Achtung!} der Anweisungen \DescRef{\LabelBase.cmd.listofeachtoc}, \DescRef{\LabelBase.cmd.listoftoc} und -\DescRef{\LabelBase.cmd.listoftoc*} für die Ausgabe der Verzeichnisse -verwendet, sollten die Anweisungen für die Haken\Index{Haken} trotzdem +\DescRef{\LabelBase.cmd.listoftoc*} für die Ausgabe der Verzeichnisse +verwendet, sollten die Anweisungen für die Haken\Index{Haken} trotzdem aufgerufen werden.% \EndIndexGroup @@ -2002,15 +2149,15 @@ aufgerufen werden.% \end{Declaration} Diese Anweisungen werden direkt nach \DescRef{\LabelBase.cmd.tocbasic@@before@hook} bzw. vor -\DescRef{\LabelBase.cmd.tocbasic@@after@hook} für das jeweilige Verzeichnis +\DescRef{\LabelBase.cmd.tocbasic@@after@hook} für das jeweilige Verzeichnis mit der entsprechenden \PName{Dateierweiterung} -ausgeführt. Sie\textnote{Achtung!} dürfen keinesfalls von Klassen- und -Paketautoren verändert werden. Werden für die Ausgabe der Verzeichnisse die +ausgeführt. Sie\textnote{Achtung!} dürfen keinesfalls von Klassen- und +Paketautoren verändert werden. Werden für die Ausgabe der Verzeichnisse die Anweisungen \DescRef{\LabelBase.cmd.listoftoc}, \DescRef{\LabelBase.cmd.listoftoc*} und \DescRef{\LabelBase.cmd.listofeachtoc} -nicht verwendet, sollten die beiden Anweisungen für die Haken\Index{Haken} -trotzdem aufgerufen werden, soweit sie definiert sind. Die Anweisungen können -auch undefiniert sein. Für einen entsprechenden Test siehe +nicht verwendet, sollten die beiden Anweisungen für die Haken\Index{Haken} +trotzdem aufgerufen werden, soweit sie definiert sind. Die Anweisungen können +auch undefiniert sein. Für einen entsprechenden Test siehe \DescRef{scrbase.cmd.scr@ifundefinedorrelax}\IndexCmd{scr@ifundefinedorrelax} in \autoref{sec:scrbase.if}, \DescPageRef{scrbase.cmd.scr@ifundefinedorrelax}.% @@ -2022,20 +2169,20 @@ in \autoref{sec:scrbase.if}, \end{Declaration} Diese Anweisung wird von \DescRef{\LabelBase.cmd.listoftoc} und \DescRef{\LabelBase.cmd.listofeachtoc} verwendet, um die Anweisung zum Setzen -der Überschrift eines Verzeichnisses aufzurufen. Das kann entweder die +der Ãœberschrift eines Verzeichnisses aufzurufen. Das kann entweder die vordefinierte Anweisung des Pakets \Package{tocbasic} oder eine individuelle -Anweisung sein. Wenn Sie Ihre eigene Anweisung für die Überschrift definieren, -können Sie ebenfalls \Macro{tocbasic@listhead} verwenden. In diesem Fall +Anweisung sein. Wenn Sie Ihre eigene Anweisung für die Ãœberschrift definieren, +können Sie ebenfalls \Macro{tocbasic@listhead} verwenden. In diesem Fall sollte vor dem Aufruf von \Macro{tocbasic@listhead} die Anweisung \Macro{@currext}\important{\Macro{@currext}}\IndexCmd{@currext} auf die -Dateinamenerweiterung, die zu diesem Verzeichnis gehört, gesetzt werden.% +Dateinamenerweiterung, die zu diesem Verzeichnis gehört, gesetzt werden.% \EndIndexGroup \begin{Declaration} \Macro{tocbasic@listhead@\PName{Dateierweiterung}}\Parameter{Titel} \end{Declaration} -Ist diese individuelle Anweisung für das Setzen einer Verzeichnisüberschrift +Ist diese individuelle Anweisung für das Setzen einer Verzeichnisüberschrift definiert, so verwendet \DescRef{\LabelBase.cmd.tocbasic@listhead} sie. Anderenfalls definiert \DescRef{\LabelBase.cmd.tocbasic@listhead} diese vor der Verwendung.% @@ -2051,10 +2198,10 @@ vor der Verwendung.% \end{Declaration} Anweisung\ChangedAt{v3.12}{\Package{tocbasic}} \Macro{tocbasic@addxcontentsline} nimmt einen \PName{Eintrag} der angegebenen -\PName{Ebene} in das über die \PName{Dateierweiterung} spezifizierte +\PName{Ebene} in das über die \PName{Dateierweiterung} spezifizierte Verzeichnis vor. Ob der Eintrag nummeriert wird\iffree{ oder nicht}{}% Umbruchvarianten -, hängt davon ab, ob das Argument \PName{Gliederungsnummer} leer ist oder +, 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 \DescRef{\LabelBase.cmd.numberline} mit \PName{Gliederungsnummer} als @@ -2065,7 +2212,7 @@ Die Anweisung \Macro{nonumberline} wird innerhalb \DescPageRef{\LabelBase.cmd.listoftoc}) entsprechend der Eigenschaft \PValue{numberline} (siehe \autoref{sec:tocbasic.toc}, \DescPageRef{\LabelBase.cmd.setuptoc}) umdefiniert. Dadurch wirkt sich das -Setzen oder Löschen dieser Eigenschaft \iffree{bereits beim nächsten +Setzen oder Löschen dieser Eigenschaft \iffree{bereits beim nächsten \LaTeX-Lauf}{unmittelbar} % Umbruchvarianten aus.% % @@ -2076,34 +2223,34 @@ aus.% \Macro{tocbasic@DependOnPenaltyAndTOCLevel}\Parameter{Eintragsebene} \Macro{tocbasic@SetPenaltyByTOCLevel}\Parameter{Eintragsebene} \end{Declaration} -Der\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil +Der\ChangedAt{v3.20}{\Package{tocbasic}} Verzeichniseintragsstil \PValue{tocline} (siehe \autoref{sec:tocbasic.tocstyle}) setzt am Ende jedes -Eintrags über \Macro{tocbasic@SetPenaltyByTOCLevel} \Macro{penalty} so, dass +Eintrags über \Macro{tocbasic@SetPenaltyByTOCLevel} \Macro{penalty} so, dass nach einem Eintrag kein Seitenumbruch erfolgen darf. Der genaue Wert wird -dabei abhängig von der \PName{Eintragsebene} gewählt. +dabei abhängig von der \PName{Eintragsebene} gewählt. % \begin{sloppypar} \begingroup \emergencystretch=2em -Über \Macro{tocbasic@DependOnPenaltyAndTOCLevel} wird am Anfang eines -Eintrags, abhängig von \Macro{lastpenalty} und der \PName{Eintragsebene} die -über die Eigenschaft \Option{onstartlowerlevel} im internen Makro -\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasHigher}, über die +Ãœber \Macro{tocbasic@DependOnPenaltyAndTOCLevel} wird am Anfang eines +Eintrags, abhängig von \Macro{lastpenalty} und der \PName{Eintragsebene} die +über die Eigenschaft \Option{onstartlowerlevel} im internen Makro +\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasHigher}, über die \iffree{Eigenschaft}{Ei\-genschaft} -\Option{onstartsamelevel} im zugehörigen, internen +\Option{onstartsamelevel} im zugehörigen, internen Makro\iffree{ }{\linebreak}\Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasSame} oder -über die Eigenschaft \Option{onstarthigherlevel} im zugehörigen, internen +über die Eigenschaft \Option{onstarthigherlevel} im zugehörigen, internen Makro \Macro{scr@tso@\PName{Eintragsebene}@LastTOCLevelWasLower} gespeicherte -Aktion ausgeführt. In der Voreinstellung\textnote{Voreinstellung} erlauben die -ersten beiden einen Umbruch, wenn sie im vertikalen Modus ausgeführt +Aktion ausgeführt. In der Voreinstellung\textnote{Voreinstellung} erlauben die +ersten beiden einen Umbruch, wenn sie im vertikalen Modus ausgeführt werden.\par \endgroup %\end{sloppypar} Entwicklern, die eigene Stile kompatibel mit \PValue{tocline} erstellen -wollen, sei empfohlen, dieses Verhalten zu kopieren. Zu diesem Zweck dürfen -sie auf diese eigentlich internen Makros zurückgreifen.% +wollen, sei empfohlen, dieses Verhalten zu kopieren. Zu diesem Zweck dürfen +sie auf diese eigentlich internen Makros zurückgreifen.% \EndIndexGroup @@ -2111,23 +2258,23 @@ sie auf diese eigentlich internen Makros zurückgreifen.% \seclabel{example} In diesem Abschnitt finden Sie ein komplettes Beispiel, wie eine eigene -Gleitumgebung einschließlich Verzeichnis und \KOMAScript-Integration mit Hilfe +Gleitumgebung einschließlich Verzeichnis und \KOMAScript-Integration mit Hilfe von \Package{tocbasic} definiert werden kann. In diesem Beispiel werden -interne Anweisungen, also solche mit »\texttt{@}« im Namen +interne Anweisungen, also solche mit »\texttt{@}« im Namen verwendet. Das\textnote{Achtung!} bedeutet, dass die Anweisungen entweder in einem eigenen Paket, einer Klasse oder zwischen \Macro{makeatletter}\important[i]{\Macro{makeatletter}\\\Macro{makeatother}}% \IndexCmd{makeatletter} und \Macro{makeatother}\IndexCmd{makeatother} -verwendet werden müssen. +verwendet werden müssen. -Als\textnote{Umgebung} erstes wird eine Umgebung benötigt, die diese neue +Als\textnote{Umgebung} erstes wird eine Umgebung benötigt, die diese neue Gleitumgebung bereitstellt. Das geht ganz einfach mit: \begin{lstcode} \newenvironment{remarkbox}% {\@float{remarkbox}}% {\end@float} \end{lstcode} -Die neue Umgebung heißt also \Environment{remarkbox}. +Die neue Umgebung heißt also \Environment{remarkbox}. Jede\textnote{Platzierung} Gleitumgebung hat eine Standardplatzierung. Diese setzt sich aus einer oder mehreren der bekannten Platzierungsoptionen @@ -2136,20 +2283,20 @@ setzt sich aus einer oder mehreren der bekannten Platzierungsoptionen \newcommand*{\fps@remarkbox}{tbp} \end{lstcode} Die neue Gleitumgebung soll also in der Voreinstellung nur oben, unten oder -auf einer eigenen Seite platziert werden dürfen. +auf einer eigenen Seite platziert werden dürfen. -Gleitumgebungen\textnote{Gleittyp} haben außerdem einen nummerischen Gleittyp +Gleitumgebungen\textnote{Gleittyp} haben außerdem einen nummerischen Gleittyp zwischen 1 und 31. Umgebungen, bei denen das gleiche Bit -im Gleittyp gesetzt ist, dürfen sich nicht gegenseitig überholen. Abbildungen -und Tabellen haben normalerweise den Typ~1 und 2. Abbildungen dürfen also -Tabellen überholen und umgekehrt. +im Gleittyp gesetzt ist, dürfen sich nicht gegenseitig überholen. Abbildungen +und Tabellen haben normalerweise den Typ~1 und 2. Abbildungen dürfen also +Tabellen überholen und umgekehrt. \begin{lstcode} \newcommand*{\ftype@remarkbox}{4} \end{lstcode} -Die neue Umgebung hat den Typ~4, darf also Tabellen und Abbildungen überholen -und von diesen überholt werden. +Die neue Umgebung hat den Typ~4, darf also Tabellen und Abbildungen überholen +und von diesen überholt werden. -Gleitumgebungen\textnote{Nummer} haben außerdem eine Nummer. +Gleitumgebungen\textnote{Nummer} haben außerdem eine Nummer. \begin{lstcode} \newcounter{remarkbox} \newcommand*{\remarkboxformat}{% @@ -2157,11 +2304,11 @@ Gleitumgebungen\textnote{Nummer} haben außerdem eine Nummer. } \newcommand*{\fnum@remarkbox}{\remarkboxformat} \end{lstcode} -Hier wird zunächst ein neuer Zähler definiert, der unabhängig von Kapiteln -oder sonstigen Gliederungszählern ist. Dabei definiert \LaTeX{} auch gleich +Hier wird zunächst ein neuer Zähler definiert, der unabhängig von Kapiteln +oder sonstigen Gliederungszählern ist. Dabei definiert \LaTeX{} auch gleich \Macro{theremarkbox} mit der Standardausgabe als arabische Zahl. Diese wird dann in der Definition der formatierten Ausgabe verwendet. Die formatierte -Ausgabe wird wiederum als Gleitumgebungsnummer für die Verwendung in +Ausgabe wird wiederum als Gleitumgebungsnummer für die Verwendung in \DescRef{maincls.cmd.caption} definiert. Gleitumgebungen\textnote{Dateierweiterung} haben Verzeichnisse und diese haben @@ -2169,16 +2316,16 @@ eine Datei mit dem Namen \Macro{jobname} und einer Dateierweiterung. \begin{lstcode} \newcommand*{\ext@remarkbox}{lor} \end{lstcode} -Als Dateierweiterung verwenden wir also »\File{lor}«. +Als Dateierweiterung verwenden wir also »\File{lor}«. Die\important{\Package{tocbasic}} Umgebung selbst steht damit. Es fehlt -allerdings das Verzeichnis. Damit wir dabei möglichst wenig selbst machen -müssen, verwenden wir das Paket \Package{tocbasic}. Dieses wird in Dokumenten +allerdings das Verzeichnis. Damit wir dabei möglichst wenig selbst machen +müssen, verwenden wir das Paket \Package{tocbasic}. Dieses wird in Dokumenten mit \begin{lstcode} \usepackage{tocbasic} \end{lstcode} -geladen. Ein Klassen- oder Paketautor würde hingegen +geladen. Ein Klassen- oder Paketautor würde hingegen \begin{lstcode} \RequirePackage{tocbasic} \end{lstcode} @@ -2190,48 +2337,48 @@ Nun\textnote{Dateierweiterung} machen wir die neue Dateierweiterung dem Paket \addtotoclist[float]{lor} \end{lstcode} Dabei verwenden wir als Besitzer \PValue{float}, damit sich alle -anschließend aufgerufenen Optionen von \KOMAScript, die sich auf Verzeichnisse +anschließend aufgerufenen Optionen von \KOMAScript, die sich auf Verzeichnisse von Gleitumgebungen beziehen, auch auf das neue Verzeichnis beziehen. -Jetzt\textnote{Verzeichnistitel} definieren wir noch einen Titel für dieses +Jetzt\textnote{Verzeichnistitel} definieren wir noch einen Titel für dieses Verzeichnis: \begin{lstcode} - \newcommand*{\listoflorname}{Verzeichnis der Merksätze} + \newcommand*{\listoflorname}{Verzeichnis der Merksätze} \end{lstcode} -Normalerweise würde man in einem Paket übrigens zunächst einen englischen +Normalerweise würde man in einem Paket übrigens zunächst einen englischen Titel definieren und dann beispielsweise mit Hilfe des Pakets -\Package{scrbase} Titel für alle weiteren Sprachen, die man unterstützen +\Package{scrbase} Titel für alle weiteren Sprachen, die man unterstützen will. Siehe dazu \autoref{sec:scrbase.languageSupport}, ab \autopageref{sec:scrbase.languageSupport}. -Jetzt\textnote{Verzeichniseintrag}\index{Verzeichnis>Eintrag} müssen wir nur +Jetzt\textnote{Verzeichniseintrag}\index{Verzeichnis>Eintrag} müssen wir nur noch definieren, wie ein einzelner Eintrag in dem Verzeichnis aussehen soll: \begin{lstcode} \newcommand*{\l@remarkbox}{\l@figure} \end{lstcode} -Weil das die einfachste Lösung ist, wurde hier festgelegt, dass Einträge in -das Verzeichnis der Merksätze genau wie Einträge in das Abbildungsverzeichnis -aussehen sollen. Man hätte auch eine explizite Festlegung wie +Weil das die einfachste Lösung ist, wurde hier festgelegt, dass Einträge in +das Verzeichnis der Merksätze genau wie Einträge in das Abbildungsverzeichnis +aussehen sollen. Man hätte auch eine explizite Festlegung wie \begin{lstcode} \DeclareTOCStyleEntry[level=1,indent=1em,numwidth=1.5em]% {tocline}{remarkbox} \end{lstcode} -verwenden können. +verwenden können. -Außerdem\textnote{Kapiteleintrag} wollen Sie, dass sich Kapiteleinträge auf das +Außerdem\textnote{Kapiteleintrag} wollen Sie, dass sich Kapiteleinträge auf das Verzeichnis auswirken. \begin{lstcode} \setuptoc{lor}{chapteratlist} \end{lstcode} -Das Setzen dieser Eigenschaft ermöglicht dies bei Verwendung einer +Das Setzen dieser Eigenschaft ermöglicht dies bei Verwendung einer \KOMAScript-Klasse und jeder anderen Klasse, die diese Eigenschaft -unterstützt. Leider gehören die Standardklassen nicht dazu. +unterstützt. Leider gehören die Standardklassen nicht dazu. -Das\textnote{Verzeichnis} genügt schon. Der Anwender kann nun bereits +Das\textnote{Verzeichnis} genügt schon. Der Anwender kann nun bereits wahlweise mit Hilfe der Optionen einer \KOMAScript-Klasse oder -\DescRef{\LabelBase.cmd.setuptoc} verschiedene Formen der Überschrift (ohne +\DescRef{\LabelBase.cmd.setuptoc} verschiedene Formen der Ãœberschrift (ohne Inhaltsverzeichniseintrag, mit Inhaltsverzeichniseintrag, mit Nummerierung) -wählen und das Verzeichnis mit +wählen und das Verzeichnis mit \DescRef{\LabelBase.cmd.listoftoc}\PParameter{lor} ausgeben. Mit einem schlichten \begin{lstcode} @@ -2239,36 +2386,36 @@ schlichten \end{lstcode} kann man die Anwendung noch etwas vereinfachen. -Wie Sie gesehen haben, beziehen sich gerade einmal fünf einzeilige +Wie Sie gesehen haben, beziehen sich gerade einmal fünf einzeilige Anweisungen, von denen nur drei bis vier wirklich notwendig sind, auf das Verzeichnis selbst. Trotzdem bietet dieses Verzeichnis bereits die -Möglichkeit, es zu nummerieren oder auch nicht nummeriert in das +Möglichkeit, es zu nummerieren oder auch nicht nummeriert in das Inhaltsverzeichnis aufzunehmen. Es kann sogar per Eigenschaft bereits eine -tiefere Gliederungsebene gewählt werden. Kolumnentitel werden für \KOMAScript, +tiefere Gliederungsebene gewählt werden. Kolumnentitel werden für \KOMAScript, die Standardklassen und alle Klassen, die \Package{tocbasic} explizit -unterstützen, angepasst gesetzt. Unterstützende Klassen beachten das neue +unterstützen, angepasst gesetzt. Unterstützende Klassen beachten das neue Verzeichnis sogar beim Wechsel zu einem neuen Kapitel. Sprachumschaltungen -durch \Package{babel} werden in dem Verzeichnis ebenfalls berücksichtigt. +durch \Package{babel} werden in dem Verzeichnis ebenfalls berücksichtigt. -Natürlich\textnote{Verzeichniseigenschaften} kann ein Paketautor weiteres -hinzufügen. So könnte er explizit Optionen anbieten, um die Verwendung von +Natürlich\textnote{Verzeichniseigenschaften} kann ein Paketautor weiteres +hinzufügen. So könnte er explizit Optionen anbieten, um die Verwendung von \DescRef{\LabelBase.cmd.setuptoc} vor dem Anwender zu verbergen. Andererseits kann er auch auf diese Anleitung zu \Package{tocbasic} verweisen, wenn es -darum geht, die entsprechenden Möglichkeiten zu erklären. Vorteil ist dann, -dass der Anwender automatisch von etwaigen zukünftigen Erweiterungen von +darum geht, die entsprechenden Möglichkeiten zu erklären. Vorteil ist dann, +dass der Anwender automatisch von etwaigen zukünftigen Erweiterungen von \Package{tocbasic} profitiert. Soll der Anwender aber nicht mit der Tatsache -belastet werden, dass für die Merksätze die Dateierweiterung \File{lor} -verwendet wird, so genügt +belastet werden, dass für die Merksätze die Dateierweiterung \File{lor} +verwendet wird, so genügt \begin{lstcode} \newcommand*{\setupremarkboxes}{\setuptoc{lor}} \end{lstcode} \iffalse% -um eine als Argument an \Macro{setupremarkboxes} übergebene Liste von +um eine als Argument an \Macro{setupremarkboxes} übergebene Liste von Eigenschaften direkt als Liste von % \else% -um über \Macro{setupremarkboxes} +um über \Macro{setupremarkboxes} \fi -Eigenschaften für \File{lor} zu setzen. +Eigenschaften für \File{lor} zu setzen. \section{Alles mit einer Anweisung} @@ -2284,82 +2431,86 @@ noch einfacher gehen kann. \Parameter{Dateierweiterung} \end{Declaration}% Mit\ChangedAt{v3.06}{\Package{tocbasic}} dieser Anweisung wird in einem -einzigen Schritt ein neues Verzeichnis, dessen Überschrift und die Bezeichnung -für die Einträge unter Kontrolle von \Package{tocbasic} definiert. Optional -können dabei gleichzeitig gleitende oder nicht gleitende Umgebungen definiert +einzigen Schritt ein neues Verzeichnis, dessen Ãœberschrift und die Bezeichnung +für die Einträge unter Kontrolle von \Package{tocbasic} definiert. Optional +können dabei gleichzeitig gleitende oder nicht gleitende Umgebungen definiert werden, innerhalb derer \DescRef{maincls.cmd.caption}% -\important{\DescRef{maincls.cmd.caption}}\IndexCmd{caption} Einträge für +\important{\DescRef{maincls.cmd.caption}}\IndexCmd{caption} Einträge für dieses neue Verzeichnis erzeugt. Auch die Erweiterungen \DescRef{maincls.cmd.captionabove}\important[i]{% \DescRef{maincls.cmd.captionabove}\\ \DescRef{maincls.cmd.captionbelow}}, \DescRef{maincls.cmd.captionbelow} und \DescRef{maincls.env.captionbeside} aus den \KOMAScript-Klassen (siehe \autoref{sec:maincls.floats}, ab \DescPageRef{maincls.cmd.captionabove}) -können dann verwendet werden. +können dann verwendet werden. \PName{Dateierweiterung} definiert dabei die Dateiendung der Hilfsdatei, die -das Verzeichnis repräsentiert, wie dies in \autoref{sec:tocbasic.basics}, ab -\autopageref{sec:tocbasic.basics} bereits erläutert +das Verzeichnis repräsentiert, wie dies in \autoref{sec:tocbasic.basics}, ab +\autopageref{sec:tocbasic.basics} bereits erläutert wurde. Dieser\textnote{Achtung!} Parameter muss angegeben werden und darf nicht leer sein! \PName{Optionenliste} ist eine durch Komma getrennte Liste, wie dies auch von \DescRef{maincls.cmd.KOMAoptions} (siehe \autoref{sec:typearea.options}, \DescPageRef{typearea.cmd.KOMAoptions}) bekannt ist. Diese -Optionen\textnote{Achtung!} können jedoch \emph{nicht} mit +Optionen\textnote{Achtung!} können jedoch \emph{nicht} mit \DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions} gesetzt werden! Eine -Übersicht über die möglichen Optionen bietet +Ãœbersicht über die möglichen Optionen bietet \autoref{tab:tocbasic.DeclareNewTOC-options}\iffalse ab \autopageref{tab:tocbasic.DeclareNewTOC-options}\fi. -Wird\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} Option +Wird\ChangedAt{v3.20}{\Package{tocbasic}} Option \Option{tocentrystyle} nicht gesetzt, so wird bei Bedarf der Stil -\PValue{default} verwendet. Näheres zu diesem Stil ist -\autoref{sec:tocbasic.tocstyle} zu entnehmen. Soll kein Befehl für -Verzeichniseinträge definiert werden, so kann ein leeres Argument, also +\PValue{default} verwendet. Näheres zu diesem Stil ist +\autoref{sec:tocbasic.tocstyle} zu entnehmen. Soll kein Befehl für +Verzeichniseinträge definiert werden, so kann ein leeres Argument, also wahlweise \OptionValue{tocentrystyle}{}\iffree{}{\unskip} oder \OptionValue{tocentrystyle}{\PParameter{}} verwendet werden. -Abhängig\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} vom Stil der -Verzeichniseinträge können auch alle für diesen Stil gültigen Eigenschaften +Abhängig\ChangedAt{v3.21}{\Package{tocbasic}} vom Stil der +Verzeichniseinträge können auch alle für diesen Stil gültigen Eigenschaften gesetzt werden, indem die entsprechenden in \autoref{tab:tocbasic.tocstyle.attributes} ab -\autopageref{tab:tocbasic.tocstyle.attributes} aufgeführten Namen, mit dem -Präfix \PValue{tocentry} versehen, in der \PName{Optionenliste} angegeben -werden. Nachträgliche Änderungen am Stil sind mit +\autopageref{tab:tocbasic.tocstyle.attributes} aufgeführten Namen, mit dem +Präfix \PValue{tocentry} versehen, in der \PName{Optionenliste} angegeben +werden. Nachträgliche Änderungen am Stil sind mit \DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}% \IndexCmd{DeclareTOCStyleEntry}% \important{\DescRef{\LabelBase.cmd.DeclareTOCStyleEntry}} jederzeit -möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, +möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, \DescPageRef{\LabelBase.cmd.DeclareTOCStyleEntry}. % Umbruchoptimierung: Tabelle verschoben. \begin{desclist} \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}% \desccaption[{% - Optionen für die Anweisung \Macro{DeclareNewTOC}% + Optionen für die Anweisung \Macro{DeclareNewTOC}% }]{% - Optionen für die Anweisung + Optionen für die Anweisung \Macro{DeclareNewTOC}\ChangedAt{v3.06}{\Package{tocbasic}}% \label{tab:tocbasic.DeclareNewTOC-options}% }{% - Optionen für die Anweisung \Macro{DeclareNewTOC} (\emph{Fortsetzung})% + Optionen für die Anweisung \Macro{DeclareNewTOC} (\emph{Fortsetzung})% }% \entry{\OptionVName{atbegin}{Code}\ChangedAt{v3.09}{\Package{tocbasic}}}{% Falls eine neue Gleitumgebung oder nicht gleitende Umgebung definiert - wird, so wird \PName{Code} jeweils am Anfang dieser Umgebung ausgeführt.% + wird, so wird \PName{Code} jeweils am Anfang dieser Umgebung ausgeführt.% }% \entry{\OptionVName{atend}{Code}\ChangedAt{v3.09}{\Package{tocbasic}}}{% Falls eine neue Gleitumgebung oder nicht gleitende Umgebung definiert - wird, so wird \PName{Code} jeweils am Ende dieser Umgebung ausgeführt.% + wird, so wird \PName{Code} jeweils am Ende dieser Umgebung ausgeführt.% }% - \entry{\OptionVName{counterwithin}{\LaTeX-Zähler}}{% + \entry{\OptionVName{category}{Kategorie}}{% + \ChangedAt{v3.27}{\Package{tocbasic}}% + Diese Option kann als Synonym für \OptionVName{owner}{Besitzer} verwendet + werden.}% + \entry{\OptionVName{counterwithin}{\LaTeX-Zähler}}{% Falls eine neue Gleitumgebung oder eine nicht gleitende Umgebung definiert - wird, so wird für diese auch ein neuer Zähler + wird, so wird für diese auch ein neuer Zähler \Counter{\PName{Eintragstyp}} (siehe Option \Option{type}) - angelegt. Dieser Zähler kann in gleicher Weise wie beispielsweise der - Zähler \Counter{figure} bei \Class{book}-Klassen von Zähler - \Counter{chapter} abhängt, von einem \LaTeX-Zähler ahängig gemacht + angelegt. Dieser Zähler kann in gleicher Weise wie beispielsweise der + Zähler \Counter{figure} bei \Class{book}-Klassen von Zähler + \Counter{chapter} abhängt, von einem \LaTeX-Zähler ahängig gemacht werden.}% \entry{\Option{float}}{% Es wird nicht nur ein neuer Verzeichnistyp definiert, sondern auch @@ -2368,132 +2519,132 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, (vgl. \Environment{figure} und \Environment{figure*}).}% \entry{\OptionVName{floatpos}{Gleitverhalten}}{% Jede Gleitumgebung hat ein voreingestelltes \PName{Gleitverhalten}, das - über das optionale Argument der Gleitumgebung geändert werden kann. Mit - dieser Option wird das \PName{Gleitverhalten} für die optional erstellbare + über das optionale Argument der Gleitumgebung geändert werden kann. Mit + dieser Option wird das \PName{Gleitverhalten} für die optional erstellbare Gleitumgebung (siehe Option \Option{float}) festgelegt. Die Syntax und - Semantik ist dabei mit der des optionalen Arguments für die Gleitumgebung + Semantik ist dabei mit der des optionalen Arguments für die Gleitumgebung identisch. Wird die Option nicht verwendet, so ist das voreingestellte Gleitverhalten \texttt{tbp}, also \emph{top}, \emph{bottom}, \emph{page}.}% \entry{\OptionVName{floattype}{Gleittyp}}{% Jede Gleitumgebung hat einen nummerischen Typ. Gleitumgebungen, bei denen - in diesem \PName{Gleittyp} nur unterschiedliche Bits gesetzt sind, können - sich gegenseitig überholen. Die Gleitumgebungen \Environment{figure} und - \Environment{table} haben normalerweise die Typen 1 und 2, können sich - also gegenseitig überholen. Es sind Typen von 1 bis 31 (alle Bits gesetzt, - kann also keinen anderen Typ überholen und von keinem anderen Typen - überholt werden) zulässig. Wird kein Typ angegeben, so wird mit 16 der - höchst mögliche Ein-Bit-Typ verwendet.}% + in diesem \PName{Gleittyp} nur unterschiedliche Bits gesetzt sind, können + sich gegenseitig überholen. Die Gleitumgebungen \Environment{figure} und + \Environment{table} haben normalerweise die Typen 1 und 2, können sich + also gegenseitig überholen. Es sind Typen von 1 bis 31 (alle Bits gesetzt, + kann also keinen anderen Typ überholen und von keinem anderen Typen + überholt werden) zulässig. Wird kein Typ angegeben, so wird mit 16 der + höchst mögliche Ein-Bit-Typ verwendet.}% \entry{\Option{forcenames}}{% Siehe Option \Option{name} und \Option{listname}.}% \entry{\OptionVName{hang}{Einzug}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% - Diese Option gilt seit \KOMAScript~3.20 als überholt. Die Breite der + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% + Diese Option gilt seit \KOMAScript~3.20 als überholt. Die Breite der Nummer des Verzeichniseintrags\index{Verzeichnis>Eintrag} ist nun - stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils + stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Bei den Stilen von - \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{numwidth} + \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{numwidth} und damit Option \Option{tocentrynumwidth}. Besitzt ein Stil diese Eigenschaft, so wird sie von \Macro{DeclareNewTOC} mit 1,5\Unit{em} voreingestellt. Diese Voreinstellung kann durch explizite Angabe von \OptionVName{tocentrynumwidth}{Wert} leicht mit einem anderen - \PName{Wert} überschrieben werden. Für Abbildungen verwenden die + \PName{Wert} überschrieben werden. Für Abbildungen verwenden die \KOMAScript-Klassen beispielsweise den \PName{Wert} \PValue{2.3em}.}% \entry{\OptionVName{indent}{Einzug}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% - Diese Option gilt seit \KOMAScript~3.20 als überholt. Der Einzug des + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% + Diese Option gilt seit \KOMAScript~3.20 als überholt. Der Einzug des Verzeichniseintrags\index{Verzeichnis>Eintrag} von links ist nun - stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils + stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Bei den Stilen von - \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{indent} und + \KOMAScript{} wäre das beispielsweise die Eigenschaft \PValue{indent} und damit Option \Option{tocentryindent}. Besitzt ein Stil diese Eigenschaft, so wird sie von \Macro{DeclareNewTOC} mit 1\Unit{em} voreingestellt. Diese Voreinstellung kann durch explizite Angabe von \OptionVName{tocentryindent}{Wert} leicht mit einem anderen \PName{Wert} - überschrieben werden. Für Abbildungen verwenden die \KOMAScript-Klassen + überschrieben werden. Für Abbildungen verwenden die \KOMAScript-Klassen beispielsweise den \PName{Wert} \PValue{1.5em}.}% \entry{\OptionVName{level}{Gliederungsebene}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}% - Diese Option gilt seit \KOMAScript~3.20 als überholt. Der nummerische Wert + \ChangedAt{v3.20}{\Package{tocbasic}}% + \ChangedAt{v3.21}{\Package{tocbasic}}% + Diese Option gilt seit \KOMAScript~3.20 als überholt. Der nummerische Wert der Ebene des Verzeichniseintrags\index{Verzeichnis>Eintrag} ist nun - stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils + stattdessen als Eigenschaft in Abhängigkeit des Verzeichniseintragsstils von Option \Option{tocentrystyle} anzugeben. Nichts desto trotz haben alle Stile die Eigenschaft \PValue{level} und damit Option \Option{tocentrylevel}. Die Eigenschaft wird von \Macro{DeclareNewTOC} mit 1 voreingestellt. Diese Voreinstellung kann durch explizite Angabe von \OptionVName{tocentrylevel}{Wert} leicht mit einem anderen \PName{Wert} - überschrieben werden.}% + überschrieben werden.}% \entry{\OptionVName{listname}{Verzeichnistitel}}{% - Jedes Verzeichnis hat eine Überschrift, die durch diese Option bestimmt + Jedes Verzeichnis hat eine Ãœberschrift, die durch diese Option bestimmt werden kann. Ist die Option nicht angegeben, so wird als Verzeichnistitel - »\texttt{List of \PName{Mehrzahl des Eintragstyps}}« (siehe Option + »\texttt{List of \PName{Mehrzahl des Eintragstyps}}« (siehe Option \Option{types}) verwendet, wobei das erste Zeichen der \PName{Mehrzahl des - Eintragstyps} in einen Großbuchstaben gewandelt wird. Es wird auch ein + Eintragstyps} in einen Großbuchstaben gewandelt wird. Es wird auch ein Makro \Macro{list\PName{Eintragstyp}name} mit diesem Wert definiert, der - jederzeit geändert werden kann. Dieses Makro wird jedoch nur definiert, - wenn es nicht bereits definiert ist oder zusätzlich Option + jederzeit geändert werden kann. Dieses Makro wird jedoch nur definiert, + wenn es nicht bereits definiert ist oder zusätzlich Option \Option{forcenames} gesetzt ist.}% \entry{\OptionVName{name}{Eintragsname}}{% - Sowohl als optionaler Präfix für die Einträge im Verzeichnis als auch für + Sowohl als optionaler Präfix für die Einträge im Verzeichnis als auch für die Beschriftung in einer Gleitumgebung (siehe Option \Option{float}) oder einer nicht gleitenden Umgebung (siehe Option \Option{nonfloat}) wird ein - Name für einen Eintrag in das Verzeichnis benötigt. Ohne diese Option wird + Name für einen Eintrag in das Verzeichnis benötigt. Ohne diese Option wird als \PName{Eintragsname} der \PName{Eintragstyp} (siehe Option \Option{type}) verwendet, bei dem das erste Zeichen in einen - Großbuchstaben gewandelt wird. Es wird auch ein Makro + Großbuchstaben gewandelt wird. Es wird auch ein Makro \Macro{\PName{Eintragstyp}name} mit diesem Wert definiert, der jederzeit - geändert werden kann. Dieses Makro wird jedoch nur definiert, wenn es - nicht bereits definiert ist oder zusätzlich Option \Option{forcenames} + geändert werden kann. Dieses Makro wird jedoch nur definiert, wenn es + nicht bereits definiert ist oder zusätzlich Option \Option{forcenames} gesetzt ist.}% \entry{\Option{nonfloat}}{% Es wird nicht nur ein neuer Verzeichnistyp definiert, sondern auch eine nicht gleitende Umgebungen \Environment{\PName{Eintragstyp}-} (siehe - Option \Option{type}), die ähnlich wie eine Gleitumgebung verwendet werden + Option \Option{type}), die ähnlich wie eine Gleitumgebung verwendet werden kann, jedoch nicht gleitet und auch nicht die Grenzen der Umgebung, in der sie verwendet wird, durchbricht.}% \entry{\OptionVName{owner}{Besitzer}}{% Jedes neue Verzeichnis hat bei \Package{tocbasic} einen Besitzer (siehe \autoref{sec:tocbasic.basics}). Dieser kann hier angegeben werden. Ist - kein Besitzer angegeben, so wird der Besitzer »\PValue{float}« verwendet, - den auch die \KOMAScript-Klassen für das Abbildungs- und das + kein Besitzer angegeben, so wird der Besitzer »\PValue{float}« verwendet, + den auch die \KOMAScript-Klassen für das Abbildungs- und das Tabellenverzeichnis verwenden.}% \entry{\OptionVName{setup}{Liste von Eigenschaften}}{% \ChangedAt{v3.25}{\Package{tocbasic}}% Die \PName{Liste von Eigenschaften} wird via \DescRef{\LabelBase.cmd.setuptoc} gesetzt. Es wird darauf hingewiesen, - dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die + dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die \PName{Liste von Eigenschaften} in geschweifte Klammern gesetzt werden muss.% }% \entry{\OptionVName{tocentrystyle}{Eintragsstil}}{% \ChangedAt{v3.20}{\Package{tocbasic}}% - \PName{Eintragsstil} gibt den Stil an, den Einträge in das entsprechende - Verzeichnis haben sollen. Der Name der Eintragsebene wird dabei über - Option \Option{type} bestimmt. Zusätzlich zu den Optionen dieser Tabelle - können auch alle Eigenschaften des Stils als Optionen angegeben werden, - indem die Namen der Eigenschaften mit dem Präfix \PValue{toc} ergänzt + \PName{Eintragsstil} gibt den Stil an, den Einträge in das entsprechende + Verzeichnis haben sollen. Der Name der Eintragsebene wird dabei über + Option \Option{type} bestimmt. Zusätzlich zu den Optionen dieser Tabelle + können auch alle Eigenschaften des Stils als Optionen angegeben werden, + indem die Namen der Eigenschaften mit dem Präfix \PValue{toc} ergänzt werden. So kann der nummerische Wert der Ebene beispielsweise als - \Option{tocentrylevel} angegeben werden. Näheres zu den Stilen ist + \Option{tocentrylevel} angegeben werden. Näheres zu den Stilen ist \autoref{sec:tocbasic.tocstyle} ab \autopageref{sec:tocbasic.tocstyle} zu entnehmen.}% \entry{\OptionVName{tocentry\PName{Stiloption}}{Wert}}{% - \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}% - Weitere Optionen in Abhängigkeit vom via \Option{tocentrystyle} gewählten + \ChangedAt{v3.20}{\Package{tocbasic}}% + Weitere Optionen in Abhängigkeit vom via \Option{tocentrystyle} gewählten \PName{Eintragsstil}. Siehe dazu \autoref{sec:tocbasic.tocstyle} ab - \autopageref{sec:tocbasic.tocstyle}. Für die von \Package{tocbasic} + \autopageref{sec:tocbasic.tocstyle}. Für die von \Package{tocbasic} vordefinierten Verzeichniseintragsstile finden sich die als \PName{Stiloption} verwendbaren Attribute in \autoref{tab:tocbasic.tocstyle.attributes}, ab \autopageref{tab:tocbasic.tocstyle.attributes}.% }% \entry{\OptionVName{type}{Eintragstyp}}{% - \PName{Eintragstyp} gibt den Typ der Einträge in das entsprechende - Verzeichnis an. Der Typ wird auch als Basisname für verschiedene Makros - und gegebenenfalls Umgebungen und Zähler verwendet. Er sollte daher nur - aus Buchstaben bestehen. Wird diese Option nicht verwendet, so wird für + \PName{Eintragstyp} gibt den Typ der Einträge in das entsprechende + Verzeichnis an. Der Typ wird auch als Basisname für verschiedene Makros + und gegebenenfalls Umgebungen und Zähler verwendet. Er sollte daher nur + aus Buchstaben bestehen. Wird diese Option nicht verwendet, so wird für \PName{Eintragstyp} die \PName{Dateierweiterung} aus dem obligatorischen Argument verwendet.}% \entry{\OptionVName{types}{Mehrzahl des Eintragstyps}}{% @@ -2501,12 +2652,12 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, verwendet, beispielsweise um eine Anweisung \Macro{listof\PName{Mehrzahl des Eintragstyps}} zu definieren. Wird diese Option nicht verwendet, so wird als \PName{Mehrzahl des Eintragstyps} der Wert von - \Option{type} mit angehängtem »s« verwendet.}% + \Option{type} mit angehängtem »s« verwendet.}% \entry{\OptionVName{unset}{Liste von Eigenschaften}}{% \ChangedAt{v3.25}{\Package{tocbasic}}% Die \PName{Liste von Eigenschaften} wird via \DescRef{\LabelBase.cmd.unsettoc} aufgehoben. Es wird darauf hingewiesen, - dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die + dass für die Angabe mehrerer durch Komma getrennter Eigenschaften die \PName{Liste von Eigenschaften} in geschweifte Klammern gesetzt werden muss.% }% @@ -2514,7 +2665,7 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, \begin{Example} Das Beispiel aus \autoref{sec:tocbasic.example} kann mit Hilfe der neuen - Anweisung deutlich verkürzt werden: + Anweisung deutlich verkürzt werden: \begin{lstcode} \DeclareNewTOC[% type=remarkbox,% @@ -2527,24 +2678,24 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, \setuptoc{lor}{chapteratlist} \end{lstcode} Neben den Umgebungen \Environment{remarkbox} und \Environment{remarkbox*} - sind damit auch der Zähler \Counter{remarkbox}, die zur Ausgabe gehörenden + sind damit auch der Zähler \Counter{remarkbox}, die zur Ausgabe gehörenden Anweisungen \Macro{theremarkbox}, \Macro{remarkboxname} und - \Macro{remarkboxformat}, die für das Verzeichnis benötigten + \Macro{remarkboxformat}, die für das Verzeichnis benötigten \Macro{listremarkboxname} und \Macro{listofremarkboxes} sowie einige intern verwendete Anweisungen mit Bezug auf die Dateiendung \File{lor} - definiert. Soll der Gleitumgebungstyp dem Paket überlassen werden, so kann - Option \Option{floattype} im Beispiel entfallen. Wird zusätzlich - die Option \Option{nonfloat} angegeben, wird außerdem eine nicht gleitende + definiert. Soll der Gleitumgebungstyp dem Paket überlassen werden, so kann + Option \Option{floattype} im Beispiel entfallen. Wird zusätzlich + die Option \Option{nonfloat} angegeben, wird außerdem eine nicht gleitende Umgebung \Environment{remarkbox-} definiert, in der ebenfalls \DescRef{maincls.cmd.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 + 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.% + Umgebungen für Abbildungen.% \begin{table} \centering - \caption{Gegenüberstellung von Beispielumgebung \Environment{remarkbox} + \caption{Gegenüberstellung von Beispielumgebung \Environment{remarkbox} und Umgebung \Environment{figure}} \label{tab:tocbasic.comparison} \begin{tabularx}{\textwidth}{l@{\hskip\tabcolsep}l@{\hskip\tabcolsep}>{\raggedright}p{7em}@{\hskip\tabcolsep}X} @@ -2564,16 +2715,16 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, & Gleitumgebung des jeweiligen Typs.\\[1ex] \Environment{remarkbox*} & \Environment{figure*} & \Option{type}, \Option{float} - & spaltenübergreifende Gleitumgebung des jeweiligen Typs \\[1ex] + & spaltenübergreifende Gleitumgebung des jeweiligen Typs \\[1ex] \Counter{remarkbox} & \Counter{figure} & \Option{type}, \Option{float} - & Zähler, der von \DescRef{maincls.cmd.caption} verwendet wird \\[1ex] + & Zähler, der von \DescRef{maincls.cmd.caption} verwendet wird \\[1ex] \Macro{theremarkbox} & \Macro{thefigure} & \Option{type}, \Option{float} - & Anweisung zur Ausgabe des jeweiligen Zählers \\[1ex] + & Anweisung zur Ausgabe des jeweiligen Zählers \\[1ex] \Macro{remarkboxformat} & \DescRef{maincls.cmd.figureformat} & \Option{type}, \Option{float} - & Anweisung zur Formatierung des jeweiligen Zählers in der Ausgabe von + & Anweisung zur Formatierung des jeweiligen Zählers in der Ausgabe von \DescRef{maincls.cmd.caption}\\[1ex] \Macro{remarkboxname} & \Macro{figurename} & \Option{type}, \Option{float}, \Option{name} @@ -2584,19 +2735,19 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, & Anweisung zur Ausgabe des jeweiligen Verzeichnisses \\[1ex] \Macro{listremarkboxname} & \Macro{listfigurename} & \Option{type}, \Option{float}, \Option{listname} - & Überschrift des jeweiligen Verzeichnisses \\[1ex] + & Ãœ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 \\ + & Dateiendung der Hilfsdatei für das jeweilige Verzeichnis \\ \bottomrule \end{tabularx} \end{table} - Und hier nun eine mögliche Verwendung der Umgebung: + Und hier nun eine mögliche Verwendung der Umgebung: \begin{lstcode} \begin{remarkbox} \centering @@ -2606,7 +2757,7 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, \label{rem:typo1} \end{remarkbox} \end{lstcode} - Ein Ausschnitt aus einer Beispielseite mit dieser Umgebung könnte dann so + Ein Ausschnitt aus einer Beispielseite mit dieser Umgebung könnte dann so aussehen: \begin{center}\footnotesize \begin{tabular} @@ -2629,11 +2780,11 @@ möglich. Siehe dazu \autoref{sec:tocbasic.tocstyle}, Benutzer von \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}} -sollten Option \Option{listname} übrigens immer angeben. Anderenfalls kommt es +sollten Option \Option{listname} übrigens immer angeben. Anderenfalls kommt es in der Regel zu einer Fehlermeldung, weil \Package{hyperref} nicht mit dem \Macro{MakeUppercase}\IndexCmd{MakeUppercase} im Namen des Verzeichnisses -zurecht kommt, das benötigt wird, um den ersten Buchstaben des Wertes von -\Option{types} in Großbuchstaben zu wandeln.% +zurecht kommt, das benötigt wird, um den ersten Buchstaben des Wertes von +\Option{types} in Großbuchstaben zu wandeln.% \EndIndexGroup % \EndIndexGroup @@ -2643,21 +2794,21 @@ zurecht kommt, das benötigt wird, um den ersten Buchstaben des Wertes von %%% Local Variables: %%% mode: latex %%% mode: flyspell -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% ispell-local-dictionary: "de_DE" %%% TeX-master: "../guide" %%% End: % LocalWords: Verzeichnisdatei Klonquelle Absatzabstandes Absatzabstand -% LocalWords: Verzeichniseinträge Verzeichniseintrag Eintragsstile -% LocalWords: Inhaltsverzeichniseinträge Standardklassen Nummernbreite +% LocalWords: Verzeichniseinträge Verzeichniseintrag Eintragsstile +% LocalWords: Inhaltsverzeichniseinträge Standardklassen Nummernbreite % LocalWords: Standardeigenschaft Eintragsebene Optionenliste expandierbar % LocalWords: Standardverzeichniseintragsstil Verzeichniseigenschaften % LocalWords: Verzeichniseintragsstil Verzeichniseintragsstils Eintragsstil -% LocalWords: Kapitelüberschrift Gliederungsebene expandierbares +% LocalWords: Kapitelüberschrift Gliederungsebene expandierbares % LocalWords: Eintragsnummer Initialisierungscode Aktivierungswerte % LocalWords: Deaktivierungswert Verzeichnistitel Eintragstyp Eintragstyps -% LocalWords: Verzeichniseintrags Säumniswert Überschriftenanweisung +% LocalWords: Verzeichniseintrags Säumniswert Ãœberschriftenanweisung % LocalWords: Eintragstext Dateierweiterung Dateierweiterungen Paketautoren % LocalWords: Verzeichnisbefehle Verzeichnisdaten Schrifteinstellungen -% LocalWords: Eintragsebenen Platzierungsoptionen Kapiteleinträge +% LocalWords: Eintragsebenen Platzierungsoptionen Kapiteleinträge diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/typearea-experts.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/typearea-experts.tex index 9b071f0edd..abd6a81675 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/typearea-experts.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/typearea-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % typearea-experts.tex -% Copyright (c) Markus Kohm, 2008-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2008-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,138 +40,138 @@ % % ---------------------------------------------------------------------- % -% Kapitel über typearea in der KOMA-Script-Anleitung Teil II +% Kapitel über typearea in der KOMA-Script-Anleitung Teil II % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{typearea-experts.tex} - [$Date: 2018-01-31 09:49:41 +0100 (Wed, 31 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: typearea for experts)] -\chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}} +\chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}} \labelbase{typearea-experts} \BeginIndexGroup \BeginIndex{Package}{typearea} In diesem Kapitel finden Sie -zusätzliche Informationen zum Paket +zusätzliche Informationen zum Paket \hyperref[cha:typearea]{\Package{typearea}}. \iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch \cite{book:komascript} vorbehalten. Dies sollte kein Problem sein, denn der}{Der} normale Anwender, der das Paket einfach nur verwenden will, wird diese Informationen eher selten -benötigen. Ein Teil der Informationen richtet sich an Anwender, die -ausgefallene Aufgaben lösen oder eigene Pakete schreiben wollen, die auf +benötigen. Ein Teil der Informationen richtet sich an Anwender, die +ausgefallene Aufgaben lösen oder eigene Pakete schreiben wollen, die auf \Package{typearea} basieren. Ein weiterer Teil der Informationen behandelt -Möglichkeiten von \Package{typearea}, die aus Gründen der Kompatibilität zu -den Standardklassen oder früheren Versionen von \KOMAScript{} existieren. Die -Teile, die nur aus Gründen der Kompatibilität zu früheren Versionen von +Möglichkeiten von \Package{typearea}, die aus Gründen der Kompatibilität zu +den Standardklassen oder früheren Versionen von \KOMAScript{} existieren. Die +Teile, die nur aus Gründen der Kompatibilität zu früheren Versionen von \KOMAScript{} existieren, sind in serifenloser Schrift gesetzt und sollten nicht mehr verwendet werden. -\section{Experimentelle Möglichkeiten} +\section{Experimentelle Möglichkeiten} \seclabel{experimental} -In diesem Abschnitt werden experimentelle Möglichkeiten +In diesem Abschnitt werden experimentelle Möglichkeiten beschrieben. Experimentell bedeutet in diesem Zusammenhang, dass die Funktion -nicht garantiert werden kann. Dafür kann es zwei Gründe geben. Zum einen -steht die endgültige Funktion oder Implementierung eventuell noch nicht -abschließend fest. Zum anderen hängen die Möglichkeiten teilweise von Interna -anderer Pakete ab und können deshalb in ihrer Funktion nur so lange garantiert -werden, wie diese anderen Pakete nicht geändert werden. +nicht garantiert werden kann. Dafür kann es zwei Gründe geben. Zum einen +steht die endgültige Funktion oder Implementierung eventuell noch nicht +abschließend fest. Zum anderen hängen die Möglichkeiten teilweise von Interna +anderer Pakete ab und können deshalb in ihrer Funktion nur so lange garantiert +werden, wie diese anderen Pakete nicht geändert werden. \begin{Declaration} \OptionVName{usegeometry}{Ein-Aus-Wert} \end{Declaration} -Normalerweise kümmert sich \Package{typearea} wenig darum, ob es in irgend +Normalerweise kümmert sich \Package{typearea} wenig darum, ob es in irgend einer Konstellation zusammen mit dem Paket \Package{geometry}\IndexPackage{geometry} (siehe \cite{package:geometry}) verwendet wird. Das bedeutet insbesondere, dass \Package{geometry} nach wie vor nichts davon mitbekommt, wenn man mit \Package{typearea} beispielsweise -die Papiergröße ändert -- etwas, das \Package{geometry} selbst gar nicht +die Papiergröße ändert -- etwas, das \Package{geometry} selbst gar nicht bietet. Sobald\ChangedAt{v3.17}{\Package{typearea}} Option \Option{usegeometry} -gesetzt wird, versucht \Package{typearea}, alle eigenen Optionen für -\Package{geometry} in dessen Optionen zu übersetzen. Innerhalb des Dokuments +gesetzt wird, versucht \Package{typearea}, alle eigenen Optionen für +\Package{geometry} in dessen Optionen zu übersetzen. Innerhalb des Dokuments wird sogar \Macro{newgeometry} aufgerufen, wenn neue Parameter aktiviert werden (siehe \DescRef{\LabelBase.cmd.activateareas} im nachfolgenden -Abschnitt). Da \Package{geometry} keine Änderung der Papiergröße oder -Papierausrichtung via \Macro{newgeometry} bietet, wird diese bei Bedarf über -interne Anweisungen und Längen von \Package{geometry} umgesetzt. Getestet ist -dies für \Package{geometry}~5.3 bis 5.6. +Abschnitt). Da \Package{geometry} keine Änderung der Papiergröße oder +Papierausrichtung via \Macro{newgeometry} bietet, wird diese bei Bedarf über +interne Anweisungen und Längen von \Package{geometry} umgesetzt. Getestet ist +dies für \Package{geometry}~5.3 bis 5.6. -Die Option bedeutet übrigens nicht, dass bei Verwendung von \Package{geometry} -nach einer Papiergrößen- oder Papierausrichtungsänderung mit +Die Option bedeutet übrigens nicht, dass bei Verwendung von \Package{geometry} +nach einer Papiergrößen- oder Papierausrichtungsänderung mit \Package{typearea} das neue Papier direkt optimal genutzt wird. Da -\Package{geometry} aus Komfortgründen deutlich mehr Optionen für die -Papiereinstellung bietet, als für die Bestimmung von Textbereich, Rändern, -Kopf, Fuß etc. benötigt werden -- man spricht von \emph{Überbestimmung} -- und +\Package{geometry} aus Komfortgründen deutlich mehr Optionen für die +Papiereinstellung bietet, als für die Bestimmung von Textbereich, Rändern, +Kopf, Fuß etc. benötigt werden -- man spricht von \emph{Ãœberbestimmung} -- und gleichzeitig bei neuen Aufrufen von \Macro{newgeometry} fehlende Angaben aus bereits bekannten ableitet -- man spricht von \emph{Werterhalt} --, -muss man gegebenenfalls durch vollständige Bestimmung neuer Werte -bei einem eigenen Aufruf von \Macro{newgeometry} alle gewünschten -Einstellungen explizit vornehmen. Nichts desto Trotz kann die Berücksichtigung -von \Package{geometry} durch \Package{typearea} zusätzliche Möglichkeiten -eröffnen. +muss man gegebenenfalls durch vollständige Bestimmung neuer Werte +bei einem eigenen Aufruf von \Macro{newgeometry} alle gewünschten +Einstellungen explizit vornehmen. Nichts desto Trotz kann die Berücksichtigung +von \Package{geometry} durch \Package{typearea} zusätzliche Möglichkeiten +eröffnen. {\setlength{\emergencystretch}{1em}% -Von \Package{typearea} werden mit \Option{usegeometry} für \Package{geometry} +Von \Package{typearea} werden mit \Option{usegeometry} für \Package{geometry} derzeit die Optionen \Option{bindingoffset}, \Option{footskip}, \Option{headheight}, \Option{headsep}, \Option{includefoot}, \Option{includehead}, \Option{includemp}, \Option{lmargin}, \Option{marginparsep}, \Option{marginparwidth}, \Option{textheight}, \Option{textwidth}, \Option{top} -und in der Dokumentpräambel zusätzlich \Option{paperheight} und +und in der Dokumentpräambel zusätzlich \Option{paperheight} und \Option{paperwidth} gesetzt.\par}% \EndIndexGroup \begin{Declaration} \OptionVName{areasetadvanced}{Ein-Aus-Wert} - \Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe} + \Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe} \end{Declaration} -Normalerweise berücksichtigt \DescRef{typearea.cmd.areaset} Optionen zur -Bestimmung der Höhe von Kopf und Fuß oder zur Festlegung, ob Randelemente Teil +Normalerweise berücksichtigt \DescRef{typearea.cmd.areaset} Optionen zur +Bestimmung der Höhe von Kopf und Fuß oder zur Festlegung, ob Randelemente Teil des Satzspiegels sein sollen, nicht in gleicher Weise wie \DescRef{typearea.cmd.typearea}. Mit Option \Option{areasetadvanced}\ChangedAt{v3.11}{\Package{typearea}} kann jedoch -eingestellt werden, dass sich \DescRef{typearea.cmd.areaset} diesbezüglich +eingestellt werden, dass sich \DescRef{typearea.cmd.areaset} diesbezüglich mehr wie \DescRef{typearea.cmd.typearea} verhalten soll. Trotzdem -unterscheiden sich Einstellungen, die zu gleich großen Textbereichen führen +unterscheiden sich Einstellungen, die zu gleich großen Textbereichen führen zwischen den beiden Befehlen weiterhin, da \DescRef{typearea.cmd.typearea} immer auf ganze Zeile rundet und dabei gegebenenfalls den unteren Rand um bis -zu eine Zeile kleiner wählt, während \DescRef{typearea.cmd.areaset} den oberen -und unteren Rand immer im Verhältnis 1:2 einstellt. Die Textbereiche der -unterschiedlichen Befehle können also bei gleicher Größe vertikal leicht +zu eine Zeile kleiner wählt, während \DescRef{typearea.cmd.areaset} den oberen +und unteren Rand immer im Verhältnis 1:2 einstellt. Die Textbereiche der +unterschiedlichen Befehle können also bei gleicher Größe vertikal leicht verschoben sein.% \EndIndexGroup -\section{Anweisungen für Experten} +\section{Anweisungen für Experten} \seclabel{experts} -In diesem Abschnitt werden Anweisungen beschrieben, die für den normalen +In diesem Abschnitt werden Anweisungen beschrieben, die für den normalen Anwender kaum oder gar nicht von Interesse sind. Experten bieten diese -Anweisungen zusätzliche Möglichkeiten.\iffree{ Da die Beschreibungen für - Experten gedacht sind, sind sie kürzer gefasst.}{} +Anweisungen zusätzliche Möglichkeiten.\iffree{ Da die Beschreibungen für + Experten gedacht sind, sind sie kürzer gefasst.}{} \begin{Declaration} \Macro{activateareas} \end{Declaration}% -Diese Anweisung wird von \Package{typearea} genutzt, um die Einstellungen für -Satzspiegel und Ränder in die internen \LaTeX-Längen zu übertragen, wenn der +Diese Anweisung wird von \Package{typearea} genutzt, um die Einstellungen für +Satzspiegel und Ränder in die internen \LaTeX-Längen zu übertragen, wenn der Satzspiegel innerhalb des Dokuments, also nach \Macro{begin}\PParameter{document} neu berechnet wurde. Wurde die Option -\DescRef{typearea.option.pagesize} verwendet, so wird diese anschließend mit +\DescRef{typearea.option.pagesize} verwendet, so wird diese anschließend mit demselben Wert neu aufgerufen. Damit kann beispielsweise innerhalb von -PDF-Dokumenten die Seitengröße tatsächlich variieren. - -Experten können diese Anweisung auch verwenden, wenn Sie aus irgendwelchen -Gründen Längen wie \Length{textwidth} oder \Length{textheight} innerhalb des -Dokuments manuell geändert haben. Der Experte ist dabei für eventuell -notwendige Seitenumbrüche vor oder nach der Verwendung jedoch selbst -verantwortlich! Darüber hinaus sind alle von \Macro{activateareas} -durchgeführten Änderungen lokal!% +PDF-Dokumenten die Seitengröße tatsächlich variieren. + +Experten können diese Anweisung auch verwenden, wenn Sie aus irgendwelchen +Gründen Längen wie \Length{textwidth} oder \Length{textheight} innerhalb des +Dokuments manuell geändert haben. Der Experte ist dabei für eventuell +notwendige Seitenumbrüche vor oder nach der Verwendung jedoch selbst +verantwortlich! Darüber hinaus sind alle von \Macro{activateareas} +durchgeführten Änderungen lokal!% % \EndIndexGroup @@ -183,10 +183,10 @@ durchgeführten Änderungen lokal!% \Macro{AfterRestoreareas}\Parameter{Code} \Macro{AfterRestoreareas*}\Parameter{Code} \end{Declaration} -Mit Hilfe von \Macro{storeareas} wird eine \PName{Anweisung} definiert, über +Mit Hilfe von \Macro{storeareas} wird eine \PName{Anweisung} definiert, über die alle aktuellen Seitenspiegeleinstellungen wieder hergestellt werden -können. So ist es möglich, die aktuellen Einstellungen zu speichern, -anschließend die Einstellungen zu ändern und dann die gespeicherten +können. So ist es möglich, die aktuellen Einstellungen zu speichern, +anschließend die Einstellungen zu ändern und dann die gespeicherten Einstellungen wieder zu reaktivieren. \begin{Example} @@ -210,14 +210,14 @@ Einstellungen wieder zu reaktivieren. Wichtig\textnote{Achtung!} ist dabei die Anweisung \DescRef{maincls.cmd.clearpage} vor dem Aufruf von \Macro{meinegespeichertenWerte}, damit die Wiederherstellung erst auf der - nächsten Seite erfolgt. Bei doppelseitigen Dokumenten sollte bei Änderungen + nächsten Seite erfolgt. Bei doppelseitigen Dokumenten sollte bei Änderungen am Papierformat stattdessen sogar \DescRef{maincls.cmd.cleardoubleoddpage}\IndexCmd{cleardoubleoddpage} oder -- wenn keine \KOMAScript-Klasse zum Einsatz kommt -- \DescRef{maincls.cmd.cleardoublepage}\IndexCmd{cleardoublepage} verwendet werden.% - \iffree{\par Außerdem wird \Macro{noindent} verwendet, um den normalen - Absatzeinzug vor den schwarzen Kästen zu verhindern. Sie würden sonst kein + \iffree{\par Außerdem wird \Macro{noindent} verwendet, um den normalen + Absatzeinzug vor den schwarzen Kästen zu verhindern. Sie würden sonst kein korrektes Bild des Seitenlayouts wiedergeben.}{}% \end{Example} @@ -229,17 +229,17 @@ nicht innerhalb einer Gruppe aufgerufen werden sollten. Die Definition der erneuter Verwendung einer bereits definierten \PName{Anweisung} wird eine entsprechende Fehlermeldung ausgegeben. -Oftmals\ChangedAt{v3.18}{\Package{typearea}} ist auch erwünscht, vor der -Wiederherstellung der Einstelllungen per \PName{Anweisung} grundsätzlich +Oftmals\ChangedAt{v3.18}{\Package{typearea}} ist auch erwünscht, vor der +Wiederherstellung der Einstelllungen per \PName{Anweisung} grundsätzlich bestimmte Aktionen wie beispielsweise ein -\DescRef{maincls.cmd.cleardoubleoddpage} auszuführen. Dies kann man mit Hilfe +\DescRef{maincls.cmd.cleardoubleoddpage} auszuführen. Dies kann man mit Hilfe von \Macro{BeforeRestoreareas} und \Macro{BeforeRestoreareas*} erreichen. Entsprechend kann man mit \Macro{AfterRestoreareas} und \Macro{AfterRestoreareas*} \PName{Code} nach der Wiederherstellung der -Einstellungen ausführen lassen. Die Formen mit und ohne Stern unterscheiden -sich insoweit, als die Sternform nur für noch nicht per \Macro{storeareas} -gespeicherte Einstellungen gilt, während sich die Variante ohne Stern auch auf -die zukünftige Verwendung bereits früher gespeicherter Einstellungen +Einstellungen ausführen lassen. Die Formen mit und ohne Stern unterscheiden +sich insoweit, als die Sternform nur für noch nicht per \Macro{storeareas} +gespeicherte Einstellungen gilt, während sich die Variante ohne Stern auch auf +die zukünftige Verwendung bereits früher gespeicherter Einstellungen auswirkt.% % \EndIndexGroup @@ -253,19 +253,19 @@ auswirkt.% \end{Declaration}% Diese Anweisungen dienen der Verwaltung zweier Haken\Index{Haken} (engl. \emph{hooks}\Index{hook=\emph{hook}}). Die ersten beiden, -\Macro{AfterCalculatingTypearea} und deren Sternform, ermöglichen es dem +\Macro{AfterCalculatingTypearea} und deren Sternform, ermöglichen es dem Experten jedes Mal, nachdem \Package{typearea} eine neue Auf"|teilung in -Satzspiegel und Ränder berechnet hat, also nach jeder impliziten oder -expliziten Ausführung von \DescRef{typearea.cmd.typearea}, \PName{Anweisungen} -ausführen zu lassen. Entsprechendes leisten +Satzspiegel und Ränder berechnet hat, also nach jeder impliziten oder +expliziten Ausführung von \DescRef{typearea.cmd.typearea}, \PName{Anweisungen} +ausführen zu lassen. Entsprechendes leisten \Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} und dessen -Stern-Form für die Ausführung von \DescRef{typearea.cmd.areaset}. Die -Normalformen arbeiten dabei global, während die Änderungen durch die +Stern-Form für die Ausführung von \DescRef{typearea.cmd.areaset}. Die +Normalformen arbeiten dabei global, während die Änderungen durch die Sternformen nur lokal wirksam sind. Die \PName{Anweisungen} werden jeweils -unmittelbar vor \DescRef{\LabelBase.cmd.activateareas} ausgeführt.\iffree{}{ - In \autoref{cha:modernletters} wird für die \emph{Letter-Class-Option} +unmittelbar vor \DescRef{\LabelBase.cmd.activateareas} ausgeführt.\iffree{}{ + In \autoref{cha:modernletters} wird für die \emph{Letter-Class-Option} \File{asymTypB.lco} davon Gebrauch gemacht, um die Randverteilung zu - ändern.}% + ändern.}% % \EndIndexGroup @@ -285,7 +285,7 @@ unmittelbar vor \DescRef{\LabelBase.cmd.activateareas} ausgeführt.\iffree{}{ %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/typearea.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/typearea.tex index 0ff9dd4573..fd8019b904 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/typearea.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/typearea.tex @@ -1,6 +1,6 @@ % ====================================================================== % typearea.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % 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-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -40,14 +40,14 @@ % % ---------------------------------------------------------------------- % -% Kapitel über typearea in der KOMA-Script-Anleitung +% Kapitel über typearea in der KOMA-Script-Anleitung % Verwaltet von Markus Kohm % % ====================================================================== \KOMAProvidesFile{typearea.tex} - [$Date: 2018-01-31 13:01:01 +0100 (Wed, 31 Jan 2018) $ + [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: typearea)] \chapter{Satzspiegelberechnung mit \Package{typearea.sty}} \labelbase{typearea} @@ -55,23 +55,23 @@ \BeginIndexGroup% \BeginIndex{Package}{typearea}% Viele \LaTeX-Klassen\iffree{, darunter auch die Standardklassen,}{} bieten dem -Anwender eine weitgehend feste Auf"|teilung von Rändern und Textbereich. Bei +Anwender eine weitgehend feste Auf"|teilung von Rändern und Textbereich. Bei den Standardklassen ist die konkrete Auf"|teilung in engen Grenzen von der -gewählten Schriftgröße abhängig. Darüber hinaus gibt es Pakete wie +gewählten Schriftgröße abhängig. Darüber hinaus gibt es Pakete wie \Package{geometry}\IndexPackage{geometry} (siehe \cite{package:geometry}), die -dem Anwender die volle Kontrolle, aber auch die Verantwortung für die -Einstellungen des Textbereichs und der Ränder überlassen. +dem Anwender die volle Kontrolle, aber auch die Verantwortung für die +Einstellungen des Textbereichs und der Ränder überlassen. \KOMAScript{} geht mit dem Paket \Package{typearea} einen etwas anderen Weg. Hier werden basierend auf einer in der Typografie etablierten -Konstruktion Einstellmöglichkeiten und Automatismen geboten, die es dem +Konstruktion Einstellmöglichkeiten und Automatismen geboten, die es dem Anwender erleichtern, eine gute Wahl zu treffen. \iffalse% Umbruchoptimierung!!! Es wird darauf hingewiesen, dass sich \Package{typearea} des Pakets \Package{scrbase} bedient. Letzteres Paket ist im Expertenteil \iffree{dieser Anleitung}{dieses Buches} in \autoref{cha:scrbase} ab - \autopageref{cha:scrbase} erklärt. + \autopageref{cha:scrbase} erklärt. Die Mehrzahl der dort dokumentierten Anweisungen richtet sich jedoch nicht an Anwender, sondern an Klassen- und Paketautoren.% \fi @@ -81,17 +81,17 @@ Anwender erleichtern, eine gute Wahl zu treffen. \begin{Explain} Betrachtet man eine einzelne Seite eines Buches oder eines anderen - Druckwerkes, so besteht diese auf den ersten Blick aus den Rändern% + Druckwerkes, so besteht diese auf den ersten Blick aus den Rändern% \iffalse% Umbruchkorrekturtext - \footnote{Der Autor und der Lektor haben an dieser Stelle überlegt, ob eine - Seite nicht nur einen umlaufenden Rand hat und daher von »dem Rand« die - Rede sein müsste. Da jedoch \LaTeX{} diesen einen Rand logisch in mehrere - Ränder unterteilt, die getrennt bestimmt werden, ist hier auch von »den - Rändern« die Rede.}% + \footnote{Der Autor und der Lektor haben an dieser Stelle überlegt, ob eine + Seite nicht nur einen umlaufenden Rand hat und daher von »dem Rand« die + Rede sein müsste. Da jedoch \LaTeX{} diesen einen Rand logisch in mehrere + Ränder unterteilt, die getrennt bestimmt werden, ist hier auch von »den + Rändern« die Rede.}% \fi% - , einem Kopfbereich, einem Textkörper und einem Fußbereich. Genauer - betrachtet, kommt noch ein Abstand zwischen Kopfbereich und Textkörper sowie - zwischen Textkörper und Fußbereich hinzu. Der Textkörper heißt in der + , einem Kopfbereich, einem Textkörper und einem Fußbereich. Genauer + betrachtet, kommt noch ein Abstand zwischen Kopfbereich und Textkörper sowie + zwischen Textkörper und Fußbereich hinzu. Der Textkörper heißt in der Fachsprache der Typografen und Setzer \emph{Satzspiegel}. Die Auf"|teilung dieser Bereiche sowie ihre Anordnung zueinander und auf dem Papier nennen wir \emph{Satzspiegeldefinition} oder @@ -99,31 +99,31 @@ Anwender erleichtern, eine gute Wahl zu treffen. In der Literatur werden verschiedene Algorithmen und heuristische Verfahren zur Konstruktion eines guten Satzspiegels vorgeschlagen und diskutiert% - \iffree{ \cite{DANTE:TK0402:MJK}}{. Einen Überblick über einige Möglichkeiten - und der dabei angenommenen Grundsätze gibt + \iffree{ \cite{DANTE:TK0402:MJK}}{. Einen Ãœberblick über einige Möglichkeiten + und der dabei angenommenen Grundsätze gibt \autoref{cha:typeareaconstruction}}% - . Häufig findet man ein Verfahren, das mit verschiedenen Diagonalen - und deren Schnittpunkten arbeitet. Das gewünschte Ergebnis ist, dass das - Seitenverhältnis des Satzspiegels dem Seitenverhältnis \emph{der Seite} - entspricht. Bei einem einseitigen\Index{einseitig} Dokument sollen außerdem - der linke und der rechte Rand gleich breit sein, während der obere zum - unteren Rand im Verhältnis 1:2 stehen sollte. Bei einem + . Häufig findet man ein Verfahren, das mit verschiedenen Diagonalen + und deren Schnittpunkten arbeitet. Das gewünschte Ergebnis ist, dass das + Seitenverhältnis des Satzspiegels dem Seitenverhältnis \emph{der Seite} + entspricht. Bei einem einseitigen\Index{einseitig} Dokument sollen außerdem + der linke und der rechte Rand gleich breit sein, während der obere zum + unteren Rand im Verhältnis 1:2 stehen sollte. Bei einem doppelseitigen\Index{doppelseitig} Dokument, beispielsweise einem Buch, ist - hingegen zu beachten, dass der gesamte innere Rand genauso groß sein sollte - wie jeder der beiden äußeren Ränder. Eine einzelne Seite steuert dabei - jeweils nur die Hälfte des inneren Randes bei. + hingegen zu beachten, dass der gesamte innere Rand genauso groß sein sollte + wie jeder der beiden äußeren Ränder. Eine einzelne Seite steuert dabei + jeweils nur die Hälfte des inneren Randes bei. - Im vorherigen Absatz wurde \emph{die Seite} erwähnt und - hervorgehoben. Irrtümlich wird oftmals angenommen, das Format der Seite wäre + Im vorherigen Absatz wurde \emph{die Seite} erwähnt und + hervorgehoben. Irrtümlich wird oftmals angenommen, das Format der Seite wäre mit dem Format des Papiers gleichzusetzen.\Index[indexmain]{Seiten>Format} \Index[indexmain]{Papier>Format} Betrachtet man jedoch ein gebundenes Druckerzeugnis, so ist zu erkennen, dass ein Teil des Papiers in der Bindung\Index[indexmain]{Bindung} verschwindet und nicht mehr als Seite zu - sehen ist. Für den Satzspiegel ist jedoch nicht entscheidend, welches Format - das Papier hat, sondern, was der Leser für einen Eindruck vom Format der + sehen ist. Für den Satzspiegel ist jedoch nicht entscheidend, welches Format + das Papier hat, sondern, was der Leser für einen Eindruck vom Format der Seite bekommt. Damit ist klar, dass bei der Berechnung des Satzspiegels der Teil, der durch die Bindung versteckt wird, aus dem Papierformat - herausgerechnet und dann zum inneren Rand hinzugefügt werden muss. Wir + herausgerechnet und dann zum inneren Rand hinzugefügt werden muss. Wir nennen diesen Teil \emph{Bindekorrektur}.\Index[indexmain]{Bindekorrektur}% \textnote{Bindekorrektur} @@ -131,68 +131,68 @@ Anwender erleichtern, eine gute Wahl zu treffen. \emph{Bundstegs}\Index{Bundsteg}, nicht jedoch des sichtbaren inneren Randes. - Die Bindekorrektur ist vom jeweiligen Produktionsvorgang abhängig und kann + Die Bindekorrektur ist vom jeweiligen Produktionsvorgang abhängig und kann nicht allgemein festgelegt werden. Es handelt sich dabei also um einen - Parameter, der für jeden Produktionsvorgang neu festzulegen ist. Im + Parameter, der für jeden Produktionsvorgang neu festzulegen ist. Im professionellen Bereich spielt dieser Wert nur eine geringe Rolle, da - ohnehin auf größere Papierbögen gedruckt und entsprechend geschnitten + ohnehin auf größere Papierbögen gedruckt und entsprechend geschnitten wird. Beim Schneiden wird dann wiederum sichergestellt, dass obige - Verhältnisse für die sichtbare Doppelseite eingehalten sind. + Verhältnisse für die sichtbare Doppelseite eingehalten sind. Wir wissen nun also, wie die einzelnen Teile zueinander stehen. Wir wissen aber noch nicht, wie breit und hoch der Satzspiegel ist. Kennen wir eines - dieser beiden Maße, so ergeben sich zusammen mit dem Papierformat und dem - Seitenformat oder der Bindekorrektur alle anderen Maße durch Lösung mehrerer + dieser beiden Maße, so ergeben sich zusammen mit dem Papierformat und dem + Seitenformat oder der Bindekorrektur alle anderen Maße durch Lösung mehrerer mathematischer Gleichungen: % Umbruchoptiomierung!!! \iffree{% \begin{align*} - \Var{Satzspiegelhöhe}\Index{Satzspiegel} : \Var{Satzspiegelbreite} &= - \Var{Seitenhöhe}\Index{Seite} : \Var{Seitenbreite} \\ + \Var{Satzspiegelhöhe}\Index{Satzspiegel} : \Var{Satzspiegelbreite} &= + \Var{Seitenhöhe}\Index{Seite} : \Var{Seitenbreite} \\ \Var{oberer~Rand}\Index{Rand} : \Var{unterer~Rand} &= \text{1} : \text{2} \\ \Var{linker~Rand} : \Var{rechter~Rand} &= \text{1} : \text{1} \\ % - \Var{innerer~Randanteil} : \Var{äußerer~Rand} &= \text{1} : \text{2} \\ + \Var{innerer~Randanteil} : \Var{äußerer~Rand} &= \text{1} : \text{2} \\ % \Var{Seitenbreite} &= \Var{Papierbreite}\Index{Papier} - \Var{Bindekorrektur}\Index{Bindekorrektur}\\ % \Var{oberer~Rand} + \Var{unterer~Rand} &= - \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\ + \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\ % \Var{linker~Rand} + \Var{rechter Rand} &= \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\ % - \Var{innerer Randanteil} + \Var{äußerer Rand} &= + \Var{innerer Randanteil} + \Var{äußerer Rand} &= \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\ % \Var{innerer~Randanteil} + \Var{Bindekorrektur} &= \Var{Bundsteg}\index{Bundsteg} \end{align*} }{% - % Umbruchkorrektur: Abstände verändert! + % Umbruchkorrektur: Abstände verändert! \begin{prepareformargin} \vskip -.5\baselineskip plus .25\baselineskip \begin{align*} - \Var{Satzspiegelhöhe}\Index{Satzspiegel} : \Var{Satzspiegelbreite} &= - \Var{Seitenhöhe}\Index{Seite} : \Var{Seitenbreite} \\ + \Var{Satzspiegelhöhe}\Index{Satzspiegel} : \Var{Satzspiegelbreite} &= + \Var{Seitenhöhe}\Index{Seite} : \Var{Seitenbreite} \\ \Var{oberer~Rand}\Index{Rand} : \Var{unterer~Rand} &= \text{1} : \text{2} \\ \Var{linker~Rand} : \Var{rechter~Rand} &= \text{1} : \text{1} \\ - \Var{innerer~Randanteil} : \Var{äußerer~Rand} &= + \Var{innerer~Randanteil} : \Var{äußerer~Rand} &= \text{1} : \text{2}\\ \Var{Seitenbreite} &= \Var{Papierbreite}\Index{Papier} - \Var{Bindekorrektur}\Index{Bindekorrektur} \\ \Var{oberer~Rand} + \Var{unterer~Rand} &= - \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\ + \Var{Seitenhöhe} - \Var{Satzspiegelhöhe} \\ % \Var{linker~Rand} + \Var{rechter Rand} &= \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\ % - \Var{innerer Randanteil} + \Var{äußerer Rand} &= + \Var{innerer Randanteil} + \Var{äußerer Rand} &= \Var{Seitenbreite} - \Var{Satzspiegelbreite} \\ % % \end{align*} @@ -207,98 +207,98 @@ Anwender erleichtern, eine gute Wahl zu treffen. }% \Index[indexmain]{Rand}% Dabei gibt es \Var{linker~Rand} und \Var{rechter~Rand} nur im einseitigen - Druck. Entsprechend gibt es \Var{innerer~Randanteil} und \Var{äußerer~Rand} + Druck. Entsprechend gibt es \Var{innerer~Randanteil} und \Var{äußerer~Rand} nur im doppelseitigen Druck. In den Gleichungen wird mit \Var{innerer~Randanteil} gearbeitet, weil der - komplette innere Rand ein Element der vollständigen Doppelseite ist. Zu - einer Seite gehört also nur die Hälfte des inneren Randes: + komplette innere Rand ein Element der vollständigen Doppelseite ist. Zu + einer Seite gehört also nur die Hälfte des inneren Randes: \Var{innerer~Randanteil}. Die Frage nach der Breite des Satzspiegels wird in der Literatur ebenfalls diskutiert. Die optimale Satzspiegelbreite ist von - verschiedenen Faktoren abhängig: + verschiedenen Faktoren abhängig: \iffree{\begin{itemize}}{\begin{itemize}[% Umbuchkorrektur topsep=.5\baselineskip plus .25\baselineskip minus .33\baselineskip, partopsep=.5\baselineskip plus .25\baselineskip minus .33\baselineskip, itemsep=.33\baselineskip plus .25\baselineskip minus .25\baselineskip, parsep=0pt ]} - \item Größe, Laufweite und Art der verwendeten Schrift, + \item Größe, Laufweite und Art der verwendeten Schrift, \item verwendeter Durchschuss, - \item Länge der Worte, - \item verfügbarer Platz. + \item Länge der Worte, + \item verfügbarer Platz. \end{itemize} Der Einfluss der Schrift wird deutlich, wenn man sich bewusst macht, wozu Serifen dienen. Serifen\Index[indexmain]{Serifen} sind kleine Striche an den Linienenden der Buchstaben. Buchstaben, die mit vertikalen Linien auf die Grundlinie der Textzeile treffen, - lösen diese eher auf, als dass sie das Auge auf der Linie halten. + lösen diese eher auf, als dass sie das Auge auf der Linie halten. Genau bei diesen Buchstaben liegen die Serifen horizontal auf - der Grundlinie und verstärken damit die Zeilenwirkung der Schrift. + der Grundlinie und verstärken damit die Zeilenwirkung der Schrift. Das Auge kann der Textzeile nicht nur beim Lesen der Worte, sondern - insbesondere auch beim schnellen Zurückspringen an den Anfang der - nächsten Zeile besser folgen. Damit darf die Zeile bei einer Schrift - mit Serifen genau genommen länger sein als bei einer Schrift ohne Serifen. + insbesondere auch beim schnellen Zurückspringen an den Anfang der + nächsten Zeile besser folgen. Damit darf die Zeile bei einer Schrift + mit Serifen genau genommen länger sein als bei einer Schrift ohne Serifen. Unter dem Durchschuss\Index[indexmain]{Durchschuss}\textnote{Durchschuss} versteht man den Abstand zwischen Textzeilen. Bei \LaTeX{} ist ein - Durchschuss von etwa 20\,\% der Schriftgröße voreingestellt. Mit Befehlen + Durchschuss von etwa 20\,\% der Schriftgröße voreingestellt. Mit Befehlen wie \Macro{linespread}\IndexCmd{linespread} oder besser mit Hilfe von Paketen wie \Package{setspace}\IndexPackage{setspace} (siehe - \cite{package:setspace}) kann der Durchschuss verändert werden. Ein großer + \cite{package:setspace}) kann der Durchschuss verändert werden. Ein großer Durchschuss erleichtert dem Auge die Verfolgung einer Zeile. Bei sehr - großem Durchschuss wird das Lesen aber dadurch gestört, dass das Auge - zwischen den Zeilen weite Wege zurücklegen muss. Daneben wird sich der + großem Durchschuss wird das Lesen aber dadurch gestört, dass das Auge + zwischen den Zeilen weite Wege zurücklegen muss. Daneben wird sich der Leser des entstehenden Streifeneffekts sehr deutlich und unangenehm - bewusst. Der Graueindruck der Seite ist in diesem Fall gestört. Dennoch - dürfen bei großem Durchschuss die Zeilen länger sein. + bewusst. Der Graueindruck der Seite ist in diesem Fall gestört. Dennoch + dürfen bei großem Durchschuss die Zeilen länger sein. - Auf der Suche nach konkreten Werten für gute - Zeilenlängen\Index[indexmain]{Zeilenlaenge=Zeilenlänge} findet man in der + Auf der Suche nach konkreten Werten für gute + Zeilenlängen\Index[indexmain]{Zeilenlaenge=Zeilenlänge} findet man in der Literatur je nach Autor unterschiedliche Angaben. Teilweise ist dies auch in - der Muttersprache des Autors begründet. Das Auge springt nämlich - üblicherweise von Wort zu Wort, wobei kurze Wörter diese Aufgabe - erleichtern. Über alle Sprachen und Schriftarten hinweg kann man sagen, dass - eine Zeilenlänge von 60 bis 70 Zeichen, einschließlich Leer- und - Satzzeichen, einen brauchbaren Kompromiss darstellt. Ein gut gewählter + der Muttersprache des Autors begründet. Das Auge springt nämlich + üblicherweise von Wort zu Wort, wobei kurze Wörter diese Aufgabe + erleichtern. Ãœber alle Sprachen und Schriftarten hinweg kann man sagen, dass + eine Zeilenlänge von 60 bis 70 Zeichen, einschließlich Leer- und + Satzzeichen, einen brauchbaren Kompromiss darstellt. Ein gut gewählter Durchschuss wird dabei vorausgesetzt. Bei den Voreinstellungen von \LaTeX{} - braucht man sich über Letzteres normalerweise keine Sorgen zu - machen. Größere Zeilenlängen darf man nur Gewohnheitslesern zumuten, die - täglich viele Stunden lesend zubringen. Aber auch dann sind Zeilenlängen + braucht man sich über Letzteres normalerweise keine Sorgen zu + machen. Größere Zeilenlängen darf man nur Gewohnheitslesern zumuten, die + täglich viele Stunden lesend zubringen. Aber auch dann sind Zeilenlängen jenseits von 80 Zeichen unzumutbar. In jedem Fall ist dann der Durchschuss - anzupassen. 5\,\% bis 10\,\% zusätzlich sind dabei als Faustregel + anzupassen. 5\,\% bis 10\,\% zusätzlich sind dabei als Faustregel empfehlenswert. Bei Schriften wie Palatino, die bereits bei einer normalen - Zeilenlänge nach 5\,\% mehr Durchschuss verlangt, können es auch mehr sein. + Zeilenlänge nach 5\,\% mehr Durchschuss verlangt, können es auch mehr sein. Bevor wir uns an die konkrete Konstruktion machen, fehlen jetzt nur noch Kleinigkeiten, die man wissen sollte. \LaTeX{} beginnt die erste Zeile des Textbereichs einer Seite nicht am oberen Rand des Textbereichs, sondern setzt die Grundlinie der Zeile mit einem definierten Mindestabstand zum - oberen Rand des Textbereichs. Des Weiteren verfügt \LaTeX{} über die beiden + oberen Rand des Textbereichs. Des Weiteren verfügt \LaTeX{} über die beiden Befehle \DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} und \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom}. Der erste dieser Befehle legt fest, dass die letzte Zeile einer jeden Seite dort liegen soll, - wo sie eben zu liegen kommt. Das kann dazu führen, dass sich die Position - der letzten Zeile von Seite zu Seite vertikal um nahezu eine Zeile verändern - kann -- bei Zusammentreffen des Seitenendes mit Überschriften, Abbildungen, - Tabellen oder Ähnlichem auch mehr. Im doppelseitigen Druck ist das in der - Regel unerwünscht. Mit dem zweiten Befehl, + wo sie eben zu liegen kommt. Das kann dazu führen, dass sich die Position + der letzten Zeile von Seite zu Seite vertikal um nahezu eine Zeile verändern + kann -- bei Zusammentreffen des Seitenendes mit Ãœberschriften, Abbildungen, + Tabellen oder Ähnlichem auch mehr. Im doppelseitigen Druck ist das in der + Regel unerwünscht. Mit dem zweiten Befehl, \DescRef{maincls.cmd.flushbottom}, wird hingegen festgelegt, dass die letzte Zeile immer am unteren Rand des Textbereichs zu liegen kommt. Um diesen vertikalen Ausgleich zu erreichen, muss \LaTeX{} gegebenenfalls dehnbare - vertikale Abstände über das erlaubte Maß hinaus strecken. Ein solcher + vertikale Abstände über das erlaubte Maß hinaus strecken. Ein solcher Abstand ist beispielsweise der Absatzabstand. Dies gilt in der Regel auch, wenn man gar keinen Absatzabstand verwendet. Um nicht bereits auf normalen - Seiten, auf denen der Absatzabstand das einzige dehnbare vertikale Maß - darstellt, eine Dehnung zu erzwingen, sollte die Höhe des Textbereichs ein - Vielfaches der Textzeilenhöhe zuzüglich des Abstandes der ersten Zeile vom + Seiten, auf denen der Absatzabstand das einzige dehnbare vertikale Maß + darstellt, eine Dehnung zu erzwingen, sollte die Höhe des Textbereichs ein + Vielfaches der Textzeilenhöhe zuzüglich des Abstandes der ersten Zeile vom oberen Rand des Textbereichs sein. \iffalse% Umbruchkorrektur Damit sind alle Grundlagen der Satzspiegelberechnung, die bei - {\KOMAScript} eine Rolle spielen, erklärt. + {\KOMAScript} eine Rolle spielen, erklärt. \else Soweit die Grundlagen. \fi @@ -306,7 +306,7 @@ Anwender erleichtern, eine gute Wahl zu treffen. Es folgen die beiden von \KOMAScript{} angebotenen Konstruktionen. \else \iffalse% Umbruchkorrektur - Wir können also mit den konkreten Konstruktionen beginnen. + Wir können also mit den konkreten Konstruktionen beginnen. \else In den folgenden beiden Abschnitten werden die von {\KOMAScript} angebotenen Konstruktionen im Detail vorgestellt. @@ -320,28 +320,28 @@ Anwender erleichtern, eine gute Wahl zu treffen. \begin{Explain} Der einfachste Weg, um zu erreichen, dass der Textbereich dasselbe - Seitenverhältnis aufweist wie die Seite, ist folgender:% + Seitenverhältnis aufweist wie die Seite, ist folgender:% \begin{itemize} - \item Zunächst zieht man an der Innenseite des Papiers den Teil - \Var{BCOR}\important{\Var{BCOR}}, der für die - Bindekorrektur\Index{Bindekorrektur} benötigt wird, ab und teilt die + \item Zunächst zieht man an der Innenseite des Papiers den Teil + \Var{BCOR}\important{\Var{BCOR}}, der für die + Bindekorrektur\Index{Bindekorrektur} benötigt wird, ab und teilt die restliche Seite vertikal in eine Anzahl \Var{DIV} gleich hoher Streifen. \item Dann teilt man die Seite horizontal in die gleiche Anzahl \Var{DIV}\important{\Var{DIV}} gleich breiter Streifen. \item Nun verwendet man den obersten horizontalen Streifen als oberen und die beiden untersten horizontalen Streifen als unteren Rand. Im - doppelseitigen Druck verwendet man außerdem den innersten vertikalen - Streifen als inneren und die beiden äußersten vertikalen Streifen als - äußeren Rand. + doppelseitigen Druck verwendet man außerdem den innersten vertikalen + Streifen als inneren und die beiden äußersten vertikalen Streifen als + äußeren Rand. \item Zum inneren Rand gibt man dann noch \Var{BCOR} hinzu. \end{itemize} - Was nun innerhalb der Seite noch übrig bleibt, ist der - Textbereich.\Index{Text>Bereich} Die Breite bzw. Höhe der Ränder und des + Was nun innerhalb der Seite noch übrig bleibt, ist der + Textbereich.\Index{Text>Bereich} Die Breite bzw. Höhe der Ränder und des Textbereichs resultiert damit automatisch aus der Anzahl \Var{DIV} der - Streifen. Da für die Ränder insgesamt jeweils drei Streifen benötigt werden, - muss \Var{DIV} zwingend größer als drei sein. Damit der Satzspiegel + Streifen. Da für die Ränder insgesamt jeweils drei Streifen benötigt werden, + muss \Var{DIV} zwingend größer als drei sein. Damit der Satzspiegel horizontal und vertikal jeweils mindestens doppelt so viel Platz wie die - Ränder einnimmt, sollte \Var{DIV} sogar mindestens 9 betragen. Mit diesem + Ränder einnimmt, sollte \Var{DIV} sogar mindestens 9 betragen. Mit diesem Wert ist die Konstruktion auch als \emph{klassische Neunerteilung} bekannt (siehe \autoref{fig:typearea.nineparts}). @@ -351,12 +351,12 @@ Anwender erleichtern, eine gute Wahl zu treffen. \setcapindent{0pt}% \setlength{\columnsep}{.6em}% \begin{captionbeside}[{% - Doppelseite mit der Rasterkonstruktion für die klassische + Doppelseite mit der Rasterkonstruktion für die klassische Neunerteilung nach Abzug einer Bindekorrektur% }]{% \label{fig:typearea.nineparts}% \hspace{0pt plus 1ex}% - Doppelseite mit der Rasterkonstruktion für die klassische + Doppelseite mit der Rasterkonstruktion für die klassische Neunerteilung nach Abzug einer Bindekorrektur% } [l] @@ -385,7 +385,7 @@ Anwender erleichtern, eine gute Wahl zu treffen. \rotatebox[origin=c]{-90}{Bindekorrektur}}} \put(44,66){\color{white}\makebox(132,198)[c]{Satzspiegel links}} \put(244,66){\color{white}\makebox(132,198)[c]{Satzspiegel rechts}} - % Kästchennummern + % Kästchennummern \makeatletter \multiput(1,27)(0,33){9}{\footnotesize\makebox(0,0)[l]{\the\@multicnt}} \multiput(177,291)(-22,0){9}{% @@ -397,35 +397,35 @@ Anwender erleichtern, eine gute Wahl zu treffen. \makeatother \end{picture} \end{captionbeside} -% \caption{Doppelseite mit der Rasterkonstruktion für die klassische +% \caption{Doppelseite mit der Rasterkonstruktion für die klassische % Neunerteilung nach Abzug einer Bindekorrektur} % \label{fig:typearea.nineparts} \end{figure} Bei {\KOMAScript} ist diese Art der Konstruktion im Paket \Package{typearea} realisiert, wobei der untere Rand weniger als eine Textzeile kleiner - ausfallen kann, um die im vorherigen Abschnitt erwähnte Nebenbedingung für - die Satzspiegelhöhe einzuhalten und damit die dort erwähnte Problematik in - Bezug auf \DescRef{maincls.cmd.flushbottom} zu mindern. Dabei sind für - A4-Papier je nach Schriftgröße unterschiedliche Werte für \Var{DIV} + ausfallen kann, um die im vorherigen Abschnitt erwähnte Nebenbedingung für + die Satzspiegelhöhe einzuhalten und damit die dort erwähnte Problematik in + Bezug auf \DescRef{maincls.cmd.flushbottom} zu mindern. Dabei sind für + A4-Papier je nach Schriftgröße unterschiedliche Werte für \Var{DIV} voreingestellt, die \autoref{tab:typearea.div}, \autopageref{tab:typearea.div} zu entnehmen sind. Bei Verzicht auf Bindekorrektur, wenn also \Var{BCOR} = 0\Unit{pt} gilt, ergeben sich in etwa - die Satzspiegelmaße aus \autoref{tab:typearea.typearea}, + die Satzspiegelmaße aus \autoref{tab:typearea.typearea}, \autopageref{tab:typearea.typearea}. Neben den voreingestellten Werten kann man \Var{BCOR} und \Var{DIV} direkt beim Laden des Pakets als Option angeben (siehe \autoref{sec:typearea.typearea} ab - \autopageref{sec:typearea.typearea}). Zusätzlich existiert ein Befehl, mit + \autopageref{sec:typearea.typearea}). Zusätzlich existiert ein Befehl, mit dem man einen Satzspiegel explizit berechnen kann und dem man die beiden - Werte als Parameter übergibt (\iftrue% Umbruchoptimierung!!!! + Werte als Parameter übergibt (\iftrue% Umbruchoptimierung!!!! siehe ebenfalls \autoref{sec:typearea.typearea}, \fi\DescPageRef{typearea.cmd.typearea}). - Das \Package{typearea}-Paket bietet außerdem die Möglichkeit, den optimalen + Das \Package{typearea}-Paket bietet außerdem die Möglichkeit, den optimalen \Var{DIV}-Wert automatisch zu bestimmen. Dieser ist von der Schrift und dem - Durchschuss abhängig, der zum Zeitpunkt der Satzspiegelberechnung + Durchschuss abhängig, der zum Zeitpunkt der Satzspiegelberechnung eingestellt ist% \iftrue% Umbruchoptimierung!!!! . Siehe hierzu ebenfalls \autoref{sec:typearea.typearea}, \else\ @@ -440,16 +440,16 @@ Anwender erleichtern, eine gute Wahl zu treffen. Neben der zuvor beschriebenen Satzspiegelkonstruktion\Index{Satzspiegel} gibt es in der Literatur noch eine eher klassische oder sogar mittelalterliche Methode. Bei diesem Verfahren will man die gleichen Werte - nicht nur in Form des Seitenverhältnisses wiederfinden; man geht außerdem - davon aus, dass das Optimum dann erreicht wird, wenn die Höhe des + nicht nur in Form des Seitenverhältnisses wiederfinden; man geht außerdem + davon aus, dass das Optimum dann erreicht wird, wenn die Höhe des 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 + 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. + wählen. % \iftrue % Umbruchkorrekturtext @@ -460,36 +460,36 @@ Anwender erleichtern, eine gute Wahl zu treffen. dass durch Auswahl eines ausgezeichneten -- normalerweise unsinnigen -- \Var{DIV}-Wertes oder einer speziellen, symbolischen Angabe 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. + spätmittelalterlichen Buchseitenkanon am nächsten kommt. Es wird also + wiederum auf die Satzspiegelkonstruktion durch Teilung zurückgegriffen. % \iffalse % Umbruchkorrekturtext Bei Wahl einer guten Schrift stimmt dieses Ergebnis nicht selten mit der - Suche nach dem optimalen \Var{DIV}-Wert überein. Siehe hierzu ebenfalls + Suche nach dem optimalen \Var{DIV}-Wert überein. Siehe hierzu ebenfalls \autoref{sec:typearea.typearea}, \DescPageRef{typearea.option.DIV.calc}. % \fi \end{Explain} -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} -\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} +\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} \section{Einstellung des Satzspiegels und der \texorpdfstring{Seitenauf"|teilung}{Seitenaufteilung}} \seclabel{typearea} Das Paket \Package{typearea} bietet zwei unterschiedliche Benutzerschnittstellen, um auf die Satzspiegelkonstruktion Einfluss zu -nehmen. Die wichtigste Möglichkeit ist die Angabe von Optionen. Wie -im vorherigen Abschnitt erwähnt, können die Optionen dabei auf +nehmen. Die wichtigste Möglichkeit ist die Angabe von Optionen. Wie +im vorherigen Abschnitt erwähnt, können die Optionen dabei auf unterschiedlichen Wegen gesetzt werden. In\textnote{Hinweis!} diesem Abschnitt wird die Klasse \Class{protokol} verwendet werden. Es handelt sich dabei nicht um eine \KOMAScript-Klasse, sondern um eine hypothetische Klasse. Diese\iffree{ Anleitung}{s Buch} geht -von dem Idealfall aus, dass für jede Aufgabe eine dafür passende Klasse zur -Verfügung steht. +von dem Idealfall aus, dass für jede Aufgabe eine dafür passende Klasse zur +Verfügung steht. \begin{Declaration} @@ -501,22 +501,22 @@ den absoluten Wert der Bindekorrektur\Index{Bindekorrektur}\textnote{Bindekorrektur} an, also die Breite des Bereichs, der durch die Bindung von der Papierbreite verloren geht. Dieser Wert wird in der Satzspiegelkonstruktion automatisch -berücksichtigt und bei der Ausgabe wieder dem inneren beziehungsweise linken -Rand zugeschlagen. Als \PName{Korrektur} können Sie jede von \TeX{} -verstandene Maßeinheit angeben. +berücksichtigt und bei der Ausgabe wieder dem inneren beziehungsweise linken +Rand zugeschlagen. Als \PName{Korrektur} können Sie jede von \TeX{} +verstandene Maßeinheit angeben. \begin{Example} Angenommen, Sie erstellen einen Finanzbericht. Das Ganze soll - einseitig in A4 gedruckt und anschließend in eine Klemmmappe + einseitig in A4 gedruckt und anschließend in eine Klemmmappe geheftet werden. Die Klemme der Mappe verdeckt 7,5\Unit{mm}. - Der Papierstapel ist sehr dünn, deshalb gehen beim Knicken und - Blättern durchschnittlich höchstens weitere 0,75\Unit{mm} + Der Papierstapel ist sehr dünn, deshalb gehen beim Knicken und + Blättern durchschnittlich höchstens weitere 0,75\Unit{mm} verloren. Sie schreiben dann also: \begin{lstcode} \documentclass[a4paper]{report} \usepackage[BCOR=8.25mm]{typearea} \end{lstcode} - mit \OptionValue{BCOR}{8.25mm} als Option für \Package{typearea} oder + mit \OptionValue{BCOR}{8.25mm} als Option für \Package{typearea} oder \begin{lstcode} \documentclass[a4paper,BCOR=8.25mm]{report} \usepackage{typearea} @@ -531,14 +531,14 @@ verstandene Maßeinheit angeben. Die Option \Option{a4paper} konnte bei \Class{scrreprt} entfallen, da diese der Voreinstellung bei allen \KOMAScript-Klassen entspricht. - Setzt man die Option erst später auf einen neuen Wert, verwendet man also + Setzt man die Option erst später auf einen neuen Wert, verwendet man also beispielsweise \begin{lstcode} \documentclass{scrreprt} \KOMAoptions{BCOR=8.25mm} \end{lstcode} so werden bereits beim Laden der Klasse \Class{scrreprt} - Standardeinstellungen vorgenommen. Beim Ändern der Einstellung mit Hilfe + Standardeinstellungen vorgenommen. Beim Ändern der Einstellung mit Hilfe einer der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} wird dann automatisch ein neuer Satzspiegel mit neuen Randeinstellungen berechnet. @@ -547,13 +547,13 @@ verstandene Maßeinheit angeben. Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei Verwendung einer der \KOMAScript-Klassen wie im Beispiel als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden +\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden muss. Weder sollte das Paket \Package{typearea} bei Verwendung einer \KOMAScript-Klasse explizit per \DescRef{\LabelBase.cmd.usepackage} geladen, noch die Option dabei als optionales Argument angegeben werden. Wird\textnote{automatische Neuberechnung} die Option per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} -nach dem Laden des Pakets geändert, so werden Satzspiegel und Ränder +nach dem Laden des Pakets geändert, so werden Satzspiegel und Ränder automatisch neu berechnet.% % \EndIndexGroup @@ -567,20 +567,20 @@ Mit Hilfe der Option festgelegt, in wie viele Streifen die Seite horizontal und vertikal bei der Satzspiegelkonstruktion eingeteilt wird. Die genaue Konstruktion ist \autoref{sec:typearea.divConstruction} zu entnehmen. Wichtig zu wissen ist, -dass gilt: Je größer der \PName{Faktor}, desto größer wird der Textbereich und -desto kleiner die Ränder. Als \PName{Faktor} kann jeder ganzzahlige Wert ab 4 -verwendet werden. Bitte beachten Sie jedoch, dass sehr große Werte dazu führen -können, dass Randbedingungen der Satzspiegelkonstruktion, je nach Wahl der +dass gilt: Je größer der \PName{Faktor}, desto größer wird der Textbereich und +desto kleiner die Ränder. Als \PName{Faktor} kann jeder ganzzahlige Wert ab 4 +verwendet werden. Bitte beachten Sie jedoch, dass sehr große Werte dazu führen +können, dass Randbedingungen der Satzspiegelkonstruktion, je nach Wahl der weiteren Optionen, verletzt werden. So kann die Kopfzeile im Extremfall auch -außerhalb der Seite liegen. Bei Verwendung der Option -\OptionVName{DIV}{Faktor} sind Sie für die Einhaltung der Randbedingungen -sowie eine nach typografischen Gesichtspunkten günstige Zeilenlänge selbst +außerhalb der Seite liegen. Bei Verwendung der Option +\OptionVName{DIV}{Faktor} sind Sie für die Einhaltung der Randbedingungen +sowie eine nach typografischen Gesichtspunkten günstige Zeilenlänge selbst verantwortlich. -In \autoref{tab:typearea.typearea} finden Sie für das Seitenformat A4 +In \autoref{tab:typearea.typearea} finden Sie für das Seitenformat A4 ohne Bindekorrektur die aus einigen \Var{DIV}-Faktoren -resultierenden Satzspiegelgrößen. Dabei werden die weiteren von der -Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. +resultierenden Satzspiegelgrößen. Dabei werden die weiteren von der +Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. \begin{table} % \centering @@ -590,7 +590,7 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. % \caption [{Satzspiegelma"se in Abh"angigkeit von \Var{DIV} bei A4}] {\label{tab:typearea.typearea}Satzspiegelma"se in Abh"angigkeit von \Var{DIV} - bei A4 ohne Berücksichtigung von \Length{topskip} oder \Var{BCOR}} + bei A4 ohne Berücksichtigung von \Length{topskip} oder \Var{BCOR}} [l] \begin{tabular}[t]{ccccc} \toprule @@ -612,22 +612,22 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. 14 & 165,00 & 233,36 & 21,21 & 15,00 \\ 15 & 168,00 & 237,60 & 19,80 & 14,00 \\ \bottomrule - \multicolumn{5}{r}{\small (alle Längen in mm)} + \multicolumn{5}{r}{\small (alle Längen in mm)} \end{tabular} \end{captionbeside} \end{table} \begin{Example} - Angenommen, Sie schreiben ein Sitzungsprotokoll. Sie verwenden dafür die + Angenommen, Sie schreiben ein Sitzungsprotokoll. Sie verwenden dafür die Klasse \Class{protokol}. Das Ganze soll doppelseitig werden. In Ihrer Firma wird die Schriftart Bookman in 12\Unit{pt} verwendet. Diese Schriftart, die - zu den Standard-PostScript-Schriften gehört, wird in {\LaTeX} mit der + zu den Standard-PostScript-Schriften gehört, wird in {\LaTeX} mit der Anweisung \verb|\usepackage{bookman}| aktiviert. Die Schriftart Bookman - läuft sehr weit, das heißt, die einzelnen Zeichen sind im Verhältnis zur - Höhe relativ breit. Deshalb ist Ihnen die Voreinstellung für den + läuft sehr weit, das heißt, die einzelnen Zeichen sind im Verhältnis zur + Höhe relativ breit. Deshalb ist Ihnen die Voreinstellung für den \Var{DIV}-Wert in \Package{typearea} zu gering. Statt einem Wert von 12 sind - Sie nach gründlichem Studium dieses Kapitels einschließlich der - weiterführenden Abschnitte überzeugt, dass der Wert 15 angebracht ist. Das + Sie nach gründlichem Studium dieses Kapitels einschließlich der + weiterführenden Abschnitte überzeugt, dass der Wert 15 angebracht ist. Das Protokoll wird nicht gebunden, sondern gelocht und in einen Ordner abgeheftet. Eine Bindekorrektur ist deshalb nicht notwendig. Sie schreiben also: @@ -640,17 +640,17 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. Protokolle neuerdings gesammelt und am Quartalsende alle zusammen als Buch gebunden werden. Die Bindung erfolgt als einfache Leimbindung, weil den Band ohnehin nie wieder jemand - anschaut und er nur wegen ISO\,9000 angefertigt wird. Für die Bindung - einschließlich Biegefalz werden durchschnittlich 12\Unit{mm} - benötigt. Sie ändern die Optionen von \Package{typearea} also - entsprechend ab und verwenden die Klasse für Protokolle nach + anschaut und er nur wegen ISO\,9000 angefertigt wird. Für die Bindung + einschließlich Biegefalz werden durchschnittlich 12\Unit{mm} + benötigt. Sie ändern die Optionen von \Package{typearea} also + entsprechend ab und verwenden die Klasse für Protokolle nach ISO\,9000: \begin{lstcode} \documentclass[a4paper,twoside]{iso9000p} \usepackage{bookman} \usepackage[DIV=15,BCOR=12mm]{typearea} \end{lstcode} - Natürlich können Sie auch hier wieder eine \KOMAScript-Klasse + Natürlich können Sie auch hier wieder eine \KOMAScript-Klasse verwenden: \begin{lstcode} \documentclass[twoside,DIV=15,BCOR=12mm]{scrartcl} @@ -668,13 +668,13 @@ Schriftgröße abhängigen Nebenbedingungen nicht berücksichtigt. Bitte beachten Sie unbedingt\textnote{Achtung!}, dass die Option \Option{DIV} bei Verwendung einer der \KOMAScript-Klassen wie im Beispiel als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden +\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden muss. Weder sollte das Paket \Package{typearea} bei Verwendung einer \KOMAScript-Klasse explizit per \DescRef{\LabelBase.cmd.usepackage} geladen, noch die Option dabei als optionales Argument angegeben werden. Wird\textnote{automatische Neuberechnung} die Option per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} -nach dem Laden des Pakets geändert, so werden Satzspiegel und Ränder +nach dem Laden des Pakets geändert, so werden Satzspiegel und Ränder automatisch neu berechnet. \begin{Declaration} @@ -682,22 +682,22 @@ automatisch neu berechnet. \OptionValue{DIV}{classic} \end{Declaration} Wie\ChangedAt{v3.00}{\Package{typearea}} bereits in -\autoref{sec:typearea.divConstruction} erwähnt, gibt es nur für das -Papierformat A4 feste Voreinstellungen für den \Var{DIV}-Wert. Diese sind +\autoref{sec:typearea.divConstruction} erwähnt, gibt es nur für das +Papierformat A4 feste Voreinstellungen für den \Var{DIV}-Wert. Diese sind \autoref{tab:typearea.div} zu entnehmen. Solche festen Werte haben allerdings den Nachteil\textnote{Achtung!}, dass sie die Laufweite der verwendeten -Schrift nicht berücksichtigen. Das kann bei A4 und recht schmalen Schriften -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 +Schrift nicht berücksichtigen. Das kann bei A4 und recht schmalen Schriften +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 \OptionValue{DIV}{calc}\important{\OptionValue{DIV}{calc}} anstelle von -\OptionVNameRef{\LabelBase}{DIV}{Faktor}. Selbstverständlich können Sie +\OptionVNameRef{\LabelBase}{DIV}{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 +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. +Option \OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber. \begin{table} % \centering @@ -717,20 +717,20 @@ Option \OptionValue{DIV}{calc} überschreibt diese Vorkonfiguration aber. \end{captionbeside} \end{table} -Die in \autoref{sec:typearea.circleConstruction} erwähnte klassische -Konstruktion, der mittelalterliche Buchseitenkanon, ist ebenfalls auswählbar. +Die in \autoref{sec:typearea.circleConstruction} erwähnte klassische +Konstruktion, der mittelalterliche Buchseitenkanon, ist ebenfalls auswählbar. Verwenden Sie in diesem Fall anstelle von \OptionVNameRef{\LabelBase}{DIV}{Faktor} oder \OptionValue{DIV}{calc} einfach \OptionValue{DIV}{classic}\important{\OptionValue{DIV}{classic}}. Es wird dann -ein \Var{DIV}-Wert ermittelt, der eine möglichst gute Näherung an den +ein \Var{DIV}-Wert ermittelt, der eine möglichst gute Näherung an den mittelalterlichen Buchseitenkanon darstellt. \begin{Example} - In dem bei der Option \OptionVNameRef{\LabelBase}{DIV}{Faktor} aufgeführten + In dem bei der Option \OptionVNameRef{\LabelBase}{DIV}{Faktor} aufgeführten Beispiel mit der Schriftart Bookman gab es ja genau das Problem, dass man einen zur Schriftart besser passenden \Var{DIV}-Wert haben wollte. Man - könnte also in Abwandlung des ersten Beispiels auch einfach die Ermittlung - dieses Wertes \Package{typearea} überlassen: + könnte also in Abwandlung des ersten Beispiels auch einfach die Ermittlung + dieses Wertes \Package{typearea} überlassen: \begin{lstcode} \documentclass[a4paper,twoside]{protokol} \usepackage{bookman} @@ -743,13 +743,13 @@ mittelalterlichen Buchseitenkanon darstellt. \iftrue wie im Beispiel \fi% als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der - Klasse übergeben werden muss. Weder sollte das Paket \Package{typearea} bei + Klasse übergeben werden muss. Weder sollte das Paket \Package{typearea} bei Verwendung einer \KOMAScript-Klasse explizit per \DescRef{\LabelBase.cmd.usepackage} geladen, noch die Option dabei als optionales Argument angegeben werden. Wird die Option per \DescRef{\LabelBase.cmd.KOMAoptions} oder - \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden des Pakets geändert, so - werden Satzspiegel und Ränder automatisch neu berechnet.% + \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden des Pakets geändert, so + werden Satzspiegel und Ränder automatisch neu berechnet.% }{% \vskip-\dp\strutbox% Wegen Code im Beispiel am Ende }% @@ -762,77 +762,77 @@ mittelalterlichen Buchseitenkanon darstellt. \end{Declaration} Wenn\ChangedAt{v3.00}{\Package{typearea}} Sie bis hier die Beispiele aufmerksam verfolgt haben, wissen Sie eigentlich bereits, wie man die Berechnung eines -\Var{DIV}-Wertes in Abhängigkeit von der gewählten Schrift erreicht, wenn eine +\Var{DIV}-Wertes in Abhängigkeit von der gewählten Schrift erreicht, wenn eine \KOMAScript-Klasse zusammen mit einem Schriftpaket verwendet wird. \begin{Explain} Das Problem dabei ist, dass die \KOMAScript-Klasse das Paket - \Package{typearea} bereits selbst lädt. Die Übergabe der Optionen als + \Package{typearea} bereits selbst lädt. Die Ãœbergabe der Optionen als optionale Argumente von \DescRef{\LabelBase.cmd.usepackage} ist also nicht - möglich. Es würde auch nichts nützen, die Option \OptionValue{DIV}{calc} als + möglich. Es würde auch nichts nützen, die Option \OptionValue{DIV}{calc} als optionales Argument von \DescRef{\LabelBase.cmd.documentclass} - anzugeben. Diese Option würde direkt beim Laden des Pakets - \Package{typearea} ausgewertet. Damit würden Satzspiegel und Ränder für die - \LaTeX-Standardschrift und nicht für die später geladene Schrift berechnet. + anzugeben. Diese Option würde direkt beim Laden des Pakets + \Package{typearea} ausgewertet. Damit würden Satzspiegel und Ränder für die + \LaTeX-Standardschrift und nicht für die später geladene Schrift berechnet. - Selbstverständlich ist es möglich, mit \DescRef{\LabelBase.cmd.KOMAoptions}% + Selbstverständlich ist es möglich, mit \DescRef{\LabelBase.cmd.KOMAoptions}% \PParameter{\OptionValueRef{\LabelBase}{DIV}{calc}} oder \DescRef{\LabelBase.cmd.KOMAoption}% \PParameter{\DescRef{\LabelBase.option.DIV}}\PParameter{calc} nach dem Laden - des Schriftpakets Satzspiegel und Ränder neu berechnen zu lassen. Dabei wird - dann über den Wert \PValue{calc} direkt ein \Var{DIV}-Wert für eine gute - Zeilenlänge eingefordert. + des Schriftpakets Satzspiegel und Ränder neu berechnen zu lassen. Dabei wird + dann über den Wert \PValue{calc} direkt ein \Var{DIV}-Wert für eine gute + Zeilenlänge eingefordert. - Da es aber häufig praktischer ist, die Einstellung für die Option + Da es aber häufig praktischer ist, die Einstellung für die Option \Option{DIV} nicht erst nach dem Laden der Schrift vorzunehmen, sondern an herausgehobener Stelle, beispielsweise beim Laden der Klasse, bietet - \Package{typearea} zwei weitere symbolische Werte für diese Option. + \Package{typearea} zwei weitere symbolische Werte für diese Option. \end{Explain} Mit \OptionValue{DIV}{current}\ChangedAt{v3.00}{\Package{typearea}}% \important{\OptionValue{DIV}{current}} wird eine Neuberechnung von Satzspiegel -und Rändern angestoßen, wobei genau der \Var{DIV}-Wert verwendet wird, der -aktuell eingestellt ist. Dies ist weniger für die Neuberechnung des +und Rändern angestoßen, wobei genau der \Var{DIV}-Wert verwendet wird, der +aktuell eingestellt ist. Dies ist weniger für die Neuberechnung des Satzspiegels nach Wahl einer anderen Grundschrift von Interesse. Vielmehr ist -das dann nützlich, wenn man etwa nach Änderung des Durchschusses bei +das dann nützlich, wenn man etwa nach Änderung des Durchschusses bei Beibehaltung des Teilers \Var{DIV} die Randbedingung sicherstellen will, dass -\Length{textheight} abzüglich \Length{topskip} ein Vielfaches von +\Length{textheight} abzüglich \Length{topskip} ein Vielfaches von \Length{baselineskip} sein sollte. Mit \OptionValue{DIV}{last}\ChangedAt{v3.00}{\Package{typearea}}% \important{\OptionValue{DIV}{last}} wird eine Neuberechnung von Satzspiegel -und Rändern angestoßen, wobei genau dieselbe Einstellung wie bei der letzten +und Rändern angestoßen, wobei genau dieselbe Einstellung wie bei der letzten Berechnung verwendet wird. \begin{Example} - Gehen wir wieder davon aus, dass für die Schriftart Bookman ein Satzspiegel - mit guter Zeilenlänge berechnet werden soll. Gleichzeitig wird eine + Gehen wir wieder davon aus, dass für die Schriftart Bookman ein Satzspiegel + mit guter Zeilenlänge berechnet werden soll. Gleichzeitig wird eine \KOMAScript-Klasse verwendet. Dies ist mit dem symbolischen Wert \PValue{last} und der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions} sehr - einfach möglich: + einfach möglich: \begin{lstcode} \documentclass[BCOR=12mm,DIV=calc,twoside] {scrartcl} \usepackage{bookman} \KOMAoptions{DIV=last} \end{lstcode} - Wird später entschieden, dass ein anderer \Var{DIV}-Wert + Wird später entschieden, dass ein anderer \Var{DIV}-Wert verwendet werden soll, so muss nur die Einstellung im optionalen Argument - von \DescRef{\LabelBase.cmd.documentclass} geändert werden. + von \DescRef{\LabelBase.cmd.documentclass} geändert werden. \end{Example} -Eine Zusammenfassung aller möglichen symbolischen Werte für die Option +Eine Zusammenfassung aller möglichen symbolischen Werte für die Option \Option{DIV} finden Sie in \autoref{tab:symbolicDIV}. Es wird an dieser Stelle darauf hingewiesen, dass auch die Verwendung des Pakets -\Package{fontenc}\IndexPackage{fontenc} dazu führen kann, dass \LaTeX{} eine -andere Schrift lädt. +\Package{fontenc}\IndexPackage{fontenc} dazu führen kann, dass \LaTeX{} eine +andere Schrift lädt. \begin{table} \caption[{% - Symbolische Werte für Option \DescRef{typearea.option.DIV} und das + Symbolische Werte für Option \DescRef{typearea.option.DIV} und das \PName{DIV}-Argument von \DescRef{typearea.cmd.typearea}% }]{% - Mögliche symbolische Werte für die Option \DescRef{typearea.option.DIV} + Mögliche symbolische Werte für die Option \DescRef{typearea.option.DIV} oder das \PName{DIV}-Argument der Anweisung \DescRef{typearea.cmd.typearea}\OParameter{BCOR}\Parameter{DIV}% } @@ -840,39 +840,39 @@ andere Schrift lädt. \begin{desctabular} \pventry{areaset}{Satzspiegel neu anordnen.\IndexOption{DIV~=\textKValue{areaset}}}% - \pventry{calc}{Satzspiegelberechnung einschließlich Ermittlung eines guten + \pventry{calc}{Satzspiegelberechnung einschließlich Ermittlung eines guten \Var{DIV}-Wertes erneut - durchführen.\IndexOption{DIV~=\textKValue{calc}}}% + durchführen.\IndexOption{DIV~=\textKValue{calc}}}% \pventry{classic}{Satzspiegelberechnung nach dem mittelalterlichen Buchseitenkanon (Kreisberechnung) erneut - durchführen.\IndexOption{DIV~=\textKValue{classic}}}% - \pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen + durchführen.\IndexOption{DIV~=\textKValue{classic}}}% + \pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen \Var{DIV}-Wert erneut - durchführen.\IndexOption{DIV~=\textKValue{current}}}% - \pventry{default}{Satzspiegelberechnung mit dem Standardwert für das - aktuelle Seitenformat und die aktuelle Schriftgröße erneut durchführen. + durchführen.\IndexOption{DIV~=\textKValue{current}}}% + \pventry{default}{Satzspiegelberechnung mit dem Standardwert für das + aktuelle Seitenformat und die aktuelle Schriftgröße erneut durchführen. Falls kein Standardwert existiert, \PValue{calc} anwenden.\IndexOption{DIV~=\textKValue{default}}}% \pventry{last}{Satzspiegelberechnung mit demselben \PName{DIV}-Argument, das beim letzten Aufruf angegeben wurde, erneut - durchführen.\IndexOption{DIV~=\textKValue{last}}}% + durchführen.\IndexOption{DIV~=\textKValue{last}}}% \end{desctabular} \end{table} -Häufig\textnote{Achtung!} wird die Satzspiegelneuberechnung im Zusammenhang -mit der Ver"-änderung des Zeilenabstandes -(\emph{Durchschuss})\Index{Durchschuss} benötigt. Da der Satzspiegel unbedingt +Häufig\textnote{Achtung!} wird die Satzspiegelneuberechnung im Zusammenhang +mit der Ver"-änderung des Zeilenabstandes +(\emph{Durchschuss})\Index{Durchschuss} benötigt. Da der Satzspiegel unbedingt so berechnet werden sollte, dass eine ganze Anzahl an Zeilen in den Textbereich passt, muss bei Verwendung eines anderen Durchschusses als des -normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden. +normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden. \begin{Example} - Angenommen, für eine Diplomarbeit wird die Schriftgröße + Angenommen, für eine Diplomarbeit wird die Schriftgröße 10\Unit{pt} bei eineinhalbzeiligem Satz zwingend gefordert. {\LaTeX} setzt normalerweise bei 10\Unit{pt} mit 2\Unit{pt} Durchschuss, - also 1,2-zeilig. Deshalb muss als zusätzlicher Dehnfaktor der Wert - 1,25 verwendet werden. Gehen wir außerdem davon aus, dass eine - Bindekorrektur von 12\Unit{mm} benötigt wird. Dann könnte die Lösung + also 1,2-zeilig. Deshalb muss als zusätzlicher Dehnfaktor der Wert + 1,25 verwendet werden. Gehen wir außerdem davon aus, dass eine + Bindekorrektur von 12\Unit{mm} benötigt wird. Dann könnte die Lösung dieses Problems wie folgt aussehen: \begin{lstcode} \documentclass[10pt,twoside,BCOR=12mm,DIV=calc] @@ -881,15 +881,15 @@ normalen der Satzspiegel für diesen Zeilenabstand neu berechnet werden. \KOMAoptions{DIV=last} \end{lstcode}\IndexCmd{linespread} 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 + 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 % \iftrue % Umbruchkorrektur - auch tatsächlich + auch tatsächlich \fi % - für die Neuberechnung verwendet wird. + für die Neuberechnung verwendet wird. - Das gleiche Beispiel sähe unter Verwendung des + Das gleiche Beispiel sähe unter Verwendung des \Package{setspace}-Pakets\IndexPackage{setspace}% \important{\Package{setspace}} (siehe \cite{package:setspace}) wie folgt aus: @@ -903,22 +903,22 @@ 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 +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 % \iftrue % Umbruchkorrektur -einen näherungsweise passenden Dehnungswert. +einen näherungsweise passenden Dehnungswert. % \else % -eine Näherung. +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 und außerdem auch die Verzeichnisse mit dem +hinzuweisen, dass der Zeilenabstand für die Titelseite wieder auf den normalen +Wert zurückgesetzt werden sollte und außerdem auch die Verzeichnisse mit dem normalen Zeilenabstand gesetzt werden sollten. \begin{Example} - Ein\IndexPackage{setspace} vollständiges Beispiel wäre also: + Ein\IndexPackage{setspace} vollständiges Beispiel wäre also: \begin{lstcode} \documentclass[10pt,twoside,BCOR=12mm,DIV=calc] {scrreprt} @@ -940,11 +940,11 @@ normalen Zeilenabstand gesetzt werden sollten. \autoref{part:forExperts}, \autoref{cha:tocbasic} auf \DescPageRef{tocbasic.cmd.AfterTOCHead} vorgestellt. \end{Example} -Außerdem sei darauf hingewiesen, dass Änderungen am Zeilenabstand auch -Auswirkungen auf Kopf und Fuß der Seite haben können. Dies kann sich +Außerdem sei darauf hingewiesen, dass Änderungen am Zeilenabstand auch +Auswirkungen auf Kopf und Fuß der Seite haben können. Dies kann sich beispielsweise bei Verwendung von \Package{scrlayer-scrpage} auswirken und man muss dann selbst entscheiden, ob man dort lieber den normalen Durchschuss oder -den veränderten haben will. Siehe dazu auch Option +den veränderten haben will. Siehe dazu auch Option \DescRef{scrlayer.option.singlespacing} in \autoref{cha:scrlayer}% \important{\hyperref[cha:scrlayer]{\Package{scrlayer}}}% \IndexPackage{scrlayer}\IndexOption{singlespacing} auf @@ -954,7 +954,7 @@ Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen auch zur Verwendung mit \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden des Pakets vorgesehen sind und dann eine\textnote{automatische Neuberechnung} automatische Neuberechnung -von Satzspiegel und Rändern auslösen.% +von Satzspiegel und Rändern auslösen.% % \EndIndexGroup \EndIndexGroup @@ -969,49 +969,49 @@ von Satzspiegel und Rändern auslösen.% \DescRef{\LabelBase.option.BCOR} nach dem Laden des Pakets \Package{typearea} gesetzt, so wird intern die Anweisung \Macro{typearea} aufgerufen. Dabei wird beim Setzen der Option - \DescRef{\LabelBase.option.DIV} für \PName{BCOR} intern der symbolische Wert - \PValue{current} verwendet, der aus Gründen der Vollständigkeit auch in + \DescRef{\LabelBase.option.DIV} für \PName{BCOR} intern der symbolische Wert + \PValue{current} verwendet, der aus Gründen der Vollständigkeit auch in \autoref{tab:symbolicBCOR} zu finden ist. Beim Setzen der Option - \DescRef{\LabelBase.option.BCOR} wird für \PName{DIV} hingegen der + \DescRef{\LabelBase.option.BCOR} wird für \PName{DIV} hingegen der symbolische Wert \PValue{last} verwendet. Wollen Sie, dass Satzspiegel und - Ränder stattdessen mit dem symbolischen Wert \PValue{current} für - \PName{DIV} neu berechnet werden, so können Sie direkt + Ränder stattdessen mit dem symbolischen Wert \PValue{current} für + \PName{DIV} neu berechnet werden, so können Sie direkt \Macro{typearea}\POParameter{current}\PParameter{current} verwenden. \end{Explain} \begin{table} \caption[{% - Symbolische \PName{BCOR}-Argumente für \DescRef{typearea.cmd.typearea}% + Symbolische \PName{BCOR}-Argumente für \DescRef{typearea.cmd.typearea}% }]{% - Mögliche symbolische \PName{BCOR}-Argumente für + Mögliche symbolische \PName{BCOR}-Argumente für \Macro{typearea}\OParameter{BCOR}\Parameter{DIV}% } \label{tab:symbolicBCOR} \begin{desctabular} - \pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen + \pventry{current}{Satzspiegelberechnung mit dem aktuell gültigen \Var{BCOR}-Wert erneut - durchführen.\IndexOption{BCOR~=\textKValue{current}}} + durchführen.\IndexOption{BCOR~=\textKValue{current}}} \end{desctabular} \end{table} -Sollen die Werte sowohl von \PName{BCOR} als auch \PName{DIV} geändert werden, -so ist die Verwendung von \Macro{typearea} zu empfehlen, da hierbei die Ränder +Sollen die Werte sowohl von \PName{BCOR} als auch \PName{DIV} geändert werden, +so ist die Verwendung von \Macro{typearea} zu empfehlen, da hierbei die Ränder und der Satzspiegel nur einmal neu berechnet werden. Bei \DescRef{\LabelBase.cmd.KOMAoptions}% \PParameter{\OptionVNameRef{\LabelBase}{DIV}{Faktor},% - \OptionVNameRef{\LabelBase}{BCOR}{Korrektur}} werden hingegen Ränder und -Satzspiegel zunächst in Folge von Option \DescRef{\LabelBase.option.DIV} und -dann zusätzlich durch Option \DescRef{\LabelBase.option.BCOR} neu berechnet. + \OptionVNameRef{\LabelBase}{BCOR}{Korrektur}} werden hingegen Ränder und +Satzspiegel zunächst in Folge von Option \DescRef{\LabelBase.option.DIV} und +dann zusätzlich durch Option \DescRef{\LabelBase.option.BCOR} neu berechnet. \begin{Explain} - Der Befehl \Macro{typearea} ist derzeit so definiert, dass es auch möglich + Der Befehl \Macro{typearea} ist derzeit so definiert, dass es auch möglich ist, mitten in einem Dokument den Satzspiegel zu wechseln. Dabei werden - allerdings Annahmen über den Aufbau des \LaTeX-Kerns gemacht und interne - Definitionen und Größen des \LaTeX-Kerns verändert. Da am \LaTeX-Kern nur - noch zur Beseitigung von Fehlern notwendige Änderungen vorgenommen werden, - ist die Wahrscheinlichkeit hoch, dass dies in zukünftigen Versionen von - \LaTeXe{} noch funktionieren wird. Eine Garantie dafür gibt es jedoch - nicht. Die Verwendung innerhalb des Dokuments führt außerdem immer zu einem + allerdings Annahmen über den Aufbau des \LaTeX-Kerns gemacht und interne + Definitionen und Größen des \LaTeX-Kerns verändert. Da am \LaTeX-Kern nur + noch zur Beseitigung von Fehlern notwendige Änderungen vorgenommen werden, + ist die Wahrscheinlichkeit hoch, dass dies in zukünftigen Versionen von + \LaTeXe{} noch funktionieren wird. Eine Garantie dafür gibt es jedoch + nicht. Die Verwendung innerhalb des Dokuments führt außerdem immer zu einem Seitenumbruch. \end{Explain} @@ -1020,9 +1020,9 @@ Da\important{\Macro{recalctypearea}} \DescRef{\LabelBase.cmd.KOMAoption}% \PParameter{\hyperref[desc:\LabelBase.option.DIV.last]{last}} oder \DescRef{\LabelBase.cmd.KOMAoptions}% \PParameter{\OptionValueRef{\LabelBase}{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 +\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 \Macro{recalctypearea}\ChangedAt{v3.00}{\Package{typearea}}. \begin{Example} Wenn Ihnen die Schreibweisen @@ -1033,8 +1033,8 @@ die abkürzende Anweisung \begin{lstcode} \typearea[current]{last} \end{lstcode} - für die Neuberechnung von Satzspiegel und Rändern aufgrund der vielen - Sonderzeichen zu umständlich ist, können Sie einfach + für die Neuberechnung von Satzspiegel und Rändern aufgrund der vielen + Sonderzeichen zu umständlich ist, können Sie einfach \begin{lstcode} \recalctypearea \end{lstcode} @@ -1047,27 +1047,27 @@ die abkürzende Anweisung \OptionVName{twoside}{Ein-Aus-Wert} \OptionValue{twoside}{semi} \end{Declaration}% -Wie in \autoref{sec:typearea.basics} erklärt, hängt +Wie in \autoref{sec:typearea.basics} erklärt, hängt die Randverteilung davon ab, ob ein Dokument ein- oder zweiseitig gesetzt werden soll. Bei einseitigem Satz sind der linke und rechte Rand gleich -breit, während bei doppelseitigem Satz der innere Randanteil einer Seite nur -halb so groß ist wie der jeweilige äußere Rand. Um diese Unterscheidung -vornehmen zu können, muss \Package{typearea} mit Option \Option{twoside} +breit, während bei doppelseitigem Satz der innere Randanteil einer Seite nur +halb so groß ist wie der jeweilige äußere Rand. Um diese Unterscheidung +vornehmen zu können, muss \Package{typearea} mit Option \Option{twoside} mitgeteilt werden, ob das Dokument doppelseitig gesetzt wird. Als \iffree{\PName{Ein-Aus-Wert}}{\PName{Wert}} kann dabei einer der Standardwerte -für einfache Schalter aus \autoref{tab:truefalseswitch} verwendet werden. Wird +für einfache Schalter aus \autoref{tab:truefalseswitch} verwendet werden. Wird die Option ohne Wert-Angabe verwendet, so wird der Wert \PValue{true}\important{\OptionValue{twoside}{true}} angenommen, also doppelseitiger Satz verwendet. Deaktivieren der -Option\important{\OptionValue{twoside}{false}} führt zu einseitigem Satz. +Option\important{\OptionValue{twoside}{false}} führt zu einseitigem Satz. \begin{table} % \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 + [{Standardwerte für einfache Schalter in \KOMAScript}]% + {\label{tab:truefalseswitch}Standardwerte für alle einfachen Schalter in \KOMAScript}% [l] \begin{tabular}[t]{ll} @@ -1085,18 +1085,18 @@ Option\important{\OptionValue{twoside}{false}} führt zu einseitigem Satz. \end{captionbeside} \end{table} -Außer den Werten aus \autoref{tab:truefalseswitch} kann jedoch auch noch der +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 +\PValue{semi} führt zu doppelseitigem Satz mit einseitigen Rändern und einseitigen, also nicht alternierenden Marginalien. Eine\ChangedAt{v3.12}{\Package{typearea}} eventuelle Bindekorrektur (siehe Option \DescRef{\LabelBase.option.BCOR}, \DescPageRef{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 früheren -Version\important{\OptionValueRef{\LabelBase}{version}{3.12}} zurückgeschaltet +Kompatibilität zu einer früheren +Version\important{\OptionValueRef{\LabelBase}{version}{3.12}} 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. @@ -1108,11 +1108,11 @@ als Klassenoption bei \DescRef{\LabelBase.cmd.documentclass}, als Paketoption bei \DescRef{\LabelBase.cmd.usepackage} oder auch nach dem Laden von \Package{typearea} per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} gesetzt werden. Eine Verwendung dieser -Option nach dem Laden von \Package{typearea} führt\textnote{automatische +Option nach dem Laden von \Package{typearea} führt\textnote{automatische Neuberechnung} automatisch zur Neuberechnung des Satzspiegels mit \DescRef{\LabelBase.cmd.recalctypearea} (siehe \DescPageRef{typearea.cmd.recalctypearea}). War vor der Option -doppelseitiger Satz aktiv, wird noch vor der Neuberechnung auf die nächste +doppelseitiger Satz aktiv, wird noch vor der Neuberechnung auf die nächste ungerade Seite umbrochen.% % \EndIndexGroup @@ -1121,28 +1121,28 @@ ungerade Seite umbrochen.% \begin{Declaration} \OptionVName{twocolumn}{Ein-Aus-Wert} \end{Declaration}% -Für die Berechnung eines guten Satzspiegels mit Hilfe von +Für die Berechnung eines guten Satzspiegels mit Hilfe von \OptionValueRef{\LabelBase}{DIV}{calc} ist es erforderlich zu wissen, ob das Dokument ein- oder zweispaltig gesetzt wird. Da die Betrachtungen zur -Zeilenlänge aus \autoref{sec:typearea.basics} dann für jede einzelne Spalte +Zeilenlänge aus \autoref{sec:typearea.basics} dann für jede einzelne Spalte gelten, darf der Satzspiegel in doppelspaltigen Dokumenten bis zu doppelt so breit sein wie in einspaltigen Dokumenten. -Um diese Unterscheidung vornehmen zu können, muss \Package{typearea} mit +Um diese Unterscheidung vornehmen zu können, muss \Package{typearea} mit Option \Option{twocolumn} mitgeteilt werden, ob das Dokument doppelspaltig -gesetzt wird. Als \PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für +gesetzt wird. Als \PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch} verwendet werden. Wird die Option ohne Wert-Angabe verwendet, so wird der Wert \PValue{true}\important{\OptionValue{twocolumn}{true}} angenommen, also doppelspaltiger Satz verwendet. Ein -Deaktivieren der Option führt wieder zum voreingestellten +Deaktivieren der Option führt wieder zum voreingestellten einspaltigen Satz. Die Option kann als Klassenoption bei \DescRef{\LabelBase.cmd.documentclass}, als Paketoption bei \DescRef{\LabelBase.cmd.usepackage} oder auch nach dem Laden von \Package{typearea} per \DescRef{\LabelBase.cmd.KOMAoptions} oder \DescRef{\LabelBase.cmd.KOMAoption} gesetzt werden. Eine Verwendung dieser -Option nach dem Laden von \Package{typearea} führt\textnote{automatische +Option nach dem Laden von \Package{typearea} führt\textnote{automatische Neuberechnung} automatisch zur Neuberechnung des Satzspiegels mittels \DescRef{\LabelBase.cmd.recalctypearea} (siehe \DescPageRef{typearea.cmd.recalctypearea}).% @@ -1155,104 +1155,104 @@ Option nach dem Laden von \Package{typearea} führt\textnote{automatische \OptionVName{footinclude}{Ein-Aus-Wert} \end{Declaration}% \begin{Explain}% - Bisher wurde zwar erklärt, wie die + Bisher wurde zwar erklärt, wie die Satzspiegelkonstruktion\Index{Satzspiegel} funktioniert und in welchem - Verhältnis einerseits die Ränder\Index{Rand} zueinander stehen, andererseits - der Textkörper zur Seite steht, aber eine entscheidende Frage blieb + Verhältnis einerseits die Ränder\Index{Rand} zueinander stehen, andererseits + der Textkörper zur Seite steht, aber eine entscheidende Frage blieb ausgeklammert: Was genau ist \emph{der Rand}? Auf den ersten Blick wirkt diese Frage trivial: Der Rand ist der Teil der Seite, der oben, unten, links und rechts frei bleibt. Doch das ist nur die - halbe Wahrheit. Der äußere Rand ist keineswegs immer leer. Teilweise findet + halbe Wahrheit. Der äußere Rand ist keineswegs immer leer. Teilweise findet man darin noch gesetzte Randnotizen (siehe den Befehl \DescRef{maincls.cmd.marginpar} beispielsweise in \cite{l2kurz} bzw. \autoref{sec:maincls.marginNotes}). Beim oberen und unteren Rand stellt sich die Frage, wie Kopf- und - Fußzeile\Index{Seiten>Kopf}\Index{Seiten>Fuss=Fuß} zu behandeln sind. - Gehören diese beiden zum Textkörper oder zum jeweiligen Rand? Die Frage ist - nicht einfach zu beantworten. Eindeutig ist, dass ein leerer Fuß und ein - leerer Kopf zum Rand zu rechnen sind. Schließlich können sie nicht vom - restlichen Rand unterschieden werden. Ein Fuß, der nur die + Fußzeile\Index{Seiten>Kopf}\Index{Seiten>Fuss=Fuß} zu behandeln sind. + Gehören diese beiden zum Textkörper oder zum jeweiligen Rand? Die Frage ist + nicht einfach zu beantworten. Eindeutig ist, dass ein leerer Fuß und ein + 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{Paginierung}\textnote{Paginierung} - \iffalse % Beseitigung von Fußnoten + \iffalse % Beseitigung von Fußnoten \unskip\footnote{Unter der Paginierung versteht man die Angabe der - Seitenzahl, wahlweise innerhalb oder außerhalb des Satzspiegels, meist im - Kopf oder Fuß der Seite.} % - \fi 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 + Seitenzahl, wahlweise innerhalb oder außerhalb des Satzspiegels, meist im + Kopf oder Fuß der Seite.} % + \fi 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 + 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. + 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 Kolumnentitel\Index{Kolumnentitel}\textnote{Kolumnentitel} - \iffalse% Beseitigung von Fußnoten + häufig der Kolumnentitel\Index{Kolumnentitel}\textnote{Kolumnentitel} + \iffalse% Beseitigung von Fußnoten \unskip\footnote{Unter dem Kolumnentitel versteht man in der Regel die - Wiederholung einer Überschrift mit Titelcharakter. Er steht häufig im - Seitenkopf, seltener im Seitenfuß.} % + Wiederholung einer Ãœberschrift mit Titelcharakter. Er steht häufig im + Seitenkopf, seltener im Seitenfuß.} % \fi gesetzt. Arbeitet man mit einem lebenden Kolumnentitel, also der Wiederholung der ersten bzw. zweiten Gliederungsebene in der Kopfzeile, und - hat gleichzeitig sehr lange Überschriften, so erhält man automatisch sehr + hat gleichzeitig sehr lange Ãœberschriften, so erhält man automatisch sehr lange Kopfzeilen. In diesem Fall wirkt der Kopf wiederum wie ein abgesetzter - Teil des Textkörpers und weniger wie leerer Rand. Verstärkt wird dieser + Teil des Textkörpers und weniger wie leerer Rand. Verstärkt wird dieser Effekt noch, wenn neben dem Kolumnentitel auch die Paginierung im Kopf - erfolgt. Dadurch erhält man einen links und rechts abgeschlossenen Bereich, + erfolgt. Dadurch erhält man einen links und rechts abgeschlossenen Bereich, der kaum noch als leerer Rand wirkt. Schwieriger ist es bei Paginierung im - Fuß und Überschriften, deren Länge sehr stark schwankt. Hier kann der Kopf - der einen Seite wie Textkörper wirken, der Kopf der anderen Seite aber + Fuß und Ãœberschriften, deren Länge sehr stark schwankt. Hier kann der Kopf + der einen Seite wie Textkörper wirken, der Kopf der anderen Seite aber eher wie Rand. Keinesfalls sollte man die Seiten jedoch unterschiedlich - behandeln. Das würde zu vertikal springenden Köpfen führen und ist nicht - einmal für ein Daumenkino geeignet. Ich rate in diesem Fall dazu, den Kopf - zum Textkörper zu rechnen. - - Ganz einfach fällt die Entscheidung, wenn Kopf oder Fuß durch - eine Linie vom eigentlichen Textkörper abgetrennt sind. Dadurch - erhält man eine geschlossene Wirkung und der Kopf bzw. Fuß sollte - unbedingt zum Textkörper gerechnet werden. Wie gesagt: Die durch die - Trennlinie verbesserte Erkennung des Kopfes oder Fußes ist hier + behandeln. Das würde zu vertikal springenden Köpfen führen und ist nicht + einmal für ein Daumenkino geeignet. Ich rate in diesem Fall dazu, den Kopf + zum Textkörper zu rechnen. + + Ganz einfach fällt die Entscheidung, wenn Kopf oder Fuß durch + eine Linie vom eigentlichen Textkörper abgetrennt sind. Dadurch + erhält man eine geschlossene Wirkung und der Kopf bzw. Fuß sollte + unbedingt zum Textkörper gerechnet werden. Wie gesagt: Die durch die + Trennlinie verbesserte Erkennung des Kopfes oder Fußes ist hier unerheblich. Entscheidend ist die unscharfe Betrachtung.\par \end{Explain} -Das \Package{typearea}-Paket trifft die Entscheidung, ob ein Kopf oder Fuß zum -Textkörper gehört\important{\OptionValue{headinclude}{true} +Das \Package{typearea}-Paket trifft die Entscheidung, ob ein Kopf oder Fuß zum +Textkörper gehört\important{\OptionValue{headinclude}{true} \OptionValue{headinclude}{false} \OptionValue{footinclude}{true} \OptionValue{footinclude}{false}} oder davon getrennt zum Rand gerechnet werden muss, nicht selbst. Stattdessen kann mit den Optionen \Option{headinclude} und \Option{footinclude} eingestellt werden, ob der Kopf -und der Fuß zum Textkörper gerechnet werden sollen. Die Optionen verstehen +und der Fuß zum Textkörper gerechnet werden sollen. Die Optionen verstehen dabei als \PName{Ein-Aus-Wert}\ChangedAt{v3.00}{\Package{typearea}} die -Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, +Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} 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 +\PName{Ein-Aus-Wert} verwendet, also der Kopf oder Fuß zum Satzspiegel gerechnet. Wenn Sie unsicher sind, was die richtige Einstellung ist, lesen Sie bitte -obige Erläuterungen. Voreingestellt sind normalerweise +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 +\KOMAScript-Pakete generell ändern (siehe \autoref{sec:maincls.options} und \autoref{cha:scrlayer-scrpage}). Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden -müssen. Eine Änderung dieser Optionen nach dem Laden von \Package{typearea} -führt dabei 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 +\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden +müssen. Eine Änderung dieser Optionen nach dem Laden von \Package{typearea} +führt dabei 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 \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder @@ -1268,22 +1268,22 @@ des Satzspiegels siehe Option \OptionVName{mpinclude}{Ein-Aus-Wert} \end{Declaration} Neben\ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} Dokumenten, bei denen der Kopf und der Fuß der Seite eher -zum Textbereich als zum Rand gehört, gibt es auch Dokumente, bei denen dies -für Randnotizen zutrifft. Mit der Option \Option{mpinclude} kann genau dies + \Class{scrartcl}} Dokumenten, bei denen der Kopf und der Fuß der Seite eher +zum Textbereich als zum Rand gehört, gibt es auch Dokumente, bei denen dies +für Randnotizen zutrifft. Mit der Option \Option{mpinclude} kann genau dies erreicht werden. Die Option versteht dabei als \PName{Ein-Aus-Wert}\ChangedAt{v3.00}{\Package{typearea}} die Standardwerte -für einfache Schalter, die in \autoref{tab:truefalseswitch}, +für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Man kann die Option auch ohne Wertzuweisung verwenden. In diesem Fall wird \PValue{true} als \PName{Ein-Aus-Wert} verwendet. Der Effekt von \OptionValue{mpinclude}{true}\important{\OptionValue{mpinclude}{true}} ist, -dass eine Breiteneinheit vom Textbereich weggenommen und als Bereich für die +dass eine Breiteneinheit vom Textbereich weggenommen und als Bereich für die Randnotizen verwendet wird. Mit \OptionValue{mpinclude}{false}, was -der Voreinstellung entspricht, wird hingegen ein Teil des Randes für +der Voreinstellung entspricht, wird hingegen ein Teil des Randes für Randnotizen verwendet. Dies ist, je nachdem ob einseitig oder doppelseitig gearbeitet wird, ebenfalls eine Breiteneinheit oder auch eineinhalb Breiteneinheiten. In der Regel ist die Verwendung von @@ -1291,28 +1291,28 @@ Breiteneinheiten. In der Regel ist die Verwendung von bleiben. \begin{Explain} - In den meisten Fällen, in denen die Option \Option{mpinclude} sinnvoll ist, - werden außerdem breitere Randnotizen benötigt. In sehr vielen Fällen sollte + In den meisten Fällen, in denen die Option \Option{mpinclude} sinnvoll ist, + werden außerdem breitere Randnotizen benötigt. In sehr vielen Fällen sollte dabei aber nicht die gesamte Breite, sondern nur ein Teil davon dem Textbereich zugeordnet werden. Dies ist beispielsweise der Fall, wenn der - Rand für Zitate verwendet wird. Solche Zitate werden üblicherweise im - Flattersatz gesetzt, wobei die bündige Kante an den Textbereich - anschließt. Da sich kein geschlossener optischer Eindruck ergibt, dürfen die + Rand für Zitate verwendet wird. Solche Zitate werden üblicherweise im + Flattersatz gesetzt, wobei die bündige Kante an den Textbereich + anschließt. Da sich kein geschlossener optischer Eindruck ergibt, dürfen die flatternden Enden also durchaus teilweise in den Rand ragen. Man kann das einfach erreichen, indem man zum einen die Option \Option{mpinclude} - verwendet. Zum anderen vergrößert man die Länge \Length{marginparwidth} nach + verwendet. Zum anderen vergrößert man die Länge \Length{marginparwidth} nach der Berechnung des Satzspiegels noch mit Hilfe der - \Macro{addtolength}-Anweisung. Um welchen Wert man vergrößern sollte, hängt - vom Einzelfall ab und erfordert einiges Fingerspitzengefühl. Auch deshalb - ist die Option \Option{mpinclude} eher etwas für Experten. Natürlich kann + \Macro{addtolength}-Anweisung. Um welchen Wert man vergrößern sollte, hängt + vom Einzelfall ab und erfordert einiges Fingerspitzengefühl. Auch deshalb + ist die Option \Option{mpinclude} eher etwas für Experten. Natürlich kann man auch festlegen, dass die Randnotizen beispielsweise zu einem Drittel in den Rand hineinragen sollen, und das wie folgt erreichen: \begin{lstcode} \setlength{\marginparwidth}{1.5\marginparwidth} \end{lstcode} - 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 + 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: % \iftrue % Umbruchkorrektur Die Anpassung von \Length{textwidth}\IndexLength{textwidth} und @@ -1328,11 +1328,11 @@ bleiben. \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 - Breite des Textbereichs verringert hat. Leider lässt sich dieses Vorgehen + Breite des Textbereichs verringert hat. Leider lässt sich dieses Vorgehen nicht mit der automatischen Berechnung des \PName{DIV}-Wertes verbinden. - Demgegenüber wird \Option{mpinclude} bei + Demgegenüber wird \Option{mpinclude} bei \OptionValueRef{\LabelBase}{DIV}{calc}\IndexOption{DIV=calc} (siehe - \DescPageRef{typearea.option.DIV.calc}) berücksichtigt. + \DescPageRef{typearea.option.DIV.calc}) berücksichtigt. % \fi \end{Explain} @@ -1340,11 +1340,11 @@ bleiben. Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei Verwendung einer der \KOMAScript-Klassen als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise oder -\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden -muss. Eine Änderung dieser Option nach dem Laden von \Package{typearea} führt +\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden +muss. Eine Änderung dieser Option 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 +Neuberechnung des Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der +nächsten Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe Option \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder @@ -1358,12 +1358,12 @@ Satzspiegels siehe Option \begin{Declaration} \OptionVName{headlines}{Zeilenanzahl} - \OptionVName{headheight}{Höhe} + \OptionVName{headheight}{Höhe} \end{Declaration}% -\BeginIndex{}{Kopf>Hoehe=Höhe}% +\BeginIndex{}{Kopf>Hoehe=Höhe}% Es ist nun also bekannt, wie man Satzspiegel mit dem \Package{typearea}-Paket -berechnet und wie man dabei angibt, ob der Kopf oder Fuß zum Textkörper oder -zum Rand gehört. Insbesondere für den Kopf fehlt aber noch die Angabe, wie +berechnet und wie man dabei angibt, ob der Kopf oder Fuß zum Textkörper oder +zum Rand gehört. Insbesondere für den Kopf fehlt aber noch die Angabe, wie hoch er denn eigentlich sein soll. Hierzu dienen die Optionen \Option{headlines} und \Option{headheight}\ChangedAt{v3.00}{\Package{typearea}}. @@ -1371,27 +1371,27 @@ hoch er denn eigentlich sein soll. Hierzu dienen die Optionen Die Option \Option{headlines}\important{\Option{headlines}} setzt man dabei auf die Anzahl der Kopfzeilen. Normalerweise arbeitet das \Package{typearea}-Paket mit 1,25 Kopfzeilen. Dieser Wert stellt einen -Kompromiss dar. Zum einen ist er groß genug, um auch für eine unterstrichene +Kompromiss dar. Zum einen ist er groß genug, um auch für eine unterstrichene Kopfzeile (siehe \autoref{sec:maincls.pagestyle}) Platz zu bieten, zum anderen -ist er klein genug, um das Randgewicht nicht zu stark zu verändern, wenn mit +ist er klein genug, um das Randgewicht nicht zu stark zu verändern, wenn mit einer einfachen, nicht unterstrichenen Kopfzeile 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 Kopfhöhe genauer den tatsächlichen +der voreingestellte Wert in den meisten Standardfällen ein guter Wert. In +einigen Fällen will oder muss man aber die Kopfhöhe genauer den tatsächlichen Erfordernissen anpassen. \begin{Example} Angenommen, es soll ein Text mit einem zweizeiligen Kopf erstellt - werden. Normalerweise würde dies dazu führen, dass auf jeder Seite - eine Warnung »\texttt{overfull} \Macro{vbox}« von {\LaTeX} - ausgegeben würde. Um dies zu verhindern, wird das + werden. Normalerweise würde dies dazu führen, dass auf jeder Seite + eine Warnung »\texttt{overfull} \Macro{vbox}« von {\LaTeX} + ausgegeben würde. Um dies zu verhindern, wird das \Package{typearea}-Paket angewiesen, einen entsprechenden Satzspiegel zu berechnen: \begin{lstcode} \documentclass[a4paper]{article} \usepackage[headlines=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: + Es ist auch wieder möglich und bei Verwendung einer \KOMAScript-Klasse + empfehlenswert, diese Option direkt an die Klasse zu übergeben: \begin{lstcode} \documentclass[headlines=2.1]{scrartcl} \end{lstcode} @@ -1399,14 +1399,14 @@ Erfordernissen anpassen. werden kann, sind in \autoref{cha:scrlayer-scrpage} zu finden. \end{Example} -In einigen Fällen ist es nützlich, wenn man die Kopfhöhe nicht in Zeilen, -sondern direkt als Längenwert angeben kann. Dies ist mit Hilfe der alternativ +In einigen Fällen ist es nützlich, wenn man die Kopfhöhe nicht in Zeilen, +sondern direkt als Längenwert angeben kann. Dies ist mit Hilfe der alternativ verwendbaren Option \Option{headheight}\important{\Option{headheight}} -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änder -entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie +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änder +entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie \Length{baselineskip} keinesfalls im optionalen Argument von \DescRef{\LabelBase.cmd.documentclass} oder \DescRef{\LabelBase.cmd.usepackage} verwendet werden. @@ -1414,11 +1414,11 @@ entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.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 +\DescRef{\LabelBase.cmd.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 \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder @@ -1432,71 +1432,71 @@ Satzspiegels siehe Option \begin{Declaration} \OptionVName{footlines}{Zeilenanzahl}% - \OptionVName{footheight}{Höhe}% + \OptionVName{footheight}{Höhe}% \Length{footheight}% \end{Declaration}% -\BeginIndex{}{Fuss=Fuß>Hoehe=Höhe}% -Wie schon für den Kopf fehlt aber noch die Angabe, wie hoch der Fuß sein +\BeginIndex{}{Fuss=Fuß>Hoehe=Höhe}% +Wie schon 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 +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 +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 \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}% -\IndexPackage{scrlayer-scrpage} berücksichtigt \Length{footheight} und +\IndexPackage{scrlayer-scrpage} berücksichtigt \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 einzeiligen Seitenfüßen anbieten. +berücksichtigen \Length{footheight} hingegen nicht, da sie ohne +Paketunterstützung nur Seitenstile mit einzeiligen Seitenfüßen anbieten. Die Option \Option{footlines}\important{\Option{footlines}} setzt man vergleichbar zu \DescRef{\LabelBase.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 +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.pagestyle}) 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 +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 + 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 \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}}% - \IndexPackage{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: + \IndexPackage{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: + 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 + 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 +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änder -entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie +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änder +entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie \Length{baselineskip} keinesfalls im optionalen Argument von \DescRef{\LabelBase.cmd.documentclass} oder \DescRef{\LabelBase.cmd.usepackage} verwendet werden. @@ -1504,11 +1504,11 @@ entscheidend ist. Außerdem\textnote{Achtung!} sollten \LaTeX-Längen wie Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Optionen bei Verwendung einer der \KOMAScript-Klassen als Klassenoptionen oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.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 +\DescRef{\LabelBase.cmd.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 \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder @@ -1520,32 +1520,32 @@ Satzspiegels siehe Option \begin{Declaration} - \Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe} + \Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe} \end{Declaration}% -Bis hier wurde nun eine Menge darüber erzählt, wie man einen guten -Satzspiegel\Index{Satzspiegel} für Standardanwendungen erstellt und wie das +Bis hier wurde nun eine Menge darüber erzählt, wie man einen guten +Satzspiegel\Index{Satzspiegel} für Standardanwendungen erstellt und wie das \Package{typearea}-Paket dem Anwender diese Arbeit erleichtert, ihm aber -gleichzeitig Möglichkeiten der Einflussnahme bietet. Es gibt jedoch auch -Fälle, in denen der Textkörper eine bestimmte Größe exakt einhalten soll, ohne +gleichzeitig Möglichkeiten der Einflussnahme bietet. Es gibt jedoch auch +Fälle, in denen der Textkörper eine bestimmte Größe exakt einhalten soll, ohne dass dabei auf gute Satzspiegelkonstruktion oder auf weitere Nebenbedingungen -zu achten ist. Trotzdem sollen die Ränder so gut wie möglich verteilt und -dabei gegebenenfalls auch eine Bindekorrektur berücksichtigt werden. Das -\Package{typearea}-Paket bietet hierfür den Befehl \Macro{areaset}, dem man -neben der optionalen Bindekorrektur als Parameter die Breite und Höhe des -Textbereichs übergibt. Die Ränder und deren Verteilung werden dann automatisch +zu achten ist. Trotzdem sollen die Ränder so gut wie möglich verteilt und +dabei gegebenenfalls auch eine Bindekorrektur berücksichtigt werden. Das +\Package{typearea}-Paket bietet hierfür den Befehl \Macro{areaset}, dem man +neben der optionalen Bindekorrektur als Parameter die Breite und Höhe des +Textbereichs übergibt. Die Ränder und deren Verteilung werden dann automatisch berechnet, wobei gegebenenfalls auch die Einstellungen der Paketoptionen \DescRef{\LabelBase.option.headinclude} und -\DescRef{\LabelBase.option.footinclude} berücksichtigt werden. Die Optionen +\DescRef{\LabelBase.option.footinclude} berücksichtigt werden. Die Optionen \DescRef{\LabelBase.option.headlines}\IndexOption{headlines}\textnote{Achtung!}, \DescRef{\LabelBase.option.headheight}\IndexOption{headheight}, \DescRef{\LabelBase.option.footlines}\IndexOption{footlines} und \DescRef{\LabelBase.option.footheight}\IndexOption{footheight} bleiben in -diesem Fall jedoch unberücksichtigt! Siehe dazu die weiterführenden +diesem Fall jedoch unberücksichtigt! Siehe dazu die weiterführenden Informationen zu \DescRef{typearea-experts.cmd.areaset} auf \DescPageRef{typearea-experts.cmd.areaset} in \autoref{sec:typearea-experts.experimental}. -Die Voreinstellung für \PName{BCOR} ist 0\Unit{pt}. Soll hingegen die aktuelle, +Die Voreinstellung für \PName{BCOR} ist 0\Unit{pt}. Soll hingegen die aktuelle, beispielsweise per Option \DescRef{\LabelBase.option.BCOR}\IndexOption{BCOR} eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert \PValue{current} als optionales Argument verwenden. @@ -1553,7 +1553,7 @@ eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert \begin{Example} Angenommen, ein Text auf A4-Papier soll genau die Breite von 60 Zeichen in der Typewriter-Schrift haben und exakt 30 Zeilen je Seite - besitzen. Dann könnte mit folgender Präambel gearbeitet werden: + besitzen. Dann könnte mit folgender Präambel gearbeitet werden: \begin{lstcode} \documentclass[a4paper,11pt]{article} \usepackage{typearea} @@ -1565,23 +1565,23 @@ eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert \addtolength{\LinesXXX}{29\baselineskip} \areaset{\CharsLX}{\LinesXXX} \end{lstcode} - Der Faktor von 29 statt 30 ist damit begründet, dass die Grundlinie der + Der Faktor von 29 statt 30 ist damit begründet, dass die Grundlinie der obersten Zeile bereits am obersten Rand des um \Macro{topskip} verringerten - Satzspiegels liegt, solange die Höhe der obersten Zeile kleiner als - \Macro{topskip} ist. Die oberste Zeile benötigt damit keine Höhe. Die - Unterlängen der untersten Zeile ragen dafür unter den Satzspiegel. + Satzspiegels liegt, solange die Höhe der obersten Zeile kleiner als + \Macro{topskip} ist. Die oberste Zeile benötigt damit keine Höhe. Die + Unterlängen der untersten Zeile ragen dafür unter den Satzspiegel. \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 + 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: + Seitenlänge 15\Unit{cm} und einem Binderand von 1\Unit{cm} gesetzt + werden, so ist Folgendes möglich: % \fi \begin{lstcode} @@ -1596,23 +1596,23 @@ eingestellte Bindekorrektur erhalten bleiben, sollte man den symbolischen Wert \begin{Declaration} \OptionValue{DIV}{areaset} \end{Declaration}% -In\ChangedAt{v3.00}{\Package{typearea}} seltenen Fällen ist es nützlich, wenn +In\ChangedAt{v3.00}{\Package{typearea}} seltenen Fällen ist es nützlich, wenn man den aktuell eingestellten Satzspiegel neu ausrichten lassen kann. Dies ist mit der Option -\OptionValue{DIV}{areaset}\important{\OptionValue{DIV}{areaset}} möglich, +\OptionValue{DIV}{areaset}\important{\OptionValue{DIV}{areaset}} möglich, wobei \DescRef{\LabelBase.cmd.KOMAoptions}\PParameter{DIV=areaset} der Anweisung \begin{lstcode} \areaset[current]{\textwidth}{\textheight} \end{lstcode} -entspricht. Dasselbe Ergebnis erhält man auch, wenn +entspricht. Dasselbe Ergebnis erhält man auch, wenn \OptionValueRef{\LabelBase}{DIV}{last} verwendet wird und der Satzspiegel zuletzt per \DescRef{\LabelBase.cmd.areaset} eingestellt wurde.% % \EndIndexGroup \iftrue% Umbruchkorrekturtext: Alternativen -Wenn Sie konkrete Vorgaben bezüglich der Ränder zu erfüllen haben, ist +Wenn Sie konkrete Vorgaben bezüglich der Ränder zu erfüllen haben, ist \Package{typearea} nicht geeignet. In diesem Fall ist die Verwendung des Pakets \Package{geometry}\IndexPackage{geometry}\important{\Package{geometry}} (siehe @@ -1621,8 +1621,8 @@ Pakets \fi \iffalse % -Das Paket \Package{typearea} ist nicht dafür gedacht, bestimmte Randbreiten -einzustellen. Dafür ist das Paket \Package{geometry}\IndexPackage{geometry} +Das Paket \Package{typearea} ist nicht dafür gedacht, bestimmte Randbreiten +einzustellen. Dafür ist das Paket \Package{geometry}\IndexPackage{geometry} (siehe \cite{package:geometry}) empfehlenswert. % \fi @@ -1633,14 +1633,14 @@ einzustellen. Dafür ist das Paket \Package{geometry}\IndexPackage{geometry} \BeginIndexGroup Das Papierformat ist ein entscheidendes Grundmerkmal eines Dokuments. Wie -bereits bei der Vorstellung der unterstützten Satzspiegelkonstruktionen (siehe +bereits bei der Vorstellung der unterstützten Satzspiegelkonstruktionen (siehe \autoref{sec:typearea.basics} bis \autoref{sec:typearea.circleConstruction} ab \autopageref{sec:typearea.basics}) -aufgezeigt, steht und fällt die Auf"|teilung der Seite und damit das gesamte -Dokumentlayout mit der Wahl des Papierformats. Während die -\LaTeX-Standardklassen auf einige wenige Formate festgelegt sind, unterstützt +aufgezeigt, steht und fällt die Auf"|teilung der Seite und damit das gesamte +Dokumentlayout mit der Wahl des Papierformats. Während die +\LaTeX-Standardklassen auf einige wenige Formate festgelegt sind, unterstützt \KOMAScript{} mit dem Paket \Package{typearea} selbst ausgefallene -Seitengrößen. +Seitengrößen. \begin{Declaration} @@ -1657,9 +1657,9 @@ zentrale Element der Formatauswahl\important[i]{% & \PValue{B0}, \PValue{B1}, \PValue{B2} \dots\\ & \PValue{C0}, \PValue{C1}, \PValue{C2} \dots\\ & \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 +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{% @@ -1667,12 +1667,12 @@ Querformate\important{% \KOption{paper} & \PValue{landscape}, \\ & \PValue{seascape} \end{tabular}% -} werden dadurch unterstützt, dass man die Option ein weiteres Mal mit dem +} werden dadurch unterstützt, dass man die Option ein weiteres Mal mit dem Wert \PValue{landscape}\Index{Papier>Ausrichtung} oder \PValue{seascape}\ChangedAt{v3.02c}{\Package{typearea}} angibt. Dabei unterscheiden sich \PValue{landscape} und \PValue{seascape} nur darin, dass das Programm \File{dvips} bei \PValue{landscape} um -90\Unit{\textdegree} -dreht, während bei \PValue{seascape} um +90\Unit{\textdegree} gedreht +dreht, während bei \PValue{seascape} um +90\Unit{\textdegree} gedreht wird. Hilfreich ist \PValue{seascape} also vor allem dann, wenn ein PostScript-Anzeigeprogramm die Seiten im Querformat auf dem Kopf stellt. Damit der Unterschied eine Rolle spielt, darf auch die nachfolgend @@ -1680,33 +1680,33 @@ beschriebene Option \DescRef{\LabelBase.option.pagesize}% \IndexOption{pagesize}\important{\DescRef{\LabelBase.option.pagesize}} nicht deaktiviert sein. -Zusätzlich kann das \PName{Format} auch in der Form -\PName{Breite}\texttt{:}\PName{Höhe}\ChangedAt{v3.01b}{\Package{typearea}}% -\important{\OptionVName{paper}{Breite\textup{:}Höhe}} beziehungsweise -\PName{Höhe}\texttt{:}\PName{Breite}\ChangedAt{v3.22}{\Package{typearea}}% -\important{\OptionVName{paper}{Höhe\textup{:}Breite}} angegeben -werden. Welcher Wert die \PName{Höhe} und welcher die \PName{Breite} ist, +Zusätzlich kann das \PName{Format} auch in der Form +\PName{Breite}\texttt{:}\PName{Höhe}\ChangedAt{v3.01b}{\Package{typearea}}% +\important{\OptionVName{paper}{Breite\textup{:}Höhe}} beziehungsweise +\PName{Höhe}\texttt{:}\PName{Breite}\ChangedAt{v3.22}{\Package{typearea}}% +\important{\OptionVName{paper}{Höhe\textup{:}Breite}} angegeben +werden. Welcher Wert die \PName{Höhe} und welcher die \PName{Breite} ist, richtet sich nach der Ausrichtung des Papiers. Mit \OptionValue{paper}{landscape} oder \OptionValue{paper}{seascape} ist der -kleinere Wert die \PName{Höhe} und der größere Wert die \PName{Breite}. Mit +kleinere Wert die \PName{Höhe} und der größere Wert die \PName{Breite}. Mit \OptionValue{paper}{portrait}\important{\OptionValue{paper}{portrait}} ist -dagegen der kleinere Wert die \PName{Breite} und der größere Wert die -\PName{Höhe}. +dagegen der kleinere Wert die \PName{Breite} und der größere Wert die +\PName{Höhe}. Es\textnote{Achtung!} wird darauf hingewiesen, dass bis Version~3.01a der -erste Wert immer die \PName{Höhe} und der zweite Wert die \PName{Breite} +erste Wert immer die \PName{Höhe} und der zweite Wert die \PName{Breite} war. Dagegen war von Version~3.01b bis Version~3.21a der erste Wert immer die -\PName{Breite} und der zweite Wert immer die \PName{Höhe}. Dies ist +\PName{Breite} und der zweite Wert immer die \PName{Höhe}. Dies ist insbesondere dann zu beachten, wenn mit einer entsprechenden -Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}% +Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}% \IndexOption{version}\important{\DescRef{\LabelBase.option.version}}, \autoref{sec:typearea.compatibilityOptions}, \DescPageRef{typearea.option.version}) gearbeitet wird. \begin{Example} Angenommen, es soll eine Karteikarte im Format ISO-A8 quer bedruckt - werden. Dabei sollen die Ränder sehr klein gewählt werden. Außerdem - wird auf eine Kopf- und eine Fußzeile verzichtet. + werden. Dabei sollen die Ränder sehr klein gewählt werden. Außerdem + wird auf eine Kopf- und eine Fußzeile verzichtet. \begin{lstcode} \documentclass{article} \usepackage[headinclude=false,footinclude=false,% @@ -1719,7 +1719,7 @@ Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}% b0, b1 \dots\ c0, c1 \dots\ d0, d1 \dots \end{document} \end{lstcode} - Haben die Karteikarten das Sonderformat (Breite:Höhe) + Haben die Karteikarten das Sonderformat (Breite:Höhe) 5\Unit{cm}\,:\,3\Unit{cm}, so ist dies mit \begin{lstcode} \documentclass{article} @@ -1733,7 +1733,7 @@ Kompatibilitätseinstellung (siehe Option \DescRef{\LabelBase.option.version}% b0, b1 \dots\ c0, c1 \dots\ d0, d1 \dots \end{document} \end{lstcode} - möglich. + möglich. \end{Example} In der Voreinstellung wird bei \KOMAScript{} mit A4-Papier in der Ausrichtung @@ -1744,12 +1744,12 @@ das amerikanische Format letter verwendet wird. Bitte beachten Sie unbedingt\textnote{Achtung!}, dass diese Option bei Verwendung einer der \KOMAScript-Klassen als Klassenoption oder per \DescRef{\LabelBase.cmd.KOMAoptions} beziehungsweise -\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden -muss. Eine Änderung des Papierformats oder der Papierausrichtung mit Hilfe +\DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden der Klasse übergeben werden +muss. Eine Änderung des Papierformats oder der Papierausrichtung mit Hilfe der Anweisung \DescRef{\LabelBase.cmd.KOMAoptions}\textnote{keine automatische Neuberechnung} oder \DescRef{\LabelBase.cmd.KOMAoption} nach dem Laden von -\Package{typearea} führt nicht zu einer automatischen Neuberechnung des -Satzspiegels. Vielmehr wirkt sich die Änderung erst bei der nächsten +\Package{typearea} führt nicht 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 \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \hyperref[desc:\LabelBase.option.DIV.last]{\PValue{last}} oder @@ -1765,100 +1765,100 @@ Option \hyperref[desc:\LabelBase.option.DIV.last]{\Option{DIV}} mit den Werten \end{Declaration}% \begin{Explain}% Die oben genannten Mechanismen zur Auswahl des Papierformats haben nur - insofern einen Einfluss auf die Ausgabe, als interne {\LaTeX}-Maße gesetzt + insofern einen Einfluss auf die Ausgabe, als interne {\LaTeX}-Maße gesetzt werden. Das Paket \Package{typearea} verwendet diese dann bei der - Auf"|teilung der Seite in Ränder und Textbereich. Die Spezifikation des + Auf"|teilung der Seite in Ränder und Textbereich. Die Spezifikation des DVI-Formats\Index{DVI} sieht aber an keiner Stelle Angaben zum Papierformat vor. % \iffree{% Wird direkt aus dem DVI-Format in eine Low-Level-Druckersprache wie PCL% \iftrue% Umbruchkorrektur - \footnote{PCL ist eine Familie von Druckersprachen, die HP für seine + \footnote{PCL ist eine Familie von Druckersprachen, die HP für seine Tinten- und Laserdrucker verwendet.}% \fi \ oder ESC/P2% \iftrue% Umbruchkorrektur - \footnote{ESC/P2 ist die Druckersprache, die EPSON für seine 24-Nadel- und - ältere Tinten- oder Laserdrucker benutzt.}% + \footnote{ESC/P2 ist die Druckersprache, die EPSON für seine 24-Nadel- und + ältere Tinten- oder Laserdrucker benutzt.}% \fi \ beziehungsweise ESC/P-R% \iftrue% Umbruchkorrektur - \footnote{ESC/P-R ist die Druckersprache, die EPSON aktuell für Tinten- + \footnote{ESC/P-R ist die Druckersprache, die EPSON aktuell für Tinten- und Laserdrucker benutzt.}% \fi \ ausgegeben, spielt dies normalerweise keine Rolle% }{% - In früheren Zeiten, als DVI zum Ausruck noch direkt in - Low-Level-Druckersprachen übertragen wurde, spielte dies keine Rolle% + In früheren Zeiten, als DVI zum Ausruck noch direkt in + Low-Level-Druckersprachen übertragen wurde, spielte dies keine Rolle% }, da auch bei diesen Ausgaben der 0-Bezugspunkt wie bei DVI links oben liegt. \iffree{Wird aber}{Heutzutage wird aber meist} in Sprachen wie - PostScript\Index{PostScript} oder PDF\Index{PDF} übersetzt, bei denen der - 0-Bezugspunkt an anderer Stelle liegt und außerdem das Papierformat in der + PostScript\Index{PostScript} oder PDF\Index{PDF} übersetzt, bei denen der + 0-Bezugspunkt an anderer Stelle liegt und außerdem das Papierformat in der Ausgabedatei angegeben werden sollte\iffree{, so}{. Dabei} fehlt diese - Information. Als Lösung des Problems verwendet der entsprechende Treiber - eine voreingestellte Papiergröße, die der Anwender entweder per Option oder - durch entsprechende Angabe in der {\TeX}-Quelldatei verändern kann. Bei + Information. Als Lösung des Problems verwendet der entsprechende Treiber + eine voreingestellte Papiergröße, die der Anwender entweder per Option oder + durch entsprechende Angabe in der {\TeX}-Quelldatei verändern kann. Bei Verwendung des DVI-Treibers \File{dvips} oder \File{dvipdfm} kann diese Angabe in Form einer \Macro{special}-Anweisung erfolgen. Bei Verwendung von {pdf\TeX}, {lua\TeX}, {\XeTeX} oder {V\TeX} werden deren - Papierformat-Längen entsprechend gesetzt.% + Papierformat-Längen entsprechend gesetzt.% \end{Explain} -Mit der Option \Option{pagesize} kann eingestellt werden, für welchen -Ausgabetreiber die Papiergröße in das Ausgabedokument geschrieben wird. Die -unterstützten Ausgabetreiber sind \autoref{tab:typearea.outputdriver} \iffalse +Mit der Option \Option{pagesize} kann eingestellt werden, für welchen +Ausgabetreiber die Papiergröße in das Ausgabedokument geschrieben wird. Die +unterstützten Ausgabetreiber sind \autoref{tab:typearea.outputdriver} \iffalse auf \autopageref{tab:typearea.outputdriver}\fi zu entnehmen. Voreingestellt\ChangedAt{v3.17}{\Package{typearea}} ist \Option{pagesize}. Diese Verwendung der Option ohne Angabe eines Wertes entspricht \OptionValue{pagesize}{auto}. % \begin{table} - \caption{Ausgabetreiber für Option \OptionVName{pagesize}{Ausgabetreiber}} + \caption{Ausgabetreiber für Option \OptionVName{pagesize}{Ausgabetreiber}} \begin{desctabular} \pventry{auto}{Falls die pdf\TeX-spezifischen Register \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} und \Macro{pdfpageheight}\IndexLength{pdfpageheight} oder die lua\TeX-spezifischen Register \Macro{pagewidth}\IndexLength{pagewidth} und \Macro{pageheight}\IndexLength{pageheight} vorhanden sind, wird - der Ausgabetreiber \PValue{pdftex} aktiviert. Zusätzlich wird auch der + der Ausgabetreiber \PValue{pdftex} aktiviert. Zusätzlich wird auch der Ausgabetreiber \PValue{dvips} - verwendet. Diese Einstellung ist grundsätzlich auch für \XeTeX{} + verwendet. Diese Einstellung ist grundsätzlich auch für \XeTeX{} geeignet.% \IndexOption{pagesize~=\textKValue{auto}}}% \pventry{automedia}{Dies entspricht dem Ausgabetreiber - \PValue{auto}. Allerdings werden zusätzlich auch noch die + \PValue{auto}. Allerdings werden zusätzlich auch noch die \mbox{V\TeX}-spezifischen Register \Macro{mediawidth}\IndexLength{mediawidth} und \Macro{mediaheight}\IndexLength{mediaheight} gesetzt, falls diese definiert sind.% \IndexOption{pagesize~=\textKValue{automedia}}}% \entry{\PValue{false}, \PValue{no}, \PValue{off}}{% - Die Papiergröße wird nicht an den Ausgabetreiber + Die Papiergröße wird nicht an den Ausgabetreiber gemeldet.% \IndexOption{pagesize~=\textKValue{false}}}% - \pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}}Die Papiergröße + \pventry{dvipdfmx}{\ChangedAt{v3.05a}{\Package{typearea}}Die Papiergröße wird als - \Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in die + \Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in die DVI-Datei geschrieben. Der Name des Ausgabetreibers kommt daher, dass das Programm \File{dvipdfmx} eine Pa\-pier\-for\-mat\-um\-schal\-tung - über diese Anweisung auch innerhalb des Dokuments erlaubt.% + über diese Anweisung auch innerhalb des Dokuments erlaubt.% \IndexOption{pagesize~=\textKValue{dvipdfmx}}}% - \pventry{dvips}{Bei Verwendung innerhalb der Dokumentpräambel wird die - Papiergröße über - \Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in das + \pventry{dvips}{Bei Verwendung innerhalb der Dokumentpräambel wird die + Papiergröße über + \Macro{special}\PParameter{pagesize=\PName{Breite},\PName{Höhe}} in das Dokument geschrieben. Da das Programm \File{dvips} keine - Pa\-pier\-for\-mat\-um\-schal\-tung innerhalb des Dokuments unterstützt, + Pa\-pier\-for\-mat\-um\-schal\-tung innerhalb des Dokuments unterstützt, wird bei Bedarf im Dokument ein recht unsauberer Hack verwendet, um die - Umschaltung nach Möglichkeit dennoch zu - erreichen. Pa\-pier\-for\-mat\-um\-schal\-tung nach der Dokumentprämbel + Umschaltung nach Möglichkeit dennoch zu + erreichen. Pa\-pier\-for\-mat\-um\-schal\-tung nach der Dokumentprämbel bei gleichzeitiger Verwendung des Ausgabetreibers \PValue{dvips} erfolgen daher auf eigene Gefahr!% \IndexOption{pagesize~=\textKValue{dvips}}}% \entry{\PValue{pdftex}, \PValue{luatex}}{% - \ChangedAt{v3.20}{\Package{typearea}}Die Papiergröße - wird über die pdf\TeX-spezifischen Register + \ChangedAt{v3.20}{\Package{typearea}}Die Papiergröße + wird über die pdf\TeX-spezifischen Register \Macro{pdfpagewidth}\IndexLength{pdfpagewidth} und \Macro{pdfpageheight}\IndexLength{pdfpageheight} oder die lua\TeX-spezifischen Register \Macro{pagewidth}\IndexLength{pagewidth} und \Macro{pageheight}\IndexLength{pageheight} gesetzt. Dies ist auch jederzeit innerhalb des Dokuments problemlos - möglich.% + möglich.% \IndexOption{pagesize~=\textKValue{pdftex}}% \IndexOption{pagesize~=\textKValue{luatex}}}% \end{desctabular} @@ -1868,29 +1868,29 @@ entspricht \OptionValue{pagesize}{auto}. \begin{Example} Angenommen, es soll ein Dokument sowohl als DVI-Datei verwendet werden, als auch eine Online-Version im PDF-Format erstellt - werden. Dann könnte die Präambel beispielsweise so beginnen: + werden. Dann könnte die Präambel beispielsweise so beginnen: \begin{lstcode}[% aboveskip=.5\baselineskip plus .1\baselineskip minus .1\baselineskip,% belowskip=.4\baselineskip plus .1\baselineskip minus .1\baselineskip] \documentclass{article} \usepackage[paper=A4,pagesize]{typearea} \end{lstcode} - Wird nun für die Bearbeitung {pdf\TeX} verwendet \emph{und} die - PDF-Ausgabe aktiviert, so werden die beiden Spezialgrößen + Wird nun für die Bearbeitung {pdf\TeX} verwendet \emph{und} die + PDF-Ausgabe aktiviert, so werden die beiden Spezialgrößen \Macro{pdfpagewidth} und \Macro{pdfpageheight} entsprechend gesetzt. Wird jedoch eine DVI-Datei erzeugt -- egal ob mit {\LaTeX} oder {pdf\LaTeX} --, so wird ein \Macro{special} an den Anfang dieser Datei geschrieben. \end{Example}% -\iffree{% Die Empfehlung ist eigentlich überholt. Wer derart alte Versionen +\iffree{% Die Empfehlung ist eigentlich überholt. Wer derart alte Versionen % von typearea verwendet, ist selbst schuld. Es wird empfohlen\textnote{Achtung!}, die Option \Option{pagesize} immer -anzugeben, weil frühere Versionen von \Package{typearea} sie noch nicht als +anzugeben, weil frühere Versionen von \Package{typearea} sie noch nicht als Voreinstellung gesetzt haben. In der Regel ist dabei die Methode ohne \PName{Ausgabetreiber} oder mit \PValue{auto} oder \PValue{automedia} -günstig.% +günstig.% }{% - \vskip-1\ht\strutbox plus .75\ht\strutbox% Wegen Beispiel am Ende der Erklärung + \vskip-1\ht\strutbox plus .75\ht\strutbox% Wegen Beispiel am Ende der Erklärung } \EndIndexGroup % @@ -1901,128 +1901,128 @@ günstig.% \section{Tipps} \seclabel{tips} -Insbesondere für die Erstellung von schriftlichen Arbeiten während des -Studiums findet man häufig Vorschriften\textnote{Satzvorschriften +Insbesondere für die Erstellung von schriftlichen Arbeiten während des +Studiums findet man häufig Vorschriften\textnote{Satzvorschriften vs. gute~Typografie}, die einer typografischen Begutachtung nicht nur in keiner Weise standhalten, sondern massiv gegen alle Regeln der Typografie -verstoßen. Ursache für solche Regeln ist oft typografische Inkompetenz +verstoßen. Ursache für solche Regeln ist oft typografische Inkompetenz derjenigen, die sie herausgeben. Manchmal ist die Ursache auch im -Ausgangspunkt begründet, nämlich der Schreibmaschine. Mit einer +Ausgangspunkt begründet, nämlich der Schreibmaschine. Mit einer Schreibmaschine oder einer Textverarbeitung von 1980 ist es ohne -erheblichen Aufwand kaum möglich, typografisch perfekte Ergebnisse zu -erzielen. Also wurden einst Vorschriften erlassen, die leicht erfüllbar -schienen und dem Korrektor trotzdem entgegenkommen. Dazu zählen dann -Randeinstellungen, die für einseitigen Druck mit einer Schreibmaschine zu -brauchbaren Zeilenlängen führen. Um nicht extrem kurze Zeilen zu erhalten, die -durch Flattersatz zudem verschlimmert werden, werden die Ränder schmal -gehalten und für Korrekturen stattdessen ein großer Durchschuss in Form von +erheblichen Aufwand kaum möglich, typografisch perfekte Ergebnisse zu +erzielen. Also wurden einst Vorschriften erlassen, die leicht erfüllbar +schienen und dem Korrektor trotzdem entgegenkommen. Dazu zählen dann +Randeinstellungen, die für einseitigen Druck mit einer Schreibmaschine zu +brauchbaren Zeilenlängen führen. Um nicht extrem kurze Zeilen zu erhalten, die +durch Flattersatz zudem verschlimmert werden, werden die Ränder schmal +gehalten und für Korrekturen stattdessen ein großer Durchschuss in Form von eineinhalbzeiligem Satz vorgeschrieben. Bevor moderne -Textverarbeitungssysteme verfügbar wurden, wäre -- außer mit {\TeX} -- -einzeiliger Satz die einzige Alternative gewesen. Dabei wäre dann selbst das +Textverarbeitungssysteme verfügbar wurden, wäre -- außer mit {\TeX} -- +einzeiliger Satz die einzige Alternative gewesen. Dabei wäre dann selbst das Anbringen von Korrekturzeichen schwierig geworden. Als die Verwendung von -Computern für die Erstellung schriftlicher Arbeiten üblicher wurde, hat sich +Computern für die Erstellung schriftlicher Arbeiten üblicher wurde, hat sich manches Mal auch der Spieltrieb des einen oder anderen Studenten gezeigt, der durch Verwendung einer Schmuckschrift seine Arbeit aufpeppen und so eine bessere Note mit weniger Einsatz herausschinden wollte. Nicht bedacht hat er -dabei, dass solche Schriften schlechter zu lesen und deshalb für den Zweck +dabei, dass solche Schriften schlechter zu lesen und deshalb für den Zweck ungeeignet sind. Damit hielten zwei Brotschriften Einzug in die Vorschriften, die weder zusammenpassen noch im Falle von Times wirklich gut geeignet sind. Times ist eine relativ enge Schrift, die Anfang des 20.~Jahrhunderts -speziell für schmale Spalten im englischen Zeitungssatz entworfen wurde. In -modernen Schnitten ist dies etwas entschärft. Dennoch passt die häufig +speziell für schmale Spalten im englischen Zeitungssatz entworfen wurde. In +modernen Schnitten ist dies etwas entschärft. Dennoch passt die häufig vorgeschriebene Times meist nicht zu den gleichzeitig gegebenen Randvorgaben. {\LaTeX} setzt bereits von sich aus mit ausreichendem Durchschuss. -Gleichzeitig sind die Ränder bei sinnvollen Zeilenlängen groß genug, um Platz -für Korrekturen zu bieten. Dabei wirkt die Seite trotz einer Fülle von Text -großzügig angelegt. +Gleichzeitig sind die Ränder bei sinnvollen Zeilenlängen groß genug, um Platz +für Korrekturen zu bieten. Dabei wirkt die Seite trotz einer Fülle von Text +großzügig angelegt. -Oft sind die typografisch mehr als fragwürdigen Satzvorschriften mit {\LaTeX} -auch außerordentlich schwierig umzusetzen. So kann eine feste Anzahl von -»Anschlägen« nur dann eingehalten werden, wenn keine proportionale Schrift +Oft sind die typografisch mehr als fragwürdigen Satzvorschriften mit {\LaTeX} +auch außerordentlich schwierig umzusetzen. So kann eine feste Anzahl von +»Anschlägen« nur dann eingehalten werden, wenn keine proportionale Schrift verwendet wird. Es gibt nur wenige gute nichtproportionale Schriften. \iffalse % Umbruchkorrektur Kaum ein Text, der mit einer derartigen Schrift gesetzt ist, wirkt wirklich -gut. So wird häufig % +gut. So wird häufig % \else -Häufig wird % +Häufig wird % \fi % versucht, durch ausladende Serifen beispielsweise beim kleinen -»i« oder »l« die unterschiedliche Breite der Zeichen auszugleichen. Dies kann +»i« oder »l« die unterschiedliche Breite der Zeichen auszugleichen. Dies kann nicht funktionieren. Im Ergebnis wirkt der Text unruhig und -zerrissen. Außerdem verträgt sich eine solche Schrift kaum mit dem im -deutschen Sprachraum üblichen und allgemein vorzuziehenden Blocksatz. Gewisse -Vorgaben können daher bei Verwendung von {\LaTeX} nur ignoriert oder großzügig -ausgelegt werden, etwa indem man »60~Anschläge pro Zeile« nicht als feste, +zerrissen. Außerdem verträgt sich eine solche Schrift kaum mit dem im +deutschen Sprachraum üblichen und allgemein vorzuziehenden Blocksatz. Gewisse +Vorgaben können daher bei Verwendung von {\LaTeX} nur ignoriert oder großzügig +ausgelegt werden, etwa indem man »60~Anschläge pro Zeile« nicht als feste, sondern als durchschnittliche oder maximale Angabe interpretiert. -Wie ausgeführt, sind Satzvorschriften meist dazu gedacht, ein brauchbares -Ergebnis zu erhalten, auch wenn der Ausführende selbst nicht weiß, was dabei -zu beachten ist. Brauchbar bedeutet häufig: lesbar und korrigierbar. Nach +Wie ausgeführt, sind Satzvorschriften meist dazu gedacht, ein brauchbares +Ergebnis zu erhalten, auch wenn der Ausführende selbst nicht weiß, was dabei +zu beachten ist. Brauchbar bedeutet häufig: lesbar und korrigierbar. Nach meiner Auf"|fassung wird ein mit {\LaTeX} und dem \Package{typearea}-Paket -gesetzter Text bezüglich des Satzspiegels diesen Anforderungen von vornherein +gesetzter Text bezüglich des Satzspiegels diesen Anforderungen von vornherein gerecht. Wenn Sie also mit Vorschriften konfrontiert sind, die offensichtlich erheblich davon abweichen, so empfehle ich, dem Betreuer einen Textauszug vorzulegen und nachzufragen, ob es gestattet ist, die Arbeit trotz der -Abweichungen in dieser Form zu liefern. Gegebenenfalls kann durch Veränderung +Abweichungen in dieser Form zu liefern. Gegebenenfalls kann durch Veränderung der Option \DescRef{\LabelBase.option.DIV}\important{\DescRef{\LabelBase.option.DIV}} der Satzspiegel moderat angepasst werden. Von der Verwendung von \DescRef{\LabelBase.cmd.areaset} zu diesem Zweck rate ich jedoch -ab. Schlimmstenfalls verwenden Sie das nicht zu {\KOMAScript} gehörende +ab. Schlimmstenfalls verwenden Sie das nicht zu {\KOMAScript} gehörende \Package{geometry}-Paket\important{\Package{geometry}}\IndexPackage{geometry} -(siehe \cite{package:geometry}) oder verändern Sie die Satzspiegelparameter +(siehe \cite{package:geometry}) oder verändern Sie die Satzspiegelparameter von {\LaTeX} selbst. Die von \Package{typearea} ermittelten Werte finden Sie in der \File{log}-Datei Ihres Dokuments. Mit Hilfe von Option \DescRef{typearea-experts.option.usegeometry}% \important{\DescRef{typearea-experts.option.usegeometry}}, die Sie in -\autoref{part:forExperts} finden, kann außerdem die Zusammenarbeit von +\autoref{part:forExperts} finden, kann außerdem die Zusammenarbeit von \Package{typearea} und \Package{geometry} verbessert werden. Damit sollten -moderate Anpassungen möglich sein. Achten Sie jedoch unbedingt darauf, dass -die Proportionen des Textbereichs mit denen der Seite unter Berücksichtigung -der Bindekorrektur annähernd übereinstimmen. +moderate Anpassungen möglich sein. Achten Sie jedoch unbedingt darauf, dass +die Proportionen des Textbereichs mit denen der Seite unter Berücksichtigung +der Bindekorrektur annähernd übereinstimmen. Sollte es unbedingt erforderlich sein, den Text eineinhalbzeilig zu setzen, so definieren Sie keinesfalls \Macro{baselinestretch} um. Dieses Vorgehen wird -zwar allzu häufig empfohlen, ist aber seit der Einführung von {\LaTeXe} im +zwar allzu häufig empfohlen, ist aber seit der Einführung von {\LaTeXe} im Jahre 1994 obsolet. Verwenden Sie schlimmstenfalls den Befehl \Macro{linespread}. Ich empfehle das Paket \Package{setspace}\important{\Package{setspace}}\IndexPackage{setspace}, das -nicht zu {\KOMAScript} gehört (siehe \cite{package:setspace}). Auch sollten +nicht zu {\KOMAScript} gehört (siehe \cite{package:setspace}). Auch sollten Sie \Package{typearea} nach der Umstellung des Zeilenabstandes den Satzspiegel -für diesen Abstand berechnen lassen, jedoch für den Titel, besser auch für die +für diesen Abstand berechnen lassen, jedoch für den Titel, besser auch für die Verzeichnisse -- sowie das Literaturverzeichnis und den Index -- wieder auf -normalen Satz umschalten. Näheres dazu finden Sie bei der Erklärung zu +normalen Satz umschalten. Näheres dazu finden Sie bei der Erklärung zu \OptionValueRef{\LabelBase}{DIV}{current}% \important{\OptionValueRef{\LabelBase}{DIV}{current}}. Das \Package{typearea}-Paket berechnet auch bei der Option \OptionValueRef{\LabelBase}{DIV}{calc}% -\important{\OptionValueRef{\LabelBase}{DIV}{calc}} einen sehr großzügigen +\important{\OptionValueRef{\LabelBase}{DIV}{calc}} einen sehr großzügigen Textbereich. Viele konservative Typografen werden feststellen, dass die -resultierende Zeilenlänge noch zu groß ist. Der berechnete \Var{DIV}-Wert ist +resultierende Zeilenlänge noch zu groß ist. Der berechnete \Var{DIV}-Wert ist ebenfalls in der \File{log}-Datei zum jeweiligen Dokument zu finden. Sie -können also leicht nach dem ersten \LaTeX-Lauf einen kleineren Wert wählen. +können also leicht nach dem ersten \LaTeX-Lauf einen kleineren Wert wählen. Nicht\textnote{Was ist besser?} selten wird mir die Frage gestellt, warum ich -eigentlich kapitelweise auf einer Satzspiegelberechnung herumreite, während es -sehr viel einfacher wäre, nur ein Paket zur Verfügung zu stellen, mit dem man -die Ränder wie bei einer Textverarbeitung einstellen kann. Oft wird auch -behauptet, ein solches Paket wäre ohnehin die bessere Lösung, da jeder selbst -wisse, wie gute Ränder zu wählen seien, und die Ränder von {\KOMAScript} wären +eigentlich kapitelweise auf einer Satzspiegelberechnung herumreite, während es +sehr viel einfacher wäre, nur ein Paket zur Verfügung zu stellen, mit dem man +die Ränder wie bei einer Textverarbeitung einstellen kann. Oft wird auch +behauptet, ein solches Paket wäre ohnehin die bessere Lösung, da jeder selbst +wisse, wie gute Ränder zu wählen seien, und die Ränder von {\KOMAScript} wären ohnehin nicht gut. Ich erlaube mir zum Abschluss dieses Kapitels ein passendes Zitat von Hans Peter Willberg und Friedrich Forssmann, zwei der angesehensten Typografen der Gegenwart (siehe \cite{TYPO:ErsteHilfe}): \begin{quote} \phantomsection\label{sec:typearea.tips.cite}% - \textit{Das\textnote{Zitat!} Selbermachen ist längst üblich, die Ergebnisse - oft fragwürdig, weil Laien-Typografen nicht sehen, was nicht stimmt und - nicht wissen können, worauf es ankommt. So gewöhnt man sich an falsche und - schlechte Typografie.} [\dots] \textit{Jetzt könnte der Einwand kommen, - Typografie sei doch Geschmackssache. Wenn es um Dekoration ginge, könnte + \textit{Das\textnote{Zitat!} Selbermachen ist längst üblich, die Ergebnisse + oft fragwürdig, weil Laien-Typografen nicht sehen, was nicht stimmt und + nicht wissen können, worauf es ankommt. So gewöhnt man sich an falsche und + schlechte Typografie.} [\dots] \textit{Jetzt könnte der Einwand kommen, + Typografie sei doch Geschmackssache. Wenn es um Dekoration ginge, könnte man das Argument vielleicht gelten lassen, da es aber bei Typografie in - erster Linie um Information geht, können Fehler nicht nur stören, sondern + erster Linie um Information geht, können Fehler nicht nur stören, sondern sogar Schaden anrichten.} \end{quote} % @@ -2030,6 +2030,6 @@ Typografen der Gegenwart (siehe \cite{TYPO:ErsteHilfe}): %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: "../guide" %%% End: diff --git a/macros/latex/contrib/koma-script/source-doc/plength.dtx b/macros/latex/contrib/koma-script/source-doc/plength.dtx index f0006db25f..556f1ff463 100644 --- a/macros/latex/contrib/koma-script/source-doc/plength.dtx +++ b/macros/latex/contrib/koma-script/source-doc/plength.dtx @@ -2,7 +2,7 @@ % \iffalse % ====================================================================== % plength.dtx -% Copyright (c) Markus Kohm, 2005-2017 +% Copyright (c) Markus Kohm, 2005-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -20,7 +20,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % plength.dtx -% Copyright (c) Markus Kohm, 2005-2017 +% Copyright (c) Markus Kohm, 2005-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -87,7 +87,6 @@ \ProvidesFile{plength.drv}[2014/02/28 plength MetaPost graphics] \documentclass{ltxdoc} \usepackage[ngerman]{babel} -\usepackage[latin1]{inputenc} \begin{document} \DocInput{plength.dtx} \end{document} @@ -95,7 +94,7 @@ %</driver> % \fi % -% \title{MetaPost-Grafiken für das Briefkapitel} +% \title{MetaPost-Grafiken für das Briefkapitel} % \author{Stephan Hennig und Markus Kohm} % \date{2010-02-09} % \maketitle @@ -106,14 +105,14 @@ % \begin{flushleft} % \texttt{mpost --tex=latex} \meta{mp-file} % \end{flushleft} -% bearbeitet ergibt \texttt{1}-Dateien. Diese können als EPS-Dateien +% bearbeitet ergibt \texttt{1}-Dateien. Diese können als EPS-Dateien % geladen werden. Es kann aber auch mit % \begin{flushleft} % \texttt{mptopdf} \meta{1-Datei} % \end{flushleft} % eine PDF-Datei erzeugt werden. % -% Anpassungen werden ausschließlich in der \texttt{dtx}-Datei vorgenommen! +% Anpassungen werden ausschließlich in der \texttt{dtx}-Datei vorgenommen! % Wesentlich ist dabei der Abschnitt \texttt{main}. % %<*main> @@ -124,12 +123,12 @@ % Hinweise zu den Variablen: % \begin{itemize} % \item \texttt{input pllcoDIN} oder \texttt{input pllcoSN}\hfill\\ -% legt fest, ob die Maße für Briefe nach DIN oder SN -% geladen werden. Damit kann gewählt werden, welches Layout -% verdeutlicht werden soll. Sollen die Längen eingezeichnet werden, +% legt fest, ob die Maße für Briefe nach DIN oder SN +% geladen werden. Damit kann gewählt werden, welches Layout +% verdeutlicht werden soll. Sollen die Längen eingezeichnet werden, % ist pllcoDIN zu verwenden. % \item \texttt{grafikhoehe}\hfill\\ -% legt die Höhe der Ausgabedatei fest. +% legt die Höhe der Ausgabedatei fest. % \item \texttt{strichstaerke}\hfill\\ % bestimmt die Stiftbreite, die zum Zeichnen des % Briefbogens, der Faltmarken und der From-Rule benutzt wird. @@ -138,32 +137,32 @@ % Element-Rahmen (nicht der Hilfsrahmen). % \item \texttt{hilfsstrichstaerke}\hfill\\ % bestimmt die Stiftbreite zum Zeichnen der -% Bemaßung und der Hilfsrahmen. +% Bemaßung und der Hilfsrahmen. % \item \texttt{tickhoehe}\hfill\\ -% legt die Höhe der vertikalen Linien horizontaler -% Bemaßung fest (Makro hmeasure). Die Maßlinie wird auf halber Höhe -% von tickhoehe gezeichnet. Für die Makros vmeasure und dmeasure gilt -% ähnliches. In dmeasure wird jedoch ein Vielfaches von tickhoehe +% legt die Höhe der vertikalen Linien horizontaler +% Bemaßung fest (Makro hmeasure). Die Maßlinie wird auf halber Höhe +% von tickhoehe gezeichnet. Für die Makros vmeasure und dmeasure gilt +% ähnliches. In dmeasure wird jedoch ein Vielfaches von tickhoehe % verwendet. % \item \texttt{framed} und \texttt{filled}\hfill\\ % legen fest, ob die Elemente mit einem Rahmen -% versehen bzw. gefüllt werden sollen. +% versehen bzw. gefüllt werden sollen. % \item \texttt{drawcolor}\hfill\\ % legt die Farbe von Linien und Text fest. % \item \texttt{fillcolor}\hfill\\ -% legt die Füllfarbe fest, falls filled=true ist. +% legt die Füllfarbe fest, falls filled=true ist. % \item \texttt{latexlengths}\hfill\\ -% legt fest, ob die unveränderlichen LaTeX-Längen +% legt fest, ob die unveränderlichen LaTeX-Längen % angezeigt werden sollen. % \item \texttt{latexlengthcolor}\hfill\\ -% legt die Farbe fest, mit der LaTeX-Längen +% legt die Farbe fest, mit der LaTeX-Längen % gezeichnet werden. % \item \texttt{language}\hfill\\ % legt die Sprache der Beschreibung fest. % \item \texttt{ahlength}\hfill\\ -% Da foldmarkhpos sehr klein ist, können sich bei kleinen Grafiken -% die Pfeilspitzen der Bemaßung berühren. Um das zu verhindern, kann -% mit der MetaPost-internen Variablen ahlength die Pfeillänge +% Da foldmarkhpos sehr klein ist, können sich bei kleinen Grafiken +% die Pfeilspitzen der Bemaßung berühren. Um das zu verhindern, kann +% mit der MetaPost-internen Variablen ahlength die Pfeillänge % verringert werden. % \end{itemize} % @@ -209,7 +208,7 @@ end %<*tex> % \section{Der Abschnitt \texttt{tex}} % -% Dieser Abschnitt enthält sozusagen den \TeX{}-Part der Grafiken. +% Dieser Abschnitt enthält sozusagen den \TeX{}-Part der Grafiken. % Hier werden beispielsweise die Fonts festgelegt. % % \begin{macrocode} @@ -218,7 +217,6 @@ verbatimtex %&latex %LATEX \documentclass[fontsize=8pt]{scrartcl} -\usepackage[latin1]{inputenc} \usepackage[ngerman]{babel} \usepackage[T1]{fontenc} \IfFileExists{scrnonfree.tex}{% @@ -299,18 +297,18 @@ def defdescriptionde = begingroup %<*terms> description[1]=btex \descr{}Briefkopf etex; - description[2]=btex \descr{}Brief"|fuß{} etex; - description[3]=btex \descr{}Rücksendeadresse etex; + description[2]=btex \descr{}Brief"|fuß{} etex; + description[3]=btex \descr{}Rücksendeadresse etex; description[4]=btex \descr{}Versandart etex; - description[5]=btex \descr{}Empfängeradresse etex; - description[6]=btex \descr{}Geschäftszeile etex; + description[5]=btex \descr{}Empfängeradresse etex; + description[6]=btex \descr{}Geschäftszeile etex; description[7]=btex \descr{}Titel etex; description[8]=btex \descr{}Betreff etex; description[9]=btex \descr{}Anrede etex; description[10]=btex \descr{}Brieftext etex; - description[11]=btex \descr{}Grußfloskel etex; + description[11]=btex \descr{}Grußfloskel etex; description[12]=btex \descr{}Signatur etex; - description[13]=btex \descr{}\begin{tabular}{@{}c@{}}Absender-\\ergänzung\end{tabular} etex; + description[13]=btex \descr{}\begin{tabular}{@{}c@{}}Absender-\\ergänzung\end{tabular} etex; %</terms> %<*!terms> description[1]=btex \Multi{\Variable{firsthead}\\ @@ -393,11 +391,11 @@ enddef; % %<*values> % \section{Der Abschnitt \texttt{values}} -% In diesem Abschnitt finden sich Maße für die unterschiedlichen Briefe +% In diesem Abschnitt finden sich Maße für die unterschiedlichen Briefe % ausgehend von \texttt{11pt}, \texttt{a4paper}. % %<*DIN> -% \section{Maße für DIN-Briefe} +% \section{Maße für DIN-Briefe} % %\begin{macrocode} numeric paperwidth; @@ -542,7 +540,7 @@ sigheight = baselineskip; %</DIN> % %<*SN> -% \section{Maße für SN-Briefe} +% \section{Maße für SN-Briefe} % \begin{macrocode} numeric paperwidth; numeric paperheight; @@ -690,18 +688,18 @@ sigheight = baselineskip; % %<*include> % \section{Der Abschnitt \texttt{include}} -% \changes{}{2005-08-30}{Korrektur der Stiftstärken} +% \changes{}{2005-08-30}{Korrektur der Stiftstärken} % % Dieser Abschnitt erzeugt die Datei \texttt{plinc.mp} mit den wesentlichen -% Definitionen für die Erzeugung eines Elements. Eine Element ist -% beispielsweise eine Pseudolänge, eine Beschreibung (Variable), ein Feld, +% Definitionen für die Erzeugung eines Elements. Eine Element ist +% beispielsweise eine Pseudolänge, eine Beschreibung (Variable), ein Feld, % \dots). % % \begin{macrocode} def lengths = toaddrindent := 0.7cm; % \end{macrocode} -% Die Breite des \texttt{location}-Feldes wird später berechnet und deshalb +% Die Breite des \texttt{location}-Feldes wird später berechnet und deshalb % hier nicht mehr mit % \begin{verbatim} % locwidth := 3.7cm; @@ -751,7 +749,7 @@ def drawframedelements = pickup pencircle scaled framestrichstaerke; drawoptions(withcolor drawcolor); % \end{macrocode} -% Kopf und Fuß +% Kopf und Fuß % \begin{macrocode} draw unitsquare xscaled firstheadwidth yscaled firstheadheight shifted (firstheadhpos, firstheadvpos) transformed T; @@ -770,12 +768,12 @@ def drawframedelements = shifted (istoaddrhpos+toaddrindent, toaddrvpos+backaddrheight+specialmailheight) transformed T; % \end{macrocode} -% Absenderergänzung: +% Absenderergänzung: % \begin{macrocode} draw unitsquare xscaled locwidth yscaled toaddrheight shifted (lochpos, toaddrvpos) transformed T; % \end{macrocode} -% Geschäftszeile: +% Geschäftszeile: % \begin{macrocode} draw unitsquare xscaled refwidth yscaled refheight shifted (1in+oddsidemargin, refvpos) transformed T; @@ -818,7 +816,7 @@ def drawfilledelements = fi drawoptions (withcolor fillcolor); % \end{macrocode} -% Kopf und Fuß: +% Kopf und Fuß: % \begin{macrocode} fill unitsquare xscaled firstheadwidth yscaled firstheadheight shifted (firstheadhpos, firstheadvpos) transformed T; @@ -837,12 +835,12 @@ def drawfilledelements = shifted (istoaddrhpos+toaddrindent, toaddrvpos+backaddrheight+specialmailheight) transformed T; % \end{macrocode} -% Absenderergänzung: +% Absenderergänzung: % \begin{macrocode} fill unitsquare xscaled locwidth yscaled toaddrheight shifted (lochpos, toaddrvpos) transformed T; % \end{macrocode} -% Geschäftszeile: +% Geschäftszeile: % \begin{macrocode} fill unitsquare xscaled refwidth yscaled refheight shifted (refhpos, refvpos) transformed T; @@ -1123,7 +1121,7 @@ begingroup drawcolor := latexlengthcolor; pickup pencircle scaled hilfsstrichstaerke; % \end{macrocode} -% \LaTeX-Längen: +% \LaTeX-Längen: % \begin{macrocode} vmeasure((1in+oddsidemargin+openingwidth,subjectvpos-baselineskip), baselineskip, latexlength[1], origin, rt); @@ -1159,7 +1157,7 @@ begingroup draw (p--p shifted (0,-tickhoehe)) shifted (breite,0) transformed T; % \end{macrocode} % Messlinie; -% die Korrektur der Stiftstärke muss nach der Transformation +% die Korrektur der Stiftstärke muss nach der Transformation % in Zeichenkoordinaten erfolgen: % \begin{macrocode} pleft = p shifted (0,-0.5*tickhoehe) @@ -1191,7 +1189,7 @@ begingroup draw (p--p shifted (tickhoehe,0)) shifted (0,breite) transformed T; % \end{macrocode} % Messlinie; -% die Korrektur der Stiftstärke muss nach der Transformation +% die Korrektur der Stiftstärke muss nach der Transformation % in Zeichenkoordinaten erfolgen: % \begin{macrocode} ptop = p shifted (0.5*tickhoehe,0) @@ -1223,7 +1221,7 @@ begingroup ptop = p shifted (0,-1.5*tickhoehe) shifted (tickhoehe,0) transformed T; % \end{macrocode} -% Die Korrektur der Stiftstärke muss nach der Transformation +% Die Korrektur der Stiftstärke muss nach der Transformation % in Zeichenkoordinaten erfolgen. % \begin{macrocode} pbottom = p shifted (tickhoehe,0) @@ -1246,7 +1244,7 @@ def writedescription(expr lang) = fi drawoptions(withcolor drawcolor); % \end{macrocode} -% Kopf und Fuß: +% Kopf und Fuß: % \begin{macrocode} label(description[1], (firstheadhpos+0.5*firstheadwidth, firstheadvpos+0.5*firstheadheight) @@ -1268,12 +1266,12 @@ def writedescription(expr lang) = toaddrvpos+backaddrheight+specialmailheight+0.5*(toaddrheight-backaddrheight-specialmailheight)) transformed T); % \end{macrocode} -% Absenderergänzung: +% Absenderergänzung: % \begin{macrocode} label(description[13], (lochpos+0.5*locwidth, toaddrvpos+0.5*toaddrheight) transformed T); % \end{macrocode} -% Geschäftszeile: +% Geschäftszeile: % \begin{macrocode} label(description[6], (1in+oddsidemargin+0.5*refwidth, refvpos+0.5*refheight) @@ -1319,7 +1317,7 @@ enddef; \endinput %%% Local Variables: %%% mode: doctex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: t %%% End: % \fi diff --git a/macros/latex/contrib/koma-script/source-doc/scrguide.cls b/macros/latex/contrib/koma-script/source-doc/scrguide.cls index cee1ba89c7..d4c2bbb23d 100644 --- a/macros/latex/contrib/koma-script/source-doc/scrguide.cls +++ b/macros/latex/contrib/koma-script/source-doc/scrguide.cls @@ -38,7 +38,7 @@ % \section{Identification} % % \begin{macrocode} -\ProvidesClass{scrguide}[2019/02/01 v1.13d internal KOMA-Script guide class] +\ProvidesClass{scrguide}[2019/10/10 v1.15 internal KOMA-Script guide class] % \end{macrocode} % % @@ -116,11 +116,8 @@ % \end{macrocode} % \end{macro} % \end{macro} -% NOTE: I use \texttt{latin1} instead of the prefered \texttt{utf8} because of -% problems of early versions of package \textsf{listings}. % \begin{macrocode} \LoadClassWithOptions{scrbook} -\RequirePackage[latin1]{inputenc} \RequirePackage[TS1,T1]{fontenc} \newcommand*{\strngerman}{ngerman} \newcommand*{\strenglish}{english} @@ -659,6 +656,8 @@ % \begin{macro}{\PageStyle} % \begin{macro}{\Variable} % \begin{macro}{\FontElement} +% \begin{macro}{\DoHook} +% \changes{v1.14}{2019/02/20}{neu}^^A % \begin{macro}{\PName} % \begin{macro}{\PValue} % \begin{macro}{\Parameter} @@ -1003,12 +1002,12 @@ \BeginIndex{PLength}{#1}% \LabelPLength{#1}% \scr@ifundefinedorrelax{% - r@\label@desc@prefix scrlttr2-experts.cmd.@setplength}{% - \textMacro{@setplength}% + r@\label@desc@prefix scrlttr2-experts.cmd.setplength}{% + \textMacro{setplength}% }{% \begingroup \let\Macro\textMacro - \DescRef{scrlttr2-experts.cmd.@setplength}% + \DescRef{scrlttr2-experts.cmd.setplength}% \endgroup }% \PParameter{#1}\Parameter{\lengthname}% @@ -1050,7 +1049,7 @@ \endgroup } \DeclareSpecialMarkup{\FontElement}{\mbox{\texttt{#1}}}{% - \par + \par \leftskip\z@ \BeginIndex{FontElement}{#1}% \LabelFontElement{#1}% @@ -1071,6 +1070,45 @@ }% \PParameter{#1}\OParameter{\fontsettingname}% } +\newcommand*{\LabelDoHook}[2][\label@suffix]{% + \begingroup + \renewcommand*{\PName}[1]{=##1=}% + \ForDoHook{#2}{\Label@DoHook{#1}}% + \endgroup +} +\newcommand*{\Label@DoHook}[3]{% + \IfArgIsEmpty{#3}{\@firstofone}{% + \scr@ifundefinedorrelax{dhr@\label@desc@prefix\label@base.dohook.#2#1}{% + \@firstofone + }{% + \@gobble + }% + }{% + \protected@edef\@currentlabel{\DoHook{#2}}% + \label@sanitize + \Hy@MakeCurrentHref{\label@desc@prefix\label@base.dohook.#2#1}% + \ClassInfo{scrguide}{Anchor: `\@currentHref'}% + \Hy@raisedlink{\hyper@anchorstart{\@currentHref}\hyper@anchorend}% + \label{\label@desc@prefix\label@base.dohook.#2#1}% + \expandafter\gdef + \csname dhr@\label@desc@prefix\label@base.dohook.#2#1\endcsname{#3}% + }% +} +\DeclareSpecialMarkup{\DoHook}{\mbox{\texttt{#1}}}{% + \par + \leftskip\z@ + \BeginIndex{DoHook}{#1}% + \LabelDoHook{#1}% + \scr@ifundefinedorrelax{r@scrbase.cmd.ExecuteDoHook}{% + \textMacro{ExecuteDoHook}% + }{% + \begingroup + \let\Macro\textMacro + \DescRef{scrbase.cmd.ExecuteDoHook}% + \endgroup + }% + \PParameter{#1}% +} \DeclareRobustCommand*{\PName}[1]{\texttt{\textit{#1}}} \DeclareRobustCommand*{\PValue}[1]{\texttt{#1}} \DeclareRobustCommand*{\Parameter}[1]{% @@ -1314,6 +1352,7 @@ \scr@Desc@let\PLength \scr@Desc@let\FontElement \scr@Desc@let\FloatStyle + \scr@Desc@let\DoHook % Todo: Replace the following by the correct definitions: \let\XMacro\textMacro \let\XEnvironment\textEnvironment @@ -1881,7 +1920,17 @@ basicstyle=\ttfamily,% columns=fullflexible,keepspaces,% aboveskip=.4\baselineskip,% - belowskip=\dp\strutbox plus 1pt minus .5pt% + belowskip=\dp\strutbox plus 1pt minus .5pt,% + literate=% + {Ö}{{\"O}}1 + {Ä}{{\"A}}1 + {Ãœ}{{\"U}}1 + {ß}{{\ss}}1 + {ü}{{\"u}}1 + {ä}{{\"a}}1 + {ö}{{\"o}}1 + {»}{{\guillemetright}}1 + {«}{{\guillemetleft}}1 }% \lstdefinestyle{code}{% language=[LaTeX]TeX,% @@ -1920,10 +1969,12 @@ addtokomafont,addtolengthplength,addtoreffields,addtotoclist, adrchar,adrentry, AddLayersAtBeginOfPageStyle,AddLayersToPageStyle, + AddtoDoHook,AddtoOneTimeDoHook, AfterBibliographyPreamble,AfterCalculatingTypearea, AfterFile,AfterPackage,AfterStartingTOC,AfterTOCHead, appendixmore,appendixname,areaset,autodot,automark,AtAddToTocList, - AtBeginLetter, + AtBeginLetter,At@startsection, + Before@sect,Before@ssect, BeforeFamilyProcessOptions, BeforeClosingMainAux,BeforePackage,bib@beginhook,bib@endhook, blinddocument,blindtext,Blinddocument,Blindtext, @@ -1952,14 +2003,14 @@ DestroyLayer,defpagestyle,deftripstyle, dictum,dictumauthorformat,dictumrule,dictumwidth,doforeachtocfile, ellipsispar, - encl,extratitle,FamilyBoolKey,FamilyExecuteOptions, + encl,ExecuteDoHook,extratitle,FamilyBoolKey,FamilyExecuteOptions, FamilyKeyState,FamilyKeyStateUnknown,FamilyKeyStateProcessed, FamilyKeyStateUnknownValue,FamilyKeyStateNeedValue, FamilyNumericalKey,% FamilyOption,FamilyOptions,FamilyProcessOptions,FamilySetBool, FamilyStringKey,FamilyUnknownKeyValue, figureformat,figurename,firstfoot,firsthead,FirstName,footfont,footref, - ForEachLayerOfPageStyle, + ForDoHook,ForEachLayerOfPageStyle, FreeI,FreeII,FreeIII,FreeIV, GenericMarkFormat, headfont,headmark, @@ -2008,6 +2059,7 @@ setheadsepline,setheadtopline,setheadwidth,setindexpreamble,setkomafont, setkomavar,setlengthtoplength,setparsizes,setpartpreamble,setuptoc, showfields,showenvelope,showISOenvelope,showUScommercial,showUScheck, + SplitDoHook, storeareas,StorePreventPackageFromLoading, subject,SubClause,subsectionmarkformat,subtitle,syncwithnotecolumn, tableformat,tablename,tableofcontents,textsubscript,thechapter,thefigure, @@ -2331,6 +2383,9 @@ KOMAScript \endcsname \printmultiindex[% \CrossIndex{\GuideOption}{gen}{\GuideoptIndexShort}% ]{\GuideoptIndex}{opt}% + \printmultiindex[% + \CrossIndex{\GuideHook}{gen}{\GuidehokIndexShort}% + ]{\GuidehokIndex}{hok} } \fi % \end{macrocode} @@ -2617,7 +2672,7 @@ KOMAScript \endcsname % Now we have to define different kinds of index entries. We have entries that % will be added to only one index. We have entries that will be added to one % index with reference to that index at another index. And there are even -% entries that will be added to one index with reference to to that index from +% entries that will be added to one index with reference to that index from % another index and from the main index. % \begin{macro}{\DefineSingeIndex} % This defines a single index entry, e.g. of commands. A macro will be @@ -2732,6 +2787,7 @@ KOMAScript \endcsname \DefineSingleIndex[\GuideVariable]{Variable}{cmd}{\Variable} \DefineSingleIndex{FontElement}{elm}{\FontElement} \DefineSingleIndex{PLength}{len}{\PLength} + \DefineSingleIndex{DoHook}{hok}{\DoHook} \else \DefineDoubleIndex[\GuideEnvironment]{Env}{cmd}{\Environment} \DefineDoubleIndex{Option}{opt}{\Option} @@ -2741,6 +2797,7 @@ KOMAScript \endcsname \DefineDoubleIndex[\GuideVariable]{Variable}{cmd}{\Variable} \DefineDoubleIndex{FontElement}{elm}{\FontElement} \DefineDoubleIndex{PLength}{len}{\PLength} + \DefineDoubleIndex{DoHook}{hok}{\DoHook} \fi % \end{macrocode} % diff --git a/macros/latex/contrib/koma-script/source-doc/scrpage2.tex b/macros/latex/contrib/koma-script/source-doc/scrpage2.tex index ce59a85ff3..fe7c62a504 100644 --- a/macros/latex/contrib/koma-script/source-doc/scrpage2.tex +++ b/macros/latex/contrib/koma-script/source-doc/scrpage2.tex @@ -40,7 +40,7 @@ % % ---------------------------------------------------------------------- % -% Kapitel über scrpage2 +% Kapitel über scrpage2 % Verwaltet von Markus Kohm % % ============================================================================ @@ -1558,39 +1558,39 @@ styles which many projects can share. \addparttocentry{}{Deutsch} \title{Das obsolete Paket \Package{scrpage2}} -\subtitle{Auszug aus früheren Versionen der \KOMAScript-Anleitung} +\subtitle{Auszug aus früheren Versionen der \KOMAScript-Anleitung} \author{Markus Kohm\and Jens-Uwe-Morawski} \date{2014-06-25} \maketitle -\chapter{Kopf- und Fußzeilen mit \Package{scrpage2}} +\chapter{Kopf- und Fußzeilen mit \Package{scrpage2}} \labelbase{scrpage-de} % \BeginIndexGroup \BeginIndex{Package}{scrpage2}% \BeginIndex{}{Seitenstil} Mit \KOMAScript~3.12 wurde das komplett neu implementierte Paket -\Package{scrlayer-scrpage} vorgestellt, das eine konsequente Weiterführung des +\Package{scrlayer-scrpage} vorgestellt, das eine konsequente Weiterführung des Designs von \Package{scrpage2} mit anderen Mitteln darstellt. Siehe dazu das -entsprechende Kapitel der \KOMAScript-Anleitung. Während +entsprechende Kapitel der \KOMAScript-Anleitung. 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 +\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. +\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} oder \Package{scrlayer-scrpage} kann - natürlich auch \Package{fancyhdr} verwendet + natürlich auch \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 + 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. @@ -1601,28 +1601,28 @@ Entwicklungsresourcen im Bereich Kopf- und Fußzeilen werden zukünftig in \begin{Explain} Um die nachfolgende Beschreibung zu verstehen, muss noch einiges zu \LaTeX{} gesagt werden. Im \LaTeX-Kern sind die Standardseitenstile - \PageStyle{empty}, welcher eine völlig undekorierte Seite erzeugt, und - \PageStyle{plain}, welcher meist nur die Seitenzahl enthält, definiert. In + \PageStyle{empty}, welcher eine völlig undekorierte Seite erzeugt, und + \PageStyle{plain}, welcher meist nur die Seitenzahl enthält, definiert. In vielen Klassen ist der Stil \PageStyle{headings} zu finden, welcher eine komplexe Seitendekoration mit automatischen Kolumnentitel\Index{Kolumnentitel>automatisch} erzeugt. Die Variante \PageStyle{myheadings} gleicht \PageStyle{headings}. Die Kolumnentitel - müssen dabei aber manuell\Index{Kolumnentitel>manuell} gesetzt werden. - Ausführlicher wird das im Abschnitt über Seitenstile der - \KOMAScript-Anleitung beschrieben. Dort wird auch erläutert, dass auf + müssen dabei aber manuell\Index{Kolumnentitel>manuell} gesetzt werden. + Ausführlicher wird das im Abschnitt über Seitenstile der + \KOMAScript-Anleitung beschrieben. Dort wird auch erläutert, dass auf einigen Seiten der Seitenstil automatisch -- in der Regel zu \PageStyle{plain} -- wechselt. \end{Explain} Das Paket \Package{scrpage2} unterscheidet nicht mehr zwischen Seitenstilen mit automatischem und mit manuellem Kolumnentitel. Die Wahl des Seitenstils -erfolgt unabhängig davon, ob mit automatischem oder manuellem Kolumnentitel -gearbeitet wird. Näheres dazu finden Sie in \autoref{sec:scrpage-de.basics.mark}. +erfolgt unabhängig davon, ob mit automatischem oder manuellem Kolumnentitel +gearbeitet wird. Näheres dazu finden Sie in \autoref{sec:scrpage-de.basics.mark}. \subsection{Vordefinierte Seitenstile}\label{sec:scrpage-de.basics.buildIn} -Zu den grundlegenden Funktionen von \Package{scrpage2} gehören unter anderem +Zu den grundlegenden Funktionen von \Package{scrpage2} gehören unter anderem vordefinierte, konfigurierbare Seitenstile. % \lehead ... @@ -1633,15 +1633,15 @@ vordefinierte, konfigurierbare Seitenstile. \PageStyle{scrheadings}% \PageStyle{scrplain} \end{Declaration}% -Das Paket \Package{scrpage2} liefert für Seiten mit Kolumnentitel einen +Das Paket \Package{scrpage2} liefert für Seiten mit Kolumnentitel einen eigenen Seitenstil namens \PageStyle{scrheadings}. Dieser Seitenstil kann mittels \Macro{pagestyle}\PParameter{scrheadings} aktiviert werden. Wird dieser Seitenstil benutzt, dann wird gleichzeitig der plain-Stil durch den dazu passenden Stil \PageStyle{scrplain} ersetzt. Passend bedeutet, dass auch der plain-Stil auf in \autoref{sec:scrpage-de.basics.format} vorgestellte -Befehle, die beispielsweise die Kopfbreite ändern, reagiert und im Grundlayout -übereinstimmt. Die Aktivierung des Seitenstils \PageStyle{scrheadings} oder -des zugehörigen plain-Stils, \PageStyle{scrplain}, hat keine Auswirkung +Befehle, die beispielsweise die Kopfbreite ändern, reagiert und im Grundlayout +übereinstimmt. Die Aktivierung des Seitenstils \PageStyle{scrheadings} oder +des zugehörigen plain-Stils, \PageStyle{scrplain}, hat keine Auswirkung darauf, ob mit manuellen oder automatischen Kolumnentiteln\Index{Kolumnentitel>automatisch}\Index{Kolumnentitel>manuell} gearbeitet wird (siehe \autoref{sec:scrpage-de.basics.mark}). Der Seitenstil @@ -1678,16 +1678,16 @@ gearbeitet wird (siehe \autoref{sec:scrpage-de.basics.mark}). Der Seitenstil \Macro{chead}% \OParameter{scrplain-zentriert}\Parameter{scrheadings-zentriert}% \Macro{ohead}% - \OParameter{scrplain-außen}\Parameter{scrheadings-außen}% + \OParameter{scrplain-außen}\Parameter{scrheadings-außen}% \Macro{ifoot}% \OParameter{scrplain-innen}\Parameter{scrheadings-innen}% \Macro{cfoot}% \OParameter{scrplain-zentriert}\Parameter{scrheadings-zentriert}% \Macro{ofoot}% - \OParameter{scrplain-außen}\Parameter{scrheadings-außen} + \OParameter{scrplain-außen}\Parameter{scrheadings-außen} \end{Declaration}% Die Seitenstile von \Package{scrpage2} sind so definiert, dass ihr Kopf und -Fuß flexibel angepasst werden kann. Hierzu sind sowohl im Kopf als auch im Fuß +Fuß flexibel angepasst werden kann. Hierzu sind sowohl im Kopf als auch im Fuß drei Felder vorhanden, deren Inhalt modifiziert werden kann. Die Befehle zur Modifikation sind in \autoref{fig:scrpage-de.leheadetall} verdeutlicht. Die in der Mitte dargestellten Befehle modifizieren sowohl die Felder der linken @@ -1705,7 +1705,7 @@ Feld im Seitenstil \PageStyle{scrheadings}. {\hspace{0pt plus 1ex}% Zuord\-nung der Befehle zur Manipulation der beiden Seiten\-stile \PageStyle{scrheadings} und \PageStyle{scrplain} zu den Feldern im - Kopf und Fuß der Seiten} + Kopf und Fuß der Seiten} [l] \setlength{\unitlength}{.95mm}\begin{picture}(100,65)(0,8)\small \put(0,12){\dashbox{2}(40,56){linke Seite}} @@ -1727,7 +1727,7 @@ Feld im Seitenstil \PageStyle{scrheadings}. \put(76,13){\framebox(8,4){~}} \put(91,13){\framebox(8,4){~}} % die Befehle und Pfeile - % für beidseitig + % für beidseitig % \put(50,65){\makebox(0,0){\DescRef{scrpage-de.cmd.ihead}}} \put(44,65){\vector(-1,0){4}}\put(56,65){\vector(1,0){4}} @@ -1746,7 +1746,7 @@ Feld im Seitenstil \PageStyle{scrheadings}. \put(50,29){\makebox(0,0){\DescRef{scrpage-de.cmd.ofoot}}} \put(44,29){\line(-1,0){40}}\put(56,29){\line(1,0){40}} \put(4,29){\vector(0,-1){11}}\put(96,29){\vector(0,-1){11}} - % Befehle für einseitig + % Befehle für einseitig \put(5,69){\makebox(0,0)[b]{\DescRef{scrpage-de.cmd.lehead}}} \put(20,69){\makebox(0,0)[b]{\DescRef{scrpage-de.cmd.cehead}}} \put(35,69){\makebox(0,0)[b]{\DescRef{scrpage-de.cmd.rehead}}} @@ -1772,56 +1772,56 @@ Feld im Seitenstil \PageStyle{scrheadings}. \end{figure} \begin{Example} - Angenommen, man möchte bei \PageStyle{scrheadings} zentriert im Seitenfuß + Angenommen, man möchte bei \PageStyle{scrheadings} zentriert im Seitenfuß die Seitenzahl dargestellt haben, dann benutzt man einfach: \begin{lstcode} \cfoot{\pagemark} \end{lstcode} - Sollen die Seitenzahlen\Index{Paginierung} im Kopf außen und die + Sollen die Seitenzahlen\Index{Paginierung} im Kopf außen und die Kolumnentitel\Index{Kolumnentitel} innen stehen, dann erfolgt dies mit: \begin{lstcode} \ohead{\pagemark} \ihead{\headmark} \cfoot{} \end{lstcode} - Das \Macro{cfoot}\PParameter{} ist nur notwendig, um eine möglicherweise in - der Mitte des Fußes vorhandene Seitenzahl zu entfernen. + Das \Macro{cfoot}\PParameter{} ist nur notwendig, um eine möglicherweise in + der Mitte des Fußes vorhandene Seitenzahl zu entfernen. \end{Example} -Die Befehle, die direkt nur einem Feld zugeordnet sind, können für +Die Befehle, die direkt nur einem Feld zugeordnet sind, können für anspruchsvollere Vorhaben genutzt werden. \begin{Example} Angenommen, man hat den Auf"|trag, einen Jahresbericht einer Firma zu - erstellen, dann könnte das so angegangen werden: + erstellen, dann könnte das so angegangen werden: \begin{lstcode} \ohead{\pagemark} \rehead{Jahresbericht 2001} \lohead{\headmark} - \cefoot{Firma WasWeißIch} + \cefoot{Firma WasWeißIch} \cofoot{Abteilung Entwicklung} \end{lstcode} - Natürlich muss man hier dafür sorgen, dass mittels \Macro{cofoot} der Fuß + Natürlich muss man hier dafür sorgen, dass mittels \Macro{cofoot} der Fuß der rechten Seite aktualisiert wird, wenn eine neue Abteilung im Bericht besprochen wird. \end{Example} Wie oben dargestellt, gibt es einen zu \PageStyle{scrheadings} -korrespondierenden plain-Seitenstil. Da es auch möglich sein soll, diesen -Stil anzupassen, unterstüt"-zen die Befehle ein optionales Argument. Damit +korrespondierenden plain-Seitenstil. Da es auch möglich sein soll, diesen +Stil anzupassen, unterstüt"-zen die Befehle ein optionales Argument. Damit kann der Inhalt des entsprechenden Feldes im plain-Seitenstil modifiziert werden. \begin{Example} - Um für die Nutzung von \PageStyle{scrheadings} die Position der Seitenzahlen + Um für die Nutzung von \PageStyle{scrheadings} die Position der Seitenzahlen festzulegen, kann man folgendes benutzen: \begin{lstcode} \cfoot[\pagemark]{} \ohead[]{\pagemark} \end{lstcode} - Wird anschließend der Stil \PageStyle{plain} genutzt, beispielsweise weil + Wird anschließend der Stil \PageStyle{plain} genutzt, beispielsweise weil \Macro{chapter} eine neue Seite beginnt und darauf umschaltet, dann steht - die Seitenzahl zentriert im Seitenfuß. + die Seitenzahl zentriert im Seitenfuß. \end{Example} % \EndIndexGroup @@ -1835,28 +1835,28 @@ werden. \Macro{clearscrheadfoot} \end{Declaration}% Will man sowohl den Seitenstil \PageStyle{scrheadings} als auch den dazu -gehörenden plain-Seitenstil von Grund auf neu definieren, -muss man häufig zusätzlich einige der bereits belegten Seitenelemente -löschen. Da man selten alle Elemente mit neuem Inhalt füllt, sind -dazu in den meisten Fällen mehrere Befehle mit leeren Parametern +gehörenden plain-Seitenstil von Grund auf neu definieren, +muss man häufig zusätzlich einige der bereits belegten Seitenelemente +löschen. Da man selten alle Elemente mit neuem Inhalt füllt, sind +dazu in den meisten Fällen mehrere Befehle mit leeren Parametern notwendig. -Mit Hilfe dieser drei Befehle ist das Löschen schnell und -gründlich möglich. Während \Macro{clearscrheadings} lediglich alle +Mit Hilfe dieser drei Befehle ist das Löschen schnell und +gründlich möglich. Während \Macro{clearscrheadings} lediglich alle Felder des Seitenstils \PageStyle{scrheadings} und \Macro{clearscrplain} -alle Felder des zugehörigen plain-Seitenstils löscht, werden +alle Felder des zugehörigen plain-Seitenstils löscht, werden von \Macro{clearscrheadfoot} alle Felder beider Seitenstile auf leere Inhalte gesetzt. \begin{Example} - Sie wollen unabhängig davon, wie die Seitenstile derzeit aussehen, + Sie wollen unabhängig davon, wie die Seitenstile derzeit aussehen, die Standardform der \KOMAScript-Klassen bei zweiseitigem Satz - erreichen. Dies ist mit nur drei Befehlen möglich: + erreichen. Dies ist mit nur drei Befehlen möglich: \begin{lstcode} \clearscrheadfoot \ohead{\headmark} \ofoot[\pagemark]{\pagemark} \end{lstcode} Ohne die Befehle \Macro{clearscrheadings}, \Macro{clearscrplain} und - \Macro{clearscrheadfoot} wären doppelt so viele Anweisungen und neun weitere + \Macro{clearscrheadfoot} wären doppelt so viele Anweisungen und neun weitere leere Argumente notwendig: \begin{lstcode} \ihead[]{} @@ -1866,7 +1866,7 @@ Inhalte gesetzt. \cfoot[]{} \ofoot[\pagemark]{\pagemark} \end{lstcode} - Einige davon könnten natürlich entfallen, wenn man von einer + Einige davon könnten natürlich entfallen, wenn man von einer konkreten Vorbelegung ausginge. \end{Example} % @@ -1886,9 +1886,9 @@ gar nicht besprochen wurden. Das soll jetzt nachgeholt werden. \Macro{rightmark} \end{Declaration}% Diese beiden Befehle erlauben es, auf die Kolumnentitel zuzugreifen, die -normalerweise für die linke bzw. die rechte Seite gedacht sind. Diese beiden +normalerweise für die linke bzw. die rechte Seite gedacht sind. Diese beiden Befehle werden nicht von \Package{scrpage2}, sondern direkt vom \LaTeX-Kern -zur Verfügung gestellt. Wenn in diesem Kapitel vom Kolumnentitel der linken +zur Verfügung gestellt. Wenn in diesem Kapitel vom Kolumnentitel der linken Seite oder vom Kolumnentitel der rechten Seite die Rede ist, dann ist damit eigentlich der Inhalt von \Macro{leftmark} und \Macro{rightmark} gemeint. % @@ -1898,7 +1898,7 @@ eigentlich der Inhalt von \Macro{leftmark} und \Macro{rightmark} gemeint. \begin{Declaration} \Macro{headmark} \end{Declaration}% -Dieser Befehl ermöglicht es, auf die Inhalte der Kolumnentitel zuzugreifen. +Dieser Befehl ermöglicht es, auf die Inhalte der Kolumnentitel zuzugreifen. Im Gegensatz zu den originalen \LaTeX{}-Befehlen \Macro{leftmark} und \Macro{rightmark} braucht man nicht auf die richtige Zuordnung zur linken oder rechten Seite zu achten.% @@ -1909,10 +1909,10 @@ rechten Seite zu achten.% \begin{Declaration} \Macro{pagemark} \end{Declaration}% -Dieser Befehl ermöglicht den Zugriff auf die Seitenzahl. Im +Dieser Befehl ermöglicht den Zugriff auf die Seitenzahl. Im \autoref{sec:scrpage-de.basics.format}, \DescPageRef{scrpage-de.cmd.pnumfont} wird der Befehl \DescRef{scrpage-de.cmd.pnumfont} zur Formatierung der Seitenzahl vorgestellt, -den \Macro{pagemark} automatisch berücksichtigt.% +den \Macro{pagemark} automatisch berücksichtigt.% % \EndIndexGroup @@ -1920,11 +1920,11 @@ den \Macro{pagemark} automatisch berücksichtigt.% \begin{Declaration} \PageStyle{useheadings} \end{Declaration}% -Das Paket \Package{scrpage2} ist in erster Linie dafür gedacht, dass die +Das Paket \Package{scrpage2} ist in erster Linie dafür gedacht, dass die bereitgestellten Stile benutzt oder eigene Stile definiert werden. Jedoch -kann es notwendig sein, auch auf einen von der Dokumentklasse zur Verfügung -gestellten Stil zurückzuschalten. Es wäre nahe liegend, dieses mit -\Macro{pagestyle}\PParameter{headings} vorzunehmen. Das hätte aber den +kann es notwendig sein, auch auf einen von der Dokumentklasse zur Verfügung +gestellten Stil zurückzuschalten. Es wäre nahe liegend, dieses mit +\Macro{pagestyle}\PParameter{headings} vorzunehmen. Das hätte aber den Nachteil, dass die nachfolgend besprochenen Befehle \DescRef{scrpage-de.cmd.automark} und \DescRef{scrpage-de.cmd.manualmark} nicht wie erwartet funktionierten. Daher sollte mit \Macro{pagestyle}\PParameter{useheadings}\IndexCmd{pagestyle} auf die @@ -1942,12 +1942,12 @@ gearbeitet wird.% \BeginIndexGroup \BeginIndex{}{Kolumnentitel>automatisch}% \BeginIndex{}{Kolumnentitel>manuell}% -Gewöhnlich\textnote{Achtung!} gibt es zu einem \PageStyle{headings}-Stil eine +Gewöhnlich\textnote{Achtung!} gibt es zu einem \PageStyle{headings}-Stil eine \emph{my}-Variante. Ist ein solcher Stil aktiv, dann werden die Kolumnentitel nicht mehr automatisch aktualisiert. Bei \Package{scrpage2} wird ein anderer Weg beschritten. Ob die Kolumnentitel lebend sind oder nicht, bestimmen die Befehle \DescRef{scrpage-de.cmd.automark} und \DescRef{scrpage-de.cmd.manualmark}. Die Voreinstellung kann auch -bereits beim Laden des Paketes über die Optionen \DescRef{scrpage-de.option.automark} und +bereits beim Laden des Paketes über die Optionen \DescRef{scrpage-de.option.automark} und \DescRef{scrpage-de.option.manualmark} beeinflusst werden (siehe \autoref{sec:scrpage-de.basics.options}, \DescPageRef{scrpage-de.option.automark}). @@ -1957,12 +1957,12 @@ bereits beim Laden des Paketes über die Optionen \DescRef{scrpage-de.option.auto \Macro{manualmark} \end{Declaration}% Wie der Name bereits verdeutlicht, schaltet \Macro{manualmark} die -Aktualisierung der Kolumnentitel aus. Es bleibt somit dem Nutzer überlassen, -für eine Aktualisierung bzw. für den Inhalt der Kolumnentitel zu sorgen. Dazu +Aktualisierung der Kolumnentitel aus. Es bleibt somit dem Nutzer überlassen, +für eine Aktualisierung bzw. für den Inhalt der Kolumnentitel zu sorgen. Dazu stehen die Befehle \Macro{markboth}\IndexCmd{markboth} und \Macro{markright}\IndexCmd{markright} aus dem \LaTeX-Kern bereit. Diese -Anweisungen sind im Abschnitt über Seitenstile in der \KOMAScript-Anleitung -erklärt.% +Anweisungen sind im Abschnitt über Seitenstile in der \KOMAScript-Anleitung +erklärt.% % \EndIndexGroup @@ -1972,24 +1972,24 @@ erklärt.% \Macro{automark}\OParameter{rechte Seite}\Parameter{linke Seite} \end{Declaration}% Die Anweisung \Macro{automark} aktiviert die automatische Aktualisierung des -Kolumnentitels. Für die beiden Parameter sind die Bezeichnungen der +Kolumnentitels. Für die beiden Parameter sind die Bezeichnungen der Gliederungsebenen\Index{Gliederungsebenen} einzusetzen, deren Titel an -entsprechender Stelle erscheinen soll. Gültige Werte für die Parameter sind: +entsprechender Stelle erscheinen soll. Gültige Werte für die Parameter sind: \PValue{part}\ChangedAt{v2.2}{\Package{scrpage2}}, \PValue{chapter}, \PValue{section}, \PValue{subsection}, \PValue{subsubsection}, -\PValue{paragraph} und \PValue{subparagraph}. Der Wert \PValue{part} führt bei -Verwendung der meisten Klassen nicht zu dem gewünschten Ergebnis. Bisher ist +\PValue{paragraph} und \PValue{subparagraph}. Der Wert \PValue{part} führt bei +Verwendung der meisten Klassen nicht zu dem gewünschten Ergebnis. Bisher ist nur von den \KOMAScript-Klassen ab Version~2.9s bekannt, dass dieser Wert -unterstützt wird. Das optionale Argument \PName{rechte Seite} ist -ver\-ständlicherweise nur für zweiseitigen Satz gedacht. Im einseitigen Satz +unterstützt wird. Das optionale Argument \PName{rechte Seite} ist +ver\-ständlicherweise nur für zweiseitigen Satz gedacht. Im einseitigen Satz sollten Sie normalerweise darauf verzichten. Mit Hilfe der Option \DescRef{scrpage-de.option.autooneside}\IndexOption{autooneside}\important{\DescRef{scrpage-de.option.autooneside}} -können Sie auch einstellen, dass das optionale Argument im +können Sie auch einstellen, dass das optionale Argument im einseitigen\Index{einseitig} Satz automatisch ignoriert wird (siehe \autoref{sec:scrpage-de.basics.options}, \DescPageRef{scrpage-de.option.autooneside}). \begin{Example} - Wird beispielsweise mit einer \emph{book}-Klasse gearbeitet, deren höch\-ste + Wird beispielsweise mit einer \emph{book}-Klasse gearbeitet, deren höch\-ste Gliederungsebene \emph{chapter} ist, dann stellt nach einem vorhergehenden \DescRef{scrpage-de.cmd.manualmark} der Befehl \begin{lstcode} @@ -2003,11 +2003,11 @@ einseitigen\Index{einseitig} Satz automatisch ignoriert wird (siehe \end{Example} \begin{Explain} - Die Markierung der jeweils höheren Gliederungsebene wird mit Hilfe von + Die Markierung der jeweils höheren Gliederungsebene wird mit Hilfe von \Macro{markboth}\IndexCmd{markboth} gesetzt. Die Markierung der tieferen Gliederungsebene wird mit \Macro{markright}\IndexCmd{markright} bzw. \Macro{markleft}\IndexCmd{markleft} gesetzt. Der entsprechende Aufruf - erfolgt indirekt über die Gliederungsbefehle. Die Anweisung \Macro{markleft} + erfolgt indirekt über die Gliederungsbefehle. Die Anweisung \Macro{markleft} wird von \Package{scrpage2} bereitgestellt und ist vergleichbar zu \Macro{markright} aus dem \LaTeX-Kern definiert. Obwohl sie nicht als internes Makro definiert ist, wird von einem @@ -2017,14 +2017,14 @@ einseitigen\Index{einseitig} Satz automatisch ignoriert wird (siehe \EndIndexGroup -\subsection{Formatierung der Kopf- und Fußzeilen} +\subsection{Formatierung der Kopf- und Fußzeilen} \label{sec:scrpage-de.basics.format} % \headfont \pnumfont % \setheadwidth \setfootwidth % \set(head|foot)(top|sep|bot)line -Im vorherigen Abschnitt ging es hauptsächlich um inhaltliche Dinge. Das -genügt natürlich nicht, um die gestalterischen Ambitionen zu -befriedigen. Deshalb soll es sich in diesem Abschnitt ausschließlich darum +Im vorherigen Abschnitt ging es hauptsächlich um inhaltliche Dinge. Das +genügt natürlich nicht, um die gestalterischen Ambitionen zu +befriedigen. Deshalb soll es sich in diesem Abschnitt ausschließlich darum drehen. \begin{Declaration} @@ -2032,11 +2032,11 @@ drehen. \Macro{footfont}% \Macro{pnumfont} \end{Declaration}% -Die Schriftformatierung für den Seitenkopf und -fuß übernimmt der Befehl -\Macro{headfont}, \Macro{footfont} die Abweichung davon für den Fuß und -\Macro{pnumfont} wiederum die Abweichung davon für die Seitenzahl. +Die Schriftformatierung für den Seitenkopf und -fuß übernimmt der Befehl +\Macro{headfont}, \Macro{footfont} die Abweichung davon für den Fuß und +\Macro{pnumfont} wiederum die Abweichung davon für die Seitenzahl. \begin{Example} - Um beispielsweise den Kopf in fetter, serifenloser Schrift und den Fuß in + Um beispielsweise den Kopf in fetter, serifenloser Schrift und den Fuß in nicht fetter, serifenloser Schrift zu setzen und die Seitenzahl geneigt mit Serifen erscheinen zu lassen, nutzt man folgende Definitionen: \begin{lstcode} @@ -2053,7 +2053,7 @@ Die Schriftformatierung für den Seitenkopf und -fuß übernimmt der Befehl \BeginIndex{FontElement}{pagehead}% \BeginIndex{FontElement}{pagefoot}% \BeginIndex{FontElement}{pagenumber}% -Ab Version 2.8p der \KOMAScript{}-Klassen wurde die Schnittstelle für +Ab Version 2.8p der \KOMAScript{}-Klassen wurde die Schnittstelle für Schriftattribute vereinheitlicht. Wird \Package{scrpage2} in Verbindung mit einer dieser Klassen verwendet, dann sollte die Zuweisung in der Art erfolgen, wie sie in der \KOMAScript-Anleitung beschrieben wird. @@ -2078,15 +2078,15 @@ wie sie in der \KOMAScript-Anleitung beschrieben wird. \Macro{setheadwidth}\OParameter{Verschiebung}\Parameter{Breite}% \Macro{setfootwidth}\OParameter{Verschiebung}\Parameter{Breite} \end{Declaration}% -Normalerweise entsprechen die Breiten von Kopf- und Fußzeile der Breite des -Textbereichs.\Index{Kopf>Breite}\Index{Fuss=Fuß>Breite} Die beiden Befehle -\Macro{setheadwidth} und \Macro{setfootwidth} ermöglichen dem Anwender, auf -einfache Weise die Breiten seinen Bedürfnissen anzupassen. Das obligatorische -Argument \PName{Breite} nimmt den Wert der Breite des Kopfes bzw. des Fußes -auf, \PName{Verschiebung} ist ein Längenmaß für die Verschiebung des -entsprechenden Elements in Richtung des äußeren Seitenrandes. - -Für die möglichen Standardfälle akzeptiert das obligatorische Argument +Normalerweise entsprechen die Breiten von Kopf- und Fußzeile der Breite des +Textbereichs.\Index{Kopf>Breite}\Index{Fuss=Fuß>Breite} Die beiden Befehle +\Macro{setheadwidth} und \Macro{setfootwidth} ermöglichen dem Anwender, auf +einfache Weise die Breiten seinen Bedürfnissen anzupassen. Das obligatorische +Argument \PName{Breite} nimmt den Wert der Breite des Kopfes bzw. des Fußes +auf, \PName{Verschiebung} ist ein Längenmaß für die Verschiebung des +entsprechenden Elements in Richtung des äußeren Seitenrandes. + +Für die möglichen Standardfälle akzeptiert das obligatorische Argument \PName{Breite} auch folgende symbolische Werte: \begin{labeling}[\ --]{\PValue{textwithmarginpar}} \item[\PValue{paper}] die Breite des Papiers @@ -2095,24 +2095,24 @@ Für die möglichen Standardfälle akzeptiert das obligatorische Argument \item[\PValue{textwithmarginpar}] die Breite des Textbereichs inklusive Seitenrand \item[\PValue{head}] die aktuelle Breite des Seitenkopfes -\item[\PValue{foot}] die aktuelle Breite des Seitenfußes +\item[\PValue{foot}] die aktuelle Breite des Seitenfußes \end{labeling} Der Unterschied zwischen \PValue{paper} und \PValue{page} besteht darin, dass -\PValue{page} die Breite des Papiers abzüglich der Bindekorrektur ist, falls +\PValue{page} die Breite des Papiers abzüglich der Bindekorrektur ist, falls das \Package{typearea}-Paket\IndexPackage{typearea} verwendet wird (siehe das -Kapitel über \Package{typearea} in der \KOMAScript-Anleitung). Ohne Verwendung +Kapitel über \Package{typearea} in der \KOMAScript-Anleitung). Ohne Verwendung von \Package{typearea} sind \PValue{paper} und \PValue{page} identisch.%mjk-2001-08-17 \begin{Example} - Angenommen, man möchte ein Seitenlayout wie im + Angenommen, man möchte ein Seitenlayout wie im \emph{\LaTeX-Begleiter}, bei dem die Kopfzeile in den Rand ragt, dann geschieht das ganz einfach mit: \begin{lstcode} \setheadwidth[0pt]{textwithmarginpar} \end{lstcode} % - und sieht dann auf einer rechten Seite folgendermaßen aus: + und sieht dann auf einer rechten Seite folgendermaßen aus: % \begin{XmpTopPage} \XmpHeading{10,29}{85} @@ -2121,23 +2121,23 @@ identisch.%mjk-2001-08-17 \XmpMarginNote{83,14} \end{XmpTopPage} % - Soll der Seitenfuß die gleiche Breite und Ausrichtung haben, dann hat man - jetzt zwei Wege. Der erste ist, man wiederholt das Gleiche für den - Seitenfuß mit: + Soll der Seitenfuß die gleiche Breite und Ausrichtung haben, dann hat man + jetzt zwei Wege. Der erste ist, man wiederholt das Gleiche für den + Seitenfuß mit: \begin{lstcode} \setfootwidth[0pt]{textwithmarginpar} \end{lstcode} % - oder man greift auf den anderen symbolischen Wert \PValue{head} zurück, da - der Kopf bereits die gewünschte Breite hat. + oder man greift auf den anderen symbolischen Wert \PValue{head} zurück, da + der Kopf bereits die gewünschte Breite hat. \begin{lstcode} \setfootwidth[0pt]{head} \end{lstcode} \end{Example} -Wird keine Verschiebung angegeben, das heißt auf das optionale Argument -verzichtet, dann erscheint der Kopf bzw. der Fuß symmetrisch auf der Seite -angeordnet. Es wird somit ein Wert für die Verschiebung automatisch ermittelt, +Wird keine Verschiebung angegeben, das heißt auf das optionale Argument +verzichtet, dann erscheint der Kopf bzw. der Fuß symmetrisch auf der Seite +angeordnet. Es wird somit ein Wert für die Verschiebung automatisch ermittelt, der der aktuellen Seitengestalt entspricht. \begin{Example} @@ -2147,7 +2147,7 @@ der der aktuellen Seitengestalt entspricht. \setheadwidth{textwithmarginpar} \end{lstcode} % - und sieht dann auf einer rechten Seite folgendermaßen aus: + und sieht dann auf einer rechten Seite folgendermaßen aus: % \begin{XmpTopPage} \XmpHeading{5,29}{85} @@ -2158,58 +2158,58 @@ der der aktuellen Seitengestalt entspricht. \end{Example} Wie zu sehen, ist der Kopf jetzt nach innen verschoben, wobei die Kopfbreite -sich nicht geändert hat. Die Verschiebung ist so berechnet, dass die +sich nicht geändert hat. Die Verschiebung ist so berechnet, dass die Seitenproportionen auch hier sichtbar werden. \EndIndexGroup \begin{Declaration} - \Macro{setheadtopline}\OParameter{Länge}\Parameter{Dicke}% + \Macro{setheadtopline}\OParameter{Länge}\Parameter{Dicke}% \OParameter{Anweisungen}% - \Macro{setheadsepline}\OParameter{Länge}\Parameter{Dicke}% + \Macro{setheadsepline}\OParameter{Länge}\Parameter{Dicke}% \OParameter{Anweisungen}% - \Macro{setfootsepline}\OParameter{Länge}\Parameter{Dicke}% + \Macro{setfootsepline}\OParameter{Länge}\Parameter{Dicke}% \OParameter{Anweisungen}% - \Macro{setfootbotline}\OParameter{Länge}\Parameter{Dicke}% + \Macro{setfootbotline}\OParameter{Länge}\Parameter{Dicke}% \OParameter{Anweisungen} \end{Declaration}% -Entsprechend den Größenparametern für die Kopf- und Fußzeile gibt es auch -Befehle, die die Dimensionen der Linien im Kopf und Fuß modifizieren -können. Dazu sollten diese Linien aber zunächst erst einmal eingeschaltet +Entsprechend den Größenparametern für die Kopf- und Fußzeile gibt es auch +Befehle, die die Dimensionen der Linien im Kopf und Fuß modifizieren +können. Dazu sollten diese Linien aber zunächst erst einmal eingeschaltet werden. Siehe hierzu die Optionen \DescRef{scrpage-de.option.headtopline}, \DescRef{scrpage-de.option.headsepline}, \DescRef{scrpage-de.option.footsepline}, \DescRef{scrpage-de.option.footbotline} in \autoref{sec:scrpage-de.basics.options}, \DescPageRef{scrpage-de.option.headsepline}. \begin{labeling}[\ --]{\Macro{setfootsepline}} -\item[\Macro{setheadtopline}] modifiziert die Parameter für die Linie -über dem Seitenkopf -\item[\Macro{setheadsepline}] modifiziert die Parameter für die Linie -zwischen Kopf und Textkörper -\item[\Macro{setfootsepline}] modifiziert die Parameter für die Linie -zwischen Text und Fuß -\item[\Macro{setfootbotline}] modifiziert die Parameter für die Linie -unter dem Seitenfuß +\item[\Macro{setheadtopline}] modifiziert die Parameter für die Linie +über dem Seitenkopf +\item[\Macro{setheadsepline}] modifiziert die Parameter für die Linie +zwischen Kopf und Textkörper +\item[\Macro{setfootsepline}] modifiziert die Parameter für die Linie +zwischen Text und Fuß +\item[\Macro{setfootbotline}] modifiziert die Parameter für die Linie +unter dem Seitenfuß \end{labeling} Das obligatorische Argument \PName{Dicke} bestimmt, wie stark die Linie -gezeichnet wird. Das optionale Argument \PName{Länge} akzeptiert die gleichen +gezeichnet wird. Das optionale Argument \PName{Länge} akzeptiert die gleichen symbolischen Werte wie \PName{Breite} bei \DescRef{scrpage-de.cmd.setheadwidth}, also auch einen -normalen Längenausdruck. Solange im Dokument dem optionalen Argument -\PName{Länge} kein Wert zugewiesen wurde, passt sich die entsprechende -Linienlänge automatisch der Breite des Kopfes bzw. des Fußes an. +normalen Längenausdruck. Solange im Dokument dem optionalen Argument +\PName{Länge} kein Wert zugewiesen wurde, passt sich die entsprechende +Linienlänge automatisch der Breite des Kopfes bzw. des Fußes an. -Möchte man diesen Automatismus für die Länge einer Linie wieder restaurieren, -dann nutzt man im Längenargument den Wert \PValue{auto}. +Möchte man diesen Automatismus für die Länge einer Linie wieder restaurieren, +dann nutzt man im Längenargument den Wert \PValue{auto}. Mit\ChangedAt{v2.2}{\Package{scrpage2}} dem optionalen Argument -\PName{Anweisungen} können zusätzliche Anweisungen definiert werden, die vor -dem Zeichnen der jeweiligen Linie auszuführen sind. Das können beispielsweise +\PName{Anweisungen} können zusätzliche Anweisungen definiert werden, die vor +dem Zeichnen der jeweiligen Linie auszuführen sind. Das können beispielsweise Anweisungen sein, um die -Farbe\Index{Kopf>Farbe}\Index{Fuss=Fuß>Farbe}\Index{Farbe>im - Kopf}\Index{Farbe>im Fuss=im Fuß} der Linie zu ändern. Bei Verwendung einer -\KOMAScript-Klasse können diese Anweisungen auch über -\Macro{setkomafont}\IndexCmd{setkomafont} für eines der Elemente +Farbe\Index{Kopf>Farbe}\Index{Fuss=Fuß>Farbe}\Index{Farbe>im + Kopf}\Index{Farbe>im Fuss=im Fuß} der Linie zu ändern. Bei Verwendung einer +\KOMAScript-Klasse können diese Anweisungen auch über +\Macro{setkomafont}\IndexCmd{setkomafont} für eines der Elemente \FontElement{headtopline}\IndexFontElement[indexmain]{headtopline}% \important[i]{\FontElement{headtopline}\\ \FontElement{headsepline}\\ @@ -2221,7 +2221,7 @@ Farbe\Index{Kopf>Farbe}\Index{Fuss=Fuß>Farbe}\Index{Farbe>im auch \FontElement{footbotline}\IndexFontElement[indexmain]{footbotline} gesetzt und mit \Macro{addtokomafont}\IndexCmd{addtokomafont} erweitert werden. Die beiden Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} -sind in der \KOMAScript-Anleitung näher beschrieben. +sind in der \KOMAScript-Anleitung näher beschrieben. \begin{Declaration} @@ -2234,29 +2234,29 @@ sind in der \KOMAScript-Anleitung näher beschrieben. \Macro{setheadtopline}\POParameter{auto}\Parameter{}\OParameter{} \end{Declaration}% Die hier am Befehl \DescRef{scrpage-de.cmd.setheadtopline} illustrierten Argumente -sind natürlich auch für die anderen drei Längenbefehle gültig. +sind natürlich auch für die anderen drei Längenbefehle gültig. -Enthält das obligatorische Argument den Wert \PValue{current} oder wird -leer gelassen, dann wird die Dicke der Linie nicht verändert. Das kann -genutzt werden, wenn die Länge der Linie, aber nicht die Dicke modifiziert +Enthält das obligatorische Argument den Wert \PValue{current} oder wird +leer gelassen, dann wird die Dicke der Linie nicht verändert. Das kann +genutzt werden, wenn die Länge der Linie, aber nicht die Dicke modifiziert werden soll. Wird das optionale Argument \PName{Anweisungen} weggelassen, so bleiben eventuell zuvor gesetzte Anweisungen erhalten. Wird hingegen ein leeres Argument \PName{Anweisungen} gesetzt, so werden eventuell zuvor gesetzte -Anweisungen wieder gelöscht. +Anweisungen wieder gelöscht. \begin{Example} - Soll beispielsweise der Kopf mit einer kräftigen Linie von 2\,pt darüber und + Soll beispielsweise der Kopf mit einer kräftigen Linie von 2\,pt darüber und einer normalen von 0,4\,pt zwischen Kopf und Text abgesetzt werden, dann erfolgt das mit: \begin{lstcode} \setheadtopline{2pt} \setheadsepline{.4pt} \end{lstcode} -Zusätzlich\textnote{Achtung!} sind unbedingt die Optionen +Zusätzlich\textnote{Achtung!} sind unbedingt die Optionen \DescRef{scrpage-de.option.headtopline} und \DescRef{scrpage-de.option.headsepline} vorzugsweise global im -optionalen Argument von \Macro{documentclass} zu setzen. Das Ergebnis könnte +optionalen Argument von \Macro{documentclass} zu setzen. Das Ergebnis könnte dann wie folgt aussehen. % \begin{XmpTopPage} @@ -2267,17 +2267,17 @@ dann wie folgt aussehen. \XmpMarginNote{83,14} \end{XmpTopPage} - Sollen diese Linien zusätzlich in roter Farbe gesetzt werden, dann sind die - Anweisungen beispielsweise wie folgt zu ändern: + Sollen diese Linien zusätzlich in roter Farbe gesetzt werden, dann sind die + Anweisungen beispielsweise wie folgt zu ändern: \begin{lstcode} \setheadtopline{2pt}[\color{red}] \setheadsepline{.4pt}[\color{red}] \end{lstcode} - In diesem und auch dem folgenden Beispiel wurde für die Aktivierung der + In diesem und auch dem folgenden Beispiel wurde für die Aktivierung der Farbe die Syntax des \Package{color}\IndexPackage{color}-Pakets verwendet, - das dann natürlich auch geladen werden muss. \Package{scrpage2} selbst - bietet keine direkte Farbunterstützung. Damit ist jedes beliebige - Farbunterstützungspaket verwendbar. + das dann natürlich auch geladen werden muss. \Package{scrpage2} selbst + bietet keine direkte Farbunterstützung. Damit ist jedes beliebige + Farbunterstützungspaket verwendbar. Mit einer \KOMAScript-Klasse kann alternativ \begin{lstcode} @@ -2288,8 +2288,8 @@ dann wie folgt aussehen. \end{lstcode} verwendet werden. - Die automatische Anpassung an die Kopf- und Fußbreiten illustriert folgendes - Beispiel, für das die Optionen \DescRef{scrpage-de.option.footbotline} und \DescRef{scrpage-de.option.footsepline} + Die automatische Anpassung an die Kopf- und Fußbreiten illustriert folgendes + Beispiel, für das die Optionen \DescRef{scrpage-de.option.footbotline} und \DescRef{scrpage-de.option.footsepline} gesetzt sein sollten: \begin{lstcode} \setfootbotline{2pt} @@ -2297,7 +2297,7 @@ dann wie folgt aussehen. \setfootwidth[0pt]{textwithmarginpar} \end{lstcode} -%\phantomsection für hyperref-\pageref-Link jum-2001/11/24 +%\phantomsection für hyperref-\pageref-Link jum-2001/11/24 \phantomsection\label{page:scrpage-de.autoLineLength}% \begin{XmpBotPage} \XmpHeading{10,18}{85} @@ -2308,9 +2308,9 @@ dann wie folgt aussehen. \end{XmpBotPage} \end{Example} % -Nun mag nicht jedem die Ausrichtung der Linie über der Fußzeile gefallen, +Nun mag nicht jedem die Ausrichtung der Linie über der Fußzeile gefallen, sondern es wird in einem solchen Fall erwartet, dass sie wie der Kolumnentitel -linksbündig zum Text ist. Diese Einstellung kann nur global in Form einer +linksbündig zum Text ist. Diese Einstellung kann nur global in Form einer Paketoption erfolgen und wird im folgenden \autoref{sec:scrpage-de.basics.options} mit anderen Optionen beschrieben.% % @@ -2321,10 +2321,10 @@ Paketoption erfolgen und wird im folgenden \subsection{Optionen beim Laden des Paketes} \label{sec:scrpage-de.basics.options} -Während bei den \KOMAScript-Klassen die Mehrzahl der Optionen auch noch nach -dem Laden der Klasse mit \Macro{KOMAoptions} und \Macro{KOMAoption} geändert -werden kann, trifft dies für das Paket \Package{scrpage2} \iffree{derzeit noch -}{}nicht zu. Alle Optionen für dieses Paket müssen als globale Optionen, also +Während bei den \KOMAScript-Klassen die Mehrzahl der Optionen auch noch nach +dem Laden der Klasse mit \Macro{KOMAoptions} und \Macro{KOMAoption} geändert +werden kann, trifft dies für das Paket \Package{scrpage2} \iffree{derzeit noch +}{}nicht zu. Alle Optionen für dieses Paket müssen als globale Optionen, also im optionalen Argument von \Macro{documentclass}, oder als Paketoptionen, also im optionalen Argument von \Macro{usepackage}, angegeben werden. @@ -2342,8 +2342,8 @@ im optionalen Argument von \Macro{usepackage}, angegeben werden. Diese\textnote{Achtung!} Optionen sollten bei Verwendung von \KOMAScript~3\ChangedAt{v2.3}{\Package{scrpage2}} nicht mehr beispielsweise per optionalem Argument von \Macro{usepackage} oder per -\Macro{PassOptionsToPackage} direkt an \Package{scrpage2} übergeben -werden. Lediglich aus Gründen der Kompatibilität sind sie noch in +\Macro{PassOptionsToPackage} direkt an \Package{scrpage2} übergeben +werden. Lediglich aus Gründen der Kompatibilität sind sie noch in \Package{scrpage2} deklariert und werden von diesem als \Option{headinclude}, \OptionValue{headinclude}{false}, \Option{footinclude} und \OptionValue{footinclude}{false} an das Paket \Package{typearea} @@ -2361,10 +2361,10 @@ weitergereicht. \Option{footbotline}% \Option{plainfootbotline} \end{Declaration}% -Eine Grundeinstellung für die Linien unter und über den Kopf- und Fußzeilen +Eine Grundeinstellung für die Linien unter und über den Kopf- und Fußzeilen kann mit diesen Optionen vorgenommen werden. Diese Einstellungen gelten dann -als Standard für alle mit \Package{scrpage2} definierten Seitenstile. Wird -eine von diesen Optionen verwendet, dann wird eine Linienstärke von 0,4\,pt +als Standard für alle mit \Package{scrpage2} definierten Seitenstile. Wird +eine von diesen Optionen verwendet, dann wird eine Linienstärke von 0,4\,pt eingesetzt. Da es zum Seitenstil \PageStyle{scrheadings} einen entsprechenden plain-Stil gibt, kann mit den \Option{plain\dots}-Optionen auch die entsprechende Linie des plain-Stils konfiguriert werden. Diese @@ -2373,18 +2373,18 @@ Option ohne \Option{plain} aktiviert wurde. Somit zeigt die Option \Option{plainheadtopline} ohne \Option{headtopline} keine Wirkung. Bei diesen Optionen ist zu beachten, dass der entsprechende Seitenteil in den -Textbereich des Satzspiegels mit übernommen wird, wenn eine Linie aktiviert +Textbereich des Satzspiegels mit übernommen wird, wenn eine Linie aktiviert wurde. Wird also mittels \Option{headsepline} die Trennlinie zwischen Kopf und Text aktiviert, dann wird automatisch mittels \Package{typearea} der Satzspiegel so berechnet, dass der Seitenkopf Teil des Textblocks ist. -Die\textnote{Achtung!} Bedingungen für die Optionen des vorhergehenden -Abschnitts gelten auch für diesen Automatismus. Das bedeutet, dass das Paket +Die\textnote{Achtung!} Bedingungen für die Optionen des vorhergehenden +Abschnitts gelten auch für diesen Automatismus. Das bedeutet, dass das Paket \Package{typearea} nach \Package{scrpage2} geladen werden muss, beziehungsweise, dass bei Verwendung einer \KOMAScript{}-Klasse die Optionen \DescRef{scrpage-de.option.headinclude} und \DescRef{scrpage-de.option.footinclude} explizit bei -\Macro{documentclass} gesetzt werden müssen, um Kopf- bzw. Fußzeile in den -Textblock zu übernehmen.% +\Macro{documentclass} gesetzt werden müssen, um Kopf- bzw. Fußzeile in den +Textblock zu übernehmen.% % \EndIndexGroup @@ -2395,14 +2395,14 @@ Textblock zu übernehmen.% \Option{olines} \end{Declaration}% \Index{Linienausrichtung}% -Bei der Festlegung der Linienlängen kann es vorkommen, dass die Linie zwar die -gewünschte Länge, aber nicht die erwünschte Ausrichtung hat, da sie im Kopf- -bzw. Fußbereich zentriert wird. Mit den hier vorgestellten Paketoptionen kann -global für alle mit \Package{scrpage2} definierten Seitenstile diese Vorgabe +Bei der Festlegung der Linienlängen kann es vorkommen, dass die Linie zwar die +gewünschte Länge, aber nicht die erwünschte Ausrichtung hat, da sie im Kopf- +bzw. Fußbereich zentriert wird. Mit den hier vorgestellten Paketoptionen kann +global für alle mit \Package{scrpage2} definierten Seitenstile diese Vorgabe modifiziert werden. Dabei setzt \Option{ilines} die Ausrichtung so, dass die Linien an den inneren Rand verschoben werden. Die Option \Option{clines} -verhält sich wie die Standardeinstellung und \Option{olines} richtet am -äußeren Rand aus. +verhält sich wie die Standardeinstellung und \Option{olines} richtet am +äußeren Rand aus. \begin{Example} Hier gilt es, das Beispiel zu \DescRef{scrpage-de.cmd.setfootsepline} auf @@ -2418,8 +2418,8 @@ verhält sich wie die Standardeinstellung und \Option{olines} richtet am % Der folgende Text wurde erg"anzt um den Seitenumbruch zu verbessern, % mjk-2001-10-05: % \enlargethispage*{2\baselineskip} - Allein die Verwendung der Option \Option{ilines} führt dabei zu der - geänderten Ausgabe, die nachfolgend veranschaulicht wird: + Allein die Verwendung der Option \Option{ilines} führt dabei zu der + geänderten Ausgabe, die nachfolgend veranschaulicht wird: % \begin{XmpBotPage} \XmpHeading{10,18}{85} @@ -2428,13 +2428,13 @@ verhält sich wie die Standardeinstellung und \Option{olines} richtet am \XmpSetText[\XmpBotText]{10,36} \XmpMarginNote{83,26} \end{XmpBotPage} - Die Trennlinie zwischen Text und Fuß wird bündig innen im Fußteil + Die Trennlinie zwischen Text und Fuß wird bündig innen im Fußteil gesetzt und nicht wie bei der Standardeinstellung zentriert. \end{Example} \EndIndexGroup -% \phantomsection für hyperref-\pageref-Link jum-2001/11/24 +% \phantomsection für hyperref-\pageref-Link jum-2001/11/24 \begin{Declaration} \Option{automark}% \Option{manualmark} @@ -2449,7 +2449,7 @@ sie. % bzw. falschen Bug-Reports im Support kamen. % mjk-2001-09-21: Ohne Verwendung einer der beiden Optionen bleibt die Einstellung -erhalten, die beim Laden des Paketes gültig war. +erhalten, die beim Laden des Paketes gültig war. \begin{Example} Sie laden das Paket \Package{scrpage2} unmittelbar nach der Klasse \Class{scrreprt} und ohne weitere Optionen. Dazu schreiben Sie: @@ -2458,9 +2458,9 @@ erhalten, die beim Laden des Paketes gültig war. \usepackage{scrpage2} \end{lstcode} Da bei \Class{scrreprt} der Seitenstil \PageStyle{plain} voreingestellt - ist, ist dies auch jetzt noch der Fall. Außerdem entspricht die + ist, ist dies auch jetzt noch der Fall. Außerdem entspricht die Voreinstellung \PageStyle{plain} manuellen Kolumnentiteln. Wenn Sie - also anschließend mit + also anschließend mit \begin{lstcode} \pagestyle{scrheadings} \end{lstcode} @@ -2474,7 +2474,7 @@ erhalten, die beim Laden des Paketes gültig war. \usepackage{scrpage2} \end{lstcode} der Seitenstil \PageStyle{headings} mit automatischen Kolumnentiteln - aktiviert. Bei anschließender Umschaltung auf den Seitenstil + aktiviert. Bei anschließender Umschaltung auf den Seitenstil \PageStyle{scrheadings} bleiben automatische Kolumnentitel eingeschaltet. Dabei werden dann weiterhin die Markierungsmakros von \Class{scrbook} verwendet. @@ -2483,10 +2483,10 @@ erhalten, die beim Laden des Paketes gültig war. \begin{lstcode} \usepackage[automark]{scrpage2} \end{lstcode} - so wird unabhängig von der verwendeten Klasse auf automatische + so wird unabhängig von der verwendeten Klasse auf automatische Kolumnentitel umgeschaltet, wobei die Markierungsmakros von \Package{scrpage2} genutzt werden. - Natürlich wirkt sich dies auf den Seitenstil + Natürlich wirkt sich dies auf den Seitenstil \PageStyle{plain} von \Class{scrreprt} nicht aus. Die Kolumnentitel werden erst sichtbar, wenn auf den Seitenstil \PageStyle{scrheadings}\IndexPagestyle{scrheadings} oder @@ -2496,7 +2496,7 @@ erhalten, die beim Laden des Paketes gültig war. \EndIndexGroup -% Folgende Deklaration und Erklaerung wurde eingefügt von +% Folgende Deklaration und Erklaerung wurde eingefügt von % mjk 2001-08-17: \begin{Declaration} \Option{autooneside} @@ -2505,7 +2505,7 @@ erhalten, die beim Laden des Paketes gültig war. \BeginIndex{}{Kolumnentitel>manuell}% Mit dieser Option wird das optionale Argument von \DescRef{scrpage-de.cmd.automark}\IndexCmd{automark}\Index{Kolumnentitel>automatisch} im -einseitigen Satz automatisch ignoriert. Siehe hierzu auch die Erläuterung +einseitigen Satz automatisch ignoriert. Siehe hierzu auch die Erläuterung zum Befehl \DescRef{scrpage-de.cmd.automark} in \autoref{sec:scrpage-de.basics.mark}, \DescPageRef{scrpage-de.cmd.automark}.% % @@ -2521,12 +2521,12 @@ Diese Optionen bestimmen, wie die beiden vordefinierten Seitenstile Bei \Option{komastyle} wird eine Definition vorgenommen, wie sie den \KOMAScript{}-Klassen entspricht. Bei den \KOMAScript{}-Klassen ist dies die Voreinstellung und -kann somit auch für andere Klassen gesetzt werden. +kann somit auch für andere Klassen gesetzt werden. Die Option \Option{standardstyle} definiert die beiden Seitenstile wie es von den Standardklassen erwartet wird. -Außerdem wird hier automatisch \DescRef{scrpage-de.option.markuppercase} aktiviert, -es sei denn, \DescRef{scrpage-de.option.markusedcase} wird ebenfalls als Option übergeben.% +Außerdem wird hier automatisch \DescRef{scrpage-de.option.markuppercase} aktiviert, +es sei denn, \DescRef{scrpage-de.option.markusedcase} wird ebenfalls als Option übergeben.% \EndIndexGroup @@ -2534,19 +2534,19 @@ es sei denn, \DescRef{scrpage-de.option.markusedcase} wird ebenfalls als Option \Option{markuppercase}% \Option{markusedcase} \end{Declaration}% -Für die Funktionalität von \DescRef{scrpage-de.cmd.automark} modifiziert +Für die Funktionalität von \DescRef{scrpage-de.cmd.automark} modifiziert \Package{scrpage2} interne Befehle, die die Gliederungsbefehle benutzen, um die lebenden Kolumnentitel zu setzen. Da einige Klassen, im Gegensatz -zu den \KOMAScript{}-Klassen, die Kolumnentitel in Großbuchstaben +zu den \KOMAScript{}-Klassen, die Kolumnentitel in Großbuchstaben schreiben, muss \Package{scrpage2} wissen, wie die genutzte Dokumentklasse die lebenden Kolumnentitel darstellt. Die Option \Option{markuppercase} zeigt \Package{scrpage2}, dass die benutzte -Klasse die Großschreibweise benutzt. Die Option \Option{markusedcase} sollte -angegeben werden, wenn die benutzte Dokumentklasse keine Großschreibweise +Klasse die Großschreibweise benutzt. Die Option \Option{markusedcase} sollte +angegeben werden, wenn die benutzte Dokumentklasse keine Großschreibweise verwendet. Die\textnote{Achtung!} Optionen sind nicht geeignet, eine -entsprechende Darstellung zu erzwingen. Es kann somit zu unerwünschten +entsprechende Darstellung zu erzwingen. Es kann somit zu unerwünschten Effekten kommen, wenn die Angabe nicht dem Verhalten der Dokumentklasse entspricht.% \EndIndexGroup @@ -2557,28 +2557,28 @@ entspricht.% \begin{Declaration} \Option{nouppercase} \end{Declaration}% -Wie in obiger Erklärung zu \DescRef{scrpage-de.option.markuppercase} und \DescRef{scrpage-de.option.markusedcase} -bereits ausgeführt wurde, gibt es Klassen und auch Pakete, die beim Setzen der +Wie in obiger Erklärung zu \DescRef{scrpage-de.option.markuppercase} und \DescRef{scrpage-de.option.markusedcase} +bereits ausgeführt wurde, gibt es Klassen und auch Pakete, die beim Setzen der lebenden Kolumnentitel\Index{Kolumnentitel>automatisch} mit Hilfe einer der Anweisungen \Macro{uppercase}\IndexCmd{uppercase}\important{\Macro{uppercase}} oder \Macro{MakeUppercase}\IndexCmd{MakeUppercase}\important{\Macro{MakeUppercase}} -den gesamten Eintrag in Großbuchstaben wandeln. Mit der Option -\Option{nouppercase} können diese beiden Anweisungen im Kopf und im Fuß außer -Kraft gesetzt werden. Das gilt aber nur für Seitenstile, die mit Hilfe von -\Package{scrpage2} definiert werden. Dazu zählen auch \PageStyle{scrheadings} -und der zugehörige plain-Seitenstil. - -Die verwendete Methode ist äußerst brutal und kann dazu führen, dass -auch erwünschte Änderungen von Klein- in -Großbuchstaben\Index{Grossbuchstaben=Großbuchstaben} unterbleiben. Da -diese Fälle nicht sehr häufig sind, stellt \Option{nouppercase} aber -meist eine brauchbare Lösung dar. +den gesamten Eintrag in Großbuchstaben wandeln. Mit der Option +\Option{nouppercase} können diese beiden Anweisungen im Kopf und im Fuß außer +Kraft gesetzt werden. Das gilt aber nur für Seitenstile, die mit Hilfe von +\Package{scrpage2} definiert werden. Dazu zählen auch \PageStyle{scrheadings} +und der zugehörige plain-Seitenstil. + +Die verwendete Methode ist äußerst brutal und kann dazu führen, dass +auch erwünschte Änderungen von Klein- in +Großbuchstaben\Index{Grossbuchstaben=Großbuchstaben} unterbleiben. Da +diese Fälle nicht sehr häufig sind, stellt \Option{nouppercase} aber +meist eine brauchbare Lösung dar. \begin{Example} Sie verwenden die Standardklasse \Class{book}\IndexClass{book}, wollen aber, dass die lebenden Kolumnentitel nicht in - Großbuchstaben, sondern in normaler gemischter Schreibweise gesetzt - werden. Die Präambel Ihres Dokuments könnte dann wie folgt beginnen: + Großbuchstaben, sondern in normaler gemischter Schreibweise gesetzt + werden. Die Präambel Ihres Dokuments könnte dann wie folgt beginnen: \begin{lstcode} \documentclass{book} \usepackage[nouppercase]{scrpage2} @@ -2589,10 +2589,10 @@ meist eine brauchbare Lösung dar. wird, der von der Option \Option{nouppercase} nicht behandelt wird. \end{Example} -In einigen Fällen setzen nicht nur Klassen, sondern auch Pakete -lebende Kolumnentitel in Großbuchstaben. Auch in diesen Fällen hilft +In einigen Fällen setzen nicht nur Klassen, sondern auch Pakete +lebende Kolumnentitel in Großbuchstaben. Auch in diesen Fällen hilft \Option{nouppercase} meist, um zu gemischter Schreibweise -zurückzuschalten.% +zurückzuschalten.% % \EndIndexGroup @@ -2603,8 +2603,8 @@ zurückzuschalten.% \subsection{Die Anwenderschnittstelle}\label{sec:scrpage-de.UI.user} % \deftripstyle -Nun möchte man ja nicht immer an die vorgegebenen Seitenstile gebunden sein, -sondern auch seiner Kreativität freien Lauf lassen. +Nun möchte man ja nicht immer an die vorgegebenen Seitenstile gebunden sein, +sondern auch seiner Kreativität freien Lauf lassen. Manchmal ist man auch dazu gezwungen, weil eine bestimmte \emph{Corporate Identity} einer Firma es verlangt. Der einfachste Weg damit umzugehen ist @@ -2619,42 +2619,42 @@ Die einzelnen Felder haben folgende Bedeutung: \item[\PName{Name}] die Bezeichnung des Seitenstils, die dann bei der Aktivierung mit \Macro{pagestyle}\Parameter{Name} oder \Macro{thispagestyle}\Parameter{Name} verwendet wird -\item[\PName{LA}] die Dicke der äußeren Linien, d.\,h. der Linien über der - Kopfzeile und unter der Fußzeile (optional) +\item[\PName{LA}] die Dicke der äußeren Linien, d.\,h. der Linien über der + Kopfzeile und unter der Fußzeile (optional) \item[\PName{LI}] die Dicke der inneren Linie, d.\,h. der Linien die Kopf und - Fuß vom Textkörper trennen (optional) + Fuß vom Textkörper trennen (optional) \item[\PName{KI}] Inhalt des Feldes im Kopf innenseitig oder bei einseitigem Layout links \item[\PName{KM}] Inhalt des Feldes im Kopf zentriert -\item[\PName{KA}] Inhalt des Feldes im Kopf außenseitig oder bei einseitigem +\item[\PName{KA}] Inhalt des Feldes im Kopf außenseitig oder bei einseitigem Layout rechts -\item[\PName{FI}] Inhalt des Feldes im Fuß innenseitig oder bei einseitigem +\item[\PName{FI}] Inhalt des Feldes im Fuß innenseitig oder bei einseitigem Layout links -\item[\PName{FM}] Inhalt des Feldes im Fuß zentriert -\item[\PName{FA}] Inhalt des Feldes im Fuß außenseitig oder bei einseitigem +\item[\PName{FM}] Inhalt des Feldes im Fuß zentriert +\item[\PName{FA}] Inhalt des Feldes im Fuß außenseitig oder bei einseitigem Layout rechts \end{labeling} Der Befehl \Macro{deftripstyle} stellt sicherlich die einfachste -Möglichkeit dar, Seitenstile zu definieren. -Leider sind damit auch Einschränkungen verbunden, +Möglichkeit dar, Seitenstile zu definieren. +Leider sind damit auch Einschränkungen verbunden, da in einem Seitenbereich mit einem durch \Macro{deftripstyle} deklarierten -Seitenstil keine Änderung der Kopf- und Fußlinien erfolgen kann. +Seitenstil keine Änderung der Kopf- und Fußlinien erfolgen kann. \begin{Example} Vorgegeben sei ein doppelseitiges Layout, bei dem die Kolumnentitel innen erscheinen sollen. Weiterhin soll der Dokumenttitel, in diesem Fall kurz - \glqq Bericht\grqq, an den Außenrand in den Kopf, die Seitenzahl soll - zentriert in den Fuß. + \glqq Bericht\grqq, an den Außenrand in den Kopf, die Seitenzahl soll + zentriert in den Fuß. \begin{lstcode} \deftripstyle{DerBericht}% {\headmark}{}{Bericht}% {}{\pagemark}{} \end{lstcode} - Sollen weiterhin die Linien über dem Kopf und unter dem Fuß - mit 2\,pt erscheinen und der ganze Textkörper mit dünnen Linien - von 0,4\,pt von Kopf und Fuß abgesetzt werden, dann erweitert + Sollen weiterhin die Linien über dem Kopf und unter dem Fuß + mit 2\,pt erscheinen und der ganze Textkörper mit dünnen Linien + von 0,4\,pt von Kopf und Fuß abgesetzt werden, dann erweitert man vorherige Definition. \begin{lstcode} \deftripstyle{DerBericht}[2pt][.4pt]% @@ -2670,9 +2670,9 @@ Seitenstil keine Änderung der Kopf- und Fußlinien erfolgen kann. [{% Beispiel eines selbst definierten, von Linien dominierten Seitenstils% }]{% - Beispiel für einen selbst definierten, von Linien dominierten Seitenstil + Beispiel für einen selbst definierten, von Linien dominierten Seitenstil mit einem statischen und einem lebenden Kolumnentitel im Kopf und der - Seitenzahl in der Mitte des Fußes.% + Seitenzahl in der Mitte des Fußes.% \label{fig:scrpage-de2.tomuchlines}% } [l] @@ -2717,24 +2717,24 @@ Seitenstil keine Änderung der Kopf- und Fußlinien erfolgen kann. \subsection{Die Expertenschnittstelle}\label{sec:scrpage-de.UI.expert} % \defpagestyle \newpagestyle \providepagestyle \renewpagestyle Einfache Seitenstile, wie sie mit \DescRef{scrpage-de.cmd.deftripstyle} deklariert -werden können, sind erfahrungsgemäß selten. +werden können, sind erfahrungsgemäß selten. Entweder verlangt ein Professor, dass die Diplomarbeit so aussieht wie seine eigene -- und wer will ihm da \emph{ernsthaft} widersprechen -- -oder eine Firma möchte, dass die halbe Finanzbuchhaltung im -Seitenfuß auf"|taucht. Alles kein Problem, denn es gibt noch: +oder eine Firma möchte, dass die halbe Finanzbuchhaltung im +Seitenfuß auf"|taucht. Alles kein Problem, denn es gibt noch: \begin{Declaration} - \Macro{defpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% - \Macro{newpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% - \Macro{renewpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% - \Macro{providepagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition} + \Macro{defpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% + \Macro{newpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% + \Macro{renewpagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition}% + \Macro{providepagestyle}\Parameter{Name}\Parameter{Kopfdefinition}\Parameter{Fußdefinition} \end{Declaration}% -Dies sind die Befehle, die die volle Kontrolle über die Gestaltung -eines Seitenstils ermöglichen. Der Aufbau ist bei allen vier +Dies sind die Befehle, die die volle Kontrolle über die Gestaltung +eines Seitenstils ermöglichen. Der Aufbau ist bei allen vier Definitionen gleich, sie unterscheiden sich nur hinsichtlich der Wirkungsweise. \begin{labeling}[\ --]{\Macro{providepagestyle}} \item[\Macro{defpagestyle}] definiert einen neuen Seitenstil. Existiert - bereits einer mit diesem Namen, wird dieser überschrieben. + bereits einer mit diesem Namen, wird dieser überschrieben. \item[\Macro{newpagestyle}] definiert einen neuen Seitenstil. Wenn schon einer mit diesem Namen existiert, wird ein Fehler ausgegeben. \item[\Macro{renewpagestyle}] definiert einen bestehenden Seitenstil um. Wenn @@ -2744,30 +2744,30 @@ der Wirkungsweise. \end{labeling} Am Beispiel von \Macro{defpagestyle} soll die Syntax der Definitionen -im Folgenden erläutert werden. +im Folgenden erläutert werden. \begin{labeling}[~--]{\PName{Kopfdefinition}\,} \item[\PName{Name}] die Bezeichnung des Seitenstils \item[\PName{Kopfdefinition}] die Deklaration des Seitenkopfes bestehend aus - fünf Teilen, wobei die in runden Klammern stehenden Angaben optional + fünf Teilen, wobei die in runden Klammern stehenden Angaben optional sind:\hfill\\ \hspace*{1em}\AParameter{OLL,OLD}% \Parameter{GS}\Parameter{US}\Parameter{ES}\AParameter{ULL,ULD} -\item[\PName{Fußdefinition}] die Deklaration des Seitenfußes bestehend aus - fünf Teilen, wobei die in runden Klammern stehenden Angaben optional +\item[\PName{Fußdefinition}] die Deklaration des Seitenfußes bestehend aus + fünf Teilen, wobei die in runden Klammern stehenden Angaben optional sind:\hfill\\ \hspace*{1em}\AParameter{OLL,OLD}% \Parameter{GS}\Parameter{US}\Parameter{ES}\AParameter{ULL,ULD} \end{labeling} -Wie zu sehen ist, haben Kopf- und Fußdefinition identischen Aufbau. Die +Wie zu sehen ist, haben Kopf- und Fußdefinition identischen Aufbau. Die einzelnen Parameter haben folgende Bedeutung: \begin{labeling}[\ --]{\PName{OLD}} -\item[\PName{OLL}] obere Linienlänge: Kopf = außen, Fuß = Trennlinie +\item[\PName{OLL}] obere Linienlänge: Kopf = außen, Fuß = Trennlinie \item[\PName{OLD}] obere Liniendicke -\item[\PName{GS}] Definition für die \emph{gerade} Seite -\item[\PName{US}] Definition für die \emph{ungerade} Seite -\item[\PName{ES}] Definition für \emph{einseitiges} Layout -\item[\PName{ULL}] untere Linienlänge Kopf = Trennlinie, Fuß = außen +\item[\PName{GS}] Definition für die \emph{gerade} Seite +\item[\PName{US}] Definition für die \emph{ungerade} Seite +\item[\PName{ES}] Definition für \emph{einseitiges} Layout +\item[\PName{ULL}] untere Linienlänge Kopf = Trennlinie, Fuß = außen \item[\PName{ULD}] untere Liniendicke \end{labeling} @@ -2777,8 +2777,8 @@ weiterhin durch die in \autoref{sec:scrpage-de.basics.format}, konfigurierbar. Die drei Felder \PName{GS}, \PName{US} und \PName{ES} entsprechen Boxen, die -die Breite des Kopf- bzw. Fußteils haben. -Die entsprechenden Definitionen erscheinen in diesen Boxen linksbündig. +die Breite des Kopf- bzw. Fußteils haben. +Die entsprechenden Definitionen erscheinen in diesen Boxen linksbündig. Um somit etwas links- \emph{und} rechtsseitig in den Boxen zu platzieren, kann der Zwischenraum mit \Macro{hfill} gestreckt werden: % @@ -2786,10 +2786,10 @@ kann der Zwischenraum mit \Macro{hfill} gestreckt werden: {\headmark\hfill\pagemark} \end{lstcode} -Um zusätzlich etwas zentriert erscheinen zu lassen, ist eine erweiterte +Um zusätzlich etwas zentriert erscheinen zu lassen, ist eine erweiterte Definition notwendig. -Die Befehle \Macro{rlap} und \Macro{llap} setzen die übergebenen Argumente. -Für \LaTeX{} erscheint es aber so, dass diese Texte eine Breite von Null +Die Befehle \Macro{rlap} und \Macro{llap} setzen die übergebenen Argumente. +Für \LaTeX{} erscheint es aber so, dass diese Texte eine Breite von Null haben. Nur so erscheint der mittlere Text auch wirklich zentriert. % \begin{lstcode} @@ -2798,12 +2798,12 @@ haben. Nur so erscheint der mittlere Text auch wirklich zentriert. \iffalse% Umbruchkorrekturtext Dies und die Verwendung der Expertenschnittstelle in Zusammenhang mit -anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. +anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. \fi \begin{Example} Angenommen es wird die Dokumentklasse \Class{scrbook} genutzt. Damit - liegt ein zweiseitiges Layout vor. Für das Paket \Package{scrpage2} wird + liegt ein zweiseitiges Layout vor. Für das Paket \Package{scrpage2} wird festgelegt, dass mit automatisch aktualisierten Kolumnentiteln gearbeitet wird und dass im Seitenstil \PageStyle{scrheadings} eine Trennlinie zwischen Kopf und Text gezogen wird. @@ -2814,7 +2814,7 @@ anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. \end{lstcode} Mit Hilfe der Expertenschnittstelle werden zwei Seitenstile definiert. Der - erste legt keine Linienargumente fest, im zweiten wird die Linie über dem + erste legt keine Linienargumente fest, im zweiten wird die Linie über dem Kopf mit einer Dicke von 1\,pt und die Linie unter dem Kopf mit 0\,pt festgelegt. @@ -2847,28 +2847,28 @@ anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. Gleich zu Beginn wird der Seitenstil \PageStyle{scrheadings} aktiviert. Mit \Macro{chapter} wird ein neues Kapitel begonnen. Weiterhin wird automatisch - durch \Macro{chapter} der Seitenstil für diese Seite auf \PageStyle{plain} + durch \Macro{chapter} der Seitenstil für diese Seite auf \PageStyle{plain} gesetzt. Das folgende \DescRef{scrpage-de.cmd.chead} zeigt, wie durch Modifikation des - plain-Stils ein Kolumnentitel erzeugt werden kann. Grundsätzlich sollte + plain-Stils ein Kolumnentitel erzeugt werden kann. Grundsätzlich sollte jedoch davon Abstand genommen werden, da sonst der Markierungscharakter der plain-Seite verloren geht. Es ist wichtiger anzuzeigen, dass hier ein neues Kapitel beginnt, als dass ein Abschnitt dieser Seite einen bestimmten Titel - trägt. + trägt. \begin{lstcode} \begin{document} \pagestyle{scrheadings} \chapter{Thermodynamik} \chead[\leftmark]{} - \section{Hauptsätze} - Jedes System besitzt eine extensive Zustandsgröße + \section{Hauptsätze} + Jedes System besitzt eine extensive Zustandsgröße Energie. Sie ist in einem abgeschlossenen System konstant. \end{lstcode}% \begin{XmpTopPage} \XmpHeading[\hfill\textsl{1 Thermodynamik}\hfill]{10,27}{70} \put(10,17){\normalsize\textbf{\sffamily 1 Thermodynamik}} - \put(10,12){\textbf{\sffamily 1.1 Hauptsätze}} + \put(10,12){\textbf{\sffamily 1.1 Hauptsätze}} \XmpSetText[% Jedes System besitzt eine extensive Zustands\char\defaulthyphenchar \linebreak]{10,9} @@ -2877,18 +2877,18 @@ anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. Nach dem Seitenwechsel ist der Seitenstil \PageStyle{scrheadings} aktiv, und somit auch die Trennlinie aus den Paketoptionen sichtbar. \begin{lstcode} - Es existiert eine Zustandsgröße, genannt die - Entropie eines Systems, deren zeitliche Änderung - sich aus Entropieströmung und Entropieerzeugung + Es existiert eine Zustandsgröße, genannt die + Entropie eines Systems, deren zeitliche Änderung + sich aus Entropieströmung und Entropieerzeugung zusammensetzt. \end{lstcode} \begin{XmpTopPage} \XmpHeading[\textsl{1 Thermodynamik}\hfill]{20,27}{70} \thinlines\XmpRule{20,25}{70} \XmpSetText[% - Es existiert eine Zustandsgröße, genannt die En"-tropie - eines Systems, deren zeitliche Änderung sich aus - Entropieströmung und Entropie\char\defaulthyphenchar\kern-1pt + Es existiert eine Zustandsgröße, genannt die En"-tropie + eines Systems, deren zeitliche Änderung sich aus + Entropieströmung und Entropie\char\defaulthyphenchar\kern-1pt \linebreak]{20,21} \end{XmpTopPage} @@ -2896,7 +2896,7 @@ anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. und der Seitenstil \PValue{ohneLinien} aktiviert. Da keine Linienargumente bei der Definition dieses Stils genutzt wurden, wird die Standard-Linien\-konfiguration verwendet. Diese zeichnet hier eine Linie - zwischen Kopf und Text, da \DescRef{scrpage-de.option.headsepline} als Argument für + zwischen Kopf und Text, da \DescRef{scrpage-de.option.headsepline} als Argument für \Package{scrpage2} angegeben wurde.% \begin{lstcode} \manualmark @@ -2942,14 +2942,14 @@ anderen Befehlen von \Package{scrpage2} nun als abschließendes Beispiel. \subsection{Seitenstile verwalten}\label{sec:scrpage-de.UI.cfgFile} % scrpage.cfg \BeginIndex{File}{scrpage.cfg} -Bei längerer Arbeit mit verschiedenen Seitenstilen wird sich, je nach +Bei längerer Arbeit mit verschiedenen Seitenstilen wird sich, je nach Geschmack und Aufgabenstellung, ein fester Satz an benutzten Stilen etablieren. -Um nicht bei jedem neuen Projekt eine große Kopieraktion von den Daten -eines Projekts zum neuen Projekt starten zu müssen, liest \Package{scrpage2} +Um nicht bei jedem neuen Projekt eine große Kopieraktion von den Daten +eines Projekts zum neuen Projekt starten zu müssen, liest \Package{scrpage2} am Ende seiner Initialisierungsphase die Datei \File{scrpage.cfg} ein. -In dieser Datei können dann Seitenstile definiert sein, die viele -Projekte gemeinsam nutzen können. +In dieser Datei können dann Seitenstile definiert sein, die viele +Projekte gemeinsam nutzen können. \EndIndex{File}{scrpage.cfg} % \EndIndexGroup @@ -2958,6 +2958,6 @@ Projekte gemeinsam nutzen können. %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: utf-8 %%% TeX-master: t %%% End: |