diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex | 3673 |
1 files changed, 3673 insertions, 0 deletions
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 new file mode 100644 index 00000000000..e5910caddb2 --- /dev/null +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrbookreportarticle.tex @@ -0,0 +1,3673 @@ +% ====================================================================== +% scrbookreportarticle.tex +% Copyright (c) Markus Kohm, 2001-2008 +% +% 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.3b of the license. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3b 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. +% ---------------------------------------------------------------------- +% scrbookreportarticle.tex +% Copyright (c) Markus Kohm, 2001-2008 +% +% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz, +% Version 1.3b, verteilt und/oder veraendert werden. +% Die neuste Version dieser Lizenz ist +% http://www.latex-project.org/lppl.txt +% und Version 1.3b 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. +% ====================================================================== +% +% Chapter about scrbook, scrreprt, and scrartcl of the KOMA-Script guide +% Maintained by Markus Kohm +% +% ---------------------------------------------------------------------- +% +% Kapitel über scrbook, scrreprt und scrartcl in der KOMA-Script-Anleitung +% Verwaltet von Markus Kohm +% +% ============================================================================ + +\ProvidesFile{scrbookreportarticle.tex}[2008/08/12 KOMA-Script guide (chapter: +scrbook, scrreprt, scrartcl)] + +\chapter{Die Hauptklassen \Class{scrbook}, \Class{scrreprt}, \Class{scrartcl}} +\labelbase{maincls}% +\BeginIndex{Class}{scrbook}% +\BeginIndex{Class}{scrreprt}% +\BeginIndex{Class}{scrartcl}% + +\AddSeeIndex{Anweisung}{gen}{\GuidecmdIndexShort}{cmd}% +\AddSeeIndex{Makro}{gen}{\GuidecmdIndexShort}{cmd}% +Die Hauptklassen des \KOMAScript-Pakets sind als Äquivalent zu den +\LaTeX-Standard"-klassen angelegt. Das bedeutet, dass zu den drei +Standardklassen \Class{book}\IndexClass{book}, \Class{report}% +\IndexClass{report} und \Class{article}\IndexClass{article} im +\KOMAScript-Paket Entsprechungen zu finden sind. Daneben ist auch für die +Standardklasse \Class{letter}\IndexClass{letter} eine Entsprechung vorhanden. +Der Briefklasse in {\KOMAScript} ist jedoch ein eigenes Kapitel gewidmet, da +sie sich von den drei Hauptklassen grundsätzlich unterscheidet (siehe +\autoref{cha:scrlttr2}). + +Die einfachste Möglichkeit, an Stelle einer Standardklasse eine +\KOMAScript-Klasse zu verwenden, ist das Ersetzen des Klassennamens in der +Anweisung \verb|\documentclass| entsprechend \autoref{tab:maincls.overview}, +also beispielsweise \Macro{documentclass}\PParameter{book} durch +\Macro{documentclass}\PParameter{scrbook}. Der anschließende \LaTeX-Lauf +sollte lediglich einige Layoutänderungen mit sich bringen. Ein großer Teil der +in den nachfolgenden Abschnitten beschriebenen vielfältigen Möglichkeiten und +Optionen werden von den \KOMAScript-Klassen zusätzlich geboten. + +\begin{table} + \centering + \caption[Klassengegenüberstellung]{Gegenüberstellung der + Standardklassen und der \KOMAScript-Klassen} + \begin{tabular}{ll} + \toprule + Standard-Klasse & \KOMAScript-Klasse \\%& \Script-Stil (\LaTeX2.09)\\ + \midrule + \Class{article} & \Class{scrartcl} \\%& \File{script\textunderscore s} \\ + \Class{report} & \Class{scrreprt} \\%& \File{script} \\ + \Class{book} & \Class{scrbook} \\%& \File{script} \\ + \Class{letter} & \Class{scrlttr2} \\%& \File{script\textunderscore l} \\ + \bottomrule + \end{tabular} + \label{tab:maincls.overview} +\end{table} + +Lassen Sie mich der Erläuterung der Klassen noch eine Bemerkung +vorausschicken. Oft ist man sich am Anfang eines Dokuments unsicher, welche +Einstellungen konkret zu wählen sind. Bei einigen Einstellungen, wie der +Auswahl des Papierformats, mögen sie bereits vorab feststehen. Aber schon die +Frage nach der Seitenauf"|teilung könnte im Voraus schwer zu beantworten sein. +Andererseits sollten diese Angaben für die Haupttätigkeiten des Autors -- +Entwurf der Gliederung, Schreiben des Textes, Zusammenstellen von Abbildungen, +Tabellen und Verzeichnissen -- zunächst auch unerheblich sein. Konzentrieren +Sie sich als Autor erst einmal auf den Inhalt. Wenn der dann steht, können Sie +sich um die Feinheiten der Form kümmern. Neben der Auswahl der Optionen +gehören dazu dann auch Dinge wie die Korrektur der Trennung und möglicherweise +dezente Eingriffe in den Seitenumbruch oder die Verteilung von Abbildungen und +Tabellen. + + +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\LoadCommon{0} % \section{Frühe oder späte Optionenwahl} + +\LoadCommon{1} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} + +\LoadCommon{2} % \section{Entwurfsmodus} + +\LoadCommon{3} % \section{Seitenauf"|teilung} + +\begin{Declaration} + \Macro{flushbottom}\\ + \Macro{raggedbottom} +\end{Declaration} +\BeginIndex{Cmd}{raggedbottom}% +\BeginIndex{Cmd}{flushbottom}% +\begin{Explain} + Insbesondere bei doppelseitigen Dokumenten ist es wünschenswert, wenn nicht + nur alle ersten Zeilen eines Satzspiegels mit ihrer Grundlinie auf der + gleichen Höhe liegen, sondern auch die letzten Zeilen einer + Doppelseite. Enthält eine Seite nur Text ohne Absätze und Überschriften, so + hat man das automatisch. Aber bereits dann, wenn Absätze mit einem halben + Grundlinienabstand markiert werden, genügt es, wenn die Anzahl der Absätze + auf der einen Seite um eine ungerade Zahl von der auf der anderen Seite + abweicht, damit dieses Ziel nicht mehr erreicht werden kann. Es ist dann + notwendig, dass man zumindest einige der vertikalen Abstände etwas dehnt + oder staucht, um das Ziel wieder zu erreichen. \TeX{} kennt zu diesem Zweck + dehn- und stauchbare Abstände und \LaTeX{} bietet dann die Möglichkeit, + diesen \emph{vertikalen Ausgleich}\Index{Ausgleich>vertikal} automatisch + durchzuführen. +\end{Explain} + +Wird über die Option \Option{twoside} (siehe \autoref{sec:typearea.options}, +\autopageref{desc:typearea.option.twoside}) doppelseitiger Satz angefordert, +so wird der vertikale Ausgleich ebenfalls eingeschaltet. Man kann ihn aber +auch mit \Macro{flushbottom} jederzeit ab der aktuellen Seite explizit +fordern. Umgekehrt ist es möglich, mit \Macro{raggedbottom} den vertikalen +Ausgleich ab der aktuellen Seite explizit abzuschalten. Dies entspricht der +Voreinstellung bei einseitigem Satz. + +{\KOMAScript} verwendet übrigens einen leicht modifizierten Verzicht auf den +vertikalen Ausgleich. \iffree{}{Näheres dazu ist in + \autoref{sec:maincls-experts.addInfos}, + \autopageref{desc:maincls-experts.cmd.footnoterule} zu erfahren.}% +% +\EndIndex{Cmd}{flushbottom}% +\EndIndex{Cmd}{raggedbottom}% +% +\EndIndex{}{Seitenaufteilung=Seitenauf~"~|teilung} + +\section{Wahl der Schriftgröße für das Dokument} +\LoadCommon{4} % \section{Wahl der Schriftgröße für das Dokument} + +Voreingestellt ist bei \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} +\OptionValue{fontsize}{11pt}. Demgegenüber ist übrigens bei den +Standardklassen \Option{10pt} voreingestellt. Dies ist bei einem Wechsel von +den Standardklassen zu den \KOMAScript-Klassen gegebenenfalls zu beachten.% +% +\EndIndex{Option}{fontsize~=\PName{Größe}}% +% +\EndIndex{}{Schrift>Groesse=Größe} + + +\LoadCommon{5} % \section{Textauszeichnungen} + +Mit der Anweisung \Macro{usekomafont} kann die aktuelle Schriftart auf +diejenige umgeschaltet werden, die für das angegebene \PName{Element} +definiert ist. + +\begin{Example} + \phantomsection\label{desc:maincls.setkomafont.example}% + Angenommen, Sie wollen, dass für das Element + \FontElement{captionlabel} dieselbe Schriftart wie + für das Element \FontElement{descriptionlabel} verwendet wird. Das + erreichen Sie einfach mit: +\begin{lstcode} + \setkomafont{captionlabel}{% + \usekomafont{descriptionlabel}} +\end{lstcode} + Weitere Beispiele finden Sie in den Abschnitten zu den jeweiligen + Elementen. +\end{Example} + +\begin{desctable} + \caption{Elemente, deren Schrift bei \KOMAScript{} mit + \Macro{setkomafont} und \Macro{addtokomafont} verändert werden + kann\label{tab:maincls.elementsWithoutText}}\\ + \Endfirsthead + \caption[]{Elemente, deren Schrift verändert werden kann + (\emph{Fortsetzung})}\\ + \Endhead% + \standardfoot% + \feentry{caption}{Text einer Abbildungs- oder Tabellenunter- oder + "~überschrift (siehe \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.cmd.caption})}% + \feentry{captionlabel}{% + Label einer Abbildungs- oder Tabellenunter- oder "~überschrift; Anwendung + erfolgt nach dem Element \FontElement{caption} (siehe + \autoref{sec:maincls.floats}, \autopageref{desc:maincls.cmd.caption})}% + \feentry{chapter}{% + Überschrift der Ebene \Macro{chapter} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.chapter})}% + \feentry{chapterentry}{% + Inhaltsverzeichniseintrag der Ebene \Macro{chapter} (siehe + \autoref{sec:maincls.toc}, + \autopageref{desc:maincls.cmd.tableofcontents})}% + \feentry{chapterentrypagenumber}{% + Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{chapter} + abweichend vom Element \FontElement{chapterentry} (siehe + \autoref{sec:maincls.toc}, + \autopageref{desc:maincls.cmd.tableofcontents})}% + \feentry{descriptionlabel}{% + Label, also das optionale Argument der \Macro{item}-Anweisung, in einer + \Environment{description}-Umgebung (\autoref{sec:maincls.lists}, + \autopageref{desc:maincls.env.description})}% + \feentry{dictum}{% + mit \Macro{dictum} gesetzter schlauer Spruch (siehe + \autoref{sec:maincls.dictum}, \autopageref{desc:maincls.cmd.dictum})}% + \feentry{dictumauthor}{% + Urheber eines schlauen Spruchs; Anwendung erfolgt nach dem Element + \FontElement{dictum} (siehe \autoref{sec:maincls.dictum}, + \autopageref{desc:maincls.cmd.dictum})}% + \feentry{dictumtext}{% + alternative Bezeichnung für \FontElement{dictum}}% + \feentry{disposition}{% + alle Gliederungsüberschriften, also die Argumente von \Macro{part} bis + \Macro{subparagraph} und \Macro{minisec} sowie die Überschrift der + Zusammenfassung; die Anwendung erfolgt vor dem Element der jeweiligen + Gliederungsebene (siehe \autoref{sec:maincls.structure} ab + \autopageref{sec:maincls.structure})}% + \feentry{footnote}{% + Marke und Text einer Fußnote (siehe \autoref{sec:maincls.footnotes}, + \autopageref{desc:maincls.cmd.footnote})}% + \feentry{footnotelabel}{% + Marke einer Fußnote; Anwendung erfolgt nach dem Element + \FontElement{footnote} (siehe \autoref{sec:maincls.footnotes}, + \autopageref{desc:maincls.cmd.footnote})}% + \feentry{footnotereference}{% + Referenzierung der Fußnotenmarke im Text (siehe + \autoref{sec:maincls.footnotes}, + \autopageref{desc:maincls.cmd.footnote})}% + \feentry{minisec}{% + mit \Macro{minisec} gesetzte Überschrift (siehe + \autoref{sec:maincls.structure} ab + \autopageref{desc:maincls.cmd.minisec})}% + \feentry{pagefoot}{% + wird nur verwendet, wenn das Paket \Package{scrpage2} geladen ist (siehe + \autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot})}% + \feentry{pagehead}{% + alternative Bezeichnung für \FontElement{pageheadfoot}}% + \feentry{pageheadfoot}{% + Seitenkopf und Seitenfuß bei allen von \KOMAScript{} definierten + Seitenstilen (siehe \autoref{sec:maincls.pagestyle} ab + \autopageref{sec:maincls.pagestyle})}% + \feentry{pagenumber}{% + Seitenzahl im Kopf oder Fuß der Seite (siehe + \autoref{sec:maincls.pagestyle})}% + \feentry{pagination}{% + alternative Bezeichnung für \FontElement{pagenumber}}% + \feentry{paragraph}{% + Überschrift der Ebene \Macro{paragraph} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.paragraph})}% + \feentry{part}{% + Überschrift der Ebene \Macro{part}, jedoch ohne die Zeile mit der Nummer + des Teils (siehe \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.part})}% + \feentry{partentry}{% + Inhaltsverzeichniseintrag der Ebene \Macro{part}}% + \feentry{partentrypagenumber}{% + Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{part} + abweichend vom Element \FontElement{partentry} (siehe + \autoref{sec:maincls.toc}, + \autopageref{desc:maincls.cmd.tableofcontents})}% + \feentry{partnumber}{% + Zeile mit der Nummer des Teils in Überschrift der Ebene \Macro{part} + (siehe \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.part})}% + \feentry{section}{% + Überschrift der Ebene \Macro{section} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.section})}% + \feentry{sectionentry}{% + Inhaltsverzeichniseintrag der Ebene \Macro{section} (nur bei + \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, + \autopageref{desc:maincls.cmd.tableofcontents})}% + \feentry{sectionentrypagenumber}{% + Seitenzahl des Inhaltsverzeichniseintrags der Ebene \Macro{section} + abweichend vom Element \FontElement{sectionentry} (nur bei + \Class{scrartcl} verfügbar, siehe \autoref{sec:maincls.toc}, + \autopageref{desc:maincls.cmd.tableofcontents})}% + \feentry{sectioning}{% + alternative Bezeichnung für \FontElement{disposition}}% + \feentry{subject}{% + Typisierung des Dokuments, also das Argument von \Macro{subject} auf der + Haupttitelseite (siehe \autoref{sec:maincls.titlepage}, + \autopageref{desc:maincls.cmd.subject})}% + \feentry{subparagraph}{% + Überschrift der Ebene \Macro{subparagraph} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.subparagraph})}% + \feentry{subsection}{% + Überschrift der Ebene \Macro{subsection} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.subsection})}% + \feentry{subsubsection}{% + Überschrift der Ebene \Macro{subsubsection} (siehe + \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.subsubsection})}% + \feentry{subtitle}{% + Untertitel des Dokuments, also das Argument von \Macro{subtitle} auf der + Haupttitelseite (siehe \autoref{sec:maincls.titlepage}, + \autopageref{desc:maincls.cmd.title})}% + \feentry{title}{% + Haupttitel des Dokuments, also das Argument von \Macro{title} (bezüglich + der Größe des Haupttitels siehe die ergänzenden Bemerkungen im Text von + \autoref{sec:maincls.titlepage} ab + \autopageref{desc:maincls.cmd.title})}% +\end{desctable} +% +\EndIndex{Cmd}{setkomafont}% +\EndIndex{Cmd}{addtokomafont}% +\EndIndex{Cmd}{usekomafont}% +% +\EndIndex{}{Schriftart}% +\EndIndex{}{Text>Auszeichnung} + +\LoadCommon{14}% \section{Dokumenttitel} + + +\section{Zusammenfassung} +\label{sec:maincls.abstract} +\BeginIndex{}{Zusammenfassung}% + +Insbesondere bei Artikeln, seltener bei Berichten findet man unmittelbar unter +der Titelei und noch vor dem Inhaltsverzeichnis eine Zusammenfassung. Bei +Verwendung eines Titelkopfes ist die Zusammenfassung in der Regel ein rechts +und links eingezogener Block. Im Vergleich dazu wird bei Verwendung von +Titelseiten die Zusammenfassung eher als Kapitel oder Abschnitt gesetzt. + +\begin{Declaration} + \KOption{abstract}\PName{Ein-Aus-Wert} +\end{Declaration}% +\BeginIndex{Option}{abstract~=\PName{Ein-Aus-Wert}}% +\ChangedAt{v3.00}{\Class{scrreprt}\and \Class{scrartcl}}% +Bei\OnlyAt{\Class{scrreprt}\and \Class{scrartcl}} +den Standardklassen setzt die \Environment{abstract}-Umgebung noch den +zentrierten Titel »\abstractname« vor die Zusammenfassung. Früher war dies +durchaus üblich. Inzwischen sind wir durch das Zeitunglesen darin geübt, einen +entsprechend hervorgehobenen Text am Anfang eines Artikels oder Berichts als +Zusammenfassung zu erkennen. Dies gilt umso mehr, wenn dieser Text noch vor +dem Inhaltsverzeichnis steht. Zudem verwundert es, wenn ausgerechnet diese +Überschrift klein und zentriert ist. {\KOMAScript} bietet mit der Option +\Option{abstract} die Möglichkeit, die Überschrift über der Zusammenfassung +ein- oder auszuschalten. Als \PName{Ein-Aus-Wert} kann einer der +Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, +\autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist bei +\KOMAScript{} \PValue{false}. + +Bei Büchern wird in der Regel eine andere Art der Zusammenfassung +verwendet. Dort setzt man ein entsprechendes Kapitel an den Anfang oder Ende +des Werks. Oft wird diese Zusammenfassung entweder mit der Einleitung oder +einem weiteren Ausblick verknüpft. Daher gibt es bei \Class{scrbook} überhaupt +keine \Environment{abstract}-Umgebung. Bei Berichten im weiteren Sinne, etwa +einer Studien- oder Diplomarbeit, ist ebenfalls eine Zusammenfassung in dieser +Form zu empfehlen.% +% +\EndIndex{Option}{abstract~=\PName{Ein-Aus-Wert}}% + + +\begin{Declaration} + \XMacro{begin}\PParameter{\Environment{abstract}}\\ + \quad\dots\\ + \XMacro{end}\PParameter{abstract} +\end{Declaration}% +\BeginIndex{Env}{abstract}% +\OnlyAt{\Class{scrartcl}\and \Class{scrreprt}}% +Einige \LaTeX-Klassen bieten eine spezielle Umgebung für diese +Zusammenfassung, die \Environment{abstract}-Umgebung. Diese wird unmittelbar +ausgegeben, ist also nicht Bestandteil der mit \Macro{maketitle} gesetzten +Titelei. Bitte beachten Sie unbedingt, dass es sich bei \Environment{abstract} +um eine Umgebung und nicht um eine Anweisung handelt. Ob die Zusammenfassung +mit einer Überschrift versehen wird oder nicht, wird über die Option +\Option{abstract} gesteuert (siehe oben). + +Bei Büchern (\Class{scrbook}) ist die Zusammenfassung häufig Bestandteil der +Einleitung oder eines gesonderten Kapitels am Ende des Dokuments. Daher gibt +es hier keine \Environment{abstract}-Umgebung. Bei Verwendung der Klasse +\Class{scrreprt} ist es sicher eine Überlegung wert, ob man nicht genauso +verfahren sollte. Siehe hierzu in \autoref{sec:maincls.structure} die +Anweisungen \Macro{chapter*}\IndexCmd{chapter*} +(\autopageref{desc:maincls.cmd.chapter*}) und +\Macro{addchap}\IndexCmd{addchap} beziehungsweise \Macro{addchap*} +(\autopageref{desc:maincls.cmd.addchap}). + +Wird ein Titelkopf\Index{Titel>-Kopf} (siehe Option \Option{titlepage}, +\autoref{sec:maincls.titlepage}, \autopageref{desc:maincls.option.titlepage}) +verwendet, so wird die Zusammenfassung intern mit Hilfe einer +\Environment{quotation}-Umgebung\IndexEnv{quotation} (siehe +\autoref{sec:maincls.lists}, \autopageref{desc:maincls.env.quotation}) +gesetzt. Dabei werden Absatzanfänge normalerweise mit Einzug gesetzt. Soll der +erste Absatz nicht eingezogen werden, so kann dieser Einzug mit +\Macro{noindent}\IndexCmd{noindent} unmittelbar nach +\Macro{begin}\PParameter{abstract} unterdrückt werden.% +% +\EndIndex{Env}{abstract} +% +\EndIndex{}{Zusammenfassung} + + +\section{Inhaltsverzeichnis} +\label{sec:maincls.toc} +\BeginIndex{}{Inhaltsverzeichnis} + +Auf die Titelei und eine eventuell vorhandene Zusammenfassung folgt +normalerweise das Inhaltsverzeichnis. Häufig findet +man nach dem Inhaltsverzeichnis auch noch die Verzeichnisse der +Gleitumgebungen, beispielsweise von Tabellen und Abbildungen (siehe +\autoref{sec:maincls.floats}). + + +\begin{Declaration} + \KOption{toc}\PName{Einstellung} +\end{Declaration} +\BeginIndex{Option}{toc~=\PName{Einstellung}}% +Neuerdings ist es fast schon üblich geworden Tabellen- und +Abbildungsverzeichnis sowie das Literaturverzeichnis, seltener das +Stichwortverzeichnis, ins Inhaltsverzeichnis aufzunehmen. Dies hat sicher +auch mit der neuen Mode zu tun, Abbildungs- und Tabellenverzeichnis ans +Buchende zu stellen. Beide Verzeichnisse haben von Aufbau und Intention eine +deutliche Ähnlichkeit mit dem Inhaltsverzeichnis. Daher betrachte ich die +Entwicklung skeptisch. Da es keinen Sinn hat, nur das Tabellen- oder nur das +Abbildungsverzeichnis ohne das jeweils andere ins Inhaltsverzeichnis +aufzunehmen, werden mit der \PName{Einstellung}\ChangedAt{v3.00}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}} +\PValue{listof}\IndexOption{toc~=listof} beide Verzeichnisse +gemeinsam ins Inhaltsverzeichnis aufgenommen. Dabei werden auch Verzeichnisse +berücksichtigt, die mit Hilfe des \Package{float}-Pakets\IndexPackage{float} +ab Version~1.2e (siehe \cite{package:float}) oder \Package{floatrow} (siehe +\cite{package:floatrow}) erstellt werden. Als Verzeichnisse, die den Inhalt +anderer Abschnitte des Werks auf"|führen, erhalten Tabellen"~, Abbildungs- und +die mit den genannten Paketen erzeugten Verzeichnisse grundsätzlich keine +Kapitelnummer. Wer diesen Grundsatz ignorieren will, bedient sich der +\PName{Einstellung} +\PValue{listofnumbered}\IndexOption{toc~=listofnumbered}. + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.toc.index}\nobreak +Das Stichwortverzeichnis erhält mit +\OptionValue{toc}{index}\IndexOption{toc~=index} einen Eintrag im +Inhaltsverzeichnis. Da das Stichwortverzeichnis ebenfalls nur Verweise auf den +Inhalt anderer Abschnitte enthält, wird auch dieser Eintrag grundsätzlich +nicht nummeriert. Eine Abweichung von diesem Grundsatz wird von \KOMAScript{} +nicht unterstützt. + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.toc.bibliography}\nobreak +Das Literaturverzeichnis stellt eine etwas andere Art von Verzeichnis +dar. Hier wird nicht der Inhalt des vorliegenden Werks aufgelistet, sondern +auf externe Inhalte verwiesen. Mit dieser Begründung könnte man argumentieren, +dass das Literaturverzeichnis ein eigenes Kapitel bzw. einen eigenen Abschnitt +darstelle und somit eine Nummer verdiene. Die Option +\OptionValue{toc}{bibliographynumbered}\IndexOption{toc~=bibliographynumbered} +führt genau dazu, einschließlich des dann fälligen Eintrags im +Inhaltsverzeichnis. Ich selbst bin allerdings der Meinung, dass bei dieser +Argumentation auch ein klassisches, kommentiertes Quellenverzeichnis ein +eigenes Kapitel wäre. Außerdem ist das Literaturverzeichnis letztlich nichts, +was man selbst geschrieben hat. Deshalb erscheint mir allenfalls ein nicht +nummerierter Eintrag im Inhaltsverzeichnis angemessen, was mit der Einstellung +\OptionValue{toc}{bibliography}\IndexOption{toc~=bibliography} erreicht +wird. + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.toc.graduated}\nobreak +Normalerweise\ChangedAt{v2.8q}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} wird das +Inhaltsverzeichnis so formatiert, dass die +Gliederungsebenen unterschiedlich weit eingezogen werden. Dabei wird für die +Gliederungsnummer jeder Ebene ein Raum fester Breite vorgesehen, in dem die +Nummer linksbündig gesetzt wird. Dies entspricht der +Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} \OptionValue{toc}{graduated}\IndexOption{toc~=graduated}. + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.toc.flat}\nobreak +Werden sehr viele Gliederungspunkte verwendet, so werden die +Gliederungsnummern sehr breit. Damit reicht der vorgesehene Platz nicht +aus. In \cite{DANTE:FAQ} wird für solche Fälle vorgeschlagen, die Erzeugung +des Inhaltsverzeichnisses umzudefinieren. \KOMAScript{} bietet jedoch eine +alternative Formatierung an, bei der das Problem nicht auf"|tritt. Bei +Verwendung der Option \OptionValue{toc}{flat}\IndexOption{toc~=flat} werden +die unterschiedlichen Gliederungsebenen nicht unterschiedlich weit +eingezogen. Stattdessen wird eine tabellenartige Form gewählt, in der alle +Gliederungsnummern und alle Gliederungstexte jeweils in einer Spalte +linksbündig untereinander stehen. Der für die Gliederungsnummern benötigte +Platz wird dabei automatisch ermittelt. + +Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von +\Option{toc} ist in \autoref{tab:maincls.toc} zu finden. + +\begin{desctable} + \caption[{Mögliche Werte für Option \Option{toc}}]{Mögliche Werte für Option + \Option{toc} zur Einstellung von Form und Inhalt des + Inhaltsverzeichnisses\label{tab:maincls.toc}}\\ + \Endfirsthead% + \caption[]{Mögliche Werte für Option \Option{toc} (\emph{Fortsetzung})}\\ + \Endhead% + \standardfoot% + \entry{\PValue{bibliography}, \PValue{bib}}{% + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne + dass es nummeriert wird.% + \IndexOption{toc~=bibliography}}% + \entry{\PValue{bibliographynumbered}, \PValue{bibnumbered}, + \PValue{numberedbibliography}, \PValue{numberedbib}}{% + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + wird nummeriert.% + \IndexOption{toc~=bibliographynumbered}}% + \entry{\PValue{flat}, \PValue{left}}{% + Das Inhaltsverzeichnis erhält eine tabellarische Form. Die + Gliederungsnummern sind dabei die erste Spalte, die Überschriften die + zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die + Gliederungsnummern reserviert wird, richtet sich nach dem benötigten Platz + des vorherigen \LaTeX-Laufs.% + \IndexOption{toc~=flat}}% + \entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{% + Das Inhaltsverzeichnis erhält eine hierarchische Form. Es steht nur ein + begrenzter Platz für die Gliederungsnummern zur Verfügung.% + \IndexOption{toc~=graduated}}% + \entry{\PValue{index}, \PValue{idx}}{% + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, ohne + dass es nummeriert wird.% + \IndexOption{toc~=index}}% + \pventry{listof}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis, + ohne dass sie nummeriert werden.% + \IndexOption{toc~=listof}}% + \entry{\PValue{listofnumbered}, \PValue{numberedlistof}}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis + und werden nummeriert.% + \IndexOption{toc~=listofnumbered}}% + \entry{\PValue{nobibliography}, \PValue{nobib}}{% + Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.% + \IndexOption{toc~=nobibliography}}% + \entry{\PValue{noindex}, \PValue{noidx}}{% + Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.% + \IndexOption{toc~=noindex}}% + \pventry{nolistof}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten keinen Eintrag im Inhaltsverzeichnis.% + \IndexOption{toc~=nolistof}}% +\end{desctable} +% +\EndIndex{Option}{toc~=\PName{Einstellung}}% + + +\begin{Declaration} + \Macro{tableofcontents} +\end{Declaration}% +\BeginIndex{Cmd}{tableofcontents}% +Die Ausgabe des Inhaltsverzeichnisses erreicht man mit +\Macro{tableofcontents}. Um ein korrektes Inhaltsverzeichnis zu erhalten, sind +nach jeder Änderung mindestens zwei \LaTeX-Läufe notwendig. Mit der oben +erläuterten Option \Option{toc} kann der Umfang und die Form des +Inhaltsverzeichnisses beeinflusst werden. Nach einer Umschaltung sind +ebenfalls mindestens zwei weitere \LaTeX-Läufe notwendig. + +Der Eintrag für die oberste Gliederungsebene unter \Macro{part}, also +\Macro{chapter} bei \Class{scrbook}\IndexClass{scrbook} und +\Class{scrreprt}\IndexClass{scrreprt} beziehungsweise \Macro{section} bei +\Class{scrartcl}\IndexClass{scrartcl}, sowie der Gliederungsebene \Macro{part} +selbst wird nicht eingerückt. Gleichzeitig befinden sich zwischen dem Text der +Gliederungsebene und der Seitenzahl keine Pünktchen. Die typografischen Gründe +dafür liegen in der normalerweise anderen Schriftart sowie der erwünschten +Hervorhebung. Das Inhaltsverzeichnis dieser Anleitung ist mit den +Voreinstellungen gesetzt und dient als Beispiel. +Die\ChangedAt{v2.97c}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} Schrift dieser beiden oberen Inhaltsverzeichniseinträge +ist außerdem über die Elemente +\FontElement{partentry}\IndexFontElement{partentry} und für \Class{scrbook} +und \Class{scrreprt} über +\FontElement{chapterentry}\IndexFontElement{chapterentry} +bzw. \FontElement{sectionentry}\IndexFontElement{sectionentry} für +\Class{scrartcl} einstellbar. Die Schrift der Seitenzahlen kann davon +abweichend über die Elemente +\FontElement{partentrypagenumber}\IndexFontElement{partentrypagenumber} und +\FontElement{chapterentrypagenumber}\IndexFontElement{chapterentrypagenumber} +bzw. +\FontElement{sectionentrypagenumber}\IndexFontElement{sectionentrypagenumber} +eingestellt werden (siehe auch \autoref{sec:maincls.textmarkup}, +\autopageref{desc:maincls.cmd.setkomafont}, sowie +\autoref{tab:maincls.elementsWithoutText}, +\autopageref{tab:maincls.elementsWithoutText}). Die Voreinstellungen der +Elemente ist \autoref{tab:maincls.tocelements} zu entnehmen. +\begin{table} + \centering + \caption{Schriftvoreinstellungen für die Elemente des Inhaltsverzeichnisses} + \begin{tabular}{ll} + \toprule + Element & Voreinstellung \\ + \midrule + \FontElement{partentry} & + \Macro{usekomafont}\PParameter{disposition}\Macro{large} \\ + \FontElement{partentrypagenumber} & \\ + \FontElement{chapterentry} & \Macro{usekomafont}\PParameter{disposition} + \\ + \FontElement{chapterentrypagenumber} & \\ + \FontElement{sectionentry} & \Macro{usekomafont}\PParameter{disposition} + \\ + \FontElement{sectionentrypagenumber} & \\ + \bottomrule + \end{tabular} + \label{tab:maincls.tocelements} +\end{table} +% +\EndIndex{Cmd}{tableofcontents}% + + +\begin{Declaration} + \Counter{tocdepth} +\end{Declaration}% +\BeginIndex{Counter}{tocdepth}% +Normalerweise werden bei den Klassen \Class{scrbook} und \Class{scrreprt} die +Gliederungsebenen \Macro{part} bis \Macro{subsection} und bei der Klasse +\Class{scrartcl} die Ebenen \Macro{part} bis \Macro{subsubsection} in das +Inhaltsverzeichnis aufgenommen. Gesteuert wird dies über den Zähler +\Counter{tocdepth}. Dabei steht der Wert \(-\)1 für \Macro{part}, 0 für +\Macro{chapter} und so weiter. Durch Setzen oder Erhöhen oder Verringern des +Zählers kann bestimmt werden, bis zu welcher Gliederungsebene Einträge in das +Inhaltsverzeichnis erfolgen sollen. Dies ist übrigens bei den Standardklassen +ganz genauso. + +Bei Verwendung des \Package{scrpage2}-Pakets\IndexPackage{scrpage2} +(siehe \autoref{cha:scrpage}) muss man sich nicht die nummerischen +Werte der einzelnen Gliederungsebenen merken. Dann stehen dafür die +Makros \Macro{chapterlevel}, \Macro{sectionlevel} und so weiter bis +hinunter zu \Macro{subparagraphlevel} zur Verfügung. +\begin{Example} + Angenommen, Sie setzen einen Artikel, bei dem die Gliederungsebene + \Macro{subsubsection} verwendet wird. Gehen wir weiter davon aus, + dass Sie diese Gliederungsebene aber nicht im Inhaltsverzeichnis + haben wollen. Dann könnte die Präambel Ihres Dokuments wie folgt + aussehen: +\begin{lstcode} + \documentclass{scrartcl} + \setcounter{tocdepth}{2} +\end{lstcode} + Sie setzen den Zähler \Counter{tocdepth} also auf 2, weil Sie + wissen, dass dies der Wert für \Macro{subsection} ist. Wissen Sie + stattdessen nur, dass normalerweise bei \Class{scrartcl} Einträge in + das Inhaltsverzeichnis bis zur Ebene \Macro{subsubsection} erfolgen, + können Sie auch einfach vom voreingestellten Wert des Zählers + \Counter{tocdepth} eins abziehen: +\begin{lstcode} + \documentclass{scrartcl} + \addtocounter{tocdepth}{-1} +\end{lstcode} + Wie viel Sie von \Counter{tocdepth} subtrahieren oder dazu addieren + müssen, kön"-nen Sie natürlich auch einfach nach einem ersten + \LaTeX-Lauf im Inhaltsverzeichnis abzählen. +\end{Example} +\iftrue % Umbruchausgleichstext +Falls Sie sich nicht merken wollen, welche Nummer zu welcher Gliederungsebene +gehört: Einfach im Inhaltsverzeichnis abzählen, wie viele Ebenen mehr oder +weniger Sie benötigen, und dann wie in obigem Beispiel mit +\Macro{addtocounter} zu \Counter{tocdepth} addieren oder davon subtrahieren.% +\fi% +\iffalse % Umbruchausgleichstext +Ein kleiner Tip am Rande: In obigem Beispiel benötigen Sie immer irgendein +Vorwissen. Es geht aber auch ohne indem Sie zunächst zwei \LaTeX-Läufe +durchführen. Dann zählen Sie am Inhaltsverzeichnis ab, wieviele Ebenen Sie zu +\Counter{tocdepth} hinzuaddieren oder davon abziehen müssen. Dies erledigen +Sie dann wie eben mit Hilfe von \Macro{addtocounter} in der Präambel Ihres +Dokuments.% +\fi +% +\EndIndex{Counter}{tocdepth}% +% +\EndIndex{}{Inhaltsverzeichnis} + + +\LoadCommon{6} % \section{Absatzauszeichnung} + +\LoadCommon{7} % \section{Erkennung von rechten und linken Seiten} + + +\section{Kopf und Fuß bei vordefinierten Seitenstilen} +\label{sec:maincls.pagestyle} + +Eine der allgemeinen Eigenschaften eines Dokuments ist der +Seitenstil\Index[indexmain]{Seitenstil}. Bei {\LaTeX} versteht man +unter dem Seitenstil in erster Linie den Inhalt der Kopf- und +Fußzeilen. + + +\begin{Declaration} + \KOption{headsepline}\PName{Ein-Aus-Wert}\\ + \KOption{footsepline}\PName{Ein-Aus-Wert} +\end{Declaration}% +\BeginIndex{Option}{headsepline~=\PName{Ein-Aus-Wert}}% +\BeginIndex{Option}{footsepline~=\PName{Ein-Aus-Wert}}% +Mit diesen Optionen kann eingestellt werden, +ob\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +unter Kolumnentiteln oder über dem Fuß eine horizontale Linie\Index{Trennlinie} +gewünscht wird. Als \PName{Ein-Aus-Wert} kann +einer der Standardwerte für einfache Schalter aus +\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet +werden. Ein Aktivieren der Option \Option{headsepline} oder die Verwendung +der Option ohne Wertübergabe schaltet die Linie unter den Kolumnentiteln +ein. Ein Aktivieren der Option \Option{footsepline} oder die Verwendung der +Option ohne Wertübergabe schaltet die Linie über der Fußzeile ein. Die +Deaktivierung der Optionen schaltet die jeweilige Linie aus. + +Bei den weiter unten erklärten Seitenstilen \PValue{empty} und \PValue{plain} +hat die Option \Option{headsepline} selbstverständlich keine Auswirkung, da +hier auf einen Seitenkopf\Index{Seitenkopf} ausdrücklich verzichtet werden +soll. Typografisch betrachtet hat eine solche Linie immer die Auswirkung, +dass der Kopf optisch näher an den Text heranrückt. Dies bedeutet nun nicht, +dass der Kopf räumlich weiter vom Textkörper\Index{Textbereich} weggerückt +werden müsste. Stattdessen sollte der Kopf dann bei der Berechnung des +Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei +{\KOMAScript} dadurch erreicht, dass bei Verwendung der Klassenoption +\Option{headsepline} automatisch die Paketoption \Option{headinclude} mit +gleichem Wert an das \Package{typearea}-Paket weitergereicht +wird. Entsprechendes gilt bei \Option{footsepline} für +\Option{footinclude}. Im Gegensatz zu \Option{headsepline} wirkt sich die +Option \Option{footsepline} auch beim Seitenstil \PValue{plain} aus, da +\PValue{plain} eine Seitenzahl im Fuß ausgibt. Das Paket +\Package{scrpage2}\IndexPackage{scrpage2} (siehe \autoref{cha:scrpage}) bietet +weitere Einflussmöglichkeiten für Linien im Kopf und Fuß.% +% +\EndIndex{Option}{headsepline~=\PName{Ein-Aus-Wert}}% +\EndIndex{Option}{footsepline~=\PName{Ein-Aus-Wert}}% + + +\begin{Declaration} + \Macro{pagestyle}\Parameter{Seitenstil}\\ + \Macro{thispagestyle}\Parameter{lokaler Seitenstil} +\end{Declaration}% +\BeginIndex{Cmd}{pagestyle}% +\BeginIndex{Cmd}{thispagestyle}% +Üblicherweise wird zwischen vier verschiedenen Seitenstilen unterschieden: +\begin{description} +\item[{\Pagestyle{empty}\BeginIndex{Pagestyle}{empty}}] ist der Seitenstil, + bei dem Kopf- und Fußzeile vollständig leer bleiben. Dies ist bei + {\KOMAScript} vollkommen identisch zu den Standardklassen.% +\item[{\Pagestyle{headings}\BeginIndex{Pagestyle}{headings}}] ist der + Seitenstil für lebende Kolumnentitel. Das sind Kolumnentitel, bei denen + Überschriften automatisch\Index[indexmain]{Kolumnentitel>automatisch} in den + Seitenkopf übernommen werden. Im Internet oder in Beschreibungen zu + \LaTeX-Paketen findet man auch häufig die englische Bezeichnung + »\emph{running headline}«. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% + Bei den Klassen \Class{scrbook}\IndexClass{scrbook} und + \Class{scrreprt}\IndexClass{scrreprt} werden dabei im doppelseitigen Layout + die Überschriften der Kapitel und der Abschnitte in der Kopfzeile wiederholt + -- bei {\KOMAScript} jeweils außen, bei den Standardklassen innen. Die + Seitenzahl wird bei {\KOMAScript} im Fuß außen, bei den Standardklassen im + Kopf außen gesetzt. Im einseitigen Layout werden nur die Überschriften der + Kapitel verwendet und bei {\KOMAScript} zentriert im Kopf ausgegeben. Die + Seitenzahlen werden bei {\KOMAScript} dann zentriert im Fuß gesetzt. + \OnlyAt{\Class{scrartcl}}Bei \Class{scrartcl}\IndexClass{scrartcl} wird + entsprechend verfahren, jedoch eine Ebene tiefer bei Abschnitt und + Unterabschnitt angesetzt, da die Gliederungsebene Kapitel hier nicht + existiert. + + Während die Standardklassen automatische Kolumnentitel immer in Versalien -- + also Großbuchstaben -- setzen, verwendet {\KOMAScript} die Schreibweise, die + in der Überschrift vorgefunden wurde. Dies hat verschiedene typografische + Gründe. So sind Versalien als Auszeichnung eigentlich viel zu + mächtig. Verwendet man sie trotzdem, sollten sie um einen Punkt kleiner + gesetzt und leicht gesperrt werden (siehe hierzu beispielsweise + \cite{JTschErfreulich}). All dies findet bei den Standardklassen keine + Beachtung. + + Darüber hinaus können bei den \KOMAScript-Klassen mit den + Optionen \Option{headsepline} und \Option{footsepline} (siehe + \autopageref{desc:maincls.option.headsepline}) Linien unter dem Kopf und + über dem Fuß gesetzt werden.% +\item[{\Pagestyle{myheadings}\BeginIndex{Pagestyle}{myheadings}}] entspricht + weitgehend dem Seitenstil \texttt{headings}, allerdings werden die + Kolumnentitel nicht automatisch\Index[indexmain]{Kolumnentitel>manuell} + erzeugt, sondern liegen in der Verantwortung des Anwenders. Er verwendet + dazu die Anweisungen \Macro{markboth}\IndexCmd{markboth} und + \Macro{markright}\IndexCmd{markright} (siehe + \autopageref{desc:maincls.cmd.markright}). +\item[{\Pagestyle{plain}\BeginIndex{Pagestyle}{plain}}] ist der Seitenstil, + bei dem keinerlei Kolumnentitel\Index{Kolumnentitel} verwendet, sondern nur + eine Seitenzahl\Index{Seitenzahl}\Index{Paginierung} ausgegeben wird. Bei + den Standardklassen wird diese Seitenzahl immer mittig im Fuß + ausgegeben. Bei {\KOMAScript} erfolgt die Ausgabe im + doppelseitigen\Index{doppelseitig} Layout stattdessen außen im Fuß. Der + einseitige Seitenstil entspricht bei {\KOMAScript} dem der Standardklassen.% +\end{description} + +Der Seitenstil kann jederzeit mit Hilfe der \Macro{pagestyle}-Anweisung +gesetzt werden und gilt dann ab der nächsten Seite, die ausgegeben +wird. Üblicherweise setzt man den Seitenstil jedoch nur einmal zu Beginn des +Dokuments oder in der Präambel. + +Für eine Änderung des Seitenstils nur der aktuellen Seite verwendet man +stattdessen die Anweisung \Macro{thispagestyle}. Dies geschieht auch an +einigen Stellen im Dokument automatisch. Beispielsweise wird bei allen +Kapitelanfangsseiten implizit die Anweisung +\Macro{thispagestyle}\PParameter{\Macro{chapterpagestyle}} ausgeführt. + +Bitte beachten Sie auch, dass die Umschaltung zwischen automatischen und +manuellen Kolumnentiteln bei Verwendung des \Package{scrpage2}-Pakets nicht +mehr über den Seitenstil, sondern mit speziellen Anweisungen erfolgt. Die +Seitenstile \texttt{headings} und \texttt{myheadings} sollten nicht zusammen +mit diesem Paket verwendet werden (siehe \autoref{cha:scrpage}, +\autopageref{desc:scrpage.pagestyle.useheadings}). + +\BeginIndex[indexother]{}{Schriftart}% +\BeginIndex{FontElement}{pageheadfoot}% +\BeginIndex{FontElement}{pagefoot}% +\BeginIndex{FontElement}{pagenumber}% +Um die Schriftarten von Kopf und Fuß der Seite oder der Seitenzahl zu +ändern\ChangedAt{v2.8p}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}, % +verwenden Sie die Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} +(siehe \autoref{sec:maincls.textmarkup}, +\autopageref{desc:maincls.cmd.setkomafont}). Für den Kopf und den Fuß ist +dabei das gleiche Element +\FontElement{pageheadfoot}\IndexFontElement{pageheadfoot} zuständig. Das +Element für die Seitenzahl innerhalb des Kopfes oder Fußes heißt +\FontElement{pagenumber}\IndexFontElement{pagenumber}. Das ebenfalls in den +\KOMAScript-Klassen bereitgestellte Element +\FontElement{pagefoot}\IndexFontElement{pagefoot} wird nur verwendet, wenn man +mit dem Paket \Package{scrpage2}\IndexPackage{scrpage2} (siehe +\autoref{cha:scrpage}, \autopageref{desc:scrpage.fontelement.pagefoot}) +einen Seitenstil definiert, bei dem auch der Fuß Text enthält. + +Die Voreinstellungen sind in \autoref{tab:maincls.defaultFontsHeadFoot} zu +finden. +% +\begin{table} + \centering% + \caption{Schriftvoreinstellungen für die Elemente des Seitenstils} + \begin{tabular}{ll} + \toprule + Element & Voreinstellung \\ + \midrule + \FontElement{pagefoot}\IndexFontElement{pagefoot} & + \\ + \FontElement{pageheadfoot}\IndexFontElement{pagehead} & + \Macro{normalfont}\Macro{normalcolor}\Macro{slshape} \\ + \FontElement{pagenumber}\IndexFontElement{pagenumber} & + \Macro{normalfont}\Macro{normalcolor}\\ + \bottomrule + \end{tabular} + \label{tab:maincls.defaultFontsHeadFoot} +\end{table} +% +\begin{Example} + \leavevmode\phantomsection\label{sec:maincls.pagestyle.example}% + Angenommen, Sie wollen Kopf und Fuß einen Schriftgrad kleiner und kursiv + setzen. Die Seitenzahl soll jedoch nicht kursiv, sondern fett gesetzt + werden. Davon abgesehen, dass das Ergebnis grauenvoll aussehen wird, können + Sie dies wie folgt erreichen: + \begin{lstcode} + \setkomafont{pageheadfoot}{% + \normalfont\normalcolor\itshape\small + } + \setkomafont{pagenumber}{\normalfont\bfseries} + \end{lstcode} + Wollen Sie hingegen lediglich, dass zusätzlich zur bereits voreingestellten + schrägen Variante ebenfalls eine kleinere Schrift verwendet wird, so genügt: + \begin{lstcode} + \addtokomafont{pagehead}{\small} + \end{lstcode} + Wie Sie sehen, ist im letzten Beispiel das Element \FontElement{pagehead} + verwendet. Das gleiche Ergebnis erhalten Sie auch, wenn Sie stattdessen + \FontElement{pageheadfoot} verwenden (siehe + \autoref{tab:maincls.elementsWithoutText}, + \autopageref{tab:maincls.elementsWithoutText}). +\end{Example} +Es ist an dieser Stelle nicht möglich, Versalien für die automatischen +Kolumnentitel zu erzwingen. Wenn Sie dies wünschen, verwenden Sie bitte das +\Package{scrpage2}-Paket (siehe \autoref{cha:scrpage}, +\autopageref{desc:scrpage.option.markuppercase}). + +Die Befehle \Macro{usekomafont}\PParameter{pageheadfoot}, +\Macro{usekomafont}\PParameter{pagenumber} und +\Macro{usekomafont}\PParameter{pagefoot} können beispielsweise dann nützlich +sein, wenn Sie eigene Seitenstile definieren. Falls Sie dafür nicht das +\KOMAScript-Paket \Package{scrpage2} (siehe \autoref{cha:scrpage}), sondern +beispielsweise das Paket \Package{fancyhdr}\IndexPackage{fancyhdr} (siehe +\cite{package:fancyhdr}) einsetzen, können Sie diese Befehle in Ihren +Definitionen verwenden. Dadurch bleiben Sie zu \KOMAScript{} möglichst +kompatibel. Verwenden Sie diese Befehle in Ihren eigenen Definitionen nicht, +so bleiben Schriftänderungen wie in den vorangehenden Beispielen +unbeachtet. Das Paket \Package{scrpage2}\IndexPackage{scrpage2} sorgt selbst +für maximale Kompatibilität.% +\EndIndex{FontElement}{pagenumber}% +\EndIndex{FontElement}{pagefoot}% +\EndIndex{FontElement}{pageheadfoot}% +% +\EndIndex[indexother]{}{Schriftart}% +% +\EndIndex{Cmd}{pagestyle}% +\EndIndex{Cmd}{thispagestyle}% +\EndIndex{Pagestyle}{empty}% +\EndIndex{Pagestyle}{plain}% + + +\begin{Declaration} + \Macro{markboth}\Parameter{linke Marke}\Parameter{rechte Marke}\\ + \Macro{markright}\Parameter{rechte Marke} +\end{Declaration} +\BeginIndex{Cmd}{markboth}% +\BeginIndex{Cmd}{markright}% +Beim Seitenstil \Pagestyle{myheadings} wird der Kolumnentitel nicht +automatisch gesetzt. Stattdessen setzt man ihn mit Hilfe der Anweisungen +\Macro{markboth} und \Macro{markright}. Dabei wird die \PName{linke Marke} +normalerweise im Kopf linker Seiten und die \PName{rechte Marke} im Kopf +rechter Seiten verwendet. Im einseitigen Satz existiert nur die rechte Marke. +Bei Verwendung des Paketes \Package{scrpage2}\IndexPackage{scrpage2} steht +außerdem die Anweisung \Macro{markleft}\IndexCmd{markleft} zur Verfügung. + +Die Anweisungen können auch zusammen mit anderen Seitenstilen verwendet +werden. Bei Kombination mit automatischen Kolumnentiteln, etwa dem Seitenstil +\Pagestyle{headings}, ist der Wirkungsbereich allerdings bis zum nächsten +automatischen Setzen der entsprechenden Marke begrenzt.% +% +\EndIndex{Cmd}{markright}% +\EndIndex{Cmd}{markboth}% +% +\EndIndex{Pagestyle}{headings}% +\EndIndex{Pagestyle}{myheadings}% + + +\begin{Declaration} + \Macro{titlepagestyle}\\ + \Macro{partpagestyle}\\ + \Macro{chapterpagestyle}\\ + \Macro{indexpagestyle} +\end{Declaration}% +\BeginIndex{Cmd}{titlepagestyle}\Index{Titel>Seitenstil}% +\BeginIndex{Cmd}{partpagestyle}\Index{Teil>Seitenstil}% +\BeginIndex{Cmd}{chapterpagestyle}\Index{Kapitel>Seitenstil}% +\BeginIndex{Cmd}{indexpagestyle}\Index{Stichwortverzeichnis>Seitenstil}% +Auf einigen Seiten wird mit Hilfe von \Macro{thispagestyle} automatisch ein +anderer Seitenstil gewählt. Welcher Seitenstil dies ist, wird diesen vier +Makros entnommen, wobei \Macro{partpagestyle} und +\Macro{chapterpagestyle}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} nur bei +den Klassen \Class{scrbook} und \Class{scrreprt} nicht jedoch bei +\Class{scrartcl} existieren. In der Voreinstellung ist der Seitenstil in allen +vier Fällen \PValue{plain}. Die Bedeutung der einzelnen Makros entnehmen Sie +bitte \autoref{tab:specialpagestyles}. +% +\begin{table} + \centering + \caption{Makros zur Festlegung des Seitenstils besonderer Seiten} + \label{tab:specialpagestyles} + \begin{desctabular} + \mentry{titlepagestyle}{Seitenstil der Seite mit der Titelei bei + Titelköpfen (siehe \autoref{sec:maincls.titlepage})}% + \mentry{partpagestyle}{Seitenstil der Seiten mit \Macro{part}-Titeln + (siehe \autoref{sec:maincls.structure})}% + \mentry{chapterpagestyle}{Seitenstil auf Kapitelanfangsseiten (siehe + \autoref{sec:maincls.structure})}% + \mentry{indexpagestyle}{Seitenstil der ersten Stichwortverzeichnisseite + (siehe \autoref{sec:maincls.index})}% + \end{desctabular} +\end{table} +% +Die Seitenstile können mit Hilfe von \Macro{renewcommand} umdefiniert +werden. +\begin{Example} + Angenommen, Sie wollen nicht, dass die Seiten mit der + \Macro{part}-Überschrift mit einer Nummer versehen werden. Dann setzen Sie + folgende Anweisung beispielsweise in der Präambel Ihres Dokuments: +\begin{lstcode} + \renewcommand*{\partpagestyle}{empty} +\end{lstcode} + Wie Sie auf \autopageref{desc:maincls.pagestyle.empty} erfahren haben, ist + der Seitenstil \PValue{empty} genau das, was in diesem Beispiel verlangt + wird. Natürlich können Sie auch einen selbst definierten Seitenstil + verwenden. + + Angenommen, Sie haben mit dem Paket \Package{scrpage2} (siehe + \autoref{cha:scrpage}) einen eigenen Seitenstil für + Kapitelanfangsseiten definiert. Diesem Seitenstil haben Sie den + passenden Namen \PValue{chapter} gegeben. Um diesen nun auch + tatsächlich zu verwenden, definieren Sie das Makro + \Macro{chapterpagestyle} entsprechend um: +\begin{lstcode} + \renewcommand*{\chapterpagestyle}{chapter} +\end{lstcode} + + Angenommen, Sie wollen das Inhaltsverzeichnis eines Buches + insgesamt nicht mit Seitenzahlen versehen. Danach soll + aber wieder mit dem Seitenstil \PValue{headings} gearbeitet + werden, sowie mit \PValue{plain} auf den Kapitelanfangsseiten. Dann + verwenden Sie beispielsweise: +\begin{lstcode} + \clearpage + \pagestyle{empty} + \renewcommand*{\chapterpagestyle}{empty} + \tableofcontents + \clearpage + \pagestyle{headings} + \renewcommand*{\chapterpagestyle}{plain} +\end{lstcode} + Sie können die Umdefinierung des Seitenstils für Kapitelanfangsseiten aber + auch lokal halten. Das hat den Vorteil, dass Sie dann keine Annahmen über + die vor der Änderung gültige Einstellung treffen müssen. Die Änderung + des Seitenstils selbst können Sie gleichermaßen lokal halten: +\begin{lstcode} + \clearpage + \begingroup + \pagestyle{empty} + \renewcommand*{\chapterpagestyle}{empty} + \tableofcontents + \clearpage + \endgroup +\end{lstcode} + Beachten Sie jedoch, dass Sie niemals eine nummerierte + Gliederungsüberschrift in eine Gruppe packen sollten. Anderenfalls können + Anweisungen wie \Macro{label} rasch zu unvorhergesehenen Ergebnissen + führen. +\end{Example} + +\begin{Explain} + Wer nun glaubt, er könne auf Kapitelanfangsseiten ebenfalls mit + lebenden Kolumnentiteln arbeiten, indem er einfach eine Definition + wie + % Umbruchkorrektur: listings korrigieren! + \begin{lstcode}[belowskip=\dp\strutbox] + \renewcommand*{\chapterpagestyle}{headings} + \end{lstcode} + verwendet, sollte in \autoref{sec:maincls-experts.addInfos}, + \autopageref{desc:maincls-experts.cmd.rightmark} Näheres über die + Hintergründe zu \Macro{rightmark} nachlesen. +\end{Explain} +% +\EndIndex{Cmd}{titlepagestyle}% +\EndIndex{Cmd}{partpagestyle}% +\EndIndex{Cmd}{chapterpagestyle}% +\EndIndex{Cmd}{indexpagestyle}% + + +\begin{Declaration} + \Macro{pagenumbering}\Parameter{Nummerierungsstil} +\end{Declaration} +\BeginIndex{Cmd}{pagenumbering}% +Diese Anweisung funktioniert bei \KOMAScript{} in der gleichen Weise wie +bei den Standardklassen. Genau genommen handelt es sich dabei weder um eine +Fähigkeit der Standardklassen noch der \KOMAScript-Klassen, sondern um eine +Anweisung des \LaTeX-Kerns. Sie wird verwendet, um den +\PName{Nummerierungsstil} für die Seitenzahlen umzuschalten. + +Die Umschaltung gilt ab sofort, also ab der Seite, auf der diese Anweisung +aufgerufen wird. Gegebenenfalls sollte also zuvor mit \Macro{clearpage} oder +\Macro{cleardoublepage} diese Seite erst beendet werden. Mögliche Angaben für +den \PName{Nummerierungsstil} sind \autoref{tab:numberKind} zu entnehmen. + +Der Aufruf von \Macro{pagenumbering} setzt immer die +Seitenzahl\Index{Seitenzahl} zurück. Die aktuelle Seite bekommt also die +Nummer 1 im gewählten \PName{Nummerierungsstil}. +% +\begin{table} + \centering + \caption{Verfügbare Nummerierungsstile für Seitenzahlen} + \begin{tabular}{lll} + \toprule + Nummerierungsstil & Beispiel & Bedeutung \\ + \midrule + \PValue{arabic} & 8 & arabische Zahlen \\ + \PValue{roman} & viii & kleine römische Zahlen \\ + \PValue{Roman} & VIII & große römische Zahlen \\ + \PValue{alph} & h & Kleinbuchstaben \\ + \PValue{Alph} & H & Großbuchstaben \\ + \bottomrule + \end{tabular} + \label{tab:numberKind} +\end{table} +% +\EndIndex{Cmd}{pagenumbering} + + +\LoadCommon{8}% \section{Vakatseiten} + +\LoadCommon{9}% \section{Fußnoten} +\LoadCommon{10}% -"- +\LoadCommon{11}% -"- + +\section[Abgrenzung]{Abgrenzung\protect\OnlyAt{\Class{scrbook}}} +\label{sec:maincls.separation} + +Bei Büchern gibt es teilweise die Grobauf"|teilung in +\emph{Vorspann}\Index{Vorspann}, \emph{Hauptteil}\Index{Hauptteil} und +\emph{Nachspann}\Index{Nachspann}. Auch \KOMAScript{} bietet für +\Class{scrbook} diese Möglichkeit. + + +\begin{Declaration} + \Macro{frontmatter}\\ + \Macro{mainmatter}\\ + \Macro{backmatter} +\end{Declaration}% +\BeginIndex{Cmd}{frontmatter}% +\BeginIndex{Cmd}{mainmatter}% +\BeginIndex{Cmd}{backmatter}% +Mit \Macro{frontmatter} wird der Vorspann eingeleitet. Im Vorspann werden die +nummerierten Seiten mit römischen Seitenzahlen versehen. Kapitelüberschriften +sind im Vorspann nicht nummeriert. Abschnittsüberschriften wären jedoch +nummeriert, gingen von Kapitelnummer 0 aus und wären außerdem über +Kapitelgrenzen hinweg durchgehend nummeriert. Dies spielt jedoch keine Rolle, +da der Vorspann allenfalls für die Titelei, das +Inhalts-\Index{Inhaltsverzeichnis}, Abbildungs-\Index{Abbildungen>Verzeichnis + der} und Tabellenverzeichnis\Index{Tabellen>Verzeichnis der} und ein +Vorwort\Index{Vorwort} verwendet wird. Das Vorwort kann also als normales +Kapitel gesetzt werden. Ein Vorwort sollte niemals in Abschnitte unterteilt, +sondern möglichst kurz gefasst werden. Im Vorwort wird also keine tiefere +Gliederungsebene als Kapitel benötigt. + +Für den Fall, dass der Anwender dies anders sieht und nummerierte +Abschnitte\Index{Abschnitt>Nummer} in den Kapiteln des Vorspanns haben will, +enthält ab Version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}} die Nummerierung +der Abschnitte keine Kapitelnummer. Diese Änderung gibt es nur, wenn eine +Kompatibilität ab Version~2.97e eingestellt ist (siehe Option +\Option{version}, \autoref{sec:maincls.compatibilityOptions}, +\autopageref{desc:maincls.option.version}). Es wird ausdrücklich darauf +hingewiesen, dass dadurch bezüglich der Nummern eine Verwechslung mit +Kapitelnummern gegeben ist! Die Verwendung von \Macro{addsec} und +\Macro{section*} (siehe \autoref{sec:maincls.structure}, +\autopageref{desc:maincls.cmd.section*} und +\autopageref{desc:maincls.cmd.addsec}) sind aus Sicht des Autors im Vorspann +deshalb unbedingt vorzuziehen! + +Ab Version~2.97e\ChangedAt{v2.97e}{\Class{scrbook}} enthalten auch die Nummern +für Gleitumgebungen wie Tabellen\Index{Tabellen>Nummern} und +Abbildungen\Index{Abbildungen>Nummern} und die +Gleichungsnummern\Index{Gleichungen>Nummern} im Vorspann keinen +Kapitelanteil. Auch dies erfordert eine entsprechende +Kompatibilitätseinstellung (siehe Option \Option{version}, +\autoref{sec:maincls.compatibilityOptions}, +\autopageref{desc:maincls.option.version}). + +\looseness=-1 +Mit \Macro{mainmatter} wird der Hauptteil eingeleitet. Existiert kein +Vorspann, so kann diese Anweisung auch entfallen. Im Hauptteil sind arabische +Seitenzahlen voreingestellt. Die Seitenzählung beginnt im Hauptteil neu mit +der 1. + +Mit \Macro{backmatter} wird der Nachspann eingeleitet. Was zum Nachspann +gehört, ist unterschiedlich. Manchmal wird im Nachspann nur das +Literaturverzeichnis\Index{Literaturverzeichnis}, manchmal nur das +Stichwortverzeichnis\Index{Stichwortverzeichnis} gesetzt. Manchmal erscheint +der gesamte Anhang im Nachspann. Der Nachspann gleicht bezüglich der +Gliederungsüberschriften dem Vorspann. Eine getrennte Seitennummerierung ist +jedoch nicht vorgesehen. Falls Sie dies ebenfalls benötigen, bedienen Sie sich +bitte der Anweisung \Macro{pagenumbering} aus \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.pagenumbering}.% +% +\EndIndex{Cmd}{frontmatter}% +\EndIndex{Cmd}{mainmatter}% +\EndIndex{Cmd}{backmatter}% + + +\section{Gliederung} +\label{sec:maincls.structure}% +\BeginIndex{}{Gliederung} + +Unter der Gliederung versteht man die Einteilung eines Dokuments in +Teile, Kapitel, Abschnitte und weitere Gliederungsebenen. + + +\begin{Declaration} + \KOption{open}\PName{Methode} +\end{Declaration}% +\BeginIndex{Option}{open~=\PName{Methode}}% +\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% +Bei den \KOMAScript-Klassen \Class{scrbook} und \Class{scrreprt} kann gewählt +werden, wo im doppelseitigen Satz neue Kapitel beginnen. In der Voreinstellung +beginnen bei \Class{scrreprt} neue Kapitel\Index{Kapitel>Anfang} auf der +nächsten neuen Seite. Dies entspricht der \PName{Methode} +\PValue{any}. Demgegenüber beginnen bei \Class{scrbook} neue Kapitel auf der +nächsten rechten Seite. Dies entspricht der \PName{Methode} \PValue{right} und +ist bei den meisten Büchern üblich. In einigen Fällen sollen neue Kapitel +jedoch auf der linken Seite einer kompletten Doppelseite beginnen. Dies +entspricht der \PName{Methode} +\PValue{left}\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}}. Eine +Zusammenfassung der möglichen Werte findet sich noch einmal in +\autoref{tab:maincls.open}. + +\begin{table} + \caption[{Mögliche Werte für Option \Option{open}}]{Mögliche Werte für + Option \Option{open} zur Auswahl von Umbrüchen mit Vakatseiten} + \begin{desctabular} + \pventry{any}{Die Anweisungen + \Macro{cleardoublepage}, \Macro{cleardoubleplainpage}, + \Macro{cleardoubleemptypage}, \Macro{cleardoublepageusingstyle} und + \Macro{cleardoublestandardpage} erzeugen einen Seitenumbruch und + entsprechen damit \Macro{clearpage}.\IndexOption{open~=any}}% + \pventry{left}{Die Anweisungen + \Macro{cleardoublepage}, \Macro{cleardoubleplainpage}, + \Macro{cleardoubleemptypage}, \Macro{cleardoublepageusingstyle} und + \Macro{cleardoublestandardpage} erzeugen einen Seitenumbruch und fügen + ggf. eine Vakatseite\Index{Vakatseite} ein, um im doppelseitigen + Satz auf die nächste linke Seite zu gelangen.\IndexOption{open~=left}}% + \pventry{right}{Die Anweisungen + \Macro{cleardoublepage}, \Macro{cleardoubleplainpage}, + \Macro{cleardoubleemptypage}, \Macro{cleardoublepageusingstyle} und + \Macro{cleardoublestandardpage} erzeugen einen Seitenumbruch und fügen + ggf. eine Vakatseite ein, um im doppelseitigen Satz auf die nächste + rechte Seite zu gelangen.\IndexOption{open~=right}}% + \end{desctabular} + \label{tab:maincls.open} +\end{table} + +Neben den Kapitelanfängen wirkt sich die Option auch auf die explizite +Verwendung der Anweisung\Macro{cleardoublepage} ebenso wie auf die +Umbruch\-anweisungen \Macro{cleardoublepageusingstyle}, +\Macro{cleardoublestandardpage}, \Macro{cleardoubleplainpage} und +\Macro{cleardoubleemptypage} aus. Siehe dazu \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.cleardoublepage}. Da im einseitigen Satz nicht +zwischen linken und rechten Seiten unterschieden wird, hat die Option dort +keine Wirkung. + +Bei der Klasse \Class{scrartcl} ist die oberste Gliederungsebene unter dem +Teil der Abschnitt. Daher unterstützt \Class{scrartcl} diese Option nicht.% +% +\EndIndex{Option}{open~=\PName{Methode}} + + +\begin{Declaration} + \KOption{chapterprefix}\PName{Ein-Aus-Wert}\\ + \KOption{appendixprefix}\PName{Ein-Aus-Wert} +\end{Declaration}% +\BeginIndex{Option}{chapterprefix~=\PName{Ein-Aus-Wert}}% +\BeginIndex{Option}{appendixprefix~=\PName{Ein-Aus-Wert}}% +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 +in einer Zeile »Kapitel«\footnote{Bei Verwendung einer anderen Sprache als + Deutsch wird »Kapitel« selbstverständlich in der jeweiligen Sprache + gesetzt.} % +gefolgt von der Kapitelnummer steht. Erst ab der nächsten Zeile wird dann die +Überschrift in linksbündigem Flattersatz ausgegeben. Bei {\KOMAScript} kann +dieses Verhalten mit der Klassenoption \Option{chapterprefix} ebenfalls +erreicht werden. Als \PName{Ein-Aus-Wert} kann einer der Standardwerte für +einfache Schalter aus \autoref{tab:truefalseswitch}, +\autopageref{tab:truefalseswitch} verwendet werden. Voreingestellt ist das +Verhalten \OptionValue{chapterprefix}{false}, während das Verhalten der +Standardklassen \OptionValue{chapterprefix}{true} entspricht. Die Optionen +wirken sich außerdem auf das Aussehen der automatischen Kolumnentitel für +Kapitel aus (siehe \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.pagestyle.headings}). + +Zuweilen kommt es vor, dass man die Kapitelüberschriften im Hauptteil durchaus +in der einfachen Form von \OptionValue{chapterprefix}{false} setzen +möchte. Gleichzeitig sollen die Überschriften im Anhang\Index{Anhang} jedoch +davon abweichend mit einer Präfixzeile, »Anhang« gefolgt vom Buchstaben des +Anhangs, versehen werden. Dies ist mit \Option{appendixprefix} möglich. Da +sich jedoch dadurch ein inkonsistentes Layout ergibt, rate ich von der +Verwendung ab.% +% +\EndIndex{Option}{appendixprefix~=\PName{Ein-Aus-Wert}}% +\EndIndex{Option}{chapterprefix~=\PName{Ein-Aus-Wert}}% + + +\begin{Declaration} + \KOption{headings}\PName{Einstellung} +\end{Declaration} +\BeginIndex{Option}{headings~=\PName{Einstellung}}% +Die Überschriften\index{Ueberschriften=Überschriften} werden sowohl bei den +Standardklassen als auch bei {\KOMAScript} normalerweise recht groß +gesetzt. Dies gefällt nicht jedem und wirkt insbesondere bei kleinen +Papiergrößen oft störend. Daher stehen bei {\KOMAScript} neben den mit der +Option \OptionValue{headings}{big}\IndexOption{headings~=big}% +\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +standardmäßig sehr groß voreingestellen Überschriften die beiden Möglichkeiten +\OptionValue{headings}{normal}\IndexOption{headings~=normal} und +\OptionValue{headings}{small}\IndexOption{headings~=small} zur Verfügung, mit +denen man insgesamt kleinere Überschriften erhält. Die aus den Optionen +resultierenden Schriftgrößen sind für die Überschriften der Klassen +\Class{scrbook} und \Class{scrreprt} +\autoref{tab:maincls.structureElementsFont}, +\autopageref{tab:maincls.structureElementsFont} zu entnehmen. Bei +\Class{scrartcl} werden generell etwas kleinere Überschriften verwendet. +\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Die Abstände vor und nach +Kapitelüberschriften werden von diesen Optionen ebenfalls beeinflusst. + +\iftrue Auf Kapitelüberschriften wirkt sich außerdem die Option +\Option{headings} mit den Einstellungen \PValue{twolinechapter} oder +\PValue{onelinechapter} aus, die den oben erklärten Optionen +\OptionValue{chapterprefix}{true} und \OptionValue{chapterprefix}{false} +entsprechen. Im Anhang gibt es zusätzlich Auswirkungen durch die +Einstellungen \PValue{onelineappendix} und \PValue{twolineappendix} für Option +\Option{headings}, was dann \OptionValue{appendixprefix}{false} und +\OptionValue{appendixprefix}{true} entspricht (siehe ebenfalls oben). \else +Auf Kapitelüberschriften wirken sich zudem +\OptionValue{headings}{twolinechapter} und +\OptionValue{headings}{onelinechapter}, was den Optionen +\OptionValue{chapterprefix}{true} und \OptionValue{chapterprefix}{false} +entspricht (siehe oben), sowie entsprechend im Anhang +\OptionValue{headings}{twolineappendix} und +\OptionValue{headings}{onelineappendix} aus, was den Optionen +\OptionValue{appendixprefix}{true} und \OptionValue{appendixprefix}{false} +entspricht (siehe ebenfalls oben). \fi + +\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Für Kapitel kann außerdem mit +\OptionValue{headings}{openany}, \OptionValue{headings}{openright} und +\OptionValue{headings}{openleft} die Methode für Kapitelanfänge alternativ zur +Verwendung der Option \Option{open} mit den Werten \PValue{any}, +\PValue{right} und \PValue{left} (siehe oben) gesetzt werden. + +Eine Zusammenfassung der möglichen Einstellungen für Option +\Option{headings} finden Sie in \autoref{tab:maincls.headings}. + +\begin{desctable} + \caption[{Mögliche Werte für Option \Option{headings}}]{Mögliche Werte für + Option \Option{headings} zur Einstellung der Überschriften% + \label{tab:maincls.headings}}\\ + \Endfirsthead + \caption[]{Mögliche Werte für Option \Option{headings} + (\emph{Fortsetzung})}\\ + \Endhead% + \standardfoot% + \pventry{big}{% + Verwende große Überschriften mit großen Abständen darüber und darunter.% + \IndexOption{headings~=big}}% + \pventry{normal}{% + Verwende mittelgroße Überschriften mit mittelgroßen Abständen darüber und + darunter.% + \IndexOption{headings~=normal}}% + \entry{\PValue{onelineappendix}, \PValue{noappendixprefix}, + \PValue{appendixwithoutprefix}, \PValue{appendixwithoutprefixline}% + \IndexOption{headings~=onelineappendix}}{% + Kapitelüberschriften im Anhang werden wie andere Überschriften auch + gesetzt.}% + \entry{\PValue{onelinechapter}, \PValue{nochapterprefix}, + \PValue{chapterwithoutprefix}, \PValue{chapterwithoutprefixline}% + \IndexOption{headings~=onelinechapter}}{% + Kapitelüberschriften werden wie andere Überschriften auch gesetzt.}% + \pventry{openany}{% + Teile, Kapitel, Index und Nachspann verwenden \Macro{clearpage}, aber nicht + \Macro{cleardoublepage}.% + \IndexOption{headings~=openany}}% + \pventry{openleft}{% + Die Anweisungen \Macro{cleardoublepage}\IndexCmd{cleardoublepage}, + \Macro{cleardoubleplainpage}\IndexCmd{cleardoubleplainpage}, + \Macro{cleardoubleemptypage}\IndexCmd{cleardoubleemptypage}, + \Macro{cleardoublepageusingstyle}\IndexCmd{cleardoublepageusingstyle} und + \Macro{cleardoublestandardpage}\IndexCmd{cleardoublestandardpage} erzeugen + einen Seitenumbruch und fügen ggf. eine Vakatseite\Index{Vakatseite} ein, + um im doppelseitigen Satz auf die nächste linke Seite zu gelangen. Teile, + Kapitel, Index und Nachspann verwenden \Macro{cleardoublepage}.% + \IndexOption{headings~=openleft}}% + \pventry{openright}{% + Die Anweisungen \Macro{cleardoublepage}\IndexCmd{cleardoublepage}, + \Macro{cleardoubleplainpage}\IndexCmd{cleardoubleplainpage}, + \Macro{cleardoubleemptypage}\IndexCmd{cleardoubleemptypage}, + \Macro{cleardoublepageusingstyle}\IndexCmd{cleardoublepageusingstyle} und + \Macro{cleardoublestandardpage}\IndexCmd{cleardoublestandardpage} erzeugen + einen Seitenumbruch und fügen ggf. eine Vakatseite\Index{Vakatseite} ein, + um im doppelseitigen Satz auf die nächste rechte Seite zu gelangen. Teile, + Kapitel, Index und Nachspann verwenden \Macro{cleardoublepage}.% + \IndexOption{headings~=openright}}% + \pventry{small}{% + Verwende kleine Überschriften mit kleinen Abständen darüber und darunter.% + \IndexOption{headings~=small}}% + \entry{\PValue{twolineappendix}, \PValue{appendixprefix}, + \PValue{appendixwithprefix}, \PValue{appendixwithprefixline}% + \IndexOption{headings~=twolineappendix}}{% + Kapitelüberschriften im Anhang werden mit einer Vorsatzzeile gesetzt, + deren Inhalt von \Macro{chapterformat}\IndexCmd{chapterformat} bestimmt + wird.}% + \entry{\PValue{twolinechapter}, \PValue{chapterprefix}, + \PValue{chapterwithprefix}, \PValue{chapterwithprefixline}% + \IndexOption{headings~=twolinechapter}}{% + Kapitelüberschriften werden mit einer Vorsatzzeile gesetzt, deren Inhalt + von \Macro{chapterformat}\IndexCmd{chapterformat} bestimmt wird.}% +\end{desctable} +% +\EndIndex{Option}{headings~=\PName{Einstellung}}% + + +\begin{Declaration} + \KOption{numbers}\PName{Einstellung} +\end{Declaration}% +\BeginIndex{Option}{numbers~=\PName{Einstellung}}% +Nach {\small DUDEN} steht in Gliederungen\Index{Gliederung}, in denen +ausschließlich arabische Ziffern für die Nummerierung\Index{Nummerierung} +verwendet werden, am Ende der Gliederungsnummern kein abschließender Punkt +(siehe \cite[R\,3]{DUDEN}). Wird hingegen innerhalb der Gliederung auch mit +römischen Zahlen oder Groß- oder Kleinbuchstaben gearbeitet, so steht am Ende +aller Gliederungsnummern ein abschließender Punkt (siehe +\cite[R\,4]{DUDEN}). In {\KOMAScript} ist ein Automatismus eingebaut, der +diese etwas komplexe Regel zu erfüllen versucht. Der Automatismus wirkt sich +so aus, dass normalerweise bei Verwendung des Gliederungsbefehls \Macro{part} +oder eines Anhangs (\Macro{appendix}) auf Gliederungsnummer mit abschließendem +Punkt umgeschaltet wird. Diese Information wird in der \File{aux}-Datei +gespeichert und wirkt sich dann beim nächsten \LaTeX-Lauf auf das gesamte +Dokument aus. + +Manchmal versagt der mit +\OptionValue{numbers}{autoendperiod}\IndexOption{numbers~=autoendperiod} +voreingestellte Automatismus zum Setzen oder Weglassen des abschließenden +Punktes in der Gliederungsnummer oder andere Sprachen sehen andere Regeln +vor. Deshalb ist es mit der Einstellung +\OptionValue{numbers}{endperiod}\IndexOption{numbers~=endperiod} möglich, den +Punkt manuell vorzuschreiben oder mit \OptionValue{numbers}{noendperiod} zu +verbieten. + +Es ist zu beachten, dass der Automatismus immer erst für den nächsten +\LaTeX-Lauf die Verwendung des abschließenden Punktes ein- oder +ausschaltet. Bevor also versucht wird, die korrekte Darstellung über +Verwendung einer der Optionen zu erzwingen, sollte grundsätzlich ein +weiterer \LaTeX-Lauf ohne Dokumentänderung durchgeführt werden. + +Ein Zusammenfassung der möglichen Werte für die \PName{Einstellung} von +\PName{numbers} bietet \autoref{tab:maincls.numbers}. Im Unterschied zu den +meisten anderen Einstellungen, kann diese Option nur in der Dokumentpräambel, +also vor \Macro{begin}\PParameter{document} vorgenommen werden. + +\begin{table} + \caption[{Mögliche Werte für Option \Option{numbers}}]{Mögliche Werte für + Option \Option{numbers} zur Auswahl des Abschlusspunkts in + Gliederungsnummern} + \label{tab:maincls.numbers} + \begin{desctabular} + \entry{\PValue{autoendperiod}, \PValue{autoenddot}, \PValue{auto}}{% + \KOMAScript{} trifft die Entscheidung, ob am Ende von Gliederungsnummern + und allen von Gliederungsnummern abhängigen Nummern ein Punkt gesetzt + wird, selbst. Kommen in sämtlichen Gliederungsnummern nur arabische + Ziffern vor, so wird kein Punkt gesetzt. Wird in einer Gliederungsnummer + ein Buchstabe oder eine römische Zahl entdeckt, so wird der Punkt bei + allen Nummern gesetzt. Referenzen auf diese Nummern werden jedoch ohne + abschließenden Punkt gesetzt.% + \IndexOption{numbers~=autoendperiod}}% + \entry{\PValue{endperiod}, \PValue{withendperiod}, \PValue{periodatend}, + \PValue{enddot}, \PValue{withenddot}, \PValue{dotatend}}{% + Bei sämtlichen Gliederungsnummern und davon abhängigen Nummern wird am + Ende ein Punkt gesetzt, der bei der Referenzierung entfällt.% + \IndexOption{numbers~=endperiod}}% + \entry{\PValue{noendperiod}, \PValue{noperiodatend}, + \PValue{noenddot}, \PValue{nodotatend}}{% + Gliederungsnummern und davon abhängige Nummern werden ohne + abschließenden Punkt gesetzt.% + \IndexOption{numbers~=noendperiod}}% + \end{desctabular} +\end{table} +% +\EndIndex{Option}{numbers~=\PName{Einstellung}}% + + +\begin{Declaration} + \Option{chapteratlists}\\ + \XOption{chapteratlists}=\PName{Wert} +\end{Declaration}% +\BeginIndex{Option}{chapteratlists}% +\BeginIndex{Option}{chapteratlists~=\PName{Wert}}% +\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% +Wie auch bei der Option \Option{listof} in \autoref{sec:maincls.floats}, +\autopageref{desc:maincls.option.listof} erwähnt wird, fügt +normalerweise\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}} jeder +mit \Macro{chapter} erzeugte Kapiteleintrag einen vertikalen Abstand in die +Verzeichnisse der Gleitumgebungen ein. Seit Version~2.96a gilt dies auch für +die Anweisung \Macro{addchap}, wenn nicht eine Kompatibilitätseinstellung zu +einer früheren Version gewählt wurde (siehe Option \Option{version} in +\autoref{sec:maincls.compatibilityOptions}, +\autopageref{desc:maincls.option.version}). + +Außerdem kann mit der Option \Option{chapteratlists} der Abstand verändert +werden. Dazu gibt man als \PName{Wert} den gewünschten Abstand an. Bei der +Voreinstellung +\OptionValue{listof}{chaptergapsmall}\IndexOption{listof~=chaptergapsmall} +sind dies 10\Unit{pt}. Mit der Einstellung \OptionValue{chapteratlists}{entry} +oder bei Verwendung der Form \Option{chapteratlists} ohne Angabe eines Wertes +wird statt des Abstandes der Kapiteleintrag selbst in die Verzeichnisse +eingetragen. Es wird darauf hingewiesen, dass ein solcher Eintrag auch dann +erfolgt, wenn das Kapitel keine Gleitumgebung enthält. + +Es ist zu beachten, dass sich eine Änderung der Einstellung je nach Art der +Änderung erst nach zwei weiteren \LaTeX-Läufen im Verzeichnis auswirkt.% +% +\EndIndex{Option}{chapteratlists~=\PName{Wert}}% +\EndIndex{Option}{chapteratlists}% + + +\begin{Declaration} + \Macro{part}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{chapter}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{section}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{subsection}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{subsubsection}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{paragraph}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{subparagraph}\OParameter{Kurzform}\Parameter{Überschrift} +\end{Declaration}% +\BeginIndex{Cmd}{part}\Index[indexmain]{Teil}% +\BeginIndex{Cmd}{chapter}\Index[indexmain]{Kapitel}% +\BeginIndex{Cmd}{section}\Index[indexmain]{Abschnitt}% +\BeginIndex{Cmd}{subsection}% +\BeginIndex{Cmd}{subsubsection}% +\BeginIndex{Cmd}{paragraph}% +\BeginIndex{Cmd}{subparagraph}% +Die Standardgliederungsbefehle funktionieren bei {\KOMAScript} beinahe genau +wie bei den Standardklassen. So kann ganz normal über ein optionales Argument +ein abweichender Text für den Kolumnentitel und das Inhaltsverzeichnis +vorgegeben werden. + +Die Überschrift der Teile-Ebene (\Macro{part}) unterscheidet sich von den +anderen Gliederungsebenen dadurch, dass sie unabhängig von den übrigen Ebenen +nummeriert wird. Das bedeutet, dass die Kapitel-Ebene (bei \Class{scrbook} +oder \Class{scrreprt}) bzw. die Abschnitt-Ebene (bei \Class{scrartcl}) über +alle Teile hinweg durchgehend nummeriert wird. Des Weiteren steht bei den +Klassen \Class{scrbook} und \Class{scrreprt} die Überschrift dieser Ebene +zusammen mit ihrer Präambel (siehe \Macro{setpartpreamble}, +\autopageref{desc:maincls.cmd.setpartpreamble}) alleine auf einer Seite. + +\Macro{chapter}\OnlyAt{\Class{scrartcl}} existiert nur bei Buch- und +Berichtklassen, also bei \Class{book}, \Class{scrbook}, \Class{report} und +\Class{scrreport}, nicht jedoch bei den Artikelklassen \Class{article} und +\Class{scrartcl}. \Macro{chapter} unterscheidet sich bei {\KOMAScript} +außerdem gravierend von der Version der Standardklassen. Bei den +Standardklassen wird die Kapitelnummer mit dem Präfix »Kapitel« +beziehungsweise dem Kapitelnamen in der gewählten Sprache in einer Zeile vor +dem eigentlichen Text der Überschrift ausgegeben. Diese sehr mächtige Form +wird bei {\KOMAScript} durch eine einfache Nummer vor dem Text abgelöst, lässt +sich aber durch die Optionen \Option{chapterprefix} und +\Option{appendixprefix} einstellen (siehe +\autopageref{desc:maincls.option.chapterprefix}). + +Bitte beachten Sie, dass \Macro{part} und \Macro{chapter} bei \Class{scrbook} +und \Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} den +Seitenstil für eine Seite umschaltet. Der jeweilige Seitenstil ist bei +\KOMAScript{} in den Makros \Macro{partpagestyle} und \Macro{chapterpagestyle} +abgelegt (siehe \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.titlepagestyle}). + +\BeginIndex[indexother]{}{Schriftart}% +\BeginIndex[indexother]{}{Schriftgroesse=Schriftgröße}% +Die Schriftart aller sieben Gliederungsebenen\ChangedAt{v2.8p}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} % +kann mit den Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe +\autoref{sec:maincls.textmarkup}, +\autopageref{desc:maincls.cmd.setkomafont}) bestimmt werden. Dabei wird +zunächst generell das Element +\FontElement{disposition}\IndexFontElement{disposition} und anschließend +zusätzlich je Gliederungsebene ein spezifisches Element verwendet (siehe +\autoref{tab:maincls.elementsWithoutText}, +\autopageref{tab:maincls.elementsWithoutText}). Die Schriftart für das Element +\FontElement{disposition}\IndexFontElement{disposition} ist als +\Macro{normalcolor}""\Macro{sffamily}""\Macro{bfseries} vordefiniert. Die +Voreinstellungen für die spezifischen Elemente sind mit einer Schriftgröße +vorbelegt und daher von den Einstellungen \PValue{big}, \PValue{normal} und +\PValue{small} für die Option \Option{headings}\IndexOption{headings} abhängig +(siehe \autopageref{desc:maincls.option.headings}). Sie finden die +Voreinstellungen in \autoref{tab:maincls.structureElementsFont}. + +\begin{Example} + Angenommen, Sie verwenden die Klassenoption \OptionValue{headings}{big} und + stellen fest, dass die sehr großen Überschriften von Teildokumenten zu fett + wirken. Nun könnten Sie natürlich wie folgt verfahren: +\begin{lstcode} + \setkomafont{disposition}{\normalcolor\sffamily} + \part{\appendixname} + \addtokomafont{disposition}{\bfseries} +\end{lstcode} + \looseness=-1 % Umbruchkorrektur + Auf diese Weise würden Sie nur für die eine Überschrift »Anhang« + das Schriftattribut \textbf{Fett} abschalten. Sehr viel komfortabler + und eleganter ist es aber, stattdessen generell für + \Macro{part}-Überschriften eine entsprechende Änderung vorzunehmen. + Das ist wahlweise mit: +\begin{lstcode} + \addtokomafont{part}{\normalfont\sffamily} + \addtokomafont{partnumber}{\normalfont\sffamily} +\end{lstcode} + oder einfach mit: +\begin{lstcode} + \addtokomafont{part}{\mdseries} + \addtokomafont{partnumber}{\mdseries} +\end{lstcode} + möglich. Die Verwendung von \Macro{setkomafont} wäre zwar grundsätzlich + möglich, müsste aber auch die Auswahl der Schriftgröße enthalten und würde + damit die Größenänderung über die Option \Option{headings} verhindern. + + Die zweite Version mit \Macro{mdseries} ist vorzuziehen, da diese auch dann + noch zum gewünschten Ergebnis führt, wenn Sie später das Element + \FontElement{disposition}\IndexFontElement{disposition} wie folgt ändern: +\begin{lstcode} + \setkomafont{disposition}{\normalcolor\bfseries} +\end{lstcode} + Mit dieser Änderung verzichten Sie darauf, für alle + Gliederungsebenen serifenlose Schrift voreinzustellen. +\end{Example} + +% Umbruchkorrektur: Tabelle verschoben +\begin{table} + \centering% + \caption[{Schriftvoreinstellungen für die Elemente der Gliederung + bei\newline \Class{scrbook} und \Class{scrreprt}}]{Schriftvoreinstellungen + für die Elemente der Gliederung bei \Class{scrbook} und \Class{scrreprt}} + \begin{tabular}{lll} + \toprule + Klassenoption & Element & Voreinstellung \\ + \midrule + \OptionValue{headings}{big} + & \FontElement{part}\IndexFontElement{part} + & \Macro{Huge} \\ + & \FontElement{partnumber}\IndexFontElement{partnumber} + & \Macro{huge} \\ + & \FontElement{chapter}\IndexFontElement{chapter} + & \Macro{huge} \\ + & \FontElement{section}\IndexFontElement{section} + & \Macro{Large} \\ + & \FontElement{subsection}\IndexFontElement{subsection} + & \Macro{large} \\ + & \FontElement{subsubsection}\IndexFontElement{subsubsection} + & \Macro{normalsize} \\ + & \FontElement{paragraph}\IndexFontElement{paragraph=} + & \Macro{normalsize} \\ + & \FontElement{subparagraph}\IndexFontElement{subparagraph} + & \Macro{normalsize} \\[1ex] + \OptionValue{headings}{normal} + & \FontElement{part} & \Macro{huge} \\ + & \FontElement{partnumber} & \Macro{huge} \\ + & \FontElement{chapter} & \Macro{LARGE} \\ + & \FontElement{section} & \Macro{Large} \\ + & \FontElement{subsection} & \Macro{large} \\ + & \FontElement{subsubsection} & \Macro{normalsize} \\ + & \FontElement{paragraph} & \Macro{normalsize} \\ + & \FontElement{subparagraph} & \Macro{normalsize} \\[1ex] + \OptionValue{headings}{small} + & \FontElement{part} & \Macro{LARGE} \\ + & \FontElement{partnumber} & \Macro{LARGE} \\ + & \FontElement{chapter} & \Macro{Large} \\ + & \FontElement{section} & \Macro{large} \\ + & \FontElement{subsection} & \Macro{normalsize} \\ + & \FontElement{subsubsection} & \Macro{normalsize} \\ + & \FontElement{paragraph} & \Macro{normalsize} \\ + & \FontElement{subparagraph} & \Macro{normalsize} \\ + \bottomrule + \end{tabular} + \label{tab:maincls.structureElementsFont} +\end{table} + +Ich möchte Sie eindringlich davor warnen, die Möglichkeit zur +Schriftumschaltung zu missbrauchen, um wild Schriften, Schriftgrößen und +Schriftattribute miteinander zu mischen. Die Auswahl der richtigen Schrift für +die richtige Aufgabe ist eine Sache für Experten und hat sehr, sehr wenig mit +dem persönlichem Geschmack eines Laien zu tun. Siehe hierzu auch das Zitat am +Ende von \autoref{sec:typearea.tips}, \autopageref{sec:typearea.tips.cite} und +die folgende Erklärung. + +\begin{Explain} + Unterschiedliche Schriften für unterschiedliche Gliederungsebenen sind mit + {\KOMAScript}-Mitteln möglich. Der Laie sollte sie aber meiden wie der + Teufel das Weihwasser. Dies hat typografische Gründe. + + Eine Regel der Typografie besagt, dass man möglichst wenig Schriften + miteinander mischen soll. Serifenlose für die Überschriften scheinen bereits + ein Verstoß gegen diese Regel zu sein. Allerdings muss man wissen, dass + fette, große, serifenbehaftete Buchstaben oft viel zu mächtig für eine + Überschrift sind. Man müsste dann strenggenommen zumindest auf eine normale + statt eine fette oder halbfette Schrift ausweichen. In tiefen + Gliederungsebenen kann das aber wieder zu schwach sein. Andererseits haben + Serifenlose in Überschriften eine sehr angenehme Wirkung und fast nur für + Überschriften eine Berechtigung. Daher wurde diese Voreinstellung für + {\KOMAScript} mit gutem Grund gewählt. + + Größere Vielfalt sollte aber vermieden werden. Schriftenmischung ist etwas + für Profis. Aus den genannten Gründen sollten Sie bei Verwendung anderer als + der Standard-\TeX-Fonts -- egal ob CM"~\Index{CM-Fonts}, + EC"~\Index{EC-Fonts} oder LM-Fonts\Index{LM-Fonts} -- bezüglich der + Verträglichkeit der serifenlosen und serifenbehafteten Schrift einen + Experten zu Rate ziehen oder die Schrift für das Element + \FontElement{disposition}\IndexFontElement{disposition} vorsichtshalber wie + in obigem Beispiel umdefinieren. Die häufig anzutreffenden Kombinationen + Times mit Helvetica oder Palatino mit Helvetica werden vom Autor als + ungünstig betrachtet. +\end{Explain} +\EndIndex[indexother]{}{Schriftart}% +\EndIndex[indexother]{}{Schriftgroesse=Schriftgröße}% +% +\EndIndex{Cmd}{part}% +\EndIndex{Cmd}{chapter}% +\EndIndex{Cmd}{section}% +\EndIndex{Cmd}{subsection}% +\EndIndex{Cmd}{subsubsection}% +\EndIndex{Cmd}{paragraph}% +\EndIndex{Cmd}{subparagraph}% + + +\begin{Declaration} + \Macro{part*}\Parameter{Überschrift}\\ + \Macro{chapter*}\Parameter{Überschrift}\\ + \Macro{section*}\Parameter{Überschrift}\\ + \Macro{subsection*}\Parameter{Überschrift}\\ + \Macro{subsubsection*}\Parameter{Überschrift}\\ + \Macro{paragraph*}\Parameter{Überschrift}\\ + \Macro{subparagraph*}\Parameter{Überschrift} +\end{Declaration}% +\BeginIndex{Cmd}{part*}% +\BeginIndex{Cmd}{chapter*}% +\BeginIndex{Cmd}{section*}% +\BeginIndex{Cmd}{subsection*}% +\BeginIndex{Cmd}{subsubsection*}% +\BeginIndex{Cmd}{paragraph*}% +\BeginIndex{Cmd}{subparagraph*}% +Bei den Sternvarianten der Gliederungsbefehle erfolgt keine +Nummerierung\Index{Nummerierung}, wird kein +Kolumnentitel\Index{Kolumnentitel>automatisch} gesetzt und kein Eintrag im +Inhaltsverzeichnis\Index{Inhaltsverzeichnis} vorgenommen. Der Verzicht auf +den Kolumnentitel hat übrigens einen oftmals unerwünschten Effekt. Geht +beispielsweise ein mit \Macro{chapter*} gesetztes Kapitel über mehrere Seiten, +so taucht plötzlich der Kolumnentitel des letzen Kapitels wieder auf. +{\KOMAScript} bietet dafür aber eine Lösung, die im Folgenden beschrieben +wird. \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}\Macro{chapter*} existiert +selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{book}, +\Class{scrbook}, \Class{report} und \Class{scrreport}, nicht jedoch bei den +Artikelklassen \Class{article} und \Class{scrartcl}. + +Bitte beachten Sie, dass \Macro{part*} und \Macro{chapter*} den Seitenstil für +eine Seite umschalten. Während die Standardklassen dabei fest den Seitenstil +\Pagestyle{plain} verwenden, ist bei \KOMAScript{} der zu verwendende +Seitenstil in den Makros \Macro{partpagestyle} und \Macro{chapterpagestyle} +abgelegt (siehe \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.titlepagestyle}). + +Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} % +gilt das Gleiche wie zuvor in der Erklärung zu den sternlosen +Varianten geschrieben. Die Elemente tragen die gleichen Namen, da sie +nicht Varianten, sondern Gliederungsebenen bezeichnen.% +% +\EndIndex{Cmd}{part*}% +\EndIndex{Cmd}{chapter*}% +\EndIndex{Cmd}{section*}% +\EndIndex{Cmd}{subsection*}% +\EndIndex{Cmd}{subsubsection*}% +\EndIndex{Cmd}{paragraph*}% +\EndIndex{Cmd}{subparagraph*}% + +\iftrue% Umbruchkorrekturtext +Bei den Standardklassen gibt es keine weiteren Gliederungsbefehle. Es +existieren also insbesondere keine Anweisungen, mit denen man nicht +nummerierte Kapitel oder nicht nummerierte Abschnitte erzeugen kann, +die ins Inhaltsverzeichnis aufgenommen werden und bei denen ein +automatischer Kolumnentitel erzeugt wird. +\fi + + +\begin{Declaration} + \Macro{addpart}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{addpart*}\Parameter{Überschrift}\\ + \Macro{addchap}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{addchap*}\Parameter{Überschrift}\\ + \Macro{addsec}\OParameter{Kurzform}\Parameter{Überschrift}\\ + \Macro{addsec*}\Parameter{Überschrift} +\end{Declaration}% +\BeginIndex{Cmd}{addpart}% +\BeginIndex{Cmd}{addpart*}% +\BeginIndex{Cmd}{addchap}% +\BeginIndex{Cmd}{addchap*}% +\BeginIndex{Cmd}{addsec}% +\BeginIndex{Cmd}{addsec*}% +{\KOMAScript} bietet über die Gliederungsbefehle der Standardklassen hinaus +die Anweisungen \Macro{addpart}, \Macro{addchap} und \Macro{addsec}. Diese +ähneln bis auf die fehlende Nummerierung sehr den Standardanweisungen +\Macro{part}, \Macro{chapter} und \Macro{section}. Sie erzeugen also sowohl +einen automatischen Kolumnentitel als auch einen Eintrag im +Inhaltsverzeichnis. + +Die Sternvarianten \Macro{addchap*} und \Macro{addsec*} gleichen hingegen den +Standardanweisungen \Macro{chapter*} und \Macro{section*} mit einem winzigen, +aber wichtigen Unterschied: Die Kolumnentitel werden gelöscht. Dadurch wird +der oben erwähnte Effekt veralteter Kolumnentitel ausgeschlossen. Stattdessen +bleibt der Kolumnentitel auf Folgeseiten leer. +\OnlyAt{\Class{scrartcl}}\Macro{addchap} und \Macro{addchap*} existieren +selbstverständlich nur bei Buch- und Berichtklassen, also bei \Class{scrbook} +und \Class{scrreport}, nicht jedoch bei der Artikelklasse \Class{scrartcl}. + +Die Anweisung \Macro{addpart} erstellt entsprechend einen nicht +nummerierten Dokumentteil mit einem Eintrag im Inhaltsverzeichnis. Da +bereits \Macro{part} und \Macro{part*} den Kolumnentitel löschen, +ergibt sich hier nicht das oben genannte Problem mit veralteten +Kolumnentiteln. Die Sternvariante \Macro{addpart*} ist daher identisch +mit der Sternvariante \Macro{part*} und wurde nur aus +Konsistenzgründen definiert. + +Bitte beachten Sie, dass \Macro{addpart} und \Macro{addchap} und deren +Sternvarianten den Seitenstil für eine Seite umschalten. Der jeweilige +Seitenstil ist in den Makros \Macro{partpagestyle} und +\Macro{chapterpagestyle} abgelegt (siehe +\autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.titlepagestyle}). + +Bezüglich der Möglichkeiten der Schriftumschaltung\ChangedAt{v2.8p}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} % +gilt das gleiche wie zuvor in der Erklärung zu \Macro{part*}, \Macro{chapter*} +und \Macro{section*} geschrieben. Die Elemente tragen die gleichen Namen, da +sie nicht Varianten, sondern Gliederungsebenen bezeichnen.% +% +\EndIndex{Cmd}{addpart}% +\EndIndex{Cmd}{addpart*}% +\EndIndex{Cmd}{addchap}% +\EndIndex{Cmd}{addchap*}% +\EndIndex{Cmd}{addsec}% +\EndIndex{Cmd}{addsec*}% + + +\begin{Declaration} + \Macro{minisec}\Parameter{Überschrift} +\end{Declaration}% +\BeginIndex{Cmd}{minisec}% +Manchmal ist eine Art Überschrift\Index{Ueberschriften=Überschriften} +wünschenswert, die zwar hervorgehoben wird, ansonsten aber eng mit dem +nachfolgenden Text zusammenhängt. Eine solche Überschrift soll dann ohne große +Abstände gesetzt werden. + +Der Befehl \Macro{minisec} bewirkt genau eine derartige Überschrift. Diese +Überschrift ist keiner Gliederungsebene zugeordnet. Eine solche +\emph{Mini-Section} wird nicht in das Inhaltsverzeichnis aufgenommen und +erhält auch keine Nummerierung. +\begin{Example} + Sie haben einen Bausatz für eine Mausefalle entwickelt und wollen + diesen getrennt nach den benötigten Materialien und der Anleitung für + die Montage beschreiben. Das könnte so gemacht werden: +\begin{lstcode} + \minisec{Bauteile} + + \begin{flushleft} + 1 Brett ($100\times 50 \times 12$)\\ + 1 Bierflaschenschnappverschluss\\ + 1 Kugelschreiberfeder\\ + 1 Reißzwecke\\ + 2 Schrauben\\ + 1 Hammer\\ + 1 Messer + \end{flushleft} + + \minisec{Montage} + + Zunächst suche man das Mauseloch. Dann lege man die + Reißzwecke innen unmittelbar hinter das Loch, damit + bei den folgenden Aktionen die Maus nicht + entschlüpfen kann. + Anschließend klopfe man mit dem Hammer den + Bierflaschenschnappverschluss in das Mauseloch. + Sollte der Verschluss nicht groß genug sein, um das + Loch vollständig und dauerhaft zu verschließen, + nehme man stattdessen das Brett und schraube es + unter Zuhilfenahme der beiden Schrauben und des + Messers vor das Loch. Statt des Messers kann + selbstverständlich auch ein Schraubendreher + verwendet werden. + Die Kugelschreiberfeder ist dem Tierschutz zum + Opfer gefallen. +\end{lstcode} + Das Ganze sieht anschließend wie folgt aus: + \begin{ShowOutput}[\baselineskip]\setlength{\parindent}{1em} + \minisec{Bauteile} + + \begin{flushleft} + 1 Brett ($100\times 50 \times 12$)\\ + 1 Bierflaschenschnappverschluss\\ + 1 Kugelschreiberfeder\\ + 1 Reißzwecke\\ + 2 Schrauben\\ + 1 Hammer\\ + 1 Messer + \end{flushleft} + + \minisec{Montage} + + Zunächst suche man das Mauseloch. Dann lege man die + Reißzwecke innen unmittelbar hinter das Loch, damit + bei den folgenden Aktionen die Maus nicht + entschlüpfen kann. + Anschließend klopfe man mit dem Hammer den + Bierflaschenschnappverschluss in das Mauseloch. + Sollte der Verschluss nicht groß genug sein, um das + Loch vollständig und dauerhaft zu verschließen, + nehme man stattdessen das Brett und schraube es + unter Zuhilfenahme der beiden Schrauben und des + Messers vor das Loch. Statt des Messers kann + selbstverständlich auch ein Schraubendreher + verwendet werden. + Die Kugelschreiberfeder ist dem Tierschutz zum + Opfer gefallen. +% Mit der Kugelschreiberfeder hat es eine besondere +% Bewandtnis. Sie stammt noch aus dem Selbstbauprojekt +% »Mauseschnappfalle«, das dem Tierschutz zum Opfer gefallen ist. + \end{ShowOutput} +\end{Example} + +\BeginIndex{FontElement}{minisec}% +\BeginIndex{FontElement}{disposition}% +Die Schriftart des Gliederungsbefehls \Macro{minisec} kann über die Elemente +\FontElement{disposition} und +\FontElement{minisec}\ChangedAt{v2.96a}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} beeinflusst +werden (siehe \autoref{tab:maincls.elementsWithoutText}, +\autopageref{tab:maincls.elementsWithoutText}). Die Voreinstellung für das +Element \FontElement{minisec} ist leer, so dass in der Voreinstellung nur +das Element \FontElement{disposition} wirkt.% +\EndIndex{FontElement}{disposition}% +\EndIndex{FontElement}{minisec}% +% +\EndIndex{Cmd}{minisec}% + + +\begin{Declaration} + \Macro{raggedsection}\\ + \Macro{raggedpart} +\end{Declaration}% +\BeginIndex{Cmd}{raggedsection}% +\BeginIndex{Cmd}{raggedpart}% +Bei den Standardklassen werden die Überschriften ganz normal im Blocksatz +ausgegeben. Dadurch können in den Überschriften Trennungen auf"|treten und +mehrzeilige Überschriften werden auf Textbreite gedehnt. Dieses Vorgehen ist +in der Typografie eher unüblich. {\KOMAScript} setzt Überschriften von +\Macro{chapter} bis \Macro{subparagraph} daher in linksbündigem Flattersatz +mit hängendem Einzug. Verantwortlich ist dafür die Anweisung +\Macro{raggedsection}, die vordefiniert ist als: +\begin{lstcode}[belowskip=\dp\strutbox] + \let\raggedsection\raggedright +\end{lstcode} +Die Anweisung \Macro{raggesection} kann mit \Macro{renewcommand} umdefiniert +werden. +\begin{Example} + Sie wollen auch für Überschriften Blocksatz. Dazu schreiben Sie in + die Präambel Ihres Dokuments: +\begin{lstcode} + \renewcommand*{\raggedsection}{} +\end{lstcode} + oder kürzer: +\begin{lstcode} + \let\raggedsection\relax +\end{lstcode} + Sie erreichen somit eine ähnliche Formatierung der Überschriften wie + bei den Standardklassen. Noch ähnlicher wird es, wenn Sie diese + Änderung mit der oben vorgestellten Änderung für das Element + \FontElement{disposition}\IndexFontElement{disposition} + kombinieren. +\end{Example} +Die Überschriften von Teilen (\Macro{part}) werden in der Voreinstellung als +einzige nicht in linksbündigem Flattersatz, sondern zentriert gesetzt. Dafür +ist die Anweisung \Macro{raggedpart} verantwortlich, die als: +\begin{lstcode}[belowskip=\dp\strutbox] + \let\raggedpart\centering +\end{lstcode} +vordefiniert ist. Natürlich kann auch diese Anweisung mit \Macro{renewcommand} +umdefiniert werden. +\begin{Example} + Sie wollen, dass Überschriften mit \Macro{part} in der gleichen Weise + formatiert werden, wie alle anderen Ebenen. Dazu schreiben Sie + \begin{lstcode} + \renewcommand*{\raggedpart}{\raggedsection} + \end{lstcode} + in die Präambel Ihres Dokuments. +\end{Example} +% +\EndIndex{Cmd}{raggedpart}% +\EndIndex{Cmd}{raggedsection}% + + +\begin{Declaration} + \Macro{partformat}\\ + \Macro{chapterformat}\\ + \Macro{othersectionlevelsformat}\Parameter{Gliederungsname}\Parameter{}\Parameter{Zählerausgabe}\\ + \Macro{autodot} +\end{Declaration}% +\BeginIndex{Cmd}{partformat}\Index{Teil>Nummer}% +\BeginIndex{Cmd}{chapterformat}\Index{Kapitel>Nummer}% +\BeginIndex{Cmd}{othersectionlevelsformat}\Index{Abschnitt>Nummer}% +\BeginIndex{Cmd}{autodot}% +\vskip 1pt\nobreak% +\KOMAScript{} hat der Ausgabe der Gliederungsnummern eine weitere logische +Ebene oberhalb von \Macro{the\PName{Gliederungsname}} (siehe +\Macro{the\PName{Zähler}}, \autopageref{desc:maincls-experts.cmd.the}) +hinzugefügt. Die Zähler werden für die jeweilige Überschrift nicht einfach nur +ausgegeben. Sie werden mit Hilfe der Anweisungen \Macro{partformat}, +\Macro{chapterformat} und \Macro{othersectionlevelsformat} formatiert. +\OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Die Anweisung +\Macro{chapterformat} existiert wie auch \Macro{thechapter} selbstverständlich +nicht in der Klasse \Class{scrartcl}, sondern nur in den Klassen +\Class{scrbook} und \Class{scrreprt}. + +Wie bereits bei Option \Option{numbers} am Anfang dieses Abschnitts (siehe +\autopageref{desc:maincls.option.numbers}) erläutert wurde, müssen gemäß +\cite{DUDEN} die Gliederungsnummern je nach Gliederung mit einem nachfolgenden +Punkt versehen werden oder dieser hat zu entfallen. Die Anweisung +\Macro{autodot} ist bei {\KOMAScript} für die Einhaltung dieser Regel +verantwortlich. Auf den Punkt folgt bei allen Gliederungsebenen außer +\Macro{part} noch ein \Macro{enskip}. Dies entspricht einem Leerraum von +0,5\Unit{em}. + +Die Anweisung \Macro{othersectionlevelsformat} erwartet als ersten Parameter +den Namen der Gliederungsebene, also »\PName{section}«, »\PName{subsection}« +\dots{} Als drittes Argument wird die Ausgabe des Zählers dieser +Gliederungsebene erwartet, also \Macro{thesection}, \Macro{thesubsection} +\dots{} In der Voreinstellung gibt es nur für die Ebenen \Macro{part} und +\Macro{chapter} eigene Formatierungsanweisungen, während alle anderen +Gliederungsebenen mit Hilfe einer einzigen Formatierungsanweisung abgedeckt +werden. Dies ist allein historisch begründet. Als Werner Lemberg für sein +\Package{CJK}-Paket (siehe \cite{package:CJK}) eine entsprechende Erweiterung +von {\KOMAScript} angeregt hat, wurde nur diese Unterscheidung +benötigt. Anwender sollten bei der Umdefinierung der Anweisung das zweite +Argument komplett ignorieren. + +Die Formatierungsanweisungen können mit Hilfe von \Macro{renewcommand} +umdefiniert werden, um sie eigenen Anforderungen anzupassen. +Nachfolgend finden Sie die Originaldefinitionen aus den +{\KOMAScript}-Klassen: +\begin{lstcode} + \newcommand*{\partformat}{\partname~\thepart\autodot} + \newcommand*{\chapterformat}{% + \chapappifchapterprefix{\ }\thechapter\autodot\enskip} + \newcommand*{\othersectionlevelsformat}[3]{#3\autodot\enskip} +\end{lstcode} + +\begin{Example} + Angenommen, Sie wollen, dass bei \Macro{part} das Wort »Teil« vor + der Nummer nicht ausgegeben wird. Dann können Sie beispielsweise + folgende Anweisung in die Präambel Ihres Dokuments schreiben: + \begin{lstcode} + \renewcommand*{\partformat}{\thepart\autodot} + \end{lstcode} + Genau genommen könnten Sie an dieser Stelle auch auf \Macro{autodot} + verzichten und stattdessen einen festen Punkt setzen. Da \Macro{part} mit + römischen Zahlen nummeriert wird, muss der Punkt laut \cite{DUDEN} folgen. + Allerdings bringen Sie sich dann um die Möglichkeit, die Option + \Option{numbers} einzusetzen und so von der Regel abzuweichen. Näheres zu + der Option siehe \autopageref{desc:maincls.option.numbers}. + + Eine weitere Möglichkeit wäre, die Nummerierung der Abschnitte + so in den Rand zu platzieren, dass der Überschriftentext + links mit dem umgebenden Text abschließt. Dies erreicht man + mit: +\begin{lstcode} + \renewcommand*{\othersectionlevelsformat}[3]{% + \llap{#3\autodot\enskip}} +\end{lstcode} + Die wenig bekannte \TeX-Anweisung \Macro{llap}\IndexCmd{llap} sorgt + dabei dafür, dass das Argument links von der aktuellen Position + ausgegeben wird, ohne dass dabei die Position verändert wird. Eine + bessere \LaTeX-Lösung für dieses Problem wäre: +\begin{lstcode} + \renewcommand*{\othersectionlevelsformat}[3]{% + \makebox[0pt][r]{#3\autodot\enskip}} +\end{lstcode} + Näheres zu den optionalen Argumenten von \Macro{makebox} ist + \cite{latex:usrguide} zu entnehmen. +\end{Example} +% +\EndIndex{Cmd}{partformat}% +\EndIndex{Cmd}{chapterformat}% +\EndIndex{Cmd}{othersectionlevelsformat}% +\EndIndex{Cmd}{autodot}% + + +\begin{Declaration} + \Macro{chapappifchapterprefix}\Parameter{Zusatztext}\\ + \Macro{chapapp} +\end{Declaration}% +\BeginIndex{Cmd}{chapappifchapterprefix}% +\BeginIndex{Cmd}{chapapp}% +Diese \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}% +\ChangedAt{v2.8o}{\Class{scrbook}\and \Class{scrreprt}}% +beiden Anweisungen werden nicht nur intern von {\KOMAScript} verwendet, +sondern stehen auch dem Anwender zur Verfügung. Nachfolgend werden sie +beispielsweise für die Umdefinierung anderer Anweisungen verwendet. Bei +Verwendung der Option \Option{chapterprefix} (siehe +\autopageref{desc:maincls.option.chapterprefix}) setzt +\Macro{chapappifchapterprefix} im Hauptteil des Dokuments das Wort +»Kapitel«\Index{Kapitel>Ueberschrift=Überschrift} in der aktuellen Sprache +gefolgt vom \PName{Zusatztext}. Im Anhang\Index{Anhang} wird stattdessen das +Wort »Anhang« in der aktuellen Sprache, ebenfalls gefolgt vom +\PName{Zusatztext}, ausgegeben. Bei der Einstellung \Option{nochapterprefix} +wird hingegen nichts ausgegeben. + +Die Anweisung \Macro{chapapp} setzt immer das Wort »Kapitel« +beziehungsweise »Anhang«. Dabei spielen die beiden Optionen +\Option{chapterprefix} und \Option{nochapterprefix} keine Rolle. + +Da es Kapitel nur bei den Klassen \Class{scrbook} und \Class{scrreprt} +gibt, existieren die beiden Anweisungen auch nur bei diesen Klassen.% +% +\EndIndex{Cmd}{chapappifchapterprefix}% +\EndIndex{Cmd}{chapapp}% + + +\begin{Declaration} + \Macro{chaptermark}\Parameter{Kolumnentitel}\\ + \Macro{sectionmark}\Parameter{Kolumnentitel}\\ + \Macro{subsectionmark}\Parameter{Kolumnentitel}\\ + \Macro{chaptermarkformat}\\ + \Macro{sectionmarkformat}\\ + \Macro{subsectionmarkformat} +\end{Declaration}% +\BeginIndex{Cmd}{chaptermark}\Index{Kapitel}% +\BeginIndex{Cmd}{sectionmark}\Index{Abschnitt}% +\BeginIndex{Cmd}{subsectionmark}% +\BeginIndex{Cmd}{chaptermarkformat}% +\BeginIndex{Cmd}{sectionmarkformat}% +\BeginIndex{Cmd}{subsectionmarkformat}% +\begin{Explain} + Wie bereits in \autoref{sec:maincls.pagestyle} erwähnt, arbeitet der + Seitenstil \PValue{headings} mit automatischen + Kolumnentiteln\Index{Kolumnentitel>automatisch}. Dazu werden die + Anweisungen \Macro{chaptermark} und \Macro{sectionmark} beziehungsweise + \Macro{sectionmark} und \Macro{subsectionmark} entsprechend definiert. + Gliederungsbefehle (\Macro{chapter}, \Macro{section}~\dots) führen + automatisch eine entsprechende \Macro{\dots mark}-Anweisung aus. Der + übergebene Parameter beinhaltet dabei den Text der + Gliederungsüberschrift\Index{Ueberschriften=Überschriften}. Die zugehörige + Gliederungsnummer wird automatisch in der \Macro{\dots mark}-Anweisung + hinzugefügt. Die Formatierung erfolgt dabei je nach Gliederungsebene mit + einer der drei Anweisungen \Macro{chaptermarkformat}, + \Macro{sectionmarkformat} und \Macro{subsectionmarkformat}. + + \OnlyAt{\Class{scrbook}\and \Class{scrreprt}}Während es bei \Class{scrartcl} + weder \Macro{chaptermark} noch \Macro{chaptermarkformat} gibt, existieren + \OnlyAt{\Class{scrartcl}}\Macro{subsectionmark} und + \Macro{subsectionmarkformat} nur bei \Class{scrartcl}. Dies ändert sich + allerdings bei Verwendung des \Package{scrpage2}-Pakets (siehe + \autoref{cha:scrpage}). +\end{Explain} +So wie mit \Macro{chapterformat} und \Macro{othersectionlevelsformat} die +Nummern der Gliederungsüberschriften formatiert ausgegeben werden, werden mit +den Anweisungen \Macro{chaptermarkformat}, \Macro{sectionmarkformat} und +\Macro{subsectionmarkformat} die Nummern der Gliederungsebenen in den +automatischen Kolumnentiteln formatiert ausgegeben. Mit +\Macro{renewcommand} können sie eigenen Anforderungen angepasst werden. Die +Originaldefinitionen aus den {\KOMAScript}-Klassen sind: +\begin{lstcode} + \newcommand*{\chaptermarkformat}{% + \chapappifchapterprefix{\ }\thechapter\autodot\enskip} + \newcommand*{\sectionmarkformat}{\thesection\autodot\enskip} + \newcommand*{\subsectionmarkformat}{% + \thesubsection\autodot\enskip} +\end{lstcode} +\begin{Example} + Angenommen, Sie wollen, dass der Kapitelnummer in den Kolumnentiteln + das Wort »Kapitel« vorangestellt wird. Dann setzen Sie + beispielsweise diese Definition in die Präambel Ihres Dokuments: +\begin{lstcode} + \renewcommand*{\chaptermarkformat}{% + \chapapp~\thechapter\autodot\enskip} +\end{lstcode} +\end{Example} +Wie Sie sehen, finden hier die Anweisungen \Macro{chapappifchapterprefix} und +\Macro{chapapp} Verwendung, die weiter oben erklärt wurden.% +% +\EndIndex{Cmd}{chaptermark}% +\EndIndex{Cmd}{sectionmark}% +\EndIndex{Cmd}{subsectionmark}% +\EndIndex{Cmd}{chaptermarkformat}% +\EndIndex{Cmd}{sectionmarkformat}% +\EndIndex{Cmd}{subsectionmarkformat}% + + +\begin{Declaration} + \Counter{secnumdepth} +\end{Declaration}% +\BeginIndex{Counter}{secnumdepth}\BeginIndex{}{Nummerierung}% +Normalerweise werden bei den Klassen \Class{scrbook}\IndexClass{scrbook} und +\Class{scrreprt}\IndexClass{scrreprt} die Gliederungsebenen +\Macro{part}\IndexCmd{part}\IndexCmd{chapter}\IndexCmd{section} bis +\Macro{subsection}\IndexCmd{subsection} und bei der Klasse +\Class{scrartcl}\IndexClass{scrartcl} die Ebenen \Macro{part} bis +\Macro{subsubsection}\IndexCmd{subsubsection} nummeriert. Gesteuert wird dies +über den \LaTeX-Zähler \Counter{secnumdepth}. Dabei steht der Wert \(-\)1 für +\Macro{part}, 0 für \Macro{chapter} und so weiter. Durch Setzen oder Erhöhen +oder Verringern des Zählers kann bestimmt werden, bis zu welcher +Gliederungsebene eine Nummerierung erfolgen soll. Dies ist übrigens bei den +Standardklassen ganz genauso. Vergleichen Sie hierzu auch die Erklärung zum +Zähler \Counter{tocdepth} in \autoref{sec:maincls.toc}, +\autopageref{desc:maincls.counter.tocdepth}.% +% +\EndIndex{Counter}{secnumdepth}\EndIndex{}{Nummerierung} + + +\begin{Declaration} + \Macro{setpartpreamble}% + \OParameter{Position}\OParameter{Breite}\Parameter{Präambel}\\ + \Macro{setchapterpreamble}% + \OParameter{Position}\OParameter{Breite}\Parameter{Präambel} +\end{Declaration}% +\BeginIndex{Cmd}{setpartpreamble}% +\BeginIndex{Cmd}{setchapterpreamble}% +\OnlyAt{\Class{scrbook}\and + \Class{scrreprt}}Teile\Index{Teil>Praeambel=Präambel} und +Kapitel\Index{Kapitel>Praeambel=Präambel} können bei {\KOMAScript} mit einer +\PName{Präambel} versehen werden. Dies ist insbesondere im zweispaltigen +Layout mit der Klassenoption \Option{twocolumn}\IndexOption{twocolumn} +nützlich, da die \PName{Präambel} zusammen mit der Überschrift einspaltig +gesetzt wird. Die \PName{Präambel} kann auch mehrere Absätze beinhalten. Die +Anweisung zum Setzen der \PName{Präambel} muss vor der jeweiligen +\Macro{part}- oder \Macro{addpart}- bzw. \Macro{chapter}- oder +\Macro{addchap}-Anweisung stehen. +\begin{Example} + Sie schreiben einen Bericht über den Zustand einer Firma. Dabei + organisieren Sie den Bericht so, dass jeder Abteilung ein eigener + Teilbericht spendiert wird. Jedem dieser Teile soll außerdem eine + Zusammenfassung vorangestellt werden. Diese Zusammenfassung soll auf + der Titelseite jedes Teils stehen. Das ist wie folgt möglich: + \begin{lstcode} + \setpartpreamble{% + \begin{abstract} + Dies ist ein Blindtext. Er dient lediglich zur + Demonstration der Möglichkeiten von \KOMAScript. + \end{abstract} + } + \part{Abteilung Grünschnitt} + \end{lstcode} + Je nach Einstellung der Optionen für die + Überschriftengröße\Index{Ueberschriften=Überschriften} (siehe + \autopageref{desc:maincls.option.headings}) und der Optionen für die Form + der \Environment{abstract}-Umgebung\IndexEnv{abstract} (siehe + \autoref{sec:maincls.abstract}, \autopageref{desc:maincls.option.abstract}), + sieht das Ergebnis ungefähr wie folgt aus: + \begin{ShowOutput}\centering + {\LARGE\usekomafont{disposition} Teil III.\par\vspace{20pt}} + {\LARGE\usekomafont{disposition} Abteilung Grünschnitt\strut\par} + \begin{quote}\small + \vspace{6ex} + \begin{center} + \usekomafont{disposition}\abstractname + \end{center} + \vspace{2ex} + Dies ist ein Blindtext. Er dient lediglich zur + Demonstration der Möglichkeiten von \KOMAScript. + \end{quote} + \end{ShowOutput} +\end{Example} +Bitte beachten Sie, dass Sie für die Abstände der Präambel zur Teilüberschrift +bzw. zum Kapiteltext selbst verantwortlich sind. Bitte beachten Sie auch, dass +die \Environment{abstract}-Umgebung bei der Klasse \Class{scrbook} nicht +existiert (siehe \autoref{sec:maincls.abstract}, +\autopageref{desc:maincls.env.abstract}). + +Das\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}} erste +optionale Argument \PName{Position} bestimmt über ein bis zwei +Buchstaben die Position, an der die Präambel ausgegeben wird. Für die +vertikale Position existieren derzeit zwei Möglichkeiten: +\begin{labeling}[~--]{\PValue{o}} +\item [\PValue{o}] über der Überschrift +\item [\PValue{u}] unter der Überschrift +\end{labeling} +Es kann jeweils eine Präambel unter und eine Präambel über der +Überschrift gesetzt werden. Für die horizontale Position existieren +derzeit drei Möglichkeiten: +\begin{labeling}[~--]{\PValue{o}} +\item [\PValue{l}] linksbündig +\item [\PValue{r}] rechtsbündig +\item [\PValue{c}] zentriert +\end{labeling} +Dabei wird allerdings nicht der Text der \PName{Präambel} entsprechend +angeordnet, sondern eine Box, deren Breite durch das zweite optionale +Argument \PName{Breite} bestimmt wird. Wird auf das zweite optionale +Argument verzichtet, so wird stattdessen die gesamte Textbreite +verwendet. Damit bleibt die Option zur horizontalen Positionierung in +diesem Fall wirkungslos. Es kann jeweils ein Buchstabe für die +vertikale mit einem Buchstaben für die horizontale Anordnung +kombiniert werden. + +Eine häufigere Anwendung von \Macro{setchapterpreamble} dürfte ein Spruch oder +Zitat zu einer Überschrift sein. Die dazu verwendbare Anweisung +\Macro{dictum}\IndexCmd{dictum} ist im nachfolgenden Abschnitt erläutert. Dort +findet sich auch ein entsprechendes Beispiel.% +% +\EndIndex{Cmd}{setpartpreamble}% +\EndIndex{Cmd}{setchapterpreamble}% +% +\EndIndex{}{Gliederung} + + +\LoadCommon{15}% \section{Schlauer Spruch} + +\LoadCommon{12}% \section{Listen} + +\section{Mathematik} +\label{sec:maincls.math}% +\BeginIndex{}{Mathematik}% +\BeginIndex{}{Formeln}% +\BeginIndex{}{Gleichungen}% + +Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische +Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik +bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll +und ganz auf den \LaTeX-Kern. Dies gilt auch für die Realisierung der beiden +Optionen \Option{leqno} und \Option{fleqn}. + + +\begin{Declaration} + \Option{leqno} +\end{Declaration}% +\BeginIndex{Option}{leqno}% +Gleichungen\Index{Gleichungen>Nummern} werden normalerweise auf der rechten +Seite nummeriert. Mit Hilfe der Standardoption \Option{leqno} wird die +Standardoptionsdatei \File{leqno.clo} geladen. Dadurch erfolgt die +Nummerierung von Gleichungen links. Diese Option ist als optionales Argument +von \Macro{documentclass} zu verwenden. Eine Einstellung per +\Macro{KOMAoptions} oder \Macro{KOMAoption} wird nicht unterstützt.% +% +\EndIndex{Option}{leqno}% + + +\begin{Declaration} + \Option{fleqn} +\end{Declaration}% +\BeginIndex{Option}{fleqn}% +Gleichungen\Index{Gleichungen>Ausrichtung} werden normalerweise horizontal +zentriert ausgegeben. Mit Hilfe der Standardoption \Option{fleqn} wird die +Standardoptionsdatei \File{fleqn.clo} geladen. Dadurch erfolgt die Ausgabe von +Gleichungen linksbündig. Diese Option ist als optionales Argument +von \Macro{documentclass} zu verwenden. Eine Einstellung per +\Macro{KOMAoptions} oder \Macro{KOMAoption} wird nicht unterstützt.% +% +\EndIndex{Option}{fleqn}% + + +Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also +\Environment{displaymath}\IndexEnv{displaymath}, +\Environment{equation}\IndexEnv{equation} und +\Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle +verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für +mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die +Verwendung von \Package{amsmath} empfohlen (siehe \cite{package:amsmath}).% +% +\EndIndex{}{Gleichungen}% +\EndIndex{}{Formeln}% +\EndIndex{}{Mathematik} + + +\section{Gleitumgebungen für Tabellen und Abbildungen} +\label{sec:maincls.floats} +\BeginIndex{}{Gleitumgebungen} +\BeginIndex{}{Tabellen} +\BeginIndex{}{Abbildungen} + +{\LaTeX} bietet mit den Gleitumgebungen einen sehr leistungsfähigen und +komfortablen Mechanismus für die automatische Anordnung von Abbildungen und +Tabellen. Genau genommen sollte von »Tafeln«\Index{Tafeln} statt von +»Tabellen« die Rede sein. Dies wäre auch zur Unterscheidung der Umgebungen +\Environment{table}\IndexEnv{table} und +\Environment{tabular}\IndexEnv{tabular} von Vorteil. Es hat sich im Deutschen +aber für beides die Bezeichnung »Tabelle« eingebürgert. Das kommt vermutlich +daher, dass man in \Environment{table}-Umgebungen üblicherweise +\Environment{tabular}-Umgebungen setzt. + +Häufig werden die Gleitumgebungen von Anfängern nicht richtig verstanden. So +wird oft die Forderung aufgestellt, eine Tabelle oder Abbildung genau an einer +bestimmten Position im Text zu setzen. Dies ist jedoch nicht erforderlich, da +auf Gleitumgebungen im Text über eine Referenz verwiesen wird. Es ist auch +nicht sinnvoll, da ein solches Objekt an einer Stelle nur dann gesetzt werden +kann, wenn auf der Seite noch genügend Platz für das Objekt vorhanden ist. Ist +dies nicht der Fall, müsste das Objekt auf die nächste Seite umbrochen werden +und auf der aktuellen Seite würde ein möglicherweise sehr großer leerer Raum +bleiben. + +Häufig findet sich in einem Dokument auch bei jedem Gleitobjekt das gleiche +optionale Argument zur Platzierung des Objekts. Auch dies ist nicht +sinnvoll. In solchen Fällen sollte man besser den Standardwert global +ändern. Näheres dazu ist \cite{DANTE:FAQ} zu entnehmen. + +Ein wichtiger Hinweis sei diesem Abschnitt noch vorangestellt: Die meisten +Mechanismen, die hier vorgestellt werden und über die Fähigkeiten der +Standardklassen hinaus gehen, funktionieren nicht mehr, wenn Sie ein Paket +verwenden, das in die Generierung von Tabellen- und Abbildungstiteln eingreift +und deren Aussehen verändert. Dies sollte selbstverständlich sein, wird aber +leider häufig nicht bedacht. + + +\begin{Declaration} + \KOption{captions}\PName{Einstellung} +\end{Declaration} +\BeginIndex{Option}{captions~=\PName{Einstellung}}% +Bei den Standardklassen werden die Titel von Gleitumgebungen, die mit der +Anweisung \Macro{caption}\IndexCmd{caption} (siehe unten) gesetzt werden, als +Unterschrift formatiert. Darüber hinaus wird zwischen ein"~ und mehrzeiligen +Unterschriften unterschieden, wobei einzeilige Unterschriften horizontal +zentriert werden. + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.captions.tableheading}\nobreak +Tabellen werden jedoch häufig mit Überschriften statt mit Unterschriften +versehen. Das liegt daran, dass es auch Tabellen geben kann, die sich über +mehrere Seiten erstrecken. Bei solchen Tabellen möchte man natürlich bereits +auf der ersten Seite wissen, worum es sich handelt. Aus Gründen der Konsistenz +werden deshalb alle Tabellen mit Überschriften versehen. \KOMAScript{} bietet +daher mit der Einstellung +\OptionValue{captions}{tableheading}\IndexOption{captions~=tableheading} die +Möglichkeit, bei Tabellen die Formatierung auf Überschriften zu ändern. Es sei +an dieser Stelle darauf hingewiesen, dass mehrseitige Tabellen nicht als +Gleitumgebungen gesetzt werden können. Für den automatischen Seitenumbruch von +Tabellen werden außerdem Zusatzpakete wie +\Package{longtable}\IndexPackage{longtable} (siehe \cite{package:longtable}) +benötigt. + +Mit der Einstellung +\OptionValue{captions}{tablesignature}\IndexOption{captions~=tablesignature} +wird wieder die Voreinstellung der Formatierung als Tabellenüberschrift +gewählt. Es sei an dieser Stelle darauf hingewiesen, dass die beiden Werte +lediglich die Formatierung ändern. Der Ort, an dem die Über"~ oder +Unterschrift gesetzt wird, hängt bei den Gleitumgebungen von \KOMAScript{} +allein vom Ort ab, an dem die Anweisung \Macro{caption} verwendet wird. Dies +ändert sich ggf. bei Verwendung des Pakets \Package{float}\IndexPackage{float} +mit der Anweisung \Macro{restylefloats} (siehe \cite{package:float}). + +Bitte\OnlyAt{\Package{float}}\IndexPackage{float} beachten Sie, dass bei +Verwendung des \Package{float}-Pakets die Einstellungen +\OptionValue{captions}{tableheadings} und +\OptionValue{captions}{tablesignature} nicht mehr funktionieren, sobald Sie +\Macro{restylefloat} auf Tabellen anwenden. Näheres zum \Package{float}-Paket +und \Macro{restylefloat} entnehmen Sie bitte \cite{package:float}. Die +zusätzliche Unterstützung, die \KOMAScript{} bei Verwendung des +\Package{float}-Pakets bietet, finden Sie bei der Erklärung zu +\PValue{komaabove} (siehe \autopageref{desc:maincls.floatstyle.komaabove}). + +\leavevmode\phantomsection\nobreak +\label{desc:maincls.option.captions.nooneline}\nobreak +\label{desc:maincls.option.captions.oneline}\nobreak +Bei \KOMAScript{} besteht darüber hinaus auch die Möglichkeit, mit der +Einstellung \OptionValue{captions}{nooneline}\IndexOption{captions~=nooneline} +die Unterscheidung zwischen ein"~ und mehrzeiligen Über"~ bzw. Unterschriften +abzuschalten. Dies ist beispielsweise dann wichtig, wenn man keine Zentrierung +wünscht. Die Voreinstellung, bei der einzeilige Über"~ und Unterschriften +automatisch horizontal zentriert werden, entspricht der Einstellung +\OptionValue{captions}{oneline}. + +Als Besonderheit bietet \KOMAScript{} innerhalb von Gleitumgebungen die +Möglichkeit, den Titel statt als Über"~ oder Unterschrift neben den +eigentlichen Inhalt zu setzen. Die dazu notwendige Umgebung +\Environment{captionsbeside}\IndexEnv{captionbeside} ist ab +\autopageref{desc:maincls.env.captionbeside} erklärt. Die +Einstellungen für diese Umgebung können ebenfalls mit der Option +\Option{captions} geändert werden. Die dabei möglichen Werte für die jeweilige +\PName{Einstellung} sind \autoref{tab:maincls.captions} zu entnehmen. + +\iffree{}{\afterpage}{% +\begin{desctable} + \caption[{Mögliche Werte für Option \Option{captions}}]{Mögliche Werte für + Option \Option{captions} zur Einstellung der Formatierung von Über"~ und + Unterschriften in Gleitumgebungen\label{tab:maincls.captions}}\\ + \Endfirsthead% + \caption[]{Mögliche Werte für Option \Option{captions} + (\emph{Fortsetzung})}\\ + \Endhead% + \standardfoot% + \entry{\PValue{bottombeside}, \PValue{besidebottom}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden mit der + untersten Grundlinie auf Höhe der untersten Grundlinie des Inhalts der + Gleitumgebung ausgerichtet.% + \IndexOption{captions~=bottombeside}}% + \entry{\PValue{centeredbeside}, \PValue{besidecentered}, + \PValue{middlebeside}, \PValue{besidemiddle}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden zum Inhalt + der Gleitumgebung vertikal zentriert ausgerichtet.% + \IndexOption{captions~=centeredbeside}}% + \entry{\PValue{innerbeside}, + \PValue{besideinner}\IndexOption{captions~=innerbeside}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden bei + doppelseitigem Satz in der Voreinstellung innen neben dem Inhalt der + Gleitumgebung gesetzt. Dies entspricht im einseitigen Satz + \OptionValue{captions}{leftbeside}.}% + \entry{\PValue{leftbeside}, + \PValue{besideleft}\IndexOption{captions~=leftbeside}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden in der + Voreinstellung links neben dem Inhalt der Gleitumgebung gesetzt.}% + \pventry{nooneline}{% + Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden nicht + gesondert, sondern genau wie mehrzeilige behandelt.% + \IndexOption{captions~=nooneline}}% + \pventry{oneline}{% + Einzeilige Über"~ und Unterschriften von Gleitumgebungen werden gesondert + behandelt, um sie horizontal zu zentrieren.% + \IndexOption{captions~=oneline}}% + \entry{\PValue{outerbeside}, \PValue{besideouter}% + \IndexOption{captions~=outerbeside}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden bei + doppelseitigem Satz in der Voreinstellung außen neben dem Inhalt der + Gleitumgebung gesetzt. Dies entspricht im einseitigen Satz + \OptionValue{captions}{rightbeside}.}% + \entry{\PValue{rightbeside}, \PValue{besideright}% + \IndexOption{captions~=rightbeside}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden in der + Voreinstellung rechts neben dem Inhalt der Gleitumgebung gesetzt.}% + \entry{\PValue{tableheading}, \PValue{tableabove}, \PValue{abovetable}, + \PValue{abovetabular}, \PValue{topattable}% + \IndexOption{captions~=tableheading}}{% + Bei Tabellen wird die Formatierung als Überschrift gewählt.}% + \entry{\PValue{tablesignature}, \PValue{belowtable}, \PValue{belowtabular}, + \PValue{bottomattable}% + \IndexOption{captions~=tablesignature}}{% + Bei Tabellen wird die Formatierung als Unterschrift gewählt.}% + \entry{\PValue{topbeside}, \PValue{besidetop}}{% + Gleitumgebungstitel der Umgebung \Environment{captionsbeside} (siehe + \autoref{sec:maincls.floats}, + \autopageref{desc:maincls.env.captionbeside}) werden mit der + obersten Grundlinie auf Höhe der obersten Grundlinie des Inhalts der + Gleitumgebung ausgerichtet.% + \IndexOption{captions~=topbeside}}% +\end{desctable}}% +% +\EndIndex{Option}{captions~=\PName{Einstellung}}% + + +\begin{Declaration} + \Macro{caption}\OParameter{Verzeichniseintrag}\Parameter{Titel}\\ + \Macro{captionbelow}\OParameter{Verzeichniseintrag}\Parameter{Titel}\\ + \Macro{captionabove}\OParameter{Verzeichniseintrag}\Parameter{Titel} +\end{Declaration}% +\BeginIndex{Cmd}{caption}% +\BeginIndex{Cmd}{captionabove}% +\BeginIndex{Cmd}{captionbelow}% +Tabellen und Abbildungen werden bei den Standardklassen mit Hilfe der +Anweisung \Macro{caption} mit einem \PName{Titel} in Form einer +Unterschrift\Index{Tabellen>Unterschrift} versehen. Bei Abbildungen ist dies +grundsätzlich korrekt. Bei Tabellen wird gestritten, ob der \PName{Titel} als +Überschrift über oder konsistent mit der +Bildunterschrift\Index{Bildunterschrift} unter die Tabelle gehört. Daher +bietet \KOMAScript{} im Gegensatz zu den Standardklassen die Anweisungen +\Macro{captionbelow} für \PName{Titel} in Form von Unterschriften und +\Macro{captionabove} für \PName{Titel} in Form von Überschriften. +\Macro{caption} verhält sich bei Abbildungen immer wie \Macro{captionbelow}. +Bei Tabellen lässt sich das Verhalten von \Macro{caption} hingegen mit der +Option \Option{captions}\IndexOption{captions} steuern, die am Anfang dieses +Abschnitts zu finden ist. Aus Gründen der Kompatibilität ist voreingestellt, +dass sich \Macro{caption} auch bei Tabellen wie \Macro{captionbelow} verhält. +% +\begin{Example} + Sie wollen mit + Tabellenüberschriften\Index{Tabellen>Ueberschrift=Überschrift} statt mit + Tabellenunterschriften arbeiten, weil Sie teilweise Tabellen haben, die über + mehr als eine Seite gehen. Mit den Standardklassen bliebe Ihnen nur die + Möglichkeit: +\begin{lstcode} + \begin{table} + \caption{Dies ist nur eine Beispieltabelle} + \begin{tabular}{llll} + Dies & ist & ein & Beispiel.\\\hline + Bitte & lassen & Sie & den \\ + Inhalt & dieser & Tabelle & unbeachtet. + \end{tabular} + \end{table} +\end{lstcode} + Damit hätten Sie das unschöne Ergebnis: + \begin{ShowOutput}\centering + {\usekomafont{caption}{\usekomafont{captionlabel}\tablename~30.2:} + Dies ist nur eine + Beispieltabelle}\\ + \begin{tabular}{llll} + Dies & ist & ein & Beispiel.\\\hline + Bitte & lassen & Sie & den \\ + Inhalt & dieser & Tabelle & unbeachtet. + \end{tabular} + \end{ShowOutput} + Bei \KOMAScript{} schreiben Sie hingegen: +\begin{lstcode} + \begin{table} + \captionabove{Dies ist nur eine Beispieltabelle} + \begin{tabular}{llll} + Dies & ist & ein & Beispiel.\\\hline + Bitte & lassen & Sie & den \\ + Inhalt & dieser & Tabelle & unbeachtet. + \end{tabular} + \end{table} +\end{lstcode} + Sie erhalten dann das gewünschte Ergebnis: + \begin{ShowOutput}\centering + {\usekomafont{caption}{\usekomafont{captionlabel}\tablename~30.2:} + Dies ist nur eine + Beispieltabelle}\\\vskip\abovecaptionskip + \begin{tabular}{llll} + Dies & ist & ein & Beispiel.\\\hline + Bitte & lassen & Sie & den \\ + Inhalt & dieser & Tabelle & unbeachtet. + \end{tabular} + \end{ShowOutput} + Da Sie konsistent alle Tabellen mit Überschriften versehen, können Sie + stattdessen auch die Option \OptionValue{captions}{tableheading} setzen + (siehe \autopageref{desc:maincls.option.captions.tableheading}). Dann genügt + es, wenn Sie wie bei den Standardklassen \Macro{caption} verwenden. Sie + erhalten trotzdem das Ergebnis von \Macro{captionabove}. +\end{Example} + +\BeginIndex[indexother]{}{Schriftart}% +Die Schriftart\ChangedAt{v2.8p}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} für die +Beschreibung und das Label~-- »Abbildung« oder »Tabelle« gefolgt von der +Nummer und einem Trennzeichen -- kann über die Anweisungen \Macro{setkomafont} +und \Macro{addtokomafont} (siehe \autoref{sec:maincls.textmarkup}, +\autopageref{desc:maincls.cmd.setkomafont}) verändert werden. Zuständig +sind hier die Elemente \FontElement{caption}\IndexFontElement{caption} und +\FontElement{captionlabel}\IndexFontElement{captionlabel} (siehe +\autoref{tab:maincls.elementsWithoutText}, +\autopageref{tab:maincls.elementsWithoutText}). Dabei wird die Schriftart für +das Element \FontElement{caption} zunächst auch auf das Element +\FontElement{captionlabel} angewandt, bevor dessen spezifische Schriftart +Anwendung findet. Die Vorbelegungen sind \autoref{tab:maincls.captionFont} zu +entnehmen. +% +\afterpage{\afterpage{% Umbruchkorrektur +\begin{table} + \centering% + \caption[{Schriftvoreinstellungen für die Elemente der Tabellen- + oder\newline Abbildungsunterschrift + bzw. "~überschrift}]{Schriftvoreinstellungen für die Elemente der Tabellen- + oder Abbildungsunterschrift bzw. "~überschrift} + \begin{tabular}{ll} + \toprule + Element & Voreinstellung \\ + \midrule + \FontElement{caption} & \Macro{normalfont} \\ + \FontElement{captionlabel} & \Macro{normalfont} \\ + \bottomrule + \end{tabular} + \label{tab:maincls.captionFont} +\end{table} +}} +% +\begin{Example} + Sie wollen, dass Tabellen- und Abbildungsbeschreibungen in einer + kleineren Schriftart gesetzt werden. Also setzen Sie + beispielsweise in der Präambel Ihres Dokuments: +\begin{lstcode} + \addtokomafont{caption}{\small} +\end{lstcode} + Außerdem hätten Sie gerne, dass das Label serifenlos und fett + gedruckt wird. Sie setzen also außerdem: +\begin{lstcode} + \setkomafont{captionlabel}{\sffamily\bfseries} +\end{lstcode} + Das Ergebnis wäre bei Verwendung von \Macro{addkomafont} in diesem Fall + übrigens gleich. +\end{Example} +% +\EndIndex[indexother]{}{Schriftart} +% +\EndIndex{Cmd}{caption}% +\EndIndex{Cmd}{captionabove}% +\EndIndex{Cmd}{captionbelow}% + + +\begin{Declaration} + \XMacro{begin}\PParameter{\Environment{captionbeside}}% + \OParameter{Verzeichnistitel}\Parameter{Titel}\texttt{\%}\\ + \hphantom{\XMacro{begin}\PParameter{captionbeside}}% + \OParameter{Anordnung}\OParameter{Breite}% + \OParameter{Offset}\\% + \quad\dots\\ + \XMacro{end}\PParameter{captionbeside}\\ + \XMacro{begin}\PParameter{captionbeside}\OParameter{Verzeichnistitel}% + \Parameter{Titel}\texttt{\%}\\ + \hphantom{\XMacro{begin}\PParameter{captionbeside}}% + \OParameter{Anordnung}\OParameter{Breite}% + \OParameter{Offset}\PValue{*}\\ + \quad\dots\\ + \XMacro{end}\PParameter{captionbeside} +\end{Declaration} +\BeginIndex{Env}{captionbeside}% +Neben \ChangedAt{v2.8q}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% +den Unter- und Überschriften findet man insbesondere bei kleineren +Abbildungen häufiger Beschreibungen, die neben der Abbildung gesetzt +werden. Dabei schließt normalerweise die Unterkante der Beschreibung +mit der Unterkante der Abbildung ab. Natürlich kann man mit etwas +Geschick und beispielsweise zwei \Macro{parbox}-Anweisungen +dergleichen auch in den Standardklassen erreichen. \KOMAScript{} +bietet jedoch eine spezielle Umgebung. Diese Umgebung kann innerhalb +der Gleitumgebungen verwendet werden. Der erste optionale Parameter +\PName{Verzeichnistitel} und der obligatorische Parameter +\PName{Titel} entsprechen dabei genau den gleichnamigen Parametern von +\Macro{caption}, \Macro{captionabove} oder \Macro{captionbelow}. Der +\PName{Titel} wird dabei neben den Inhalt der Umgebung gesetzt. + +Ob der \PName{Titel} rechts oder links daneben gesetzt wird, kann mit +dem optionalen Parameter \PName{Anordnung} bestimmt werden. Es darf +genau einer der folgenden Buchstaben angegeben werden: +\begin{labeling}[~--]{\PValue{o}} +\item[\PValue{l}] links +\item[\PValue{r}] rechts +\item[\PValue{i}] innen, also auf rechten Seiten links und auf + linken Seiten rechts +\item[\PValue{o}] außen, also auf rechten Seiten rechts und auf + linken Seiten links +\end{labeling} +Voreingestellt ist rechts neben dem Inhalt der Umgebung. Diese +Voreinstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} kann jedoch mit der Option +\Option{captions}\IndexOption{captions} (siehe +\autopageref{desc:maincls.option.captions}) und deren Werte +\PValue{innerbeside}\IndexOption[indexmain]{captions~=innerbeside}, +\PValue{leftbeside}\IndexOption[indexmain]{captions~=leftbeside}, +\PValue{outerbeside}\IndexOption[indexmain]{captions~=outerbeside} und +\PValue{rightbeside}\IndexOption[indexmain]{captions~=rightbeside} verändert +werden. Bei Verwendung der Anordnung außen oder innen werden unter Umständen +zwei \LaTeX-Durchläufe benötigt, um die korrekte Anordnung zu erreichen. + +Normalerweise nehmen der Inhalt der Umgebung und der \PName{Titel} die +gesamte verfügbare Breite ein. Es besteht jedoch die Möglichkeit, mit +dem optionalen Parameter \PName{Breite} eine andere Breite +anzugeben. Diese kann auch größer als die Breite des Textkörpers +sein. + +Bei Angabe einer \PName{Breite} wird die genutzte Breite +normalerweise bezüglich der Breite des Textkörpers zentriert. Mit dem +optionalen Argument \PName{Offset} kann stattdessen eine Verschiebung +relativ zum linken Rand angegeben werden. Ein positiver Wert +entspricht einer Verschiebung nach rechts, ein negativer Wert einer +Verschiebung nach links. Mit einem \PName{Offset} von 0\Unit{pt} +erfolgt die Ausgabe linksbündig. + +Wird hinter den optionalen Parameter \PName{Offset} noch ein Stern +gesetzt, so stellt der \PName{Offset} im doppelseitigen Druck auf +linken Seiten eine Verschiebung relativ zum rechten Rand dar. Ein +positiver Wert entspricht dann einer Verschiebung nach außen, während +ein negativer Wert für eine Verschiebung nach innen steht. Ein +\PName{Offset} von 0\Unit{pt} wäre dann also bündig zum inneren +Rand. Diese Variante benötigt unter Umständen zwei \LaTeX-Durchläufe, +um die korrekte Verschiebung zu erreichen. + +Vertikal erfolgt die Ausrichtung in der Voreinstellung unten. Das bedeutet, +dass die untere Grundlinie des Inhalts des Gleitobjekts und die untere +Grundlinie von \PName{Titel} auf einer Höhe liegen. Diese +Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} kann mit der Option +\Option{captions}\IndexOption{captions} (siehe +\autopageref{desc:maincls.option.captions}) und deren Werte +\PValue{topbeside}\IndexOption[indexmain]{captions~=topbeside}, +\PValue{centeredbeside}\IndexOption[indexmain]{captions~=centeredbeside} und +\PValue{bottombeside}\IndexOption[indexmain]{captions~=bottombeside} verändert +werden. Bei der Einstellung \PValue{topbeside} werden die oberen Grundlinien +von Gleitobjektinhalt und \PName{Titel} auf einer Höhe ausgerichtet, während +bei \PValue{centeredbeside} eine Zentrierung stattfindet. In diesem +Zusammenhang sei erwähnt, dass Abbildungen normalerweise die Grundlinie unten +haben. Dies kann beispielsweise mit der Anweisung +\Macro{raisebox}\IndexCmd{raisebox} verändert werden. + +\begin{Example} + Ein Beispiel für die Verwendung der + \Environment{captionbeside}-Umgebung ist in + \autoref{fig:maincls.captionbeside} zu finden. Gesetzt wurde + diese Abbildung mit: +\begin{lstcode} + \begin{figure} + \begin{captionbeside}% + [Beispiel: Bildbeschreibung daneben, unten]% + {Eine Bildbeschreibung weder über noch unter + der Abbildung, sondern unten daneben}% + [i][\linewidth][2em]* + \fbox{\parbox[b][5\baselineskip][c]{.25\textwidth}{% + \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}} + \end{captionbeside} + \label{fig:maincls.captionbeside} + \end{figure} +\end{lstcode} + \begin{figure} + \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, unten]% + {Eine Bildbeschreibung weder über noch unter der Abbildung, + sondern unten daneben}[i][\linewidth][2em]* + \fbox{\parbox[b][5\baselineskip][c]{.25\textwidth}{% + \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}} + \end{captionbeside} + \label{fig:maincls.captionbeside} + \end{figure} + Die Gesamtbreite ist also die aktuell verfügbare Breite + \PValue{\Macro{linewidth}}. Diese wird jedoch mit \PValue{2em} nach + außen verschoben. Der Titel oder die Beschreibung steht innen neben + der Abbildung. Damit erscheint die Abbildung selbst um 2\Unit{em} in + den Rand gerückt. + + Die Zentrierung der Bildbeschreibung mit + \begin{lstcode} + \KOMAoption{captions}{centeredbeside} + \end{lstcode} + zeigt \autoref{fig:maincls.captionbesidecentered}. Auch der Anfänger wird + erkennen, dass von dieser Ausrichtung normalerweise abzusehen ist. + \begin{figure} + \KOMAoption{captions}{centeredbeside} + \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, mittig]% + {Eine Bildbeschreibung weder über noch unter der Abbildung, + sondern mittig daneben}[i][\linewidth][2em]* + \fbox{\parbox[b][5\baselineskip][c]{.25\textwidth}{% + \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}} + \end{captionbeside} + \label{fig:maincls.captionbesidecentered} + \end{figure} + + Demgegenüber kann die Ausrichtung oben, die bei + \autoref{fig:maincls.captionbesidetop} zu sehen ist, durchaus verwendet + werden. Zur Verdeutlichung, wie man \Macro{raisebox} zur Verschiebung der + Grundlinie verwenden kann, sei hier ein komplettes Beispiel angegeben: + \begin{lstcode} + \documentclass[captions=topbeside]{scrbook} + \usepackage[ngerman]{babel} + \usepackage{graphics} + \begin{document} + \chapter{Ein Beispiel} + \begin{figure} + \begin{captionbeside}% + [Beispiel: Bildbeschreibung daneben, oben]% + {Eine Bildbeschreibung weder über noch unter + der Abbildung, sondern oben daneben}% + [i][\linewidth][2em]* + \raisebox{\dimexpr\baselineskip-\totalheight}{% + \includegraphics{beispielbild}}% + \end{captionbeside} + \label{fig:maincls.captionbesidetop} + \end{figure} + \end{document} + \end{lstcode} + Mit \Macro{dimexpr} wird hier eine \eTeX-Anweisung verwendet. Bei älteren + \LaTeX-Installationen, die noch nicht auf \eTeX{} basieren und bei denen + deshalb \Macro{dimexpr} nicht definiert ist, lädt man stattdessen das Paket + \Package{calc}. + \begin{figure} + \KOMAoption{captions}{topbeside} + \begin{captionbeside}[Beispiel: Bildbeschreibung daneben, oben]% + {Eine Bildbeschreibung weder über noch unter der Abbildung, + sondern oben daneben}[i][\linewidth][2em]* + \raisebox{\dimexpr\baselineskip-\totalheight}{% + \fbox{% + \parbox[b][5\baselineskip][c]{.25\textwidth}{% + \hspace*{\fill}\KOMAScript\hspace*{\fill}\par}}% + }% + \end{captionbeside} + \label{fig:maincls.captionbesidetop} + \end{figure} +\end{Example} +% +\EndIndex{Env}{captionbeside} + + +\begin{Declaration} + \FloatStyle{komaabove}\\ + \FloatStyle{komabelow} +\end{Declaration}% +\BeginIndex{Floatstyle}{komaabove}% +\BeginIndex{Floatstyle}{komabelow}% +Bei\OnlyAt{\Package{float}} Verwendung des +\Package{float}-Pakets\IndexPackage{float} wird das Aussehen der damit +definierten Gleitumgebungen allein vom \emph{float}-Stil bestimmt. Dies +schließt auch die Frage ein, ob mit Überschriften oder Unterschriften +gearbeitet wird. Im \Package{float}-Paket gibt es keinen vordefinierten Stil, +der im Aussehen dem von \KOMAScript{} entspricht und dieselben +Einstellmöglichkeiten (siehe unten) bietet. \KOMAScript{} definiert deshalb +zusätzlich die beiden Stile \PValue{komaabove} und \PValue{komabelow}. Diese +können bei Verwendung des \Package{float}-Pakets wie die dort definierten +Stile \PValue{plain}\IndexFloatstyle{plain}, +\PValue{boxed}\IndexFloatstyle{boxed} oder +\PValue{ruled}\IndexFloatstyle{ruled} aktiviert werden. Siehe dazu +\cite{package:float}. Beim Stil \PValue{komaabove} werden \Macro{caption}, +\Macro{captionabove} und \Macro{captionbelow} als Überschrift, beim Stil +\PValue{komabelow} als Unterschrift gesetzt.% +% +\EndIndex{Floatstyle}{komaabove}% +\EndIndex{Floatstyle}{komabelow}% + + +\begin{Declaration} + \Macro{captionformat} +\end{Declaration}% +\BeginIndex{Cmd}{captionformat}% +Bei {\KOMAScript} gibt es verschiedene Eingriffsmöglichkeiten, um die +Formatierung der Beschreibung zu ändern. Die Änderung der Schriftart +wurde bereits erläutert. Das oder die Trennzeichen zwischen dem Label +und dem eigentlichen Beschreibungstext sind im Makro +\Macro{captionformat} abgelegt. Abweichend von allen anderen +\Macro{\dots}format-Anweisungen ist hier also nicht der Zähler, +sondern nur die auf den Zähler folgenden Angaben enthalten. Die +Originaldefinition lautet: +\begin{lstcode}[belowskip=\dp\strutbox] + \newcommand*{\captionformat}{:\ } +\end{lstcode} +Auch diese kann mit \Macro{renewcommand} geändert werden. +\begin{Example} + Aus mir unerfindlichen Gründen wollen Sie als Trennzeichen + keinen Doppelpunkt gefolgt von einem Leerzeichen, sondern einen + Gedankenstrich einschließlich der notwendigen Leerzeichen. + Daher definieren Sie: +\begin{lstcode} + \renewcommand*{\captionformat}{~--~} +\end{lstcode} + Diese Definition sollten Sie beispielsweise in die Präambel Ihres + Dokuments stellen. +\end{Example} +% +\EndIndex{Cmd}{captionformat}% + + +\begin{Declaration} + \Macro{figureformat}\\ + \Macro{tableformat} +\end{Declaration}% +\BeginIndex{Cmd}{figureformat}% +\BeginIndex{Cmd}{tableformat}% +Es wurde schon darauf hingewiesen, dass \Macro{captionformat} keine +Formatierung für das Label selbst enthält. Dieses sollte nun +keineswegs über Umdefinierung der Anweisungen für die Zählerausgabe, +\Macro{thefigure} oder \Macro{thetable}, verändert werden. Eine solche +Umdefinierung hätte nämlich auch Auswirkungen auf die Ausgabe von +\Macro{ref} oder der Verzeichnisse. Stattdessen bietet {\KOMAScript} +auch hier zwei \Macro{\dots format}-Anweisungen. Diese sind wie folgt +vordefiniert: +\begin{lstcode} + \newcommand*{\figureformat}{\figurename~\thefigure\autodot} + \newcommand*{\tableformat}{\tablename~\thetable\autodot} +\end{lstcode} +Sie können ebenfalls mit \Macro{renewcommand} eigenen Anforderungen +angepasst werden. +\begin{Example} + Hin und wieder wird gewünscht, dass die Beschreibungstexte ganz ohne + Label und natürlich auch ohne Trennzeichen ausgegeben werden. Bei + {\KOMAScript} genügen folgende Definitionen, um dies zu erreichen: +\begin{lstcode} + \renewcommand*{\figureformat}{} + \renewcommand*{\tableformat}{} + \renewcommand*{\captionformat}{} +\end{lstcode} + Dabei ist jedoch zu beachten, dass die Nummerierung damit zwar nicht + ausgegeben, aber dennoch fortgezählt wird. Dies ist insbesondere dann + von Bedeutung, wenn die Umdefinierungen nur auf einzelne + \Environment{figure}- oder \Environment{table}-Umgebungen angewendet + werden. +\end{Example} +% +\EndIndex{Cmd}{figureformat}% +\EndIndex{Cmd}{tableformat}% + + +\begin{Declaration} + \Macro{setcapindent}\Parameter{Einzug}\\ + \Macro{setcapindent*}\Parameter{XEinzug}\\ + \Macro{setcaphanging} +\end{Declaration}% +\BeginIndex{Cmd}{setcapindent}% +\BeginIndex{Cmd}{setcapindent*}% +\BeginIndex{Cmd}{setcaphanging}% +Wie bereits erwähnt wurde, werden in den Standardklassen die +Beschreibungen nicht hängend gesetzt. Das heißt: In mehrzeiligen +Beschreibungen beginnt die zweite Zeile direkt unter dem Labeltext. +Es gibt bei den Standardklassen auch keinen Mechanismus, dies direkt +zu beeinflussen. Bei {\KOMAScript} werden hingegen alle Zeilen ab der +zweiten so weit eingerückt, dass diese nicht mehr unter dem Label, +»Abbildung~\dots:« oder »Tabelle~\dots:«, sondern unter dem +eigentlichen Text der ersten Zeile beginnen. + +Dieses Verhalten, das der Verwendung der Anweisung \Macro{setcaphanging} +entspricht, kann bei {\KOMAScript} jederzeit durch Verwendung der Anweisung +\Macro{setcapindent} oder \Macro{setcapindent*} geändert werden. Dabei gibt +der Parameter \PName{Einzug} an, wie weit ab der zweiten Zeile eingerückt +werden soll. Soll nach dem Label und vor dem Beschreibungstext noch ein +Zeilenumbruch erfolgen, so definieren Sie die Einrücktiefe \PName{XEinzug} der +Beschreibung stattdessen mit der Sternvariante der Anweisung: +\Macro{setcapindent*}. +Mit einem negativen \PName{Einzug} erreicht man hingegen, dass vor der +Beschreibung ebenfalls ein Umbruch erfolgt und nur die erste Zeile der +Beschreibung, nicht jedoch die folgenden, um den Betrag von \PName{Einzug} +eingerückt werden. + +Ob einzeilige Beschreibungen wie mehrzeilige Beschreibungen gesetzt werden +oder eine Sonderbehandlung erfahren, wird über die Option \Option{captions} +gewählt. Siehe hierzu die Erklärung zu den Werten \PValue{oneline} und +\PValue{nooneline} dieser Option auf +\autopageref{desc:maincls.option.captions.oneline}. + +\begin{Example} + Die Abbildungen~\ref{fig:maincls.caption.first} bis + \ref{fig:maincls.caption.last} zeigen die Auswirkungen unterschiedlicher + Einstellungen. Dabei wird deutlich, dass bei geringer Spaltenbreite der + komplett hängende Einzug unvorteilhaft ist. Der Quelltext der zweiten + Abbildung sei hier mit abgewandelter Unterschrift beispielhaft + wiedergegeben: +\begin{lstcode} + \begin{figure} + \setcapindent{1em} + \fbox{\parbox{.95\linewidth}{% + \centering\KOMAScript}} + \caption{Beispiel mit teilweise hängendem Einzug + ab der zweiten Zeile} + \end{figure} +\end{lstcode} + Wie zu sehen ist, kann die Formatierung also auch lokal innerhalb + der \Environment{figure}-Umgebung\IndexEnv{figure} geändert werden. Die + Änderung gilt dann nur für die eine Abbildung. Nachfolgende Abbildungen + werden wieder mit den Grundeinstellungen oder den globalen Einstellungen, + die Sie beispielsweise in der Dokumentpräambel vorgenommen haben, + gesetzt. Das gilt für Tabellen natürlich genauso. + \begin{figure} + \typeout{^^J--- Ignore underfull and overfull \string\hbox:} + \addtokomafont{caption}{\small} + \addtokomafont{captionlabel}{\bfseries} + \centering% + \begin{minipage}{.9\linewidth} + \begin{minipage}[t]{.48\linewidth}\sloppy + \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} + \caption[Beispiel: Bildunterschrift mit Voreinstellung]% + {Mit der Stan\-dard\-ein\-stell\-ung, also wie bei + Verwendung von \Macro{setcaphanging}} + \label{fig:maincls.caption.first} + \end{minipage} + \hspace{.02\linewidth} + \begin{minipage}[t]{.48\linewidth}\sloppy + \setcapindent{1em} + \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} + \caption[Beispiel: Bildunterschrift mit teilweise hängendem Einzug]% + {Mit teilweise häng"-endem Einzug ab der zweiten Zeile durch + Verwendung von \Macro{setcapindent}\PParameter{1em}} + \end{minipage} + \end{minipage} + + \vspace*{2ex}\noindent% + \begin{minipage}{.9\linewidth} + \begin{minipage}[t]{.48\linewidth}\sloppy + \setcapindent*{1em} + \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} + \caption[Beispiel: Bildunterschrift mit hängendem Einzug und Umbruch]% + {Mit hängendem Einzug ab der zweiten Zeile und Umbruch vor + der Beschreibung durch Verwendung von + \Macro{setcapindent*}\PParameter{1em}} + \end{minipage} + \hspace{.02\linewidth} + \begin{minipage}[t]{.48\linewidth}\sloppy + \setcapindent{-1em} + \fbox{\parbox{.95\linewidth}{\centering{\KOMAScript}}} + \caption[Beispiel: Bildunterschrift mit Einzug in den zweiten Zeile]% + {Mit Einzug lediglich in der zweiten Zeile und einem Umbruch + vor der Beschreibung durch Verwendung von + \Macro{setcapindent}\PParameter{-1em}} + \label{fig:maincls.caption.last} + \end{minipage} + \end{minipage} + \typeout{^^J--- Don't ignore underfull and overfull + \string\hbox:^^J} + \end{figure} +\end{Example} +% +\EndIndex{Cmd}{setcapindent}% +\EndIndex{Cmd}{setcapindent*}% +\EndIndex{Cmd}{setcaphanging}% + + +\begin{Declaration} + \Macro{setcapwidth}\OParameter{Ausrichtung}\Parameter{Breite}\\ + \Macro{setcapmargin}\OParameter{Rand links}\Parameter{Rand}\\ + \Macro{setcapmargin*}\OParameter{Rand innen}\Parameter{Rand} +\end{Declaration} +\BeginIndex{Cmd}{setcapwidth}% +\BeginIndex{Cmd}{setcapmargin}% +\BeginIndex{Cmd}{setcapmargin*}% +Mit \ChangedAt{v2.8q}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} Hilfe dieser drei Befehle kann die Breite und Anordnung +der Beschreibung beeinflusst werden. Normalerweise steht die gesamte Text- +oder Spaltenbreite für den Text der Beschreibung zur Verfügung. + +Mit der Anweisung \Macro{setcapwidth} kann diese \PName{Breite} +reduziert werden. Dabei gibt das obligatorische Argument die maximale +\PName{Breite} der Beschreibung an. Als optionales Argument kann genau +ein Buchstabe übergeben werden, der die horizontale Ausrichtung der +Beschreibung angibt. Die möglichen Ausrichtungen finden Sie in der +folgenden Liste. +\begin{labeling}[~--]{\PValue{o}} +\item[\PValue{l}] linksbündig +\item[\PValue{c}] zentriert +\item[\PValue{r}] rechtsbündig +\item[\PValue{i}] innen, also auf rechten Seiten linksbündig und auf + linken Seiten rechtsbündig +\item[\PValue{o}] außen, also auf rechten Seiten rechtsbündig und auf + linken Seiten linksbündig +\end{labeling} +Die Ausrichtung innen und außen entspricht im einseitigen Satz +linksbündig und rechtsbündig. Innerhalb von +\Package{longtable}\IndexPackage{longtable}-Tabellen funktioniert die +Ausrichtung innen und außen nicht korrekt. Insbesondere werden +Beschreibungen von Folgeseiten bei diesen Tabellen immer nach den +Beschreibungen der ersten Teiltabelle ausgerichtet. Dies ist ein +konzeptionelles Problem des Paketes \Package{longtable}. + +Mit der Anweisung \Macro{setcapmargin} kann statt der Breite der Beschreibung +ein \PName{Rand} angegeben werden, der neben der Beschreibung zusätzlich zum +normalen Textrand eingehalten werden soll. Sollen der Rand rechts und links +nicht identisch gewählt werden, kann mit dem optionalen Argument ein von +\PName{Rand} abweichender \PName{Rand links} von der Beschreibung eingestellt +werden. Bei der Sternvariante \Macro{setcapmargin*} wird statt \PName{Rand + links} im doppelseitigen Satz \PName{Rand innen} abweichend definiert. +Hier ergibt sich bei \Package{longtable}\IndexPackage{longtable}-Tabellen das +gleiche Problem wie bei der Ausrichtung außen oder innen bei der Anweisung +\Macro{setcapwidth}. Die Verwendung von \Macro{setcapmargin} oder +\Macro{setcapmargin*} aktiviert außerdem die Einstellung +\OptionValue{captions}{nooneline} (siehe +\autopageref{desc:maincls.option.captions.nooneline}) für die Beschreibungen, +die mit dieser Randeinstellung gesetzt werden. + +Man kann übrigens auch negative Werte für \PName{Rand} und \PName{Rand rechts} +oder \PName{Rand außen} angeben. Dadurch erreicht man, dass die Beschreibung +in den entsprechenden Rand hineinragt. + +Für Experten und versierte Anwender ist eine etwas trickreiche Anwendung für +\Macro{setcapwidth} in +\iffree{\cite{book:komascript}}{\autoref{cha:floattricks}, + \autopageref{cha:floattricks}} zu finden.% +% +\EndIndex{Cmd}{setcapwidth}% +\EndIndex{Cmd}{setcapmargin}% +\EndIndex{Cmd}{setcapmargin*}% + + +\begin{Declaration} + \Option{origlongtable} +\end{Declaration}% +\BeginIndex{Option}{origlongtable}% +\BeginIndex{Package}{longtable}% +Falls die Tabellenüberschriften des \Package{longtable}-Pakets (siehe +\cite{package:longtable}) von den \KOMAScript-Klassen nicht umdefiniert werden +sollen, kann die Option \Option{origlongtable} gesetzt werden. Diese Option +ist als optionales Argument von \Macro{documentclass} zu verwenden. Eine +Einstellung per \Macro{KOMAoptions} oder \Macro{KOMAoption} wird nicht +unterstützt. +% +\EndIndex{Package}{longtable}% +\EndIndex{Option}{origlongtable}% +% +\EndIndex{}{Abbildungen}% +\EndIndex{}{Tabellen}% +\EndIndex{}{Gleitumgebungen}% + + +\begin{Declaration} + \KOption{listof}\PName{Einstellung} +\end{Declaration} +\BeginIndex{Option}{listof~=\PName{Einstellung}}% +Normalerweise\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} werden die Verzeichnisse der Gleitumgebungen -- wie das +Tabellen"~\Index{Tabellen>Verzeichnis der} und das +Abbildungsverzeichnis\Index{Abbildungen>Verzeichnis der} -- nicht nummeriert +oder in das Inhaltsverzeichnis aufgenommen. In \autoref{sec:maincls.toc} wurde +dies bereits näher ausgeführt. Alternativ zu den dort erwähnten Einstellungen +\OptionValue{toc}{nolistof}\IndexOption{toc~=nolistof}, +\OptionValue{toc}{listof}\IndexOption{toc~=listof} und +\OptionValue{toc}{listofnumbered}\IndexOption{toc~=listofnumbered}, kann +dieses Verhalten auch aus Sicht der Verzeichnisse selbst gesehen werden. Daher +kann man die gleichen Ergebnisse auch mit den Einstellungen +\OptionValue{listof}{notoc}, \OptionValue{listof}{totoc} und +\OptionValue{listof}{numbered} erreichen. + +Dabei werden in der Voreinstellung für die Überschriften der Verzeichnisse die +oberste verfügbare Gliederungsebene unterhalb von \Macro{part} verwendet. Bei +\Class{scrbook} und \Class{scrreprt} ist das die Kapitelebene, bei +\Class{scrartcl} die Abschnittsebene. Mit Hilfe der Einstellung +\OptionValue{listof}{leveldown} kann hingegen die nächst tiefere +Gliederungsebene verwendet werden. +\begin{Example} + Sie wollen in einem Buch das Abbildungs- und das Tabellenverzeichnis als + Unterverzeichnisse eines gemeinsamen Verzeichnisses »Abbildungen und + Tabellen« setzen. Dazu verwenden Sie einfach: + \begin{lstcode} + \KOMAoption{listof}{leveldown} + \end{lstcode} + und dann an entsprechender Stelle Ihres Dokuments: + \begin{lstcode} + \addchap*{Abbildungs- und Tabellenverzeichnis} + \listoffigures + \listoftables + \end{lstcode} + Näheres zur Anweisung \Macro{addchap*} ist \autoref{sec:maincls.structure}, + \autopageref{desc:maincls.cmd.addchap*} zu entnehmen. +\end{Example} + +Normalerweise\ChangedAt{v2.8q}{% + \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} werden die +Verzeichnisse\Index{Abbildungen>Verzeichnis der}\Index{Tabellen>Verzeichnis + der} der Gleitumgebungen so formatiert, dass für die Nummer ein Raum fester +Breite verwendet wird. Dies entspricht der Verwendung der Einstellung +\OptionValue{listof}{graduated}\IndexOption{listof~=graduated}. + +Werden die Nummern sehr breit, weil beispielsweise sehr viele Tabellen +verwendet werden, so reicht der vorgesehene Platz irgendwann nicht mehr aus. +Vergleichbar zur Einstellung \OptionValue{toc}{flat}\IndexOption{toc~=flat} +für das Inhaltsverzeichnis bietet \KOMAScript{} daher die Einstellung +\OptionValue{listof}{flat}\IndexOption{listof~=flat} für die Verzeichnisse der +Gleitumgebungen. Dabei wird die Breite der Nummern automatisch ermittelt und +der Platz entsprechend angepasst. Bezüglich der Nebenwirkungen und +Funktionsweise gilt, was in \autoref{sec:maincls.toc}, +\autopageref{desc:maincls.option.toc.flat} für die Einstellung +\OptionValue{toc}{flat} erklärt wurde. Es sei an dieser Stelle jedoch nochmals +darauf hingewiesen, dass mit der Einstellung \OptionValue{listof}{flat} +mehrere \LaTeX-Durchläufe benötigt werden, bis die Verzeichnisse ihre +endgültige Form erhalten haben. + +Bei den Klassen \Class{scrbook} und +\Class{scrreprt}\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} fügt +\KOMAScript{} in der Voreinstellung bei jedem Kapitelanfang einen vertikalen +Abstand in die Verzeichnisse der Gleitumgebungen ein. Dieses Verhalten, das es +auch bei den Standardklassen gibt, dient dazu, diese Verzeichnisse nach +Kapiteln zu gruppieren. Es entspricht bei \KOMAScript{} der +Einstellung\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} +\OptionValue{listof}{chaptergapsmall}\IndexOption{listof~=chaptergapsmall}. +Dabei wird ein fester vertikaler Abstand von 10\Unit{pt} verwendet. Mit der +Einstellung +\OptionValue{listof}{chaptergapline}\IndexOption{listof~=chaptergapline} kann +man stattdessen einen vertikalen Abstand von einer Zeile erreichen. Mit +\OptionValue{listof}{nochaptergap}\IndexOption{listof~=nochaptergap} kann man +den vertikalen Abstand komplett abschalten. Eine Besonderheit stellt die +Einstellung +\OptionValue{listof}{chapterentry}\IndexOption{listof~=chapterentry} +dar. Dabei wird statt des Abstandes der Inhaltsverzeichniseintrag für das +Kapitel in das Verzeichnis der Gleitumgebungen eingefügt. Es wird darauf +hingewiesen, dass ein solcher Eintrag auch dann erfolgt, wenn das Kapitel +keine Gleitumgebung enthält. Eine noch direktere Beeinflussung, was in den +Verzeichnissen der Gleitumgebungen bei neuen Kapiteln geschehen soll, ist mit +der Option \Option{chapteratlists} zu erreichen, die nachfolgend erläutert +wird. + +Einen Überblick über alle möglichen Werte für die \PName{Einstellung} von +\Option{listof} ist in \autoref{tab:maincls.listof} zu finden. + +\begin{desctable} + \caption[{Mögliche Werte für Option \Option{listof}}]{Mögliche Werte für + Option \Option{listof} zur Einstellung von Form und Inhalt der + Verzeichnisse der Gleitumgebungen\label{tab:maincls.listof}}\\ + \Endfirsthead% + \caption[]{Mögliche Werte für Option \Option{listof} (\emph{Fortsetzung})}\\ + \Endhead% + \standardfoot% + \entry{\PValue{chapterentry}, \PValue{withchapterentry}}{% + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + einen Inhaltsverzeichniseintrag des Kapitels markiert.% + \IndexOption{listof~=chapterentry}}% + \entry{\PValue{chaptergapline}, \PValue{onelinechaptergap}}{% + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + einen Abstand von einer Zeile markiert.% + \IndexOption{listof~=chaptergapline}}% + \entry{\PValue{chaptergapsmall}, \PValue{smallchaptergap}}{% + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen durch + einen kleinen Abstand markiert.% + \IndexOption{listof~=chaptergapsmall}}% + \entry{\PValue{flat}, \PValue{left}}{% + Die Verzeichnisse der Gleitumgebungen erhalten eine tabellarische + Form. Die Gleitumgebungsnummern sind dabei die erste Spalte, der Titel die + zweite Spalte, die Seitenzahlen die dritte Spalte. Der Platz, der für die + Gleitumgebungsnummern reserviert wird, richtet sich nach dem benötigten + Platz des vorherigen \LaTeX-Laufs.% + \IndexOption{listof~=flat}}% + \entry{\PValue{graduated}, \PValue{indent}, \PValue{indented}}{% + Die Verzeichnisse der Gleitumgebungen erhalten eine hierarchische Form. Es + steht nur ein begrenzter Platz für die Gleitumgebungsnummern zur + Verfügung.% + \IndexOption{listof~=graduated}}% + \entry{\PValue{leveldown}}{% + Die Verzeichnisse werden um eine Gliederungsebene nach unten verschoben.% + \IndexOption{listof~=leveldown}}% + \entry{\PValue{nochaptergap}, \PValue{ignorechapter}}{% + Kapitelanfänge werden in den Verzeichnissen der Gleitumgebungen nicht + markiert.% + \IndexOption{listof~=nochaptergap}}% + \entry{\PValue{notoc}, \PValue{plainheading}}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten keinen Eintrag im Inhaltsverzeichnis.% + \IndexOption{listof~=notoc}}% + \entry{\PValue{numbered}, \PValue{totocnumbered}, \PValue{tocnumbered}, + \PValue{numberedtotoc}}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis und + werden nummeriert.% + \IndexOption{listof~=numbered}}% + \entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{% + Die Verzeichnisse der Gleitumgebungen, beispielsweise das Abbildungs"~ und + das Tabellenverzeichnis, erhalten einen Eintrag im Inhaltsverzeichnis, + ohne dass sie nummeriert werden.% + \IndexOption{listof~=totoc}}% +\end{desctable} +% +\EndIndex{Option}{listof~=\PName{Einstellung}}% + + +\begin{Declaration} + \Macro{listoftables}\\ + \Macro{listoffigures} +\end{Declaration}% +\BeginIndex{Cmd}{listoftables}% +\BeginIndex{Cmd}{listoffigures}% +Mit diesen Anweisungen kann ein Verzeichnis der Tabellen beziehungsweise der +Abbildungen ausgegeben werden. Änderungen, die Auswirkungen auf diese +Verzeichnisse haben, werden erst nach zwei \LaTeX{}-Läufen sichtbar. Die Form +der Verzeichnisse kann durch die Option \Option{listof} mit den Werten +\PValue{graduated} und \PValue{flat} beeinflusst werden (siehe +\autopageref{desc:maincls.option.listof}). Darüber hinaus wirken sich indirekt +die Werte \PValue{listof} und \PValue{listofnumbered} für die Option +\Option{toc} (siehe \autoref{sec:maincls.toc}, +\autopageref{desc:maincls.option.toc}), sowie die Werte \PValue{totoc} und +\PValue{totocnumbered} der oben erläuterten Option \Option{listof} auf die +Verzeichnisse aus. + +In der Regel findet man die Verzeichnisse der +Gleitumgebungen\Index{Gleitumgebungen}, also das +\index{Tabellen>Verzeichnis der}Tabellen- und das +Abbildungsverzeichnis\index{Abbildungen>Verzeichnis der}, unmittelbar nach dem +Inhaltsverzeichnis. In einigen Dokumenten wandern diese auch in den +Anhang. Der Autor bevorzugt jedoch die Platzierung unmittelbar nach dem +Inhaltsverzeichnis.% +% +\EndIndex{Cmd}{listoffigures}% +\EndIndex{Cmd}{listoftables}% + + +\LoadCommon{13}% \section{Randnotizen} + + +\section{Anhang} +\label{sec:maincls.appendix} +\BeginIndex{}{Anhang} + +Der Anhang eines Dokuments besteht im Wesentlichen aus den Anlagen zu einem +Dokument. Typische Teile eines Anhangs sind Literaturverzeichnis, +Stichwortverzeichnis und Begriffsverzeichnis. Alleine für diese Teile würde +man jedoch keinen Anhang beginnen, da diese Teile normalerweise schon von sich +aus eine Auszeichnung besitzen, die sie als Anhang erkennbar macht. Enthält +der Anhang aber weitere Teile wie beispielsweise zitierte Fremddokumente, +Endnoten oder Tafeln, so werden die zuvor genannten Teile ebenfalls im Anhang +gesetzt. + + +\begin{Declaration} + \Macro{appendix} +\end{Declaration}% +\BeginIndex{Cmd}{appendix}% +Der Anhang wird in den Standardklassen und den {\KOMAScript}-Klassen mit der +Anweisung \Macro{appendix} eingeleitet. Diese Anweisung schaltet unter anderem +die Kapitelnummerierung auf Großbuchstaben um und sorgt gleichzeitig dafür, +dass die Regeln für die Nummerierung der Gliederungsebenen nach \cite{DUDEN} +eingehalten werden. Diese Regeln sind in der Beschreibung der Option +\Option{numbers} in +\autoref{sec:maincls.structure}, +\autopageref{desc:maincls.option.numbers} näher erläutert. + +Die Form der Kapitelüberschriften\OnlyAt{\Class{scrbook}\and \Class{scrreprt}} +im Anhang wird durch die Optionen \Option{chapterprefix} und +\Option{appendixprefix} bestimmt. Näheres dazu ist +\autoref{sec:maincls.structure}, +\autopageref{desc:maincls.option.appendixprefix} zu entnehmen. + +Bitte beachten Sie, dass es sich bei \Macro{appendix} um eine +Anweisung und \emph{nicht} um eine Umgebung handelt! Die Anweisung +erwartet auch nicht etwa ein Argument. Die Kapitel beziehungsweise +Abschnitte des Anhangs werden ganz normal mit \Macro{chapter} und +\Macro{section} gesetzt.% +% +\EndIndex{Cmd}{appendix}% +% +\EndIndex{}{Anhang} + + +\section{Literaturverzeichnis} +\label{sec:maincls.bibliography} +\BeginIndex{}{Literaturverzeichnis} + +Das Literaturverzeichnis erschließt externe Quellen. In der Regel wird das +Literaturverzeichnis mit Hilfe des Programms \BibTeX{} aus einer Datei mit +datenbankähnlicher Struktur erzeugt. Dabei kann über den \BibTeX-Stil sowohl +die Form der Einträge als auch deren Sortierung verändert werden. Wird +zusätzlich ein Literaturpaket, beispielsweise +\Package{natbib}\IndexPackage{natbib}, +\Package{babelbib}\IndexPackage{bibalbib} oder +\Package{biblatex}\IndexPackage{biblatex} verwendet, so schwindet der Einfluss +von \KOMAScript{} auf das Literaturverzeichnis. In diesen Fällen ist unbedingt +die Anleitung des verwendeten Pakets zu beachten! Zur generellen Verwendung +eines Literaturverzeichnisses sei auf \cite{l2kurz} verwiesen. + + +\begin{Declaration} + \KOption{bibliography}\PName{Einstellung} +\end{Declaration} +\BeginIndex{Option}{bibliography~=\PName{Einstellung}}% +Als \PName{Einstellung}\ChangedAt{v3.00}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}} kann zunächst einmal jeder definierte +Formatierungsstil gewählt werden. Vordefiniert sind bei \KOMAScript{} zwei +solche Formatierungsstile für das Literaturverzeichnis. Diese sind jedoch +nicht zu verwechseln mit den unterschiedlichen Stilen für +\BibTeX\Index{BibTeX=\BibTeX}, die man mit \Macro{bibstyle} auswählt. Während +\BibTeX{} sowohl die Art der Sortierung als auch den Inhalt des +Literaturverzeichnisses bestimmt, können über die Einstellungen von +\KOMAScript{} nur grundlegende Eigenschaften des Literaturverzeichnisses oder +einige wenige Eigenschaften der Formatierung der Einträge beeinflusst werden. + +Mit \OptionValue{bibliography}{oldstyle}\IndexOption{bibliography~=oldstyle} +wird die kompakte Formatierung gewählt. Dabei führt die Anweisung +\Macro{newblock}\IndexCmd{newblock} in den einzelnen Einträgen lediglich zu +einem dehnbaren horizontalen Abstand. Der Name kommt daher, dass dies die +häufigste klassische Form eines Literaturverzeichnisses ist. Demgegenüber +erreicht man die etwas modernere, offene Form mit der Einstellung +\OptionValue{bibliography}{openstyle}\IndexOption{bibliography~=openstyle}. Der +Name kommt daher, dass hier die Anweisung \Macro{newblock} einen Absatz +einfügt. Die Einträge im Literaturverzeichnis werden so stärker +gegliedert. Sie sind weniger kompakt und deutlich aufgelockerter oder geöffnet. +Bezüglich der Möglichkeit, neue Formatierungsstile zu definieren, sei auf +\Macro{newbibstyle}, \autoref{sec:maincls-experts.experts}, +\autopageref{desc:maincls-experts.cmd.newbibstyle} verwiesen. + +Neben dem Formatierungsstil gibt es eine weitere Eigenschaft, die über +\PName{Einstellung} verändert werden kann. Das Literaturverzeichnis stellt +eine Art von Verzeichnis dar, bei der nicht der Inhalt des vorliegenden Werks +aufgelistet, sondern auf externe Inhalte verwiesen wird. Mit dieser Begründung +könnte man argumentieren, dass das Literaturverzeichnis ein eigenes Kapitel +bzw. einen eigenen Abschnitt darstellt und somit eine Nummer verdiene. Die +Einstellung \OptionValue{bibliography}{totocnumbered}% +\IndexOption{bibliography~=totocnumbered} führt genau dazu, einschließlich des +dann fälligen Eintrags im Inhaltsverzeichnis. Ich selbst bin der Meinung, +dass bei dieser Argumentation auch ein klassisches, kommentiertes +Quellenverzeichnis ein eigenes Kapitel wäre. Außerdem ist das +Literaturverzeichnis letztlich nichts, was man selbst geschrieben hat. Deshalb +verdient es allenfalls einen nicht nummerierten Eintrag im +Inhaltsverzeichnis, was mit der Einstellung +\OptionValue{bibliography}{totoc}\IndexOption{bibliography~=totoc} erreicht +wird. Die Voreinstellung, bei der das Literaturverzeichnis als nicht +nummeriertes Kapitel ohne eigenen Inhaltsverzeichniseintrag gesetzt wird, +entspricht +\OptionValue{bibliography}{nottotoc}\IndexOption{bibliography~=nottotoc}. Siehe +hierzu auch Option \Option{toc} in \autoref{sec:maincls.toc}, +insbesondere die Werte \PValue{bibliographynumbered}, \PValue{bibliography} +und \PValue{nobibliography} ab +\autopageref{desc:maincls.option.toc.bibliography}. + +Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von +\PName{bibliography} ist in \autoref{tab:maincls.bibliography} zu finden. Es +ist jedoch zu beachten, dass mit \Macro{newbibstyle}\IndexCmd{newbibstyle} +weitere Werte definiert werden können. + +\begin{table} + \caption[{Mögliche Werte für Option \Option{bibliography}}]{Vordefinierte + Werte für Option \Option{bibliography} zur Einstellung der Form des + Literaturverzeichnisses} + \label{tab:maincls.bibliography} + \begin{desctabular} + \pventry{nottotoc}{% + Das Literaturverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis + und wird auch nicht nummeriert.% + \IndexOption{bibliography~=nottotoc}}% + \pventry{oldstyle}{% + Es wird die klassische, kompakte Formatierung gewählt, bei der + \Macro{newblock}\IndexCmd{newblock} nur einen dehnbaren horizontalen + Abstand darstellt.% + \IndexOption{bibliography~=oldstyle}}% + \pventry{openstyle}{% + Es wird eine untergliederte, offene Formatierung gewählt, bei der + \Macro{newblock}\IndexCmd{newblock} einen Absatz darstellt.% + \IndexOption{bibliography~=openstyle}}% + \pventry{totoc}{% + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, + ohne dass es nummeriert wird.% + \IndexOption{bibliography~=totoc}}% + \pventry{totocnumbered}{% + Das Literaturverzeichnis erhält einen Eintrag im Inhaltsverzeichnis und + wird nummeriert.% + \IndexOption{bibliography~=totocnumbered}}% + \end{desctabular} +\end{table} +% +\EndIndex{Option}{bibliography~=\PName{Einstellung}}% + + +\begin{Declaration} + \Macro{setbibpreamble}\Parameter{Präambel} +\end{Declaration}% +\BeginIndex{Cmd}{setbibpreamble}% +Mit der Anweisung \Macro{setbibpreamble} kann eine Präambel für das +Literaturverzeichnis gesetzt werden. Bedingung +dafür ist, dass die Präambel vor der Anweisung zum Setzen des +Literaturverzeichnisses gesetzt wird. Dies muss nicht unmittelbar davor +sein. Es kann also beispielsweise am Anfang des Dokuments erfolgen. Ebenso wie +die Klassenoptionen \Option{bibtotoc} und \Option{bibtotocnumbered} kann die +Anweisung aber nur erfolgreich sein, wenn nicht ein Paket geladen wird, das +dies durch Umdefinierung der \Environment{thebibliography}-Umgebung +verhindert. Obwohl das \Package{natbib}-Paket\IndexPackage{natbib} nicht +freigegebene interne Makros von {\KOMAScript} verwendet, konnte erreicht +werden, dass \Macro{setbibpreamble} auch mit der aktuellen Version von +\Package{natbib} funktioniert (siehe \cite{package:natbib}). +\begin{Example} + Sie wollen darauf hinweisen, dass das Literaturverzeichnis nicht in + der Reihenfolge der Zitierung im Dokument, sondern alphabetisch + sortiert ist. Daher setzen Sie folgende Anweisung: +\begin{lstcode} + \setbibpreamble{Die Literaturangaben sind + alphabetisch nach den Namen der Autoren sortiert. + Bei mehreren Autoren wird nach dem ersten Autor + sortiert.\par\bigskip} +\end{lstcode} + Die Anweisung \Macro{bigskip}\IndexCmd{bigskip} sorgt dafür, dass + zwischen der Präambel und der ersten Literaturangabe ein großer + Zwischenraum gesetzt wird.% +\end{Example} +% +\EndIndex{Cmd}{setbibpreamble}% + + +\begin{Declaration} + \Macro{BreakBibliography}\Parameter{Unterbrechung} +\end{Declaration} +\BeginIndex{Cmd}{BreakBibliography}% +Diese\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}} Anweisung existiert nur, wenn die Umgebung +\Environment{thebibliography} nicht durch ein Paket neu definiert wurde. In +diesem Fall ist es möglich, mit dieser Anweisung das Literaturverzeichnis zu +unterbrechen. Die \PName{Unterbrechung} wird dann innerhalb einer Gruppe +ausgegeben. Eine solche \PName{Unterbrechung} könnte beispielsweise eine +Überschrift mit Hilfe von \Macro{minisec} sein. Leider gibt es bisher keine +Möglichkeit, diese Anweisung beispielsweise mit Hilfe eines speziellen Eintrags +in der Literaturdatenbank von \BibTeX{} erzeugen zu lassen. Daher kann sie +derzeit nur von Anwendern verwendet werden, die das Literaturverzeichnis +selbst editieren. Ihr Nutzen ist damit sehr beschränkt.% +% +\EndIndex{Cmd}{BreakBibliography}% + + +\begin{Declaration} + \Macro{AfterBibliographyPreamble}\Parameter{Anweisungen}\\ + \Macro{AtEndBibliography}\Parameter{Anweisungen} +\end{Declaration} +\BeginIndex{Cmd}{AfterBibliographyPreamble}% +\BeginIndex{Cmd}{AtEndBibliography}% +In\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} +einigen Fällen ist es nützlich, wenn man nach der Präambel des +Literaturverzeichnisses oder unmittelbar vor dem Ende des +Literaturverzeichnisses noch \PName{Anweisungen} ausführen kann. Dies ist mit +Hilfe dieser beiden Anweisungen möglich. +\begin{Example} + Sie wollen, dass das Literaturverzeichnis nicht im Blocksatz, sondern im + linksbündigen Flattersatz ausgegeben wird. Dies ist einfach mit: + \begin{lstcode} + \AfterBibliographyPreamble{\raggedright} + \end{lstcode} + zu erreichen. Sie können diese Anweisung an beliebiger Stelle vor dem + Literaturverzeichnis verwenden. Es wird jedoch empfohlen, sie in die + Präambel des Dokuments oder ein eigenes Paket zu schreiben. +\end{Example} +Die Realisierung dieser Anweisung bedarf bei Verwendung eines Pakets, das die +Umgebung für Literaturverzeichnisse umdefiniert, der Zusammenarbeit mit dem +entsprechenden Paket (siehe \autoref{sec:maincls-experts.coexistence}, +\autopageref{desc:maincls-experts.cmd.AfterBibliographyPreamble}).% +% +\EndIndex{Cmd}{AtEndBibliography}% +\EndIndex{Cmd}{AfterBibliographyPreamble}% +% +\EndIndex{}{Literaturverzeichnis} + + +\section{Stichwortverzeichnis} +\label{sec:maincls.index} +\BeginIndex{}{Stichwortverzeichnis} + + +Das Stichwortverzeichnis ist auch unter den Bezeichnungen Index oder Register +bekannt. Zur generellen Verwendung eines Stichwortverzeichnisses sei auf +\cite{l2kurz} sowie auf \cite{makeindex} und \cite{xindy} verwiesen. Wird ein +Paket verwendet, das selbst Anweisungen und Umgebungen für das +Stichwortverzeichnis zur Verfügung stellt, so schwindet eventuell der +Einfluss, den \KOMAScript{} auf dieses Verzeichnis hat. Dies gilt +beispielsweise bei Verwendung von \Package{index}\IndexPackage{index}, +nicht jedoch bei Verwendung von +\Package{splitidx}\IndexPackage{splitidx} (siehe +\cite{package:splitindex}). + + +\begin{Declaration} + \KOption{index}\PName{Einstellung}% +\end{Declaration} +\BeginIndex{Option}{index~=\PName{Einstellung}}% +\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% +In der Voreinstellung \OptionValue{index}{default}\IndexOption{index~=default} +ist das Stichwortverzeichnis ein nicht nummeriertes Kapitel ohne Eintrag im +Inhaltsverzeichnis. Da das Stichwortverzeichnis normalerweise in einem Buch +oder ähnlichen Dokument zuletzt steht, benötigt es eigentlich auch keinen +Inhaltsverzeichniseintrag. Wird dieser dennoch gewünscht, beispielsweise weil +wie in \iffree{dieser Anleitung}{diesem Buch} mit einem mehrgliedrigen +Stichwortverzeichnis gearbeitet wird, so kann dies mit der Einstellung +\OptionValue{index}{totoc}\IndexOption{index~=totoc} erreicht werden. Siehe +hierzu auch Option \Option{toc} mit dem Wert \PValue{index} in +\autoref{sec:maincls.toc} ab +\autopageref{desc:maincls.option.toc.index}. + +Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von +\PName{index} ist in \autoref{tab:maincls.index} zu finden. + +\begin{table} + \caption[{Mögliche Werte für Option \Option{index}}]{Mögliche Werte für + Option \Option{index} zur Einstellung des Stich\-wort\-verzeichnisses} + \label{tab:maincls.index} + \begin{desctabular} + \entry{\PValue{totoc}, \PValue{toc}, \PValue{notnumbered}}{% + Das Stichwortverzeichnis erhält einen Eintrag im Inhaltsverzeichnis, + ohne dass er nummeriert wird.% + \IndexOption{index~=totoc}}% + \entry{\PValue{default}, \PValue{nottotoc}, \PValue{plainheading}}{% + Das Stichwortverzeichnis erhält keinen Eintrag im Inhaltsverzeichnis.% + \IndexOption{index~=default}}% + \end{desctabular} +\end{table} +% +\EndIndex{Option}{index~=\PName{Einstellung}}% + + +\begin{Declaration} + \Macro{setindexpreamble}\Parameter{Präambel} +\end{Declaration}% +\BeginIndex{Cmd}{setindexpreamble}% +Analog zur Präambel des Literaturverzeichnisses können Sie auch das +Stichwortverzeichnis mit einer Präambel versehen. Dies findet häufig +dann Anwendung, wenn es mehr als einen Index gibt oder im Index +unterschiedliche Arten der Referenzierung durch unterschiedliche +Hervorhebung der Seitenzahlen markiert werden. +\begin{Example} + Sie haben ein Dokument, in dem Begriffe sowohl definiert als auch + verwendet werden. Die Seitenzahlen der Begriffsdefinitionen sind + fett dargestellt. Natürlich möchten Sie gerne auf diesen Umstand + hinweisen. Also setzen Sie eine entsprechende Präambel für den + Index: +\begin{lstcode} + \setindexpreamble{Alle \textbf{fett} gedruckten + Seitenzahlen sind Referenzen auf die Definition + des jeweiligen Begriffs. Demgegenüber geben normal + gedruckte Seitenzahlen die Seiten der Verwendung + des jeweiligen Begriffs wieder.\par\bigskip} +\end{lstcode} +\end{Example} + +Bitte beachten Sie, dass für die erste Seite des Index der Seitenstil +umgeschaltet wird. Welcher Seitenstil hierbei Verwendung findet, ist im Makro +\Macro{indexpagestyle} abgelegt (siehe \autoref{sec:maincls.pagestyle}, +\autopageref{desc:maincls.cmd.titlepagestyle}). + +Für die Erstellung, Sortierung und Ausgabe des Stichwortverzeichnisses +sind die üblichen Standard-\LaTeX-Pakete und Zusatzprogramme +zuständig. Von {\KOMAScript} werden genau wie von den Standardklassen +lediglich die grundlegenden Makros und Umgebungen dafür zur Verfügung +gestellt.% +% +\EndIndex{Cmd}{setindexpreamble}% +% +\EndIndex{}{Stichwortverzeichnis}% +% +\EndIndex{Class}{scrbook}% +\EndIndex{Class}{scrreprt}% +\EndIndex{Class}{scrartcl}% + +\endinput + +%%% Local Variables: +%%% mode: latex +%%% coding: iso-latin-1 +%%% TeX-master: "guide.tex" +%%% End: |