diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex | 226 |
1 files changed, 226 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex new file mode 100644 index 00000000000..ce20e734239 --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-options.tex @@ -0,0 +1,226 @@ +% ====================================================================== +% common-options.tex +% Copyright (c) Markus Kohm, 2001-2017 +% +% This file is part of the LaTeX2e KOMA-Script bundle. +% +% This work may be distributed and/or modified under the conditions of +% the LaTeX Project Public License, version 1.3c of the license. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3c or later is part of all distributions of LaTeX +% version 2005/12/01 or later and of this work. +% +% This work has the LPPL maintenance status "author-maintained". +% +% The Current Maintainer and author of this work is Markus Kohm. +% +% This work consists of all files listed in manifest.txt. +% ---------------------------------------------------------------------- +% common-options.tex +% Copyright (c) Markus Kohm, 2001-2017 +% +% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, +% Version 1.3c, verteilt und/oder veraendert werden. +% Die neuste Version dieser Lizenz ist +% http://www.latex-project.org/lppl.txt +% und Version 1.3c ist Teil aller Verteilungen von LaTeX +% Version 2005/12/01 oder spaeter und dieses Werks. +% +% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained" +% (allein durch den Autor verwaltet). +% +% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm. +% +% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien. +% ====================================================================== +% +% Paragraphs that are common for several chapters of the KOMA-Script guide +% Maintained by Markus Kohm +% +% ---------------------------------------------------------------------- +% +% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Verwaltet von Markus Kohm +% +% ====================================================================== + +\KOMAProvidesFile{common-options.tex} + [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $ + KOMA-Script guide (common paragraphs)] + +\section{Frühe oder späte Optionenwahl} +\seclabel{options} +\BeginIndexGroup +\BeginIndex{}{Optionen}% + +\IfThisCommonFirstRun{}{% + Es gilt sinngemäß, was in + \autoref{sec:\ThisCommonFirstLabelBase.options} geschrieben wurde. Falls + Sie also \autoref{sec:\ThisCommonFirstLabelBase.options} bereits gelesen + und verstanden haben, können Sie auf + \autopageref{sec:\ThisCommonLabelBase.options.next} mit + \autoref{sec:\ThisCommonLabelBase.options.next} fortfahren.% +} + +In diesem Abschnitt wird eine Besonderheit von \KOMAScript{} vorgestellt, die +neben % +\IfThisCommonLabelBase{typearea}{\Package{typearea} auch andere + \KOMAScript-Pakete und "~Klassen }{% + \IfThisCommonLabelBase{maincls}{den Klassen \Class{scrbook}, + \Class{scrreprt} und \Class{scrartcl} auch andere \KOMAScript-Klassen und + "~Pakete }{% + \IfThisCommonLabelBase{scrlttr2}{der Klasse \Class{scrlttr2} auch andere + \KOMAScript-Klassen und "~Pakete }{% + \IfThisCommonLabelBase{scrextend}{den Klassen und \Package{scrextend} + auch einige andere \KOMAScript-Pakete }{% + \IfThisCommonLabelBase{scrhack}{\Package{scrhack} auch andere + \KOMAScript-Pakete und "~Klassen }{% + \IfThisCommonLabelBase{scrjura}{\Package{scrjura} auch andere + \KOMAScript-Pakete und "~Klassen }{% + \IfThisCommonLabelBase{scrlayer}{\Package{scrlayer} auch andere + \KOMAScript-Pakete und "-Klassen }{% + \IfThisCommonLabelBase{scrlayer-scrpage}{% + \Package{scrlayer-scrpage} auch andere \KOMAScript-Pakete und + "-Klassen }{% + \IfThisCommonLabelBase{scrlayer-notecolumn}{% + \Package{scrlayer-notecolumn} auch andere \KOMAScript-Pakete + und "-Klassen }{% + \InternalCommonFileUsageError}}}}}}}}}%% +betrifft. % +% Umbruchvarianten: +\IfThisCommonLabelBase{scrlttr2}{Im Sinne der Abgeschlossenheit der Kapitel + ist dieser Abschnitt nahezu identisch in mehreren Kapiteln zu finden, + braucht aber beim Studium des gesamten von \KOMAScript{} natürlich nur in + einem gelesen werden.% +}{Damit die Anwender alle Informationen zu einem Paket oder einer Klasse im + jeweiligen Kapitel finden, ist dieser Abschnitt nahezu gleichlautend in + mehreren Kapiteln zu finden. Anwender, die nicht nur an der Anleitung zu + einem Paket oder einer Klasse interessiert sind, sondern sich einen + Gesamtüberblick über \KOMAScript{} verschaffen wollen, brauchen diesen + Abschnitt nur in einem der Kapitel zu lesen und können ihn + \IfThisCommonLabelBase{maincls}{bei den weiteren Kapitel überspringen.}{beim + weiteren Studium der Anleitung dann überspringen.}% +} % + +\begin{Declaration} + \Macro{documentclass}\OParameter{Optionenliste}% + \Parameter{\KOMAScript-Klasse}% + \Macro{usepackage}\OParameter{Optionenliste}% + \Parameter{Paket-Liste} +\end{Declaration} +Bei \LaTeX{} ist vorgesehen, dass Anwender Klassenoptionen in Form einer durch +Komma getrennten Liste einfacher Schlüsselwörter als optionales Argument von +\Macro{documentclass} angeben. Außer an die Klasse werden diese Optionen auch +an alle Pakete weitergereicht, die diese Optionen verstehen. Ebenso ist +vorgesehen, dass Anwender Paketoptionen in Form einer durch Komma getrennten +Liste einfacher Schlüsselwörter als optionales Argument von \Macro{usepackage} +angeben. \KOMAScript{} erweitert\ChangedAt{v3.00}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}\and \Package{typearea}} den +Mechanismus der Optionen für die \KOMAScript-Klassen und einige Pakete um +weitere Möglichkeiten. So haben die meisten Optionen bei \KOMAScript{} +zusätzlich einen Wert. Eine Option hat also nicht unbedingt nur die Form +\PName{Option}, sondern kann auch die Form +\PName{Option}\texttt{=}\PName{Wert} haben. Bis auf diesen Unterschied +arbeiten \Macro{documentclass} und \Macro{usepackage} bei \KOMAScript{} wie in +\cite{latex:usrguide} oder jeder \LaTeX-Einführung, beispielsweise +\cite{l2kurz}, beschrieben.% +% +\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par + Das als veraltet zu betrachtende Paket + \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} + besitzt diese Erweiterung übrigens nicht. Es versteht daher nur einfache + Optionen ohne Wertzuweisung.\par}{}}% + +\IfThisCommonLabelBaseNotOneOf{% + scrjura,scrhack,scrlayer,scrlayer-scrpage,scrlayer-notecolumn,scrextend% +}{% + Bei Verwendung einer \KOMAScript-Klasse\textnote{Achtung!} sollten im + Übrigen beim Laden des Pakets \Package{typearea} oder \Package{scrbase} + keine Optionen angegeben werden. Das ist darin begründet, dass die Klasse + diese Pakete bereits ohne Optionen lädt und \LaTeX{} das mehrmalige Laden + eines Pakets mit unterschiedlicher Angabe von Optionen verweigert.% + \IfThisCommonLabelBase{scrlttr2}{\ Überhaupt ist es bei Verwendung einer + \KOMAScript-Klasse nicht notwendig, eines dieser Pakete auch noch explizit + zu laden.}{}} + +% Umbruchoptimierung!!! +\IfThisCommonLabelBase{typearea}{Das Setzen der Optionen mit + \Macro{documentclass} oder \Macro{usepackage} hat übrigens + einen\textnote{Achtung!} entscheidenden + Nachteil: +}{% + zu Einstellungen von Optionen haben \Macro{documentclass} und + \Macro{usepackage} einen Nachteil, der unbedingt zu + beachten\textnote{Achtung!} ist: +}% +Anweisungen, Längen, Zähler und ähnliches können darin leicht zerbrechen. So +führt die Verwendung einer \LaTeX-Länge im Wert einer Option bei diesen +Anweisungen zu einer Fehlermeldung, noch bevor der Wert an \KOMAScript{} +übergeben wird, es also die Kontrolle darüber übernehmen +könnte. Wertzuweisungen mit \LaTeX-Längen oder \LaTeX-Zählern sollten daher +nie per \Macro{documentclass} oder \Macro{usepackage}, sondern immer mit den +nachfolgend dokumentierten Anweisungen \DescRef{\LabelBase.cmd.KOMAoptions} oder +\DescRef{\LabelBase.cmd.KOMAoption} vorgenommen werden. +\EndIndexGroup + + +\begin{Declaration} + \Macro{KOMAoptions}\Parameter{Optionenliste}\\ + \Macro{KOMAoption}\Parameter{Option}\Parameter{Werteliste} +\end{Declaration} +\KOMAScript{}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}\and \Package{typearea}} bietet bei +den meisten Klassen- und Paketoptionen auch die Möglichkeit, den Wert der +Optionen noch nach dem Laden der Klasse beziehungsweise des Pakets zu +ändern. Man kann dann wahlweise mit der Anweisung \Macro{KOMAoptions} die +Werte einer Reihe von Optionen ändern. Jede Option der \PName{Optionenliste} +hat dabei die Form \PName{Option}\texttt{=}\PName{Wert}. + +Einige Optionen besitzen auch einen Säumniswert (engl. \emph{default + value}). Versäumt man die Angabe eines Wertes, verwendet man die Option also +einfach in der Form \PName{Option}, so wird automatisch dieser Säumniswert +angenommen. + +Manche Optionen können gleichzeitig mehrere Werte besitzen. Für solche +Optionen besteht die Möglichkeit, mit \Macro{KOMAoption} der einen +\PName{Option} nacheinander eine Reihe von Werten zuzuweisen. Die einzelnen +Werte sind dabei in der \PName{Werteliste} durch Komma voneinander getrennt. + +Soll\textnote{Achtung!} ein \PName{Wert} ein Gleichheitszeichen oder ein Komma +enthalten, so ist der \PName{Wert} in geschweifte Klammern zu setzen. + +\begin{Explain} + \KOMAScript{} bedient sich für die Realisierung dieser Möglichkeit der + Anweisungen \DescRef{scrbase.cmd.FamilyOptions} und + \DescRef{scrbase.cmd.FamilyOption} mit der Familie »\PValue{KOMA}«. +\iffalse % Umbruchkorrektur + Näheres zu diesen Anweisungen ist % + \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{für Experten }{}% + in \autoref{sec:scrbase.keyvalue}, + \DescPageRef{scrbase.cmd.FamilyOptions} zu finden. \else + % + Siehe dazu \autoref{part:forExperts}, \autoref{sec:scrbase.keyvalue}, + \DescPageRef{scrbase.cmd.FamilyOptions}. + % +\fi +\end{Explain}% +\iffree{}{\IfThisCommonLabelBase{scrlayer-scrpage}{\par + Das als veraltet zu betrachtende Paket + \Package{scrpage2}\IndexPackage{scrpage2}\important{\Package{scrpage2}} + besitzt diese Erweiterung übrigens nicht. Optionen können daher nur über + die zuvor erklärte Möglichkeit während des Ladens des Pakets gesetzt + werden.}{}}% +\EndIndexGroup +% +\EndIndexGroup + +\phantomsection +\label{sec:\ThisCommonLabelBase.options.end} +\endinput + +%%% Local Variables: +%%% mode: latex +%%% coding: iso-latin-1 +%%% TeX-master: "../guide" +%%% End: |