summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex164
1 files changed, 124 insertions, 40 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
index 7dd0e09f809..263b3c74128 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2006
+% Copyright (c) Markus Kohm, 2001-2007
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrbookreportarticle.tex
-% Copyright (c) Markus Kohm, 2001-2006
+% Copyright (c) Markus Kohm, 2001-2007
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3b, verteilt und/oder veraendert werden.
@@ -45,7 +45,7 @@
%
% ============================================================================
-\ProvidesFile{scrbookreportarticle.tex}[2006/07/01 KOMA-Script guide (chapter:
+\ProvidesFile{scrbookreportarticle.tex}[2007/01/09 KOMA-Script guide (chapter:
scrbook, scrreprt, scrartcl)]
% Date of translated german file: 2005-11-26
@@ -195,6 +195,67 @@ set, either by default or by the user.
\end{Explain}
\par
+\subsection{Optionen for Compatibility}
+\label{sec:maincls.compatibilityOptions}
+\BeginIndex{}{Compatibility}
+
+% TODO: Translate this
+\minisec{Sorry, Still waiting for translation:}
+Wer seine Dokumente im Quellcode archiviert, legt in der Regel allergroessten
+Wert darauf, dass bei zukuenftigen \LaTeX{}-Laeufen immer wieder exakt dasselbe
+Ergebnis erzielt wird. In einigen Faellen ist es aber so, dass Verbesserungen
+und Korrekturen an der Klasse zu aenderungen im Verhalten, inbesondere beim
+Umbruch, fuehren.
+
+\begin{Declaration}
+ \Option{version}\\
+ \XOption{version}=\PName{Wert}
+\end{Declaration}
+\BeginIndex{Option}{version}%
+Seit\ChangedAt{v2.96a}{\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}}
+Version~2.96a besteht bei \KOMAScript\ die Wahl, ob eine Quelldatei so weit
+irgend moeglich auch zukuenftig bei einem \LaTeX{}-Lauf zu exakt demselben
+Ergebnis fuehren soll oder ob jeweils entsprechend der Anpassungen der neusten
+Version der Klasse zu setzen ist. Zu welcher Version Kompatibilitaet
+herzustellen ist, wird dabei ueber die Option \Option{version}
+festgelegt. Voreingestellt ist Version~2.9t. Dasselbe Ergebnis kann mit
+\begin{lstlisting}
+ version=first
+\end{lstlisting}
+oder
+\begin{lstlisting}
+ version=2.9
+\end{lstlisting}
+oder
+\begin{lstlisting}
+ version=2.9t
+\end{lstlisting}
+erreicht werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird
+eine Warnung ausgegeben und sicherheitshalber \Option{version=}\PValue{first}
+angenommen. Mit
+\begin{lstlisting}
+ version=last
+\end{lstlisting}
+kann die jeweils neuste Version ausgewaehlt werden. In diesem Fall wird also
+auf zukuenftige Kompatibilitaet verzichtet. Wird die Option ohne Wertangabe
+verwendet, so wird ebenfalls \PValue{last} angenommen.
+
+Die Frage der Kompatiblitaet betrifft in erster Linie Fragen des Umbruchs. Neue
+Moeglichkeiten, die sich nicht auf den Umbruch auswirken, sind auch dann
+verfuegbar, wenn man per Option die Kompatibilitaet zu einer aelteren Version
+ausgewaehlt hat. Die Option hat keine Auswirkungen auf Umbruchaenderungen, die
+bei Verwendung einer neueren Version durch Beseitigung eindeutiger Fehler
+entstehen. Wer auch im Fehlerfall unbedingte Umbruchkompatibitlitaet benoetigt,
+sollte stattdessen mit dem Dokument auch die verwendete \KOMAScript-Version
+archivieren.
+
+Es ist zu beachten, dass die Option \Option{version} nach dem Laden der Klasse
+nicht mehr veraendert werden kann.%
+%
+\EndIndex{Option}{version}%
+%
+\EndIndex{}{Compatibility}
+
\subsection{Options for Page Layout}
\label{sec:maincls.typeareaOptions}
@@ -594,7 +655,7 @@ captions when the \Option{noonelinecaption} option is given.
\Option{noonelinecaption} option is used no such measurement is
made. The footnote numbers are therefore correct.
- But since \KOMAScript{} version 2.9 you don't need the option
+ But since \KOMAScript{} version~2.9 you don't need the option
\Option{noonelinecaption} to avoid the above described
effect. \KOMAScript{} classes contain a workaround, so if you have
footnotes at captions you simply should put the contents of the
@@ -710,7 +771,7 @@ structure and intention. I'm therefore sceptical of this evolution.
Since it makes no sense to include only one of the aforementioned lists
in the table of contents, there exists only one option
\Option{liststotoc} that causes entries for both types of lists to be
-included. This also includes any lists produced with version 1.2e or
+included. This also includes any lists produced with version~1.2e or
later of the \Package{float}\IndexPackage{float} package (see
\cite{package:float}). All these lists are unnumbered, since they
contain entries that reference other sections of the document.
@@ -956,8 +1017,8 @@ versa. It only changes the spacing between caption and e.g. tabular.
Note\OnlyAt{\Package{float}}\IndexPackage{float} that when using the
\Package{float} package, the options \Option{tablecaptionbelow} and
\Option{tablecaptionabove} cease to act correctly when the
-\Macro{refloatstyle} is applied to tables. More details of the \Package{float}
-package's \Macro{refloatstyle} can be obtained from
+\Macro{restylefloat} is applied to tables. More details of the \Package{float}
+package's \Macro{restylefloat} can be obtained from
\cite{package:float}. Additional support for \Package{float} may be found at
\autoref{sec:maincls.floats}, \autopageref{desc:maincls.floatstyle.komaabove}.
%
@@ -1126,26 +1187,30 @@ specification to the one used with the specified \PName{element}.
\feentry{chapter}{Title of the sectional unit \Macro{chapter}}%
\feentry{descriptionlabel}{Labels, i.e. the optional argument of
\Macro{item}, in the \Environment{description} environment}%
+ \feentry{dictum}{smart saing (see command \Macro{dictum})}%
\feentry{dictumauthor}{Author of a smart saying; used according to the
element \FontElement{dictumtext}}%
- \feentry{dictumtext}{Text of a smart saing (see command \Macro{dictum})}%
+ \feentry{dictumtext}{Another name for \FontElement{dictum}}%
+ \feentry{disposition}{All sectional unit titles, i.e. the arguments of
+ \Macro{part} down to \Macro{subparagraph} and \Macro{minisec}, including
+ the title of the abstract; used before the element of the corresponding
+ unit}%
\feentry{footnote}{Footnote text and marker}%
\feentry{footnotelabel}{Mark of a footnote; used according to the element
\FontElement{footnote}}%
\feentry{footnotereference}{Footnote reference in the text}%
+ \feentry{minisec}{Title of \Macro{minisec}}
\feentry{pagefoot}{The foot of a page, but also the head of a page}%
\feentry{pagehead}{The head of a page, but also the foot of a page}%
\feentry{pagenumber}{Page number in the header or footer}%
+ \feentry{pagination}{Another name for \FontElement{pagenumber}}%
\feentry{paragraph}{Title of the sectional unit \Macro{paragraph}}%
\feentry{part}{Title of the \Macro{part} sectional unit, without the line
with the part number}%
\feentry{partnumber}{Line with the part number in a title of the sectional
unit \Macro{part}}%
\feentry{section}{Title of the sectional unit \Macro{section}}%
- \feentry{sectioning}{All sectional unit titles, i.e. the arguments of
- \Macro{part} down to \Macro{subparagraph} and \Macro{minisec}, including
- the title of the abstract; used before the element of the corresponding
- unit}%
+ \feentry{sectioning}{Another name for \FontElement{disposition}}%
\feentry{subparagraph}{Title of the sectional unit \Macro{subparagraph}}%
\feentry{subsection}{Title of the sectional unit \Macro{subsection}}%
\feentry{subsubsection}{Title of the sectional unit \Macro{subsubsection}}%
@@ -1788,7 +1853,7 @@ Besides\ChangedAt{v2.8p}{%
of size, the settings for the element
\FontElement{title}\IndexFontElement{title} also take effect. By
default these settings are identical to the settings for the element
-\FontElement{sectioning}\IndexFontElement{sectioning} (see
+\FontElement{disposition}\IndexFontElement{disposition} (see
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). The font size is however
not affected (see \autoref{tab:maincls.elementsWithoutText},
@@ -2034,7 +2099,7 @@ The entry for the highest sectional unit below \Macro{part}, i.e.,
\Class{scrreprt}\IndexClass{scrreprt} or \Macro{section} with
\Class{scrartcl}\IndexClass {scrartcl} is not indented. It is however
affected by the settings of the element
-\FontElement{sectioning}\IndexFontElement{sectioning} (see
+\FontElement{disposition}\IndexFontElement{disposition} (see
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). There is no point
between the text of the sectional unit heading and the page number. The
@@ -2089,6 +2154,24 @@ can also be found by looking at the table of contents after the first
%
\EndIndex{Counter}{tocdepth}%
+% TODO: Translate this:
+\minisec{Sorry, Still waiting for translation:}
+\KOMAScript{} hat schon immer versucht, im Inhaltsverzeichnis Umbrueche
+unmittelbar zwischen einer Gliederungsebene und der zugehoerigen Unterebene,
+also beispielsweise zwischen einer Kapitel- und der zugehoeriger erster
+Abschnittsueberschrift, zu vermeiden. Leider funktionierte dieser Mechanismus
+bis Version~2.96 sehr schlecht bis gar nicht. In
+Version~2.96a\ChangedAt{v2.96a}{%
+ \Class{scrbook} \and\Class{scrreprt} \and\Class{scrartcl}} wurde er
+erheblich verbessert und sollte nun immer funktionieren. Allerdings kann dies
+zu Umbruchaenderungen im Inhaltsverzeichnis fuehren. Daher ist der neue
+Mechanismus nur aktiv, wenn die Kompatibilitaet nicht auf Version~2.96 oder
+kleiner eingestellt ist (siehe Option \Option{version},
+\autoref{sec:maincls.compatibilityOption},
+\autopageref{desc:maincls.option.version}). Der Mechanismus funktioniert auch
+nicht mehr, wenn die Befehle zur Erzeugung der Inhaltsverzeichniseintraege
+umdefiniert werden, etwa bei Verwendung des Pakets \Package{tocloft}.
+
\section{Lists of Floats}
As a rule, the lists of floats\index{float environments},
@@ -2205,7 +2288,7 @@ sections and so on.
\BeginIndex{Cmd}{subsubsection}%
\BeginIndex{Cmd}{paragraph}%
\BeginIndex{Cmd}{subparagraph}%
-The standard sectioning commands in {\KOMAScript} work quite similar
+The standard disposition commands in {\KOMAScript} work quite similar
to the standard classes. Normally the section headings show up in the
table of contents exactly as they are entered in the text. The entry
for the table of contents can be specified as an optional argument in
@@ -2232,11 +2315,11 @@ can be changed with the commands
\Macro{setkomafont}\IndexCmd{setkomafont} and
\Macro{addtokomafont}\IndexCmd{addtokomafont} described in
\autoref{sec:maincls.font}. First of all the element
-\FontElement{sectioning}\IndexFontElement{sectioning} is used, which
+\FontElement{disposition}\IndexFontElement{disposition} is used, which
is followed by a specific element for every section level (see
\autoref{tab:maincls.elementsWithoutText},
\autopageref{tab:maincls.elementsWithoutText}). The font for the element
-\FontElement{sectioning}\IndexFontElement{sectioning} is predefined as
+\FontElement{disposition}\IndexFontElement{disposition} is predefined as
\Macro{normalfont}\Macro{normalcolor}\Macro{sffamily}%
\Macro{bfseries}. The default font size for the specific elements depends
on the options \Option{bigheadings}, \Option{normalheadings} and
@@ -2299,9 +2382,9 @@ defaults are listed in \autoref{tab:maincls.structureElementsFont}
that the very big headings of document parts are to bold. You could change
this as follows:
\begin{lstlisting}
- \setkomafont{sectioning}{\normalcolor\sffamily}
+ \setkomafont{disposition}{\normalcolor\sffamily}
\part{Appendices}
- \addtokomafont{sectioning}{\bfseries}
+ \addtokomafont{disposition}{\bfseries}
\end{lstlisting}
Using the command above you only switch off the font attribute
\textbf{bold} for the heading ``Appendices''. A much more comfortable
@@ -2317,10 +2400,10 @@ defaults are listed in \autoref{tab:maincls.structureElementsFont}
\addtokomafont{partnumber}{\mdseries}
\end{lstlisting}
The last version is to be preferred because it gives you the correct
- result even when you change the \FontElement{sectioning}
- element\IndexFontElement{sectioning} as follows:
+ result even when you change the \FontElement{disposition}
+ element\IndexFontElement{disposition} as follows:
\begin{lstlisting}
- \setkomafont{sectioning}{\normalcolor\bfseries}
+ \setkomafont{disposition}{\normalcolor\bfseries}
\end{lstlisting}
With this change it is possible to set all section levels at once to not
longer use sans serif fonts.
@@ -2351,7 +2434,7 @@ following explanation.
case you want to use other fonts than the standard \TeX-Fonts\,---\,no matter
whether using CM \Index{CM fonts} or EC fonts\Index{EC fonts}\,---\,you should
consult an expert or redefine the font for the element
- \FontElement{sectioning}\IndexFontElement{sectioning} as seen in the example
+ \FontElement{disposition}\IndexFontElement{disposition} as seen in the example
above. You often find the combinations Times and Helvetica or Palatino with
Helvetica. The author of this documentation does not favour these
combinations.
@@ -2384,7 +2467,7 @@ following explanation.
\BeginIndex{Cmd}{subsubsection*}%
\BeginIndex{Cmd}{paragraph*}%
\BeginIndex{Cmd}{subparagraph*}%
-All sectioning commands exist as ``starred'' versions. They produce
+All disposition commands exist as ``starred'' versions. They produce
section headings which do not show up in the table of
contents\Index{table of contents}, in the page header\Index{header}
and which are not numbered\Index{numbering}. Not using a headline
@@ -2406,7 +2489,7 @@ style for one page. The applied style is defined in
As for the possibilities of font switching\ChangedAt{v2.8p}{%
\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} %
the same explanations apply which were given above with the normal
-sectioning commands. The elements of structuring are named in the same
+disposition commands. The elements of structuring are named in the same
way as the ``unstarred'' versions.
%
\EndIndex{Cmd}{part*}%
@@ -2417,7 +2500,7 @@ way as the ``unstarred'' versions.
\EndIndex{Cmd}{paragraph*}%
\EndIndex{Cmd}{subparagraph*}%
-\iffalse In the standard classes there are no further sectioning commands. In
+\iffalse In the standard classes there are no further disposition commands. In
particular, there are no commands which produce unnumbered chapters or
sections which show up in the table of contents or in the page header. \fi
@@ -2465,7 +2548,7 @@ page style is defined in the macros \Macro{partpagestyle} and
As for the possibilities of font switching\ChangedAt{v2.8p}{%
\Class{scrbook}\and\Class{scrreprt}\and\Class{scrartcl}} %
the same explanations apply which were given above with the normal
-sectioning commands. The elements of structuring are named in the same
+disposition commands. The elements of structuring are named in the same
way as the ``unstarred'' versions.
%
\EndIndex{Cmd}{addpart}%
@@ -2548,13 +2631,14 @@ any numbering.
\end{ShowOutput}
\end{Example}
-The font type of the sectioning command \Macro{minisec} can only be
+The font type of the disposition command \Macro{minisec} be
changed using the element
-\FontElement{sectioning}\IndexFontElement{sectioning} (see
+\FontElement{disposition}\IndexFontElement{disposition} (see
\autoref{tab:maincls.elementsWithoutText},
-\autopageref{tab:maincls.elementsWithoutText}). There is no specific
-element for \Macro{minisec}. This means you can't change the font size
-manually.
+\autopageref{tab:maincls.elementsWithoutText}) or
+\FontElement{minisec}\ChangedAt{2.96a}{%
+ \Class{scrbook} \and\Class{scrreprt} \and\Class{scrartcl}}. Default setting
+of element \FontElement{minisec} is empty.
%
\EndIndex{Cmd}{minisec}%
@@ -2585,7 +2669,7 @@ This command can be redefined with \Macro{renewcommand}.
You will get a formatting of the headings which is very close to the
standard classes. Even closer it will get when you combine this change
with the change of the element
- \FontElement{sectioning}\IndexFontElement{sectioning} mentioned
+ \FontElement{disposition}\IndexFontElement{disposition} mentioned
above.
\end{Example}
%
@@ -2738,7 +2822,7 @@ Since chapters only exist in the classes \Class{scrbook} and
\PValue{headings} works with running heads\Index{running
head}. For this, the commands \Macro{chaptermark} and
\Macro{sectionmark} as well as \Macro{sectionmark} and
- \Macro{subsectionmark} respectively are defined. Every sectioning
+ \Macro{subsectionmark} respectively are defined. Every disposition
command (\Macro{chapter}, \Macro{section}, \Macro{subsection} \dots)
automatically carries out the respective \Macro{\dots mark} command.
The parameter handed over takes the text of the section
@@ -2851,12 +2935,12 @@ respective \Macro{part}, \Macro{addpart}, \Macro{chapter} or
\autopageref{desc:maincls.option.abstracton}), the result would look similar
to:
\begin{ShowOutput}\centering
- {\LARGE\usekomafont{sectioning} Part III.\par\vspace{20pt}}
- {\LARGE\usekomafont{sectioning} Department for Word Processing\strut\par}
+ {\LARGE\usekomafont{disposition} Part III.\par\vspace{20pt}}
+ {\LARGE\usekomafont{disposition} Department for Word Processing\strut\par}
\begin{quote}\small
\vspace{3ex}
\begin{center}
- \usekomafont{sectioning}\abstractname
+ \usekomafont{disposition}\abstractname
\end{center}
\vspace{2ex} This is a blind text. This text should show, how a
printed text will look like at this place. If you read this text,
@@ -3001,7 +3085,7 @@ additional vertical space. You could easely use the command
\end{lstlisting}
The output would look as follows:
\begin{ShowOutput}
- {\usekomafont{sectioning}\usekomafont{chapter}%
+ {\usekomafont{disposition}\usekomafont{chapter}%
17\enskip Weather forecasting\par} \vspace{\baselineskip}
\dictum[Anonymous]{Forecasting is the art of saying what is going to
happen and then to explain why it didn't.}
@@ -4584,7 +4668,7 @@ options \Option{pointednumbers} and \Option{pointlessnumbers} in
\autopageref{desc:maincls.option.pointlessnumbers}.
Please note that \Macro{appendix} is a command, \emph{not} an
-environment! This command does not need an argument. The sectioning
+environment! This command does not need an argument. The disposition
commands in the appendix are used in the same way as in the main part.
%
@@ -4751,7 +4835,7 @@ environments.
\BeginIndex{Cmd}{sectfont}%
This macro sets the font which is used for all section headings, the
main title an the highest level below \Macro{part} in the table of
- contents. Use element \FontElement{sectioning} instead, which is
+ contents. Use element \FontElement{disposition} instead, which is
described in more detail in \autoref{sec:maincls.font}.%
\EndIndex{Cmd}{sectfont}%