summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex292
1 files changed, 154 insertions, 138 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
index 0ba42ca00b1..06051e8a95a 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-6.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-6.tex}[2009/01/04 KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug}
+\ProvidesFile{common-6.tex}[2012/05/15 KOMA-Script guide (common paragraphs)]
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+
+% Date of the translated German file: 2012/01/01
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -56,171 +58,185 @@
\makeatother
-\section{Absatzauszeichnung}
+\section{Paragraph Markup}
\label{sec:\csname label@base\endcsname.parmarkup}%
\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
-\ifIgnoreThis\else
-\BeginIndex{}{Absatz>Auszeichnung}%
+\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
+\else %------------------------------------------------------- nur maincls -
+\BeginIndex{}{paragraph>markup}%
\IfCommon{maincls}{%
- Die Standardklassen setzen Absätze\Index[indexmain]{Absatz} normalerweise
- mit Absatzeinzug und ohne Absatzabstand. Bei Verwendung eines normalen
- Satzspiegels, wie ihn \Package{typearea} bietet, ist dies die
- vorteilhafteste Absatzauszeichnung. Würde man ohne Einzug und Abstand
- arbeiten, hätte der Leser als Anhaltspunkt nur die Länge der letzten Zeile.
- Im Extremfall kann es sehr schwer sein, zu erkennen, ob eine Zeile voll ist
- oder nicht. Des Weiteren stellt der Typograf fest, dass die Auszeichnung des
- Absatzendes am Anfang der nächsten Zeile leicht vergessen ist. Demgegenüber
- ist eine Auszeichnung am Absatzanfang einprägsamer. Der Absatzabstand hat
- den Nachteil, dass er in verschiedenem Zusammenhang leicht verloren geht. So
- wäre nach einer abgesetzten Formel nicht mehr festzustellen, ob der Absatz
- fortgesetzt wird oder ein neuer beginnt. Auch am Seitenanfang müsste
- zurückgeblättert werden, um feststellen zu können, ob mit der Seite auch ein
- neuer Absatz beginnt. All diese Probleme sind beim Absatzeinzug nicht
- gegeben. Eine Kombination von Absatzeinzug und Absatzabstand ist wegen der
- übertriebenen Redundanz abzulehnen. Der Einzug\Index[indexmain]{Einzug}
- alleine ist deutlich genug. Der einzige Nachteil des Absatzeinzugs liegt in
- der Verkürzung der Zeile. Damit gewinnt der
- Absatzabstand\Index{Absatz>Abstand} bei ohnehin kurzen Zeilen, etwa im
- Zeitungssatz, seine Berechtigung.}%
-\fi% IgnoreThis
+ The\textnote{paragraph indent vs. paragraph spacing} standard classes
+ normally set paragraphs\Index[indexmain]{paragraph} indented and without any
+ vertical inter-paragraph space. This is the best solution when using a
+ regular page layout, like the ones produced with the \Package{typearea}
+ package. If neither indentation nor vertical space is used, only the length
+ of the last line would give the reader a reference point. In extreme cases,
+ it is very difficult to detect whether a line is full or not. Furthermore,
+ it is found that a marker at the paragraph's end tends to be easily
+ forgotten by the start of the next line. A marker at the paragraph's
+ beginning is more easily remembered. Inter-paragraph spacing has the
+ drawback of disappearing in some contexts. For instance, after a displayed
+ formula it would be impossible to detect if the previous paragraph continues
+ or if a new one begins. Also, when starting to read at the top of a new page
+ it might be necessary to look at the previous page in order determine if a
+ new paragraph has been started or not. All these problems disappear when
+ using indentation. A combination of indentation and vertical inter-paragraph
+ spacing is extremely redundant and therefore should be avoided. The
+ indentation\Index[indexmain]{indentation} is perfectly sufficient by
+ itself. The only drawback of indentation is the reduction of the line
+ length. The use of inter-paragraph spacing\Index{paragraph>spacing} is
+ therefore justified when using short lines, for instance in a newspaper.}%
+\fi %**************************************************** Ende nur maincls *
\IfCommon{scrlttr2}{%
- In der Einleitung zu \autoref{sec:maincls.parmarkup} ab
- \autopageref{sec:maincls.parmarkup} wird dargelegt, warum der Absatzeinzug
- gegenüber dem Absatzabstand vorzuziehen ist. Die Elemente, auf die sich
- diese Argumente beziehen, beispielsweise Abbildungen, Tabellen, Listen,
- abgesetzte Formeln und auch neue Seiten, sind in Standardbriefen eher
- selten. Auch sind Briefe normalerweise nicht so umfänglich, dass ein nicht
- erkannter Absatz sich schwerwiegend auf die Lesbarkeit auswirkt. Die
- Argumente sind daher bei Standardbriefen eher schwach. Dies dürfte ein Grund
- dafür sein, dass der Absatzabstand bei Briefen eher gebräuchlich ist. Es
- bleiben damit für Standardbriefe im Wesentlichen zwei Vorteile des
- Absatzeinzugs. Zum einen hebt sich ein solcher Brief aus der Masse hervor
- und zum anderen durchbricht man damit nicht nur für Briefe das einheitliche
- Erscheinungsbild aller Dokumente aus einer Quelle, die so genannte
- \emph{Corporate Identity}.}%
-\ifIgnoreThis%
-\IfCommon{scrlttr2}{\ Von dieser Unterscheidung gegenüber den anderen
- \KOMAScript-Klassen abgesehen gilt, was in \autoref{sec:maincls.parmarkup}
- geschrieben wurde.}
-\else
+ In the preliminaries of \autoref{sec:maincls.parmarkup},
+ \autopageref{sec:maincls.parmarkup} it was argued why paragraph indent is
+ preferred over paragraph spacing. But the elements the argumentation depends on,
+ i.\,e., figures, tables, lists, equations, and even new pages,
+ are rare. Often letters are not so long that an oversighted paragraph will
+ have serious consequences to the readability of the document. Because of
+ this, the arguments are less serious for standard letters. This may be one
+ reason that in letters you often encounter paragraphs marked not with
+ indentation of the first line, but with a vertical skip between
+ them. But there may be still some advantages of the paragraph indent. One
+ may be that such a letter is highlighted in the mass of letters. Another may
+ be that the \emph{corporate identity} needn't be broken for letters only.}%
+\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht maincls +
+\IfCommon{scrlttr2}{Apart from these suggestions, everything that has been
+ written at \autoref{sec:maincls.parmarkup} for the other \KOMAScript{}
+ classes is valid for letters too.}
+\else %------------------------------------------------------- nur maincls -
\begin{Declaration}
- \KOption{parskip}\PName{Abstandsart}
+ \KOption{parskip}\PName{manner}
\end{Declaration}
-\BeginIndex{Option}{parskip~=\PName{Methode}}%
+\BeginIndex{Option}{parskip~=\PName{manner}}%
\IfCommon{maincls}{%
- Hin und wieder wird ein Layout mit Absatzabstand an Stelle des
- voreingestellten Absatzeinzugs gefordert. Die \KOMAScript-Klassen bietet mit
- der Option \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and
- \Class{scrreprt}\and \Class{scrartcl}} }%
-\IfCommon{scrlttr2}{Bei Briefen findet man häufiger ein Layout mit
- Absatzabstand an Stelle des voreingestellten Absatzeinzugs. Die
- \KOMAScript-Klasse \Class{scrlttr2} bietet mit der Option \Option{parskip}
-}%
-eine Reihe von Möglichkeiten, um dies
-zu erreichen. Die \PName{Methode} setzt sich dabei aus zwei Teilen
-zusammen. Der erste Teil ist entweder \PValue{full} oder \PValue{half}, wobei
-\PValue{full} für einen Absatzabstand von einer Zeile und \PValue{half} für
-einen Absatzabstand von einer halben Zeile steht. Der zweite Teil ist eines
-%der Zeichen »\PValue{*}«, »\PValue{+}«, »\PValue{-}« und kann auch
-entfallen. Lässt man das Zeichen weg, so wird in der letzten Zeile des
-Absatzes am Ende mindestens ein Geviert, das ist 1\Unit{em}, frei gelassen.
-Mit dem Pluszeichen wird am Zeilenende mindestens ein Drittel und mit dem
-Stern mindestens ein Viertel einer normalen Zeile frei gelassen. Mit der
-Minus-Variante werden keine Vorkehrungen für die letzte Zeile eines Absatzes
-getroffen.
+ Once in a while there are requests for a document layout with vertical
+ inter-paragraph spacing instead of indentation. The \KOMAScript{} classes
+ provide with option \Option{parskip}\ChangedAt{v3.00}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}} several capabilities to use
+ inter-paragraph spacing instead of paragraph indent.}
+\IfCommon{scrlttr2}{%
+ Especially in letters you often encounter paragraphs marked not with
+ indentation of the first line, but with a vertical skip between
+ them. \KOMAScript{} class \Class{scrlttr2} provides several capabilities for
+ this.}
+
+The \PName{manner} consists of two elements. The first element is either
+\PValue{full} or \PValue{half}, meaning the space amount of one line or only
+half of a line. The second element is ``\PValue{*}'', ``\PValue{+}'', or
+``\PValue{-}'', and may be omitted. Without the second element the last line of
+a paragraph will end with white space of at least 1\Unit{em}. With the plus
+character as second element the white space amount will be a third, and with
+the asterisk a fourth, of the width of a normal line. The minus variant doesn't
+take care about the white space at the end of the last line of a paragraph.
+
+The setting may be changed at any place inside the document. In this case the
+command \Macro{selectfont}\IndexCmd{selectfont}%
+\IfCommon{maincls}{\ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}}\IfCommon{scrlttr2}{\ChangedAt{v3.08}{\Class{scrlttr2}}}
+will be called implicitly. The change will be valid and may be seen from the
+next paragraph.
-Neben den sich so ergebenden acht Kombinationen ist es noch möglich, als
-\PName{Methode} die Werte für einfache Schalter aus
-\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} zu
-verwenden. Das Einschalten der Option entspricht dabei \PValue{full} ohne
-angehängtes Zeichen für den Freiraum der letzten Absatzzeile, also mit
-mindestens einem Geviert Freiraum am Ende des Absatzes. Das Ausschalten der
-Option schaltet hingegen wieder auf Absatzeinzug von einem Geviert um. Dabei
-darf die letzte Zeile eines Absatzes auch bis zum rechten Rand reichen. Einen
-Überblick über alle möglichen Werte für \PName{Methode} bietet
-\autoref{tab:maincls.parskip}%
-\IfCommon{scrlttr2}{auf \autopageref{tab:maincls.parskip}}%
+Besides the resulting eight possible combinations for \PName{manner}, the values
+for simple switches shown at \autoref{tab:truefalseswitch},
+\autopageref{tab:truefalseswitch} may be used. Switching on the option would
+be the same as using \PValue{full} without annex and therefore will result in
+inter-paragraph spacing of one line with at least 1\Unit{em} white space at
+the end of the last line of each paragraph. Switching off the options would
+reactivate the default of 1\Unit{em} indent at the first line of the
+paragraph instead of paragraph spacing. All the possible values of option
+\Option{parskip} are shown in \autoref{tab:maincls.parskip}%
+\IfCommon{scrlttr2}{ at \autopageref{tab:maincls.parskip}}%
.
\IfCommon{maincls}{%
-\begin{desctable}
- \caption[{Mögliche Werte für Option \Option{parskip}}]{Mögliche Werte für
- Option \Option{parskip} zur Auswahl der Kennzeichnung von
- Absätzen\label{tab:maincls.parskip}}\\
- \Endfirsthead%
- \caption[]{Mögliche Werte für Option \Option{parskip}
- (\emph{Fortsetzung})}\\
- \Endhead%
- \standardfoot%
+ \begin{desclist}
+ % Umbruchkorrektur
+ \vskip-\ht\strutbox
+ \renewcommand{\abovecaptionskipcorrection}{-\normalbaselineskip}%
+% \begin{table}
+ \desccaption
+% \caption
+ [{Possible values of option \Option{parskip}}]{%
+ Possible values of option \Option{parskip} to select
+ the paragraph mark\label{tab:maincls.parskip}%
+ }%
+ {%
+ Possible values of option \Option{parskip} (\emph{continuation})%
+ }%
+ % \begin{desctabular}
\entry{\PValue{false}, \PValue{off}, \PValue{no}%
- \IndexOption{parskip~=false}}{%
- Absätze werden durch einen Einzug der ersten Zeilen von einem Geviert
- (1\Unit{em}) gekennzeichnet. Der erste Absatz eines Abschnitts wird nicht
- eingezogen.}%
+ \IndexOption{parskip~=\PValue{false}}}{%
+ paragraph indentation instead of vertical space; the last line of a
+ paragraph may be arbitrarily filled}%
\entry{\PValue{full}, \PValue{true}, \PValue{on}, \PValue{yes}%
- \IndexOption{parskip~=full}%
+ \IndexOption{parskip~=\PValue{full}}%
}{%
- Absätze werden durch einen vertikalen Abstand von einer Zeile
- gekennzeichnet, Absatzenden durch einen Leerraum von mind. ein
- Geviert (1\Unit{em}) der Grundschrift am Ende der letzten Zeile.}%
+ one line vertical space between paragraphs; there must be at least
+ 1\Unit{em} free space in the last line of a paragraph}%
\pventry{full-}{%
- Absätze werden durch einen vertikalen Abstand von einer Zeile
- gekennzeichnet. Absatzenden werden nicht
- gekennzeichnet.\IndexOption{parskip~=full-}}%
+ one line vertical space between paragraphs; the last line of a paragraph
+ may be arbitrarily filled\IndexOption{parskip~=\PValue{full-}}}%
\pventry{full+}{%
- \looseness=-1
- Absätze werden durch einen vertikalen Abstand von einer Zeile
- gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
- Viertel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=full+}}%
+ one line vertical space between paragraphs; there must be at least a third
+ of a line free space at the end of a
+ paragraph\IndexOption{parskip~=\PValue{full+}}}%
\pventry{full*}{%
- Absätze werden durch einen vertikalen Abstand von einer Zeile
- gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
- Drittel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=full*}}%
+ one line vertical space between paragraphs; there must be at least a
+ quarter of a line free space at the end of a
+ paragraph\IndexOption{parskip~=\PValue{full*}}}%
\pventry{half}{%
- Absätze werden durch einen vertikalen Abstand von einer halben Zeile
- gekennzeichnet. Absatzenden durch einen Leerraum von mind. ein Geviert
- (1\Unit{em}) der normalen Schrift am Ende
- gekennzeichnet.\IndexOption{parskip~=half}}%
+ half a line vertical space between paragraphs; there must be at least
+ 1\Unit{em} free space in the last line of a
+ paragraph\IndexOption{parskip~=\PValue{half}}}%
\pventry{half-}{%
- Absätze werden durch einen vertikalen Abstand von einer halben Zeile
- gekennzeichnet. Absatzenden werden nicht
- gekennzeichnet.\IndexOption{parskip~=half-}}%
+ one line vertical space between
+ paragraphs\IndexOption{parskip~=\PValue{half-}}}%
\pventry{half+}{%
- Absätze werden durch einen vertikalen Abstand von einer halben Zeile
- gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
- Viertel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=half+}}%
+ half a line vertical space between paragraphs; there must be at least a
+ third of a line free space at the end of a
+ paragraph\IndexOption{parskip~=\PValue{half+}}}%
\pventry{half*}{%
- Absätze werden durch einen vertikalen Abstand von einer Zeile
- gekennzeichnet. Absatzenden werden durch einen Leerraum von mind. einem
- Drittel einer normalen Zeile gekennzeichnet.\IndexOption{parskip~=half*}}%
-\end{desctable}}
+ half a line vertical space between paragraphs; there must be at least a
+ quarter of a line free space at the end of a
+ paragraph\IndexOption{parskip~=\PValue{half+}}}%
+ \pventry{never}{%
+ there \IfCommon{maincls}{\ChangedAt{v3.08}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}}%
+ \IfCommon{scrlttr2}{\ChangedAt{v3.08}{\Class{scrlttr2}}}%
+ will be no inter-paragraph spacing even if additional vertical spacing is
+ needed for the vertical adjustment with
+ \Macro{flushbottom}\IndexCmd{flushbottom}%
+ \IndexOption{parskip~=\PValue{never}}}%
+% \end{desctabular}
+% \end{table}%
+\end{desclist}%
+}
-Wird ein Absatzabstand verwendet, so verändert sich auch der Abstand vor, nach
-und innerhalb von Listenumgebungen. Dadurch wird verhindert, dass diese
-Umgebungen oder Absätze innerhalb dieser Umgebungen stärker vom Text abgesetzt
-werden als die Absätze des normalen Textes voneinander.%
-\IfCommon{maincls}{ Inhalts"~, Abbildungs"~ und Tabellenverzeichnis werden
- immer ohne zusätzlichen Absatzabstand gesetzt.}%
-\IfCommon{scrlttr2}{% Umbruchkorrekturtext
- \iffalse%
- \ Verschiedene Elemente des Briefbogens werden immer ohne Absatzabstand
- gesetzt.%
- \fi}%
+All\textnote{Attention!} eight \PValue{full} and \PValue{half} option values
+also change the spacing before, after, and inside list environments. This
+avoids the problem of these environments or the paragraphs inside them having
+a larger separation than the separation between the paragraphs of normal text.
+\IfCommon{maincls}{Additionally, these options ensure that the table of
+ contents and the lists of figures and tables are set without any additional
+ spacing.}%
+\IfCommon{scrlttr2}{Several element of the first letter page will be set
+ without inter-paragraph spacing always.}
-Voreingestellt ist bei \KOMAScript{} das Verhalten
-\OptionValue{parskip}{false}. Hierbei gibt es keinen Absatzabstand, sondern
-einen Absatzeinzug von 1\Unit{em}.%
+The default behaviour of {\KOMAScript} follows
+\OptionValue{parskip}{false}. In this case, there is no spacing between
+paragraphs, only an indentation of the first line by 1\Unit{em}.%
%
-\EndIndex{Option}{parskip~=\PName{Methode}}%
+\EndIndex{Option}{parskip~=\PName{manner}}%
%
-\EndIndex{}{Absatz>Auszeichnung}
-\fi % IgnoreThis
+\EndIndex{}{paragraph>markup}
+\fi %**************************************************** Ende nur maincls *
%%% Local Variables:
%%% mode: latex
-%%% coding: iso-latin-1
+%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End: