summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex111
1 files changed, 80 insertions, 31 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
index f19c3ebc4fa..017c382ab10 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle-experts.tex
-% Copyright (c) Markus Kohm, 2001-2015
+% Copyright (c) Markus Kohm, 2001-2016
%
% 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-2015
+% Copyright (c) Markus Kohm, 2001-2016
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -48,16 +48,18 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle-experts.tex}
- [$Date: 2015-09-11 14:31:18 +0200 (Fri, 11 Sep 2015) $
+ [$Date: 2016-04-07 09:48:00 +0200 (Thu, 07 Apr 2016) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
\translator{Gernot Hassenpflug\and Markus Kohm}
-% Date of the translated German file: 2015-09-10
+% Date of the translated German file: 2016-03-08
-\chapter{Additional Information about the Main Classes \Class{scrbook},
+\chapter[{Additional Information about the Main Classes and
+ \Package{scrextend}}]{Additional Information about the Main Classes
+ \Class{scrbook},
\Class{scrreprt}, and \Class{scrartcl} as well as the Package
\Package{scrextend}}
\labelbase{maincls-experts}
@@ -536,26 +538,35 @@ dependent attributes, too. Currently the following styles are provided:
the value should be unique.\\
\PValue{style} & \PName{name} & Defines the style of the
heading.\\
- \PValue{tocindent} & \PName{length} & Total indentation from the left
- margin of the entry in the table of
- contents corresponding to this
- heading, if and only if such an
- entry will be made (see
- \Counter{tocdepth} (siehe
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.counter.tocdepth}).\\
- \PValue{toclevel} & \PName{integer} &
- A number denoting the depth of the
- entry in the table of contents
- corresponding to this heading, if
- this should differ from
- \PValue{level} (see
- \Counter{tocdepth} in
- \autoref{sec:maincls.toc},
- \autopageref{desc:maincls.counter.tocdepth}). \\
- \PValue{tocnumwidth} & \PName{length} &
- Width of the box for the number of
- the entry in the table of contents.\\
+ \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ \PValue{tocstyle} & \PName{name} & Defines the style of the entries into
+ the table of contents. You can use
+ every already defined toc-entry
+ style (see
+ \autoref{sec:tocbasic.tocstyle}). An
+ empty \PName{name} prevents a new
+ definition of the toc-entry command.\\
+ % \PValue{tocindent} & \PName{length} & Total indentation from the left
+ % margin of the entry in the table of
+ % contents corresponding to this
+ % heading, if and only if such an
+ % entry will be made (see
+ % \Counter{tocdepth} (siehe
+ % \autoref{sec:maincls.toc},
+ % \autopageref{desc:maincls.counter.tocdepth}).\\
+ % \PValue{toclevel} & \PName{integer} &
+ % A number denoting the depth of the
+ % entry in the table of contents
+ % corresponding to this heading, if
+ % this should differ from
+ % \PValue{level} (see
+ % \Counter{tocdepth} in
+ % \autoref{sec:maincls.toc},
+ % \autopageref{desc:maincls.counter.tocdepth}). \\
+ % \PValue{tocnumwidth} & \PName{length} &
+ % Width of the box for the number of
+ % the entry in the table of contents.\\
\bottomrule
\end{tabularx}
\end{table}
@@ -738,6 +749,26 @@ the \PName{key} \PValue{counterwithin} defines a counter the heading number
depends on, the output of the counter will be prefixed by the output of that
counter followed by a dot.
+Beside\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} the section-like command, a command for corresponding
+entries to the table of contents is defined also. This is done using package
+\Package{tocbasic}\important{\Package{tocbasic}}\IndexPackage{tocbasic}.
+Attribute \PName{tocstyle} defines the style of those entries. If you set an
+empty \PName{name}, e.\,g., using \OptionValue{tocstyle}{} or
+\OptionValue{tocstyle}{\{\}}, the entry command will not be changed. This is
+important, if you use another package to modify the table of contents. If you
+do not set attribute \PValue{tocstyle} the already configured style will be
+used again.
+
+The\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} different toc-entry styles also have different, additional
+attributes. You can set them here too, if you prefix them with
+\PValue{toc}. For example, you can setup the level of the toc-entries,
+\PValue{level}, using \PValue{toclevel}, the indention, \PValue{indent}, using
+\PValue{tocindent}, or the number width, \PValue{numwidth}, using
+\PValue{tocnumwidth}. For more toc-entry style attributes see
+\autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle}.
+
\begin{Example}
Because of incomprehensible reasons, the headings of \Macro{paragraph}
shouldn't be run-in headings any longer but headings similar to
@@ -791,12 +822,16 @@ with their initial definition. Furthermore, the original definition of
\Class{scrreprt} and \Class{scrbook} use slightly different values.
Some settings of \Macro{chapter} depend on option \Option{headings} (see
-\autoref{sec:maincls.structure},
-\autopageref{desc:maincls.option.headings}). \hyperref[tab:maincls.chapter.skips]{Table~\ref*{tab:maincls.chapter.skips}}
+\autoref{sec:maincls.structure}, \autopageref{desc:maincls.option.headings}).
+\hyperref[tab:maincls.chapter.skips]{Table~\ref*{tab:maincls.chapter.skips}}
shows the default values of these settings. An overview of all settings is
-shown in \autoref{tab:maincls.section.defaults}. Please note, that
-\PValue{1ex} and \Length{baselineskip} depend on the default font size
-of the heading or the table of contents entry.%
+shown in \autoref{tab:maincls.section.defaults}. For more
+information\ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} about the default of the toc-entry
+styles see \autoref{sec:tocbasic.tocstyle}\important{\Package{tocbasic}},
+\autopageref{sec:tocbasic.tocstyle}. Please note, that \PValue{1ex} and
+\Length{baselineskip} depend on the default font size of the heading or the
+table of contents entry.%
%
\begin{table}
\centering
@@ -870,7 +905,9 @@ of the heading or the table of contents entry.%
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
\PValue{tocindent} & \PValue{0pt} \\
+ \PValue{toclevel} & -1 \\
\PValue{tocnumwidth} & \PValue{2em} \\
+ \PValue{tocstyle} & \PValue{part} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -890,7 +927,9 @@ of the heading or the table of contents entry.%
\autoref{tab:maincls.structureElementsFont},
\autopageref{tab:maincls.structureElementsFont} \\
\PValue{tocindent} & \PValue{0pt} \\
+ \PValue{toclevel} & 0 \\
\PValue{tocnumwidth} & \PValue{1.5em} \\
+ \PValue{tocstyle} & \PValue{chapter} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -907,7 +946,9 @@ of the heading or the table of contents entry.%
\PValue{indent} & \PValue{0pt} \\
\PValue{level} & 1 \\
\PValue{tocindent} & \PValue{1.5em}\\
+ \PValue{toclevel} & 1 \\
\PValue{tocnumwidth} & \PValue{2.3em}\\
+ \PValue{tocstyle} & \PValue{section} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -924,7 +965,9 @@ of the heading or the table of contents entry.%
\PValue{indent} & \PValue{0pt} \\
\PValue{level} & 2 \\
\PValue{tocindent} & \PValue{3.8em}\\
+ \PValue{toclevel} & 2 \\
\PValue{tocnumwidth} & \PValue{3.2em}\\
+ \PValue{tocstyle} & \PValue{section} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -942,6 +985,8 @@ of the heading or the table of contents entry.%
\PValue{level} & 3 \\
\PValue{tocindent} & \PValue{7.0em}\\
\PValue{tocnumwidth} & \PValue{4.1em}\\
+ \PValue{toclevel} & 3 \\
+ \PValue{tocstyle} & \PValue{section} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -958,7 +1003,9 @@ of the heading or the table of contents entry.%
\PValue{indent} & \PValue{0pt} \\
\PValue{level} & 4 \\
\PValue{tocindent} & \PValue{10em}\\
+ \PValue{toclevel} & 4 \\
\PValue{tocnumwidth} & \PValue{5em}\\
+ \PValue{tocstyle} & \PValue{section} \\
\bottomrule
\end{tabularx} \\
\addlinespace[\normalbaselineskip]
@@ -975,7 +1022,9 @@ of the heading or the table of contents entry.%
\PValue{indent} & \Macro{scr@parindent} \\
\PValue{level} & 5 \\
\PValue{tocindent} & \PValue{12em}\\
+ \PValue{toclevel} & 5 \\
\PValue{tocnumwidth} & \PValue{6em}\\
+ \PValue{tocstyle} & \PValue{section} \\
\bottomrule
\end{tabularx}
\end{longtable}
@@ -1064,7 +1113,7 @@ already part of the default of \Macro{partheadendvskip} in
\Class{scrreprt}} is used to produce the empty page after the part heading
page of \Class{scrbook} and \Class{scrreprt}.
-Since \KOMAScript~3.15\ChangedAt{3.15}{\Class{scrbook}\and
+Since \KOMAScript~3.15\ChangedAt{v3.15}{\Class{scrbook}\and
\Class{scrreprt}\and \Class{scrartcl}} the defaults of these seven commands
are independent from option \Option{headings} (see
\autoref{sec:maincls.structure},