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