diff options
author | Norbert Preining <norbert@preining.info> | 2023-04-18 03:02:36 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-04-18 03:02:36 +0000 |
commit | 80e82c6cd5fb165fa720a1ce3a25f357ea11b9fc (patch) | |
tree | f8978ec3fb998e446d63ff65719cc30189deeb5f /macros/latex/contrib/koma-script/doc | |
parent | 88aa9bb9a3222cf13820ae3b6f64ce48dcd003ea (diff) |
CTAN sync 202304180302
Diffstat (limited to 'macros/latex/contrib/koma-script/doc')
69 files changed, 276 insertions, 626 deletions
diff --git a/macros/latex/contrib/koma-script/doc/common-headfootheight-en.tex b/macros/latex/contrib/koma-script/doc/common-headfootheight-en.tex index c703e26dbe..2507a0b8ca 100644 --- a/macros/latex/contrib/koma-script/doc/common-headfootheight-en.tex +++ b/macros/latex/contrib/koma-script/doc/common-headfootheight-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % common-headfootheight-en.tex -% Copyright (c) Markus Kohm, 2013-2022 +% Copyright (c) Markus Kohm, 2013-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,9 +24,9 @@ % ============================================================================ \KOMAProvidesFile{common-headfootheight-en.tex} - [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + [$Date: 2023-04-06 09:05:58 +0200 (Do, 06. Apr 2023) $ KOMA-Script guide (common paragraph: Head and Foot Height)] -\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} +\translator{Markus Kohm\and Jana Schubert\and Jens Hühne\and Karl Hagen} \section{Header and Footer Height} \seclabel{height} diff --git a/macros/latex/contrib/koma-script/doc/common-textmarkup-de.tex b/macros/latex/contrib/koma-script/doc/common-textmarkup-de.tex index 7531a7bb12..100cfeac87 100644 --- a/macros/latex/contrib/koma-script/doc/common-textmarkup-de.tex +++ b/macros/latex/contrib/koma-script/doc/common-textmarkup-de.tex @@ -24,7 +24,7 @@ % ====================================================================== \KOMAProvidesFile{common-textmarkup-de.tex} - [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + [$Date: 2023-04-04 13:29:59 +0200 (Di, 04. Apr 2023) $ KOMA-Script guide (common paragraphs)] \section{Textauszeichnungen} @@ -156,6 +156,54 @@ \fi +\IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura,scrlayer-notecolumn}{% + \iffalse% +}{% + \csname iftrue\endcsname% +}% + \begin{Declaration} + \OptionVName{sfdefaults}{Ein-Aus-Wert}% + \Macro{maybesffamily}% + \Macro{textmaybesf}\Parameter{Text}% + \end{Declaration} + Die% + \IfThisCommonLabelBase{maincls}{% + \ChangedAt{v3.39}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + }{% + \IfThisCommonLabelBase{scrextend}{% + \ChangedAt{v3.39}{\Package{screxend}}% + }{% + \IfThisCommonLabelBase{scrlttr2}{% + \ChangedAt{v3.39}{\Class{scrlttr2}}% + }{}% + }% + } Anweisungen \Macro{maybesffamily} und \Macro{textmaybesf} verhalten sich + je nach Einstellung von Option \Option{sfdefaults} unterschiedlich. Als + \PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache + Schalter aus \autoref{tab:truefalseswitch} verwendet werden. Nur bei + aktivierter Option führt \Macro{maybesffamily} zu \Macro{sffamily} und + \Macro{textmaybesf} zu \Macro{textsf}. \KOMAScript{} selbst verwendet + \Macro{maybesffamily} in der Voreinstellung der Elemente + \IfThisCommonLabelBase{scrextend}{}{% + \DescRef{\LabelBase.fontelement.descriptionlabel}, % + }% + \IfThisCommonLabelBase{scrlttr2}{% + \DescRef{\LabelBase.fontelement.backaddress}, % + \DescRef{\LabelBase.fontelement.refname} % + und \DescRef{\LabelBase.fontelement.lettertitle}% + }{% + \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.fontelement.disposition}% + }{% + \DescRef{\LabelBase.fontelement.disposition}% + } % + und \DescRef{\LabelBase.fontelement.dictum}% + }.% + \EndIndexGroup% + \fi + + \begin{Declaration} \Macro{setkomafont}\Parameter{Element}\Parameter{Befehle}% \Macro{addtokomafont}\Parameter{Element}\Parameter{Befehle}% diff --git a/macros/latex/contrib/koma-script/doc/common-textmarkup-en.tex b/macros/latex/contrib/koma-script/doc/common-textmarkup-en.tex index 3f161aaedc..8b81bfbbb2 100644 --- a/macros/latex/contrib/koma-script/doc/common-textmarkup-en.tex +++ b/macros/latex/contrib/koma-script/doc/common-textmarkup-en.tex @@ -24,7 +24,7 @@ % ====================================================================== \KOMAProvidesFile{common-textmarkup-en.tex} - [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + [$Date: 2023-04-04 13:29:59 +0200 (Di, 04. Apr 2023) $ KOMA-Script guide (common paragraphs)] \translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and Karl Hagen} @@ -153,6 +153,53 @@ \fi +\IfThisCommonLabelBaseOneOf{scrlayer-scrpage,scrjura,scrlayer-notecolumn}{% + \iffalse% +}{% + \csname iftrue\endcsname% +}% + \begin{Declaration} + \OptionVName{sfdefaults}{simple switch}% + \Macro{maybesffamily}% + \Macro{textmaybesf}\Parameter{text}% + \end{Declaration} + The% + \IfThisCommonLabelBase{maincls}{% + \ChangedAt{v3.39}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}}% + }{% + \IfThisCommonLabelBase{scrextend}{% + \ChangedAt{v3.39}{\Package{screxend}}% + }{% + \IfThisCommonLabelBase{scrlttr2}{% + \ChangedAt{v3.39}{\Class{scrlttr2}}% + }{}% + }% + } \Macro{maybesffamily} and \Macro{textmaybesf} commands behave differently + depending on the setting of option \Option{sfdefaults}. One of the default + values for simple switches from \autoref{tab:truefalseswitch} can be used + here. Only if this option is enabled will \Macro{maybesffamily} result in + \Macro{sffamily} and \Macro{textmaybesf} use \Macro{textsf}. KOMA-Script + itself uses \Macro{maybesffamily} in the default settings of elements + \IfThisCommonLabelBase{scrextend}{}{% + \DescRef{\LabelBase.fontelement.descriptionlabel}, % + }% + \IfThisCommonLabelBase{scrlttr2}{% + \DescRef{\LabelBase.fontelement.backaddress}, % + \DescRef{\LabelBase.fontelement.refname}, % + and \DescRef{\LabelBase.fontelement.lettertitle}% + }{% + \IfThisCommonLabelBase{scrextend}{% + \DescRef{maincls.fontelement.disposition}% + }{% + \DescRef{\LabelBase.fontelement.disposition}, % + }% + and \DescRef{\LabelBase.fontelement.dictum}% + }.% + \EndIndexGroup% +\fi + + \begin{Declaration} \Macro{setkomafont}\Parameter{element}\Parameter{commands}% \Macro{addtokomafont}\Parameter{element}\Parameter{commands}% diff --git a/macros/latex/contrib/koma-script/doc/letter-example-00-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-00-de.pdf Binary files differindex 2249512b97..bf2ad91537 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-00-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-00-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-00-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-00-en.pdf Binary files differindex 67abe74cd3..cceedc4657 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-00-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-00-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-01-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-01-de.pdf Binary files differindex b5a190fa23..7b235fa7db 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-01-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-01-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-01-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-01-en.pdf Binary files differindex 270c7c3d7d..df28d5d708 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-01-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-01-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-02-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-02-de.pdf Binary files differindex 82f7716e3a..72cb97f417 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-02-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-02-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-02-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-02-en.pdf Binary files differindex 31bcb38952..8c32102d1b 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-02-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-02-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-03-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-03-de.pdf Binary files differindex eb2f4259cb..68c17bb8db 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-03-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-03-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-03-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-03-en.pdf Binary files differindex fbfd018450..7c0e47913c 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-03-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-03-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-04-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-04-de.pdf Binary files differindex 9631976843..4f72d91356 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-04-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-04-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-04-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-04-en.pdf Binary files differindex 48ad48858a..fea4f82e13 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-04-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-04-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-05-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-05-de.pdf Binary files differindex a0f0bca15d..04f77cb7d5 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-05-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-05-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-05-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-05-en.pdf Binary files differindex 2a956f2965..99ac87b961 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-05-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-05-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-06-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-06-de.pdf Binary files differindex e66bd554e1..b207def49a 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-06-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-06-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-06-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-06-en.pdf Binary files differindex c64985369e..2ea196f2b0 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-06-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-06-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-07-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-07-de.pdf Binary files differindex 4e65475a2f..c4806624d5 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-07-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-07-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-07-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-07-en.pdf Binary files differindex 2f76bfa3f7..453d96f15c 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-07-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-07-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-08-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-08-de.pdf Binary files differindex d9de127751..35dd6e5095 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-08-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-08-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-08-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-08-en.pdf Binary files differindex dc4a322f89..1543cf5eca 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-08-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-08-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-09-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-09-de.pdf Binary files differindex 259a7dc2dd..4879a525b8 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-09-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-09-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-09-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-09-en.pdf Binary files differindex 1a384afac1..f15d3ed842 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-09-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-09-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-10-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-10-de.pdf Binary files differindex dac0d2ec28..e98de9d690 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-10-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-10-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-10-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-10-en.pdf Binary files differindex a277f2fc55..1cb5b1f34d 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-10-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-10-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-11-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-11-de.pdf Binary files differindex 9f50de50e4..eea9f33be8 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-11-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-11-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-11-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-11-en.pdf Binary files differindex 8fcbc7e47d..d16b5b1ad2 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-11-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-11-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-12-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-12-de.pdf Binary files differindex 72a9aea2d5..4a7a1aee52 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-12-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-12-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-12-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-12-en.pdf Binary files differindex 4bebc44a1f..995d7ada77 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-12-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-12-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-13-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-13-de.pdf Binary files differindex 88f0d60137..0f10aad58b 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-13-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-13-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-13-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-13-en.pdf Binary files differindex e8a805b47b..0d75113def 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-13-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-13-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-14-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-14-de.pdf Binary files differindex 64b9623031..bc8c78a39d 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-14-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-14-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-14-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-14-en.pdf Binary files differindex d737001ea5..63c0ed97ed 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-14-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-14-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-15-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-15-de.pdf Binary files differindex 2c8345548d..d7a7021cc0 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-15-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-15-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-15-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-15-en.pdf Binary files differindex 4939295488..94c8221b79 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-15-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-15-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-16-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-16-de.pdf Binary files differindex 048a7793da..07c725b509 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-16-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-16-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-16-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-16-en.pdf Binary files differindex 52ed1ab06a..9a836451af 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-16-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-16-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-17-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-17-de.pdf Binary files differindex 9aefd10579..39ebc382d7 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-17-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-17-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-17-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-17-en.pdf Binary files differindex 7903207d01..026232663f 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-17-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-17-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-18-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-18-de.pdf Binary files differindex 94935d2668..282c02c3bd 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-18-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-18-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-18-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-18-en.pdf Binary files differindex d70ca642c1..1cbdc9dc9d 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-18-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-18-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-19-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-19-de.pdf Binary files differindex 464fb712e4..beff2c403a 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-19-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-19-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-19-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-19-en.pdf Binary files differindex 3f45de2755..78a55e595d 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-19-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-19-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-20-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-20-de.pdf Binary files differindex 3cf39ec1b7..dbd12bef9a 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-20-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-20-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-20-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-20-en.pdf Binary files differindex 09d88c5d65..e39a1a32e4 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-20-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-20-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-21-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-21-de.pdf Binary files differindex 7602ec5e30..4c4a9606e7 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-21-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-21-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-21-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-21-en.pdf Binary files differindex cc74aca2f1..a892448d61 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-21-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-21-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-22-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-22-de.pdf Binary files differindex 873f92bf96..072952e220 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-22-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-22-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-22-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-22-en.pdf Binary files differindex 5b5c16e21d..1926717703 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-22-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-22-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-23-de.pdf b/macros/latex/contrib/koma-script/doc/letter-example-23-de.pdf Binary files differindex c1bbff8084..9bda41d035 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-23-de.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-23-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/letter-example-23-en.pdf b/macros/latex/contrib/koma-script/doc/letter-example-23-en.pdf Binary files differindex ef315480af..27a27eed8b 100644 --- a/macros/latex/contrib/koma-script/doc/letter-example-23-en.pdf +++ b/macros/latex/contrib/koma-script/doc/letter-example-23-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrbookreportarticle-en.tex b/macros/latex/contrib/koma-script/doc/scrbookreportarticle-en.tex index 3cf7fc28a0..9994aa9738 100644 --- a/macros/latex/contrib/koma-script/doc/scrbookreportarticle-en.tex +++ b/macros/latex/contrib/koma-script/doc/scrbookreportarticle-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrbookreportarticle-en.tex -% Copyright (c) Markus Kohm, 2001-2022 +% Copyright (c) Markus Kohm, 2001-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,11 +24,11 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-en.tex} - [$Date: 2022-07-17 12:37:12 +0200 (So, 17. Jul 2022) $ + [$Date: 2023-04-06 09:05:58 +0200 (Do, 06. Apr 2023) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)] \translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and - Krickette Murabayashi\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} + Krickette Murabayashi\and Jana Schubert\and Jens Hühne\and Karl Hagen} \chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and \Class{scrartcl}} @@ -1615,7 +1615,7 @@ below contain examples using some of these settings. \ChangedAt{v3.12}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}% Reset the font settings for each of the standard sectioning levels and use headings with the sizes of the standard classes. For chapter headings, - \Class{scrbook} und \Class{scrreprt} set + \Class{scrbook} and \Class{scrreprt} set \OptionValue{headings}{twolinechapter}.% }% \entry{\PValue{twolineappendix}, \PValue{appendixprefix}, diff --git a/macros/latex/contrib/koma-script/doc/scrguide-de.pdf b/macros/latex/contrib/koma-script/doc/scrguide-de.pdf Binary files differindex 870ca4aff9..db536b8340 100644 --- a/macros/latex/contrib/koma-script/doc/scrguide-de.pdf +++ b/macros/latex/contrib/koma-script/doc/scrguide-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrguide-en.pdf b/macros/latex/contrib/koma-script/doc/scrguide-en.pdf Binary files differindex bcd01f37da..78a67052de 100644 --- a/macros/latex/contrib/koma-script/doc/scrguide-en.pdf +++ b/macros/latex/contrib/koma-script/doc/scrguide-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrguide.bib b/macros/latex/contrib/koma-script/doc/scrguide.bib index 4c6b7e6da3..d93e74044a 100644 --- a/macros/latex/contrib/koma-script/doc/scrguide.bib +++ b/macros/latex/contrib/koma-script/doc/scrguide.bib @@ -1,6 +1,6 @@ % ====================================================================== % scrguide.bib -% Copyright (c) Markus Kohm, 2002-2022 +% Copyright (c) Markus Kohm, 2002-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -719,6 +719,16 @@ Schlegl}, url = {CTAN://macros/latex/contrib/splitindex/} } +@Misc{ package:scrwfile, + language= {english}, + author = {Markus Kohm}, + title = {{\Package{scrwfile}} -- Use {\LaTeX} {\File{.aux}} file in place of {\Macro{newfile}} files}, + year = 2023, + month = apr, + edition = {0.1.99}, + url = {https://www.ctan.org/pkg/scrwfile} +} + @Misc{ package:supertabular, language= {english}, author = {Braams, Johannes L. and Jurriens, Theo}, diff --git a/macros/latex/contrib/koma-script/doc/scrjura-de.tex b/macros/latex/contrib/koma-script/doc/scrjura-de.tex index 3889dd96a3..aa8dc88922 100644 --- a/macros/latex/contrib/koma-script/doc/scrjura-de.tex +++ b/macros/latex/contrib/koma-script/doc/scrjura-de.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrjura-de.tex -% Copyright (c) Markus Kohm, 2011-2022 +% Copyright (c) Markus Kohm, 2011-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,7 +24,7 @@ % ====================================================================== \KOMAProvidesFile{scrjura-de.tex}% - [$Date: 2022-07-17 12:36:46 +0200 (So, 17. Jul 2022) $ + [$Date: 2023-04-16 13:50:16 +0200 (So, 16. Apr 2023) $ KOMA-Script guide (chapter: scrjura)] \chapter{Unterstützung für die Anwaltspraxis durch \Package{scrjura}} @@ -1069,7 +1069,7 @@ erhalten. Diese Funktionalität ist seit \LaTeX{} 2020/02/01 jedoch in den Wie Sie am Laden von \Package{fontenc} erkennen können, wird für das Beispiel PDF\LaTeX{} verwendet. Soll stattdessen \LuaLaTeX{} oder \XeLaTeX{} verwendet -werden, entfallen alle drei Zeilen. Wahlweise kann dann \Package{fontspec} +werden, entfallen die beiden Zeilen. Wahlweise kann dann \Package{fontspec} geladen oder einfach mit den Voreinstellungen gearbeitet werden. \lstinputcode[{xleftmargin=2em,% @@ -1136,7 +1136,7 @@ Mit dem ersten Artikel beginnt auch der Vertrag. Der erste Paragraph erhält neben der Nummer auch einen Titel. Dies wird auch bei den nachfolgenden Paragraphen so sein. -Der erste Absatz des Vertrags enthält nichts ungewöhnliches. Da es nicht der +Der erste Absatz des Vertrags enthält nichts Ungewöhnliches. Da es nicht der einzige Absatz ist, werden bei der Ausgabe jedem Absatz automatisch Absatznummern voran gestellt werden. Damit dies auch beim ersten Absatz geschieht, sind allerdings zwei \LaTeX-Läufe notwendig. Da dies für das diff --git a/macros/latex/contrib/koma-script/doc/scrjura-example-de.pdf b/macros/latex/contrib/koma-script/doc/scrjura-example-de.pdf Binary files differindex e7152f2979..1fa785aa8f 100644 --- a/macros/latex/contrib/koma-script/doc/scrjura-example-de.pdf +++ b/macros/latex/contrib/koma-script/doc/scrjura-example-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrjura-example-de.tex b/macros/latex/contrib/koma-script/doc/scrjura-example-de.tex index 89cb106474..602422b0f2 100644 --- a/macros/latex/contrib/koma-script/doc/scrjura-example-de.tex +++ b/macros/latex/contrib/koma-script/doc/scrjura-example-de.tex @@ -23,7 +23,7 @@ \subject{Satzung} \title{VfVmai} -\subtitle{Verein für Vereinsmaierei mit ai n.e.V.} +\subtitle{Verein für Vereinsmaierei mit ai n.\,e.\,V.} \date{11.\,11.\,2011} \maketitle diff --git a/macros/latex/contrib/koma-script/doc/scrjura-example-en.pdf b/macros/latex/contrib/koma-script/doc/scrjura-example-en.pdf Binary files differindex f906b65de2..67ce42a47b 100644 --- a/macros/latex/contrib/koma-script/doc/scrjura-example-en.pdf +++ b/macros/latex/contrib/koma-script/doc/scrjura-example-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-de.pdf b/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-de.pdf Binary files differindex a0a33872ec..91280bf2b8 100644 --- a/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-de.pdf +++ b/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-de.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-en.pdf b/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-en.pdf Binary files differindex 0e93178c60..89fd3d7413 100644 --- a/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-en.pdf +++ b/macros/latex/contrib/koma-script/doc/scrlayer-notecolumn-example-en.pdf diff --git a/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-de.tex b/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-de.tex index 7cf7502ba6..80673ca33c 100644 --- a/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-de.tex +++ b/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-de.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage-de.tex -% Copyright (c) Markus Kohm, 2013-2022 +% Copyright (c) Markus Kohm, 2013-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -23,7 +23,7 @@ % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage-de.tex}% - [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + [$Date: 2023-04-06 10:35:02 +0200 (Do, 06. Apr 2023) $ KOMA-Script guide (chapter:scrlayer-scrpage)] \chapter[{Kopf- und Fußzeilen mit \Package{scrlayer-scrpage}}] @@ -386,6 +386,18 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% wird, bleibt der Seitenstil \DescRef{\LabelBase.pagestyle.plain.scrheadings} unverändert. Das Ergebnis ist für die erste Seite also tatsächlich korrekt. + Die explizite Verwendung von + \DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} ist nicht einmal + notwendig. Das Paket führt diese Anweisung bereits selbst beim Laden aus, + stellt den Seitenstil also automatisch auf + \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings} + um. Dabei wird auch nicht nur der Seitenstil + \DescRef{maincls.pagestyle.headings}\IndexPagestyle{headings} automatisch in + \DescRef{\LabelBase.pagestyle.scrheadings} geändert, sondern auch + \DescRef{maincls.pagestyle.plain}\IndexPagestyle{plain} in + \DescRef{\LabelBase.pagestyle.plain.scrheadings}% + \IndexPagestyle{plain.scrheadings}. + Fügen Sie jetzt im Beispiel nach \DescRef{maincls.cmd.maketitle} so viel Text ein, dass eine zweite Seite ausgegeben wird. Sie können dazu auch einfach \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} in der @@ -404,7 +416,6 @@ für den Kopf der Seiten im doppelseitigen Modus noch einmal skizziert.% {Peter Musterheinzel} \rohead[Seitenstile mit \KOMAScript] {Seitenstile mit \KOMAScript} - \pagestyle{scrheadings} \usepackage{lipsum} \begin{document} \title{Seitenstile mit \KOMAScript} @@ -483,7 +494,6 @@ Sternvariante mit nur einem Argument verwenden.% \usepackage{scrlayer-scrpage} \lohead*{Peter Musterheinzel} \rohead*{Seitenstile mit \KOMAScript} - \pagestyle{scrheadings} \usepackage{lipsum} \begin{document} \title{Seitenstile mit \KOMAScript} @@ -693,7 +703,6 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \lohead{Peter Musterheinzel} \rohead{Seitenstile mit \KOMAScript} \lofoot{Verlag Naseblau, Irgendwo} - \pagestyle{scrheadings} \usepackage{lipsum} \begin{document} \title{Seitenstile mit \KOMAScript} @@ -790,7 +799,6 @@ für den Fuß der Seiten im doppelseitigen Modus noch einmal skizziert. \lehead{Seitenstile mit \KOMAScript} \refoot[Verlag Naseblau, Irgendwo] {Verlag Naseblau, Irgendwo} - \pagestyle{scrheadings} \setkomafont{pageheadfoot}{\small} \setkomafont{pagehead}{\bfseries} \usepackage{lipsum} @@ -864,7 +872,6 @@ Sternvariante mit nur einem Argument verwenden.% \rehead{Peter Musterheinzel} \lehead{Seitenstile mit \KOMAScript} \refoot*{Verlag Naseblau, Irgendwo} - \pagestyle{scrheadings} \setkomafont{pageheadfoot}{\small} \setkomafont{pagehead}{\bfseries} \usepackage{lipsum} @@ -936,7 +943,6 @@ skizziert. \ohead{Seitenstile mit \KOMAScript} \ifoot[Verlag Naseblau, Irgendwo] {Verlag Naseblau, Irgendwo} - \pagestyle{scrheadings} \setkomafont{pageheadfoot}{\small} \setkomafont{pagehead}{\bfseries} \usepackage{lipsum} @@ -1019,7 +1025,6 @@ Sternvariante mit nur einem Argument verwenden.% \ihead{Peter Musterheinzel} \ohead{Seitenstile mit \KOMAScript} \ifoot*{Verlag Naseblau, Irgendwo} - \pagestyle{scrheadings} \setkomafont{pageheadfoot}{\small} \setkomafont{pagehead}{\bfseries} \usepackage{lipsum} diff --git a/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-en.tex b/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-en.tex index 73b71c1523..efd42a1b0f 100644 --- a/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-en.tex +++ b/macros/latex/contrib/koma-script/doc/scrlayer-scrpage-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlayer-scrpage-en.tex -% Copyright (c) Markus Kohm, 2013-2022 +% Copyright (c) Markus Kohm, 2013-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -23,9 +23,9 @@ % ============================================================================ \KOMAProvidesFile{scrlayer-scrpage-en.tex}% - [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $ + [$Date: 2023-04-06 09:06:52 +0200 (Do, 06. Apr 2023) $ KOMA-Script guide (chapter: scrlayer-scrpage)] -\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen} +\translator{Markus Kohm\and Jana Schubert\and Jens Hühne\and Karl Hagen} \chapter[{Headers and Footers with \Package{scrlayer-scrpage}}] {Headers\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} and @@ -355,6 +355,7 @@ in \autoref{fig:scrlayer-scrpage.head}.% \usepackage{scrlayer-scrpage} \lohead{John Doe} \rohead{Page style with \KOMAScript} + \pagestyle{scrheadings} \begin{document} \title{Page styles with \KOMAScript} \author{John Doe} @@ -376,6 +377,17 @@ in \autoref{fig:scrlayer-scrpage.head}.% \DescRef{\LabelBase.pagestyle.plain.scrheadings} page style remains unchanged and the result for the first page is actually correct. + The explicit use of \DescRef{maincls.cmd.pagestyle}\PParameter{scrheadings} + is not even necessary. The package already executes this command itself when + loading, so it automatically sets the page style to + \DescRef{\LabelBase.pagestyle.scrheadings}\IndexPagestyle{scrheadings}. This + also changes not only the page style + \DescRef{maincls.pagestyle.headings}\IndexPagestyle{headings} automatically + to \DescRef{\LabelBase.pagestyle.scrheadings}, but also + \DescRef{maincls.pagestyle.plain}\IndexPagestyle{plain} to + \DescRef{\LabelBase.pagestyle.plain.scrheadings}% + \IndexPagestyle{plain.scrheadings}. + Now add enough text to the example after \DescRef{maincls.cmd.maketitle} so that a second page is printed. You can simply add \Macro{usepackage}\PParameter{lipsum}\IndexPackage{lipsum} to the document diff --git a/macros/latex/contrib/koma-script/doc/scrlttr2-en.tex b/macros/latex/contrib/koma-script/doc/scrlttr2-en.tex index bff4cba354..6aa27c2c59 100644 --- a/macros/latex/contrib/koma-script/doc/scrlttr2-en.tex +++ b/macros/latex/contrib/koma-script/doc/scrlttr2-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrlttr2-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{scrlttr2-en.tex}% - [$Date: 2022-10-12 08:12:27 +0200 (Mi, 12. Okt 2022) $ + [$Date: 2023-03-20 09:42:36 +0100 (Mo, 20. Mär 2023) $ KOMA-Script guide (chapter: scrlttr2)] \translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe @@ -4095,7 +4095,7 @@ If\ChangedAt{v2.97}{\Class{scrlttr2}} an \File{lco} file is loaded via he finds it quite annoying to copy this information to each new letter. To simplify the effort of writing a new letter, he therefore creates an \File{lco} file:% - \lstinputcode[xleftmargin=1em]{ich.lco}% + \lstinputcode[xleftmargin=1em]{me.lco}% With this, the size of his letter from the previous example shrinks considerably: \lstinputcode[xleftmargin=1em]{letter-example-23-en.tex}% Nevertheless, the result does not change, as shown in diff --git a/macros/latex/contrib/koma-script/doc/scrwfile-de.tex b/macros/latex/contrib/koma-script/doc/scrwfile-de.tex index 11f2107b84..98bf0c5574 100644 --- a/macros/latex/contrib/koma-script/doc/scrwfile-de.tex +++ b/macros/latex/contrib/koma-script/doc/scrwfile-de.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrwfile-de.tex -% Copyright (c) Markus Kohm, 2001-2022 +% Copyright (c) Markus Kohm, 2010-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,250 +24,32 @@ % ============================================================================ \KOMAProvidesFile{scrwfile-de.tex} - [$Date: 2022-07-17 12:36:46 +0200 (So, 17. Jul 2022) $ + [$Date: 2023-03-31 16:23:35 +0200 (Fr, 31. Mär 2023) $ KOMA-Script guide (chapter: scrwfile)] \chapter{Dateien mit \Package{scrwfile} sparen und ersetzen} \labelbase{scrwfile} \BeginIndexGroup -\BeginIndex{Package}{scrwfile} -Eines der Probleme, die auch durch die Einführung von \eTeX{} nicht gelöst -wurden, ist die Tatsache, dass \TeX{} nur 18 Dateien gleichzeitig zum Schreiben -geöffnet haben kann. Diese Zahl erscheint zunächst recht groß. Allerdings ist -zu berücksichtigen, dass bereits \LaTeX{} selbst einige dieser Dateien -belegt. Inhaltsverzeichnis, Tabellenverzeichnis, Abbildungsverzeichnis, Index, -Glossar und jedes weitere Verzeichnis, das von \LaTeX{} aus erzeugt wird, -belegt in der Regel eine weitere Datei. Dazu kommen Hilfsdateien von Paketen -wie \Package{hyperref} oder \Package{minitoc}. - -Im Endeffekt kann es daher geschehen, dass irgendwann die Meldung -\begin{lstcode} +\BeginIndex{Package}{scrwfile}% +Von Version 3.10 bis 3.38 war das Paket +\href{https://www.ctan.org/pkg/scrwfile}{\Package{scrwfile}} Bestandteil von +\KOMAScript. Danach wurde es als eigenständiges Paket aus \KOMAScript{} +herausgelöst. Das erschien und erscheint noch immer sinnvoll, weil das Paket +immer experimentell und ohne offizielle Unterstützung war. Darüber hinaus +lautet schon seit einiger Zeit die Empfehlung, stattdessen \LuaLaTeX{} zu +verwenden, da mit \LuaLaTeX{} das Grundproblem: +\begin{lstoutput} ! No room for a new \write . \ch@ck ...\else \errmessage {No room for a new #3} \fi -\end{lstcode} -erscheint. Seit einiger Zeit ist die einfachste Lösung dieses Problems die -Verwendung von \LuaLaTeX{} anstelle von PDF\LaTeX{} oder \XeLaTeX. Damit -entfällt die Beschränkung und die maximale Anzahl der gleichzeitig zum -Schreiben geöffneten Dateien wird nur noch durch das Betriebssystem -bestimmt. In der Realität braucht man sich darüber dann normalerweise keine -Gedanken mehr zu machen. - -Dass \LaTeX{} bei Verzeichnissen wie dem Inhaltsverzeichnis, dem -Tabellenverzeichnis und dem Abbildungsverzeichnis immer sofort eine neue Datei -zum Schreiben öffnet, hat aber auch noch einen weiteren Nachteil. Solche -Verzeichnisse werden durch deren Befehle nicht nur direkt gesetzt, sie können -auch kein weiteres Mal gesetzt werden, da die zugehörige Hilfsdatei nach dem -jeweiligen Befehl bis zum Ende des Dokuments leer ist. - -Das Paket \Package{scrwfile} bietet hier eine grundsätzliche Änderung im -\LaTeX-Kern, durch die beide Probleme nicht nur für \LuaLaTeX{} sondern auch -bei Verwendung von PDF\LaTeX{} oder \XeLaTeX{} gelöst werden können. - - -\section{Grundsätzliche Änderungen am \LaTeX-Kern} -\seclabel{kernelpatches} - -\LaTeX-Klassen verwenden zum Öffnen eines Verzeichnisses, beispielsweise mit -\Macro{tableofcontents} oder \Macro{listoffigures}, die \LaTeX-Kern-Anweisung -\Macro{@starttoc}\IndexCmd{@starttoc}. \LaTeX{} selbst lädt bei dieser -Anweisung nicht nur die zugehörige Hilfsdatei, sondern öffnet diese Hilfsdatei -auch neu zum Schreiben. Werden anschließend mit \Macro{addtocontents} oder -\Macro{addcontentsline} Einträge in dieses Verzeichnis vorgenommen, so wird -jedoch nicht direkt in die geöffnete Hilfsdatei geschrieben. Stattdessen -schreibt \LaTeX{} \Macro{@writefile}-Anweisungen\IndexCmd{@writefile} in die -\File{aux}-Datei. Erst beim Einlesen der \File{aux}-Dateien am Ende des -Dokuments wird dann über diese \Macro{@writefile}-Anweisungen in die -tatsächlichen Hilfsdateien geschrieben. Die Hilfsdateien werden von \LaTeX{} -auch nicht explizit geschlossen. Stattdessen verlässt sich \LaTeX{} hier -darauf, dass \TeX{} die Dateien am Ende ohnehin schließt. - -Dieses Vorgehen sorgt dafür, dass die Hilfsdateien zwar erst innerhalb von -\Macro{end}\PParameter{document} tatsächlich beschrieben werden, aber trotzdem -während des gesamten \LaTeX-Laufs gleichzeitig offen sind. \Package{scrwfile} -hat nun genau hier einen Ansatzpunkt: die Umdefinierung von \Macro{@starttoc} -und \Macro{@writefile}. - -Natürlich\textnote{Achtung!} besitzen Änderungen am \LaTeX-Kern immer das -Potential, dass es zu Unverträglichkeiten mit anderen Paketen kommen -kann. Betroffen können in erster Linie Pakete sein, die ebenfalls -\Macro{@starttoc} oder \Macro{@writefile} umdefinieren. In einigen Fällen kann -es helfen, die Reihenfolge der Pakete zu ändern.% -\iffalse % Umbruchkorrektur -\ Wenn Sie auf ein solches Problem stoßen, sollten Sie sich an den -\KOMAScript-Autor wenden.5 -\fi - -\section{Das Eindateiensystem} -\seclabel{singlefilefeature} - -Bereits beim Laden des Pakets mit -% Umbruchoptimierung: listings -\begin{lstcode} - \usepackage{scrwfile} -\end{lstcode} -wird \Macro{@starttoc}\IndexCmd{@starttoc} von \Package{scrwfile} so -umdefiniert, dass davon selbst keine Datei mehr zum Schreiben angefordert und -geöffnet wird. Unmittelbar vor dem Schließen der \File{aux}-Datei in -\Macro{end}\PParameter{document} wird dann \Macro{@writefile} so umdefiniert, -dass diese Anweisung statt in die eigentlichen Hilfsdateien in eine neue -Hilfsdatei mit der Endung \File{wrt} schreibt. Nach dem Einlesen der -\File{aux}-Dateien wird schließlich die \File{wrt}-Datei abgearbeitet und zwar -ein Mal für jede der Hilfsdateien, in die mit \Macro{@writefile} geschrieben -wird. Dabei muss aber nicht jede dieser Hilfsdateien gleichzeitig -geöffnet sein. Stattdessen ist immer nur eine zum Schreiben geöffnet und wird -auch wieder explizit geschlossen. Da dabei eine interne Schreibdatei von -\LaTeX{} wiederverwendet wird, benötigt \Package{scrwfile} keine einzige -eigene Schreibdatei für diese Art von Verzeichnissen. - -Selbst wenn bisher nur mit einem Inhaltsverzeichnis gearbeitet wird, steht -nach dem Laden des Pakets bereits eine Schreibdatei mehr für -Literaturverzeichnisse, Stichwortverzeichnisse, Glossare und ähnliche -Verzeichnisse, die nicht mit \Macro{@starttoc} arbeiten, zur -Verfügung. Darüber hinaus können beliebig viele Verzeichnisse, die mit -\Macro{@starttoc}\IndexCmd{@starttoc} arbeiten, angelegt werden.% -% - -\section{Das Klonen von Dateieinträgen} -\seclabel{clonefilefeature} - -Nachdem \Macro{@writefile}\IndexCmd{@writefile} für das Eindateiensystem aus -dem vorherigen Abschnitt bereits so geändert wurde, dass es nicht direkt in -die entsprechende Hilfsdatei schreibt, lag eine weitere Idee nahe. Beim -Kopieren der \Macro{@writefile}-Anweisungen in die \File{wrt}-Datei können -diese auch für andere Zielendungen übernommen werden. Es sei ausdrücklich -darauf hingewiesen, dass dies nur in der Dokumentpräambel funktioniert. - -\begin{Declaration} - \Macro{TOCclone}\OParameter{Verzeichnisüberschrift} - \Parameter{Quellendung}\Parameter{Zielendung} - \Macro{listof\PName{Zielendung}} -\end{Declaration}% -Durch dieses Klonen von Dateieinträgen werden so ganze Verzeichnisse -geklont. Dazu muss man nur die Endung der Hilfsdatei des Verzeichnisses -kennen, dessen Einträge kopiert werden sollen. Zusätzlich muss man die Endung -einer Zieldatei angeben. In diese werden die Einträge dann kopiert. Natürlich -kann man in dieses geklonte Verzeichnis auch zusätzliche Einträge -schreiben. +\end{lstoutput} +nicht mehr existiert. -Die \PName{Zielendung} der Zieldatei wird mit Hilfe von -\hyperref[cha:tocbasic]{\Package{tocbasic}}% -\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} (siehe -\autoref{cha:tocbasic}) verwaltet. Steht eine solche Datei bereits unter -Kontrolle von \hyperref[cha:tocbasic]{\Package{tocbasic}} wird eine Warnung -ausgegeben. Anderenfalls wird mit Hilfe von -\hyperref[cha:tocbasic]{\Package{tocbasic}} ein neues Verzeichnis für diese -Endung angelegt. Die Überschrift des neuen Verzeichnisses kann man über das -optionale Argument \PName{Verzeichnisüberschrift} bestimmen. - -Ausgeben kann man dieses neue Verzeichnis dann beispielsweise über die -Anweisung \Macro{listof\PName{Zielendung}}. Die -Verzeichniseigenschaften\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} -\PValue{leveldown}, \PValue{numbered}, \PValue{onecolumn} und \PValue{totoc} -(siehe Anweisung \DescRef{tocbasic.cmd.setuptoc} in -\autoref{sec:tocbasic.toc}, \DescPageRef{tocbasic.cmd.setuptoc}) werden -automatisch in das Zielverzeichnis übernommen, falls sie für das -Quellverzeichnis bereits gesetzt waren. Die Eigenschaft \PValue{nobabel} wird -für geklonte Verzeichnisse immer gesetzt, da die entsprechenden -\Package{babel}-Einträge in das Quellverzeichnis ohnehin bereits kopiert -werden. - -\begin{Example} - Angenommen, Sie wollen zusätzlich zum normalen Inhaltsverzeichnis eine - Gliederungsübersicht, in der nur die Kapitel angezeigt werden. -\begin{lstcode} - \usepackage{scrwfile} - \TOCclone[Gliederungsübersicht]{toc}{stoc} -\end{lstcode} - Hierdurch wird zunächst ein neues Verzeichnis mit der Überschrift - »Gliederungsübersicht« angelegt. Das neue Verzeichnis verwendet die - Dateiendung \File{stoc}. Alle Einträge in die Datei mit der Endung - \File{toc} werden auch in dieses Verzeichnis kopiert. - - Damit dieses neue Verzeichnis nun nur die Kapitelebene ausgibt, verwenden - wir: -\begin{lstcode} - \addtocontents{stoc}{\protect\value{tocdepth}=0} -\end{lstcode} - Während\textnote{Achtung!} normalerweise erst ab - \Macro{begin}\PParameter{document} Einträge in ein Verzeichnis vorgenommen - werden können, funktioniert dies nach Laden von \Package{scrwfile} bereits - in der Dokumentpräambel. Durch die hier gezeigte unkonventionelle Art, den - Zähler \DescRef{maincls.counter.tocdepth} innerhalb der Verzeichnisdatei zu - ändern, bleibt diese Änderung nur für dieses Verzeichnis wirksam. - - Später im Dokument wird das Verzeichnis mit der Endung \File{stoc} dann - durch -\begin{lstcode}[moretexcs={listofstoc}] - \listofstoc -\end{lstcode} - ausgegeben und zeigt nur die Teile und Kapitel des Dokuments. - - Etwas schwieriger wird es, wenn das Inhaltsverzeichnis in der - Gliederungsübersicht angezeigt werden soll. Dies wäre zwar mit -\begin{lstcode} - \addtocontents{toc}{% - \protect\addxcontentsline - {stoc}{chapter}{\protect\contentsname}% - } -\end{lstcode} - möglich. Da jedoch alle Einträge in \File{toc} auch nach \File{stoc} kopiert - werden, würde so von der Gliederungsübersicht dieser Eintrag ebenfalls - übernommen. Also darf der Eintrag nicht aus der Verzeichnisdatei heraus - erzeugt werden. Da das Paket \hyperref[cha:tocbasic]{\Package{tocbasic}}% - \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} zum Einsatz kommt, - kann aber% - \phantomsection\xmpllabel{cmd.BeforeStartingTOC}% -\begin{lstcode} - \BeforeStartingTOC[toc]{% - \addxcontentsline{stoc}{chapter} - {\protect\contentsname}} -\end{lstcode} - verwendet werden. Natürlich\textnote{Achtung!} setzt dies voraus, dass die - Datei mit Endung \File{toc} auch unter der Kontrolle von - \hyperref[cha:tocbasic]{\Package{tocbasic}} steht. Dies ist bei allen - \KOMAScript-Klassen der Fall. Näheres zur Anweisung - \DescRef{tocbasic.cmd.BeforeStartingTOC} ist in \autoref{sec:tocbasic.toc} - auf \DescPageRef{tocbasic.cmd.BeforeStartingTOC} zu finden. Die Erklärung zu - \DescRef{tocbasic.cmd.addxcontentsline} findet sich in demselben Abschnitt - auf \DescPageRef{tocbasic.cmd.addxcontentsline}.% -\end{Example}% -\EndIndexGroup% -\ExampleEndFix - - -\section{Hinweis zum Entwicklungsstand} -\seclabel{draft} - -Obwohl das Paket bereits von mehreren Anwendern getestet wurde und vielfach im -Einsatz ist, ist es vom Autor als experimentell eingestuft. Deshalb ist es -theoretisch möglich, dass insbesondere an der internen Funktionsweise des -Pakets noch Änderungen vorgenommen werden. Teilweise befindet sich auch Code -für zusätzliche Erweiterungen im Paket. Da jedoch keine Benutzeranweisungen -existieren, mit denen diese Möglichkeiten genutzt werden könnten, wurde auf -eine Dokumentation derselben verzichtet. - - -\section{Bekannte Paketunverträglichkeiten} -\seclabel{incompatible} - -Wie in \autoref{sec:scrwfile.kernelpatches} bereits erwähnt, muss -\Package{scrwfile} einige wenige Anweisungen des \LaTeX-Kerns -umdefinieren. Dies geschieht nicht allein während des Ladens des Pakets, -sondern vielmehr zu verschiedenen Zeitpunkten während der Abarbeitung eines -Dokuments, beispielsweise vor dem Einlesen der -\File{aux}-Datei. Das\textnote{Achtung!} führt dazu, dass \Package{scrwfile} -sich nicht mit anderen Paketen verträgt, die dieselben Anweisungen ebenfalls -zur Laufzeit umdefinieren. - -Ein Beispiel für eine solche Unverträglichkeit ist -\Package{titletoc}\important{\Package{titletoc}}\IndexPackage{titletoc}. Das -Paket definiert unter gewissen Umständen \Macro{@writefile} zur Laufzeit -um. Werden \Package{scrwfile} und \Package{titletoc} zusammen verwendet, ist -die Funktion beider Paket nicht mehr gewährleistet. Dies ist weder ein Fehler -in \Package{titletoc} noch in \Package{scrwfile}.% -% +Sollten Sie das Paket dennoch verwendet haben und weiterhin benötigen, so kann +es getrennt installiert wird. Verwenden Sie dazu vorzugsweise den Paketmanager +Ihrer \TeX-Distribution. Näheres zu dem Paket finden Sie im +CTAN-Katalogeintrag \cite{package:scrwfile}.% \EndIndexGroup %%% Local Variables: @@ -278,8 +60,4 @@ in \Package{titletoc} noch in \Package{scrwfile}.% %%% eval: (flyspell-mode 1) %%% End: -% LocalWords: Eindateiensystem Schreibdatei Zieldatei Zielendung Quellendung -% LocalWords: Verzeichnisüberschrift Dateiendung Zielendungen Verzeichnisdatei -% LocalWords: Benutzeranweisungen Dokumentpräambel Kapitelebene -% LocalWords: Paketunverträglichkeiten Verzeichniseigenschaften - +% LocalWords: herausgelöst Paketmanager CTAN Katalogeintrag diff --git a/macros/latex/contrib/koma-script/doc/scrwfile-en.tex b/macros/latex/contrib/koma-script/doc/scrwfile-en.tex index 5d87d4f994..e7cee8896e 100644 --- a/macros/latex/contrib/koma-script/doc/scrwfile-en.tex +++ b/macros/latex/contrib/koma-script/doc/scrwfile-en.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrwfile-en.tex -% Copyright (c) Markus Kohm, 2010-2022 +% Copyright (c) Markus Kohm, 2010-2023 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -24,236 +24,34 @@ % ============================================================================ \KOMAProvidesFile{scrwfile-en.tex}% - [$Date: 2022-07-17 12:36:46 +0200 (So, 17. Jul 2022) $ + [$Date: 2023-03-31 16:23:35 +0200 (Fr, 31. Mär 2023) $ KOMA-Script guide (chapter: scrwfile)] -\translator{Markus Kohm\and Jana Schubert\and Karl Hagen} +\translator{Markus Kohm} \chapter{Economising and Replacing Files with \Package{scrwfile}} \labelbase{scrwfile} \BeginIndexGroup \BeginIndex{Package}{scrwfile} -One of the problems not solved by the introduction of \eTeX{} is the fact that -\TeX{} can support only 18 open write handles. This number seems quite large -at first, but many of these handles are already reserved. \TeX{} itself uses -handle 0 for the log file. \LaTeX{} needs handle 1 for \Macro{@mainaux}, -handle 2 for \Macro{@partaux}, one handle for \Macro{tableofcontents}, one -handle for \Macro{listoffigures}, one handle for \Macro{listoftables}, and one -handle for \Macro{makeindex}. Every other such list generates another handle, -and packages like \Package{hyperref} or \Package{minitoc} require write -handles too. - -The bottom line is that eventually you may get the following error message: -\begin{lstcode} +From version 3.10 to 3.38, the package +\href{https://www.ctan.org/pkg/scrwfile}{\Package{scrwfile}} was part of +\KOMAScript. After that, it was separated from \KOMAScript{} as a standalone +package. This seemed and still seems reasonable because the package was always +experimental and without official support. Moreover, for some time now the +recommendation has been to use \LuaLaTeX{} instead, since with \LuaLaTeX{} the +basic problem: +\begin{lstoutput} ! No room for a new \write . \ch@ck ...\else \errmessage {No room for a new #3} - \fi -\end{lstcode} - -For some time, the simplest solution to this problem has been to use -\mbox{\LuaLaTeX} instead of \mbox{pdf\LaTeX} or \XeLaTeX. This eliminates the -restriction, and the maximum number of files you can have open for writing is -then limited only by the operating system. In reality, you usually so not need -to worry about it any more. - -The fact that \LaTeX{} always opens a new file for writing every table of -contents, list of figures, list of tables, etc. has another disadvantage. Such -lists are not only output by their respective commands, they also could not be -output a second time because the associated auxiliary file\footnote{The term - \emph{auxiliary file} here refers not to the main \File{aux} file but to the - other internal files used indirectly via the \File{aux} file, e.\,g. the - \File{toc} file, the \File{lof} file, or the \File{lot} file.} is empty -after the respective command until the end of the document. - -The \Package{scrwfile} package makes a fundamental change to the \LaTeX{} -kernel, which can solve both problems not only for \mbox{\LuaLaTeX} but also -for \mbox{pdf\LaTeX} or \XeLaTeX. - -\section{Fundamental Changes to the \LaTeX{} Kernel} -\seclabel{kernelpatches} - -\LaTeX{} classes use the \LaTeX{} kernel command -\Macro{@starttoc}\IndexCmd{@starttoc} to allocate a new file handle, such as -for \Macro{tableofcontents} or \Macro{listoffigures}. This command not only -loads the associated auxiliary file but also reopens it for writing. If -entries to these lists are added using \Macro{addcontentsline}, however, the -system does not write directly to these auxiliary files. Instead, \LaTeX{} -writes \Macro{@writefile}\IndexCmd{@writefile} commands to the \File{aux} -file. Only while reading the \File{aux} file at the end of the document do -those \Macro{@writefile} commands become actual write operations in the -auxiliary files. Additionally, \LaTeX{} does not close the auxiliary files -explicitly. Instead it relies on \TeX{} to close all open files at the end. - -This procedure ensures that the auxiliary files are only written to within -\Macro{end}\PParameter{document}, but they remain open throughout the entire -\LaTeX{} run. \Package{scrwfile} takes is starting point here, by redefining -\Macro{@starttoc} and \Macro{@writefile}. - -Of course\textnote{Attention!} changes to the \LaTeX{} kernel always have the -potential to cause incompatibilities with other packages. Those primarily -affected may be those which also redefine \Macro{@starttoc} or -\Macro{@writefile}. In some cases, it may help to change the order the -packages are loaded. If you encounter such a problem, please contact the -\KOMAScript{} author. - -\section{The Single-File Method} -\seclabel{singlefilefeature} - -As soon as the package is loaded with -\begin{lstcode} - \usepackage{scrwfile} -\end{lstcode} -\Package{scrwfile} redefines \Macro{@starttoc}\IndexCmd{@starttoc} so that it -no longer allocates a write handle or opens a file for writing. -\Macro{@writefile} is redefined so that immediately before closing the -\File{aux} file in \Macro{end}\PParameter{document}, it writes not to the -usual auxiliary files but to a single new file with extension \File{wrt}. -After reading the \File{aux} file, this \File{wrt} file will be processed once -for each of the auxiliary files that \Macro{@writefile} writes information to. -However these auxiliary files do not all have to be open at the same time. -Instead, only one is open at a time and is explicitly closed afterwards. Since -\LaTeX{} reuses an internal write file, \Package{scrwfile} doesn't need its -own write handle for this type of table of contents or list of floating -environments. - -Because of this behaviour, even if you have only one table of contents, once -you load \Package{scrwfile} you will have access to a write file handle for -bibliographies, indexes, glossaries, and similar lists that do not use -\Macro{@starttoc}. Additionally, you can create any number of tables of -contents and other lists that use \Macro{@starttoc}\IndexCmd{@starttoc}. - -\section{The File Cloning Method} -\seclabel{clonefilefeature} - -Since \Macro{@writefile}\IndexCmd{@writefile} has already been modified for -the single-file method described in the previous system so that it no longer -writes directly to the corresponding auxiliary file, a further possibility -suggests itself. When copying the \Macro{@writefile} statements into the -\File{wrt} file, you can also copy them to other destinations. It should be -explicitly noted that this only works in the document preamble. - -\begin{Declaration} - \Macro{TOCclone}% - \OParameter{list heading}\Parameter{source extension}% - \Parameter{destination extension} -\end{Declaration} -This cloning of file entries copies entire tables of contents or other lists. -For this, you only need to specify the extension of the auxiliary file whose -entries should be copied and the extension of a destination file. The entries -are then copied there. Of course, you can also write additional entries to -this cloned file. - -You can manage the \PName{destination extention} using -\hyperref[cha:tocbasic]{\Package{tocbasic}}% -\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} (see -\autoref{cha:tocbasic}). If such a file is already under the control of -\hyperref[cha:tocbasic]{\Package{tocbasic}}, a warning will be issued. -Otherwise, a new list for this extension will be created using -\hyperref[cha:tocbasic]{\Package{tocbasic}}. You can set the heading for this -list with the optional argument \PName{list heading}. - -You can then output this new content list, for example, with the command -\Macro{listof\PName{destination extension}}. The content-list -attributes\important{\hyperref[cha:tocbasic]{\Package{tocbasic}}} -\PValue{leveldown}, \PValue{numbered}, \PValue{onecolumn}, and \PValue{totoc} -(see \DescRef{tocbasic.cmd.setuptoc} in \autoref{sec:tocbasic.toc}, -\DescPageRef{tocbasic.cmd.setuptoc}) are automatically copied to the -destination list if they were already set in the source list. The -\PValue{nobabel} attribute is always set for cloned content lists, because the -language-selection commands in the source content list are already copied -anyway. - -\begin{Example} - Suppose you want a short table of contents with only the chapter level in - addition to the normal the table of contents: -\begin{lstcode} - \usepackage{scrwfile} - \TOCclone[Summary Contents]{toc}{stoc} -\end{lstcode} - This creates a new table of contents with the heading ``Summary Contents''. - The new table of contents uses an auxiliary file with the extension - \File{stoc}. All entries to the auxiliary file with extension \File{toc} - will also be copied to this new auxiliary file. - - In order to have the new short table of contents display only the chapter - entries, we use: -\begin{lstcode} - \addtocontents{stoc}{\protect\value{tocdepth}=0} -\end{lstcode} - Although\textnote{Attention!} normally you cannot write to an auxiliary file - before \Macro{begin}\PParameter{document}, the code above works in the - preamble after loading \Package{scrwfile}. Owing to the unconventional way - of changing the \DescRef{maincls.counter.tocdepth} counter within the TOC - file, this change only applies to this content list. - - Later in the document, we then output the content list with the file - extension \File{stoc} with: -\begin{lstcode}[moretexcs={listofsttoc}] - \listofstoc -\end{lstcode} - and this shows only the parts and chapters of the document. - - Things become a bit more difficult if the summary contents are to be - listed in the table of contents. This would seem to be possible with -\begin{lstcode} - \addtocontents{toc}{% - \protect\addxcontentsline - {stoc}{chapter}{\protect\contentsname}% - } -\end{lstcode} -However, since all entries in \File{toc} are also copied to \File{stoc}, this -entry would also be copied from the summary contents. So we cannot generate -the entry from the content list. Because we use the -\Package{tocbasic}\important{\Package{tocbasic}} package, we can use the -following: -\phantomsection\xmpllabel{cmd.BeforeStartingTOC} -\begin{lstcode} - \BeforeStartingTOC[toc]{% - \addcontentslinedefault{stoc}{chapter} - {\protect\contentsname}% - } -\end{lstcode} -Of course, this assumes that the \File{toc} file is under the control -of the \Package{tocbasic} package, which is indeed the case for all -\KOMAScript{} classes. See \autoref{sec:tocbasic.toc} on -\DescPageRef{tocbasic.cmd.BeforeStartingTOC} for more information about -\DescRef{tocbasic.cmd.BeforeStartingTOC}.% -\end{Example} -Incidentally, the \DescRef{tocbasic.cmd.addxcontentsline} command used in the -examples is also documented in \autoref{cha:tocbasic}, -\DescPageRef{tocbasic.cmd.addxcontentsline}.% -\EndIndexGroup - - -\section{Note on the State of Development} -\seclabel{draft} - -Although this package has already been tested by many users and is often in -production use, its development is still ongoing. Therefore, it is -theoretically possible that there might be changes, especially to the internal -functionality. It is likely that the package will be extended in the future. -Some code for such extensions is already in the package. However, as there are -no user commands that make use of these features, they are currently -undocumented. - -\section{Known Package Incompatibilities} -\seclabel{incompatible} - -As mentioned in \autoref{sec:scrwfile.kernelpatches}, \Package{scrwfile} -redefines some commands of the \LaTeX{} kernel. This happens not only while -loading the package, but indeed at various times while the document is -processed, for example just before reading the \File{aux} file. -This\textnote{Attention!} results in incompatibility with packages that also -redefine these commands at run time. - -The \Package{titletoc}\important{Package{titletoc}}\IndexPackage{titletoc} -package is an example for such an incompatibility. That package redefines -\Macro{@writefile} under some conditions at run time. If you use both -\Package{scrwfile} and \Package{titletoc}, there is no warranty for the -correct behaviour of either one. This is neither an error of -\Package{titletoc} nor of \Package{scrwfile}.% -% + \fi +\end{lstoutput} +no longer exists. + +If you have been using the package and still need it, you can install install +it separately. Preferably use the package manager of your \TeX{} +distribution. More information about the package can be found in the CTAN +catalog entry \cite{package:scrwfile}.% \EndIndexGroup %%% Local Variables: diff --git a/macros/latex/contrib/koma-script/doc/scrwfile.html b/macros/latex/contrib/koma-script/doc/scrwfile.html deleted file mode 100644 index de29ea7c82..0000000000 --- a/macros/latex/contrib/koma-script/doc/scrwfile.html +++ /dev/null @@ -1,57 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE html - PUBLIC "-//W3C//DTD XHTML 1.1//EN" - "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> - <head> - <meta name="keywords" content="KOMA-Script, scrwfile - <meta name="DC.Title" content="Economising and Replacing Files with scrwfile" /> - <meta name="DC.Creator" content="l3build" /> - <meta name="DC.Subject" content="KOMA-Script Documentation" /> - <meta name="DC.Description" content="Where to find the KOMA-Script - documentation of scrwfile" /> - <meta name="DC.Publisher" content="Markus kohm" /> - <meta name="DC.Date" content="2022-06-03" /> - <meta name="DC.Type" content="Text" /> - <meta name="DC.Format" content="text/html" /> - <meta name="DC.Identifier" content="scrwfile.html" /> - <meta name="DC.Language" content="en,de" /> - <meta name="DC.Relation" content="Link to documentation" /> - <meta name="DC.Coverage" content="Version since 3.00" /> - <meta name="DC.Rights" content="LaTeX Public Private License 1.3c" /> - <title>Economising and Replacing Files with scrwfile</title> - <style type="text/css"> - <!-- - body {} - #en { position:absolute; left:10px; width:45%; } - #de { position:absolute; right:10px; width:45%; } - #fn { position:absolute; bottom:0px; width:50%; - border-top-width:1px; border-top-style:solid; - font-size:x-small; } - h1.right { text-align:right; } - --> - </style> - </head> - <body> - <h1>Economising and Replacing Files with <tt>scrwfile</tt></h1> - <h1 class="right">Dateien mit <tt>scrwfile</tt> sparen und ersetzen</h1> - <div id="en"> - I think you are searching for the chapter - <a href="scrguide-en.pdf#chapter.14">“Economising and Replacing Files with <tt>scrwfile</tt>”</a> in the - KOMA-Script documentation. - </div> - <div id="de"> - Ich nehme an, Sie suchen nach dem Kapitel - <a href="scrguide-de.pdf#chapter.14">„Dateien mit <tt>scrwfile</tt> sparen und ersetzen”</a> in der - KOMA-Script-Anleitung. - </div> - <div id="fn"> - Markus Kohm, 2022-06-03 - <p><a - href="http://validator.w3.org/check?uri=referer"><img - src="http://www.w3.org/Icons/valid-xhtml11" alt="Valid XHTML 1.1" - height="31" width="88" /></a></p> - </div> - </body> -</html> - diff --git a/macros/latex/contrib/koma-script/doc/tocbasic-de.tex b/macros/latex/contrib/koma-script/doc/tocbasic-de.tex index bc9995cb3e..6f1a6de96e 100644 --- a/macros/latex/contrib/koma-script/doc/tocbasic-de.tex +++ b/macros/latex/contrib/koma-script/doc/tocbasic-de.tex @@ -1,6 +1,6 @@ % ====================================================================== % tocbasic-de.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-de.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)] \chapter{Verzeichnisse verwalten mit Hilfe von \Package{tocbasic}} @@ -196,14 +196,14 @@ diesen Besitzer setzt. Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% \important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens -Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, die -eigene Verzeichnisse bereitstellen. Bei Verwendung von -\hyperref[cha:scrhack]{\Package{scrhack}} wird unter anderem die jeweilige -Dateierweiterung der Liste der bekannten Dateierweiterungen hinzugefügt. Dabei -wird als \PName{Besitzer} »\PValue{float}« verwendet. Dies ist sozusagen der -grundlegende Baustein, um die Möglichkeiten von \Package{tocbasic} und der -\KOMAScript-Klassen auch für diese Verzeichnisse automatisch nutzen zu -können.% +Patches für mehrere Pakete wie \Package{float}\IndexPackage{float} oder +\Package{listings}\IndexPackage{listings}, die eigene Verzeichnisse +bereitstellen. Bei Verwendung von \hyperref[cha:scrhack]{\Package{scrhack}} +wird unter anderem die jeweilige Dateierweiterung der Liste der bekannten +Dateierweiterungen hinzugefügt. Dabei wird als \PName{Besitzer} +»\PValue{float}« verwendet. Dies ist sozusagen der grundlegende Baustein, um +die Möglichkeiten von \Package{tocbasic} und der \KOMAScript-Klassen auch für +diese Verzeichnisse automatisch nutzen zu können.% \EndIndexGroup @@ -533,16 +533,17 @@ dieser Anweisungen zu einer Fehlermeldung der Art \fi \end{lstoutput} führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in -diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets +diesem Fall das Laden von Paket \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} -oder die Verwendung von \LuaLaTeX{} bieten. +\cite{package:scrwfile} oder die Verwendung von \LuaLaTeX{} bieten. Das Paket \hyperref[cha:scrhack]{\Package{scrhack}}\IndexPackage{scrhack}% \important{ \hyperref[cha:scrhack]{\Package{scrhack}}} enthält übrigens -Patches für mehrere Pakete wie \Package{float} oder \Package{listings}, damit -deren Verzeichnisbefehle \Macro{listoftoc} verwenden. Dadurch stehen viele -Möglichkeiten von \Package{tocbasic} und den \KOMAScript-Klassen auch für -deren Verzeichnisse zur Verfügung.% +Patches für mehrere Pakete wie \Package{float}\IndexPackage{float} oder +\Package{listings}\IndexPackage{listings}, damit deren Verzeichnisbefehle +\Macro{listoftoc} verwenden. Dadurch stehen viele Möglichkeiten von +\Package{tocbasic} und den \KOMAScript-Klassen auch für deren Verzeichnisse +zur Verfügung.% \EndIndexGroup @@ -561,12 +562,7 @@ eingelesen werden, erreichen. Ebenso können Sie \PName{Anweisungen} nach dem Einlesen der Datei ausführen, wenn Sie diese mit \Macro{AfterStartingTOC} definieren. Während der Ausführung der \PName{Anweisungen} ist \Macro{@currext}\IndexCmd{@currext}\important{\Macro{@currext}} die -Dateierweiterung der Datei, die eingelesen wird bzw. gerade eingelesen wurde. - -Ein Beispiel\textnote{Beispiel} zur Verwendung von \Macro{BeforeStartingTOC} -ist in \autoref{sec:scrwfile.clonefilefeature} auf -\PageRefxmpl{scrwfile.cmd.BeforeStartingTOC} zu finden. -% +Dateierweiterung der Datei, die eingelesen wird bzw. gerade eingelesen wurde.% \EndIndexGroup @@ -687,9 +683,9 @@ Komma getrennte Folge von \PName{Eigenschaften}. Das Paket werden, die nur in einer festen Sprache erstellt werden, in denen also Sprachumschaltungen im Dokument nicht zu berücksichtigen sind. Sie wird außerdem vom Paket - \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} für - Klonziele verwendet, da die Erweiterungen dort bereits durch das Klonen - selbst aus der Klonquelle übernommen werden. + \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} + \cite{package:scrwfile} für Klonziele verwendet, da die Erweiterungen dort + bereits durch das Klonen selbst aus der Klonquelle übernommen werden. Es ist zu beachten\textnote{Achtung!}, dass die Eigenschaft bereits vor dem Hinzufügen der Dateierweiterung zu der Liste der bekannten @@ -1366,13 +1362,14 @@ mit dem Präfix \PValue{tocentry} zu verwenden, also beispielsweise Kopiermöglichkeit mit \Option{:=} ist hierbei ebenfalls verfügbar. Die Addition mit Hilfe von \Option{+=} wird derzeit jedoch nicht unterstützt. -Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung als Optionen -für \DescRef{maincls-experts.cmd.DeclareSectionCommand}% +Bei\ChangedAt{v3.20}{\Package{tocbasic}} Verwendung als Optionen für +\DescRef{maincls-experts.cmd.DeclareSectionCommand}% \IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}% \IndexCmd{RedeclareSectionCommand}\IndexCmd{ProvideSectionCommand} (siehe \DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) und verwandten Anweisungen sind die Namen der Eigenschaften mit dem Präfix \PValue{toc} zu -versehen, also beispielsweise \Option{toclevel} anstelle von \PValue{level}. Hierbei existiert derzeit weder die Kopiermöglichkeit mit +versehen, also beispielsweise \Option{toclevel} anstelle von +\PValue{level}. Hierbei existiert derzeit weder die Kopiermöglichkeit mit \Option{:=} noch die Addition mit \Option{+=}. Letztlich führt der Aufruf von \Macro{DeclareTOCStyleEntry} zur Definition der @@ -1521,10 +1518,12 @@ angegebenen Einstellungen definiert.% entsprechenden Eigenschaften existiert. Bei den Stilen \PValue{dottedtocline}, \PValue{undottedtocline} und \PValue{tocline} findet für die Eintragsebenen \PValue{part} bis \PValue{subparagraph} - sowie \PValue{figure} und \PValue{table} eine Initialisierung mit Werten - entsprechend der Standardklassen statt. Alle anderen Ebenen erhalten keine - Initialisierung. Für sie ist eine explizite Angabe daher bei der ersten - Verwendung zwingend. + sowie \PValue{figure}, \PValue{table} und + \ChangedAt{v3.39}{\Package{tocbasic}}\PValue{lstlisting} eine + Initialisierung mit Werten entsprechend der Standardklassen + beziehungsweise des Paket \Package{listings}\IndexPackage{listings} + statt. Alle anderen Ebenen erhalten keine Initialisierung. Für sie ist + eine explizite Angabe daher bei der ersten Verwendung zwingend. Ist für ein Verzeichnis die Eigenschaft \PValue{noindent} via \DescRef{\LabelBase.cmd.setuptoc} gesetzt, so ignorieren die Einträge bei @@ -1559,11 +1558,14 @@ angegebenen Einstellungen definiert.% \PValue{tocline}, \PValue{toctext} und \PValue{undottedtocline} findet für die \PName{Eintragsebene} \PValue{part}, \PValue{chapter}, \PValue{section}, \PValue{subsection}, \PValue{subsubsection}, - \PValue{paragraph}, \PValue{subparagraph}, \PValue{figure} und - \PValue{table} automatisch eine Initialisierung aufgrund des Namens - statt. Für andere Ebenen findet eine Initialisierung mit dem Wert der - Gliederungsebene statt, falls kompatibel zu den \KOMAScript-Klassen - \Macro{\PName{Eintragsebene}numdepth} definiert ist.% + \PValue{paragraph}, \PValue{subparagraph}, \PValue{figure}, \PValue{table} + und \ChangedAt{v3.39}{\Package{tocbasic}}\PValue{lstlisting} automatisch + eine Initialisierung aufgrund des Namens statt. Für andere Ebenen findet + eine Initialisierung mit dem Wert der Gliederungsebene statt, falls + kompatibel zu den \KOMAScript-Klassen + \Macro{\PName{Eintragsebene}numdepth} definiert ist. Als letzter Ausweg + kann auch das interne \Package{hyperref}-Makro + \Macro{toclevel@\PName{Eintragsebene}} herangezogen werden.% }% \entry{\OptionVName{linefill}{Code}}{% Beim Stil \PValue{tocline} kann zwischen dem Ende des Eintragstextes und @@ -1610,10 +1612,12 @@ angegebenen Einstellungen definiert.% vorgenommen, falls eine solche Ebene mit entsprechender Eigenschaft existiert. Bei den Stilen \PValue{dottedtocline}, \PValue{undottedtocline} und \PValue{tocline} findet für die Eintragsebenen \PValue{part} bis - \PValue{subparagraph} sowie \PValue{figure} und \PValue{table} eine - Initialisierung mit Werten entsprechend der Standardklassen statt. Alle - anderen Ebenen erhalten keine Initialisierung. Für sie ist eine explizite - Angabe daher bei der ersten Verwendung zwingend.% + \PValue{subparagraph} sowie \PValue{figure}, \PValue{table} und + \ChangedAt{v3.39}{\Package{tocbasic}}\PValue{lstlisting} eine + Initialisierung mit Werten entsprechend der Standardklassen + beziehungsweise des Pakets \Package{listings}\IndexPackage{listings} + statt. Alle anderen Ebenen erhalten keine Initialisierung. Für sie ist + eine explizite Angabe daher bei der ersten Verwendung zwingend.% }% \entry{\OptionVName{onendentry}{Code}}{% \ChangedAt{v3.27}{\Package{tocbasic}}% @@ -2133,9 +2137,9 @@ Anweisung zu einer Fehlermeldung der Art \fi \end{lstoutput} führen, wenn keine Schreibdateien mehr zur Verfügung stehen. Abhilfe kann in -diesem Fall das Laden des in \autoref{cha:scrwfile} beschriebenen Pakets +diesem Fall das Laden des Pakets \Package{scrwfile}\important{\Package{scrwfile}}\IndexPackage{scrwfile} -oder die Verwendung von \LuaLaTeX{} bieten.% +\cite{package:scrwfile} oder die Verwendung von \LuaLaTeX{} bieten.% \EndIndexGroup diff --git a/macros/latex/contrib/koma-script/doc/tocbasic-en.tex b/macros/latex/contrib/koma-script/doc/tocbasic-en.tex index b4f0a1174e..768c933207 100644 --- a/macros/latex/contrib/koma-script/doc/tocbasic-en.tex +++ b/macros/latex/contrib/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 |