diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman')
6 files changed, 270 insertions, 89 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex index f11a1c9f29b..805b5a185a2 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/common-21.tex @@ -46,7 +46,7 @@ % ============================================================================ \KOMAProvidesFile{common-21.tex} - [$Date: 2015-03-31 11:10:59 +0200 (Tue, 31 Mar 2015) $ + [$Date: 2015-06-18 09:58:50 +0200 (Thu, 18 Jun 2015) $ KOMA-Script guide (common paragraph: Setting up defined page styles)] @@ -174,6 +174,11 @@ Normalerweise sollte die höhere Ebene die linke Marke setzen, während die tiefere Ebene für die rechte Marke zu verwenden ist. Diese übliche Konvention ist jedoch keine Pflicht, sondern lediglich sinnvoll. +Es ist zu beachten\textnote{Achtung!}, dass nicht alle Klassen Kolumnentitel +für alle Ebenen ermöglichen. So setzen die Standardklassen beispielsweise nie +Kolumnentitel für \Macro{part}. Die \KOMAScript-Klassen unterstützen hingegen +alle Ebenen. + Der Unterschied zwischen \Macro{automark} und \Macro{automark*}\important{\Macro{automark*}} liegt darin, dass \Macro{automark} alle vorherigen Befehle zum automatischen Setzen der Marken @@ -401,24 +406,24 @@ Alle für \Option{markcase} möglichen Werte sind noch einmal in automatischen Kolumnentiteln}% \label{tab:\csname label@base\endcsname.markcase}% \begin{desctabular} - \pventry{lower}{\IndexOption{markcase~=\PValue{lower}}% + \pventry{lower}{\IndexOption[indexmain]{markcase~=lower}% definiert \Macro{MakeMarkcase} so um, dass automatische Kolumnentitel mit Hilfe von \Macro{MakeLowercase} in Kleinbuchstaben gewandelt werden (Minuskelsatz).% }% - \pventry{upper}{\IndexOption{markcase~=\PValue{upper}}% + \pventry{upper}{\IndexOption[indexmain]{markcase~=upper}% definiert \Macro{MakeMarkcase} so um, dass automatische Kolumnentitel mit Hilfe von \Macro{MakeUppercase} in Großbuchstaben gewandelt werden (Versalsatz).% }% - \pventry{used}{\IndexOption{markcase~=\PValue{used}}% + \pventry{used}{\IndexOption[indexmain]{markcase~=used}% definiert \Macro{MakeMarkcase} so um, dass für automatische Kolumnentitel keine automatische Veränderung der Groß-/Kleinschreibung durchgeführt wird.% }% \entry{\PValue{ignoreuppercase}, \PValue{nouppercase}, \PValue{ignoreupper}, - \PValue{noupper}}{\IndexOption{markcase~=\PValue{noupper}}% + \PValue{noupper}}{\IndexOption[indexmain]{markcase~=noupper}% definiert nicht nur \Macro{MakeMarkcase} so um, dass für automatische Kolumnentitel keine automatische Veränderung der Groß-/Kleinschreibung durchgeführt wird, sondern deaktiviert zusätzlich lokal für alle Ebenen @@ -608,6 +613,11 @@ lediglich der Text, nicht jedoch die Nummer erwartet. Die Nummer wird stattdessen automatisch über den aktuellen Zählerstand ermittelt, falls mit nummerierten Überschriften gearbeitet wird. +Allerdings\textnote{Achtung!} verwenden nicht alle Klassen in allen +Gliederungsebenen eine solche Anweisung. So wird beispielsweise +\Macro{partmark} von den Standardklassen nie aufgerufen, während die +\KOMAScript-Klassen selbstverständlich auch \Macro{partmark} unterstützen. + Falls diese Anweisungen vom Anwender umdefiniert werden, sollte er\textnote{Achtung!} unbedingt darauf achten, vor dem Setzen der Nummer ebenfalls über \Counter{secnumdepth} zu prüfen, ob die Nummern auszugeben @@ -1016,4 +1026,4 @@ auch diese nur, wenn mit automatischen Kolumnentiteln gearbeitet wird.% % LocalWords: Einstellmöglichkeiten Seiteninhalts Gliederungsüberschrift % LocalWords: Maßlinien Entwurfsphase Unterabschnittsüberschrift Versalsatz % LocalWords: Abschnittsüberschrift Kapitelüberschrift Glyphenanalyse -% LocalWords: Hilfsanweisung content Expertenwissen +% LocalWords: Hilfsanweisung content Expertenwissen Gliederungsebenen diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex index 0c8da19490c..ed61ae005ac 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbase.tex @@ -46,7 +46,7 @@ % ====================================================================== \KOMAProvidesFile{scrbase.tex} - [$Date: 2015-03-31 11:10:59 +0200 (Tue, 31 Mar 2015) $ + [$Date: 2015-06-17 12:15:52 +0200 (Wed, 17 Jun 2015) $ KOMA-Script package scrbase] \chapter{Grundlegende Funktionen im Paket \Package{scrbase}} @@ -351,7 +351,7 @@ Mitglieds gesetzt wird. \begin{lstcode} \FamilyProcessOptions{Fleischermeister} \end{lstcode} - ergänzt wird, so kann der Anwender bereits beim Laden der Pakete, die + ergänzt wird, so kann der Anwender bereits beim Laden der Pakete die Eigenschaft \Option{Aufschnitt} wählen. Wird die Option global, also bei \Macro{documentclass} angegeben, so wird die Eigenschaft automatisch bei allen drei Paketen gesetzt, wenn alle drei Pakete geladen werden. @@ -377,6 +377,49 @@ Ausführung von Optionen Pakete zu laden.%, die selbst % \EndIndex{Cmd}{FamilyProcessOptions}% +\begin{Declaration} + \Macro{BeforeFamilyProcessOptions}\OParameter{Mitglied}\Parameter{Familie}% + \Parameter{Code}% +\end{Declaration} +\BeginIndex{Cmd}{BeforeFamilyProcessOptions}% +Insbesondere\ChangedAt{v3.18}{\Package{scrbase}} Autoren von Wrapper-Klassen +wünschen manchmal, in ein Paket oder eine Klasse noch vor der Verarbeitung der +Optionen eines zukünftig geladenen Pakets oder einer zukünftig geladenen +Klasse mit \Macro{FamilyProcessOptions} eingreifen zu können. Dies ist mit +\Macro{BeforeFamilyProcessOptions} möglich. Das Paket \Package{scrbase} bietet +dafür einen sogenannten Haken (engl. \emph{hook}). Diesem kann man mit +\Macro{BeforeFamilyProcessOptions} neuen \PName{Code} hinzufügen. Die +Parameter \PName{Mitglied} und \PName{Familie} entsprechen dabei denen von +\Macro{FammilyProcessOptions}. Allerdings kann man auch den Haken von +Familien-Mitgliedern \PName{Code} hinzufügen, wenn bisher die \PName{Familie} +oder das \PName{Mitglied} noch gar nicht definiert ist. + +Der Haken eines Familien-Mitglieds wird übrigens nach dessen Ausführung +automatisch gelöscht. Verwendet man hingegen ein leeres \PName{Mitglied}, so +wird dieser Haken für alle Mitglieder der \PName{Familie} ausgeführt und +bleibt auch über die Ausführung hinaus erhalten. + +\begin{Example} + Sie schreiben ein Paket, das selbst \Package{Mettwurst} lädt. Allerdings + wollen Sie nicht, dass für dieses Paket die Option \Option{Aufschnitt} + gesetzt werden kann. Daher deaktivieren sie die Option vor dem Laden des + Pakets über \Macro{BeforeFamilyProcessOptions}. +\begin{lstcode} + \RequirePackage{scrbase} + \BeforeFamilyProcessOptions[.Mettwurst.sty]{Fleischermeister}{% + \RelaxFamilyKey[.Mettwurst.sty]{Fleischermeister}{Aufschnitt}% + } + \RequirePackageWithOptions{Mettwurst} +\end{lstcode} + Versucht nun jemand Ihr Paket mit Option \Option{Aufschnitt} zu laden, so + meldet das Paket \Package{Mettwurst}, dass diese Option nicht bekannt + ist. Wird die Option \Option{Aufschnitt} als globale Option angegeben, so + ignoriert Paket \Package{Mettwurst} diese. Voreinstellungen innerhalb des + Pakets beispielsweise mit \Macro{FamilyExecuteOptions} noch vor + \Macro{FamilyProcessOptions} sind allerdings davon unabhängig. +\end{Example} +\EndIndex{Cmd}{BeforeFamilyProcessOptions}% + \begin{Declaration} \Macro{FamilyExecuteOptions}\OParameter{Mitglied}\Parameter{Familie}% @@ -851,7 +894,7 @@ statt.% \BeginIndex{Cmd}{FamilyStringKey}% Hier wird nun\ChangedAt{v3.08}{\Package{scrbase}} ein Schlüssel definiert, der jeden beliebigen Wert annehmen kann. Der Wert wird in dem angegebenen -\PName{Makro} gespeichert. Wird das optionales Argument für den +\PName{Makro} gespeichert. Wird das optionale Argument für den \PName{Säumniswert} weggelassen, so entspricht die Anweisung: \begin{lstcode}[belowskip=\dp\strutbox plus 1pt,escapeinside=»«] \DefineFamilyKey[»\PName{Mitglied}«]{»\PName{Familie}«}{»\PName{Schlüssel}«} diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex index a4321e1112f..874e014c3d2 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle-experts.tex @@ -48,7 +48,7 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex}% - [$Date: 2015-04-04 11:18:50 +0200 (Sat, 04 Apr 2015) $ + [$Date: 2015-06-17 13:12:54 +0200 (Wed, 17 Jun 2015) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] @@ -250,9 +250,11 @@ Ergebnissen führen.% % \seclabel{fonts} \begin{Declaration} - \Macro{@fontsizefilebase} + \Macro{@fontsizefilebase}\\ + \Macro{changefontsizes}\Parameter{Schriftgröße} \end{Declaration} \BeginIndex{Cmd}{@fontsizefilebase}% +\BeginIndex{Cmd}{changefontsizes}% Der\iffree{ in \autoref{sec:maincls-experts.addInfos}}{} auf \autopageref{desc:maincls-experts.option.fontsize} für die Schriftgrößendateien angegebene Präfix \File{scrsize}, ist lediglich die @@ -263,10 +265,9 @@ nicht definiert ist. Autoren von Wrapper-Klassen können dieses Makro abweichend definieren, um andere Schriftgrößendateien zu verwenden. Ebenso\textnote{Tipp!} können Autoren von Wrapper-Klassen die \emph{fallback}-Lösung dadurch ändern oder abschalten, dass sie das Macro -\Macro{changefontsizes}\important{\Macro{changefontsizes}}% -\IndexCmd{changefontsize}, das als Argument die gewünschte Größe erwartet, -umdefinieren.% -% +\Macro{changefontsizes}\important{\Macro{changefontsizes}}, das als Argument +die gewünschte \PName{Schriftgröße} erwartet, umdefinieren.% +\EndIndex{Cmd}{changefontsizes}% \EndIndex{Cmd}{@fontsizefilebase}% @@ -441,7 +442,7 @@ deaktiviert.% \BeginIndex{Cmd}{DeclareNewSectionCommand}% \BeginIndex{Cmd}{RedeclareSectionCommand}% \BeginIndex{Cmd}{ProvideSectionCommand}% -Mit\ChangedAt[2014/11]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and +Mit\ChangedAt{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} diesen Anweisungen kann ein neuer Gliederungsbefehl \Macro{\PName{Name}} definiert oder der vorhandene Gliederungsbefehl \Macro{\PName{Name}} verändert werden. Dazu werden über das optionale Argument @@ -453,31 +454,39 @@ unabhängigen Eigenschaften, die auch Eigenschaften, die vom jeweiligen Stil abhängig sind. Derzeit stehen die folgenden Stile zur Verfügung: \begin{labeling}{\PValue{chapter}:} -\item[\PValue{chapter}:] \ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}}Stil einer Kapitelüberschrift. Neue - Anweisungen in diesem Stil können bisher nicht definiert werden. Es kann - lediglich die existierende Anweisung \Macro{chapter} umkonfiguriert - werden. Dazu stehen zusätzlich die Eigenschaften aus +\item[\PValue{chapter}:] \ChangedAt{v3.18}{\Class{scrbook}\and + \Class{scrreprt}}Stil einer + Kapitelüberschrift. Dieser Stil wird in der Voreinstellung für + \Macro{chapter}\IndexCmd{chapter} und indirekt für + \Macro{addchap}\IndexCmd{addchap} verwendet. Neue Überschriften in diesem + Stil können definiert werden, haben dann aber nicht automatisch auch eine + \Macro{add\dots}-Variante. Für die Konfiguration des vorhandenen oder neuer + Überschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declarechapterstyle.keys}, \autopageref{tab:maincls-experts.declarechapterstyle.keys} zur - Verfügung. Die\textnote{Achtung!} Anweisung \Macro{addchap} wird ebenso wie + Verfügung. Die\textnote{Achtung!} Anweisung \Macro{addchap} wird ebenso wie die Sternformen automatisch zusammen mit \Macro{chapter} umkonfiguriert und kann nicht unabhängig davon verändert werden. Es ist zu beachten, dass dieser Stil von \Class{scrartcl}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nicht bereitgestellt wird. -\item[\PValue{part}:] \ChangedAt[2015/03]{v3.17}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}}Stil einer Teileüberschrift. Neue - Anweisungen in diesem Stil können bisher nicht definiert werden. Es kann - lediglich die existierende Anweisung \Macro{part} umkonfiguriert - werden. Dazu stehen zusätzlich die Eigenschaften aus +\item[\PValue{part}:] \ChangedAt{v3.18}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}}Stil einer Teileüberschrift. Dieser + Stil wird in der Voreinstellung für \Macro{part}\IndexCmd{part} und indirekt + für \Macro{addpart}\IndexCmd{addpart} verwendet. Neue Überschriften in + diesem Stil können definiert werden, haben dann aber nicht automatisch auch + eine \Macro{add\dots}-Variante. Für die Konfiguration des vorhandenen oder + neuer Überschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declarepartstyle.keys}, \autopageref{tab:maincls-experts.declarepartstyle.keys} zur Verfügung. Die\textnote{Achtung!} Anweisung \Macro{addpart} wird ebenso wie die Sternformen automatisch zusammen mit \Macro{part} umkonfiguriert und kann nicht unabhängig davon verändert werden. \item[\PValue{section}:] Stil einer Abschnittsüberschrift. Dieser Stil wird - derzeit für \Macro{section}, \Macro{subsection}, \Macro{subsubsection}, - \Macro{paragraph} und \Macro{subparagraph} verwendet. Neue Überschriften in + derzeit für \Macro{section}\IndexCmd{section}, + \Macro{subsection}\IndexCmd{subsection}, + \Macro{subsubsection}\IndexCmd{subsubsection}, + \Macro{paragraph}\IndexCmd{paragraph} und + \Macro{subparagraph}\IndexCmd{subparagraph} verwendet. Neue Überschriften in diesem Stil können definiert werden. Für die Konfigurierung der vorhandenen oder neuer Überschriften stehen zusätzlich die Eigenschaften aus \autoref{tab:maincls-experts.declaresectionstyle.keys}, @@ -650,6 +659,15 @@ folgenden Stile zur Verfügung: Präfixzeile und Text der Überschrift, falls eine Präfixzeile verwendet wird.\\ + \PValue{pagestyle} & \PName{Seitenstil} & + Der Name des Seitenstils, der für + die Seite mit der Überschrift + verwendet werden soll. Es findet + keine Überprüfung statt, ob der + angegebene \PName{Seitenstil} gültig + ist. Fehlerhafte Angaben führen + daher zu Fehlermeldungen bei + Verwendung des Gliederungsbefehls.\\ \PValue{prefixfont} & \PName{Schrifteinstellung} & Die Fonteinstellungen, die zusätzlich zum Element @@ -698,11 +716,28 @@ folgenden Stile zur Verfügung: \Macro{addtokomafont} für das Element des Gliederungsbefehls erlaubt sind.\\ - \PValue{innerskip} & \PName{Länge} & Der vertikale Abstand zwischen + \PValue{innerskip} & \PName{Länge} & %\OnlyAt{\Class{scrbook}\and + % \Class{scrreprt}}% + Der vertikale Abstand zwischen Präfixzeile und Text der Überschrift bei \Class{scrbook} und \Class{scrreprt}.\\ + \PValue{pagestyle} & \PName{Seitenstil} & + %\OnlyAt{\Class{scrbook}\and + % \Class{scrreprt}}% + Der Name des Seitenstils, der für + die Seite mit der Überschrift + verwendet werden soll. Es findet + keine Überprüfung statt, ob der + angegebene \PName{Seitenstil} gültig + ist. Fehlerhafte Angaben führen + daher zu Fehlermeldungen bei + Verwendung des + Gliederungsbefehls. Diese + Möglichkeit existiert nur bei + \Class{scrbook} und + \Class{scrreprt}. \\ \PValue{prefixfont} & \PName{Schrifteinstellung} & Die Fonteinstellungen, die zusätzlich zum Element diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex index 8cd919f656d..9c53ce1bae8 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex @@ -46,7 +46,7 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle.tex} - [$Date: 2015-05-11 09:45:36 +0200 (Mon, 11 May 2015) $ + [$Date: 2015-06-15 13:41:43 +0200 (Mon, 15 Jun 2015) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)] \chapter{Die Hauptklassen \Class{scrbook}, \Class{scrreprt}, \Class{scrartcl}} @@ -1291,10 +1291,12 @@ Teil der Abschnitt. Daher unterstützt \Class{scrartcl} diese Option nicht.% \begin{Declaration} \KOption{chapterprefix}\PName{Ein-Aus-Wert}\\ - \KOption{appendixprefix}\PName{Ein-Aus-Wert} + \KOption{appendixprefix}\PName{Ein-Aus-Wert}\\ + \Macro{IfChapterUsesPrefixLine}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration}% \BeginIndex{Option}{chapterprefix~=\PName{Ein-Aus-Wert}}% \BeginIndex{Option}{appendixprefix~=\PName{Ein-Aus-Wert}}% +\BeginIndex{Cmd}{IfChapterUsesPrefixLine}% Bei\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} den Standardklassen \Class{book} und \Class{report} werden Kapitelüberschriften% \Index{Kapitel>Ueberschrift=Überschrift} in der Form ausgegeben, dass zunächst @@ -1322,7 +1324,14 @@ möchte. Gleichzeitig\important{\Option{appendixprefix}} sollen die Präfixzeile, »Anhang« gefolgt vom Buchstaben des Anhangs, versehen werden. Dies ist mit der Einstellung \OptionValue{appendixprefix}{true} möglich. Da sich jedoch dadurch ein inkonsistentes Layout ergibt, rate ich von -der Verwendung ab. +der Verwendung ab. Letztlich führt die Option dazu, dass +\Option{chapterprefix} zu Beginn des Anhangs automatisch geändert wird. + +Mit der Anweisung +\Macro{IfChapterUsesPrefixLine}\ChangedAt{v3.18}{\Class{scrbook}\and + \Class{scrreprt}} kann man Code in Abhängigkeit der aktuellen Einstellung +für die Präfixzeile ausführen. Ist \Option{chapterprefix} aktiv, so wird der +\PName{Dann-Teil} ausgeführt, anderenfalls der \PName{Sonst-Teil}. Die Schriftart der Kapitelnummernzeile bei \OptionValue{chapterprefix}{true} oder \OptionValue{appendixprefix}{true} kann @@ -1336,6 +1345,7 @@ Elements \FontElement{chapter}\IndexFontElement{chapter} (siehe \autoref{tab:maincls.structureElementsFont}, \autopageref{tab:maincls.structureElementsFont}).% % +\EndIndex{Cmd}{IfChapterUsesPrefixLine}% \EndIndex{Option}{appendixprefix~=\PName{Ein-Aus-Wert}}% \EndIndex{Option}{chapterprefix~=\PName{Ein-Aus-Wert}}% @@ -2327,6 +2337,7 @@ umdefiniert werden. \Macro{paragraphformat}\\ \Macro{subparagraphformat}\\ \Macro{othersectionlevelsformat}\Parameter{Gliederungsname}\Parameter{}\Parameter{Zählerausgabe}\\ + \Macro{IfUsePrefixLine}\Parameter{Dann-Teil}\Parameter{Sonst-Teil}\\ \Macro{autodot} \end{Declaration}% \BeginIndex{Cmd}{partformat}\Index{Teil>Nummer}% @@ -2337,6 +2348,7 @@ umdefiniert werden. \BeginIndex{Cmd}{paragraphformat}% \BeginIndex{Cmd}{subparagraphformat}% \BeginIndex{Cmd}{othersectionlevelsformat}\Index{Abschnitt>Nummer}% +\BeginIndex{Cmd}{IfUsePrefixLine}% \BeginIndex{Cmd}{autodot}% \KOMAScript{} fügt der Ausgabe der Gliederungsnummern oberhalb von \Macro{the\PName{Gliederungsname}} (siehe \Macro{the\PName{Zähler}}, @@ -2382,13 +2394,23 @@ anzupassen. Nachfolgend finden Sie einige Definitionen, die denen aus den \newcommand*{\partformat}{\partname~\thepart\autodot} \newcommand*{\chapterformat}{% \mbox{\chapappifchapterprefix{\nobreakspace}\thechapter - \autodot\enskip}} + \autodot\IfUsePrefixLine{}{\enskip}}} \newcommand*{\sectionformat}{\thesection\autodot\enskip} \newcommand*{\othersectionlevelsformat}[3]{% #3\autodot\enskip} \end{lstcode} Die Definitionen der tieferen Ebenen entsprechen der von -\Macro{sectionformat}. Bitte\textnote{Achtung!} beachten Sie, dass bei der +\Macro{sectionformat}. + +Wegen\ChangedAt{v3.17}{\Class{scrbook}\and \Class{scrreprt}} der Verwendung +von \Macro{IfUsePrefixLine} sollte \Macro{chapterformat} nicht außerhalb von +\Macro{chapter} verwendet werden. Diese Anweisung ist nur innerhalb der +Gliederungsbefehle von \KOMAScript{} wohldefiniert. In diesem Fall wird im +Falle der Verwendung einer Präfixzeile für die Nummer der Überschrift der +\PName{Dann-Teil} ausgeführt, während im anderen Fall der \PName{Sonst-Teil} +verwendet wird. + +Bitte\textnote{Achtung!} beachten Sie außerdem, dass bei der Umdefinierung \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen ist. \begin{Example} @@ -2427,6 +2449,7 @@ Umdefinierung \Macro{newcommand} durch \Macro{renewcommand} zu ersetzen ist. \end{Example} % \EndIndex{Cmd}{autodot}% +\EndIndex{Cmd}{IfUsePrefixLine}% \EndIndex{Cmd}{othersectionlevelsformat}% \EndIndex{Cmd}{paragraphformat}% \EndIndex{Cmd}{subparagraphformat}% @@ -2503,19 +2526,17 @@ gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.% einer der drei Anweisungen \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und \Macro{subsectionmarkformat}. - Da\ChangedAt{v3.12}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}} \KOMAScript{} zusätzlich die Gliederungsanweisungen - \Macro{addchap} und \Macro{addsec} bereitstellt, die nicht nummerierte - Überschriften erzeugen, existieren für diese auch korrespondierende - Anweisungen für den Kolumnentitel. Es ist zu beachten\textnote{Achtung!}, - dass diese in der Voreinstellung ebenfalls auf \Macro{chaptermark} und - \Macro{sectionmark} zurück greifen, dabei aber lokal den Zähler - \Counter{secnumdepth} auf -1 setzen, um die Nummerierung von Kapiteln und - Abschnitten abzuschalten. Dies sollte man beispielsweise bei der - Umdefinierung von \Macro{chaptermark} und \Macro{sectionmark} - berücksichtigen (siehe \Macro{ifnumbered} auf - \autopageref{desc:maincls.cmd.ifnumbered}) oder \Macro{addchapmark} und - \Macro{addsecmark} ebenfalls dazu passend umdefinieren. + Es ist zu beachten\textnote{Achtung!}, dass die Kolumnentitel von + \Macro{addchap}\IndexCmd{addchap} und \Macro{addsec}\IndexCmd{addsec} + ebenfalls auf \Macro{chaptermark} und \Macro{sectionmark} basieren. Dabei + wird aber lokal der Zähler \Counter{secnumdepth} auf einen Wert gesetzt, mit + dem die Nummerierung von Kapiteln beziehungsweise Abschnitten abgeschaltet + wird. Dies sollte man beispielsweise bei der Umdefinierung von + \Macro{chaptermark} und \Macro{sectionmark} berücksichtigen (siehe + \Macro{ifnumbered} auf \autopageref{desc:maincls.cmd.ifnumbered}). Für die + Sternformen \Macro{addchap*} und \Macro{addsec*} existieren außerdem die + Anweisungen \Macro{addchapmark} und \Macro{addsecmark}, die in der + Voreinstellung ebenfalls in der genannten Weise definiert sind. Während\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} bei \Class{scrartcl} weder \Macro{chaptermark} noch \Macro{addchapmark} oder @@ -4523,4 +4544,4 @@ zuständig.% % LocalWords: Teildokumenten Klassenoption Tabellenunterschrift float % LocalWords: Satzspiegels Schrifteinstellung Abschnittseinträgen -% LocalWords: Vakatseiten +% LocalWords: Vakatseiten Kolumnentitel Sternformen diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex index 852cc0d2b59..2a69372fb06 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlayer.tex @@ -46,7 +46,7 @@ % ============================================================================ \KOMAProvidesFile{scrlayer.tex}% - [$Date: 2015-03-31 11:10:59 +0200 (Tue, 31 Mar 2015) $ + [$Date: 2015-05-19 11:08:32 +0200 (Tue, 19 May 2015) $ KOMA-Script guide (chapter:scrlayer)] \chapter[{Definition von Ebenen und Seitenstilen mit \Package{scrlayer}}] @@ -344,8 +344,7 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. }{% Optionen für die Definition von Ebenen (\emph{Fortsetzung})% }% - \ifnum\currentversionlt{3.16}\else - \nentry{% + \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{addcontents}\PName{Code}}{% Der angegebene Wert wird an den aktuellen Wert des Attributs @@ -353,35 +352,34 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. generiert. Zu näheren Informationen über die Behandlung von \PName{Code} siehe Option \Option{contents}.% }% - \nentry{% + \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{addheight}\PName{zusätzliche Höhe}}{% Der aktuelle Wert von Attribut \Option{height} wird um den Wert dieser Option erhöht. Als Wert sind die gleichen Angaben wie bei \Option{height} möglich.% }% - \nentry{% + \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{addhoffset}\PName{zusätzlicher horizontaler Abstand}}{% Der aktuelle Wert von Attribut \Option{hoffset} wird um den Wert dieser Option erhöht. Als Wert sind die gleichen Angaben wie bei \Option{hoffset} möglich.% }% - \nentry{% + \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{addvoffset}\PName{zusätzlicher vertikaler Abstand}}{% Der aktuelle Wert von Attribut \Option{voffset} wird um den Wert dieser Option erhöht. Als Wert sind die gleichen Angaben wie bei \Option{voffset} möglich.% }% - \nentry{% + \entry{% \ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{addwidth}\PName{zusätzliche Breite}}{% Der aktuelle Wert von Attribut \Option{width} wird um den Wert dieser Option erhöht. Als Wert sind die gleichen Angaben wie bei \Option{width} möglich.% }% - \fi \nentry{\KOption{align}\PName{Ausrichtungszeichen}}{% Über die \PName{Ausrichtungszeichen} wird die gewünschte Ausrichtung der Ebene bestimmt. Dabei steht jedes einzelne \PName{Ausrichtungszeichen} für @@ -412,6 +410,14 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \KOption{voffset}\PName{vertikaler Abstand}, \KOption{width}\PName{Breite}, \KOption{height}\PName{Höhe}.% }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{backandforeground}}{% + Mit dieser Option wird die Einschränkung der Ebene auf den Vorder- oder + Hintergrund wieder aufgehoben und diesbezüglich die Grundeinstellung + wieder hergestellt. In der Regel ist dies wenig sinnvoll, daher existiert + die Option nur aus Gründen der Vollständigkeit. Diese Option erwartet und + erlaubt keinen Wert.% + }% \entry{\Option{background}}{% Mit dieser Option wird die Ebene zu einer reinen Hintergrundebene. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im @@ -450,6 +456,26 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. doppelseitigen Satz gibt, schließt diese Eigenschaft quasi \Option{twoside} mit ein. Diese Option erwartet und erlaubt keinen Wert.% }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{everypage}}{% + Dies ist eine Kombination von \Option{oddorevenpage} und + \Option{floatornonfloatpage}. Diese Option erwartet und erlaubt keinen + Wert.% + }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{everyside}}{% + Mit dieser Option wird die Einschränkung der Ebene auf den einseitigen + oder den doppelseitigen Satz aufgehoben. Sie wird damit wie in der + Voreinstellung wieder sowohl im einseitigen als auch im doppelseitigen + Satz ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% + }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{floatornonfloatpage}}{% + Mit dieser Option wird die Einschränkung der Ebene auf Gleitseiten oder + Seiten, die keine Gleitseiten sind, aufgehoben und diesbezüglich die + Voreinstellung wieder hergestellt. Diese Option erwartet und erlaubt + keinen Wert.% + }% \entry{\Option{floatpage}}{% Mit dieser Option wird die Ebene zu einer Gleitseitenebene. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr auf allen Seiten, sondern nur @@ -473,8 +499,8 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. erwartet und erlaubt keinen Wert.% }% \entry{\Option{foreground}}{% - Mit dieser Option wird die Ebene zu einer reinen Vordergrundebene. Sie wird - also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im + Mit dieser Option wird die Ebene zu einer reinen Vordergrundebene. Sie + wird also im Gegensatz zur Grundeinstellung nicht mehr gleichzeitig im Hintergrund und im Vordergrund, sondern nur noch im Vordergrund ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% @@ -533,17 +559,24 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. zu diesem Abschnitt zu entnehmen. Diese Option erwartet und erlaubt keinen Wert.% }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{oddorevenpage}}{% + Mit dieser Option werden Beschränkungen der Ebene auf rechte oder linke + Seiten aufgehoben. Damit wird die Ebene wie in der Voreinstellung sowohl + auf linken als auch rechten Seiten ausgegeben. Diese Option erwartet und + erlaubt keinen Wert.% + }% \entry{\Option{oddpage}}{% - Mit dieser Option wird die Ebene zu einer Ebene für rechte Seiten. Sie wird - also im Gegensatz zur Grundeinstellung nicht mehr sowohl auf linken als - auch auf rechten Seiten ausgegeben. Es ist zu beachten, dass im + Mit dieser Option wird die Ebene zu einer Ebene für rechte Seiten. Sie + wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl auf linken + als auch auf rechten Seiten ausgegeben. Es ist zu beachten, dass im einseitigen Satz alle Seiten unabhängig von der Seitenzahl rechte Seiten sind. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{oneside}}{% Mit dieser Option wird die Ebene zu einer Ebene für den einseitigen - Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl - im einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option + Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl im + einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% \entry{\Option{outermargin}}{% @@ -560,16 +593,13 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \Option{align} so, dass die Ebene die komplette Seite überdeckt. Diese Option erwartet und erlaubt keinen Wert.% }% - \ifnum\currentversionlt{3.16}\else - \nentry{% - \ChangedAt{v3.16}{\Package{scrlayer}}% + \entry{\ChangedAt{v3.16}{\Package{scrlayer}}% \KOption{pretocontents}\PName{Code}}{% Der angegebene Wert wird dem aktuellen Wert des Attributs - \Option{contents} vorangestellt. Es wird also ein zusätzlicher Inhalt - vor dem bisherigen Inhalt generiert. Zu näheren Informationen über die + \Option{contents} vorangestellt. Es wird also ein zusätzlicher Inhalt vor + dem bisherigen Inhalt generiert. Zu näheren Informationen über die Behandlung von \PName{Code} siehe Option \Option{contents}.% }% - \fi \entry{\Option{rightmargin}}{% Die zusammengesetzte Eigenschaft setzt die primären Eigenschaften \Option{hoffset}, \Option{voffset}, \Option{width}, \Option{height} und @@ -592,10 +622,17 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. }% \entry{\Option{twoside}}{% Mit dieser Option wird die Ebene zu einer Ebene für den doppelseitigen - Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl - im einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option + Satz. Sie wird also im Gegensatz zur Grundeinstellung nicht mehr sowohl im + einseitigen als auch im doppelseitigen Satz ausgegeben. Diese Option erwartet und erlaubt keinen Wert.% }% + \entry{\ChangedAt{v3.18}{\Package{scrlayer}}% + \Option{unrestricted}}{% + Hebt alle Ausgabebeschränkungen auf. Damit ist die Option eine Kombination + von \Option{backandforground}, \Option{everyside} und + \Option{floatornonfloatpage}. Diese Option erwartet und erlaubt keinen + Wert.% + }% \entry{\KOption{voffset}\PName{Abstand}}{% Setzt den \PName{Abstand} der Ebene von der Papieroberkante. Wie der \PName{Abstand} gemessen wird, hängt von Eigenschaft \Option{align} @@ -632,22 +669,20 @@ Ebene stellt bei beiden Anweisungen einen Fehler dar. \BeginIndex{Cmd}{layeryoffset}% \BeginIndex{Cmd}{layerwidth}% \BeginIndex{Cmd}{layerheight}% -Diese Anweisungen sind nur innerhalb der Ausgabe des mit \Option{contents}% -\ifnum\currentversionlt{3.16}\else -, \Option{addcontents} oder \Option{pretocontents}\fi{} -angegebenen \PName{Code} gültig. In diesem Fall enthalten sie die tatsächlich -verwendete Position und Ausdehnung der Ebene, die für die Ausgabe verwendet -werden. Dies ist jedoch nicht zwangsläufig auch die tatsächliche Ausdehnung des -Inhalts, falls dieser beispielsweise überbreit oder überhoch ist oder die -Ebene nicht komplett ausfüllt. Eine Umdefinierung der Anweisungen und damit -Änderung der in ihnen gespeicherten Werte ist nicht gestattet und führt zu -unvorhersehbaren Ergebnissen.% +Diese Anweisungen sind nur innerhalb der Ausgabe des mit \Option{contents}, +\Option{addcontents} oder \Option{pretocontents} angegebenen \PName{Code} +gültig. In diesem Fall enthalten sie die tatsächlich verwendete Position und +Ausdehnung der Ebene, die für die Ausgabe verwendet werden. Dies ist jedoch +nicht zwangsläufig auch die tatsächliche Ausdehnung des Inhalts, falls dieser +beispielsweise überbreit oder überhoch ist oder die Ebene nicht komplett +ausfüllt. Eine Umdefinierung der Anweisungen und damit Änderung der in ihnen +gespeicherten Werte ist nicht gestattet und führt zu unvorhersehbaren +Ergebnissen.% \EndIndex{Cmd}{layerheight}% \EndIndex{Cmd}{layerwidth}% \EndIndex{Cmd}{layeryoffset}% \EndIndex{Cmd}{layerxoffset}% -\ifnum\currentversionlt{3.16}\else \begin{Declaration} \Macro{GetLayerContents}\Parameter{Name der Ebene} \end{Declaration} @@ -660,7 +695,6 @@ Ebenen-Attribute \Option{contents}, \Option{addcontents} oder den Inhalt der aktuellen Ebene zugegriffen wird. Der Anwender ist selbst dafür verantwortlich solche Situationen zu vermeiden!% \EndIndex{Cmd}{GetLayerContents}% -\fi \begin{Declaration} \Macro{IfLayerExists}%^^A @@ -1178,10 +1212,13 @@ wird, entfernt werden.% \begin{Declaration} \KOption{deactivatepagestylelayers}\PName{Ein-Aus-Wert}\\ \Macro{ForEachLayerOfPageStyle}\Parameter{Seitenstil-Name}% + \Parameter{Code}\\ + \Macro{ForEachLayerOfPageStyle*}\Parameter{Seitenstil-Name}% \Parameter{Code} \end{Declaration} \BeginIndex{Option}{deactivatepagestylelayers~=\PName{Ein-Aus-Wert}}% \BeginIndex{Cmd}{ForEachLayerOfPageStyle}% +\BeginIndex{Cmd}{ForEachLayerOfPageStyle*}% Solange \KOMAScript-Option \Option{deactivatepagestylelayers} nicht aktiviert ist, kann mit \Macro{ForEachLayerOfPageStyle} für jede Ebene des Seitenstils mit dem Namen \PName{Seitenstil-Name} beliebiger \PName{Code} @@ -1204,12 +1241,22 @@ unerwünschte Seiteneffekte zu minimieren. Die Anweisung \Macro{gdef} definiert \Macro{commaatlist} jedoch global um, so dass beim Aufruf des Codes für die nächste Ebene die Änderung Bestand hat. +Alternativ\ChangedAt{v3.18}{\Package{scrlayer}} hätte man auch zwar mit +\Macro{def}, dafür aber mit der Sternvariante \Macro{ForEachLayerOfPageStyle*} +arbeiten können. Diese Form verzichtet bei der Ausführung von \PName{Code} auf +eine zusätzliche Gruppe. Allerdings muss der Anwender dann selbst +sicherstellen, dass \PName{Code} keine unerwünschten Seiteneffekte +hat. Insbesondere würde die Deaktivierung der Ebenen mit +\OptionValue{deactivatepagestylelayers}{true} innerhalb von \PName{Code} dann +über den Aufruf von \Macro{ForEachLayerOfPageStyle*} hinaus Bestand haben. + Diverse Anweisungen von \Package{scrlayer} setzen intern selbst ebenfalls \Macro{ForEachLayerOfPageStyle} ein. Auch deren Funktion kann daher über die \KOMAScript-Option \Option{deactivatepagestylelayers} verändert werden. Diese -Option kann daher verwendet werden, um alle Ebenen aller Seitenstile temporär +Option kann also verwendet werden, um alle Ebenen aller Seitenstile temporär zu deaktivieren oder zu verstecken. % +\EndIndex{Cmd}{ForEachLayerOfPageStyle*}% \EndIndex{Cmd}{ForEachLayerOfPageStyle}% \EndIndex{Option}{deactivatepagestylelayers~=\PName{Ein-Aus-Wert}}% @@ -1591,4 +1638,5 @@ optionale Argument sei auf die Erklärung zu -% LocalWords: Vordergrundebene +% LocalWords: Vordergrundebene Sternvariante Gleitseiten +% LocalWords: Ausgabebeschränkungen 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 3502a796f16..005ec57f86a 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 @@ -46,7 +46,7 @@ % ====================================================================== \KOMAProvidesFile{typearea-experts.tex} - [$Date: 2015-03-31 11:10:59 +0200 (Tue, 31 Mar 2015) $ + [$Date: 2015-05-21 15:48:01 +0200 (Thu, 21 May 2015) $ KOMA-Script guide (chapter: typearea for experts)] \chapter{Zusätzliche Informationen zum Paket \Package{typearea.sty}} @@ -96,9 +96,17 @@ durchgeführten Änderungen lokal!% \EndIndex{Cmd}{activateareas} \begin{Declaration} - \Macro{storeareas}\Parameter{Anweisung} + \Macro{storeareas}\Parameter{Anweisung}\\ + \Macro{BeforeRestoreareas}\Parameter{Code}\\ + \Macro{BeforeRestoreareas*}\Parameter{Code}\\ + \Macro{AfterRestoreareas}\Parameter{Code}\\ + \Macro{AfterRestoreareas*}\Parameter{Code} \end{Declaration} -\BeginIndex{Cmd}{storearea}% +\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, @@ -142,7 +150,23 @@ nicht innerhalb einer Gruppe aufgerufen werden sollten. Die Definition der \Macro{newcommand}\IndexCmd{newcommand*}\important{\Macro{newcommand*}}. Bei erneuter Verwendung einer bereits definierten \PName{Anweisung} wird eine 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.% % +\EndIndex{Cmd}{AfterRestoreareas*}% +\EndIndex{Cmd}{AfterRestoreareas}% +\EndIndex{Cmd}{BeforeRestoreareas*}% +\EndIndex{Cmd}{BeforeRestoreareas}% \EndIndex{Cmd}{storeareas} \begin{Declaration} |