diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex | 174 |
1 files changed, 120 insertions, 54 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex index 005ec57f86a..84463e8fd40 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex @@ -1,6 +1,6 @@ % ====================================================================== % typearea-experts.tex -% Copyright (c) Markus Kohm, 2008-2015 +% Copyright (c) Markus Kohm, 2008-2017 % % This file is part of the LaTeX2e KOMA-Script bundle. % @@ -18,7 +18,7 @@ % This work consists of all files listed in manifest.txt. % ---------------------------------------------------------------------- % typearea-experts.tex -% Copyright (c) Markus Kohm, 2008-2015 +% Copyright (c) Markus Kohm, 2008-2017 % % Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, % Version 1.3c, verteilt und/oder veraendert werden. @@ -46,12 +46,14 @@ % ====================================================================== \KOMAProvidesFile{typearea-experts.tex} - [$Date: 2015-05-21 15:48:01 +0200 (Thu, 21 May 2015) $ + [$Date: 2017-01-02 13:27:16 +0100 (Mon, 02 Jan 2017) $ KOMA-Script guide (chapter: typearea for experts)] \chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}} \labelbase{typearea-experts} +\BeginIndexGroup +\BeginIndex{Package}{typearea} In diesem Kapitel finden Sie zusätzliche Informationen zum Paket \Package{typearea}. \iffree{Einige Teile des Kapitels sind dabei dem \KOMAScript-Buch \cite{book:komascript} vorbehalten. Dies sollte kein @@ -66,6 +68,73 @@ Gründen der Kompatibilität zu früheren Versionen von \KOMAScript{} existieren, sind in serifenloser Schrift gesetzt und sollten nicht mehr verwendet werden. +\section{Experimentelle Möglichkeiten} +\seclabel{experimental} + +In diesem Abschnitt werden experimentelle Möglichkeiten +beschrieben. Experimentell bedeutet in diesem Zusammenhang, dass die Funktion +nicht garantiert werden kann. Dafür kann es zwei Gründe geben. Zum einen +steht die endgültige Funktion oder Implementierung eventuell noch nicht +abschließend fest. Zum anderen hängen die Möglichkeiten teilweise von Interna +anderer Pakete ab und können deshalb in ihrer Funktion nur so lange garantiert +werden, wie diese anderen Pakete nicht geändert werden. + +\begin{Declaration} + \OptionVName{usegeometry}{Ein-Aus-Wert} +\end{Declaration} +Normalerweise kümmert sich \Package{typearea} wenig darum, ob es in irgend +einer Konstellation zusammen mit dem Paket +\Package{geometry}\IndexPackage{geometry} (siehe \cite{package:geometry}) +verwendet wird. Das bedeutet insbesondere, dass \Package{geometry} nach wie +vor nichts davon mit bekommt, wenn man mit \Package{typearea} beispielsweise +die Papiergröße ändert -- etwas, das \Package{geometry} selbst gar nicht +bietet. + +Sobald Option \Option{usegeometry} gesetzt wird versucht \Package{typearea} +alle eigenen Optionen auch in Optionen für \Package{geometry} zu übersetzen +und innerhalb des Dokuments wird sogar \Macro{newgeometry} aufgerufen, wenn +neue Parameter aktiviert werden (siehe \DescRef{\LabelBase.cmd.activateareas} +im nachfolgenden Abschnitt). Da \Package{geometry} keine Änderung der +Papiergröße oder Papierausrichtung via \Macro{newgeometry} bietet, wird diese +bei Bedarf über interne Anweisungen und Längen von \Package{geometry} +umgesetzt. Getestet ist dies für \Package{geometry}~5.3 bis 5.6. + +Die Option bedeutet übrigens nicht, dass bei Verwendung von \Package{geometry} +nach einer Papiergrößen- oder Papierausrichtungsänderung mit +\Package{typearea} das neue Papier direkt optimal genutzt wird. Da +\Package{geometry} aus Komfortgründen deutlich mehr Optionen für die +Papiereinstellung bietet, als für die Bestimmung von Textbereich, Rändern, +Kopf, Fuß etc. benötigt werden -- man spricht von \emph{Überbestimmung} -- und +gleichzeitig bei neuen Aufrufen von \Macro{newgeometry} fehlende Angaben aus +bereits bekannten ableitet -- man spricht von \emph{Werterhalt} --, +muss man gegebenenfalls durch explizite vollständige Bestimmung neuer Werte +bei einem eigenen Aufruf von \Macro{newgeometry} alle gewünschten +Einstellungen explizit vornehmen. Nichts desto Trotz kann die Berücksichtigung +von \Package{geometry} durch \Package{typearea} zusätzliche Möglichkeiten +eröffnen.% +\EndIndexGroup + + +\begin{Declaration} + \OptionVName{areasetadvanced}{Ein-Aus-Wert} + \Macro{areaset}\OParameter{BCOR}\Parameter{Breite}\Parameter{Höhe} +\end{Declaration} +Normalerweise berücksichtigt \DescRef{typearea.cmd.areaset} Optionen zur +Bestimmung der Höhe von Kopf und Fuß oder zur Festlegung, ob Randelemente Teil +des Satzspiegels sein sollen, nicht in gleicher Weise wie +\DescRef{typearea.cmd.typearea}. Mit Option \Option{areasetadvanced} kann +jedoch eingestellt werden, dass sich \DescRef{typearea.cmd.areaset} +diesbezüglich mehr wie \DescRef{typearea.cmd.typearea} verhalten +soll. Trotzdem unterscheiden sich Einstellungen, die zu gleich großen +Textbereichen führen zwischen den beiden Befehlen weiterhin, da +\DescRef{typearea.cmd.typearea} immer auf ganze Zeile rundet und dabei +gegebenenfalls den unteren Rand um bis zu eine Zeile kleiner wählt, während +\DescRef{typearea.cmd.areaset} den oberen und unteren Rand immer im Verhältnis +1:2 einstellt. Die Textbereiche der unterschiedlichen Befehle können also bei +gleicher Größe vertikal leicht verschoben sein.% +\EndIndexGroup + + \section{Anweisungen für Experten} \seclabel{experts} @@ -77,14 +146,13 @@ gedacht sind, sind sie kürzer gefasst. \begin{Declaration} \Macro{activateareas} \end{Declaration}% -\BeginIndex{Cmd}{activateareas}% -Diese Anweisung wird von \Package{typearea} genutzt, um die Einstellungen -für Satzspiegel und Ränder in die internen \LaTeX-Längen zu übertragen, wenn -der Satzspiegel innerhalb des Dokuments, also nach +Diese Anweisung wird von \Package{typearea} genutzt, um die Einstellungen für +Satzspiegel und Ränder in die internen \LaTeX-Längen zu übertragen, wenn der +Satzspiegel innerhalb des Dokuments, also nach \Macro{begin}\PParameter{document} neu berechnet wurde. Wurde die Option -\Option{pagesize} verwendet, so wird diese anschließend mit demselben Wert -neu aufgerufen. Damit kann beispielsweise innerhalb von PDF-Dokumenten die -Seitengröße tatsächlich variieren. +\DescRef{typearea.option.pagesize} verwendet, so wird diese anschließend mit +demselben Wert neu aufgerufen. Damit kann beispielsweise innerhalb von +PDF-Dokumenten die Seitengröße tatsächlich variieren. Experten können diese Anweisung auch verwenden, wenn Sie aus irgendwelchen Gründen Längen wie \Length{textwidth} oder \Length{textheight} innerhalb des @@ -93,20 +161,16 @@ notwendige Seitenumbrüche vor oder nach der Verwendung jedoch selbst verantwortlich! Darüber hinaus sind alle von \Macro{activateareas} durchgeführten Änderungen lokal!% % -\EndIndex{Cmd}{activateareas} +\EndIndexGroup + \begin{Declaration} - \Macro{storeareas}\Parameter{Anweisung}\\ - \Macro{BeforeRestoreareas}\Parameter{Code}\\ - \Macro{BeforeRestoreareas*}\Parameter{Code}\\ - \Macro{AfterRestoreareas}\Parameter{Code}\\ + \Macro{storeareas}\Parameter{Anweisung} + \Macro{BeforeRestoreareas}\Parameter{Code} + \Macro{BeforeRestoreareas*}\Parameter{Code} + \Macro{AfterRestoreareas}\Parameter{Code} \Macro{AfterRestoreareas*}\Parameter{Code} \end{Declaration} -\BeginIndex{Cmd}{storeareas}% -\BeginIndex{Cmd}{BeforeRestoreareas}% -\BeginIndex{Cmd}{BeforeRestoreareas*}% -\BeginIndex{Cmd}{AfterRestoreareas}% -\BeginIndex{Cmd}{AfterRestoreareas*}% Mit Hilfe von \Macro{storeareas} wird eine \PName{Anweisung} definiert, über die alle aktuellen Seitenspiegeleinstellungen wieder hergestellt werden können. So ist es möglich, die aktuellen Einstellungen zu speichern, @@ -131,13 +195,15 @@ Einstellungen wieder zu reaktivieren. \noindent\rule{\textwidth}{\textheight} \end{document} \end{lstcode} - Wichtig\textnote{Achtung!} ist dabei die Anweisung \Macro{clearpage} vor dem - Aufruf von \Macro{meinegespeichertenWerte}, damit die Wiederherstellung erst - auf der nächsten Seite erfolgt. Bei doppelseitigen Dokumenten sollte bei - Änderungen am Papierformat stattdessen sogar - \Macro{cleardoubleoddpage}\IndexCmd{cleardoubleoddpage} oder -- wenn keine - \KOMAScript-Klasse zum Einsatz kommt -- - \Macro{cleardoublepage}\IndexCmd{cleardoublepage} verwendet werden. + Wichtig\textnote{Achtung!} ist dabei die Anweisung + \DescRef{maincls.cmd.clearpage} vor dem Aufruf von + \Macro{meinegespeichertenWerte}, damit die Wiederherstellung erst auf der + nächsten Seite erfolgt. Bei doppelseitigen Dokumenten sollte bei Änderungen + am Papierformat stattdessen sogar + \DescRef{maincls.cmd.cleardoubleoddpage}\IndexCmd{cleardoubleoddpage} oder + -- wenn keine \KOMAScript-Klasse zum Einsatz kommt -- + \DescRef{maincls.cmd.cleardoublepage}\IndexCmd{cleardoublepage} verwendet + werden. \end{Example} Im Beispiel wird \Macro{noindent} verwendet, um den normalen Absatzeinzug vor den schwarzen Kästen zu verhindern. Sie würden sonst kein korrektes Bilde des @@ -153,45 +219,43 @@ entsprechende Fehlermeldung ausgegeben. Oftmals\ChangedAt{v3.18}{\Package{typearea}} ist es auch erwünscht, vor der Wiederherstellung der Einstelllungen per \PName{Anweisung} grundsätzlich -bestimmte Aktionen wie beispielsweise ein \Macro{cleardoubleoddpage} -auszuführen. Dies kann man mit Hilfe von \Macro{BeforeRestoreareas} und -\Macro{BeforeRestoreareas*} erreichen. Entsprechend kann man mit -\Macro{AfterRestoreareas} und \Macro{AfterRestoreareas*} \PName{Code} nach der -Wiederherstellung der Einstellungen ausführen lassen. Die Formen mit und ohne -Stern unterscheiden sich insoweit, als die Sternform nur für noch nicht per -\Macro{storeareas} gespeicherte Einstellungen gilt, während sich die Variante -ohne Stern auch auf die zukünftige Verwendung bereits früher gespeicherter -Einstellungen auswirkt.% +bestimmte Aktionen wie beispielsweise ein +\DescRef{maincls.cmd.cleardoubleoddpage} auszuführen. Dies kann man mit Hilfe +von \Macro{BeforeRestoreareas} und \Macro{BeforeRestoreareas*} +erreichen. Entsprechend kann man mit \Macro{AfterRestoreareas} und +\Macro{AfterRestoreareas*} \PName{Code} nach der Wiederherstellung der +Einstellungen ausführen lassen. Die Formen mit und ohne Stern unterscheiden +sich insoweit, als die Sternform nur für noch nicht per \Macro{storeareas} +gespeicherte Einstellungen gilt, während sich die Variante ohne Stern auch auf +die zukünftige Verwendung bereits früher gespeicherter Einstellungen +auswirkt.% % -\EndIndex{Cmd}{AfterRestoreareas*}% -\EndIndex{Cmd}{AfterRestoreareas}% -\EndIndex{Cmd}{BeforeRestoreareas*}% -\EndIndex{Cmd}{BeforeRestoreareas}% -\EndIndex{Cmd}{storeareas} +\EndIndexGroup + \begin{Declaration} - \Macro{AfterCalculatingTypearea}\Parameter{Anweisungen}\\ - \Macro{AfterCalculatingTypearea*}\Parameter{Anweisungen}\\ - \Macro{AfterSettingArea}\Parameter{Anweisungen}\\ + \Macro{AfterCalculatingTypearea}\Parameter{Anweisungen} + \Macro{AfterCalculatingTypearea*}\Parameter{Anweisungen} + \Macro{AfterSettingArea}\Parameter{Anweisungen} \Macro{AfterSettingArea*}\Parameter{Anweisungen} \end{Declaration}% -\BeginIndex{Cmd}{AfterCalculatingTypearea}% Diese Anweisungen dienen der Verwaltung zweier Haken\Index{Haken} (engl. \emph{hooks}\Index{hook=\emph{hook}}). Die ersten beiden, \Macro{AfterCalculatingTypearea} und deren Sternform, ermöglichen es dem Experten jedes Mal, nachdem \Package{typearea} eine neue Aufteilung in Satzspiegel und Ränder berechnet hat, also nach jeder impliziten oder -expliziten Ausführung von \Macro{typearea}, \PName{Anweisungen} ausführen zu -lassen. Entsprechendes leisten +expliziten Ausführung von \DescRef{typearea.cmd.typearea}, \PName{Anweisungen} +ausführen zu lassen. Entsprechendes leisten \Macro{AfterSettingArea}\ChangedAt{v3.11}{\Package{typearea}} und dessen -Stern-Form für die Ausführung von \Macro{areaset}. Die Normalformen arbeiten -dabei global, während die Änderungen durch die Sternformen nur lokal wirksam -sind. Die \PName{Anweisungen} werden jeweils unmittelbar vor -\Macro{activateareas} ausgeführt.\iffree{}{ In \autoref{cha:modernletters} - wird für die \emph{Letter-Class-Option} \File{asymTypB.lco} davon Gebrauch - gemacht, um die Randverteilung zu ändern.}% +Stern-Form für die Ausführung von \DescRef{typearea.cmd.areaset}. Die +Normalformen arbeiten dabei global, während die Änderungen durch die +Sternformen nur lokal wirksam sind. Die \PName{Anweisungen} werden jeweils +unmittelbar vor \DescRef{\LabelBase.cmd.activateareas} ausgeführt.\iffree{}{ + In \autoref{cha:modernletters} wird für die \emph{Letter-Class-Option} + \File{asymTypB.lco} davon Gebrauch gemacht, um die Randverteilung zu + ändern.}% % -\EndIndex{Cmd}{AfterCalculatingTypearea} +\EndIndexGroup \section{Lokale Einstellungen durch die Datei \File{typearea.cfg}} @@ -204,6 +268,8 @@ sind. Die \PName{Anweisungen} werden jeweils unmittelbar vor \seclabel{obsolete} \LoadNonFree{typearea-experts}{1} +% +\EndIndexGroup %%% Local Variables: %%% mode: latex |