% % This is file `caption-deu.tex'. % % Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de) % % -------------------------------------------------------------------------- % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of LaTeX % version 2003/12/01 or later. % % This work has the LPPL maintenance status "maintained". % % This Current Maintainer of this work is Axel Sommerfeldt. % % This work consists of the files caption.ins, caption.dtx, caption2.dtx, % and ltcaption.dtx, the derived files caption.sty, caption2.sty, % caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex, % caption-eng.tex, and caption-rus.tex. % \NeedsTeXFormat{LaTeX2e}[1994/12/01] \ProvidesFile{caption-deu.tex}[2007/09/22 v3.1b Das caption-Paket] \hbadness=9999 \newcount\hbadness \hfuzz=20pt % Make TeX shut up. %\errorcontextlines=3 \documentclass[a4paper]{ltxdoc} \setlength\parindent{0pt} \setlength\parskip{\medskipamount} %%%\usepackage[T1]{fontenc} \usepackage{ifpdf} \ifpdf \usepackage{mathptmx,courier} \usepackage[scaled=0.90]{helvet} \addtolength\marginparwidth{15pt} \fi \usepackage[german]{babel} \IfFileExists{selinput.sty}% {\usepackage{selinput}\SelectInputMappings{adieresis={ä},germandbls={ß}}}% {\usepackage[latin1]{inputenc}} \usepackage{longtable,setspace} \usepackage{hypdoc}\hypersetup{german} \hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartview={}} \usepackage[listof=0,hypcap=false]{caption}[2007/09/01] \DeclareRobustCommand*\eTeX{\texorpdfstring {\leavevmode\hbox{$\varepsilon$}-\TeX}% {e-TeX}} \DeclareRobustCommand*\AmS{\texorpdfstring {{\protect\usefont{OMS}{cmsy}{m}{n}A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}}% {AMS}} \DeclareRobustCommand*\KOMAScript{\texorpdfstring {\textsf{K\kern.05em O\kern.05em M\kern.05em A\kern.1em-\kern.1em Script}}% {KOMA-Script}} \DeclareRobustCommand*\NTG{NTG} \DeclareRobustCommand*\SmF{SMF} \newcommand\NEW[2]{\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}} \usepackage{marvosym} \makeatletter \newcommand*\INFO{\@ifstar{\@INFO{}}{\@INFO{\vbox to \ht\strutbox}}} \newcommand*\@INFO[1]{\MARGINSYM{#1{\Huge\Info}}} \makeatother \font\manual=manfnt \newcommand*\DANGER{\MARGINSYM{\manual\char127}} \newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}} \DeclareCaptionFormat{myformat1}{#1#2\\#3} \newlength\myindention \DeclareCaptionFormat{myformat2}{#1#2\\\hspace*\myindention#3} \DeclareCaptionOption{myindention}{\setlength\myindention{#1}} \DeclareCaptionFormat{reverse}{#3#2#1} \DeclareCaptionFormat{llap}{\llap{#1#2}#3\par} \DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)} \DeclareCaptionLabelSeparator{fill}{\hfill} \newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}} \newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}} \newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}} \let\package\puresf \let\env\purett \let\opt\purett \newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}} \newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}} \newcommand*\version[2][]{$v#2$} \newcommand*\x{\discretionary{-}{}{}} \newcommand*\xx{\discretionary{}{}{}} \newenvironment{Options}[1]% {\list{}{\renewcommand{\makelabel}[1]{\texttt{##1}\hfil}% \settowidth{\labelwidth}{\texttt{#1\space}}% \setlength{\leftmargin}{\labelwidth}% \addtolength{\leftmargin}{\labelsep}}}% {\endlist} \newenvironment{Example}% {\ifvmode\else\unskip\par\fi \minipage{\linewidth}\smallskip}% {\smallskip\endminipage} \makeatletter \newcommand\example{\@ifstar {\@example{belowskip=\abovecaptionskip}}% {\@example{}}} \def\@example#1{% \@testopt{\@@example{#1}}{figure}} \long\def\@@example#1[#2]#3#4{% \begingroup \captionsetup{#1,size=small,margin={\leftmargini,10pt},#3}% \captionof{#2}[]{#4}% \endgroup} \makeatother \begin{document} \let\subsectionautorefname\sectionautorefname \let\subsubsectionautorefname\sectionautorefname \def\thispackage{das \package{caption}"=Paket} \def\Thispackage{Das \package{caption}"=Paket} \newcommand\NEWfeature{\NEW{Neues Feature}} \newcommand\NEWdescription{\NEW{Neue Beschreibung}} \makeatletter \newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}} \newcommand*\@Ref[2]{#1{#2}: \textit{"`\nameref{#2}"'}} \makeatother \newcommand*\See[1]{{\small (Siehe #1)}} \newcommand*\SeeUserDefined[1][]{\See{\Ref{declare}#1}} \def\TODO{\emph{-- Hier fehlt noch 'was --}} % --------------------------------------------------------------------------- % \GetFileInfo{caption-deu.tex} \let\docdate\filedate \GetFileInfo{caption.sty} \title{Setzen von Abbildungs- und Tabellenbeschriftungen mit dem caption-Paket\texorpdfstring{\thanks{% Dieses Paket hat die Versionsnummer \fileversion, zuletzt ge"andert am \filedate.}}{}} \author{Axel Sommerfeldt\\ \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}} \date{\docdate} \maketitle % --------------------------------------------------------------------------- % \begin{abstract} \Thispackage\ bietet einem Mittel und Wege das Erscheinungsbild der Bildunterschriften und Tabellen"uberschriften den eigenen W"unschen bzw.\ bestimmten Vorgaben anzupassen. Hierbei wurde viel Wert auf die reibungslose Zusammenarbeit und in die Integration anderer Dokumentenklassen und Pakete gelegt.\footnote{F"ur die Version 3.0 dieses Paketes wurde die Benutzerschnittstelle zusammen mit Steven D. Cochran und Frank Mittelbach komplett "uberarbeitet.} \end{abstract} \newcommand\exampletext{% Die auf die Rotationsfrequenz des Innenzylinders normierten Eigenfrequenzen der gefundenen Grundmoden der Taylor"=Str"omung f"ur \mbox{$\eta = 0.5$}. %\\ (Die azimutale Wellenzahl ist mit $m$ bezeichnet.)} % --------------------------------------------------------------------------- % \section*{Einleitung} Mit |\caption| gesetzte Bildunterschriften und Tabellenüberschriften werden von den Standard"=Dokumentenklassen eher stiefmütterlich behandelt. In der Regel schlicht als ganz normaler Absatz gesetzt, ergibt sich keine signifikante optische Abgrenzung vom eigentlichen Text, wie z.B. hier: \example*{size=normalsize,margin=0pt}{\exampletext} Es sollte aber eine Möglichkeit geben, diesem Umstand abzuhelfen. Es wäre zum Beispiel nett, wenn man den Text der Unterschrift etwas kleiner gestalten, extra Ränder festlegen oder den Zeichensatz des Bezeichners dem der Kapitelüberschriften anpassen könnte. So in etwa: \example*{size=small,margin=10pt,labelfont=bf,labelsep=endash}{\exampletext} Mit Hilfe dieses Paketes können Sie dies leicht bewerkstelligen; es sind viele vorgegebene Parameter einstellbar, Sie können aber auch eigene Gestaltungsmerkmale einfließen lassen. % --------------------------------------------------------------------------- % \clearpage \section*{Vorläufige Dokumentation} Diese Anleitung beschreibt leider noch nicht alle Fassetten und Möglichkeiten, die einem \thispackage\ bietet. Ich werde mich bemühen, jeden Monat eine etwas vollständigere Fassung bereitzustellen; die jeweile aktuelle Fassung kann \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf}% {hier} bezogen werden.\par\bigskip % --------------------------------------------------------------------------- % %\clearpage \tableofcontents % --------------------------------------------------------------------------- % \clearpage \section{Verwendung des Paketes} \label{usage} \DescribeMacro{\usepackage} Mittels \begin{quote} |\usepackage|\oarg{Optionen}|{caption}[|\texttt{\filedate}|]| \end{quote} in dem Vorspann des Dokumentes wird das \thispackage\ Paket eingebunden, die Optionen legen hierbei das Aussehen der "Uber- und Unterschriften fest. So w"urde z.B. \begin{quote} |\usepackage[margin=10pt,font=small,labelfont=bf,|\\ | labelsep=endash]{caption}|% %|[|\texttt{\filedate}|]| \end{quote} zu dem obrigen Ergebnis mit Rand, kleinerem Zeichensatz und fetter Bezeichnung f"uhren. \DescribeMacro{\captionsetup} Eine "Anderung der Parameter ist auch zu einem sp"ateren Zeitpunkt jederzeit mittels des Befehls \begin{quote} |\captionsetup|\oarg{Typ}\marg{Optionen} \end{quote} m"oglich. So sind z.B. die Befehlssequenzen \begin{quote} |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}| \end{quote} und \begin{quote} |\usepackage{caption}|\\ |\captionsetup{margin=10pt,font=small,labelfont=bf}| \end{quote} in ihrer Wirkung identisch. Weiterhin gilt zu beachten, da"s sich die Verwendung von |\captionsetup| innerhalb von Umgebungen nur auf die Umgebung selber auswirkt, nicht aber auf den Rest des Dokumentes. M"ochte man also z.B. die automatische Zentrierung der Abbildungsunterschrift nur in einem konkreten Falle ausschalten, so kann dies mit \begin{quote} |\begin{figure}|\\ | |\ldots\\ | \captionsetup{singlelinecheck=off}|\\ | \caption{|\ldots|}|\\ |\end{figure}| \end{quote} geschehen, ohne da"s die restlichen Abbildungsunterschriften hiervon beeintr"achtigt werden. (Der optionale Parameter \meta{Typ} wird in \Ref{commands} behandelt.) % --------------------------------------------------------------------------- % \pagebreak[4] \section{Optionen} \label{options} \def\OptionLabel{RaggedRight} \def\UserDefined{\ldots} % --------------------------------------------------------------------------- % \subsection{Formatierung} \label{formats} \DescribeMacro{format=} Eine Abbildungs- oder Tabellenbeschriftung besteht im wesentlichen aus drei Teilen: Dem Bezeichner (etwa "`Abbildung 3"'), dem Trenner (etwa "`:\textvisiblespace"') und dem eigentlichen Text. Mittels der Option \begin{quote} |format=|\meta{Name} \end{quote} wird festgelegt, wie diese drei Teile zusammengesetzt werden. F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar:%\footnote{Es gibt %hier wie auch bei vielen anderen Optionen die M"oglichkeit, auch eigene %Formate, Zeichens"atze etc.\ zu definieren. Wie dies geht wird in Abschnitt %\ref{declare}: \textit{"`Eigene Erweiterungen"'} dargelegt.} \begin{Options}{\OptionLabel} \item[plain]%\NEWdescription{v3.0h} Die Beschriftung wird als gew"ohnlicher Abschnitt gesetzt. \item[hang] Der Text wird so gesetzt, da"s er an dem Bezeichner "`h"angt"', d.h.~der Platz unter dem Bezeichner und dem Trenner bleibt leer. \item[\UserDefined] Eigene Formate k"onnen mittels |\DeclareCaptionFormat| definiert werden. \SeeUserDefined \end{Options} \begin{Example} Ein Beispiel: Die Angabe der Option \begin{quote} |format=hang| \end{quote} f"uhrt zu Abbildungsunterschriften der Art \example{format=hang}{\exampletext} \end{Example} \DescribeMacro{indention=} Bei beiden Formaten (\texttt{plain} und \texttt{hang}) kann der Einzug der Beschriftung ab der zweiten Textzeile angepasst werden, dies geschieht mit Hilfe der Option \begin{quote} |indention=|\meta{Einzug}\quad, \end{quote} wobei anstelle von \meta{Einzug} jedes beliebige feste Ma"s angegeben werden kann. Zwei Beispiele: \begin{Example} \begin{quote} |format=plain,indention=.5cm| \end{quote} \captionsetup{aboveskip=0pt} \example{format=plain,indention=.5cm}{\exampletext} \end{Example} \begin{Example} \begin{quote} |format=hang,indention=-0.5cm| \end{quote} \captionsetup{aboveskip=0pt} \example{format=hang,indention=-0.5cm}{\exampletext} \end{Example} %\pagebreak[3] \DescribeMacro{labelformat=} Mittels der Option \nopagebreak[3] \begin{quote} |labelformat=|\meta{Name} \end{quote} \nopagebreak[3] %\NEWdescription{v3.0e} wird die Zusammensetzung des Bezeichners festgelegt. F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar: \begin{Options}{\OptionLabel} \item[default] Der Bezeichner wird wie von der verwendeten Dokumentenklasse vorgegeben gesetzt, "ublicherweise ist dies der Name und die Nummer, getrennt durch ein Leerzeichen (wie \texttt{simple}). (Dies ist das Standardverhalten.) \item[empty] Der Bezeichner ist leer. (Diese Option macht in der Regel nur in Verbindung mit anderen Optionen -- wie etwa \texttt{labelsep=none} -- Sinn.) \item[simple] Der Bezeichner ist aus dem Namen und der Nummer zusammengesetzt. \item[parens] Die Nummer des Bezeichners wird in runde Klammern gesetzt. \item[\UserDefined] Eigene Formate k"onnen mittels |\DeclareCaptionLabelFormat| definiert werden. \SeeUserDefined \end{Options} \begin{Example} Ein Beispiel: Die Optionen \begin{quote} |labelformat=parens,labelsep=quad| \end{quote} f"uhren zu Abbildungsunterschriften der Art \example{labelformat=parens,labelsep=quad}{\exampletext} \end{Example} \DescribeMacro{labelsep=} Mittels der Option \begin{quote} |labelsep=|\meta{Name} \end{quote} wird die Zusammensetzung des Trenners festgelegt. F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar: \begin{Options}{\OptionLabel} \item[none] Der Trenner ist leer. (Diese Option macht in der Regel nur in Verbindung mit anderen Optionen -- wie etwa \texttt{labelformat=empty} -- Sinn.) \item[colon] Der Trenner besteht aus einem Doppelpunkt und einem Leerzeichen. \item[period] Der Trenner besteht aus einem Punkt und einem Leerzeichen. \item[space] Der Trenner besteht lediglich aus einem einzelnen Leerzeichen. \item[quad] Der Trenner besteht aus einem |\quad|. \item[newline] Als Trenner wird ein Zeilenumbruch verwendet. \item[endash]%\NEWfeature{v3.0h} Als Trenner wird ein Gedankenstrich verwendet. \item[\UserDefined] Eigene Trenner k"onnen mittels |\DeclareCaptionLabelSeparator| definiert werden. \SeeUserDefined \end{Options} Drei Beispiele: \begin{Example} \begin{quote} |labelsep=period| \end{quote} \captionsetup{aboveskip=0pt} \example{labelsep=period}{\exampletext} \end{Example} \begin{Example} \begin{quote} |labelsep=newline,singlelinecheck=false| \end{quote} \captionsetup{aboveskip=0pt} \example{labelsep=newline,singlelinecheck=false}{\exampletext} \end{Example} \begin{Example} \begin{quote} |labelsep=endash| \end{quote} \captionsetup{aboveskip=0pt} \example{labelsep=endash}{\exampletext} \end{Example} % --------------------------------------------------------------------------- % \subsection{Textausrichtung} \label{justification} \DescribeMacro{justification=} Mittels der Option \begin{quote} |justification=|\meta{Name} \end{quote} wird die Ausrichtung des Textes festgelegt. F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar: \begin{Options}{\OptionLabel} \item[justified] Der Text wird als Blocksatz gesetzt. \item[centering] Der Text wird zentriert gesetzt. % \item[Centering] % Der Text wird zentriert gesetzt. Hierf"ur wird jedoch im Gegensatz % zu \texttt{centering} der Befehl |\Centering| des \package{ragged2e}-Paketes % verwendet, der \LaTeX\ das Trennen der Worte erlaubt. \item[centerlast] Lediglich die letzte Zeile des Textes wird zentriert gesetzt. \item[centerfirst] Lediglich die erste Zeile des Textes wird zentriert gesetzt. \item[raggedright] Der Text wird linksb"undig gesetzt. % \item[RaggedRight] % Der Text wird linksb"undig mit Hilfe des \package{ragged2e}-Paketes gesetzt. \item[RaggedRight] Der Text wird ebenfalls linksb"undig gesetzt. Hierf"ur wird jedoch im Gegensatz zu \texttt{raggedright} der Befehl |\RaggedRight| des \package{ragged2e}-Paketes verwendet, der \LaTeX\ das Trennen der Worte erlaubt. \item[raggedleft] Der Text wird rechtsb"undig gesetzt. % \item[RaggedLeft] % Der Text wird rechtsb"undig mit Hilfe des \package{ragged2e}-Paketes gesetzt. \item[\UserDefined] Eigene Ausrichtungen k"onnen mittels |\DeclareCaptionJustification| definiert werden. \SeeUserDefined \end{Options} Einige Beispiele: \begin{Example} \begin{quote} |justification=centerlast| \end{quote} \captionsetup{aboveskip=0pt} \example{justification=centerlast}{\exampletext} \end{Example} \begin{Example} \begin{quote} |format=hang,justification=raggedright| \end{quote} \captionsetup{aboveskip=0pt} \example{format=hang,justification=raggedright}{\exampletext} \end{Example} \begin{Example} \begin{quote} |format=hang,justification=RaggedRight| \end{quote} \captionsetup{aboveskip=0pt} \example{belowskip=\abovecaptionskip,format=hang,justification=RaggedRight}{\exampletext} \end{Example} \begin{Example} \begin{quote} |labelsep=newline,justification=centering| \end{quote} \captionsetup{aboveskip=0pt} \example{belowskip=\abovecaptionskip,labelsep=newline,justification=centering}{\exampletext} \end{Example} \DescribeMacro{singlelinecheck=} In den Standard"=Dokumentenclassen |article|, |report| und |book| sind die Ab\-bildungs- und Tabellenbeschriftungen so realisiert, da"s sie automatisch zentriert werden, wenn sie lediglich aus einer einzigen Textzeile bestehen: \example*{}{Eine kurze Beschriftung.} %\example{belowskip=\abovecaptionskip}{% % Eine lange Beschriftung, die gen"ugend Text enth"alt, um l"anger als % eine einzelne Zeile zu sein.} \INFO Diesen Mechanismus "ubernimmt \thispackage\ und ignoriert damit in der Regel bei solch kurzen Beschriftungen die mittels der Optionen |format=| und |justification=| eingestellte Textausrichtung. Dieses Verhalten kann jedoch mit der Option \begin{quote} |singlelinecheck=|\meta{bool} \end{quote} reguliert werden. Setzt man f"ur \meta{bool} entweder |false|, |no|, |off| oder |0| ein, so wird der Zentrierungsmechnismus au"ser Kraft gesetzt. Die obrige, kurze Abbildungsunterschrift w"urde z.B. nach Angabe der Option \begin{quote} |singlelinecheck=false| \end{quote} so aussehen: \begingroup \captionsetup{type=figure} \ContinuedFloat \example*{singlelinecheck=false}{Eine kurze Beschriftung.} \endgroup Setzt man f"ur \meta{bool} hingegen |true|, |yes|, |on| oder |1| ein, so wird die automatische Zentrierung wieder eingeschaltet. (Standardm"a"sig ist sie eingeschaltet.) % --------------------------------------------------------------------------- % \subsection{Zeichens"atze} \label{fonts} \DescribeMacro{font=} \DescribeMacro{labelfont=} \DescribeMacro{textfont=} Das \thispackage-Paket kennt 3 Zeichens"atze: Denjenigen f"ur die gesammte Beschriftung (|font|), denjenigen, der lediglich auf den Bezeichner und den Trenner angewandt wird (|labelfont|), sowie denjenigen, der lediglich auf den Text wirkt (|textfont|). So lassen sich die unterschiedlichen Teile der Beschriftung individuell mittels \begin{quote}\begin{tabular}{@{}r@{}ll} |font=| & \marg{Zeichensatzoptionen} & ,\\ |labelfont=| & \marg{Zeichensatzoptionen} & und\\ |textfont=| & \marg{Zeichensatzoptionen} & \\ \end{tabular}\end{quote} \nopagebreak[3] anpassen. \pagebreak[3] Als \meta{Zeichensatzoptionen} sind eine Kombination aus folgendem erlaubt: \begin{Options}{\OptionLabel} \item[scriptsize] {\scriptsize Sehr kleine Schrift} \item[footnotesize] {\footnotesize Fu"snotengr"o"se} \item[small] {\small Kleine Schrift} \item[normalsize] {\normalsize Normalgro"se Schrift} \item[large] {\large Gro"se Schrift} \item[Large] {\Large Gr"o"sere Schrift} \item[up] {\upshape Upright Schriftart} \item[it] {\itshape Italic Schriftart} \item[sl] {\slshape Slanted Schriftart} \item[sc] {\scshape Small Caps Schriftart} \item[md] {\mdseries Medium Schriftserie} \item[bf] {\bfseries Bold Schriftserie} \item[rm] {\rmfamily Roman Schriftfamilie} \item[sf] {\sffamily Sans Serif Schriftfamilie} \item[tt] {\ttfamily Typewriter Schriftfamilie} \item[singlespacing] |\singlespacing| (siehe \package{setspace}-Paket) \item[onehalfspacing] |\onehalfspacing| \item[doublespacing] |\doublespacing| \item[\UserDefined] Eigene Zeichensatzoptionen k"onnen mittels |\DeclareCaptionFont| definiert werden. \SeeUserDefined \end{Options} Wird lediglich eine einzelne Zeichensatzoption ausgew"ahlt, k"onnen die geschweiften Klammern entfallen, d.h.~die Optionen %\begin{quote} |font={small}| %\end{quote} und %\begin{quote} |font=small| %\end{quote} sind in ihrer Wirkung identisch. Beispiele: \begin{Example} \begin{quote} |font={small,it},labelfont=bf| \end{quote} \captionsetup{aboveskip=0pt} \example{font={small,it},labelfont=bf}{\exampletext} \end{Example} \begin{Example} \begin{quote} |font=small,labelfont=bf,textfont=it| \end{quote} \captionsetup{aboveskip=0pt} \example{font=small,labelfont=bf,textfont=it}{\exampletext} \end{Example} % --------------------------------------------------------------------------- % \subsection{R"ander und Abs"atze} \label{margins} \DescribeMacro{margin=} \DescribeMacro{width=} F"ur die Abbildungs- und Tabellenbeschriftungen kann \emph{entweder} ein extra Rand \emph{oder} eine feste Breite festgelegt werden. Dies geschieht mit \begin{quote}\begin{tabular}{@{}r@{}ll} |margin=| & \meta{Rand} & \emph{oder}\\ |width=| & \meta{Breite} & \\ \end{tabular}\end{quote} In beiden F"allen wird die Beschriftung zentriert, d.h.~der linke und rechte Rand sind immer gleich gro"s. Zwei Beispiele hierzu: \begin{Example} \begin{quote} |margin=10pt| \end{quote} \captionsetup{aboveskip=0pt} \example{margin=10pt}{\exampletext} \end{Example} \begin{Example} \begin{quote} |width=.75\textwidth| \end{quote} \captionsetup{aboveskip=0pt} \example{width=.75\textwidth}{\exampletext} \end{Example} \DescribeMacro{parskip=} Diese Option wirkt auf Abbildungs- oder Tabellenbeschriftungen, die aus mehr als einem Absatz bestehen; sie legt den Abstand zwischen den Abs"atzen fest. \begin{quote} |parskip=|\meta{Abstand zwischen Abs"atzen} \end{quote} Ein Beispiel: \begin{Example} \begin{quote} |margin=10pt,parskip=5pt| \end{quote} \captionsetup{aboveskip=0pt} \example{margin=10pt,parskip=5pt}{% Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.\par Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.} \end{Example} \DescribeMacro{hangindent=} Die Option \begin{quote} |hangindent=|\meta{Einzug} \end{quote} legt einen Einzug f"ur alle Zeilen au"ser der jeweils ersten des Absatzes fest. Besteht die Beschriftung lediglich aus einem einzelnen Absatz, so ist die Wirkung mit der Option |indention=|\meta{Einzug} identisch, bei mehreren Abs"atzen zeigt sich jedoch der Unterschied: \begin{Example} \begin{quote} |format=hang,indention=-.5cm| \end{quote} \captionsetup{aboveskip=0pt} \example{format=hang,indention=-.5cm}{% Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.\par Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.} \end{Example} \begin{Example} \begin{quote} |format=hang,hangindent=-.5cm| \end{quote} \captionsetup{aboveskip=0pt} \example{format=hang,hangindent=-.5cm}{% Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.\par Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text, so da"s die Auswirkungen der Optionen deutlich werden.} \end{Example} % --------------------------------------------------------------------------- % \subsection{Stile} \label{style} \DescribeMacro{style=} Eine geeignete Kombination aus den bisher vorgestellten Optionen wird \textit{Stil} genannt; dies ist in etwa mit dem Seitenstil vergleichbar, den man bekannterma"sen mit |\pagestyle| einstellen kann. Einen vordefinierten Abbildungs- und Tabellenbeschriftungsstil kann man mit der Option \begin{quote} |style=|\meta{Stil} \end{quote} ausw"ahlen. \Thispackage\ definiert zwei Stile: |base| und |default|. \NEWfeature{v3.1} Der Stil |base| setzt alle bisher vorgestellten Optionen auf die Belegung zurück, die das Aussehen der Beschriftungen der Standard"=\LaTeX"=Dokumentenklassen |article|, |report| und |book| repräsentiert. D.h.~die Angabe der Option \begin{quote} |style=default| \end{quote} entspricht den Optionen \begin{quote} |format=plain,labelformat=default,labelsep=colon,|\\ |justification=justified,font=,labelfont=,|\\ |textfont=,margin=0pt,indention=0pt,parindent=0pt|\\ |hangindent=0pt,singlelinecheck=true| \end{quote} (Aber |justification=centering| wird automatisch gewählt werden, wenn die Beschriftung in eine einzelne Zeile passt.) Der Stil |default| hingegen folgt den Standardwerten der verwendeten Dokumentenklasse. Dieser Stil wird vorausgewählt und entspricht den Optionen \begin{quote} |format=default,labelformat=default,labelsep=default,|\\ |justification=default,font=default,labelfont=default,|\\ |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\ |hangindent=0pt,singlelinecheck=true|\quad. \end{quote} (Aber |justification=centering| und |format=plain| wird automatisch gewählt werden, wenn die Beschriftung in eine einzelne Zeile passt.) Wenn also eine der drei Standard"=\LaTeX"=Dokumentenklassen verwendet wird, zeigen |base| und |default| auf (fast) die gleichen Einstellungen. \emph{Hinweis:} Eigene Stile k"onnen mittels |\DeclareCaptionStyle| definiert werden. \SeeUserDefined % --------------------------------------------------------------------------- % \subsection{Abst"ande} \label{skips} \DescribeMacro{aboveskip=} \DescribeMacro{belowskip=} Die vertikalen Abstände vor und nach der Beschriftung werden von |\abovecaptionskip| und |\belowcaptionskip| kontrolliert. Die Standard"=\LaTeX"=Klassen |article|, |report| und |book| belegen den Abstand |\abovecaptionskip| mit |10pt| und |\belowcaptionskip| mit |0pt|, andere Dokumentenklassen ggf.~ mit anderen Werten. \pagebreak[3] Beide Abst"ande lassen sich gew"ohnlich mit |\setlength| "andern, aber auch mit den \thispackage-Optionen \nopagebreak[3] \begin{quote}\begin{tabular}{@{}r@{}ll} |aboveskip=| & \meta{Abstand nach oben} & und\\ |belowskip=| & \meta{Abstand nach unten} & .\\ \end{tabular}\end{quote} \DescribeMacro{position=} Die sture Anwendung von |\abovecaptionskip| und |\belowcaptionskip| bei Beschriftungen birgt einen gro"sen Nachteil: Ist die Beschriftung \emph{"uber} und nicht \emph{unter} der Abbildung oder Tabelle (wie bei Tabellen durchaus "ublich), so ist die Vorbelegung dieser beiden Abst"ande nicht mehr sinnvoll, da hier kein Abstand zwischen der Beschriftung und der Tabelle gesetzt wird. (Wir erinnern uns: |\belowcaptionskip| ist auf |0pt|, also kein Abstand, vorbelegt.) Man vergleiche: \begin{Example} \captionsetup{position=b} \begin{minipage}[c]{.5\linewidth}% % \captionsetup{aboveskip=0pt}% \captionof{table}{Eine Tabelle}% \centering\begin{tabular}{ll}% A & B \\% C & D \\% \end{tabular}% \end{minipage}% \begin{minipage}[c]{.5\linewidth}% \centering\begin{tabular}{ll}% A & B \\% C & D \\% \end{tabular}% \captionof{table}{Eine Tabelle}% \end{minipage}% \end{Example} Mit Hilfe des Parameters |position| kann man jedoch festlegen, wie \LaTeX\ die Beschriftung behandeln soll, ob als \mbox{\emph{"Uber}schrift} oder als \mbox{\emph{Unter}schrift}: \begin{quote} |position=top|\quad(oder |position=above|) \end{quote} gibt an, da"s die Abst"ande so gew"ahlt werden, da"s sie f"ur \mbox{\emph{"Uber}schriften} sinnvoll gew"ahlt sind und \begin{quote} |position=bottom|\quad(oder |position=below|) \end{quote} gibt an, da"s die Abst"ande so gew"ahlt werden, da"s sie f"ur \mbox{\emph{"Uber}schriften} sinnvoll gew"ahlt sind. (Dies ist die Standardeinstellung, allerdings nicht f"ur |longtable|s.) F"ugt man nun ein |\captionsetup{position=top}| in die linke Tabelle vor dem |\caption| Befehl ein, so ergeben sich im Vergleich zwischen "Uberschrift und Unterschrift stimmige Abst"ande: \begin{Example} \begin{minipage}[c]{.5\linewidth}% \captionsetup{position=t}% \captionof{table}{Eine Tabelle}% \centering\begin{tabular}{ll}% A & B \\% C & D \\% \end{tabular}% \end{minipage}% \begin{minipage}[c]{.5\linewidth}% \centering\begin{tabular}{ll}% A & B \\% C & D \\% \end{tabular}% \captionsetup{position=b} \captionof{table}{Eine Tabelle}% \end{minipage}% \end{Example} (Technisch ist dies so realisiert, da"s bei "Uberschriften die Ab\-st"an\-de |\abovecaptionskip| und |\belowcaptionskip| vertauscht werden, so da"s |\abovecaptionskip| immer derjenige Abstand ist, der zwischen Tabelle und Beschriftung zur Anwendung kommt.) Sinnvoll l"a"st sich diese Option insbesondere zusammen mit dem optionalen Parameter bei |\captionsetup| anwenden: \See{auch \Ref{commands}} \begin{quote} |\captionsetup[table]{position=top}| \end{quote} bewirkt, da"s bei allen Tabellen die Beschriftung bzgl.~der Abst"ande als "Uberschrift behandelt wird. \DescribeMacro{tableposition=}%\NEWfeature{v3.0a} Da dies eine sehr gebr"auchliche Einstellung ist, stellt das \thispackage"=Paket diesen Befehl auch als abk"urzende Option f"ur |\usepackage| zur Verf"ugung: \begin{quote} |\usepackage[|\ldots|,tableposition=top]{caption}| \end{quote} entspricht \begin{quote} |\usepackage[|\ldots|]{caption}|\\ |\captionsetup[table]{position=top}| \end{quote} % --------------------------------------------------------------------------- % \pagebreak[3] \section{Befehle} \label{commands} \DescribeMacro{\caption} Der Befehl \nopagebreak[3] \begin{quote} |\caption|\oarg{Kurzform f"ur das Verzeichnis}\marg{Beschriftung} \end{quote} \nopagebreak[3] erzeugt eine "Uber- bzw.~Unterschrift innerhalb einer gleitenden Umgebung wie |figure| oder |table|. Dies ist an sich nichts neues, neu ist allerdings, da"s kein Eintrag ins Abbildungs- oder Tabellenverzeichnis vorgenommen wird, wenn eine leere Kurzform angegeben wird, etwa so: \begin{quote} |\caption[]{Dies ist eine Abbildung, die nicht ins|\\ | Abbildungsverzeichnis aufgenommen wird}| \end{quote} \DescribeMacro{\caption*} Das \package{longtable}-Paket definiert zus"atzlich zum Befehl |\caption| auch den Befehl |\caption*|, der eine Beschriftung ohne Bezeichner und ohne Eintrag ins Tabellenverzeichnis erzeugt. So erzeugt z.B. der Code \begin{quote} |\begin{longtable}{cc}|\\ | \caption*{Eine Tabelle}\\|\\ | A & B \\|\\ | C & D \\|\\ |\end{longtable}| \end{quote} diese Tabelle: \begin{longtable}{cc} \caption*{Eine Tabelle}\\ A & B \\ C & D \\ \end{longtable} \Thispackage\ bietet diesen Mechanismus auch f"ur normale Abbildungs- und Tabellenbeschriftungen an. Ein Beispiel: \begin{quote} |\begin{table}|\\ | \caption*{Eine Tabelle}|\\ | \begin{tabular}{cc}|\\ | A & B \\|\\ | C & D \\|\\ | \end{tabular}|\\ |\end{table}| \end{quote} \DescribeMacro{\captionof} \DescribeMacro{\captionof*} Der Befehl |\caption| funktioniert in der Regel nur innerhalb von gleitenden Umgebungen, manchmal m"ochte man ihn jedoch auch anderweitig anwenden, etwa um eine Abbildung in eine nicht-gleitende Umgebung wie |minipage| zu setzen. \pagebreak[2] Hierf"ur stellt \thispackage\ den Befehl \begin{quote} |\captionof|\marg{Umgebungstyp}\oarg{Kurzform}\marg{Langform} \end{quote} zur Verf"ugung. Die Angabe des Umgebungstypen ist hierbei notwendig, damit der gew"unschte Bezeichner gew"ahlt wird und der Eintrag in das richtige Verzeichnis vorgenommen wird. Ein Beispiel: \begin{quote} |\captionof{figure}{Abbildung}|\\ |\captionof{table}{Tabelle}| \end{quote} f"uhrt zu folgendem Ergebnis: \begin{Example} \captionof{figure}{Abbildung} \captionsetup{belowskip=\abovecaptionskip} \captionof{table}{Tabelle} \end{Example} Analog zu |\caption*| gibt es auch den Befehl |\captionof*| f"ur Beschriftungen ohne Bezeichner und ohne Verzeichniseintrag. \DANGER % \NEWdescription{v3.1} Beide Befehle, sowohl |\captionof| als auch |\captionof*|, sollten nur \emph{innerhalb} von Umgebungen (wie |minipage| oder |\parbox|) angewandt werden; ansonsten hat dies einen \LaTeX"=Fehler zur Folge.\footnote{% Nur wenn \eTeX\ zum Einsatz kommt. Ansonsten gibt es zwar keine Fehlermeldung, aber es kann passieren, da"s \LaTeX\ zwischen dem Inhalt und der Beschreibung einen Seitenumbruch setzt; zum anderen kann es bei Mi"sachtung gar zu seltsamen Effekten und unerwünschten Formatierungen der folgenden Abbildungs- und Tabellenbeschriftungen kommen!} \DescribeMacro{\captionsetup} Den Befehl |\captionsetup| haben wir ja schon im \Ref{usage} kennengelernt, uns dort allerdings die Bedeutung des optionalen Parameters \meta{Typ} aufgespart. %Dies soll nun nachgeholt werden: Wir erinnern uns, die Syntax des Befehls lautet \begin{quote} |\captionsetup|\oarg{Typ}\marg{Optionen} \end{quote} Wird hierbei ein \meta{Typ} angegeben, so werden die Optionen nicht unmittelbar umgesetzt, sondern werden lediglich vermerkt und kommen erst dann zum Einsatz, wenn eine "Uber- bzw.\ Unterschrift innerhalb des passenden gleitenden Umgebungstyps gesetzt wird. So wirkt sich z.B. die Angabe \begin{quote} |\captionsetup[figure]|\marg{Optionen} \end{quote} lediglich auf die Unterschriften aus, die innerhalb einer |figure|"=Umgebung gesetzt werden. Ein Beispiel: \begin{quote} |\captionsetup{font=small}|\\ |\captionsetup[figure]{labelfont=bf}| \end{quote} f"uhrt zu Abbildungs- und Tabellenunterschriften der Art: \begin{Example} \captionsetup{font=small} \captionsetup[figure]{labelfont=bf} \begingroup \captionof{figure}{Eine Abbildung} \endgroup \captionsetup{belowskip=\abovecaptionskip} \begingroup \captionof{table}{Eine Tabelle} \endgroup \end{Example} Wie man sieht, f"uhrt das |\captionsetup[figure]{labelfont=bf}| lediglich dazu, da"s Abbildungsunterschriften mit fettem Bezeichner gesetzt werden, alle anderen Unter- bzw.\ "Uberschriften werden hiervon nicht beeinflu"st. \DescribeMacro{\clearcaptionsetup} Um diese vermerkten, typbezogenen Parameter aus dem Ged"achnis von \LaTeX\ zu l"oschen, gibt es den Befehl \begin{quote} |\clearcaptionsetup|\marg{Typ}\quad. \end{quote} |\clearcaptionsetup{figure}| w"urde z.B. die obrige Sonderbehandlung der Abbildungsunterschriften wieder aufheben: \begin{Example} \captionsetup{font=small} \begingroup \captionof{figure}{Eine Abbildung} \endgroup \captionsetup{belowskip=\abovecaptionskip} \begingroup \captionof{table}{Eine Tabelle} \endgroup \end{Example} Als Umgebungstypen mit Unter- bzw.\ "Uberschriften gibt es in der Regel nur zwei: |figure| und |table|. Wie wir jedoch sp"ater sehen werden, kommen durch die Verwendung spezieller \LaTeX-Pakete (wie etwa das \package{float}, \package{longtable} oder \package{sidecap}"=Paket) ggf.~weitere Typen hinzu, deren Beschriftungen ebenfalls derart individuell angepasst werden k"onnen. \subsection{Fortlaufende gleitende Umgebungen} \label{ContinuedFloat} \DescribeMacro{\ContinuedFloat} Manchmal m"ochte man Abbildungen oder Tabellen aufteilen, jedoch ohne den einzelnen Teilen eine eigene Abbildungs- oder Tabellennummer zu geben. Hierf"ur stellt das \thispackage-Paket den Befehl \begin{quote} |\ContinuedFloat| \end{quote} zur Verf"ugung, der gleich als erstes innerhalb der folgenden Teile angewandt werden sollte. Er verhindert, da"s die Z"ahlung fortgef"uhrt wird; eine Abbildung oder Tabelle, die ein |\ContinuedFloat| enth"alt, erh"alt also die gleiche Nummer wie die vorherige Abbildung oder Tabelle. Ein Beispiel: \begin{quote} |\begin{table}|\\ |\caption{Eine Tabelle.}|\\ \ldots\\ |\end{table}|\\ \ldots\\ |\begin{table}\ContinuedFloat|\\ |\caption{Eine Tabelle. (fortgef"uhrt)}|\\ \ldots\\ |\end{table}| \end{quote} ergibt als Ergebnis: \begin{Example} \makeatletter\def\@captype{table}\makeatother \caption[]{Eine Tabelle.} \centerline{\ldots} \ContinuedFloat \captionsetup{aboveskip=0pt} \caption[]{Eine Tabelle. (fortgef"uhrt)} \end{Example} % --------------------------------------------------------------------------- % \pagebreak[4] \section{Eigene Erweiterungen} \label{declare} Wem die vorhandenen Formate, Trenner, Textausrichtungen, Zeichens"atze und Stile nicht ausreichen, der hat die M"oglichkeit, sich eigene zu definieren. Hierzu gibt es eine Reihe von Befehlen, die in dem Vorspann des Dokumentes (das ist der Teil vor |\begin{document}|) zum Einsatz kommen. \pagebreak[2] \DescribeMacro{\DeclareCaptionFormat} Eigene Formate k"onnen mit dem Befehl \begin{quote} |\DeclareCaptionFormat|\marg{Name}\marg{Code mit \#1, \#2 und \#3} \end{quote} definiert werden. F"ur \#1 wird sp"ater der Bezeichner, f"ur \#2 der Trenner und f"ur \#3 der Text eingesetzt. So ist z.B. das Standardformat |plain|, welches die Beschriftung als gew"ohnlichen Absatz formatiert, folgenderma"sen in |caption.sty| definiert: \begin{quote} |\DeclareCaptionFormat{plain}{#1#2#3\par}| \end{quote} \DescribeMacro{\DeclareCaptionLabelFormat} "Ahnlich k"onnen auch eigene Bezeichnerformate definiert werden: \begin{quote} |\DeclareCaptionLabelFormat|\marg{Name}\marg{Code mit \#1 und \#2} \end{quote} Bei den Bezeichnerformaten wird hierbei f"ur \#1 der Name (also z.B. "`Abbildung"'), f"ur \#2 die Nummer (also z.B. "`12"') eingesetzt. \DescribeMacro{\bothIfFirst} \DescribeMacro{\bothIfSecond} Hierbei gibt es eine Besonderheit zu beachten: Wird das Bezeichnerformat auch in Verbindung mit dem \package{subfig}"=Paket\cite{subfig} verwendet, so kann der Bezeichnername (also \#1) auch leer sein. Um dies flexibel handhaben zu k"onnen, stellt das \thispackage"=Paket die Befehle \begin{quote} |\bothIfFirst|\marg{Erstes Argument}\marg{Zweites Argument}\quad und\\ |\bothIfSecond|\marg{Erstes Argument}\marg{Zweites Argument} \end{quote} zur Verf"ugung. |\bothIfFirst| testet, ob das erste Argument leer ist, |\bothIfSecond|, ob das zweite Argument leer ist. Nur wenn dies nicht der Fall ist, werden beide Argumente ausgegeben, ansonsten werden beide unterdr"uckt. So ist z.B. das Standard"=Bezeichnerformat |simple| nicht, wie man naiverweise annehmen k"onnte, als \begin{quote} |\DeclareCaptionLabelFormat{simple}{#1 #2}| \end{quote} definiert, weil dies zu einem st"orendem f"uhrenden Leerzeichen f"uhren w"urde, wenn \#1 leer ist. Stattdessen findet sich in |caption.sty| folgende Definition, die sowohl mit |\caption| als auch mit |\subfloat| harmoniert: \begin{quote} |\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{~}#2}| \end{quote} d.h.~das Leerzeichen kommt nur dann zum Einsatz, wenn \#1 nicht leer ist. \pagebreak[3] \DescribeMacro{\DeclareCaptionLabelSeparator} Eigene Trenner werden mit \nopagebreak[3] \begin{quote} |\DeclareCaptionLabelSeparator|\marg{Name}\marg{Code} \end{quote} \nopagebreak[3] definiert. Auch hier wieder als einfaches Beispiel die Definition des Standard"=Trenners aus |caption.sty|: \nopagebreak[3] \begin{quote} |\DeclareCaptionLabelSeparator{colon}{: }| \end{quote} \pagebreak[3] \DescribeMacro{\DeclareCaptionJustification} Eigene Textausrichtungen k"onnen mit \begin{quote} |\DeclareCaptionJustification|\marg{Name}\marg{Code} \end{quote} definiert werden. Der \meta{Code} wird dann der Beschriftung vorangestellt, so f"uhrt z.B. die Verwendung der Ausrichtung \begin{quote} |\DeclareCaptionJustification{raggedright}{\raggedright}| \end{quote} dazu, da"s alle Zeilen der Beschriftung linksb"undig ausgegeben werden. \DescribeMacro{\DeclareCaptionFont} Eigene Zeichensatzoptionen k"onnen mit \begin{quote} |\DeclareCaptionFont|\marg{Name}\marg{Code} \end{quote} definiert werden. So definiert z.B. das \thispackage"=Paket die Optionen |small| und |bf| folgenderma"sen: \begin{quote} |\DeclareCaptionFont{small}{\small}|\\ |\DeclareCaptionFont{bf}{\bfseries}| \end{quote} \iffalse Die Zeilenabst"ande lie"sen sich z.B.~"uber das \package{setspace}"=Paket regeln:%\NEWdescription{v3.0h} \begin{quote} |\usepackage{setspace}|\\ |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{% \emph{Hinweis:} \cs{singlespacing} kann hier nicht benutzt werden, da es ein \cs{vskip} Kommando enth"alt.}\\ |\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}|\\ |\DeclareCaptionFont{doublespacing}{\doublespacing}|\\ |\captionsetup{font={onehalfspacing,small},labelfont=bf}| \end{quote} \example{font={onehalfspacing,small},labelfont=bf,singlelinecheck=off}{\exampletext} \fi Ein Beispiel, welches etwas Farbe ins Spiel bringt: \begin{quote} |\usepackage{color}|\\ |\DeclareCaptionFont{red}{\color{red}}|\\ |\DeclareCaptionFont{green}{\color{green}}|\\ |\DeclareCaptionFont{blue}{\color{blue}}|\\ |\captionsetup{labelfont={blue,bf},textfont=green}| \end{quote} \example*{labelfont={color=blue,bf},textfont={color=green},singlelinecheck=off}{\exampletext} Aber da \thispackage\ schon die pfiffige Definition \begin{quote} |\DeclareCaptionFont{color}{\color{#1}}| \end{quote} enthält, kann man das selbe Resultat auch einfach mit \begin{quote} |\usepackage{color}|\\ |\captionsetup{labelfont={color=blue,bf},|\\ | textfont={color=green}}|\quad. \end{quote} erreichen. \DescribeMacro{\DeclareCaptionStyle} Zu guter letzt noch die Definition eigener Stile. Stile sind einfach eine Ansammlung von geeigneten Einstellungen, die unter einem eigenen Namen zusammengefasst werden und mit der Paketoption |style=|\meta{Name} ausgew"ahlt werden k"onnen. Sie werden wie folgt definiert: \begin{quote} |\DeclareCaptionStyle|\marg{Name}\oarg{zus"atzliche Optionen}\marg{Optionen} \end{quote} Hierbei ist zu beachten, da"s die \meta{Optionen} immer auf dem Stil |base| basieren (siehe auch \Ref{style}), es brauchen also nur davon abweichende Optionen angegeben werden. Sind \meta{zus"atzliche Optionen} angegeben, so kommen diese automatisch zus"atzlich zum Einsatz, sofern die Beschreibung in eine einzelne Zeile passt und diese Abfrage nicht mit |singlelinecheck=off| ausgeschaltet wurde. Als Beispiel mu"s mal wieder eine einfache Definition innerhalb dieses Paketes herhalten, so ist der Stil |base| definiert als \begin{quote} |\DeclareCaptionStyle{base}%|\\ | [format=plain,justification=centering]{}|\quad. \end{quote} % --------------------------------------------------------------------------- % \subsection{Weiterf"uhrende Beispiele} %\NEWdescription{v3.1} Möchte man die Bezeichnung (inkl. Trenner wie Doppelpunkt) vom Text mit einem Zeilenumbruch getrennt haben, so könnte man dies z.B.~so bewerkstelligen: \begin{quote} |\DeclareCaptionFormat{myformat}{#1#2\\#3}| \end{quote} Wählt man anschließend dieses Format mit |\captionsetup{format=myformat}| aus, so erhält man Beschriftungen der Art: %\begin{Example} % \captionsetup{aboveskip=0pt} \example{format=myformat1,labelfont=bf}{\exampletext} %\end{Example} Auch einen Einzug könnte man diesem Format mit auf den Weg geben: \begin{quote} |\captionsetup{format=myformat,indention=1cm}| \end{quote} führt zu Beschriftungen wie: %\begin{Example} % \captionsetup{aboveskip=0pt} \example{format=myformat1,indention=1cm,labelfont=bf}{\exampletext} %\end{Example} Aber Sie möchten den Einzug nur auf die erste Zeile des Texts anwenden? Kein Problem, so würde z.B.~die Definition \begin{quote} |\newlength\myindention|\\ |\DeclareCaptionFormat{myformat}%|\\ | {#1#2\\\hspace*{\myindention}#3}|\\ \ldots\\ |\setlength\myindention{1cm}|\\ |\captionsetup{format=myformat}| \end{quote} zu Beschriftungen dieser Art führen: %\begin{Example} % \captionsetup{aboveskip=0pt} \example{format=myformat2,myindention=1cm,labelfont=bf}{\exampletext} %\end{Example} Zu der Länge |\myindention| hätten Sie gerne eine Option, so daß man diesen Einzug auch z.B.~mit |\captionsetup|\xx|[figure]|\xx|{myindention=|\ldots|}| setzen kann? Auch dies läßt sich bewerkstelligen, z.B.~folgendermaßen: \begin{quote} |\newlength\myindention|\\ |\DeclareCaptionOption{myindention}%|\\ | {\setlength\myindention{#1}}|\\ |\DeclareCaptionFormat{myformat}%|\\ | {#1#2\\\hspace\myindention #3}|\\ \ldots\\ |\captionsetup{format=myformat,myindention=1cm}| \end{quote} \bigskip\pagebreak[3] Ein anderes Beispiel: Die Beschriftungen sollen wie folgt aussehen: %\begin{Example} % \captionsetup{aboveskip=0pt} \example{format=reverse,labelformat=fullparens,labelsep=fill,labelfont=it}{\exampletext} %\end{Example} \pagebreak[2] Dies lie"se sich z.B. wie folgt realisieren: \nopagebreak[3] {\leftmargini=10pt \begin{quote} |\DeclareCaptionFormat{reverse}{#3#2#1}|\\ |\DeclareCaptionLabelFormat{fullparens}%|\\ | {(\bothIfFirst{#1}{~}#2)}|\\ |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\ |\captionsetup{format=reverse,labelformat=fullparens,|\\ | labelsep=fill,font=small,labelfont=it}| \end{quote}} Für kurze Beschriftungen, die in eine einzige Zeile passen, wird dieses Format jedoch nicht automatisch angewandt, da die Option |format=plain| Teil der \meta{zusätzlichen Optionen} des Beschrifungsstils |default| ist. Dies läßt sich auf verschiedene Arten ändern, so könnte man z.B.~den |singlelinecheck| auf |off| setzen. Wenn man die Zentrierung aber beibehalten möchte, bietet sich die Definition eines eigenen Beschriftungstils an, etwa so: \begin{quote} |\DeclareCaptionStyle{mystyle}%|\\ | [justification=centering]{format=myformat}|\\ |\captionsetup{style=mystyle}| \end{quote} oder \begin{quote} |\DeclareCaptionFormat{myshortformat}{|\ldots \textit{was-auch-immer\ldots}|}|\\ |\DeclareCaptionStyle{mystyle}%|\\ | [format=myshortformat]{format=myformat}|\\ |\captionsetup{style=mystyle}| \end{quote} \bigskip\pagebreak[3] Ein weiteres Beispiel: Der Bezeichner soll in den linken Rand verlagert werden, so da"s die komplette Absatzbreite der Beschriftung selber zugute kommt: {\leftmargini=10pt \begin{quote} |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\ |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}| \end{quote}} Das Ergebnis w"aren Beschriftungen wie diese: %\begin{Example} % \captionsetup{aboveskip=0pt} \example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext} %\end{Example} % --------------------------------------------------------------------------- % \pagebreak[4] \section{Unterstützung der Dokumentenklassen} % \& Babel} \label{classes} %\NEWdescription{v3.1} {\small\emph{Bitte beachten Sie:} Viele Dokumentenklassen haben bereits eingebaute Optionen und Befehle, um das Erscheinungsbild der Abbildungs- und Tabellenbeschriftungen individuell anzupassen. Wenn diese Möglichkeiten für Sie ausreichend sind, gibt es in der Regel keinen Grund, \thispackage\ zu benutzen. Und falls Sie lediglich an dem Befehl |\captionof| interessiert sind, ist in der Regel das Laden des kleinen aber feinen \package{capt-of}"=Paketes hierzu völlig ausreichend.} Dieser Teil der Dokumentation möchte Ihnen einen Überblick über diejenigen Dokumentenklassen, an welche \thispackage\ angepasst ist, geben: Welche Möglichkeiten zur Beschriftungsgestaltung sie bereits verfügen, mit welchen Seiteneffekten Sie rechnen müssen, wenn Sie dieses Paket verwenden, und zuletzt mit welchen Standardwerten die Optionen belegt werden. \NEWfeature{v3.1} Die Standardwerte "`default"' hängen von der verwendeten Dokumentenklasse ab; sie repräsentieren quasi das Aussehen, wie es vom Autor der Klasse gewünscht war. So kann z.B.~die Einstellung |format=default| je nach verwendeter Klasse unterschiedliche Aussehen der Beschriftungen hervorbringen. \DANGER Sollten Sie Ihre Dokumentenklasse nicht in diesem Abschnitt finden, so haben Sie trotzdem oftmals keinen Grund zur Sorge: Viele Dokumentenklassen sind von den Standardklassen |article|, |report| und |book| abgeleitet, und verhalten sich bezüglich der Abbildungs- und Tabellenbeschriftungen gleich. \Thispackage überprüft automatisch die Kompatibilität zur Dokumentenklasse und gibt eine klare Warnung aus, wenn es eine Unverträglichkeit entdeckt. Wenn Sie keine solche Warnung erhalten, ist alles bestens, wenn doch, wird von der Verwendung des \package{caption}"=Paketes abgeraten, insbesondere erhalten Sie in einem solchen Fall keinen Support. {\small(Sollten Sie trotz der angemahnten Inkompatibilität \thispackage{} nutzen wollen, sollten Sie vorsichtig auf Seiteneffekte achten; gewöhnlich ändert sich alleine durch das Einbinden des \package{caption}"=Paketes ohne Optionen bereits das eigentlich von der Dokumentenklasse vorgebene Aussehen der Beschriftungen. Wenn dies für Sie in Ordnung ist, sollten Sie als erstes die Option |style=base| mittels |\usepackage|\xx|[style=base]|\xx|{caption}| oder |\captionsetup|\xx|{style=base}| angeben, um \thispackage\ in einen dokumentierten Grundstatus zu versetzen. Anschließend können Sie anfangen, mittels zusätzlicher Optionen erste Anpassungen vorzunehmen und die Daumen gedrückt zu halten.)} \newcommand*\Option{Option} \newcommand*\defaultvalue{\texttt{default} Belegung} \newcommand*\use{\textit{verwendet}} \newcommand*\settings{\textit{Einstellungen}} \newcommand*\nofont{\textit{keiner}} \subsection{Standard \LaTeX: article, report und book} \begin{tabular}{ll} \Option & \defaultvalue \\\hline |format=| & |plain| \\ |labelformat=| & |simple| \\ |labelsep=| & |colon| \\ |justification=| & |justified| \\ |font=| & \nofont \\ |labelfont=| & \nofont \\ |textfont=| & \nofont \\ \end{tabular} \textbf{Von der Klasse angebotene Befehle:} Keine \noindent{\small(\emph{Hinweis:} Dies gilt in der Regel auch für abgeleitete Dokumentenklassen.)} \subsection{\AmS: amsart, amsproc und amsbook} \label{AMS} \TODO \subsection{beamer} \label{beamer} \begin{tabular}{ll} \Option & \defaultvalue \\\hline |format=| & |plain| \\ |labelformat=| & \textit{nicht nummeriert} \\ |labelsep=| & |colon| \\ |justification=| & |raggedright| \\ |font=| & \use\ \package{beamer} |caption| \settings \\ |labelfont=| & \use\ \package{beamer} |caption name| \settings \\ |textfont=| & \nofont \\ \end{tabular} \textbf{Von der Klasse angebotene Befehle und Seiteneffekte:}\\ Die Zeichensatz- und Farbeinstellungen können mit |\setbeamerfont|\xx|{caption}|\xx\marg{options} und |\setbeamerfont|\xx|{caption name}|\xx\marg{options} vorgenommen werden. Dies wird auch mit dem \package{caption}"=Paket noch funktionieren, zumindest solange Sie keinen anderen Zeichensatz mit |\captionsetup|\xx|{font=|\xx\meta{options}|}| oder |\captionsetup|\xx|{labelfont=|\xx\meta{options}|}| einstellen.\par Weiterhin bietet die \package{beamer}"=Klasse verschiedene "`Templates"' für die Beschriftungen an, diese können mit |\set|\x|beamter|\x|template|\xx|{caption}|\xx|[|\meta{template}|]| ausgewählt werden. Da \thispackage\ diesen Mechanismus ersetzt, haben |\def|\x|beamer|\x|template*|\xx|{caption}|\xx\marg{template code} und |\set|\x|beamer|\x|template|\xx|{caption}|\xx|[|\meta{template}|]| keine Funktion mehr, wenn \thispackage\ verwendet wird. \subsection{\KOMAScript: scrartcl, scrreprt, and scrbook} \label{KOMA} \begin{tabular}{ll} \Option & \defaultvalue \\\hline |format=| & \use\ |\setcapindent| \textit{\&} |\setcaphanging| \\ |labelformat=| & |simple| \\ |labelsep=| & \use\ |\captionformat| \\ |justification=| & |justified| \\ |font=| & \use\ |\setkomafont{caption}| \settings \\ |labelfont=| & \use\ |\setkomafont{captionlabel}| \settings \\ |textfont=| & \nofont \\ \end{tabular} \textbf{Von der Klasse angebotene Befehle:}\\ Die \KOMAScript"=Dokumentenklassen bietet sehr viele Möglichkeiten, das Design der Abbildungs- und Tabellenbeschriftungen anzupassen. Für eine Übersicht schauen Sie bitte in die sehr gute \KOMAScript"=Dokumentation, Abschnitt "`Tabellen und Abbildungen"'. \textbf{Seiteneffekte:}\\ Das optionale Argument von |\setcapwidth| wird (noch) nicht vom \package{caption}"=Paket unterstützt und daher ignoriert. Weiterhin überschreiben die \KOMAScript"=Optionen |tablecaptionabove| \& |tablecaptionbelow| sowie die dazugehörigen Befehle |\captionabove| \& |\captionbelow| die Einstellungsmöglichkeit |position=|, die \thispackage{} anbietet. \subsection{\NTG: artikel, rapport und boek} \label{NTG} \begin{tabular}{ll} \Option & \defaultvalue \\\hline |format=| & |plain| \\ |labelformat=| & |simple| \\ |labelsep=| & |colon| \\ |justification=| & |justified| \\ |font=| & \nofont \\ |labelfont=| & \use\ |\CaptionLabelFont| \\ |textfont=| & \use\ |\CaptionTextFont| \\ \end{tabular} \textbf{Von der Klasse angebotene Befehle und Seiteneffekte:}\\ |\CaptionLabelFont| und |\CaptionTextFont| können entweder direkt oder indirekt über |\CaptionFonts| definiert werden. Beides funktioniert auch weiterhin, zumindest solange kein anderer Zeichensatz mittels der \package{caption}"=Paket"=Optionen |labelfont=| oder |textfont=| festgelegt wird. \subsection{\SmF: smfart und smfbook} \label{SMF} \TODO \subsection{Die französische Babel Option} \label{frenchb} \TODO\iffalse If you use the \package{frenchb} option of the \package{babel} package with one of the three standard \LaTeX{} classes (or a one derived from them) the default |labelsep=| will be set to \cs{CaptionSeparator} (offered by \package{frenchb}), overriding the default value set by the document class. So redefining \cs{CaptionSeparator} will still work, unless you don't select a different |labelsep=| than the default one. \fi \INFO* Bitte laden Sie \thispackage\ \emph{nach} dem \package{babel}"=Paket. \subsection{Das frenchle- und frenchpro-Paket} \label{frenchpro} \TODO\iffalse If you use the \package{frenchle} or \package{frenchpro} package, the default |labelsep=| will be set to \cs{captionseparator} (offered by \package{frenchle/pro}) plus \cs{space}, overriding the default value set by the document class. So redefining \cs{captionseparator} will still work, unless you don't select a different |labelsep=| than the default one. Furthermore the default |textfont=| will be set to |textfont=it|, since this emulates the default setting of |\captionfont| defined by the \package{frenchle} or \package{frenchpro} package. %If you redefine |\captionfont| after loading the \package{frenchle} or %\package{frenchpro} package, this redefinition gets lost. Please note that the command \cs{captionfont} is used by the \package{caption} package internally for a different purpose, so you should not change it (anymore). The command \cs{unnumberedcaptions}\marg{figure or table} will still work, but only unless you don't select a different |labelformat=| than the default one. \fi \INFO* Bitte laden Sie \thispackage\ \emph{nach} dem \package{frenchle} oder \package{frenchpro}"=Paket. % --------------------------------------------------------------------------- % \pagebreak[4] \section{Interaktion mit anderen Paketen} \label{packages} %\NEWdescription{v3.1} \Thispackage\ ist an folgende Pakete, die ebenfalls Abbildungs- oder Tabellenbeschriftungen anbieten, angepasst: \begin{quote} \package{float}, \package{floatflt}, \package{fltpage}, \package{hyperref}, \package{hypcap}, \package{listings}, \package{longtable}, \package{picinpar}, \package{picins}, \package{rotating}, \package{sidecap}, \package{subfigure}, \package{supertabular}, \package{threeparttable} und \package{wrapfig} \end{quote} Weiterhin arbeiten das \package{floatrow}- und das \package{subfig}"=Paket aktiv mit diesem Paket zusammen und verwenden die |\captionsetup|"=Schnittstelle. \subsection{float} \label{float} \TODO \subsection{floatflt} \label{floatflt} \TODO \subsection{fltpage} \label{fltpage} \TODO \subsection{hyperref} \label{hyperref} \NEWfeature{v3.1} Zwei Optionen regeln das Setzen von Hyperlinks: \begin{description} \item{\texttt{hypcap=}}\\[\smallskipamount] Auf |true| gesetzt, werden alle Hyperlink"=Anker -- wohin Einträge im Abbildungs- und Tabellenverzeichnis, sowie |\ref| und |\autoref| verweisen -- an den Anfang der (gleitenden) Umgebungen wie Abbildung oder Tabelle plaziert.\par Auf |false| gesetzt zeigen hingegen alle Hyperlink"=Anker auf die Beschriftung.\par (Die Voreinstellung ist |hypcap=true|.) \item{\texttt{hypcapspace=}}\\[\smallskipamount] Dies regelt den vertikalen Abstand zwischen dem Hyperlink"=Anker und der (gleitenden) Umgebung, so entfernt z.B.~|hypcapspace=0pt| diesen Abstand.\par (Die Voreinstellung ist|hypcapspace=0.5\baselineskip|.) \end{description} Bitte beachten Sie: \begin{description} \item{\cs{captionof}\marg{type}\csmarg\ldots\ vs. \cs{captionsetup}\csmarg{type=\meta{Typ}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount] Ohne geladenes \package{hyperref}"=Paket bekommen Sie identische Resultate. Aber mit \package{hyperref} geladen und mit |hypcap=true| versehen wird der Hyperlink"=Anker unterschiedlich gesetzt. So plaziert z.B. \begin{quote} |\begin{minipage}{\linewidth}|\\ | |\ldots\\ | \captionof{figure}{A figure}|\\ |\end{minipage}| \end{quote} den Anker bei der Beschriftung. (Und wenn |hypcap=true| gesetzt ist, wird eine Warnung deswegen ausgegeben.) \begin{quote} |\begin{minipage}{\linewidth}|\\ | \captionsetup{type=figure}|\\ | |\ldots\\ | \caption{A figure}|\\ |\end{minipage}| \end{quote} hingegen plaziert den Anker an den Anfang der |minipage|. \item{\cs{caption}\csoarg{}\csmarg\ldots\ vs. \cs{captionsetup}\csmarg{listof=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount] Wiederum bekommen Sie ohne geladenes \package{hyperref}"=Paket identische Resultate. Aber mit \package{hyperref} geladen liegen die Unterschiede in den Feinheiten. So wird z.B.~das optionale Argument von \cs{caption} auch in die |aux|-Datei geschrieben und vom \cs{nameref} Befehl verwendet. Wenn Sie also \cs{caption} mit leerem Argument angeben, wird ein auf diese Abbildung oder Tabelle angewandtes \cs{nameref} nicht das erwünschte, nämlich ein leeres Resultat zur Folge haben. Daher ist es besser \cs{captionsetup}\csmarg{listof=false} zu verwenden, wenn Sie keinen Eintrag in dem Abbildungs- oder Tabellenverzeichnis wünschen. \end{description} \subsection{hypcap} \label{hypcap} Wird das \package{hypcap}"=Paket zusätzlich zum \package{hyperref}"=Paket geladen, so übernimmt es die Kontrolle über die Platzierung der Hyperlink"=Anker. Dies hat den Nebeneffekt, daß die Hyperlink"=Anker innerhalb der Umgebungen |floatingfigure| (vom \package{floatflt}"=Paket bereitgestellt), |figwindow| (vom \package{picinpar}"=Paket bereitgestellt), |parpic| (vom \package{picins}"=Paket bereitgestellt) und |wrapfigure| (vom \package{wrapfig}"=Paket bereitgestellt) nicht mehr optimal platziert werden. Außerdem ist zu beachten, daß dann |\captionsetup{type=|\meta{Type}|}| keinen Hyperlink"=Anker mehr setzt, dies muß dann stattdessen mit |\capstart| (welches vom \package{hypcap}"=Paket angeboten wird) geschehen. \subsection{listings} \label{listings} \TODO \subsection{longtable} \label{longtable} \TODO \subsection{picinpar} \label{picinpar} \TODO \subsection{picins} \label{picins} \TODO \subsection{rotating} \label{rotating} \TODO \subsection{sidecap} \label{sidecap} \TODO \subsection{subfigure} \label{subfigure} \TODO \subsection{supertabular} \label{supertabular} \TODO \subsection{threeparttable} \label{threeparttable} \TODO \subsection{wrapfig} \label{wrapfig} \TODO % --------------------------------------------------------------------------- % \pagebreak[4] \section{Kompatibilit"at zu "alteren Versionen} \label{compatibility} \subsection{caption v\texorpdfstring{$1.x$}{1.x}} \label{caption1} Diese Version des \thispackage"=Paketes ist weitgehend kompatibel zu "alteren Versionen des Paketes; alte, vorhandene Dokumente sollten sich also in der Regel ohne Probleme weiterhin "ubersetzen lassen. Jedoch ist zu beachten, da"s eine Mischung aus alten Befehlen und neueren Optionen bzw.~Befehlen zu unerw"unschten Nebeneffekten f"uhren kann. Hier eine kurze "Ubersicht "uber die alten, "uberholten Optionen und ihre aktuellen Entsprechungen: {\small\begin{longtable}{ll} \package{caption} \version{1.x} & \package{caption} \version{3.x}\\ \hline \endhead |normal| & |format=plain|\\ |hang| & |format=hang|\\ |isu| & |format=hang|\\ |center| & |justification=centering|\\ |centerlast| & |justification=centerlast|\\ %|anne| & |justification=centerlast|\\ |nooneline| & |singlelinecheck=off|\\ |scriptsize| & |font=scriptsize|\\ |footnotesize| & |font=footnotesize|\\ |small| & |font=small|\\ |normalsize| & |font=normalsize|\\ |large| & |font=large|\\ |Large| & |font=Large|\\ |up| & |labelfont=up|\\ |it| & |labelfont=it|\\ |sl| & |labelfont=sl|\\ |sc| & |labelfont=sc|\\ |md| & |labelfont=md|\\ |bf| & |labelfont=bf|\\ |rm| & |labelfont=rm|\\ |sf| & |labelfont=sf|\\ |tt| & |labelfont=tt|\\ \end{longtable}} Neben den Optionen zum Einstellen des Zeichensatzes gab es auch die Befehle |\captionsize| bzw. |\captionfont| und |\captionlabelfont|, die direkt mittels |\renewcommand| ver"andert werden konnten. Dieser Mechanismus wurde durch die Anweisungen \begin{quote} |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad und\\ |\captionsetup{font=|\ldots|,labelfont=|\ldots|}| \end{quote} ersetzt. \SeeUserDefined Das Setzen eines Randes geschah in \version{1.x} mittels \begin{quote} |\setlength{\captionmargin}{|\ldots|}|\quad. \end{quote} Dies wurde durch \begin{quote} |\captionsetup{margin=|\ldots|}| \end{quote} ersetzt. \See{\Ref{margins}} Zum Beispiel w"urde \begin{quote} |\usepackage[hang,bf]{caption}|\\ |\renewcommand\captionfont{\small\sffamily}|\\ |\setlength\captionmargin{10pt}| \end{quote} in aktueller Notation \begin{quote} |\usepackage[format=hang,labelfont=bf,font={small,sf},|\\ | margin=10pt]{caption}| \end{quote} bzw. \begin{quote} |\usepackage{caption}|\\ |\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\ | margin=10pt}| \end{quote} hei"sen. Die etwas exotische Option |ruled|, die eine partielle Anwendung der eingestellten Parameter bei gleitenden Umgebungen des Typs |ruled| aktivierte, wird ebenfalls emuliert, hat aber keine direkte Entsprechung in dieser Version des \package{caption}"=Paketes. M"ochte man gezielt das Aussehen der Abbildungen des Stils |ruled|, der durch das \package{float}"=Paket zur Verf"ugung gestellt wird, ver"andern, so ist dies nun durch \begin{quote} |\DeclareCaptionStyle{ruled}{|\ldots|}| \end{quote} bzw. \begin{quote} |\captionsetup[ruled]{|\ldots|}| \end{quote} m"oglich. \SeeUserDefined[, \Ref{commands} und \Ref{float}] \subsection{caption2 v\texorpdfstring{$2.x$}{2.x}} \label{caption2} Die Pakete \package{caption} und seine experimentelle, nun veraltete Variante \package{caption2} sind vom internen Konzept her zu unterschiedlich, um hier eine vollst"andige Kompatibilit"at gew"ahrleisten zu k"onnen. Daher liegt diesem Paket weiterhin die Datei |caption2.sty| bei, so da"s "altere Dokumente, die das \package{caption2}"=Paket verwenden, weiterhin "ubersetzt werden k"onnen. Neue Dokumente sollten jedoch auf dem aktuellen \package{caption}"=Paket aufgesetzt werden. In den meisten F"allen ist es ausreichend, einfach ggf.~die Anweisung \begin{quote} |\usepackage[...]{caption2}| \end{quote} durch \begin{quote} |\usepackage[...]{caption}| \end{quote} zu ersetzen. Einige Optionen und Befehle werden jedoch nicht emuliert, so da"s sie anschlie"send Fehlermeldungen erhalten k"onnen. Die folgenden Abs"atze werden Ihnen jedoch bei der Umsetzung dieser Optionen und Befehle helfen. Sollten dar"uberhinaus noch Fragen oder Probleme auftreten, so z"ogern Sie bitte nicht, mich diesbez"uglich per E-Mail zu kontaktieren. Zus"atzlich zu den bereits im vorherigen Abschnitt vorgestellten Optionen werden auch folgende emuliert: {\small\begin{longtable}{ll} \package{caption2} \version{2.x} & \thispackage\ \version{3.x}\\ \hline \endhead |flushleft| & |justification=raggedright|\\ |flushright| & |justification=raggedleft|\\ |oneline| & |singlelinecheck=on|\\ \end{longtable}} Das Setzen eines Randes geschah in \version{2.x} mittels \begin{quote}\leavevmode\hbox{% |\setcaptionmargin{|\ldots|}| bzw. |\setcaptionwidth{|\ldots|}|\quad. }\end{quote} Dies wurde durch \begin{quote}\leavevmode\hbox{% |\captionsetup{margin=|\ldots|}| bzw. |\captionsetup{width=|\ldots|}| }\end{quote} ersetzt. \See{\Ref{margins}} Das Setzen des Einzuges wurde in \version{2.x} mit \begin{quote} |\captionstyle{indent}|\\ |\setlength\captionindent{|\ldots|}| \end{quote} erledigt, dies geschieht nun mit \begin{quote} |\captionsetup{format=plain,indention=|\ldots|}|\quad. \end{quote} Die Sonderbehandlung von einzeiligen Beschriftungen lie"s sich in \version{2.x} mit |\oneline|\-|captions|\-|false| aus- bzw. |\oneline|\-|captions|\-|true| wieder einschalten. Dies wurde durch |\captionsetup{|\xx|singlelinecheck=|\xx|off}| bzw. |\captionsetup{|\xx|singlelinecheck=|\xx|on}| ersetzt. \See{\Ref{justification}} Die Befehle \begin{quote} |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\ |\defcaptionstyle|, |\newcaptionstyle| und |\renewcaptionstyle| \end{quote} haben keine direkte Entsprechnung und werden daher durch diese Version des \package{caption}"=Paketes auch nicht emuliert. Sie f"uhren also bei der Verwendung %mit diesem \thispackage"=Paket zu Fehlermeldungen und m"ussen daher zwingend umgesetzt werden. Die Umsetzung ist von Fall zu Fall verschieden, lesen Sie sich daher bitte diese Anleitung gr"undlich durch und suchen Sie sich die Optionen bzw.~Befehle als Ersatz heraus, die Ihren W"unschen entsprechen. \iffalse Als kleine Hilfestellung hier die Beispiele aus der alten Anleitung zum \package{caption2}"=Paket und deren Umsetzung: \newenvironment{OldNew}% {\begin{minipage}\linewidth \def\Old{Alt:\begin{quote}}% \def\New{\end{quote}Neu:\begin{quote}}% \def\Or{\end{quote}\centerline{-- oder --}\begin{quote}}% }% {\end{quote}\end{minipage}} \begin{OldNew} \Old |\captionstyle{center}| \New |\captionsetup{justification=centering}| \end{OldNew} \hrule \begin{OldNew} \Old |\captionstyle{indent}|\\ |\setlength{\captionindent}{1cm}| \New |\captionsetup{format=plain,indention=1cm}| \end{OldNew} \hrule \begin{OldNew} \Old |\renewcommand\captionfont{\small}|\\ |\renewcommand\captionlabelfont{\itshape}| \New |\captionsetup{font=small,labelfont=it}| \end{OldNew} \hrule \begin{OldNew} \Old |\renewcommand\captionfont{\small\itshape}|\\ |\renewcommand\captionlabelfont{\upshape}| \New |\captionsetup{font=small,textfont=it}| \end{OldNew} \hrule \begin{OldNew} \Old |\setcaptionwidth{.5\textwidth}| \New |\captionsetup{width=.5\textwidth}| \end{OldNew} \hrule \begin{OldNew} \Old |\setcaptionmargin{.25\textwidth}| \New |\captionsetup{margin=.25\textwidth}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{absatz}{\captionlabel: \exampletext\par}|\\ |\captionstyle{absatz}| \New |\DeclareCaptionFormat{absatz}{#1: #3\par}|\\ |\captionsetup{format=absatz,singlelinecheck=off}| \Or |\captionsetup{format=plain,singlelinecheck=off}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{fancy}{\textsf{\captionlabel}\\\exampletext\par}|\\ |\captionstyle{fancy}| \New |\DeclareCaptionFormat{fancy}{\textsf{#1}\\#3\par}|\\ |\captionsetup{format=fancy,singlelinecheck=off}| \Or |\captionsetup{format=plain,labelfont=sf,labelsep=newline}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{fancy2}{\exampletext\hfill\textit{(\captionlabel)}}|\\ |\captionstyle{fancy2}| \New |\DeclareCaptionFormat{fancy2}{#3\hfill\textit{(#1)}}|\\ |\captionsetup{format=fancy2,singlelinecheck=off}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{mystyle}{%|\\ | \normalcaptionparams|\\ | \renewcommand\captionlabelfont{\bfseries}%|\\ | \renewcommand\captionlabeldelim{.}%|\\ | \onelinecaptionsfalse|\\ | \usecaptionstyle{centerlast}}|\\ |\captionstyle{mystyle}| \New |\DeclareCaptionStyle{mystyle}{labelfont=bf,labelsep=period,justification=centerlast}|\\ |\captionsetup{style=mystyle}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{hangandleft}{%|\\ | \let\oldcaptiontext\exampletext|\\ | \def\exampletext{\raggedright\oldcaptiontext}%|\\ | \usecaptionstyle{hang}}|\\ |\captionstyle{hangandleft}| \New |\captionsetup{format=hang,justification=raggedright}| \end{OldNew} \hrule \begin{OldNew} \Old |\newcaptionstyle{fancy}{%|\\ | \usecaptionmargin\captionfont|\\ | \onelinecaption|\\ | {{\captionlabelfont\captionlabel\captionlabeldelim}%|\\ | \captionlabelsep\exampletext}%|\\ | {{\centering\captionlabelfont\captionlabel\par}%|\\ | \centerlast\exampletext\par}}|\\ |\captionstyle{fancy}| \New |\DeclareCaptionFormat{fancy}{\centering#1\par\centerlast#3\par}|\\ |\DeclareCaptionStyle{fancy}|\\ | [format=plain,justification=centering]|\\ | {format=fancy}|\\ |\captionsetup{style=fancy}| \Or |\DeclareCaptionFormat{fancy}{#1\par#3\par}|\\ |\DeclareCaptionStyle{fancy}|\\ | [format=plain,justification=centering]|\\ | {format=fancy,justification=centerlast}|\\ |\captionsetup{style=fancy}| \end{OldNew} \hrule \begin{OldNew} \Old |\renewcaptionstyle{longtable}{\usecaptionstyle{normal}}| \New |\captionsetup[longtable]{format=plain}| \end{OldNew} \fi Ebenfalls keine Entsprechung hat die \version{2.x}"=Option |ignoreLTcapwidth|. Deren Verwendung kann in der Regel einfach entfallen, da \thispackage\ den Wert von |\LTcapwidth| sowieso nicht beachtet, solange er nicht explizit auf einen anderen Wert als den Standardwert ($=$|4in|) gesetzt wird. \See{\Ref{longtable}} \subsection{caption v\texorpdfstring{$3.0$}{3.0}} \label{caption3} %\NEWdescription{v3.1} \Thispackage\ \version{3.0} hatte keine weiteren Dokumentenklassen aktiv unterstützt als die drei Standard"=Klassen, die \LaTeX\ selber mitbringt: |article|, |report| und |book|. Daher waren die Vorbelegungen der Einstellungsmöglichkeiten fest durch dieses Paket vorgegeben, sie repräsentierten das Aussehen bei Verwendung einer dieser Klassen. Nun aber unterstützt \thispackage\ mehr Dokumentenklasse aktiv, folglich kann die Vorbelegung nun von der verwendeten Dokumentenklasse abhängen. Ein Beispiel: Während in \version{3.0} die Vorbelegung der Ausrichtung immer |justification=|\xx|justified| was, ist sie nun immer noch |justified| wenn eine der drei Standardklassen verwendet wird, aber |justification=|\xx|raggedright|, wenn die \package{beamer}"=Klasse verwendet wird. Möchten sie weiterhin die "`alten"' Vorbelegungen, so können Sie die Option |style=base| beim Laden des \package{caption}"=Paketes angeben oder später mittels |\captionsetup|\xx|{style=base}| den alten Grundzustand wieder herstellen. Weiterhin prüft die aktuelle Version des \package{caption}"=Paketes automatisch nach Inkompatibilitäten und gibt ggf.~ eine Warnung diesbezüglich aus. Sollte eine ernsthafte Inkompatibilität festgestellt werden, werden außerdem einige Features des \package{caption}"=Paketes abgeschaltet. Lediglich diese Prüfung ist neu, wenn sie also neuerdings eine Kompatibilitätswarnung erhalten, so waren auch bereits vorangegangene Versionen des \package{caption}"=Paketes inkompatibel, dies hatte sich aber früher "`nur"' durch Seiteneffekte bzw.~nicht korrekt funktionierende Features geäußert. Die Kompatibilitätswarnungen sagen auch nicht aus, daß etwas schief gegangen ist, sondern lediglich, daß etwas schief gehen kann. Sie sollten aber auf jeden Fall, wenn Sie \thispackage\ trotz einer solchen Warnung einsetzen, die Abbildungs- und Tabellenbeschriftungen bzgl.~ ihres Aussehens genau im Auge behalten. % --------------------------------------------------------------------------- % \pagebreak[4] \section{Alphabetische Referenz} %\newenvironment{Warnings}% % {\begin{trivlist}% % \def\Message{\pagebreak[3]\leftskip=0pt\relax\item[]\color{blue}}% % \def\Description{\nopagebreak\par\nopagebreak\color{black}\leftskip=1.5em\nopagebreak}% % }% % {\color{black}\end{trivlist}} \newenvironment{Warnings}{% \newif\ifMessage \def\Message{% \ifMessage\end{minipage}\par\vspace\itemsep\pagebreak[3]\fi \begin{minipage}{\linewidth}% \setlength\parindent{0pt}% \setlength\parskip{\smallskipamount}% \setlength\leftskip{0pt}% \color{blue}% \Messagetrue}% \def\Description{% \par\color{black}\leftskip=1.5em}% }{% \ifMessage\end{minipage}\par\fi } \subsection{Befehle} \begin{longtable}{lll} Befehl & & Abschnitt \\ \hline \endhead |\abovecaptionskip| & & \ref{skips} \\ %|\AtBeginCaption| & & \ref{x} \\ %|\AtEndCaption| & & \ref{x} \\ |\belowcaptionskip| & & \ref{skips} \\ |\caption| & & \ref{commands} \\ |\caption*| & & \ref{commands} \\ |\captionbox| & & \ref{x} \\ |\captionof| & & \ref{commands} \\ |\captionof*| & & \ref{commands} \\ |\captionsetup| & & \ref{commands} \\ |\captionsetup*| & & \ref{commands} \\ |\centerfirst| & & \ref{justification} \\ |\centerlast| & & \ref{justification} \\ |\clearcaptionsetup| & & \ref{commands} \\ |\clearcaptionsetup*| & & \ref{commands} \\ |\ContinuedFloat| & & \ref{ContinuedFloat} \\ |\DeclareCaptionFont| & & \ref{declare} \\ |\DeclareCaptionFormat| & & \ref{declare} \\ |\DeclareCaptionFormat*| & & \ref{declare} \\ |\DeclareCaptionJustification| & & \ref{declare} \\ |\DeclareCaptionLabelFormat| & & \ref{declare} \\ |\DeclareCaptionLabelSeparator| & & \ref{declare} \\ |\DeclareCaptionLabelSeparator*| & & \ref{declare} \\ |\DeclareCaptionListOfFormat| & & \ref{declare} \\ |\DeclareCaptionOption| & & \ref{declare} \\ |\DeclareCaptionStyle| & & \ref{declare} \\ |\DeclareCaptionTextFormat| & & \ref{declare} \\ |\showcaptionsetup| & & \ref{commands} \\ \end{longtable} \pagebreak[4] \subsection{Optionen} \newcommand\preambleoption{ \footnotemark[1]} \begin{longtable}{lll} Option & Kurzbeschreibung & Abschnitt \\ \hline \endhead |aboveskip| & setzt den Abstand über der Beschriftung & \ref{skips} \\ |belowskip| & setzt den Abstand unter der Beschriftung & \ref{skips} \\ |compatibility|\preambleoption & erzwingt (Nicht-)Kompatibilität & \ref{classes} \\ %|config| & & \ref{x} \\ |figurename|\preambleoption & setzt den Abbildungsnamen & \ref{x} \\ |figureposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\ |font| & wählt den Zeichensatz & \ref{fonts} \\ |format| & wählt das Format & \ref{formats} \\ |FPlist| & wohin soll der Listeneintrag einer FPfigure zeigen? & \ref{fltpage} \\ |FPref| & wohin soll ein |\ref| einer FPfigure zeigen? & \ref{fltpage} \\ |hangindent| & setzt den "`hängenden"' Einzug & \ref{margins} \\ |hypcap| & wählt das "`hypcap"' Feature aus & \ref{hyperref} \\ |hypcapspace| & setzt den Abstand über einem Hyperlink & \ref{hyperref} \\ |indention| & setzt den Einzug & \ref{margins} \\ |justification| & wählt die Ausrichtung & \ref{justification} \\ |labelfont| & wählt den Zeichensatz des Bezeichners & \ref{fonts} \\ |labelformat| & wählt das Format des Bezeichners & \ref{formats} \\ |labelsep| & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\ |labelseparator| & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\ |listof| & schaltet die Listeneinträge an bzw. aus & \ref{listof} \\ |listofformat| & wählt das Listenformat & \ref{listof} \\ |margin| & setzt den Rand bzw. die Ränder & \ref{margins} \\ |margin*| & setzt den Rand, sofern keine Breite gesetzt ist & \ref{margins} \\ |maxmargin| & setzt den max. zu verwendenen Rand & \ref{margins} \\ |minmargin| & setzt den min. zu verwendenen Rand & \ref{margins} \\ |options| & führt die angegebene Optionsliste aus & \ref{x} \\ |parindent| & setzt den Absatzeinzug & \ref{margins} \\ |parskip| & setzt den Absatzabstand & \ref{margins} \\ |position| & gibt einen Hinweis auf die Position & \ref{skips} \\ |singlelinecheck| & schaltet die "`Ein-Zeilen-Prüfung"' ein bzw. aus & \ref{justification} \\ %|size| & wählt die Größe des Zeichensatzes & \ref{x} \\ |skip| & setzt den Abstand zwischen Inhalt \& Beschriftung & \ref{skips} \\ |strut| & schaltet die Verwendung von |\strut| ein bzw. aus & \ref{formats} \\ |style| & wählt einen kompletten Stil aus & \ref{style} \\ |tablename|\preambleoption & setzt den Tabellennamen & \ref{x} \\ |tableposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\ |textfont| & wählt den Zeichensatz des Textes & \ref{fonts} \\ |textformat| & wählt das Format des Textes & \ref{formats} \\ |twoside| & wählt den zweiseitigen Modus & \ref{x} \\ |type| & setzt den Typ \& setzt einen Hyperlink-Anker & \ref{x} \\ |type*| & setzt (nur) den Typ & \ref{x} \\ |width| & setzt eine feste Breite & \ref{margins} \\ \end{longtable} \footnotetext[1]{Diese Optionen stehen nur in dem Dokumentenvorspann (Preamble) zur Verfügung.} \nopagebreak\parbox[t]{\linewidth}{\small\emph{Hinweis:} Veraltete Optionen sind hier nicht gelistet, diese sind in\\ \hspace*{1em}\Ref{caption1} und\\ \hspace*{1em}\Ref{caption2} zu finden.} \pagebreak[4] \subsection{Warnungen} \begin{Warnings} \Message |\caption will not be redefined since it's already|\\ |redefined by a document class or package which is|\\ |unknown to the caption package.|\\ |As a result some new features of the caption|\\ |package will not work as expected.| \Description Wenn \thispackage\ eine vorhandene (und unbekannte) Erweiterung des Befehls |\caption| erkannt hat, definiert es |\caption| nicht erneut um, da dies unweigerlich den Verlust der ursprünglichen Erweiterung zur Folge hätte. Daher funktionieren manche Features, wie |\caption*|, |\ContinuedFloat|, das optionale Argument von |\captionsetup|, sowie die Optionen |listof=| und |hypcap=| nicht mehr; sie werden entweder ignoriert oder arbeiten nicht erwartungsgemäß.\par Wenn Sie an der ursprünglichen Erweiterung nicht interessiert sind und stattdessen den vollen Umfang des \package{caption}"=Paketes verwenden wollen, können Sie es mit der nicht supporteten(!) Option |compatibility=false| probieren und die Daumen drücken. (Aber Sie werden die nächste Warnung stattdessen bekommen.) \par\See{\Ref{classes}} \Message |Caption type was already set to `|\meta{type}|'.| \Description Diese Warnung informiert Sie über vermische \package{caption}"=Optionen. Wenn Sie z.B.~ein |\captionof|\xx|{table}|\xx|{|\ldots|}| in einer |figure| Umgebung verwenden, werden beide Optionensätze, sowohl derjenige für |figure| (mittels |\captionsetup|\xx|[figure]|\xx|{|\ldots|}| angegeben) als auch derjenige für |table| (mittels |\captionsetup|\xx|[table]|\xx|{|\ldots|}| angegeben), angewandt. \par\See{\Ref{commands}} \Message |Forced redefinition of \caption since the|\\ |unsupported(!) package option `compatibility=false'|\\ |was given. Please fasten your seat belts, as we may|\\ |experience turbulence!| \Description Da Sie so mutig waren, die Option |compatibility=false| zu probieren, wird \thispackage\ sein bestes geben, um diesen Wunsch zu erfüllen. Aber je nach verwendeter Dokumentenklasse bzw.~Pakete sollten Sie sich auf nicht"=funktionierende Features oder gar Fehlermeldungen einstellen. Also bitte die Daumen gedrückt halten! \par\See{\Ref{classes}} \Message |Hyperref support is turned off because hyperref has|\\ |stopped early.| \Description Wenn das \package{hyperref}"=Paket seinen Dienst einstellt (den Grund hierfür teilt es Ihnen mit), ist auch die \package{hyperref}"=Unterstützung des \package{caption}"=Paketes nicht verfügbar. Als Folge werden Sie einige Warnungen des \package{hyperref}"=Paketes bekommen, ferner werden Hyperlinks auf Abbildungen und Tabellen nicht funktionsfähig sein. \par\See{\Ref{hyperref}} \Message |Ignoring optional argument [|\meta{pos}|] of \setcapwidth.| \Description \Thispackage\ bemüht sich, so gut es kann, die \KOMAScript"=Befehle bzgl.~Tabellen und Abbildungen zu emulieren. Aber das optionale Argument von |\setcapwidth| funktioniert (noch) nicht; wenn Sie es angeben, wird diese Warnung ausgegeben. \par\See{\Ref{KOMA}} \Message |Internal Warning: |\meta{Warnungstext}|.| \Description Diese Warnung sollten Sie niemals sehen; entweder verwenden Sie ein Paket, welches |figure| und/oder |table| in einer dem \package{caption}"=Paket unbekannten Art \& Weise verändert, oder aber es ist ein Bug im \package{caption}"=Paket. Bitte senden Sie mir einen Fehlerbericht diesbezüglich per E-Mail. Danke! \Message |\label before \caption ignored| \Description Anders als bei nicht gleitenden Umgebungen wird bei den gleitenden Umgebungen die interne Referenz erst bei Anwendung des Befehls |\caption| erzeugt. Ein |\label| Befehl, der auf diese Abbildung bzw.~Tabelle verweisen soll, muß daher entweder \emph{nach} |\caption| oder innerhalb des Argumentes von |\caption| platziert werden. \Message |Option `|\meta{option}|' was not in list `|\meta{option list}|'.| \Description Wenn Sie versuchen, eine bestimmte Option aus einer Optionsliste zu entfernen, zum Beispiel mit |\clearcaptionsetup[position]{table}|, und die angegebene Option kann nicht in der Liste gefunden werden, so erhalten Sie die obenstehende Warnung. Liegt dies nicht an einem Schreibfehler Ihrerseits und möchten Sie ferner diese Warnung unterdrücken, so verwenden können Sie hierzu |\clearcaptionsetup*| anstelle von |\clearcaptionsetup| verwenden. \par\See{\Ref{commands}} \Message |Option list `|\meta{option list}|' undefined.| \Description Wenn Sie versuchen, eine bestimmte Option aus einer Optionsliste zu entfernen, zum Beispiel mit |\clearcaptionsetup[format]{figure}|, und die angegebene Optionsliste ist (noch) nicht definiert, so erhalten Sie die obenstehende Warnung. Liegt dies nicht an einem Schreibfehler Ihrerseits und möchten Sie ferner diese Warnung unterdrücken, so verwenden können Sie hierzu |\clearcaptionsetup*| anstelle von |\clearcaptionsetup| verwenden. \par\See{\Ref{commands}} \iffalse \Message |Possibly superfluous \restylefloat{|\meta{type}|} detected.|\\ |If you think that this warning is unjustified,|\\ |you can switch it off using the caption package|\\ |option `restylefloatcheck=off'.| \Description \TODO \fi \Message |`ragged2e' package not loaded, therefore|\\ |substituting \raggedright for \RaggedRight.| \Description Die Option |justification=|\xx|RaggedRight| ist nur dann voll funktionsfähig, wenn Sie das \package{ragged2e}"=Paket auf Ihrem \TeX"=System installiert haben. Ist dies nicht der Fall, erhalten Sie diese Warnung und |justification=|\xx|RaggedRight| wird im späteren Verlauf des Dokumentes wie |justification=|\xx|raggedright| behandelt werden. \par\See{\Ref{justification}} \Message |Obsolete option `ignoreLTcapwidth' ignored.| \Description Die Option |ignoreLTcapwidth| des \package{caption2}"=Paketes wird nicht von diesem Paket emuliert. In der Regel können Sie aber diese Option ohne Nebeneffekte einfach entfernen. \par\See{\Ref{caption2} und \Ref{longtable}} \Message |`ragged2e' support has been changed. Rerun to get|\\ |captions right.| \Description Das \package{ragged2e} wird nur dann vom \package{caption}"=Paket geladen, wenn es tatsächlich benötigt wird. Um dies zu gewährleisten, sind zwei \LaTeX"=Läufe notwendig, daher können Sie beim ersten Durchlauf diese Warnung bekommen. Im nächsten \LaTeX"=Lauf sollte also diese Warnung verschwunden sein. \par\See{\Ref{justification}} \Message |Reference on page |\meta{page no.}| undefined.| \Description Ist ein zweiseitiges Dokumentenlayout gewählt, benötigt \thispackage\ zwei \LaTeX"=Läufe, um die Ränder richtig zuordnen zu können; daher können Sie beim ersten Durchlauf diese Warnung bekommen. Im nächsten \LaTeX"=Lauf sollte also diese Warnung verschwunden sein. \par\See{\Ref{margins}} \Message |The option `hypcap=true' will be ignored for this|\\ |particular \caption.| \Description \Thispackage\ hat keinen geeigneten Hyperlink"=Anker für diese Beschriftung gefunden, daher hat es entschlossen, die Einstellung |hypcap=true| (die per Standard gesetzt ist) zu ignorieren. Als Folge werden Hyperlinks zu dieser Abbildung oder Tabelle (etwa über das Abbildungsverzeichnis, oder selber mit |\ref| oder |\autoref| angelegt) nicht auf den Beginn der Abbildung oder Tabelle verweisen, sondern stattdessen auf deren Beschriftung.\par Dies kann z.B.~passieren, wenn eine Beschriftung mittels |\captionof| innerhalb einer nicht-gleitenden Umgebung gesetzt wird, aber auch, wenn ein Sie ein Paket in Ihrem Dokument verwenden, welches die Umgebungen |figure| oder |table| umdefiniert hat, dieses Paket aber dem \package{caption}"=Paket unbekannt ist.\par Ist dies für Sie ok, aber die Warnung stört Sie, können Sie sie |\captionsetup{|\xx|hypcap=|\xx|false}| direkt vor dem betroffenen |\caption| oder |\captionof| Befehl platzieren. Ist dies hingegen nicht für Sie ok, können Sie versuchen, selber an geeigneter Stelle einen Hyperlink"=Anker mit |\captionsetup{|\xx|type=|\xx\meta{Typ}|}| zu setzen. \par\See{\Ref{hyperref}} \Message |Unsupported document class (or package) detected,|\\ |usage of the caption package is *not* recommended.| \Description Entweder ist die verwendete Dokumentenklasse dem \package{caption}"=Paket unbekannt, oder aber Sie haben ein Paket in Ihrem Dokument eingebunden, welches ebenfalls das interne Makro |\@makecaption| (was für das Setzen der Abbildungs- und Tabellenbeschriftungen zuständig ist) umdefiniert. Wie-auch-immer, \thispackage\ wird entweder das Design der Beschriftungen in einer ungewollten Art \& Weise verändern, oder aber es wird zu keinem geordneten Verhalten und/oder Fehlermeldungen kommen. Deswegen wird in diesem Falle die Verwendung des \package{caption}"=Paketes nicht empfohlen. \par\See{\Ref{classes}} \Message |Unused \captionsetup[|\meta{type}|].| \Description Es wurden Optionen mit |\captionsetup[|\meta{Typ}|]| definiert, die im Laufe des Dokumentes aber nicht zur Anwendung gekommen sind. Dies kann zum einen an einem Schreibfehler im Argument \meta{Typ} liegen, aber auch daran, daß ein dem \package{caption}"=Paket unbekanntes Paket die Umgebungen |figure| und/oder |table| umdefiniert hat, oder auch einfach, weil Sie die angegebene Umgebung gar nicht im späteren Verlauf Ihres Dokumentes verwenden.\par Möchten Sie diese Warnung unterdrücken, so verwenden Sie hierzu |\caption|\x|setup*| anstelle von |\caption|\x|setup|. \par\See{\Ref{commands}} \Message |Usage of the |\meta{package}| package together with the|\\ |caption package is strongly *not* recommended.|\\ |Instead of loading the |\meta{package}| package you should|\\ |use the caption package option `tableposition=top'.| \Description Das angegebene Paket mischt sich ebenfalls in die Verwendung der Abstände über- und unterhalb der Beschriftungen ein. Viele Köche verderben den Brei, also ist es ratsam, sich für eines der Pakete -- das angegebene oder \thispackage\ -- zu entscheiden, um falsche Abstände zu vermeiden. \par\See{\Ref{skips}} \end{Warnings} \pagebreak[4] \subsection{Fehlermeldungen} \begin{Warnings} \Message |! Argument of \@caption has an extra }.| \Description Beim Setzen von Beschriftungen, die etwas spezielles wie z.B.~eine Tabelle enthält, ist zu beachten, daß immer ein alternativer Listeneintrag als optionales Argument bei |\caption| bzw. |\captionof| mit angegeben werden muß, auch wenn Ihr Dokument gar kein Abbildungs- oder Tabellenverzeichnis beeinhaltet. \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,} \Message |\caption outside float.| \Description |\caption| ist (in der Regel) nur für die Anwendung in gleitenden Umgebungen wie |figure| oder |table|, oder für die Anwendung innerhalb |longtable| konzipiert, ansonsten bekommen Sie obenstehende Fehlermeldung.\par Um eine Beschriftung innerhalb einer anderen Umgebung zu setzen, verwenden Sie bitte entweder die Kombination |\captionsetup{|\xx|type=|\xx\meta{type}|}| $+$ |\caption|, oder aber |\captionof|. \par\See{\Ref{commands}} \Message |\caption outside group or environment.| \Description |\caption| bzw. |\captionof| sind nur für die Anwendung innerhalb einer Box, Gruppe oder Umgebung konzipiert. \par\See{\Ref{commands}} \Message |\captionsetup{type=|\meta{type}|} outside group or environment.| \Description |\captionof| bzw. |\captionsetup{|\xx|type=|\xx\meta{type}|}| sind nur für die Anwendung innerhalb einer Box, Gruppe oder Umgebung konzipiert. \par\See{\Ref{commands}} \Message |\ContinuedFloat outside float.| \Description |\ContinuedFloat| ist nur für die Anwendung innerhalb einer gleitenden Umgebung wie |figure| oder |table| konzipiert. %oder auch |longtable| Für die Anwendung in einer Box, Gruppe oder nicht-gleitenden Umgebung bietet sich die Kombination |\captionsetup{|\xx|type=|\xx\meta{Typ}|}| $+$ |\ContinuedFloat| an.\par |\ContinuedFloat| innerhalb einer |longtable| funktioniert zwar (noch) nicht, aber vielleicht ist die |longtable*| Umgebung, die eine longtable ohne Erhöhung des Tabellenzählers setzt, für Sie hilfreich. \par\See{\Ref{commands} und \Ref{longtable}} \Message |Continued `|\meta{type}|' after `|\meta{type}|'.| \Description Z.Z.~ dürfen fortlaufende Abbildungen oder Tabellen nicht von anderen gleitenden Umgebungen oder einer |longtable| unterbrochen werden, so ist z.B.~ eine Tabelle zwischen einer Abbildung und einer (mit |\ContinuedFloat|) fortgesetzten Abbildung nicht möglich. \par\See{\Ref{ContinuedFloat}} \Message |For a successful cooperation of the `wrapfig' package|\\ |with the `float' package you should load the `wrapfig'|\\ |package *(right) after* the `float' package.| \Description Achten Sie bei der gleichzeitigen Verwendung der Pakete \package{wrapfig} und \package{float} unbedingt auf die richtige Ladereihenfolge und Anwendung. \par\See{\Ref{wrapfig}} \Message |For a successful cooperation of the `wrapfig' package|\\ |with the `float' package you should use at least|\\ |`wrapfig' version 3.6.| \Description Für die gleichzeitige Verwendung der Pakete \package{wrapfig} und \package{float} wird die Version $3.6$ des \package{wrapfig}"=Paketes benötigt. \par\See{\Ref{wrapfig}} \Message |For a successful cooperation we need at least version|\\ |`|\meta{date}|' of package |\meta{package}|, but only version|\\ |`|\meta{old-date}|' is available.| \Description Das aktuelle \package{caption}"=Paket kann nicht mit einem solchen, veralteten Paket zusammen betrieben werden. Bitte aktualisieren Sie das betroffene Paket, zumindest auf die benötigte Version. \Message |Internal Error: |\meta{Fehlertext}|.| \Description Diesen Fehler sollten Sie niemals sehen. Wenn doch, senden Sie mir bitte einen Fehlerbericht per E-Mail. \Message |! LaTeX Error: Option clash for package caption.|\\ {\color{black}\hspace{1.5em}-- oder --}\\ |! LaTeX Error: Missing \begin{document}.| \Description Ein anderes \LaTeX-Paket hat \thispackage\ bereits geladen, Sie können es daher nicht noch einmal mit anderen Optionen laden. Als Verdächtiger kommt das \package{subfig}"=Paket in Frage, sollte dies zutreffen, laden Sie bitte entweder \thispackage\ \emph{vor} dem \package{subfig}"=Paket oder geben beim Laden des \package{subfig}"=Paketes die Option |caption=false| an. \par\See{Dokumentation des \package{subfig}"=Paketes\cite{subfig}} \Message |Not allowed in longtable* environment.| \Description Der Befehl |\caption| ist nicht immerhalb einer |longtable*| Umgebung erlaubt. Verwenden sie entweder |\caption*| für eine Beschriftung ohne Bezeichner oder benutzen Sie die reguläre |longtable| Umgebung. \Message |Not available in compatibility mode.| \Description Das angeforderte Feature steht im sog.~Kompatibilitätsmodus nicht zur Verfügung, d.h.~\thispackage\ hat eine inkompatible Dokumentenklasse oder ein inkompatibles Paket entdeckt, welches ebenfalls |\caption| erweitert und damit die Anwendung dieses Features bzw.~Befehls verhindert. \par\See{\Ref{compatibility}} \Message |Runaway argument?|\\ |! Paragraph ended before \caption@makecurrent was complete.| \Description Beim Setzen von Beschriftungen, die mehr als aus einem Absatz bestehen, ist zu beachten, daß immer ein alternativer Listeneintrag als optionales Argument bei |\caption| bzw. |\captionof| mit angegeben werden muß, auch wenn Ihr Dokument gar kein Abbildungs- oder Tabellenverzeichnis beeinhaltet. \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,} \iffalse % was removed in v3.1b \Message |Something is going wrong here...|\\ |For a removal of this problem please consult the|\\ |caption package documentation, especially the sections|\\ |about the `float' and the `wrapfig' package.| \Description Achten Sie bei der gleichzeitigen Verwendung der Pakete \package{wrapfig} und \package{float} unbedingt auf die richtige Ladereihenfolge und Anwendung. Aber vielleicht hat auch ein anderes Paket das \package{float}"=Paket in einer für \thispackage\ inkompatiblen Art \& Weise erweitert!? \par\See{\Ref{float} und \Ref{wrapfig}} \fi \iffalse \Message |Something's wrong--perhaps a missing \caption|\\ |in the last figure or table.| \Description It seems that you have used a |\subcaption| command without a corresponding |\caption| command. This is not supported. \fi \Message |The option `labelsep=|\meta{name}|' does not work|\\ |with `format=hang'.|\\ {\color{black}\hspace{1.5em}-- oder --}\\ |The option `labelsep=|\meta{name}|' does not work|\\ |with \setcaphanging (which is set by default).| \Description Ein Bezeichnungstrenner, der ein |\\| Kommando enthält, kann nicht mit einem Format kombiniert werden, welches "`hängende"' Beschriftungen liefert. Bitte wählen Sie einen anderen Trenner oder ein anderes Beschriftungsformat aus. \par\See{\Ref{formats} bzw.~\Ref{KOMA}} \Message |The package option `caption=false' is obsolete.|\\ |Please pass this option to the subfig package instead|\\ |and do *not* load the caption package anymore.| \Description Sie haben die Option |caption=false| angegeben. Diese war früher mal eine Krücke, um nicht das komplette \package{caption}"=Paket zu laden, sondern nur den für das \package{subfig}"=Paket zwingend benötigten Teil. Dieser Mechanismus ist veraltet und wird nicht mehr angeboten; stattdessen sollten sie diese Option dem \package{subfig}"=Paket übergeben und \thispackage\ nicht mehr explizit laden. \par\See{Dokumentation des \package{subfig}"=Paketes\cite{subfig}} \Message |Undefined boolean value `|\meta{value}|'.| \Description Es wurde versucht, eine boolische Option (wie z.B.~|singlelinecheck=| oder |hypcap=|) auf einen unbekannten Wert zu setzen. Nur die Werte |false|, |no|, |off|, |0| bzw.~|true|, |yes|, |on| und |1| sind hier möglich. \Message |Undefined format `|\meta{name}|'.| \Description Es wurde versucht, ein Beschriftungsformat auszuwählen, welches nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{formats}} \Message |Undefined label format `|\meta{name}|'.| \Description Es wurde versucht, ein Bezeichnungsformat auszuwählen, welches nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{formats}} \Message |Undefined label separator `|\meta{name}|'.| \Description Es wurde versucht, ein Beschriftungstrenner auszuwählen, welcher nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{formats}} \Message |Undefined list-of format `|\meta{name}|'.| \Description Es wurde versucht, ein Listenformat auszuwählen, welches nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{listof}} \Message |Undefined position `|\meta{name}|'.| \Description Es wurde versucht, den Positionshinweis auf einen unbekannten Wert zu setzen. Vielleicht ein Schreibfehler!? \par\See{\Ref{skips}} \Message |Undefined style `|\meta{name}|'.| \Description Es wurde versucht, ein Beschriftungsstil auszuwählen, welcher nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{style}} \Message |Undefined text format `|\meta{name}|'.| \Description Es wurde versucht, ein Textformat auszuwählen, welches nicht definiert ist. Vielleicht ein Schreibfehler!? \par\See{\Ref{formats}} \Message |You can't use both, the (obsolete) caption2 *and*|\\ |the (current) caption package.| \Description Die Pakete \package{caption} und \package{caption2} können nicht innerhalb eines Dokumentes gleichzeitig verwendet werden. Verwenden Sie bitte nur das aktuelle \package{caption}"=Paket. \par\See{\Ref{caption2}} \Message |You can't use the caption package option|\\ | `tableposition=|\meta{position}|'|\\ |and use the |\meta{package}| package, too.|\\ {\color{black}\hspace{1.5em}-- oder --}\\ |You can't use the global option|\\ | `tablecaptionabove'|\\ |and use the |\meta{package}| package, too.| \Description % (ftcap,nonfloat,topcapt) Das angegebene Paket mischt sich ebenfalls in die Verwendung der Abstände über- und unterhalb der Beschriftungen ein. Sie müssen sich daher für eines der Pakete -- das angegebene oder \thispackage\ -- zu entscheiden, um falsche Abstände zu verhindern. \par\See{\Ref{skips}} \end{Warnings} % --------------------------------------------------------------------------- % \pagebreak[4] \section{Weiterf"uhrende Dokumente} Folgende, im Internet verfügbare Dokumente m"ochte ich an dieser Stelle jedem ans Herz legen: \begin{itemize} \item Die \TeX\ FAQ -- "`Frequently Asked Questions"' über \TeX\ und \LaTeX: \begin{quote}\url{http://faq.tug.org/}\end{quote} \iffalse \item Die DANTE-FAQ -- Oft gestellte Fragen \& deren Antworten: \begin{quote}\url{http://www.dante.de/faq/de-tex-faq/}\end{quote} \fi \item \emph{"`Hilfe für LaTeX-Einsteiger"'} von Christian Faulhammer: \begin{quote}\url{http://www.minimalbeispiel.de/}\end{quote} \item \emph{"`Gleitobjekte -- die richtige Schmierung"'} von Axel Reichert erl"autert den Umgang mit gleitenden Umgebungen und ist hier im Netz zu finden: \begin{quote} \url{ftp://dante.ctan.org/pub/tex/info/german/gleitobjekte/} \end{quote} \item \emph{"`Bilder einfügen in \LaTeX: Ein How-To"'} von Dominik Bischoff beinhaltet die häufigsten Fragen und Antworten, die im Zusammenhang mit \LaTeX\ und Abbildungen auftreten: \begin{quote} \url{http://tug.ctan.org/info/l2picfaq/german/l2picfaq.pdf} \end{quote} \item \textsf{epslatex} von Keith Reckdahl enth"alt viele n"utzliche Tips im Zusammenhang mit der Einbindung von Graphiken in \LaTeXe. Das Dokument ist in Englisch und unter \begin{quote}\url{ftp://dante.ctan.org/pub/tex/info/epslatex/}\end{quote} zu finden. \end{itemize} % --------------------------------------------------------------------------- % \pagebreak[2] \section{Danksagungen} Von ganzem Herzen danke ich Katja Melzner, Steven D. Cochran, Frank Mittelbach, Olga Lapko, David Carlisle, Carsten Heinz und Keith Reckdahl. Weiterhin m"ochte ich mich herzlich bei Harald Harders, Peter L\"offler, Peng Yu, Alexander Zimmermann, Matthias Pospiech, J\"urgen Wieferink, Christoph Bartoschek, Uwe St\"ohr, Ralf Stubner, Geoff Vallis, Florian Keiler, J"urgen G"obel, Uwe Siart, Sang-Heon Shim, Henrik Lundell, David Byers, William Asquith, Prof.~Dr.~Dirk Hoffmann, Frank Martini und Danie Els f"ur ihre Hilfe beim stetigen Verbessern dieses Paketes bedanken. % --------------------------------------------------------------------------- % \pagebreak[4] \begin{thebibliography}{99} \bibitem{TLC2} Frank Mittelbach und Michel Goossens:\\ \newblock {\em Der {\LaTeX} Begleiter (2.\,Auflage)},\\ \newblock Addison-Wesley, 2004. \bibitem{beamer} Till Tantau:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf}% {\emph{User Guide to the Beamer Class, Version 3.07}},\\ March 11, 2007 \bibitem{KOMAScript} Markus Kohm \& Jens-Uwe-Morawski:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/koma-script/scrguide.pdf}% {\emph{KOMA-Script -- ein wandelbares \LaTeXe-Paket}},\\ 2007-03-02 \bibitem{NTG} Victor Eijkhout:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/ntgclass/classdoc.pdf}% {\emph{An introduction to the Dutch \LaTeX\ document classes}},\\ 3 September 1989 \bibitem{float} Anselm Lingnau:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/float/float.pdf}% {\emph{An Improved Environment for Floats}},\\ 2001/11/08 \bibitem{floatflt} Mats Dahlgren:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/floatflt/floatflt.pdf}% {\emph{Welcome to the floatflt package}},\\ 1998/06/05 \bibitem{floatrow} Olga Lapko:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf}% {\emph{The floatrow package documentation}},\\ 2006/07/24 \bibitem{fltpage} Sebastian Gross:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/fltpage/fltpage.pdf}% {\emph{Welcome to the beta test of fltpage package!}},\\ 1998/11/13 \bibitem{hyperref} Sebastian Rahtz \& Heiko Oberdiek:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}% {\emph{Hypertext marks in \LaTeX}},\\ June 14, 2007 \bibitem{hypcap} Heiko Oberdiek:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/oberdiek/hypcap.pdf}% {\emph{The hypcap package -- Adjusting anchors of captions}},\\ 2007/04/09 \bibitem{listings} Carsten Heinz \& Brooks Moses:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/listings/listings.pdf}% {\emph{The Listings Package}},\\ 2007/02/22 \bibitem{longtable} David Carlisle:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/required/tools/longtable.pdf}% {\emph{The longtable package}},\\ 2004/02/01 \bibitem{picinpar} Friedhelm Sowa:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}% {\emph{Pictures in Paragraphs}},\\ July 13, 1993 \bibitem{picins} Joachim Bleser und Edmund Lang:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex209/contrib/picins/mpic.dvi}% {\emph{PicIns-Benutzerhandbuch Version 3.0}},\\ September~1992 \bibitem{rotating} Sebastian Rahtz und Leonor Barroca:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/rotating/}% {\emph{A style option for rotated objects in \LaTeX}},\\ 1997/09/26 \bibitem{sidecap} Rolf Niepraschk \& Hubert G\"a\ss lein:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf}% {\emph{The sidecap package}},\\ 2003/06/06 \bibitem{subfigure} Steven D. Cochran:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/subfigure/subfigure.pdf}% {\emph{The subfigure package}},\\ 2002/07/02 \bibitem{subfig} Steven D. Cochran:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/subfig/subfig.pdf}% {\emph{The subfig package}},\\ 2005/07/05 \bibitem{supertabular} Johannes Braams und Theo Jurriens:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/supertabular/supertabular.pdf}% {\emph{The supertabular environment}},\\ 2002/07/19 \bibitem{threeparttable} Donald Arseneau:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/misc/threeparttable.sty}% {\emph{Three part tables: title, tabular environment, notes}},\\ 2003/06/13 \bibitem{wrapfig} Donald Arseneau:\\ \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/wrapfig/wrapfig.sty}% {\emph{WRAPFIG.STY ver 3.6}},\\ 2003/01/31 \end{thebibliography} % --------------------------------------------------------------------------- % \end{document}