summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/ngerman/typearea-experts.tex
diff options
context:
space:
mode:
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.tex174
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