diff options
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/english/scrhack.tex')
-rw-r--r-- | macros/latex/contrib/koma-script/source-doc/english/scrhack.tex | 52 |
1 files changed, 47 insertions, 5 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex index a7dfac605c..5a7fc200a1 100644 --- a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex +++ b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex @@ -1,6 +1,6 @@ % ====================================================================== % scrhack.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % scrhack.tex -% Copyright (c) Markus Kohm, 2001-2018 +% Copyright (c) Markus Kohm, 2001-2019 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,11 +46,12 @@ % ============================================================================ \KOMAProvidesFile{scrhack.tex} - [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $ + [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $ KOMA-Script guide (chapter: scrhack)] \translator{Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2018-02-05 +% Date of the translated German file: 2019-10-09 + \chapter{Improving Third-Party Packages with \Package{scrhack}} \labelbase{scrhack} @@ -213,7 +214,7 @@ package also uses \Package{lscape}, so \Package{scrhack} affects the functioning of this package too.% -\section{Special Case \Package{nomencl}} +\section{Special Case for \Package{nomencl}} \label{sec:nomencl} The\ChangedAt{v3.23}{\Package{scrhack}} hack for the @@ -251,6 +252,47 @@ The\textnote{Achtung!} setting of the option when \Package{nomencl} is loaded is crucial! Later changes to the option with \DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions} have no influence and will lead to a corresponding warning.% + + +\section{Special Case for Section Headings} +\seclabel{sections} + +Various\ChangedAt{v3.27}{\Package{scrhack}} packages assume that the +sectioning commands are defined in a specific way, corresponding to the +definitions in the standard classes. But for some classes this is not the +case. For example, the \KOMAScript{} classes use a completely different +implementation to provide many additional features. But this can cause +problems for packages that depend on the definition of the standard classes. +As of version~3.27, \Package{scrhack} offers the option to force the +sectioning commands \DescRef{maincls.cmd.part}\IndexCmd{part}, +\DescRef{maincls.cmd.chapter}\IndexCmd{chapter}, +\DescRef{maincls.cmd.section}\IndexCmd{section}, +\DescRef{maincls.cmd.subsection}\IndexCmd{subsection}, +\DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection}, +\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph}, and +\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} to be compatible +with those in the standard classes. When \DescRef{maincls.cmd.chapter} is +defined, the definitions are based on those in \Class{book}. When +\DescRef{maincls.cmd.chapter} is undefined, the definitions of +\Class{article} are used. + +If you are using a \KOMAScript{} class, several features of these classes are +also deactivated as side effect. For example, the commands to define or +modify sectioning commands described in +\autoref{sec:maincls-experts.sections} or option +\DescRef{maincls.option.headings} are no longer available, and commands like +\DescRef{maincls.cmd.partformat} have different defaults. + +Because this hack has the potential to do more harm than good, it issues +several warnings. Also it is not activated simply by loading the +\Package{scrhack} package. If you want to use it, you must explicitly activate +it with the \Option{standardsections}\IndexOption[indexmain]{standardsections} +option when you load the package. Late activation or deactivation is not +supported. + +Since there are often less invasive solutions to fix the problem of package +incompatibilities, using this hack is not recommended. It is provided only as +a last resort for emergencies.% \EndIndexGroup \endinput |