diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex | 61 |
1 files changed, 36 insertions, 25 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex index 446e8fedd1a..36681ff6093 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex @@ -46,10 +46,10 @@ % ====================================================================== \KOMAProvidesFile{tocbasic.tex} - [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2018-08-31 09:11:20 +0200 (Fri, 31 Aug 2018) $ KOMA-Script guide (package tocbasic)] -% Date of the translated German file: 2018-03-27 +% Date of the translated German file: 2018-08-31 \translator{Markus Kohm\and Arndt Schubert\and Karl Hagen} @@ -863,16 +863,19 @@ internal switch \Macro{@tempswa} globally!% \begin{Declaration} \Macro{DeclareTOCStyleEntry}\OParameter{option list}\Parameter{style}% \Parameter{entry level} + \Macro{DeclareTOCStyleEntries}\OParameter{option list}\Parameter{style}% + \Parameter{entry level list} \end{Declaration} -This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command defines or -configures the content-list entries of a given \PName{entry level}. The -\PName{entry level} argument is a symbolic name, e.\,g. \PValue{section}, for -the entry to the table of contents of the section level with the same name or -\PValue{figure} for an entry of a figure to the list of figures. A -\PName{style} is assigned to each \PName{entry level}. The \PName{style} has -to be defined before using it as an argument of \Macro{DeclareTOCStyleEntry}. -You can use the \PName{option list} to configure the various, usually -\PName{style}-dependent, attributes of the entries. +These\ChangedAt{v3.20}{\Package{tocbasic}} commands define or configure the +content-list entries of a given \PName{entry level}. The \PName{entry level} +argument is a symbolic name, e.\,g. \PValue{section}, for the entry to the +table of contents of the section level with the same name or \PValue{figure} +for an entry of a figure to the list of figures. A \PName{style} is assigned +to each \PName{entry level}. The \PName{style} has to be defined before using +it as an argument of \Macro{DeclareTOCStyleEntry} or +\Macro{DeclareTOCStyleEntries}. You can use the \PName{option list} to +configure the various, usually \PName{style}-dependent, attributes of the +entries. Currently, \Package{tocbasic} defines the following entry styles: \begin{description} @@ -1243,11 +1246,11 @@ 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}. -If\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} you use these attributes as +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[2015/12]{v3.20}{\Package{tocbasic}} use +\Option{tocentrylevel}. If\ChangedAt{v3.20}{\Package{tocbasic}} use these attributes as options for \DescRef{maincls-experts.cmd.DeclareSectionCommand}% \IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}% @@ -1417,18 +1420,18 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command used.% }% \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 than, - the same as, or less than the current - entry. The \PName{code} specified by this attribute will be executed if the - current entry has a greater numerical value, i.\,e. it is - lower in the entry hierarchy, than the previous one. - - Note that detecting the level of the previous entry only works so long as + The \PValue{tocline} style can execute \PName{code} at the start of an + entry, depending on whether the previous entry had numerical level greater + than, the same as, or less than the current entry. The \PName{code} + specified by this attribute will be executed if the current entry has a + greater numerical value, i.\,e. it is lower in the entry hierarchy, than + the previous one. + + Note that detecting the level of the previous entry only works so long as \Macro{lastpenalty} has not changed since the previous entry. - The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} (see - \DescPageRef{\LabelBase.cmd.LastTOCLevelWasLower}).% + The initial \PName{code} is \DescRef{\LabelBase.cmd.LastTOCLevelWasLower} + (see \DescPageRef{\LabelBase.cmd.LastTOCLevelWasLower}).% }% \entry{\OptionVName{onstartlowerlevel}{code}}{% The \PValue{tocline} style can execute \PName{code} at the start of an @@ -1505,7 +1508,15 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command \DescRef{\LabelBase.cmd.TOCLineLeaderFill} for the \PValue{linefill} attribute.% }% -\end{desclist}% +\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. % \EndIndexGroup @@ -1625,7 +1636,7 @@ is used to define the \Option{linefill} option. By specifying \DescRef{\LabelBase.cmd.TOCLineLeaderFill} as the \PName{default value}, a call such as \begin{lstcode} - \RedeclareTOCStyleEntry[linefill]{tocline}{part} + \DeclareTOCStyleEntry[linefill]{tocline}{part} \end{lstcode} would, among other things, create the definition \begin{lstcode} |