diff options
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.tex | 247 |
1 files changed, 164 insertions, 83 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 c01bbdada5d..17734f58c26 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: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $ + [$Date: 2018-10-14 20:31:51 +0200 (Sun, 14 Oct 2018) $ 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-02-13 +% Date of the translated German file: 2018-10-14 \chapter[{Additional Information about the Main Classes and \Package{scrextend}}]{Additional Information about the Main Classes @@ -516,69 +516,75 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or \toprule \PName{key} & \PName{value} & Description \\ \midrule% - \PValue{counterwithin} & \PName{counter name} & The value of the - counter of the heading should depend on \PName{counter name}. Whenever - \Macro{stepcounter} or \Macro{refstepcounter} increases 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{counterwithin} + & \PName{counter name} + & The value of the counter of the heading should depend on \PName{counter + name}. Whenever \Macro{stepcounter} or \Macro{refstepcounter} increases + 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.\\ \ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartl}}% - \PValue{counterwithout} & \PName{counter name} & Cancels a prior - \PValue{counterwithin} setting. Therefore it makes sense only if you - redefine an existing sectioning command.\\ - \PValue{expandtopt} & \PName{switch}& If the switch is on, all subsequent - values for lengths will be completely expanded, evaluated, and stored as - \texttt{pt} values when they are defined. This means lengths no longer - depend on the current font size. If the switch is off, all subsequent - values for lengths will be tentatively expanded and evaluated but stored - for full evaluation at application time. You can use any values from - \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The - default is \PValue{false}.\\ - \PValue{level} & \PName{integer} & The numerical value of the sectioning level - (see the \DescRef{maincls.counter.secnumdepth} counter, - \autoref{sec:maincls.structure}, - \DescPageRef{maincls.counter.secnumdepth}); - the value should be unique and is mandatory for new levels.\\ - \PValue{style} & \PName{name} & Defines the style of the - heading.\\ - \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - \PValue{tocstyle} & \PName{name} & Defines the style of the entries in - the table of contents. You can use every previously defined TOC-entry style - (see \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a - new definition of the TOC-entry - command \Macro{l@\dots}.\\ - \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and + \PValue{counterwithout} + & \PName{counter name} + & Cancels a prior \PValue{counterwithin} setting. Therefore it makes sense + only if you redefine an existing sectioning command.\\ + \PValue{expandtopt} + & \PName{switch} + & If the switch is on, all subsequent values for lengths will be + completely expanded, evaluated, and stored as \texttt{pt} values when + they are defined. This means lengths no longer depend on the current + font size. If the switch is off, all subsequent values for lengths will + be tentatively expanded and evaluated but stored for full evaluation at + application time. You can use any values from + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. + The default is \PValue{false}.\\ + \PValue{level} + & \PName{integer} + & The numerical value of the sectioning level (see the + \DescRef{maincls.counter.secnumdepth} counter, + \autoref{sec:maincls.structure}, + \DescPageRef{maincls.counter.secnumdepth}); the value should be unique + and is mandatory for new levels.\\ + \PValue{style} + & \PName{name} + & Defines the style of the heading.\\ + \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% - \PValue{toc\PName{option}} & \PName{value} & Additional options depending - on the TOC-entry style selected with \Option{tocstyle}. See - \autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle} for - additional information about TOC-entry styles. You can find the attributes - that can be used as \PName{option}s for the predefined TOC-entry styles of - the \Package{tocbasic} package in - \autoref{tab:tocbasic.tocstyle.attributes}, - \autopageref{tab:tocbasic.tocstyle.attributes}.\\ - % \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 - % \DescRef{maincls.counter.tocdepth} (siehe - % \autoref{sec:maincls.toc}, - % \DescPageRef{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 - % \DescRef{maincls.counter.tocdepth} in - % \autoref{sec:maincls.toc}, - % \DescPageRef{maincls.counter.tocdepth}). \\ - % \PValue{tocnumwidth} & \PName{length} & - % Width of the box for the number of - % the entry in the table of contents.\\ + \PValue{tocstyle} + & \PName{name} + & Defines the style of the entries in the table of contents. You can use + every previously defined TOC-entry style (see + \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a new + definition of the TOC-entry command \Macro{l@\dots}.\\ + \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + \PValue{toc\PName{option}} + & \PName{value} + & Additional options depending on the TOC-entry style selected with + \Option{tocstyle}. See \autoref{sec:tocbasic.tocstyle}, + \autopageref{sec:tocbasic.tocstyle} for additional information about + TOC-entry styles. You can find the attributes that can be used as + \PName{option}s for the predefined TOC-entry styles of the + \Package{tocbasic} package in + \autoref{tab:tocbasic.tocstyle.attributes}, + \autopageref{tab:tocbasic.tocstyle.attributes}.\\ + % \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 \DescRef{maincls.counter.tocdepth}, + % \autoref{sec:maincls.toc}, \DescPageRef{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 \DescRef{maincls.counter.tocdepth}, + % \autoref{sec:maincls.toc}, \DescPageRef{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} @@ -593,20 +599,55 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or \toprule \PName{key} & \PName{value} & Description \\ \midrule - \PValue{afterskip} & \PName{length} & A negative value activates a run-in - heading. The absolute value is the horizontal space after the heading. A - positive value is the vertical skip below the heading.\\ - \PValue{beforeskip} & \PName{length} & The amount indicates the vertical - skip before the heading. If the value is negative, a positive distance - is still inserted, but in this case the paragraph indent of the text - following the heading is suppressed.\\ - \PValue{font} & \PName{font commands} & The font settings that should be - used for the heading in addition to +% TODO: New translation by Markus Kohm (please fix) + \PValue{afterindent}% + \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + & \PName{switch} + & The \PName{switch} defines whether or not to allow the indent of the + paragraph following a free-standing heading (see \PValue{runin}). With + the default \PValue{bysign} the sign of \PValue{beforeskip} defines the + behaviour. If the value of \PValue{beforeskip} is negative, the + paragraph indent of the text following the heading is suppressed. You + can use any values from \autoref{tab:truefalseswitch}, + \autopageref{tab:truefalseswitch} to explicitly allow or suppress that + paragraph indent.\\ + \PValue{afterskip} + & \PName{length} + & In case of a run-in heading, the absolute value is the horizontal space + after the heading. In case of a free-standing heading, the value of the + vertical skip below the heading. With \OptionValue{runin}{bysign}, a + positive value activates a free-standing heading and a negative value or + zero activates a run-in heading.\\ + \PValue{beforeskip} + & \PName{length} + & The vertical skip before the heading. With + \OptionValue{afterindent}{bysign}, if the value is negative, a positive + distance\,---\,the amount of \PName{length}\,---\,is still inserted, but + in this case the paragraph indent of the text following the heading is + suppressed.\\ +% End of new translation + \PValue{font} + & \PName{font commands} + & The font settings that should be used for the heading in addition to \DescRef{maincls.fontelement.disposition}. You can use all settings that are allowed for \DescRef{maincls.cmd.setkomafont} and \DescRef{maincls.cmd.addtokomafont} for the element of the heading.\\ - \PValue{indent} & \PName{length} & The indentation of heading from the - left margin.\\ + \PValue{indent} + & \PName{length} + & The indentation of heading from the left margin.\\ +% TODO: New translation by Markus Kohm (please fix)! + \PValue{runin} + \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + & \PName{switch} + & Defines whether to use a run-in heading or a free-standing heading. With + the default \PValue{bysign} the sign of \PValue{afterskip} defines the + behaviour. In this case, a positive value of \PValue{afterskip} + deactivates a run-in heading. You can use any values from + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to + explicitly activate or deactivate a run-in heading.\\ +% End of new translation \bottomrule \end{tabularx} \end{table} @@ -621,14 +662,31 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or \toprule \PName{key} & \PName{value} & Description \\ \midrule - \PValue{afterskip} & \PName{length} & The value is the vertical skip below - the heading.\\ - \PValue{beforeskip} & \PName{length} & The value of the vertical skip - before the heading. If the value is negative, then the positive distance - is nevertheless inserted, and the paragraph indent of the text following - the heading is suppressed. There will also be no indentation even for - positive values if the \DescRef{maincls.option.version} class option is - set to a value less than 3.22.\\ +% TODO: New translation by Markus Kohm (please fix) + \PValue{afterindent}% + \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + & \PName{switch} + & The \PName{switch} defines whether or not to allow the indent of the + paragraph following a heading. With the default \PValue{bysign} the sign + of \PValue{beforeskip} defines the behaviour. If the value of + \PValue{beforeskip} is negative, the paragraph indent of the text + following the heading is suppressed. You can use any values from + \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to + explicitly allow or suppress that paragraph indent.\\ + \PValue{afterskip}% + \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + & \PName{length} + & The vertical skip below the heading.\\ + \PValue{beforeskip} + & \PName{length} + & The vertical skip before the heading. With + \OptionValue{afterindent}{bysign}, if the value is negative, a positive + distance\,---\,the amount of \PName{length}\,---\,is still inserted, but + in this case the paragraph indent of the text following the heading is + suppressed.\\ +% End of new translation \PValue{font} & \PName{font commands} & The font setting to use for the heading in addition to \DescRef{maincls.fontelement.disposition}. You can use all settings, that are allowed for @@ -660,10 +718,33 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or \toprule \PName{key} & \PName{value} & Description \\ \midrule +% TODO: New translation by Markus Kohm (please fix) + \PValue{afterindent}% + \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + & \PName{switch} + & The \PName{switch} defines whether or not to allow the indent of the + paragraph following a heading. With + value \PValue{bysign} the sign of \PValue{beforeskip} defines the + behaviour. If the value of \PValue{beforeskip} is negative, the + paragraph indent of the text following the heading is suppressed. You + can use any values from \autoref{tab:truefalseswitch}, + \autopageref{tab:truefalseswitch} to explicitly allow or suppress that + paragraph indent. For compatibility, the default of \Class{scrartcl} is + \PValue{false} and the default of \Class{scrbook} and \Class{scrreprt} + is \PValue{true}.\\ +% End of new translation \PValue{afterskip} & \PName{length} & The value is the vertical skip below the heading.\\ - \PValue{beforeskip} & \PName{length}& The value is the vertical skip above - the heading.\\ +% TODO: New translation by Markus Kohm (please fix) + \PValue{beforeskip} + & \PName{length} + & The vertical skip before the heading. With + \OptionValue{afterindent}{bysign}, if the value is negative, a positive + distance\,---\,the amount of \PName{length}\,---\,is still inserted, but + in this case the paragraph indent of the text following the heading is + suppressed.\\ +% End of new translation \PValue{font} & \PName{font commands} & The font setting to use for the heading in addition to \DescRef{maincls.fontelement.disposition}. You can use all settings that are allowed for |