diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex | 75 |
1 files changed, 40 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex b/Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex index b4f0a1174e5..768c9332071 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/tocbasic-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % tocbasic-en.tex -% Copyright (c) Markus Kohm, 2002-2022 +% Copyright (c) Markus Kohm, 2002-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,7 +24,7 @@ % ====================================================================== \KOMAProvidesFile{tocbasic-en.tex} - [$Date: 2022-07-17 12:36:46 +0200 (So, 17. Jul 2022) $ + [$Date: 2023-04-04 10:50:12 +0200 (Di, 04. Apr 2023) $ KOMA-Script guide (package tocbasic)] \translator{Markus Kohm\and Arndt Schubert\and Karl Hagen} @@ -184,13 +184,15 @@ sets the options for this owner. By the way, the \hyperref[cha:scrhack]{\Package{scrhack}}% \IndexPackage{scrhack}\important{\hyperref[cha:scrhack]{\Package{scrhack}}} -package contains patches for several packages, such as \Package{float} or -\Package{listings}, which provide their own content lists. If you use -\hyperref[cha:scrhack]{\Package{scrhack}}, among other things, the respective -file extensions will be added to the list of known file extensions. Their -\PName{owner} is also ``\PValue{float}''. This is the basic building block, so -to speak, allowing you to use the features of \Package{tocbasic} and the -\KOMAScript{} classes with these content lists as well.% +package contains patches for several packages, such as +\Package{float}\IndexPackage{float} or +\Package{listings}\IndexPackage{listings}, which provide their own content +lists. If you use \hyperref[cha:scrhack]{\Package{scrhack}}, among other +things, the respective file extensions will be added to the list of known file +extensions. Their \PName{owner} is also ``\PValue{float}''. This is the basic +building block, so to speak, allowing you to use the features of +\Package{tocbasic} and the \KOMAScript{} classes with these content lists as +well.% \EndIndexGroup @@ -496,14 +498,14 @@ result in an error like: \end{lstoutput} if there are no more write handles left. Loading the \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} -package (see \autoref{cha:scrwfile}) can solve this problem. +package \cite{package:scrwfile} can solve this problem. Also, the \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% \important{\hyperref[cha:scrhack]{\Package{scrhack}}} package contains patches -for several packages, such as \Package{float} or \Package{listings}, so that -their content-list commands can use \Macro{listoftoc}. As a result, many -features of \Package{tocbasic} and the \KOMAScript{} classes are also -available for their content lists.% +for several packages, such as \Package{float}\IndexPackage{float} or +\Package{listings}\IndexPackage{listings}, so that their content-list commands +can use \Macro{listoftoc}. As a result, many features of \Package{tocbasic} +and the \KOMAScript{} classes are also available for their content lists.% \EndIndexGroup @@ -523,12 +525,7 @@ all content lists. The general before-hook is called before the individual one, and the general after-hook is called after the individual one. While executing the commands in these hooks, \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} is the -extension of the TOC file which is about to be or has just been read. - -You can find an example\textnote{Example} using \Macro{BeforeStartingTOC} in -\autoref{sec:scrwfile.clonefilefeature} on -\PageRefxmpl{scrwfile.cmd.BeforeStartingTOC}. -% +extension of the TOC file which is about to be or has just been read.% \EndIndexGroup @@ -635,8 +632,9 @@ recognizes following features: lists that are created in a fixed language, which means that changes of the language inside of the document will no longer affect the content list. The \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} - package also uses this feature for cloned destinations, as because those - files already inherit any language changes from the cloning source. + \cite{package:scrwfile} package also uses this feature for cloned + destinations, as because those files already inherit any language changes + from the cloning source. Note\textnote{Attention!} that you must set this feature before you add a file extension to the list of known extensions. Changing the feature @@ -1405,10 +1403,12 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command without this prefix. For the \PValue{dottedtocline}, \PValue{undottedtocline}, and \PValue{tocline} styles, the initial values of levels \PValue{part} down to \PValue{subparagraph} and the levels - \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. + \PValue{figure}, \PValue{table} and + \ChangedAt{v3.39}{\Package{tocbasic}}\PValue{lstlisting} are compatible + with the standard classes resp. package + \Package{listings}\IndexPackage{listings}. 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. If the \PValue{noindent} attribute is set for a content list via \DescRef{\LabelBase.cmd.setuptoc}, the entries of all styles provided by @@ -1429,10 +1429,13 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command 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.% + from \PValue{part} to \PValue{subparagraph}, as well as \PValue{figure}, + \PValue{table} and + \ChangedAt{v3.39}{\Package{tocbasic}}\PValue{lstlisting}, are initialised + to be compatible with the standard classes resp. package + \Package{listings}\IndexPackage{listings}. For all other levels, the + initialisation is done with the value of \Macro{\PName{entry + level}numdepth}, if this is defined.% }% \entry{\OptionVName{indentfollows}{list of levels}}{% \ChangedAt{v3.31}{\Package{tocbasic}}% @@ -1485,10 +1488,12 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command attributes exists. With the \PValue{dottedtocline}, \PValue{undottedtocline}, and \PValue{tocline} styles, the initial \PName{length}s of levels from \PValue{part} to \PValue{subparagraph}, as - well as \PName{figure} and \PName{table}, are compatible with those of the - standard classes. All other levels do not have an initial value. Therefore - you must set \PValue{numwidth} explicitly when the entry level is first - used.% + well as \PName{figure}, \PName{table} and + \ChangedAt{v3.39}{\Package{tocbasic}}\PName{lstlisting}, are compatible + with those of the standard classes resp. package + \Package{listings}\IndexPackage{listings}. All other levels do not have an + initial value. Therefore you must set \PValue{numwidth} explicitly when + the entry level is first used.% }% \entry{\OptionVName{onendentry}{code}}{% \ChangedAt{v3.27}{\Package{tocbasic}}% @@ -1967,7 +1972,7 @@ message of the type \end{lstoutput} if no more write handles are available. You can solve this problem by loading the \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} -package described in \autoref{cha:scrwfile}, or by using \LuaLaTeX{}.% +package \cite{package:scrwfile} or by using \LuaLaTeX{}.% \EndIndexGroup |