diff options
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.tex | 79 |
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 % |