summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-12-06 23:18:10 +0000
committerKarl Berry <karl@freefriends.org>2014-12-06 23:18:10 +0000
commit4832d732052d6e2b43b5e3ff45aa31bfbc0cbdc2 (patch)
tree968a3b4cdf4631c0272fc725330ea28a554c8471 /Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
parent59d9a998c6236de39603cb2ea077c5371e06b842 (diff)
koma-script (6dec14)
git-svn-id: svn://tug.org/texlive/trunk@35754 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex84
1 files changed, 45 insertions, 39 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
index c7dfe74b3f1..e5d8d096da7 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2013
+% Copyright (c) Markus Kohm, 2001-2014
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2013
+% Copyright (c) Markus Kohm, 2001-2014
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -45,8 +45,8 @@
%
% ============================================================================
-\KOMAProvidesFile{scrlfile.tex}
- [$Date: 2013-11-24 10:49:38 +0100 (So, 24. Nov 2013) $
+\KOMAProvidesFile{scrlfile.tex}%
+ [$Date: 2014-03-07 09:38:29 +0100 (Fri, 07 Mar 2014) $
KOMA-Script guide (chapter: scrlfile)]
\chapter{Paketabhängigkeiten mit \Package{scrlfile}
@@ -68,6 +68,7 @@ erfüllt.
\section{Die Sache mit den Paketabhängigkeiten}
\label{sec:scrlfile.dependency}
%\begin{Explain}
+ \iffree{}{\looseness=1\relax}% Umbruchkorrektur
Immer häufiger definieren unterschiedliche Pakete den gleichen
Befehl neu oder um. Dabei ist es dann sehr entscheidend, in welcher
Reihenfolge die Pakete geladen werden. Manchmal ist das für den
@@ -142,7 +143,7 @@ ausgeführt werden. Vergleichbar arbeitet \Macro{AfterFile}. Nur werden die
\PName{Anweisungen} hier erst nach dem Laden der \PName{Datei}
ausgeführt. Wird die Datei nie geladen, so werden die \PName{Anweisungen} in
beiden Fällen natürlich auch nie ausgeführt. Bei \PName{Datei} sind etwaige
-Dateiendungen wie bei \Macro{input} alt Teil des Dateinamens anzugeben.
+Dateiendungen wie bei \Macro{input} als Teil des Dateinamens anzugeben.
Um die Funktionalität bereitstellen zu können, bedient sich \Package{scrlfile}
der bekannten \LaTeX-Anweisung
@@ -208,7 +209,7 @@ seinem Namen und nicht mit seinem Dateinamen angegeben wird. Die Endungen
\Macro{AfterPackage*}\Parameter{Paket}\Parameter{Anweisungen}\\
\Macro{AfterPackage+}\Parameter{Paket}\Parameter{Anweisungen}\\
\Macro{AfterPackage!}\Parameter{Paket}\Parameter{Anweisungen}\\
- \Macro{AfterAtEndOfPackage}\Parameter{Klasse}\Parameter{Anweisungen}
+ \Macro{AfterAtEndOfPackage}\Parameter{Paket}\Parameter{Anweisungen}
\end{Declaration}%
Die Anweisungen \Macro{AfterClass} und \Macro{AfterPackage} arbeiten
weitgehend wie \Macro{AfterFile} mit dem winzigen Unterschied, dass die
@@ -225,10 +226,10 @@ ausgeführt.
Bei\important[i]{\Macro{AfterClass+}\\\Macro{AfterPackage+}} der
Plusvariante\ChangedAt{v3.09}{\Package{scrlfile}} werden die
\PName{Anweisungen} sicher erst dann ausgeführt, wenn die Klasse oder das
-Paket vollständig geladen wurden. Der Unterschied zwischen der Stern- und der
-Plusvariante kommt nur zum Tragen, wenn die Anweisung verwendet wird, wenn das
-Laden der Klassen bzw. des Pakets zwar bereits begonnen hat, aber noch nicht
-beendet wurde. Wenn das Laden der Klasse bzw. des Pakets noch nicht
+Paket vollständig geladen wurde. Der Unterschied zwischen der Stern- und der
+Plusvariante kommt nur zum Tragen, falls die Anweisung verwendet wird, während
+das Laden der Klassen bzw. des Pakets zwar bereits begonnen hat, aber noch
+nicht beendet wurde. Wenn das Laden der Klasse bzw. des Pakets noch nicht
abgeschlossen wurde, werden die \PName{Anweisungen} in allen Fällen vor den in
der Klasse bzw. dem Paket mit \Macro{AtEndOfClass} oder \Macro{AtEndOfPackage}
verzögerten Anweisungen ausgeführt.
@@ -269,7 +270,7 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
}
\end{lstcode}
Alte Versionen von \Package{hyperref} definierten ein Makro von
- \Class{scrbook} in einer Weise um, so dass es mit neueren Versionen
+ \Class{scrbook} in einer Weise um, die mit neueren Versionen
von \KOMAScript{} nicht mehr funktioniert. Neuere Versionen von
\Package{hyperref} unterlassen dies, wenn sie eine neuere Version
von \KOMAScript{} erkennen. Für den Fall, dass \Package{hyperref}
@@ -278,7 +279,7 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
es sich um eine verträgliche Version handelt. Falls dies nicht der
Fall ist, wird eine Warnung ausgegeben.
- An anderer Stelle findet sich in drei \KOMAScript-Klassen Folgendes:
+ An anderer Stelle findet sich in drei der \KOMAScript-Klassen Folgendes:
\begin{lstcode}
\AfterPackage{caption2}{%
\renewcommand*{\setcapindent}{%
@@ -295,13 +296,13 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
Es gibt aber auch Beispiele für den sinnvollen Einsatz der neuen
Anweisungen durch normale Anwender. Angenommen, Sie erstellen ein
Dokument, aus dem sowohl eine PS-Datei mit \LaTeX{} und dvips als auch
- eine PDF-Datei mit pdf\LaTeX{} erstellt werden soll. Das Dokument soll
+ eine PDF-Datei mit \mbox{pdf\LaTeX} erstellt werden soll. Das Dokument soll
außerdem Hyperlinks aufweisen. Im Tabellenverzeichnis haben Sie
Einträge, die über mehrere Zeilen gehen. Nun gibt es zwar mit
- pdf\LaTeX{} bei der PDF-Ausgabe keine Probleme, da dort Links
+ \mbox{pdf\LaTeX} bei der PDF-Ausgabe keine Probleme, da dort Links
umbrochen werden können. Bei Verwendung des
\Package{hyperref}-Treibers für dvips oder
- hyper\TeX{} ist dies jedoch nicht
+ \mbox{hyper\TeX} ist dies jedoch nicht
möglich. In diesem Fall hätten Sie gerne, dass bei
\Package{hyperref} die Einstellung \Option{linktocpage} verwendet
wird. Die Entscheidung, welcher Treiber geladen wird, wird bei Ihnen
@@ -328,14 +329,14 @@ und für Pakete \Macro{AfterAtEndOfPackage}.%
\caption{Dies ist ein Beispiel mit einer
Abbildungsunterschrift, die etwas länglich ist
und bei der trotzdem auf die Verwendung des
- optionalen Arguments verzichtet wurde}
+ optionalen Arguments verzichtet wurde.}
\end{figure}
\end{document}
\end{lstcode}
Egal, ob nun der \Package{hyperref}-Treiber \Option{hypertex} oder
\Option{dvips} zu Anwendung kommt, wird die dann nützliche Einstellung
- \Option{linktocpage} verwendet. Wenn Sie jedoch mit pdf\LaTeX{} eine
- PDF-Datei erstellen, wird darauf verzichtet, da in diesem Fall der
+ \Option{linktocpage} verwendet. Wenn Sie jedoch mit \mbox{pdf\LaTeX} eine
+ PDF-Datei erstellen, wird darauf verzichtet, da dann der
\Package{hyperref}-Treiber \File{hpdftex.def} verwendet wird. Das bedeutet,
dass weder die Treiberdatei \File{hdvips.def} noch \File{hypertex.def}
geladen wird.
@@ -367,11 +368,13 @@ Optionen \Option{dvips} oder \Option{pdftex}, eingefügt werden.%
\Macro{BeforeClosingMainAux}\Parameter{Anweisungen}\\
\Macro{AfterReadingMainAux}\Parameter{Anweisungen}
\end{Declaration}
-Diese Anweisungen unterscheidet sich in einem Detail von den zuvor erklärten
+Diese Anweisungen unterscheiden sich in einem Detail von den zuvor erklärten
Anweisungen. Jene ermöglichen Aktionen vor und nach dem Laden von
-Dateien. Dies ist hier nicht der Fall. Paketautoren haben des Öfteren das
-Problem, dass Sie Anweisungen in die \File{aux}-Datei schreiben wollen,
-nachdem die letzte Seite des Dokuments ausgegeben wurde. Dies wird häufig mit
+Dateien. Das ist hier nicht der Fall. Paketautoren haben des Öfteren das
+Problem, dass sie Anweisungen in die \File{aux}-Datei schreiben wollen,
+nachdem die letzte Seite des Dokuments ausgegeben wurde. Dazu wird -- in
+Unkenntnis der dadurch verursachten Probleme -- häufig Code
+wie der folgende eingesetzt:
\begin{lstcode}[belowskip=\dp\strutbox]
\AtEndDocument{%
\if@filesw
@@ -381,14 +384,14 @@ nachdem die letzte Seite des Dokuments ausgegeben wurde. Dies wird häufig mit
\fi
}
\end{lstcode}
-versucht. Dies ist jedoch keine echte Lösung des Problems. Wurde die letzte
+Dies ist jedoch keine wirkliche Lösung. Wurde die letzte
Seite vor \Macro{end}\PParameter{document} bereits ausgegeben, so führt obiges
-zu keiner Ausgabe in die \File{aux}-Datei mehr. Würde man zur Lösung dieses
+zu keiner Ausgabe in die \File{aux}-Datei. Würde man zur Lösung dieses
Problems nun ein \Macro{immediate} vor \Macro{write} setzen, so hätte man das
umgekehrte Problem: wurde die letzte Seite bei
\Macro{end}\PParameter{document} noch nicht ausgegeben, so wird
\Macro{writethistoaux} zu früh in die \File{aux}-Datei geschrieben. Man sieht
-daher häufig Lösungsversuche wie:
+daher häufig auch Lösungsversuche wie:
\begin{lstcode}[belowskip=\dp\strutbox]
\AtEndDocument{%
\if@filesw
@@ -410,7 +413,7 @@ erzwungen wird. Eine Anweisung wie:
führt dann nicht mehr dazu, dass der Hinweis am Ende der letzten Seite des
Dokuments ausgegeben wird, sie würde stattdessen am Ende der nächsten Seite
ausgegeben. Gleichzeitig würde \Macro{writethistoaux} wieder eine Seite zu
-früh in der \File{aux}-Datei landen.
+früh in die \File{aux}-Datei geschrieben.
Die beste Lösung des Problems wäre nun, wenn man unmittelbar in die
\File{aux}-Datei schreiben könnte, nachdem das finale \Macro{clearpage}
@@ -426,10 +429,11 @@ innerhalb von \Macro{end}\PParameter{document} ausgeführt, aber bevor die
\fi
}
\end{lstcode}
-Dies ist auch dann erfolgreich, wenn das finale \Macro{clearpage} innerhalb
+Das ist auch dann erfolgreich, wenn das finale \Macro{clearpage} innerhalb
von \Macro{end}\PParameter{document} tatsächlich zu keiner Ausgabe einer Seite
-mehr führt oder wenn \Macro{clearpage} innerhalb einer
-\Macro{AtEndDocument}-Anweisung verwendet wurde.
+mehr führt oder wenn -- sei es korrekt verwendet oder in Unkenntnis der oben
+erläuterten Probleme -- \Macro{clearpage} innerhalb einer
+\Macro{AtEndDocument}-Anweisung zum Einsatz kam.
Es gibt jedoch für \Macro{BeforeClosingMainAux} eine Einschränkung: Im
Argument \Macro{Anweisungen} sollte keine Satzanweisung verwendet
@@ -457,7 +461,7 @@ an dieser Stelle noch kritischer zu betrachten als bei
In den bisherigen Abschnitten wurden Anweisungen erklärt, mit denen es möglich
ist, vor oder nach dem Einlesen einer bestimmten Datei, eines bestimmten
-Pakets oder einer Klasse, Aktionen auszuführen. Es ist mit \Package{scrlfile}
+Pakets oder einer Klasse Aktionen auszuführen. Es ist mit \Package{scrlfile}
aber auch möglich, eine ganz andere Datei als die angeforderte einzulesen.
\BeginIndex{Cmd}{ReplaceInput}%
@@ -511,7 +515,7 @@ der Klasse passen. Eine Lösung dieses Problems finden Sie nachfolgend.
\Macro{ReplacePackage}\Parameter{Paket}\Parameter{Ersatzpaket}
\end{Declaration}
Eine\ChangedAt{v2.96}{\Package{scrlfile}}\textnote{Achtung!} Klasse oder ein
-Paket sollte niemals mit Hilfe der oben erklären Anweisung
+Paket sollte niemals mit Hilfe der oben erklärten Anweisung
\Macro{ReplaceInput} ersetzt werden. In diesem Fall würde \LaTeX{} eine
Warnung über nicht übereinstimmende Klassen- oder Paketnamen melden.
\begin{Example}
@@ -531,7 +535,7 @@ Warnung über nicht übereinstimmende Klassen- oder Paketnamen melden.
\end{Example}
Eine Lösung dieses Problems besteht nun darin, statt \Macro{ReplaceInput} eine
der Anweisungen \Macro{ReplaceClass} oder \Macro{ReplacePackage} zu
-verwenden. Es ist zu beachten, dass dabei wie bei \Macro{documentclass} und
+verwenden. Es ist zu beachten, dass wie bei \Macro{documentclass} und
\Macro{usepackage} der Name der Klasse oder des Pakets und nicht deren
kompletter Dateiname anzugeben ist.
@@ -552,7 +556,7 @@ ersetzt, das eine geforderte Option nicht unterstützt, würde dies zu den
\begin{Example}
Angenommen, das Paket \Package{oldfoo} soll beim Laden durch das
- Paket{newfoo} ersetzt werden. Dies wird mit:
+ Paket \Package{newfoo} ersetzt werden. Dies wird mit:
\begin{lstcode}
\ReplacePackage{oldfoo}{newfoo}
\end{lstcode}
@@ -635,7 +639,7 @@ geladen wird.%
Gerade\ChangedAt{v3.08}{\Package{scrlfile}} in Klassen und Paketen, die
innerhalb von Firmen oder Instituten verwendet werden, findet man häufig, dass
sehr viele Pakete nur deshalb geladen werden, weil die Anwender diese Pakete
-häufig verwenden. Wenn es dann mit einem dieser automatisch geladenen Paketen
+oft verwenden. Wenn es dann mit einem dieser automatisch geladenen Paketen
zu einem Problem kommt, muss man irgendwie das Laden des problematischen Paketes
verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung.
@@ -689,7 +693,7 @@ Das optionale Argument\ChangedAt{v3.12}{\Package{scrlfile}} kann verwendet
werden, wenn an Stelle des Ladens des Pakets etwas anderes getan werden
soll. Innerhalb des \PName{Stattdessencode}s dürfen jedoch keine anderen
Pakete und keine Dateien geladen werden. Zum Laden eines anderen Pakets siehe
-\Macro{ReplacePackage} in \autoref{sec:scrlfile.macros} auf
+\Macro{ReplacePackage} in \autoref{sec:scrlfile.replace} auf
\autopageref{desc:scrlfile.cmd.ReplacePackage}. Beachten Sie bitte auch, dass
der \PName{Stattdessencode} mehrfach ausgeführt wird, falls Sie versuchen,
das Paket mehrfach zu laden!%
@@ -735,7 +739,7 @@ können wieder alle Pakete geladen werden.
werden würde, wenn diese bereits anderweitig definiert wäre. Eine vorhandene
Definition würde also ohne Rücksicht überschrieben werden. In diesem
Beispiel wurde deshalb mit einem vorherigen \Macro{newcommand*}
- sichergestellt, dass in diesem Fall zur Sicherheit eine Fehlermeldung
+ sichergestellt, dass in dem Fall zur Sicherheit eine Fehlermeldung
ausgegeben wird.
\end{Example}
An dieser Stelle sei darauf hingewiesen, dass Sie bei Manipulationen an der mit
@@ -772,10 +776,12 @@ einer gespeicherten Liste wiederhergestellt wird, wird dann der
\PName{Stattdessencode} ausgeführt werden. Dies ist wie folgt möglich:
\begin{lstcode}
\UnPreventPackageFromLoading*{foo}
- \PreventPackageFromLoading[\typeout{Stattdessencode}]{foo}
+ \PreventPackageFromLoading[%
+ \typeout{Stattdessencode}%
+ ]{foo}
\end{lstcode}
- Sollte das Paket zuvor gar nicht vom Laden ausgenommen worden sein, so spielt
- dies für die Anweisung \Macro{UnPreventPackageFromLoading*} keine Rolle.
+ Für die Anweisung \Macro{UnPreventPackageFromLoading*} ist es unerheblich,
+ ob das Paket zuvor überhaupt vom Laden ausgenommen war.
Natürlich können Sie die Anweisung indirekt auch nutzen, um den
\PName{Stattdessencode} aller Pakete zu löschen: