summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex93
1 files changed, 58 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
index d6614e2c972..9d9b3faed2b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrhack.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% 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-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ============================================================================
\KOMAProvidesFile{scrhack.tex}
- [$Date: 2017-03-31 12:00:24 +0200 (Fri, 31 Mar 2017) $
+ [$Date: 2018-02-05 10:50:56 +0100 (Mon, 05 Feb 2018) $
KOMA-Script guide (chapter: scrhack)]
\chapter{Fremdpakete verbessern mit \Package{scrhack}}
@@ -60,13 +60,14 @@ mühsam, die Autoren der jeweiligen Pakete von einer Verbesserung zu
überzeugen. Das betrifft auch Pakete, deren Entwicklung eingestellt
wurde. Deshalb wurde das Paket \Package{scrhack} begonnen. Dieses Paket ändert
Anweisungen und Definitionen anderer Pakete, damit sie besser mit
-\KOMAScript{} zusammenarbeiten.
+\KOMAScript{} zusammenarbeiten. Einige Änderungen sind auch bei
+Verwendung anderer Klassen nützlich.
\section{Entwicklungsstand}
\seclabel{draft}
Obwohl das Paket bereits seit längerer Zeit Teil von \KOMAScript{} ist und
-auch bereits von vielen Anwendern genutzt wird, hat es auch ein Problem. Bei
+von vielen Anwendern genutzt wird, hat es auch ein Problem: Bei
der Umdefinierung von Makros fremder Pakete ist es von der genauen Definition
und Verwendung dieser Makros abhängig. Damit ist es gleichzeitig auch von
bestimmten Versionen dieser Pakete abhängig. Wird eine unbekannte Version
@@ -88,7 +89,7 @@ nicht dauerhaft garantiert werden.
In den Anfängen von \KOMAScript{} gab es von Anwenderseite den Wunsch, dass
Verzeichnisse von Gleitumgebungen, die mit dem Paket
\Package{float}\IndexPackage{float}\important{\Package{float}} erzeugt werden,
-genauso behandelt werden, wie das Abbildungsverzeichnis oder das
+genauso behandelt werden wie das Abbildungsverzeichnis oder das
Tabellenverzeichnis, das von den \KOMAScript-Klassen selbst angelegt
wird. Damals setzte sich der \KOMAScript-Autor mit dem Autor von
\Package{float} in Verbindung, um diesem eine Schnittstelle für entsprechende
@@ -135,10 +136,10 @@ stehen, ist \autoref{sec:tocbasic.toc} zu entnehmen.
Sollte diese Änderung für eines der Pakete nicht erwünscht sein oder zu
Problemen führen, so kann sie selektiv mit den Einstellungen
-\OptionValue{float}{false}\IndexOption[indexmain]{float~=\PValue{false}},
-\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\PValue{false}}
+\OptionValue{float}{false}\IndexOption[indexmain]{float~=\textKValue{false}},
+\OptionValue{floatrow}{false}\IndexOption[indexmain]{floatrow~=\textKValue{false}}
und
-\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\PValue{false}}
+\OptionValue{listings}{false}\IndexOption[indexmain]{listings~=\textKValue{false}}
abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung
der Optionen nach dem Laden des zugehörigen Pakets keinen Einfluss mehr hat!
@@ -155,17 +156,17 @@ Schriftgrößen erlaubt, kann dabei \Macro{@ptsize} natürlich auch zu einem
Dezimalbruch expandieren.
Eines\ChangedAt{v3.17}{\Package{scrhack}} der Pakete, die damit nicht zurecht
-kommen, ist das Paket
-\Package{setspace}\IndexPackage[indexmain]{setspace}. Darüber hinaus sind die
-von diesem Paket eingestellten Werte immer von der Grundschriftgröße abhängig,
-auch wenn die Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket
+kommen, ist das Paket \Package{setspace}\IndexPackage[indexmain]{setspace}%
+\important{\Package{setspace}}. Darüber hinaus sind die von diesem Paket
+eingestellten Werte immer von der Grundschriftgröße abhängig, auch wenn die
+Einstellung im Kontext einer anderen Schriftgröße erfolgt. Paket
\Package{scrhack} löst beide Probleme, indem es die Einstellungen von
\Macro{onehalfspacing} und \Macro{doublespacing} immer relativ zur aktuellen,
tatsächlichen Schriftgröße vornimmt.
Sollte diese Änderung nicht erwünscht sein oder zu Problemen führen, so kann
sie selektiv mit der Einstellung
-\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\PValue{false}}
+\OptionValue{setspace}{false}\IndexOption[indexmain]{setspace~=\textKValue{false}}
abgeschaltet werden. Wichtig\textnote{Achtung!} dabei ist, dass eine Änderung
der Option nach dem Laden von \Package{setspace} keinen Einfluss mehr hat!
Ebenso muss \Package{scrhack} vor \Package{setspace} geladen werden, falls
@@ -182,7 +183,7 @@ auswirken soll.
6.79h haben bei den Sternformen der Gliederungsbefehle hinter statt vor oder
auf die Gliederungsüberschriften verlinkt. Inzwischen ist dieses Problem auf
Vorschlag des \KOMAScript-Autors beseitigt. Da die entsprechende Änderung aber
-über ein Jahr auf sich warten lies, wurde in \Package{scrhack} ein
+über ein Jahr auf sich warten ließ, wurde in \Package{scrhack} ein
entsprechender Patch aufgenommen. Zwar kann dieser ebenfalls durch
\OptionValue{hyperref}{false} deaktiviert werden, empfohlen wird jedoch
stattdessen die aktuelle Version von \Package{hyperref} zu verwenden. In
@@ -193,7 +194,8 @@ diesem Fall wird die Änderung durch \Package{scrhack} automatisch verhindert.
\seclabel{lscape}
Das\ChangedAt{v3.18}{\Package{scrhack}} Paket
-\Package{lscape}\IndexPackage[indexmain]{lscape} definiert eine Umgebung
+\Package{lscape}\IndexPackage[indexmain]{lscape}%
+\important{\Package{lscape}} definiert eine Umgebung
\Environment{landscape}\IndexEnv{landscape}, um den Inhalt einer Seite aber
nicht deren Kopf und Fuß quer zu setzen. Innerhalb dieser Umgebung wird
\Length{textheight}\IndexLength{textheight} auf den Wert von
@@ -206,12 +208,12 @@ und in der Tat beschädigt sie die Funktion beispielsweise der Pakete
\Package{showframe}\IndexPackage{showframe} und
\Package{scrlayer}\IndexPackage{scrlayer}. Daher wäre es am besten, wenn
\Length{textheight} ebenfalls unverändert bliebe. \Package{scrhack} verwendet
-Paket \Package{xpatch} (siehe \cite{package:xpatch}) um die Startanweisung
+Paket \Package{xpatch} (siehe \cite{package:xpatch}), um die Startanweisung
\Macro{landscape} der gleichnamigen Umgebung entsprechend zu ändern.
Falls diese Änderung nicht gewünscht wird oder Probleme verursacht, kann sie
mit Option
-\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\PValue{false}}
+\OptionValue{lscape}{false}\IndexOption[indexmain]{lscape~=\textKValue{false}}
deaktiviert werden. Es ist zu beachten\textnote{Achtung!}, dass eine
nachträgliche Zuweisung an Option \Option{lscape} mit
\DescRef{\LabelBase.cmd.KOMAoption}\IndexCmd{KOMAoption} oder
@@ -219,33 +221,54 @@ nachträgliche Zuweisung an Option \Option{lscape} mit
hat, wenn sie während des Ladens von \Package{lscape} nicht \PValue{false}
war.
-Im übrigens\textnote{Achtung!} wird \Package{lscape} auch von dem Paket
-\Package{pdflscape}\IndexPackage[indexmain]{pdflscape} verwendet, so dass
-\Package{scrhack} sich auch auf die Funktion dieses Pakets auswirkt.%
+Im übrigens wird \Package{lscape} auch von dem Paket
+\Package{pdflscape}\IndexPackage[indexmain]{pdflscape}%
+\important{\Package{pdflscape}} verwendet, so dass \Package{scrhack} sich auch
+auf die Funktion dieses Pakets auswirkt.%
\section{Sonderfall \Package{nomencl}}
\seclabel{nomencl}
Eine\ChangedAt{v3.23}{\Package{scrhack}} Besonderheit stellt der Hack für das
-Paket \Package{nomencl}\IndexPackage[indexmain]{nomencl} dar. Dieser rüstet
-einerseits nach, dass der optionale Inhaltsverzeichniseintrag für die
-Nomenklatur Option \OptionValueRef{maincls}{toc}{indentunnumbered}
-beachtet. Quasi nebenbei werden aber auch gleich die Endungen \File{nlo} und
-\File{nls} über das Paket \Package{tocbasic} reserviert (siehe
+Paket
+\Package{nomencl}\IndexPackage[indexmain]{nomencl}\important{\Package{nomencl}}
+dar. Dieser rüstet einerseits nach, dass der optionale
+Inhaltsverzeichniseintrag für die Nomenklatur Option
+\OptionValueRef{maincls}{toc}{indentunnumbered} beachtet. Quasi nebenbei
+werden über das Paket \Package{tocbasic} auch gleich die Endungen \File{nlo}
+und \File{nls} für den Besitzer \PValue{nomencl} reserviert (siehe
\DescRef{tocbasic.cmd.addtotoclist}, \autoref{sec:tocbasic.basics},
-\DescPageRef{tocbasic.cmd.addtotoclist}). Darüber hinaus können mit dem Hack
+\DescPageRef{tocbasic.cmd.addtotoclist}).
+
+Außerdem wird die Umgebung
+\Environment{thenomenclature}\IndexEnv{thenomenclature} so geändert,
+dass \DescRef{tocbasic.cmd.tocbasic@listhead}\IndexCmd{tocbasic@listhead} für
+die Überschrift verwendet wird (siehe \autoref{sec:tocbasic.internals},
+\DescPageRef{tocbasic.cmd.tocbasic@listhead}). Dadurch können mit dem Hack
diverse Attribute für die Endung \File{nls} über
-\DescRef{tocbasic.cmd.setuptoc} gesetzt werden. So ist es beispielsweise
-möglich, mit
+\DescRef{tocbasic.cmd.setuptoc}\IndexCmd{setuptoc}%
+\important{\DescRef{tocbasic.cmd.setuptoc}} gesetzt werden. So ist es
+beispielsweise möglich, mit
\DescRef{tocbasic.cmd.setuptoc}\PParameter{nls}\PParameter{numbered} die
Nomenklatur nicht nur ins Inhaltsverzeichnis einzutragen sondern auch gleich
-zu nummerieren. Als weiterer Nebeneffekt erhält die Nomenklatur mit diesem
-Hack außerdem einen passenden Kolumnentitel, falls lebende Kolumnentitel
-beispielsweise durch Verwendung von Seitenstil
-\DescRef{maincls.pagestyle.headings} aktiviert wurden. All dies wird mit einem
-kleinen Patch der Umgebung \Environment{thenomenclature} erreicht.%
-%
+zu nummerieren. Näheres zu \DescRef{tocbasic.cmd.setuptoc} und den damit
+möglichen Einstellungen ist in \autoref{sec:tocbasic.toc}, ab
+\DescPageRef{tocbasic.cmd.setuptoc} zu finden. Als kleiner aber wichtiger
+Nebeneffekt erhält die Nomenklatur mit diesem Patch außerdem einen passenden
+Kolumnentitel, falls lebende Kolumnentitel beispielsweise durch Verwendung von
+Seitenstil \DescRef{maincls.pagestyle.headings} aktiviert wurden.
+
+Dieser eher simple Patch ist damit ein Beispiel dafür, wie auch Pakete, die
+keine Gleitumgebungen definieren, Nutzen aus der Verwendung von
+\Package{tocbasic} ziehen könnten. Falls diese Änderung jedoch nicht
+gewünscht wird oder Probleme verursacht, kann sie mit Option
+\OptionValue{nomencl}{false}\IndexOption[indexmain]{nomencl~=\textKValue{false}}
+deaktiviert werden. Entscheidend\textnote{Achtung!} ist dabei die Einstellung
+der Option zum Zeitpunkt, zu dem \Package{nomencl} geladen wird! Spätere
+Änderungen der Option mit \DescRef{\LabelBase.cmd.KOMAoption} oder
+\DescRef{\LabelBase.cmd.KOMAoptions} haben also keinen Einfluss und führen zu
+einer entsprechenen Warnung.%
\EndIndexGroup