diff options
author | Karl Berry <karl@freefriends.org> | 2012-05-16 23:12:50 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-05-16 23:12:50 +0000 |
commit | 33a91552392adacad1480db2e7ea4e966c0f4533 (patch) | |
tree | 6e4a4f772fcce778b4726d75f2ae00a217ca41d1 /Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex | |
parent | 20572a9d0911336a8588b561872220d6aba8e208 (diff) |
koma-script (15may12)
git-svn-id: svn://tug.org/texlive/trunk@26455 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex | 246 |
1 files changed, 122 insertions, 124 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex index de11c016ad2..150e563f87d 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-9.tex @@ -40,13 +40,15 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absaetze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== -\ProvidesFile{common-9.tex}[2009/01/04 KOMA-Script guide (common paragraphs)] -\translator{Gernot Hassenpflug} +\ProvidesFile{common-9.tex}[2012/05/15 KOMA-Script guide (common paragraphs)] +\translator{Markus Kohm\and Krickette Murabayashi} + +% Date of the translated German file: 2012/01/01 \makeatletter \@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}% @@ -56,95 +58,95 @@ \makeatother -\section{Fußnoten} +\section{Footnotes} \label{sec:\csname label@base\endcsname.footnotes}% \ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi% -\ifIgnoreThis -\IfNotCommon{scrextend}{Es gilt sinngemäß, was in - \autoref{sec:maincls.footnotes} geschrieben wurde.} -\else -\BeginIndex{}{Fussnoten=Fußnoten}% +\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls + +\IfNotCommon{scrextend}{% + What is described in + \autoref{sec:maincls.footnotes} applies, mutatis mutandis. } +\else %------------------------------------------------------- nur maincls - +\BeginIndex{}{footnotes}% \iffalse% Umbruchkorrekturtext -Selbstverständlich beherrscht \LaTeX{} auch Fußnoten. % +\LaTeX{} of course handles footnotes. % \fi% -\IfCommon{maincls}{Im Unterschied zu den Standardklassen bietet \KOMAScript{} - die Möglichkeit, die Form von Fußnoten zu konfigurieren.}% -\IfCommon{scrlttr2}{Die Anweisungen zum Setzen von Fußnoten sind in jeder - \LaTeX-Einführung, beispielsweise \cite{l2kurz}, zu finden. \KOMAScript{} - bietet darüber hinaus aber auch noch die Möglichkeit, die Form der Fußnoten - zu verändern.}% -\fi -\IfCommon{scrextend}{Die Fußnoten-Möglichkeiten der \KOMAScript-Klassen% -\ifIgnoreThis - , die in \autoref{sec:maincls.footnotes} beschrieben sind,% -\fi - \ werden - von \Package{scrextend} ebenfalls bereitgestellt. In der Voreinstellung wird - die Formatierung der Fußnoten jedoch der verwendeten Klasse überlassen. Dies - ändert sich, sobald die Anweisung \Macro{deffootnote} verwendet wird, die - auf - \autopageref{desc:\ifIgnoreThis maincls\else scrextend\fi.cmd.deffootnote} - näher erläutert wird.}% -\ifIgnoreThis\else +\IfCommon{maincls}{% + \KOMAScript{}, unlike the standard classes, provides features for + configuration of the footnote block format.}% +\IfCommon{scrlttr2}{% + The commands for setting footnotes may be found at each introduction into + \LaTeX, e.\,g., at \cite{lshort}. \KOMAScript{} provides additional features + to change the footnote block format.}% +\fi %**************************************************** Ende nur maincls * +\IfCommon{scrextend}{% + Package \Package{scrextend} supports all the footnote features of + \KOMAScript +\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls + + , that are described at \autoref{sec:maincls.footnotes}% +\fi %**************************************************** Ende nur maincls * + . Nevertheless, by default the footnotes are under full control of the used + class. This changes as soon as command \Macro{deffootnote} (see + \autopageref{desc:\ifIgnoreThis maincls\else scrextend\fi.cmd.deffootnote}) + has been used.}% +\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls + +\else %------------------------------------------------------- nur maincls - \begin{Declaration} - \KOption{footnotes}\PName{Einstellung} + \KOption{footnotes}\PName{setting} \end{Declaration} -\BeginIndex{Option}{footnotes~=\PName{Einstellung}}% -\IfCommon{scrextend}{Bei vielen Klassen werden Fußnoten }% -\IfNotCommon{scrextend}{ \ChangedAt{v3.00}{\Class{scrbook}\and - \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}}Fußnoten werden +\BeginIndex{Option}{footnotes~=\PName{setting}}% +\IfCommon{scrextend}{At several classes footnotes }% +\IfNotCommon{scrextend}{\ChangedAt{v3.00}{\Class{scrbook}\and + \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}}Footnotes }% -im Text in der Voreinstellung mit kleinen, hochgestellten Ziffern -markiert. Werden zu einer Textstelle mehrere Fußnoten hintereinander gesetzt, -so entsteht der Eindruck, dass es sich nicht um zwei einzelne Fußnoten, -sondern um eine einzige Fußnote mit hoher Nummer handelt. Mit der Einstellung -\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} werden -Fußnoten, die unmittelbar aufeinander folgen, stattdessen mit Trennzeichen -aneinander gereiht. Das in \Macro{multfootsep}\IndexCmd{multfootsep} -definierte Trennzeichen ist mit einem Komma vorbelegt. Der gesamte Mechanismus -ist kompatibel zu \Package{footmisc}\IndexPackage{footmisc}, Version~5.3d -(siehe \cite{package:footmisc}) implementiert. Er wirkt sich sowohl auf -Fußnotenmarkierungen aus, die mit \Macro{footnote}\IndexCmd{footnote} gesetzt -wurden, als auch auf solche, die direkt mit -\Macro{footnotemark}\IndexCmd{footnotemark} ausgegeben werden. - -Es ist jederzeit möglich, auf die Voreinstellung -\OptionValue{footnotes}{nomultiple} zurückzuschalten. Bei Problemen mit -anderen Paketen, die Einfluss auf die Fußnoten nehmen, sollte die Option -jedoch nicht verwendet und die Einstellung auch nicht innerhalb des Dokuments -umgeschaltet werden. - -Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von -\Option{footnotes} bietet \autoref{tab:maincls.footnotes}% +will be marked with a tiny superscript number in text by default. If more than +one footnote falls at the same place, one may think that it is only one +footnote with a very large number instead of multiple footnotes +(i.\,e., footnote 12 instead of footnotes 1 and 2). Using \important{\OptionValue{footnotes}{multiple}} +\OptionValue{footnotes}{multiple}\IndexOption{footnotes=~multiple} will +separate multiple footnotes immediately next to each other by a separator +string. The predefined separator at +\Macro{multfootsep}\IndexCmd{multfootsep}\important{\Macro{multfootsep}} is a +single comma without space. The whole mechanism is compatible with package \Package{footmisc}\IndexPackage{footmisc}\important{\Package{footmisc}}, +Version~5.3d (see \cite{package:footmisc}). It is related not only to +footnotes placed using \Macro{footnote}\IndexCmd{footnote}, but +\Macro{footnotemark}\IndexCmd{footnotemark} too. + +Command \Macro{KOMAoptions} or \Macro{KOMAoption} may be used to switch back +to the default \OptionValue{footnotes}{nomultiple} at any time. If +any problems using another package that influences footnotes occur, it is +recommended not to use the option anywhere and not to change the +\PName{setting} anywhere inside the document. + +A summary of the available \PName{setting} values of \Option{footnotes} may +be found at \autoref{tab:maincls.footnotes}% \IfNotCommon{maincl}{, \autopageref{tab:maincls.footnotes}}% .% \IfCommon{maincls}{% \begin{table} - \caption[{Mögliche Werte für Option \Option{footnotes}}]{Mögliche Werte für - Option \Option{footnotes} zur Einstellung der Fußnoten} + \caption[{Available values for option \Option{footnotes}}] + {Available values for option \Option{footnotes} setting up footnotes} \label{tab:maincls.footnotes} \begin{desctabular} \pventry{multiple}{% - Unmittelbar aufeinander folgende Fußnotenmarkierungen werden durch - \Macro{multfootsep}\IndexCmd{multfootsep} voneinander getrennt - ausgegeben.% - \IndexOption{footnotes~=multiple}}% + At sequences of immediately following footnote marks, consecutive marks + will be separated by \Macro{multfootsep}\IndexCmd{multfootsep}.% + \IndexOption{footnotes~=\PValue{multiple}}}% \pventry{nomultiple}{% - Unmittelbar aufeinander folgende Fußnotenmarkierungen werden auch - unmittelbar aufeinander folgend ausgegeben.% - \IndexOption{footnotes~=nomultiple}}% + Immediately following footnotes will be handled like single footnotes + and not separated from each other.% + \IndexOption{footnotes~=\PValue{nomultiple}}}% \end{desctabular} \end{table}}% % -\EndIndex{Option}{footnotes~=\PName{Einstellung}} +\EndIndex{Option}{footnotes~=\PName{setting}} \begin{Declaration} - \Macro{footnote}\OParameter{Nummer}\Parameter{Text}\\ - \Macro{footnotemark}\OParameter{Nummer}\\ - \Macro{footnotetext}\OParameter{Nummer}\Parameter{Text}\\ + \Macro{footnote}\OParameter{number}\Parameter{text}\\ + \Macro{footnotemark}\OParameter{number}\\ + \Macro{footnotetext}\OParameter{number}\Parameter{text}\\ \Macro{multiplefootnoteseparator}\\ \Macro{multfootsep} \end{Declaration}% @@ -153,81 +155,77 @@ Eine Zusammenfassung der möglichen Werte für die \PName{Einstellung} von \BeginIndex{Cmd}{footnotetext}% \BeginIndex{Cmd}{multiplefootnoteseparator}% \BeginIndex{Cmd}{multfootsep}% -Fußnoten werden bei {\KOMAScript} genau wie bei den Standardklassen mit der -Anweisung \Macro{footnote} oder den paarweise zu verwendenden Anweisungen -\Macro{footnotemark} und \Macro{footnotetext} erzeugt. Genau wie bei den -Standardklassen ist es möglich, dass innerhalb einer Fußnote ein -Seiten"-umbruch erfolgt. Dies geschieht in der Regel dann, wenn die zugehörige -Fußnotenmarkierung so weit unten auf der Seite gesetzt wird, dass keine andere -Wahl bleibt, als die Fußnote auf die nächste Seite zu umbrechen. Im -Unterschied\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}\and \Class{scrlttr2}} zu den Standardklassen bietet -\KOMAScript{} aber zusätzlich die Möglichkeit, Fußnoten, die unmittelbar -aufeinander folgen, automatisch zu erkennen und durch ein Trennzeichen -auseinander zu rücken. Siehe hierzu die zuvor dokumentierte Option -\Option{footnotes}. - -Will man dieses Trennzeichen stattdessen von Hand setzen, so erhält man es -durch Aufruf von \Macro{multiplefootnoteseparator}. Diese Anweisung sollten -Anwender jedoch nicht umdefinieren, da sie neben dem Trennzeichen auch die -Formatierung des Trennzeichen, beispielsweise die Wahl der Schriftgröße und -das Hochstellen, enthält. Das Trennzeichen selbst ist in der Anweisung -\Macro{multfootsep} gespeichert. In der Voreinstellung ist dieses als +Similar to the standard classes, footnotes in {\KOMAScript} are produced +with the \Macro{footnote} command, or alternatively the paired usage of the +commands \Macro{footnotemark} and \Macro{footnotetext}. As in the standard +classes, it is possible that a page break occurs within a footnote. Normally +this happens if the footnote mark is placed so near the bottom of a page as to +leave {\LaTeX} no choice but to break the footnote onto the next page. +\KOMAScript\ChangedAt{v3.00}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}\and \Class{scrlttr2}}, unlike the standard classes, +can recognize and separate consecutive footnotes +automatically. See\important{\Option{footnote}} the previously documented +option \Option{footnotes} for this. + +If you want to set the separator manually, you may use +\Macro{multiplefootnoteseparator}. Note that this command shouldn't be +redefined, because it has been defined not only to be the separator string but +also the type style, i.\,e., font size and superscript. The separator string +without type style may be found at \Macro{multfootsep}. The +predefined default is % Umbruchkorrektur: listings korrigieren! \begin{lstcode}[belowskip=\dp\strutbox] \newcommand*{\multfootsep}{,} \end{lstcode} -definiert. Dieses kann umdefiniert werden. +and may be changed by redefining the command. \ifCommonscrlttr\else \begin{Example} \phantomsection\label{desc:maincls.cmd.footnote.example}% - Angenommen, Sie wollen zu einem Wort zwei Fußnoten setzen. Im ersten Ansatz - schreiben Sie dafür - \begin{lstcode} - Wort\footnote{erste Fußnote}\footnote{zweite Fußnote}. - \end{lstcode} - Nehmen wir weiter an, dass die Fußnoten mit 1 und 2 nummeriert werden. Da - die beiden Fußnotennummern direkt aufeinander folgen, entsteht jedoch der - Eindruck, dass das Wort nur eine Fußnote mit der Nummer 12 besitzt. Sie - könnten dies nun dadurch ändern, dass Sie mit - \begin{lstcode} + Assume you want to place two footnotes following a single word. First you may try +\begin{lstcode} + Word\footnote{1st footnote}\footnote{2nd footnote} +\end{lstcode} + for this. Assume that the footnotes will be numbered with 1 and 2. Now the + reader may think it's a single footnote 12, because the 2 + immediately follows the 1. You may change this using +\begin{lstcode} \KOMAoptions{footnotes=multiple} - \end{lstcode} - die automatische Erkennung von Fußnotenhäufungen aktivieren. Stattdessen - können Sie aber auch - \begin{lstcode} - Wort\footnote{erste Fußnote}\multiplefootnoteseparator - \footnote{zweite Fußnote} - \end{lstcode} - verwenden. Das sollte auch dann noch funktionieren, wenn die automatische - Erkennung aus irgendwelchen Gründen versagt oder nicht verwendet werden - kann. - - Nehmen wir nun an, dass Sie außerdem wollen, dass die Fußnotennummern - nicht nur durch ein Komma, sondern durch ein Komma gefolgt von einem - Leerzeichen getrennt werden sollen. In diesem Fall schreiben Sie - \begin{lstcode} +\end{lstcode} + which would switch on the automatic recognition of footnote sequences. As an + alternative you may use +\begin{lstcode} + Word\footnote{1st footnote}% + \multiplefootnoteseparator + \footnote{2nd footnote} +\end{lstcode} + This should give you the wanted result even if the automatic solution would + fail or couldn't be used. + + Further, assume you want the footnotes separated not only by a single + comma, but by a comma and a white space. In this case you may redefine +\begin{lstcode} \renewcommand*{\multfootsep}{,\nobreakspace} - \end{lstcode} - in Ihre Dokumentpräambel. \Macro{nobreakspace}\IndexCmd{nobreakspace} wurde - hier an Stelle eines normalen Leerzeichens gewählt, damit innerhalb der - Reihung der Fußnotenzeichen kein Absatz- oder Seitenumbruch erfolgen kann. +\end{lstcode} + at the document preamble. \Macro{nobreakspace}\IndexCmd{nobreakspace} + instead of a usual space character has been used in this case to avoid + paragraph or at least page breaks within footnote sequences. \end{Example}% \fi% -\IfCommon{scrlttr2}{Beispiele und ergänzende Hinweise sind - \autoref{sec:maincls.footnotes} ab - \autopageref{desc:maincls.cmd.footnote.example} zu entnehmen.}% +\IfCommon{scrlttr2}{% + Examples and additional information may be found at + \autoref{sec:maincls.footnotes} from + \autopageref{desc:maincls.cmd.footnote.example} onward.}% \EndIndex{Cmd}{footnote}% \EndIndex{Cmd}{footnotemark}% \EndIndex{Cmd}{footnotetext}% \EndIndex{Cmd}{multiplefootnoteseparator}% \EndIndex{Cmd}{multfootsep}% -\fi% IgnoreThis +\fi %**************************************************** Ende nur maincls * %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: us-ascii %%% TeX-master: "../guide" %%% End: |