summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-04-24 23:19:31 +0000
committerKarl Berry <karl@freefriends.org>2015-04-24 23:19:31 +0000
commit0a00b3b492fd27dc12cddae602b2c43206a17d74 (patch)
tree40a09bf2208cc13bcd727626e1ee058e2caa68b1 /Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
parent77b150bbd42aa48ba71627e09763785b26adfcfd (diff)
koma-script (24apr15)
git-svn-id: svn://tug.org/texlive/trunk@37036 c570f23f-e606-0410-a88d-b1316a301751
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.tex913
1 files changed, 626 insertions, 287 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 705b4d248d4..00f2b232365 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
@@ -48,13 +48,13 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle-experts.tex}
- [$Date: 2015-02-07 14:34:46 +0100 (Sat, 07 Feb 2015) $
+ [$Date: 2015-04-04 11:18:50 +0200 (Sat, 04 Apr 2015) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
\translator{Gernot Hassenpflug\and Markus Kohm}
-% Date of the translated German file: 2015/02/07
+% Date of the translated German file: 2015-04-04
\chapter{Additional Information about the Main Classes \Class{scrbook},
@@ -78,24 +78,26 @@ with a sans serif font. You should not use them any longer.
\LoadNonFree{scrbookreportarticle-experts}{0}
\section{Additional Information to User Commands}
-\label{sec:maincls-experts.addInfos}
+\seclabel{addInfos}
\LoadNonFree{scrbookreportarticle-experts}{1}
\section{Cooperation and Coexistence of \KOMAScript{} and Other Packages}
-\label{sec:maincls-experts.coexistence}
+\seclabel{coexistence}
\LoadNonFree{scrbookreportarticle-experts}{2}
\section{Expert Commands}
-\label{sec:maincls-experts.experts}
+\seclabel{experts}
This sections described commands, that are more or less out of average user's
interest. Nevertheless these commands provide additional features for
experts. Because the information is addressed to experts it's condensed.
+% \subsection{Identification}
+% \seclabel{identification}
\begin{Declaration}
\Macro{KOMAClassName}\\
@@ -118,6 +120,9 @@ may also define the \KOMAScript{} word mark with this name.%
\EndIndex{Cmd}{ClassName}%
\EndIndex{Cmd}{KOMAClassName}%
+% \subsection{Entries to the Table of Contents}
+% \seclabel{toc}
+
\begin{Declaration}
\Macro{addtocentrydefault}\Parameter{level}\Parameter{number}%
\Parameter{heading}
@@ -213,6 +218,25 @@ arguments through.%
\EndIndex{Cmd}{addparttocentry}%
\begin{Declaration}
+ \Macro{raggedchapterentry}
+\end{Declaration}
+\BeginIndex{Cmd}{raggedchapterentry}%
+Command \Macro{raggedchapterentry} currently only provides for printing
+chapter entries at the table of contents justified or left-aligned. Default is
+an empty definition with justified results. For left-aligned the command has
+to be redefined to be
+\Macro{raggedright}\important{\Macro{raggedright}}\IndexCmd{raggedright}. See
+also the limitation note in \autoref{sec:maincls-experts.coexistence},
+\autopageref{desc:maincls-experts.cmd.raggedsection}. Other definitions are
+not recommended!%
+%
+\EndIndex{Cmd}{raggedchapterentry}
+
+% \subsection{Font Settings}
+% \seclabel{fonts}
+
+
+\begin{Declaration}
\Macro{@fontsizefilebase}
\end{Declaration}
\BeginIndex{Cmd}{@fontsizefilebase}%
@@ -269,6 +293,55 @@ itself defines a lot of \PName{alias name}s for several \PName{element}s.
\EndIndex{Cmd}{newkomafont}%
\begin{Declaration}
+ \Macro{addtokomafontrelaxlist}\Parameter{macro}
+\end{Declaration}
+\BeginIndex{Cmd}{addtokomafontrelaxlist}%
+As already mentioned in \autoref{part:forAuthors} of this manual, font
+settings of elements should consist only in commands to select the size, family,
+coding, series, shape, or colour. At least changing the colour is not always
+transparent in \LaTeX{} and therefore could result in unwanted effects if
+someone uses \Macro{usekomafont} at an inappropriate state.
+
+Users tend to use different, somehow critical things in the font setting of an
+element, e.\,g., \Macro{MakeUppercase} at the very end of the setting. As long
+as possible, the internal usage of font settings has been implemented so that
+such forbidden settings do not matter. Even using a command that expects an
+argument, e.\,g., \Macro{textbf} instead of \Macro{bfseries}, would work
+mostly, if it the last one in the font setting of an element\,---\,but without
+warranty.
+
+Inside \KOMAScript, sometimes, it was necessary to restrict the font change
+to real font settings. This has been done, e.\,g., using
+\Macro{usefontofkomafont}%
+\IndexCmd{usefontofkomafont}%
+\IndexCmd{usesizeofkomafont}\IndexCmd{useencodingofkomafont}%
+\IndexCmd{usefamilyofkomafont}\IndexCmd{useseriesofkomafont}%
+\IndexCmd{useshapeofkomafont} instead of \Macro{usekomafont} (see
+\autoref{sec:maincls.textmarkup},
+\autopageref{desc:maincls.cmd.usefontofkomafont}).
+
+Nevertheless, command \Macro{usefontofkomafont} and it's siblings have some
+limitations. Therefore you must not use a command that always needs a fully
+expandable argument inside the font setting of an element. But this is exactly
+what \Macro{MakeUppercase}
+needs. Therefore\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \KOMAScript{} holds a list of macros, which should become
+\Macro{relax} inside \Macro{usefontofkomafont} and it's siblings. Amongst
+others, \Macro{color}, \Macro{normalcolor}, \Macro{MakeUppercase}, and
+\Macro{MakeLowercase} are part of that list. More macros can be added one by
+one using \Macro{addtokomafontrelaxlist}.
+
+Note that \PName{macro} will be set simply to \Macro{relax}. So if
+\PName{macro} really has an argument, the argument will be execute
+locally. Therefore you must not add commands like \Macro{setlength} to the
+list. The user himself is responsible for all errors resulting in the usage of
+\Macro{addtokomafontrelaxlist}. Additionally this command should not be
+misunderstood as a legitimation for adding all kind of commands to the font
+setting of an element!%
+\EndIndex{Cmd}{addtokomafontrelaxlist}%
+
+
+\begin{Declaration}
\Macro{IfExistskomafont}\Parameter{element}\Parameter{then code}%
\Parameter{else code}
\end{Declaration}
@@ -284,6 +357,8 @@ or \Macro{aliaskomafont} and therefore can be changed using
code}.%
\EndIndex{Cmd}{IfExistskomafont}%
+% \subsubsection{Paragraph Indention or Gap}
+% \seclabel{parskip}
\begin{Declaration}
\Macro{setparsizes}\Parameter{indent}\Parameter{distance}%^^A
@@ -308,194 +383,29 @@ settings of paragraph indent and distance between paragraphs, usage of
\begin{lstcode}[belowskip=\dp\strutbox plus 1ex]
\setlength{\parfillskip}{0pt plus 1fil}
\end{lstcode}
-would be recommended.%
+would be recommended.
+
+Since \KOMAScript~3.17\ChangedAt{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} changing or
+reactivation\IndexCmd{activateareas} of the typing area or the margins (see
+\autoref{cha:typearea}) will also reactivate the values of \Macro{setparsizes}
+if they have not been changed since the last usage of this command. This is
+one more reason not to change these values without using \KOMAScript. With
+compatibility to a \KOMAScript{} version prior to 3.17 (see
+\autoref{sec:maincls.compatibilityOptions},
+\autopageref{desc:maincls.option.version}, option
+\Option{version}\IndexOption{version}\important{\OptionValue{version}{3.17}})
+this reactivation of the \Macro{setparsizes} values is deactivated.%
%
\EndIndex{Cmd}{setparsizes}%
-\begin{Declaration}
- \Macro{raggedchapterentry}
-\end{Declaration}
-\BeginIndex{Cmd}{raggedchapterentry}%
-This command is not really comparable with commands like
-\Macro{raggedsection}. In opposite to those commands, that provide to print
-corresponding elements either justified or right- or left-aligned or centered,
-\Macro{raggedchapterentry} currently only provides to print chapter entries at
-the table of contents justified or left-aligned. Default is justified. For
-left-aligned the command has to be redefined to be
-\Macro{raggedright}\important{\Macro{raggedright}}\IndexCmd{raggedright}. See
-also the limitation note in \autoref{sec:maincls-experts.coexistence},
-\autopageref{desc:maincls-experts.cmd.raggedsection} for this.%
-%
-\EndIndex{Cmd}{raggedchapterentry}
+% \subsection{Counters}
+% \seclabel{counter}
\LoadNonFree{scrbookreportarticle-experts}{3}
-\begin{Declaration}
- \Macro{chapterheadstartvskip}\\
- \Macro{chapterheadmidvskip}\\
- \Macro{chapterheadendvskip}\\
- \Macro{partheadstartvskip}\\
- \Macro{partheadmidvskip}\\
- \Macro{partheadendvskip}\\
- \Macro{partheademptypage}
-\end{Declaration}
-\BeginIndex{Cmd}{chapterheadstartvskip}%
-\BeginIndex{Cmd}{chapterheadmidvskip}%
-\BeginIndex{Cmd}{chapterheadendvskip}%
-\BeginIndex{Cmd}{partheadstartvskip}%
-\BeginIndex{Cmd}{partheadmidvskip}%
-\BeginIndex{Cmd}{partheadendvskip}%
-\BeginIndex{Cmd}{partheademptypage}%
-These\important[i]{\Macro{chapter}\\
- \Macro{part}\\
- \Macro{addchap}\\
- \Macro{addpart}} are used inside of the definition of the headings
-\Macro{chapter}\IndexCmd{chapter}, \Macro{part}, \Macro{addchap},
-\Macro{addpart} and their star-variations. Thereby
-\Macro{chapterheadstartvskip} is designed to be a command, that inserts
-vertical distance before the chapter heading. Analogues
-\Macro{chapterheadendvskip} is designed to be a command, that inserts vertical
-distance after the chapter heading. If\ChangedAt{v3.15}{\Class{scrbook}\and
- \Class{scrreprt}} the chapter heading has a prefix number line (see option
-\Option{chapterprefix} in \autoref{sec:maincls.structure},
-\autopageref{desc:maincls.option.chapterprefix}) \Macro{chapterheadmidvskip}
-will be used between the number line and the heading text.
-Vertical distance above and below part headings will be inserted using the
-commands \Macro{partheadstartvskip} and \Macro{partheadendvskip}. A page break
-would be interpreted to be part of the vertical distance and therefor is
-already part of the default of \Macro{partheadendvskip} in
-\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
-\Class{scrreprt}. Command
-\Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and
- \Class{scrreprt}} is used to produce the empty page after the part heading
-page of \Class{scrbook} and \Class{scrreprt}.
-
-The \Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
-\Class{scrreprt} default of the seven commands are listed in
-\autoref{tab:maincls-experts.headvskip} and
-\autoref{tab:maincls-experts.headvskip2}. The
-\Class{scrartcl}\OnlyAt{\Class{scrartcl}} defaults of the three at this class
-defined commands are listed in
-\autoref{tab:maincls-experts.headvskip3}. An\textnote{Example!} example, that
-redefines \Macro{chapterheadstartvskip} and \Macro{chapterheadendvskip} to
-print extra rules above and below the chapter heading, may be found at
-\cite{homepage} (in German).%
-%
-\begin{table}
- \centering
-% \KOMAoptions{captions=topbeside}%
-% \setcapindent{0pt}%
- \caption
-% \begin{captionbeside}
- {%
- defaults of the commands for the vertical distances of chapter headings
- with \Class{scrbook} and \Class{scrreprt}%
- }%
-% [l]
- \begin{tabular}{ll}
- \multicolumn{2}{@{}l}{\bfseries Mit \OptionValue{headings}{big}:}\\
- \toprule
- command & default definition \\
- \midrule
- \Macro{chapterheadstartvskip} &
- \Macro{vspace*}\PParameter{2.3\Macro{baselineskip}} \\
- \Macro{chapterheadmidvskip} &
- \Macro{par}\Macro{nobreak}\Macro{vskip.5}\Macro{baselineskip} \\
- \Macro{chapterheadendvskip} &
- \Macro{vspace*}\texttt{\{1.725\Macro{baselineskip}} \\ & \quad
- \texttt{plus .115\Macro{baselineskip}} % \\ & \quad
- \texttt{minus .192\Macro{baselineskip}\}} \\
- \bottomrule\\
- \multicolumn{2}{@{}l}{\bfseries Mit \OptionValue{headings}{normal}:}\\
- \toprule
- command & default definition \\
- \midrule
- \Macro{chapterheadstartvskip} &
- \Macro{vspace*}\PParameter{2\Macro{baselineskip}} \\
- \Macro{chapterheadmidvskip} &
- \Macro{par}\Macro{nobreak}\Macro{vskip.5}\Macro{baselineskip} \\
- \Macro{chapterheadendvskip} &
- \Macro{vspace*}\texttt{\{1.5\Macro{baselineskip}}\\ & \quad
- \texttt{plus .1\Macro{baselineskip}} % \\ & \quad
- \texttt{minus .167\Macro{baselineskip}\}} \\
- \bottomrule\\
- \multicolumn{2}{@{}l}{\bfseries Mit \OptionValue{headings}{small}:}\\
- \toprule
- command & default definition \\
- \midrule
- \Macro{chapterheadstartvskip} &
- \Macro{vspace*}\PParameter{1.8\Macro{baselineskip}} \\
- \Macro{chapterheadmidvskip} &
- \Macro{par}\Macro{nobreak}\Macro{vskip.5}\Macro{baselineskip} \\
- \Macro{chapterheadendvskip} &
- \Macro{vspace*}\texttt{\{1.35\Macro{baselineskip}}\\ & \quad
- \texttt{plus .09\Macro{baselineskip}} % \\ & \quad
- \texttt{minus .15\Macro{baselineskip}\}} \\
- \bottomrule\\
- \end{tabular}
-% \end{captionbeside}
- \label{tab:maincls-experts.headvskip}%
-\end{table}
-%
-\begin{table}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}
- {%
- defaults of the commands for the vertical distances of part headings
- with \Class{scrbook} and \Class{scrreprt}%
- }[l]
- \begin{tabular}[t]{ll}
- \toprule
- command & default definition \\
- \midrule
- \Macro{partheadstartvskip} & \Macro{null}\Macro{vfil} \\
- \Macro{partheadmidvskip} & \Macro{par}\Macro{nobreak}\Macro{vskip} \texttt{20pt}\\
- \Macro{partheadendvskip} & \Macro{vfil}\Macro{newpage} \\
- \Macro{partheademptypage} & \Macro{if@twoside}\Macro{if@openright} \\ &
- \quad\Macro{null}\Macro{thispagestyle}\PParameter{empty}\texttt{\%}\\ &
- \quad\Macro{newpage}\\&
- \Macro{fi}\Macro{fi}\\
- \bottomrule
- \end{tabular}
- \end{captionbeside}
- \label{tab:maincls-experts.headvskip2}%
-\end{table}%
-%
-\begin{table}
-% \centering
- \KOMAoptions{captions=topbeside}%
- \setcapindent{0pt}%
-% \caption
- \begin{captionbeside}
- {%
- defaults of the commands for the vertical distances of part headings
- with \Class{scrartcl}%
- }[l]
- \begin{tabular}[t]{ll}
- \toprule
- command & default definition \\
- \midrule
- \Macro{partheadstartvskip} & \Macro{addvspace}\PParameter{4ex} \\
- \Macro{partheadmidvskip} & \Macro{par}\Macro{nobreak}\\
- \Macro{partheadendvskip} & \Macro{vskip} \texttt{3ex}\\
- \bottomrule
- \end{tabular}
- \end{captionbeside}
- \label{tab:maincls-experts.headvskip3}%
-\end{table}%
-%
-\EndIndex{Cmd}{partheademptypage}%
-\EndIndex{Cmd}{partheadendvskip}%
-\EndIndex{Cmd}{partheadmidvskip}%
-\EndIndex{Cmd}{partheadstartvskip}%
-\EndIndex{Cmd}{chapterheadendvskip}%
-\EndIndex{Cmd}{chapterheadmidvskip}%
-\EndIndex{Cmd}{chapterheadstartvskip}%
-
-\iffree{\clearpage}{}% Umbruchkorrektur
+% \subsubsection{Sections}
+% \seclabel{sections}
\begin{Declaration}
\Macro{DeclareSectionCommand}\OParameter{attributes}\Parameter{name}\\
@@ -509,46 +419,65 @@ print extra rules above and below the chapter heading, may be found at
\BeginIndex{Cmd}{ProvideSectionCommand}%
With\ChangedAt[2014/11]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} these commands you can either define a new section-like
-command \Macro{\PName{Name}} or change an already defined sectioning command
-\Macro{\PName{Name}}. To do so you use the optional argument to setup several
+command \Macro{\PName{name}} or change an already defined sectioning command
+\Macro{\PName{name}}. To do so you use the optional argument to setup several
\PName{attributes}. The \PName{attributes} are a comma-separated list of
-\PName{key}=\PName{value} assignments.
-\hyperref[tab:maincls-experts.declaresection.keys]{Table~\ref*{tab:maincls-experts.declaresection.keys}}
-describes the available \PName{key}s.
-
-\begin{longtable}[l]{llp{\dimexpr\linewidth-6\tabcolsep-14em}}
- \caption[Attributes at the declaration of section-like commands]{Available
- \PName{key}s and \PName{value}s for the \PName{attributes} declaring a
- section-like command%
- \label{tab:maincls-experts.declaresection.keys}}\\
- \toprule
- \PName{key} & \PName{value} & Description \\
- \midrule
- \endfirsthead
- \caption[]{Attributes at the declaration of section-like commands
- (\emph{Fortsetzung})}\\
- \toprule
- \PName{key} & \PName{value} & description \\
- \midrule
- \endhead
- \midrule
- \multicolumn3r{\dots}\\
- \endfoot
- \bottomrule
- \endlastfoot
- \PValue{afterskip} & \PName{length} & With \PValue{style} \PValue{section}
- a negative value activates a run-in
- heading. The absolute value is the
- skip to leave to right of the run-in
- heading. A positive value is the
- vertical skip below the heading.\\
- \PValue{beforeskip} & \PName{length}& With \PValue{style} \PValue{section}
- the absolute value of the vertical
- skip before the heading. If the
- value is negative, then the
- paragraph indent of the text
- following heading is suppressed
- using that \PValue{style}.\\
+\PName{key}=\PName{value} assignments. Beside the style-independent attributes
+shown in \autoref{tab:maincls-experts.declaresection.keys}, there are style
+dependent attributes, too. Currently the following styles are provided:
+\begin{labeling}{\PValue{chapter}:}
+\item[\PValue{chapter}:] \ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}Style of chapter
+ headings. Currently you cannot define new commands with this style. But you
+ can configure the existing command \Macro{chapter}. To do so you can also
+ use the additional attributes of
+ \autoref{tab:maincls-experts.declarechapterstyle.keys},
+ \autopageref{tab:maincls-experts.declarechapterstyle.keys}.
+ Note\textnote{Attention!} that command \Macro{addchap} and the star variants
+ are configured automatically together with \Macro{chapter} and should not be
+ changed independently. Note that \Class{scrartcl}\OnlyAt{\Class{scrbook}\and
+ \Class{scrreprt}} does not provide this style.
+\item[\PValue{part}:] \ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}Style part headings. Currently you
+ cannot define new commands with this style. But you can configure the
+ existing command \Macro{part}. To do so you can also use the additional
+ attributes of \autoref{tab:maincls-experts.declarepartstyle.keys},
+ \autopageref{tab:maincls-experts.declarepartstyle.keys}.
+ Note\textnote{Attention!} that command \Macro{addpart} and the star variants
+ are configured automatically together with \Macro{part} and should not be
+ changed independently.
+\item[\PValue{section}:] Style of section headings. This style is currently
+ used for \Macro{section}, \Macro{subsection}, \Macro{subsubsection},
+ \Macro{paragraph}, and \Macro{subparagraph}. You can define new section-like
+ commands using this style. To define new or to reconfigure existing commands
+ you can also use the additional attributes of
+ \autoref{tab:maincls-experts.declaresectionstyle.keys},
+ \autopageref{tab:maincls-experts.declaresectionstyle.keys}. Definitions of
+ new commands need at least the \PName{key}s \PValue{style},
+ \PValue{afterskip}, \PValue{beforeskip}, \PValue{font}, \PValue{indent},
+ \PValue{level}, \PValue{tocindent}, and \PValue{tocnumwidth}. This is also
+ true if a command that was not a section-like command before will be
+ redefined as a section-like command using
+ \Macro{RedeclareSectionCommand}. Note\textnote{Attention!} that command
+ \Macro{addsec} and the star variants are configured automatically together
+ with \Macro{section} and should not be changed independently. Defining a new
+ section-like command with this style will also define an element with the
+ same \PName{name} and the possibility to change its font using
+ \Macro{setkomafont} or \Macro{addtokomafont} (see
+ \autoref{sec:maincls.textmarkup},
+ \autopageref{desc:maincls.cmd.setkomafont}), if such an element does not
+ already exist.
+\end{labeling}
+
+\begin{table}
+ \caption[{Style-independent attributes at the declaration of section-like
+ commands}]{Available \PName{key}s and \PName{value}s for the
+ style-independent \PName{attributes} declaring a section-like command}%
+ \label{tab:maincls-experts.declaresection.keys}%
+ \begin{tabularx}{\linewidth}{llX}
+ \toprule
+ \PName{key} & \PName{value} & Description \\
+ \midrule
\PValue{counterwithin} & \PName{counter name} &
The value of the counter of the
heading should depend on
@@ -562,24 +491,25 @@ describes the available \PName{key}s.
be prefixed by
\Macro{the\PName{counter name}}
followed by a dot.\\
- \PValue{font} & \PName{font commands} &
- The initial font setting, that
- should be used beside
- \FontElement{disposition} for the
- heading. You can use all settings,
- that are allowed for
- \Macro{setkomafont} and
- \Macro{addtokomafont} for the
- element of the heading.\\
- \PValue{indent} & \PName{length} & Indentation of heading from the left
- margin.\\
+ \PValue{expandtopt} & \PName{switch}& If the switch is on, all following
+ values for lengths will be
+ completely expanded, evaluated and
+ stored as \texttt{pt} values.
+ If the switch is off, all following
+ values for lengths will be
+ completely expanded, tentatively
+ evaluated but only expanded stored.
+ Any values from
+ \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch}
+ may be used. Default is
+ \PValue{false}.\\
\PValue{level} & \PName{integer} & A number, denoting depth of section
(see counter \Counter{secnumdepth};
\autoref{desc:maincls.counter.secnumdepth});
the value should be unique.\\
\PValue{style} & \PName{name} & Defines the style of the
- heading. Currently only style
- \PValue{section} is provided.\\
+ heading.\\
\PValue{tocindent} & \PName{length} & Total indentation from the left
margin of the entry in the table of
contents corresponding to this
@@ -600,19 +530,137 @@ describes the available \PName{key}s.
\PValue{tocnumwidth} & \PName{length} &
Width of the box for the number of
the entry in the table of contents.\\
-\end{longtable}
+ \bottomrule
+ \end{tabularx}
+\end{table}
+
+\begin{table}
+ \caption[{Attributes of the style \PValue{section} declaring a section-like
+ command}]{Additional \PName{keys} and \PName{value}s of attributes
+ declaring a section-like command with style \PValue{section}}%
+ \label{tab:maincls-experts.declaresectionstyle.keys}%
+ \begin{tabularx}{\linewidth}{llX}
+ \toprule
+ \PName{key} & \PName{value} & Description \\
+ \midrule
+ \PValue{afterskip} & \PName{length} & A negative value activates a run-in
+ heading. The absolute value is the
+ skip to leave to right of the run-in
+ heading. A positive value is the
+ vertical skip below the heading.\\
+ \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
+ skip before the heading. If the
+ value is negative, then the
+ paragraph indent of the text
+ following the heading is
+ suppressed.\\
+ \PValue{font} & \PName{font commands} &
+ The initial font setting that
+ should be used beside
+ \FontElement{disposition} for the
+ heading. You can use all settings,
+ that are allowed for
+ \Macro{setkomafont} and
+ \Macro{addtokomafont} for the
+ element of the heading.\\
+ \PValue{indent} & \PName{length} & Indentation of heading from the left
+ margin.\\
+ \bottomrule
+ \end{tabularx}
+\end{table}
+
+\begin{table}
+ \caption[{Attributes of the style \PValue{chapter} declaring a section-like
+ command}]{Additional \PName{keys} and \PName{value}s of attributes
+ declaring a section-like command with style \PValue{chapter}}%
+ \label{tab:maincls-experts.declarechapterstyle.keys}%
+ \begin{tabularx}{\linewidth}{llX}
+ \toprule
+ \PName{key} & \PName{value} & Description \\
+ \midrule
+ \PValue{afterskip} & \PName{length} & The absolute value is the
+ vertical skip below the heading.\\
+ \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
+ skip before the heading. If the
+ value is negative, then the
+ paragraph indent of the text
+ following the heading is
+ suppressed.\\
+ \PValue{font} & \PName{font commands} &
+ The initial font setting that
+ should be used beside
+ \FontElement{disposition} for the
+ heading. You can use all settings,
+ that are allowed for
+ \Macro{setkomafont} and
+ \Macro{addtokomafont} for the
+ element of the heading.\\
+ \PValue{innerskip} & \PName{length} & The vertical skip between the prefix
+ line and the heading's text, if a
+ prefix line is used.\\
+ \PValue{prefixfont} & \PName{font commands} &
+ The initial font setting that
+ should be used beside
+ \FontElement{disposition} and the
+ element of the heading for the
+ prefix line of the heading. You can
+ use all settings that are allowed
+ for \Macro{setkomafont} and
+ \Macro{addtokomafont} for the
+ element of the prefix line.\\
+ \bottomrule
+ \end{tabularx}
+\end{table}
-The \PName{key}s \PValue{afterskip}, \PValue{beforeskip}, \PValue{font},
-\PValue{indent}, \PValue{level}, \PValue{tocindent}, and \PValue{tocnumwidth}
-are mandatory when declaring a new section-like command. This is also true if
-a command that was not a section-like command before will be redefined as a
-section-like command using \Macro{RedeclareSectionCommand}.
+\begin{table}
+ \caption[{Attributes of the style \PValue{part} declaring a section-like
+ command}]{Additional \PName{keys} and \PName{value}s of attributes
+ declaring a section-like command with style \PValue{part}}%
+ \label{tab:maincls-experts.declarepartstyle.keys}%
+ \begin{tabularx}{\linewidth}{llX}
+ \toprule
+ \PName{key} & \PName{value} & Description \\
+ \midrule
+ \PValue{afterskip} & \PName{length} & The absolute value is the
+ vertical skip below the heading.\\
+ \PValue{beforeskip} & \PName{length}& The absolute value of the vertical
+ skip before the heading. If the
+ value is negative, then the
+ paragraph indent of the text
+ following the heading is
+ suppressed.\\
+ \PValue{font} & \PName{font commands} &
+ The initial font setting that
+ should be used beside
+ \FontElement{disposition} for the
+ heading. You can use all settings,
+ that are allowed for
+ \Macro{setkomafont} and
+ \Macro{addtokomafont} for the
+ element of the heading.\\
+ \PValue{innerskip} & \PName{length} & The vertical skip between the prefix
+ line and the heading's text of
+ \Class{scrbook} and
+ \Class{scrreprt}.\\
+ \PValue{prefixfont} & \PName{font commands} &
+ The initial font setting that
+ should be used beside
+ \FontElement{disposition} and the
+ element of the heading for the
+ prefix line of the heading. You can
+ use all settings that are allowed
+ for \Macro{setkomafont} and
+ \Macro{addtokomafont} for the
+ element of the prefix line.\\
+ \bottomrule
+ \end{tabularx}
+\end{table}
\Macro{DeclareNewSectionCommand} defines a new section-like command. If the
same \PName{name} is already used by \TeX{} for something else, the command
will result in an error message and will not define anything.
-\Macro{ProvideSectionSommand} is similar but doesn't show any error message.
+\Macro{ProvideSectionSommand} is similar but does not show any error message.
\Macro{RedeclareSectionCommand} can only change an existing command to a
section-like command with given \PName{attributes}. There is no pre-validation
@@ -625,30 +673,18 @@ command \Macro{\PName{name}} with the given \PName{attributes}.
Every section-like command has also a corresponding counter with the same
\PName{name}, that will be allocated using \Macro{newcounter} if
-necessary. The same rule applies to the corresponding output of the counter
-\Macro{the\PName{name}}, the output format \Macro{\PName{name}format}, the
-command to generate a running head, \Macro{\PName{name}mark}, the counter
-format of the running head, \Macro{\PName{name}markformat}, the font element
-\FontElement{\PName{name}}, and the section depth number,
+necessary. The same rule applies to the corresponding output of the counter:
+\Macro{the\PName{name}}, the output format: \Macro{\PName{name}format}, the
+command to generate a running head: \Macro{\PName{name}mark}, the counter
+format of the running head: \Macro{\PName{name}markformat}, the font element:
+\FontElement{\PName{name}}, and the section depth number:
\Macro{\PName{name}numdepth}. The command for the running head
\Macro{\PName{name}mark} will be defined to not generate any running head. The
-output of the counter, \Macro{the\PName{name}} will show an Arabic number. If
-the \PName{key} \PValue{counterwithin} defines a counter, the heading number
+output of the counter, \Macro{the\PName{name}}, will show an Arabic number. If
+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.
-Please note\textnote{Attention!}: Currently you can define only headings for
-section-like commands depending on \Macro{scr@startsection}. This is the style
-\PValue{section}, that \KOMAScript{} uses for headings from \Macro{section}
-down to \Macro{subparagraph}. Headings with the style of \Macro{part} or
-\Macro{chapter} are not yet supported. Nevertheless, the implementations of
-commands \Macro{part} and \Macro{chapter} support changing attributes using
-\Macro{DeclareSectionCommand} or \Macro{RedeclareSectionCommand}. The
-special headings \Macro{addpart}, \Macro{addchap} and \Macro{addsec} on the
-other hand depend indirectly on \Macro{part}, \Macro{chapter}, and
-\Macro{section}. Therefore they shouldn't be redefined directly using the
-commands described here.
-
\begin{Example}
Because of incomprehensible reasons, the headings of \Macro{paragraph}
shouldn't be run-in headings any longer but headings similar to
@@ -699,7 +735,199 @@ with their initial definition. Furthermore, the original definition of
counterwithin=subsubsection
]{paragraph}
\end{lstcode}
-\Class{scrreprt} and \Class{scrbook} use slightly different values.%
+\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}}
+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.%
+%
+\begin{table}
+ \centering
+ \caption{Defaults of the chapter headings of \Class{scrbook}
+ and \Class{scrreprt} subject to option \Option{headings}}
+ \label{tab:maincls.chapter.skips}
+ \begin{tabular}{ll}
+ \multicolumn{2}{@{}l}{\bfseries With \OptionValue{headings}{big}:}\\
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip}
+ & \PValue{1.725\Length{baselineskip} plus .115\Length{baselineskip}
+ minus .192\Length{baselineskip}} \\
+ \PValue{beforeskip}
+ & \PValue{3.3\Length{baselineskip}+\Length{parskip}} \\
+ \PValue{font} & \Macro{huge} \\
+ \bottomrule\\
+ \multicolumn{2}{@{}l}{\bfseries With \OptionValue{headings}{normal}:}\\
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip}
+ & \PValue{1.5\Length{baselineskip} plus .1\Length{baselineskip}
+ minus .167\Length{baselineskip}} \\
+ \PValue{beforeskip}
+ & \PValue{3\Length{baselineskip}+\Length{parskip}} \\
+ \PValue{font} & \Macro{LARGE} \\
+ \bottomrule\\
+ \multicolumn{2}{@{}l}{\bfseries With \OptionValue{headings}{small}:}\\
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip}
+ & \PValue{1.35\Length{baselineskip} plus .09\Length{baselineskip}
+ minus .15\Length{baselineskip}} \\
+ \PValue{beforeskip}
+ & \PValue{2.8\Length{baselineskip}+\Length{parskip}} \\
+ \PValue{font} & \Macro{Large} \\
+ \bottomrule
+ \end{tabular}
+\end{table}
+
+%begin{table}
+% \centering
+ \begin{longtable}{@{}p{\columnwidth}@{}}
+ \caption{Default of the headings of \Class{scrbook} and
+ \Class{scrreprt}}%
+ \label{tab:maincls.section.defaults}\\
+ \endfirsthead
+ \caption[]{Default of the headings of \Class{scrbook} and
+ \Class{scrreprt} \emph{(Continuation)}}\\
+ \addlinespace[-\normalbaselineskip]
+ \endhead
+ \raggedleft\dots\\
+ \endfoot
+ \endlastfoot
+ \Macro{part}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip} & \PValue{0pt plus 1fil} \\
+ \PValue{beforeskip} & \PValue{0pt plus 1fil + \Length{baselineskip}} \\
+ \PValue{font} & see element \FontElement{part},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{innerskip} & \PValue{20pt} \\
+ \PValue{level} & -1 \\
+ \PValue{prefixfont} & see element \FontElement{partnumber},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{tocindent} & \PValue{0pt} \\
+ \PValue{tocnumwidth} & \PValue{2em} \\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{chapter}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip} & see \autoref{tab:maincls.chapter.skips} \\
+ \PValue{beforeskip} & see \autoref{tab:maincls.chapter.skips} \\
+ \PValue{font} & see element \FontElement{chapter},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{innerskip} & \PValue{0pt} \\
+ \PValue{level} & 0 \\
+ \PValue{prefixfont} & see element \FontElement{chapterprefix},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{tocindent} & \PValue{0pt} \\
+ \PValue{tocnumwidth} & \PValue{1.5em} \\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{section}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule
+ \PValue{afterskip} & \PValue{2.3ex plus .2ex} \\
+ \PValue{beforeskip} & \PValue{-3.5ex plus -1ex minus -.2ex} \\
+ \PValue{font} & see element \FontElement{section},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{indent} & \PValue{0pt} \\
+ \PValue{level} & 1 \\
+ \PValue{tocindent} & \PValue{1.5em}\\
+ \PValue{tocnumwidth} & \PValue{2.3em}\\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{subsection}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule\nopagebreak
+ \PValue{afterskip} & \PValue{1.5ex plus .2ex} \\
+ \PValue{beforeskip} & \PValue{-3.25ex plus -1ex minus -.2ex} \\
+ \PValue{font} & see element \FontElement{subsection},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{indent} & \PValue{0pt} \\
+ \PValue{level} & 2 \\
+ \PValue{tocindent} & \PValue{3.8em}\\
+ \PValue{tocnumwidth} & \PValue{3.2em}\\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{subsubsection}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule\nopagebreak
+ \PValue{afterskip} & \PValue{1.5ex plus .2ex} \\
+ \PValue{beforeskip} & \PValue{-3.25ex plus -1ex minus -.2ex} \\
+ \PValue{font} & see element \FontElement{subsubsection},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{indent} & \PValue{0pt} \\
+ \PValue{level} & 3 \\
+ \PValue{tocindent} & \PValue{7.0em}\\
+ \PValue{tocnumwidth} & \PValue{4.1em}\\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{paragraph}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule\nopagebreak
+ \PValue{afterskip} & \PValue{-1em} \\
+ \PValue{beforeskip} & \PValue{3.25ex plus 1ex minus .2ex} \\
+ \PValue{font} & see element \FontElement{paragraph},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{indent} & \PValue{0pt} \\
+ \PValue{level} & 4 \\
+ \PValue{tocindent} & \PValue{10em}\\
+ \PValue{tocnumwidth} & \PValue{5em}\\
+ \bottomrule
+ \end{tabularx} \\
+ \addlinespace[\normalbaselineskip]
+ \Macro{subparagraph}: \\*
+ \begin{tabularx}{\linewidth}{ll}
+ \toprule
+ Attribute & Default Value \\
+ \midrule\nopagebreak
+ \PValue{afterskip} & \PValue{-1em} \\
+ \PValue{beforeskip} & \PValue{3.25ex plus 1ex minus .2ex} \\
+ \PValue{font} & see element \FontElement{subparagraph},
+ \autoref{tab:maincls.structureElementsFont},
+ \autopageref{tab:maincls.structureElementsFont} \\
+ \PValue{indent} & \Macro{scr@parindent} \\
+ \PValue{level} & 5 \\
+ \PValue{tocindent} & \PValue{12em}\\
+ \PValue{tocnumwidth} & \PValue{6em}\\
+ \bottomrule
+ \end{tabularx}
+ \end{longtable}
+%end{table}
+%
\EndIndex{Cmd}{ProvideSectionCommand}%
\EndIndex{Cmd}{RedeclareSectionCommand}%
\EndIndex{Cmd}{DeclareNewSectionCommand}%
@@ -742,6 +970,126 @@ will be increased by the value of \PValue{increaselevel}. If attribute
\EndIndex{Cmd}{DeclareNewSectionCommands}%
\EndIndex{Cmd}{DeclareSectionCommands}%
+\begin{Declaration}
+ \Macro{chapterheadstartvskip}\\
+ \Macro{chapterheadmidvskip}\\
+ \Macro{chapterheadendvskip}\\
+ \Macro{partheadstartvskip}\\
+ \Macro{partheadmidvskip}\\
+ \Macro{partheadendvskip}\\
+ \Macro{partheademptypage}
+\end{Declaration}
+\BeginIndex{Cmd}{chapterheadstartvskip}%
+\BeginIndex{Cmd}{chapterheadmidvskip}%
+\BeginIndex{Cmd}{chapterheadendvskip}%
+\BeginIndex{Cmd}{partheadstartvskip}%
+\BeginIndex{Cmd}{partheadmidvskip}%
+\BeginIndex{Cmd}{partheadendvskip}%
+\BeginIndex{Cmd}{partheademptypage}%
+These\important[i]{\Macro{chapter}\\
+ \Macro{part}\\
+ \Macro{addchap}\\
+ \Macro{addpart}} commands are used inside of the definition of the headings
+\Macro{chapter}\IndexCmd{chapter}, \Macro{part}, \Macro{addchap},
+\Macro{addpart} and their star-variations. Thereby
+\Macro{chapterheadstartvskip} is designed to be a command, that inserts a
+vertical distance before the chapter heading. Analogues
+\Macro{chapterheadendvskip} is designed to be a command, that inserts a vertical
+distance after the chapter heading. If\ChangedAt{v3.15}{\Class{scrbook}\and
+ \Class{scrreprt}} the chapter heading has a prefix number line (see option
+\Option{chapterprefix} in \autoref{sec:maincls.structure},
+\autopageref{desc:maincls.option.chapterprefix}), \Macro{chapterheadmidvskip}
+will be used between the number line and the heading text.
+
+Vertical distance above and below part headings will be inserted using the
+commands \Macro{partheadstartvskip} and \Macro{partheadendvskip}. A page break
+would be interpreted to be part of the vertical distance and therefore is
+already part of the default of \Macro{partheadendvskip} in
+\Class{scrbook}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} and
+\Class{scrreprt}. Command
+\Macro{partheademptypage}\ChangedAt{v3.02}{\Class{scrbook}\and
+ \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
+ \Class{scrreprt}\and \Class{scrartcl}} the defaults of these seven commands
+are independent from option \Option{headings} (see
+\autoref{sec:maincls.structure},
+\autopageref{desc:maincls.option.headings}). The original definitions of the
+chapter heading reads since
+\KOMAScript~3.157\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}:\IndexLength{@tempskipa}
+\begin{lstcode}
+ \newcommand*{\chapterheadstartvskip}{\vspace{\@tempskipa}}
+ \newcommand*{\chapterheadmidvskip}{\par\nobreak\vskip\@tempskipa}
+ \newcommand*{\chapterheadendvskip}{\vskip\@tempskipa}
+\end{lstcode}
+Every usage of \OptionValue{headings}{big}\IndexOption{headings},
+\OptionValue{headings}{normal}, or \OptionValue{headings}{small} reactivates
+these default definitions.
+
+Command \Macro{chapter} automatically sets the internal length
+\Length{@tempskipa} to the value of the
+\Macro{DeclareSectionCommand}\IndexCmd{DeclareSectionCommand} attribute
+\PValue{beforeskip} before calling
+\Macro{chapterheadstartvskip}. Correspondingly it sets the length to the value
+of attribute \PValue{afterskip} before calling \Macro{chapterheadendvskip} and
+\PValue{innerskip} before calling \Macro{chapterheadmidvskip}. If you redefine
+\Macro{chapterheadstartvskip}, \Macro{chapterheadmidvskip}, or
+\Macro{chapterheadendvskip} you should also correspond the new definition to
+\Length{@tempskipa} to respect the values of \Macro{DeclareSectionCommand}.
+
+The default values of the distances of \Macro{part} do not depend on option
+\Option{headings}. So the corresponding commands will not be redefined using
+the options. The\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} original definitions of these commands of \Class{scrbook}
+and \Class{scrreprt} read:
+\begin{lstcode}
+ \newcommand*{\partheadstartvskip}{%
+ \null\vskip-\baselineskip\vskip\@tempskipa
+ }
+ \newcommand*{\partheadmidvskip}{%
+ \par\nobreak
+ \vskip\@tempskipa
+ }
+ \newcommand*{\partheadendvskip}{%
+ \vskip\@tempskipa\newpage
+ }
+\end{lstcode}
+and of \Class{scrartcl}:
+\begin{lstcode}
+ \newcommand*{\partheadstartvskip}{%
+ \addvspace{\@tempskipa}%
+ }
+ \newcommand*{\partheadmidvskip}{%
+ \par\nobreak
+ }
+ \newcommand*{\partheadendvskip}{%
+ \vskip\@tempskipa
+ }
+\end{lstcode}
+Again \Macro{part} sets \Length{@tempskipa}\IndexLength{@tempskipa} to the
+values of \Macro{DeclareSectionCommand}\IndexCmd{DeclareSectionCommand} before
+the internal usage of the command.
+
+It\ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} is not recommended to redefine the command for the
+distances above or below the headings only for changing these distances,
+because you can reconfigure these distances much easier using
+\Macro{RedeclareSectionCommand}. Redefinition of the commands should be
+reserved to more complex changes. An\textnote{Example!} example that
+redefines \Macro{chapterheadstartvskip} and \Macro{chapterheadendvskip} to
+print extra rules above and below the chapter heading may be found at
+\cite{homepage} (in German).%
+%
+\EndIndex{Cmd}{partheademptypage}%
+\EndIndex{Cmd}{partheadendvskip}%
+\EndIndex{Cmd}{partheadmidvskip}%
+\EndIndex{Cmd}{partheadstartvskip}%
+\EndIndex{Cmd}{chapterheadendvskip}%
+\EndIndex{Cmd}{chapterheadmidvskip}%
+\EndIndex{Cmd}{chapterheadstartvskip}%
+
\begin{Declaration}
\Macro{SecDef}\Parameter{star command}\Parameter{command}\\
@@ -814,6 +1162,9 @@ The commands \Macro{At@startsection}, \Macro{Before@sect}, and
\EndIndex{Cmd}{Before@ssect}%
\EndIndex{Cmd}{At@startsection}%
+% \subsection{Appendix}
+% \seclabel{appendix}
+
\begin{Declaration}
\Macro{appendixmore}
@@ -860,32 +1211,15 @@ prevent you from disabling options without noticing it.
intended with the option.
It is also possible to get a similar behaviour of the appendix for
- the class \Class{scrartcl}. You would write in the preamble of your
+ the class \Class{scrartcl}. You can write in the preamble of your
document:
\begin{lstcode}[moretexcs={ifthenelse,equal}]
\newcommand*{\appendixmore}{%
- \renewcommand*{\othersectionlevelsformat}[3]{%
- \ifthenelse{\equal{##1}{section}}{%
- \appendixname~}{}%
- ##3\autodot\enskip}
+ \renewcommand*{\sectionformat}{%
+ \appendixname~\thesection\autodot\enskip}%
\renewcommand*{\sectionmarkformat}{%
\appendixname~\thesection\autodot\enskip}}
\end{lstcode}
- In addition, the package \Package{ifthen}\IndexPackage{ifthen} (see
- \cite{package:ifthen}) is required.
-
- An alternative implementation would be:
-\begin{lstcode}
- \newcommand*{\appendixmore}{%
- \renewcommand*{\othersectionlevelsformat}[3]{%
- \ifstr{##1}{section}{\appendixname~}{}%
- ##3\autodot\enskip}
- \renewcommand*{\sectionmarkformat}{%
- \appendixname~\thesection\autodot\enskip}}
-\end{lstcode}
- Thereby used command \Macro{ifstr}\IndexCmd[indexmain]{ifstr} is provided by
- \KOMAScript{}. See \autoref{sec:scrbase.if},
- \autopageref{desc:scrbase.cmd.ifstr}.
Redefined commands are explained in more detail in
\autoref{sec:maincls.structure},
@@ -896,6 +1230,9 @@ prevent you from disabling options without noticing it.
\EndIndex{Cmd}{appendixmore}%
+% \subsection{Literaturverzeichnis}
+% \seclabel{bibliography}
+
\begin{Declaration}
\Macro{newbibstyle}\OParameter{parent style}\Parameter{name}%^^A
\Parameter{instructions}\\
@@ -994,7 +1331,7 @@ as usual.%
\section{More or Less Obsolete Options and Commands}
-\label{sec:maincls-experts.obsolete}
+\seclabel{obsolete}
\LoadNonFree{scrbookreportarticle-experts}{4}
@@ -1007,3 +1344,5 @@ as usual.%
%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End:
+
+% LocalWords: Amongst legitimation