From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Mon, 2 Sep 2019 13:46:59 +0900
Subject: Initial commit

---
 .../source-doc/english/common-marginpar.tex        | 144 +++++++++++++++++++++
 1 file changed, 144 insertions(+)
 create mode 100644 macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex

(limited to 'macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex')

diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex
new file mode 100644
index 0000000000..05e2bdd1f3
--- /dev/null
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex
@@ -0,0 +1,144 @@
+% ======================================================================
+% common-marginpar.tex
+% Copyright (c) Markus Kohm, 2001-2019
+%
+% 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-marginpar.tex
+% Copyright (c) Markus Kohm, 2001-2019
+%
+% 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-marginpar.tex}
+                 [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+                  KOMA-Script guide (common paragraphs)]
+\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
+
+% Date of the translated German file: 2018-01-29
+
+\section{Marginal Notes}
+\seclabel{marginNotes}%
+\BeginIndexGroup
+\BeginIndex{}{marginal notes}%
+
+\IfThisCommonFirstRun{}{%
+  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}.%
+}
+
+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}{%
+  In letters, however, marginal notes are unusual and should be used 
+  sparingly.%
+}{%
+  This \iffree{guide}{book} makes frequent use of them.%
+}%
+
+
+\begin{Declaration}
+  \Macro{marginpar}\OParameter{margin note left}\Parameter{margin note}%
+  \Macro{marginline}\Parameter{margin note}
+\end{Declaration}%
+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%
+}{%
+  For a detailed example, see
+  \autoref{sec:\ThisCommonFirstLabelBase.marginNotes} at
+  \PageRefxmpl{\ThisCommonFirstLabelBase.cmd.marginline}.%
+  \csname iffalse\endcsname%
+}%
+  \begin{Example}
+    \phantomsection\xmpllabel{cmd.marginline}%
+    In some parts of this \iffree{guide}{book}, the class name
+    \Class{scrartcl} can be found in the margin. You can produce 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}}
+\end{lstcode}
+
+  Instead of \Macro{marginline} you could have used \Macro{marginpar}. In fact
+  the first command is implemented internally as:
+\begin{lstcode}
+  \marginpar[\raggedleft\texttt{scrartcl}]
+    {\raggedright\texttt{scrartcl}}
+\end{lstcode}
+  Thus \Macro{marginline} is really just a shorthand notation for the
+  code above.%
+\end{Example}%
+\fi
+
+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
+%
+\EndIndexGroup
+
+%%% Local Variables:
+%%% mode: latex
+%%% coding: us-ascii
+%%% TeX-master: "../guide"
+%%% End:
-- 
cgit v1.2.3

