summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex219
1 files changed, 110 insertions, 109 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
index 52854624c72..dfbf6fd9aff 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-5.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-5.tex}[2009/01/04 KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug}
+\ProvidesFile{common-5.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,21 +58,22 @@
\makeatother
-\section{Textauszeichnungen}
+\section{Text Markup}
\label{sec:\csname label@base\endcsname.textmarkup}%
\ifshortversion\IgnoreThisfalse\IfCommon{scrlttr2}{\IgnoreThistrue}\fi%
-\ifIgnoreThis%
-Es gilt sinngemäß, was in \autoref{sec:maincls.textmarkup} geschrieben
-wurde. Dabei sind Namen und Bedeutung der einzelnen Elemente in
-\else
-\BeginIndex{}{Text>Auszeichnung}%
-\BeginIndex{}{Schriftart}%
+\ifIgnoreThis %++++++++++++++++++++++++++++++++++++++++++++++ nur scrlttr2 +
+What is described in
+\autoref{sec:maincls.textmarkup} applies, mutatis mutandis.
+\else %---------------------------------------------------- nicht scrlttr2 -
+\BeginIndex{}{text>markup}%
+\BeginIndex{}{font}%
-\LaTeX{} verfügt über eine ganze Reihe von Anweisungen zur
-Textauszeichnung. Neben der Wahl der Schriftart gehören dazu auch Befehle zur
-Wahl einer Textgröße oder der Textausrichtung. Näheres zu den normalerweise
-definierten Möglichkeiten ist \cite{l2kurz}, \cite{latex:usrguide} und
-\cite{latex:fntguide} zu entnehmen.
+{\LaTeX} offers different possibilities for logical and direct
+markup\Index{logical markup}\Index{markup} of text.
+Selection of the
+font family commands, as well as choosing the font size and width is
+supported. More information about the standard font facilities may be found at
+\cite{lshort}, \cite{latex:usrguide}, and \cite{latex:fntguide}.
\begin{Declaration}
@@ -79,65 +82,74 @@ definierten Möglichkeiten ist \cite{l2kurz}, \cite{latex:usrguide} und
\end{Declaration}
\BeginIndex{Cmd}{textsubscript}%
\BeginIndex{Cmd}{textsuperscript}%
-Im \LaTeX-Kern ist bereits die Anweisung
-\Macro{textsuperscript}\IndexCmd{textsuperscript} definiert, mit der
-\PName{Text} höher gestellt werden kann. Leider bietet \LaTeX{} selbst keine
-entsprechende Anweisung, um Text tief\Index{Tiefstellung} statt
-hoch\Index{Hochstellung} zu stellen. \KOMAScript{} definiert dafür
-\Macro{textsubscript}. %
-\IfCommon{scrlttr2}{Ein Anwendungsbeispiel finden Sie in
+The \LaTeX-Kern already defines the command
+\Macro{textsuperscript}\IndexCmd{textsuperscript} to
+superscript\Index{text>superscript}\Index{superscript} text. Unfortunately,
+{\LaTeX} itself does not offer a command to produce text in
+subscript\Index{text>subscript}\Index{subscript} instead of
+superscript\Index{text>superscript}\Index{superscript}. {\KOMAScript}
+defines \Macro{textsubscript} for this purpose.
+
+\IfCommon{scrlttr2}{You may find an example of usage at
\autoref{sec:maincls.textmarkup},
\autopageref{desc:maincls.textsubscript.example}.}
-\IfCommon{scrextend}{Ein Anwendungsbeispiel finden Sie in
+\IfCommon{scrextend}{You may find an example of usage at
\autoref{sec:maincls.textmarkup},
\autopageref{desc:maincls.textsubscript.example}.}
%
\ifCommonmaincls
\begin{Example}
\phantomsection\label{desc:maincls.textsubscript.example}%
- Sie schreiben einen Text über den menschlichen Stoffwechsel. Darin kommen
- hin und wieder einfache chemische Summenformeln vor. Dabei sind einzelne
- Ziffern tief zu stellen. Im Sinne des logischen Markups definieren Sie
- zunächst in der Dokumentpräambel oder einem eigenen Paket:
- \begin{lstcode}
- \newcommand*{\Molek}[2]{#1\textsubscript{#2}}
- \end{lstcode}
- \newcommand*{\Molek}[2]{#1\textsubscript{#2}}%
- Damit schreiben Sie dann:
- \begin{lstcode}
- Die Zelle bezieht ihre Energie unter anderem aus der
- Reaktion von \Molek C6\Molek H{12}\Molek O6 und
- \Molek O2 zu \Molek H2\Molek O{} und
- \Molek C{}\Molek O2. Arsen (\Molek{As}{}) wirkt sich
- allerdings auf den Stoffwechsel sehr nachteilig aus.
- \end{lstcode}
- Das Ergebnis sieht daraufhin so aus:
+ You are writing a text on human metabolism. From time to time you
+ have to give some simple chemical formulas in which the numbers are
+ in subscript. For enabling logical markup you first define in the
+ document preamble or in a separate package:
+\begin{lstcode}
+ \newcommand*{\molec}[2]{#1\textsubscript{#2}}
+\end{lstcode}
+ \newcommand*{\molec}[2]{#1\textsubscript{#2}}
+ Using this you then write:
+\begin{lstcode}
+ The cell produces its energy partly from reaction of \molec C6\molec
+ H{12}\molec O6 and \molec O2 to produce \molec H2\Molec O{} and
+ \molec C{}\molec O2. However, arsenic (\molec{As}{}) has a quite
+ detrimental effect on the metabolism.
+\end{lstcode}
+ The output looks as follows:
\begin{ShowOutput}
- Die Zelle bezieht ihre Energie unter anderem aus der Reaktion von
- \Molek C6\Molek H{12}\Molek O6 und \Molek O2 zu \Molek H2\Molek
- O{} und \Molek C{}\Molek O2. Arsen (\Molek{As}{}) wirkt sich
- allerdings auf den Stoffwechsel sehr nachteilig aus.
+ The cell produces its energy from reaction of \molec C6\molec
+ H{12}\molec O6 and \molec O2 to produce \molec H2\molec O{} and
+ \molec C{}\molec O2. However, arsenic (\molec{As}{}) has a quite
+ detrimental effect on the metabolism.
\end{ShowOutput}
- Etwas später entscheiden Sie, dass Summenformeln grundsätzlich serifenlos
- geschrieben werden sollen. Nun zeigt sich, wie gut die Entscheidung für
- konsequentes logisches Markup war. Sie müssen nur die
- \Macro{Molek}-Anweisung umdefinieren:
- \begin{lstcode}
- \newcommand*{\Molek}[2]{%
- \textsf{#1\textsubscript{#2}}%
- }
- \end{lstcode}
- \renewcommand*{\Molek}[2]{\textsf{#1\textsubscript{#2}}}%
- Schon ändert sich die Ausgabe im gesamten Dokument:
+ Some time later you decide that the chemical formulas should be
+ typeset in sans serif. Now you can see the advantages of using
+ logical markup. You only have the redefine the \Macro{molec}
+ command:
+\begin{lstcode}
+ \newcommand*{\molec}[2]{\textsf{#1\textsubscript{#2}}}
+\end{lstcode}
+ \renewcommand*{\molec}[2]{\textsf{#1\textsubscript{#2}}}
+ Now the output in the whole document changes to:
\begin{ShowOutput}
- Die Zelle bezieht ihr Energie unter anderem aus der Reaktion von
- \Molek C6\Molek H{12}\Molek O6 und \Molek O2 zu \Molek H2\Molek
- O{} und \Molek C{}\Molek O2. Arsen (\Molek{As}{}) wirkt sich
- allerdings auf den Stoffwechsel sehr nachteilig aus.
+ The cell produces its energy partly from reaction of \molec
+ C6\molec H{12}\molec O6 and \molec O2 to produce \molec H2\molec
+ O{} and \molec C{}\molec O2. However, arsenic (\molec{As}{}) has
+ a quite detrimental effect on the metabolism.
\end{ShowOutput}
\end{Example}
-\iffalse % vielleicht in einer späteren Auf-lage
-Für Experten ist in \autoref{sec:experts.knowhow},
+\iftrue
+\begin{Explain}
+ In the example above, the notation ``\verb|\molec C6|'' is used. This
+ makes use of the fact that arguments consisting of only one
+ character do not have to be enclosed in parentheses. That is why
+ ``\verb|\molec C6|'' is similar to ``\verb|\molec{C}{6}|''. You
+ might already know this from indices or powers in mathematical
+ environments, such as ``\verb|$x^2$|'' instead of ``\verb|$x^{2}$|''
+ for ``$x^2$''.
+\end{Explain}
+\else % vielleicht in einer spaeteren Auflage
+F\"ur Experten ist in \autoref{sec:experts.knowhow},
\autopageref{desc:experts.macroargs} dokumentiert, warum das Beispiel
funktioniert, obwohl teilweise die Argumente von \Macro{Molek} nicht in
geschweifte Klammern gesetzt wurden.%
@@ -149,64 +161,53 @@ geschweifte Klammern gesetzt wurden.%
\begin{Declaration}
- \Macro{setkomafont}\Parameter{Element}\Parameter{Befehle}\\
- \Macro{addtokomafont}\Parameter{Element}\Parameter{Befehle}\\
- \Macro{usekomafont}\Parameter{Element}
+ \Macro{setkomafont}\Parameter{element}\Parameter{commands}\\
+ \Macro{addtokomafont}\Parameter{element}\Parameter{commands}\\
+ \Macro{usekomafont}\Parameter{element}
\end{Declaration}%
\BeginIndex{Cmd}{setkomafont}%
\BeginIndex{Cmd}{addtokomafont}%
\BeginIndex{Cmd}{usekomafont}%
-Mit\ChangedAt{v2.8p}{%
- \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}} Hilfe der beiden
-Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} ist es möglich, die
-\PName{Befehle} festzulegen, mit denen die Schrift eines bestimmten
-\PName{Element}s umgeschaltet wird. Theoretisch könnten als \PName{Befehle}
-alle möglichen Anweisungen einschließlich Textausgaben verwendet werden. Sie
-sollten sich jedoch unbedingt auf solche Anweisungen beschränken, mit denen
-wirklich nur ein Schriftattribut umgeschaltet wird. In der Regel werden dies
-die Befehle \Macro{normalfont}, \Macro{rmfamily}, \Macro{sffamily},
+With\ChangedAt{v2.8p}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} the help of the two commands \Macro{setkomafont} and
+\Macro{addtokomafont}, it is possible to define the \PName{commands} that
+change the characteristics of a given \PName{element}. Theoretically, all
+possible statements including literal text could be used as \PName{commands}.
+You should\textnote{Attention!}, however, absolutely limit yourself to those
+statements that really switch only one font attribute. This will usually be
+the commands \Macro{normalfont}, \Macro{rmfamily}, \Macro{sffamily},
\Macro{ttfamily}, \Macro{mdseries}, \Macro{bfseries}, \Macro{upshape},
-\Macro{itshape}, \Macro{slshape}, \Macro{scshape} sowie die Größenbefehle
-\Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large}, \Macro{large},
-\Macro{normalsize}, \Macro{small}, \Macro{footnotesize} und \Macro{tiny}
-sein. Die Erklärung zu diesen Befehlen entnehmen Sie bitte \cite{l2kurz},
-\cite{latex:usrguide} oder \cite{latex:fntguide}. Auch Farbumschaltungen wie
-\Macro{normalcolor} sind möglich (siehe \cite{package:graphics} und
-\cite{package:xcolor}).
-\iffalse % Umbruchkorrekturtext
-Das Verhalten bei Verwendung anderer Anweisungen,
-inbesondere solcher, die zu Umdefinierungen führen oder Ausgaben tätigen, ist
-nicht definiert. Seltsames Verhalten ist möglich und stellt keinen Fehler dar.
-\else
-Die Verwendung anderer Anweisungen, inbesondere
-solcher, die Umdefinierungen vornehmen oder zu Ausgaben führen, ist nicht
-vorgesehen. Seltsames Verhalten ist in diesen Fällen möglich und stellt
-keinen Fehler dar.
-\fi
+\Macro{itshape}, \Macro{slshape}, and \Macro{scshape}, as well as the font size
+commands \Macro{Huge}, \Macro{huge}, \Macro{LARGE}, \Macro{Large},
+\Macro{large}, \Macro{normalsize}, \Macro{small}, \Macro{footnotesize},
+\Macro{scriptsize}, and \Macro{tiny}. The description of these commands can be
+found in \cite{lshort}, \cite{latex:usrguide}, or \cite{latex:fntguide}. Color
+switching commands like \Macro{normalcolor} (see \cite{package:graphics} and
+\cite{package:xcolor}) are also acceptable. The behavior when using other
+commands, especially those that make redefinitions or generate output, is not
+defined. Strange behavior is possible and does not represent a bug.
-Mit \Macro{setkomafont} wird die Schriftumschaltung eines Elements mit einer
-völlig neuen Definition versehen. Demgegenüber wird mit \Macro{addtokomafont}
-die existierende Definition lediglich erweitert. Es wird empfohlen, beide
-Anweisungen nicht innerhalb des Dokuments, sondern nur in der Dokumentpräambel
-zu verwenden. Beispiele für die Verwendung entnehmen Sie bitte den Abschnitten
-zu den jeweiligen Elementen. Namen und Bedeutung der einzelnen Elemente sind
-in %
-\fi % IgnoreThis
+The command \Macro{setkomafont } provides a font switching command with a
+completely new definition. In contrast to this, the \Macro{addtokomafont}
+command merely extends an existing definition. It is recommended to not use
+both commands inside the document body, but only in the document preamble.
+Usage examples can be found in the paragraphs on the corresponding element.
+\fi %************************************************* Ende nicht scrlttr2 *
+Names and meanings of the individual items are listed in %
\IfNotCommon{scrextend}{\autoref{tab:\csname
- label@base\endcsname.elementsWithoutText} }%
+ label@base\endcsname.elementsWithoutText}}%
\IfCommon{scrextend}{\autoref{tab:maincls.elementsWithoutText},
- \autopageref{tab:maincls.elementsWithoutText} }%
-aufgelistet. %
-\IfCommon{scrextend}{Allerdings werden davon in \Package{scrextend} nur die
- Elemente für den Dokumenttitel, den schlauen Spruch und die Fußnoten
- behandelt. Das Element \FontElement{disposition} ist zwar auch verfügbar,
- wird jedoch von \Package{scrextend} ebenfalls nur für den Dokumenttitel
- verwendet. }%
-Die Voreinstellungen sind den jeweiligen Abschnitten zu entnehmen.
-
+ \autopageref{tab:maincls.elementsWithoutText}}%
+. %
+\IfCommon{scrextend}{However only the listed elements for the document title,
+ dicta, footnotes, and the \Environment{labeling} environment are
+ supported. Though element \FontElement{disposition} exists, it will also be
+ used for the document title only. This has been done for compatibility with
+ the \KOMAScript{} classes. }%
+The default values are shown in the corresponding paragraphs.
%%% Local Variables:
%%% mode: latex
-%%% coding: iso-latin-1
+%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End: