summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex255
1 files changed, 255 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
new file mode 100644
index 00000000000..dad2091a6f1
--- /dev/null
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-parmarkup.tex
@@ -0,0 +1,255 @@
+% ======================================================================
+% common-parmarkup.tex
+% Copyright (c) Markus Kohm, 2001-2017
+%
+% This file is part of the LaTeX2e KOMA-Script bundle.
+%
+% This work may be distributed and/or modified under the conditions of
+% the LaTeX Project Public License, version 1.3c of the license.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2005/12/01 or later and of this work.
+%
+% This work has the LPPL maintenance status "author-maintained".
+%
+% The Current Maintainer and author of this work is Markus Kohm.
+%
+% This work consists of all files listed in manifest.txt.
+% ----------------------------------------------------------------------
+% common-parmarkup.tex
+% Copyright (c) Markus Kohm, 2001-2017
+%
+% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
+% Version 1.3c, verteilt und/oder veraendert werden.
+% Die neuste Version dieser Lizenz ist
+% http://www.latex-project.org/lppl.txt
+% und Version 1.3c ist Teil aller Verteilungen von LaTeX
+% Version 2005/12/01 oder spaeter und dieses Werks.
+%
+% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
+% (allein durch den Autor verwaltet).
+%
+% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
+%
+% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
+% ======================================================================
+%
+% Paragraphs that are common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ----------------------------------------------------------------------
+%
+% Absaetze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
+% Verwaltet von Markus Kohm
+%
+% ======================================================================
+
+\KOMAProvidesFile{common-parmarkup.tex}
+ [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ KOMA-Script guide (common paragraph: Paragraph Markup)]
+\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}
+
+% Date of the translated German file: 2017-01-02
+
+\section{Paragraph Markup}
+\seclabel{parmarkup}%
+\BeginIndexGroup
+\BeginIndex{}{paragraph>markup}%
+
+\IfThisCommonLabelBase{maincls}{%
+ 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.%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ 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} need not be broken for letters only.%
+ }{\InternalCommonFileUsageError}%
+} %
+\IfThisCommonFirstRun{}{%
+ Apart from these suggestions, everything that has been written at
+ \autoref{sec:\ThisCommonFirstLabelBase.parmarkup} for the other
+ \KOMAScript{} classes is valid for letters too. So if you have alread read
+ and understood \autoref{sec:\ThisCommonFirstLabelBase.parmarkup} you can
+ jump to \autoref{sec:\ThisCommonLabelBase.parmarkup.next} on
+ \autopageref{sec:\ThisCommonLabelBase.parmarkup.next}.%
+}
+
+
+\begin{Declaration}
+ \OptionVName{parskip}{manner}
+\end{Declaration}
+\IfThisCommonLabelBase{maincls}{%
+ 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.%
+}{%
+ \IfThisCommonLabelBase{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.%
+ }{\InternalCommonFileUsageError}%
+} %
+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 does
+not 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}%
+\IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.08}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+}{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ \ChangedAt{v3.08}{\Class{scrlttr2}}%
+ }{%
+ \InternalComonFileUsageError%
+ }%
+} %
+will be called implicitly. The change will be valid and may be seen from the
+next paragraph.
+
+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:\ThisCommonFirstLabelBase.parskip}%
+\IfThisCommonFirstRun{.%
+ \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:\ThisCommonFirstLabelBase.parskip}%
+ }%
+ {%
+ Possible values of option \Option{parskip} (\emph{continuation})%
+ }%
+ % \begin{desctabular}
+ \entry{\PValue{false}, \PValue{off}, \PValue{no}%
+ \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~=\PValue{full}}%
+ }{%
+ 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-}{%
+ one line vertical space between paragraphs; the last line of a paragraph
+ may be arbitrarily filled\IndexOption{parskip~=\PValue{full-}}}%
+ \pventry{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*}{%
+ 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}{%
+ 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-}{%
+ one line vertical space between
+ paragraphs\IndexOption{parskip~=\PValue{half-}}}%
+ \pventry{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*}{%
+ 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%
+ \IfThisCommonLabelBase{maincls}{%
+ \ChangedAt{v3.08}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}%
+ }{%
+ \IfThisCommonLabelBase{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}%
+}{ at \autopageref{tab:\ThisCommonFirstLabelBase.parskip}.}
+
+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.%
+\IfThisCommonLabelBase{maincls}{ %
+ Additionally, these options ensure that the table of contents and the lists
+ of figures and tables are set without any additional spacing.%
+}{ %
+ Several element of the first letter page will be set without inter-paragraph
+ spacing always.%
+}%
+
+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}.%
+%
+\EndIndexGroup
+%
+\EndIndexGroup
+
+
+%%% Local Variables:
+%%% mode: latex
+%%% coding: us-ascii
+%%% TeX-master: "../guide"
+%%% End: