diff options
author | Karl Berry <karl@freefriends.org> | 2013-12-26 23:18:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-12-26 23:18:36 +0000 |
commit | 9b219d1b664067729034647a4b37626cf2bf5e26 (patch) | |
tree | 00708467b44f90736dc32ed1bebb95e9c4710139 /Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlfile.tex | |
parent | c00c8298eb6913b74270a36c1f1018f1e9946f7b (diff) |
koma-script (26dec13)
git-svn-id: svn://tug.org/texlive/trunk@32489 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.tex | 102 |
1 files changed, 95 insertions, 7 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 ea00f9fa9b3..c7dfe74b3f1 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-2012 +% Copyright (c) Markus Kohm, 2001-2013 % % 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-2012 +% Copyright (c) Markus Kohm, 2001-2013 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -45,7 +45,9 @@ % % ============================================================================ -\ProvidesFile{scrlfile.tex}[2012/02/25 KOMA-Script guide (chapter: scrlfile)] +\KOMAProvidesFile{scrlfile.tex} + [$Date: 2013-11-24 10:49:38 +0100 (So, 24. Nov 2013) $ + KOMA-Script guide (chapter: scrlfile)] \chapter{Paketabhängigkeiten mit \Package{scrlfile} beherrschen} @@ -605,6 +607,28 @@ mit Hilfe von \Macro{RequirePackage} vor der Klasse zu laden. \EndIndex{Cmd}{ReplacePackage}% \EndIndex{Cmd}{ReplaceClass}% +\begin{Declaration} + \Macro{UnReplaceInput}\Parameter{Dateinamen}\\ + \Macro{UnReplacePackage}\Parameter{Paket}\\ + \Macro{UnReplaceClass}\Parameter{Klasse}% +\end{Declaration} +\BeginIndex{Cmd}{UnReplaceInput}% +\BeginIndex{Cmd}{UnReplacePackage}% +\BeginIndex{Cmd}{UnReplaceClass}% +Eine\ChangedAt{v3.12}{\Package{scrlfile}} Ersetzung kann auch wieder +aufgehoben werden. Dabei sollten Ersetzungen von Dateien immer mit +\Macro{UnReplaceInput}, Ersetzungen von Paketen mit \Macro{UnReplacePackage} +und Ersetzungen von Klassen mit \Macro{UnReplaceClass} aufgehoben werden. Nach +der Aufhebung der Ersetzung führen Ladebefehle für den entsprechenden +\PName{Dateiname}, das entsprechende \PName{Paket} oder die entsprechende +\PName{Klasse} dann wieder dazu, dass die Datei, das Paket oder die Klasse +selbst an Stelle der Ersatzdatei, des Ersatzpakets oder der Ersatzklasse +geladen wird.% +\EndIndex{Cmd}{UnReplaceClass}% +\EndIndex{Cmd}{UnReplacePackage}% +\EndIndex{Cmd}{UnReplaceInput}% + + \section{Dateien gar nicht erst einlesen} \label{sec:scrlfile.prevent} @@ -616,9 +640,13 @@ zu einem Problem kommt, muss man irgendwie das Laden des problematischen Paketes verhindern. Auch hier bietet \Package{scrlfile} eine einfache Lösung. \begin{Declaration} - \Macro{PreventPackageFromLoading}\Parameter{Paketliste} + \Macro{PreventPackageFromLoading}\OParameter{Stattdessencode}% + \Parameter{Paketliste}\\ + \Macro{PreventPackageFromLoading*}\OParameter{Stattdessencode}% + \Parameter{Paketliste} \end{Declaration} \BeginIndex{Cmd}{PreventPackageFromLoading}% +\BeginIndex{Cmd}{PreventPackageFromLoading*}% Wird diese Anweisung\ChangedAt{v3.08}{\Package{scrlfile}} vor dem Laden eines Paket mit \Macro{usepackage}\IndexCmd{usepackage}, \Macro{RequirePackage}\IndexCmd{RequirePackage} oder @@ -650,7 +678,22 @@ Wie im Beispiel zu sehen ist, kann man das Paket \Package{scrlfile} auch bereits vor der Klasse laden. In diesem Fall muss das Laden dann aber mit Hilfe von \Macro{RequirePackage}\IndexCmd{RequirePackage} erfolgen, da \Macro{usepackage} vor \Macro{documentclass} verboten ist. -% + +Wird eine leere \PName{Paketliste} angegeben, oder wird ein Paket angegeben, +das bereits geladen ist, so gibt \Macro{PreventPackageFromLoading} eine +Warnung aus, während +\Macro{PreventPackageFromLoading*}\ChangedAt{v3.12}{\Package{scrlfile}} +lediglich einen entsprechenden Hinweis in die Log-Datei schreibt. + +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 +\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!% +\EndIndex{Cmd}{PreventPackageFromLoading*}% \EndIndex{Cmd}{PreventPackageFromLoading} \begin{Declaration} @@ -699,14 +742,59 @@ An dieser Stelle sei darauf hingewiesen, dass Sie bei Manipulationen an der mit \Macro{StorePreventPackageFromLoading} zwischengespeicherten Liste selbst die Verantwortung für eine korrekte Wiederherstellbarkeit tragen. So muss die Liste unbedingt mit Komma separiert sein, sollte keine Leerzeichen oder -Gruppenklammern enthalten und muss voll expandierbar sein. -% +Gruppenklammern enthalten und muss voll expandierbar sein.% + +Beachten\textnote{Achtung!} Sie bitte auch, dass +\Macro{ResetPreventPackageFromLoading} den \PName{Stattdessencode} für ein +Paket nicht löscht, sondern nur vorübergehend dessen Ausführung nicht mehr +erfolgt.% \EndIndex{Cmd}{ResetPreventPackageFromLoading}% \EndIndex{Cmd}{StorePreventPackageFromLoading}% + +\begin{Declaration} + \Macro{UnPreventPackageFromLoading}\Parameter{Paketliste}\\ + \Macro{UnPreventPackageFromLoading*}\Parameter{Paketliste} +\end{Declaration} +\BeginIndex{Cmd}{UnPreventPackageFromLoading}% +\BeginIndex{Cmd}{UnPreventPackageFromLoading*}% +Statt\ChangedAt{v3.12}{\Package{scrlfile}} die Liste der Pakete, für die das +Laden verhindert werden soll, komplett zurück zu setzen, kann man auch +einzelne oder mehrere Pakete gezielt von dieser Liste entfernen. Die +Sternvariante des Befehls löscht außerdem den \PName{Stattdessencode}, der für +das Paket gespeichert ist. Falls die Verhinderungsliste beispielsweise aus +einer gespeicherten Liste wiederhergestellt wird, wird dann der +\PName{Stattdessencode} trotzdem nicht mehr ausgeführt.% +% +\begin{Example} + Angenommen, Sie wollen zwar verhindern, dass ein Paket \Package{foo} + geladen wird, wollen aber nicht, dass ein eventuell bereits gespeicherter + \PName{Stattdessencode} ausgeführt wird. Stattdessen soll nur Ihr neuer + \PName{Stattdessencode} ausgeführt werden. Dies ist wie folgt möglich: +\begin{lstcode} + \UnPreventPackageFromLoading*{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. + + Natürlich können Sie die Anweisung indirekt auch nutzen, um den + \PName{Stattdessencode} aller Pakete zu löschen: +\begin{lstcode} + \StorePreventPackageFromLoading\TheWholePreventList + \UnPreventPackageFromLoading*{\TheWholePreventList} + \PreventPackageFromLoading{\TheWholePreventList} +\end{lstcode} + Die Pakete werden dann zwar noch immer nicht geladen, ihr + \PName{Stattdessencode} existiert aber nicht mehr und wird nicht mehr + ausgeführt.% +\end{Example}% +\EndIndex{Cmd}{UnPreventPackageFromLoading*}% +\EndIndex{Cmd}{UnPreventPackageFromLoading}% % \EndIndex{Package}{scrlfile} %%% Local Variables: %%% mode: latex +%%% coding: iso-latin-1 %%% TeX-master: "../guide" %%% End: |