diff options
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.tex | 292 |
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: |