summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex79
1 files changed, 43 insertions, 36 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
index ff57abce762..4ef54b7e68e 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-marginpar.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-marginpar.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2018
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,33 +46,33 @@
% ======================================================================
\KOMAProvidesFile{common-marginpar.tex}
- [$Date: 2017-01-02 13:30:07 +0100 (Mon, 02 Jan 2017) $
+ [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug\and Markus Kohm}
+\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2017-01-02
+% Date of the translated German file: 2018-01-29
-\section{Margin Notes}
+\section{Marginal Notes}
\seclabel{marginNotes}%
\BeginIndexGroup
-\BeginIndex{}{margin>notes}%
+\BeginIndex{}{marginal notes}%
\IfThisCommonFirstRun{}{%
- All of what is described in
- \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} is generally
- applicable. So if you have alread read and understood
- \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} you can switch to
+ The information in \autoref{sec:\ThisCommonFirstLabelBase.marginNotes}
+ applies equally to this chapter. So if you have already read and understood
+ \autoref{sec:\ThisCommonFirstLabelBase.marginNotes}, you can skip ahead to
\autoref{sec:\ThisCommonLabelBase.marginNotes.next},
\autopageref{sec:\ThisCommonLabelBase.marginNotes.next}.%
}
-Aside from the text area, that normally fills the typing area, usually a
-marginalia column may be found. Margin notes will be printed at this area.
+In addition to the text area, which normally fills the type area, documents
+often contain a column for marginalia. You can set marginal notes in this
+area.
\IfThisCommonLabelBase{scrlttr2}{%
- Nevertheless, margin notes are unusual at letters and should be used
- seldomly.%
+ In letters, however, marginal notes are unusual and should be used
+ sparingly.%
}{%
- At lot of them may be found in this \iffree{manual}{book}.%
+ This \iffree{guide}{book} makes frequent use of them.%
}%
@@ -80,31 +80,30 @@ marginalia column may be found. Margin notes will be printed at this area.
\Macro{marginpar}\OParameter{margin note left}\Parameter{margin note}%
\Macro{marginline}\Parameter{margin note}
\end{Declaration}%
-Usually margin notes\Index[indexmain]{margin>notes} in {\LaTeX} are
-inserted with the command \Macro{marginpar}. They are placed in the
-outer margin. In documents with one-sided layout the right border is
-used. Though \Macro{marginpar} can take an optional different margin
-note argument in case the output is in the left margin, margin notes
-are always set in justified layout. However, experience has shown
-that many users prefer left- or right-aligned margin notes instead.
-To facilitate this, {\KOMAScript} offers the command
-\Macro{marginline}.
+Marginal notes\Index[indexmain]{marginal notes} in {\LaTeX} are usually
+inserted with the \Macro{marginpar} command. They are placed in the outer
+margin. One-sided documents use the right border. Although you can specify a
+different marginal note for \Macro{marginpar} in case it winds up in the left
+margin, marginal notes are always fully justified. However, experience has
+shown that many users prefer left- or right-justified marginal notes
+instead. For this purpose, {\KOMAScript} offers the \Macro{marginline}
+command.
\IfThisCommonFirstRun{%
\iftrue%
}{%
- An example for this may be found in
+ For a detailed example, see
\autoref{sec:\ThisCommonFirstLabelBase.marginNotes} at
\PageRefxmpl{\ThisCommonFirstLabelBase.cmd.marginline}.%
\csname iffalse\endcsname%
}%
\begin{Example}
\phantomsection\xmpllabel{cmd.marginline}%
- In this \iffree{document}{book}, sometimes, the class name
- \Class{scrartcl} can be found in the margin. This can be produced with:%
- \iffalse% Umbruchkorrekturtext
- \footnote{In fact, instead of \Macro{texttt}, a semantic highlighting
- was used. To avoid confusion this was replaced in the example.}%
+ In some parts of this \iffree{guide}{book}, the class name
+ \Class{scrartcl} can be found in the margin. You can produced this with:%
+ \iftrue% Umbruchkorrekturtext
+ \footnote{Actually, instead of \Macro{texttt}, a semantic markup
+ was used. To avoid confusion, this has been replaced in the example.}%
\fi
\begin{lstcode}
\marginline{\texttt{scrartcl}}
@@ -116,15 +115,23 @@ To facilitate this, {\KOMAScript} offers the command
\marginpar[\raggedleft\texttt{scrartcl}]
{\raggedright\texttt{scrartcl}}
\end{lstcode}
- Thus \Macro{marginline} is really only an abbreviated writing of the
+ Thus \Macro{marginline} is really just a shorthand notation for the
code above.%
\end{Example}%
\fi
-Experts\textnote{Attention!} and advanced users may find information about
-problems using \Macro{marginpar} at \autoref{sec:maincls-experts.addInfos},
-\DescPageRef{maincls-experts.cmd.marginpar}. These are valid for
-\Macro{marginline} also.%
+Advanced users\textnote{Attention!} will find notes about difficulties that
+can arise using \Macro{marginpar} in \autoref{sec:maincls-experts.addInfos}%
+\iffree{}{, on \DescPageRef{maincls-experts.cmd.marginpar}}. These remarks
+also apply to \Macro{marginline}. In addition,
+\autoref{cha:scrlayer-notecolumn} introduces a package that you can use to
+create note columns with their own page breaks.%
+\iftrue% Umbruchkorrektur
+ \ However, the
+ \hyperref[cha:scrlayer-notecolumn]{\Package{scrlayer-notecolumn}}%
+ \IndexPackage{scrlayer-notecolumn} package is more a proof of concept than a
+ finished package.%
+\fi%
%
\EndIndexGroup
%