diff options
author | Karl Berry <karl@freefriends.org> | 2009-07-20 18:10:03 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-07-20 18:10:03 +0000 |
commit | c085420206defb618b877e4e046024830c6ef8e1 (patch) | |
tree | 4871a44a4250285bfd69467785548085cf5ab21e /Master/texmf-dist/source/latex/koma-script/doc | |
parent | d0d80da633ecb4209bb8355828026d5cf5419ea7 (diff) |
koma-script update (8jul09)
git-svn-id: svn://tug.org/texlive/trunk@14345 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc')
5 files changed, 345 insertions, 113 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex index f53c5112241..03c4c01e181 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex @@ -45,7 +45,7 @@ % % ============================================================================ -\ProvidesFile{scrlttr2.tex}[2009/01/01 KOMA-Script guide (chapter: scrlttr2)] +\ProvidesFile{scrlttr2.tex}[2009/06/12 KOMA-Script guide (chapter: scrlttr2)] \translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm} @@ -909,15 +909,15 @@ can contain internal commands available to package writers. For (see \autoref{sec:scrlttr2.pseudoLength}). There are already some \File{lco} files included in the {\KOMAScript} -distribution. The \File{DIN.lco}, \File{DINmtext.lco}, -\File{SNleft.lco}, and \File{SN.lco} files serve to adjust -{\KOMAScript} to different layout standards. They are well suited as -templates for your own parameter sets. The \File{KOMAold.lco} file, on -the other hand, serves to improve compatibility with the old letter -class \Class{scrlettr}. Since it contains internal commands not open -to package writers, you should not use this as a template for your own -\File{lco} files. You can find a list of predefined \File{lco} files -in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}. +distribution. The \File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco}, +\File{SN.lco}, and \File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} files +serve to adjust {\KOMAScript} to different layout standards. They are well +suited as templates for your own parameter sets. The \File{KOMAold.lco} file, +on the other hand, serves to improve compatibility with the old letter class +\Class{scrlettr}. Since it contains internal commands not open to package +writers, you should not use this as a template for your own \File{lco} +files. You can find a list of predefined \File{lco} files in +\autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}. \begin{Explain} If you have defined a parameter set for a letter standard not yet @@ -1051,66 +1051,70 @@ value. Additionally, also reduce \PLength{toaddrwidth} accordingly. \Endhead% \standardfoot% \oentry{DIN}{% - parameter set for letters on A4-size paper, complying with German - standard DIN~676; suitable for window envelopes in the sizes C4, - C5, C6, and C6/5 (C6 long).}% - \oentry{DINmtext}{% - parameter set for letters on A4-size paper, complying with - DIN~676, but using an alternate layout with more text on the first - page; only suitable for window envelopes in the sizes C6 and C6/5 + parameter set for letters on A4-size paper, complying with German standard + DIN~676; suitable for window envelopes in the sizes C4, C5, C6, and C6/5 (C6 long).}% + \oentry{DINmtext}{% + parameter set for letters on A4-size paper, complying with DIN~676, but + using an alternate layout with more text on the first page; only suitable + for window envelopes in the sizes C6 and C6/5 (C6 long).}% \oentry{KOMAold}{% - parameter set for letters on A4-size paper using a layout close to - the now obsolete \Class{scrlettr} letter class; suitable for - window envelopes in the sizes C4, C5, C6, and C6/5 (C6 long); some - additional commands to improve compatibility with obsolete - \Class{scrlettr} commands are defined; \Class{scrlttr2} may behave - slightly different when used with this \File{lco} file than with - the other \File{lco} files.}% + parameter set for letters on A4-size paper using a layout close to the now + obsolete \Class{scrlettr} letter class; suitable for window envelopes in + the sizes C4, C5, C6, and C6/5 (C6 long); some additional commands to + improve compatibility with obsolete \Class{scrlettr} commands are defined; + \Class{scrlttr2} may behave slightly different when used with this + \File{lco} file than with the other \File{lco} files.}% + \oentry{NF}{% + parameter set for French letters, according to NF~Z~11-001; suitable for + window envelopes of type DL (110\Unit{mm} to 220\Unit{mm}) with a window + of about 20\Unit{mm} from right and bottom with width 45\Unit{mm} and + height 100\Unit{mm}; this file was originally developed by Jean-Marie + Pacquet, who provides an extended version and additional information on + \cite{www:NF.lco}.}% \oentry{NipponEL}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of types Chou or You 3 or 4, in which - the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high, - and positioned 22\Unit{mm} from the left and 12\Unit{mm} from the - top edge (see \autoref{cha:japanlco}).}% + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of types Chou or You 3 or 4, in which the windows is + approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned + 22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see + \autoref{cha:japanlco}).}% \oentry{NipponEH}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of types Chou or You 3 or 4, in which - the windows is approximately 90\Unit{mm} wide, 55\Unit{mm} high, - and positioned 22\Unit{mm} from the left and 12\Unit{mm} from the - top edge (see \autoref{cha:japanlco}).}% + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of types Chou or You 3 or 4, in which the windows is + approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned + 22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see + \autoref{cha:japanlco}).}% \oentry{NipponLL}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of types Chou or You 3 or 4, in which - the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high, - and positioned 25\Unit{mm} from the left and 12\Unit{mm} from the - top edge (see \autoref{cha:japanlco}).}% + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of types Chou or You 3 or 4, in which the windows is + approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned + 25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see + \autoref{cha:japanlco}).}% \oentry{NipponLH}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of types Chou or You 3 or 4, in which - the windows is approximately 90\Unit{mm} wide, 55\Unit{mm} high, - and positioned 25\Unit{mm} from the left and 12\Unit{mm} from the - top edge (see \autoref{cha:japanlco}).}% + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of types Chou or You 3 or 4, in which the windows is + approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned + 25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see + \autoref{cha:japanlco}).}% \oentry{NipponRL}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of types Chou or You 3 or 4, in which - the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high, - and positioned 25\Unit{mm} from the left and 24\Unit{mm} from the - top edge (see \autoref{cha:japanlco}).}% - \oentry{KakuLL}{% - parameter set for Japanese letters in A4 format; suitable for - Japanese window envelopes of type Kaku A4, in which the windows is + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of types Chou or You 3 or 4, in which the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned 25\Unit{mm} from the left and 24\Unit{mm} from the top edge (see \autoref{cha:japanlco}).}% + \oentry{KakuLL}{% + parameter set for Japanese letters in A4 format; suitable for Japanese + window envelopes of type Kaku A4, in which the windows is approximately + 90\Unit{mm} wide, 45\Unit{mm} high, and positioned 25\Unit{mm} from the + left and 24\Unit{mm} from the top edge (see \autoref{cha:japanlco}).}% \oentry{SN}{% - parameter set for Swiss letters with address field on the right - side, according to SN~010\,130; suitable for Swiss window - envelopes in the sizes C4, C5, C6, and C6/5 (C6 long).}% + parameter set for Swiss letters with address field on the right side, + according to SN~010\,130; suitable for Swiss window envelopes in the sizes + C4, C5, C6, and C6/5 (C6 long).}% \oentry{SNleft}{% - parameter set for Swiss letters with address field on the left - side; suitable for Swiss window envelopes with window on the left - side in the sizes C4, C5, C6, and C6/5 (C6 long).}% + parameter set for Swiss letters with address field on the left side; + suitable for Swiss window envelopes with window on the left side in the + sizes C4, C5, C6, and C6/5 (C6 long).}% \end{desctable} \begin{Explain} diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex index 4b45a2c316f..2c876dfd2c1 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex @@ -38,9 +38,9 @@ %% standard classes created by The LaTeX3 Project 1994-1996. %% %%% From File: tocbasic.dtx -\def\tocbasicversion{2009/01/20 v3.02a} +\def\tocbasicversion{2009/06/08 v3.03b} \ProvidesFile{tocbasic.tex} - [\tocbasicversion + [\tocbasicversion\space KOMA-Script package (manual)% ] diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib index 10761b93606..c1cb00521f5 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib +++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib @@ -133,6 +133,15 @@ address = {Berlin} } +@Misc{ www:NF.lco, + language = {english}, + author = {Jean-Marie Pacquet}, + title = {{KomaLetter2}; {E}xample by {J}ean-{M}arie {P}acquet ({F}rench style)}, + institution = {wiki.lyx.org}, + howpublished = {Wiki}, + url = {http://wiki.lyx.org/Examples/KomaLetter2#toc6} +} + @Misc{ www:blaettery, language = {ngerman}, author = {Jürgen F. Schopp}, diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex index 216d50925cc..f80b4d62b17 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex @@ -45,7 +45,7 @@ % % ============================================================================ -\ProvidesFile{scrlttr2-experts.tex}[2009/03/04 KOMA-Script guide (chapter: scrlttr2 for experts)] +\ProvidesFile{scrlttr2-experts.tex}[2009/07/07 KOMA-Script guide (chapter: scrlttr2 for experts)] \chapter{Zusätzliche Informationen zur Briefklasse \Class{scrlttr2}} @@ -565,7 +565,8 @@ Die Pseudolänge \PLength{firstheadwidth} gibt die Breite des Briefkopfes an. Der Wert wird in den vordefinierten \File{lco}-Dateien unterschiedlich gesetzt. Während er normalerweise von der Papierbreite und dem horizontalen Abstand der Empfängeradresse vom linken Papierrand abhängt, entspricht er bei -\Option{KOMAold} der Breite des Satzspiegels.% +\Option{KOMAold} der Breite des Satzspiegels und ist bei \Option{NF} fest auf +170\Unit{mm} eingestellt.% \EndIndex{PLength}{firstheadwidth}% @@ -581,7 +582,7 @@ erwähnt wurde, kann in den vordefinierten Briefköpfen eine Linie im oder unter dem Absender gesetzt werden. Hat die Pseudolänge \PLength{fromrulewidth} die Länge 0, so wird dabei die Länge dieser Linie automatisch bestimmt. Dies ist die Voreinstellung bei den vordefinierten \File{lco}-Dateien. Der Wert kann -mit \Macro{\@setplength} (siehe +mit \Macro{@setplength} (siehe \autopageref{desc:scrlttr2-experts.cmd.@setplength}) in eigenen \File{lco}-Dateien aber auch abweichend gesetzt werden. Die voreingestellte Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, \PLength{fromrulethickness}, der @@ -615,11 +616,11 @@ Fensterbriefumschlags vom oberen und vom linken Rand des Papiers an. Sie werden in den vordefinierten \File{lco}-Dateien unterschiedlich eingestellt. Für \PLength{toaddrhpos} gilt außerdem eine Besonderheit. Ist der Wert negativ, so ist sein Betrag der Abstand des Anschriftfeldes vom rechten Rand -des Papiers. Sie finden dies beispielsweise bei \Option{SN}. Am kleinsten ist -der Wert \PLength{toaddrvpos} bei \Option{DINmtext}. Hier kann es schnell -passieren, dass der Briefkopf in das Anschriftfenster ragt. Ob das -Anschriftfenster überhaupt gesetzt wird, hängt von der Option -\Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage}, +des Papiers. Sie finden dies beispielsweise bei \Option{SN} oder +\Option{NF}. Am kleinsten ist der Wert \PLength{toaddrvpos} bei +\Option{DINmtext}. Hier kann es schnell passieren, dass der Briefkopf in das +Anschriftfenster ragt. Ob das Anschriftfenster überhaupt gesetzt wird, hängt +von der Option \Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage}, \autopageref{desc:scrlttr2.option.addrfield}).% \EndIndex{PLength}{toaddrhpos}% \EndIndex{PLength}{toaddrvpos}% @@ -1014,13 +1015,13 @@ verringert werden. Bei einer Kompatibilitätseinstellung\ChangedAt{v2.9t}{\Class{scrlttr2}} bis Version~2.9t (siehe \Option{version} in \autoref{sec:scrlttr2.compatibilityOptions}, -\autopageref{desc:scrlttr2.option.version}) wird außer bei \Option{KOMAold} in -allen vordefinierten \File{lco}-Dateien (siehe \autoref{sec:scrlttr2.lcoFile}) -der Fuß abhängig vom Satzspiegel gesetzt. Damit hat dann auch -\Option{enlargefirstpage} keine Wirkung. Ab Version 2.9u bekommt der Fuß eine -Position am unteren Ende des Papiers. Damit ist dann die Höhe des Satzspiegels -des Briefbogens eventuell auch von der Option \Option{enlargefirstpage} -abhängig. +\autopageref{desc:scrlttr2.option.version}) wird außer bei \Option{KOMAold} +und \Option{NF} in allen vordefinierten \File{lco}-Dateien (siehe +\autoref{sec:scrlttr2.lcoFile}) der Fuß abhängig vom Satzspiegel gesetzt. +Damit hat dann auch \Option{enlargefirstpage} keine Wirkung. Ab Version 2.9u +bekommt der Fuß eine Position am unteren Ende des Papiers. Damit ist dann die +Höhe des Satzspiegels des Briefbogens eventuell auch von der Option +\Option{enlargefirstpage} abhängig. Sollte der Briefbogenfuß mittels Option \Option{firstfoot}\IndexOption{firstfoot}\ChangedAt{v2.97e}{\Class{scrlttr2}} @@ -1168,26 +1169,33 @@ funktionieren. Obwohl jedes von \Package{typearea} einstellbare Format verwendbar ist, kann es bei der Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten Ergebnissen kommen. Das liegt aber nicht am Konzept der Klasse, sondern daran, -dass derzeit nur Parametersätze für ISO A4 existieren. Leider gibt es keine -allgemein gültigen Regeln, um die Position von Anschriftfeldern und Ähnlichem -für beliebige Papierformate zu berechnen. Es ist jedoch möglich, auch für -andere Papierformate Parametersätze zu erstellen.% +dass derzeit hauptsächlich Parametersätze für ISO A4 existieren. Leider gibt +es keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und +Ähnlichem für beliebige Papierformate zu berechnen. Es ist jedoch möglich, +auch für andere Papierformate Parametersätze zu erstellen.% \EndIndex{}{Papierformat>Beschraenkungen=Beschränkungen}% +\subsection{Überwachung des Papierformats} +\label{sec:scrlttr2-experts.papersize} + +Derzeit existieren Parametersätze und \File{lco}-Dateien für A4-Papier und +letter-Papier. Die Klasse \Class{scrlttr2} versteht aber theoretisch sehr viel +mehr Papierformate. Daher ist es notwendig zu überwachen, ob die korrekte +Papiergröße eingestellt ist. + \begin{Declaration} \Macro{LetterOptionNeedsPapersize}% \Parameter{Optionsname}\Parameter{Papiergröße} \end{Declaration} \BeginIndex{Cmd}{LetterOptionNeedsPapersize}% -Derzeit existieren nur Parametersätze und \File{lco}-Dateien für -A4-Papier. Damit man bei Verwendung einer anderen -\PName{Papiergröße}\Index{Papierformat} zumindest gewarnt wird, ist in -jeder mit \KOMAScript{} ausgelieferten \File{lco}-Datei eine Anweisung -\Macro{LetterOptionNeedsPapersize} zu finden. Als erstes Argument wird -dabei der Name der \File{lco}-Datei ohne die Endung »\File{.lco}« -übergeben. Als zweites Argument wird die Papiergröße übergeben, für -die diese \File{lco}-Datei gedacht ist. +Damit man bei Verwendung einer in der \File{lco}-Datei nicht +vorgesehenen \PName{Papiergröße}\Index{Papierformat} zumindest gewarnt wird, +sind in den mit \KOMAScript{} ausgelieferten \File{lco}-Dateien Anweisungen +\Macro{LetterOptionNeedsPapersize} zu finden. Als erstes Argument wird dabei +der Name der \File{lco}-Datei ohne die Endung »\File{.lco}« übergeben. Als +zweites Argument wird die Papiergröße übergeben, für die diese +\File{lco}-Datei gedacht ist. Werden nacheinander mehrere \File{lco}-Dateien geladen, so kann jede dieser \File{lco}-Dateien eine Anweisung \Macro{LetterOptionNeedsPapersize} @@ -1227,6 +1235,191 @@ und auch das Beispiel überspringen. \end{Example} % \EndIndex{Cmd}{LetterOptionNeedsPapersize}% + +\subsection{Positionen sichtbar machen} +\label{sec:scrlttr2-experts.visualize} +\BeginIndex{Option}{visualize} + +Wenn man selbst \File{lco}-Dateien entwickelt, beispielsweise umd die +Positionen von verschiedenen Feldern des Briefbogens an eigene Wünsche oder +Notwendigkeiten anzupassen, ist es hilfreich, wenn zumindest einige Elemente +unmittelbar sichtbar gemacht werden können. Zu diesem Zweck existiert die +\File{lco}-Datei +\File{visualize.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}. Diese kann wie jede +\File{lco}-Datei geladen werden. Allerdings ist das Laden dieser \emph{Letter + Class Option} auf die Dokumentpräambel beschränkt und seine Auswirkungen +können nicht wieder rückgängig gemacht werden. Die \File{lco}-Datei selbst +bedient sich der Pakete \Package{eso-pic}\IndexPackage{eso-pic} und +\Package{graphicx}\IndexPackage{graphicx}, die nicht zu \KOMAScript{} gehören. + +Es wird darauf hingewiesen, dass \Option{visualize} bisher nur in einer +Beta-Version existiert. Das bedeutet insbesondere, dass es keinen Support +dafür gibt und sich noch alles ändern kann. Da die Datei aber ohnehin nicht +für Produktionssysteme genutzt werden sollte, sondern in erste Linie der +Entwicklung eigener Parametersätze dient, sollte das die Verwendbarkeit nicht +verhindern. + +\begin{Declaration} + \Macro{showfields}\Parameter{Feldliste} +\end{Declaration} +\BeginIndex{Cmd}{showfields}% +Mit dieser Anweisung kann die Visualisierung von Feldern des Briefbogens +aktiviert werden. Das Argument \PName{Feldliste} ist dabei eine durch Komma +separierte Liste der Feldern, die visualisiert werden sollen. Folgende Felder +werden derzeit unterstützt: +\begin{description} +\item[test] -- ein Testfeld der Größe 10\Unit{cm} auf 15\Unit{cm}, das jeweils + 1\Unit{cm} vom oberen und linken Papierrand entfernt ist. Dieses Testfeld + existiert zu Debuggingzwecken. Es dient als Vergleichsmaß für den Fall, dass + im Dokumenterstellungsprozess die Maße verfälscht werden. +\item[head] -- der Kopfbereich des Briefbogens. Es handelt sich hier um ein nach + unten offenes Feld. +\item[foot] -- der Fußbereich des Briefbogens. Es handelt sich hier um ein nach + unten offenes Feld. +\item[address] -- das Anschriftfenster. +\item[location] -- das Feld der Absenderergänzung. +\item[refline] -- die Geschäftszeile. Es handelt sich hier um ein nach unten + offenes Feld. +\end{description}% +\BeginIndex{FontElement}{field}% +Mit Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe +\autoref{sec:scrlttr2.textmarkup}, +\autopageref{desc:scrlttr2.cmd.setkomafont}) für das +Element \FontElement{field} kann die Farbe der Visualisierung geändert +werden. Voreingestellt ist \Macro{normalcolor}.% +\EndIndex{FontElement}{field}% +% +\EndIndex{Cmd}{showfields} + +\begin{Declaration} + \Macro{setshowstyle}\Parameter{Visualsisierungsstil}\\ + \Macro{edgesize} +\end{Declaration} +\BeginIndex{Cmd}{setshowstyle}% +\BeginIndex{Cmd}{edgesize} +In der Voreinstellung werden die einzelnen Felder durch Umgrenzungslinien +markiert. Dies entspricht dem \PName{Visualisierungsstil} \PValue{frame}. Nach +unten offene Felder werden dabei nicht komplett umrahmt, sondern unten offen +mit kleinen Pfeilen nach unten dargestellt. Als Alternative hierzu steht auch +der \PName{Visualisierungsstil} \PValue{rule} zur Verfügung. Dabei wird das +Feld farbig hinterlegt. Hierbei kann nicht zwischen geschlossenen und nach +unten offenen Feldern unterschieden werden. Stattdessen werden nach unten +offene Felder mit einer Mindesthöhe dargestellt. Der dritte verfügbare +\PName{Visualisierungsstil} ist \PValue{edge}. Dabei werden die Ecken der +Felder markiert. Bei nach unten offenen Feldern entfallen dabei die unteren +Eckmarkierungen. Die Größe der Eckmarkierungen ist im Makro \Macro{edgesize} +abgelegt und mit 1\Unit{ex} voreingestellt. +\EndIndex{Cmd}{edgesize} +\EndIndex{Cmd}{setshowstyle} + +\begin{Declaration} + \Macro{showenvelope}(\PName{Breite},\PName{Höhe})% + (\PName{HOffset},\PName{VOffset})\OParameter{Zusatz}\\ + \Macro{showISOenvelope}\Parameter{Format}\OParameter{Zusatz}\\ + \Macro{showUScommercial}\Parameter{Format}\OParameter{Zusatz}\\ + \Macro{showUScheck}\OParameter{Zusatz}\\ + \Macro{unitfactor} +\end{Declaration} +\BeginIndex{Cmd}{showenvelope}% +\BeginIndex{Cmd}{showISOenvelope}% +\BeginIndex{Cmd}{showUScommercial}% +\BeginIndex{Cmd}{showUScheck}% +\BeginIndex{Cmd}{unitfactor}% +Diese Anweisungen dienen dazu eine Seite mit einer Zeichnung eines Umschlags +auszugeben. Der Umschlag wird dabei immer um 90° gedreht auf einer eigenen +Seite im Maßstab~1:1 ausgegeben. Das Anschriftfenster wird automatisch aus den +aktuellen Daten für die Anschriftposition auf dem Briefbogen, +\PLength{toaddrvpos}, \PLength{toaddrheight}, \PLength{toaddrwidth} und +\PLength{toaddrhpos}, erzeugt. Hierfür ist es notwendig zu wissen, um welchen +Wert der gefaltete Briefbogen auf jeder Seite kleiner als die +\PName{Breite} und \PName{Höhe} des Briefbogens ist. Sind diese beiden Werte, +\PName{HOffset} und \PName{VOffset}, bei \Macro{showenvelope} nicht angegeben, +so wird versucht, sie aus den Faltmarken und der Papiergröße selbst zu +berechnen. + +Die übrigen Anweisungen basieren auf \Macro{showenvelope}. Mit +\Macro{showISOenvelope} kann ein ISO-Umschlag im \PName{Format} C4, C5, C5/6, +DL (auch bekannt als C5/6) oder C6 erzeugt werden. Mit +\Macro{showUScommercial} wird hingegen ein US-Commercial-Umschlag im +\PName{Format} 9 oder 10 ausgegeben. \Macro{showUScheck} schließlich ist für +Umschläge im US-Check-Format zuständig. + +\BeginIndex{FontElement}{letter}% +Innerhalb des Umschlags wird die Lage des Briefbogens gestrichtelt +angedeutet. Die dabei verwendete Farbe kann mit Hilfe der Anweisungen +\Macro{setkomafont} und \Macro{addtokomafont} (siehe +\autoref{sec:scrlttr2.textmarkup}, +\autopageref{desc:scrlttr2.cmd.setkomafont}) für das Element +\FontElement{letter} verändert werden. Voreingstellt ist \Macro{normalcolor}.% +\EndIndex{FontElement}{letter} + +\BeginIndex{FontElement}{measure}% +Die Umschlagzeichnung wird automatisch bemaßt. Die Farbe der Bemaßung und die +Größe deren Beschriftung kann mit Hilfe der Anweisungen \Macro{setkomafont} +und \Macro{addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup}, +\autopageref{desc:scrlttr2.cmd.setkomafont}) für das Element +\FontElement{measure} verändert werden. Voreingstellt ist hier +\Macro{normalcolor}. Die Bemaßung erfolgt in Vielfachen von +\Length{unitlength} mit einer maximalen Genauigkeit von +$1/\Macro{unitfactor}$, wobei die Genauigkeit der \TeX-Arithmetik die +tatsächliche Grenze darstellt. Voreingestellt ist 1. Eine Umdefinierung ist +mit \Macro{renewcommand} möglich.% +\EndIndex{FontElement}{measure} + +\begin{Example} + Es wird ein Beispielbrief im Format ISO~A4 erzeugt. Die unterstützten Felder + sollen zwecks Überprüfung ihrer Position mit gelben Rahmenlinien markiert + werden. Desweiteren soll die Position des Fensters in einem Umschlag der + Größe~DL mit Hilfe einer Zeichnung überprüft werden. Die Maßlinien in dieser + Zeichnung sollen rot und die Maßzahlen in kleinerer Schrift ausgegeben + werden, wobei die Maßzahlen in cm mit einer Genauigkeit von 1\Unit{mm} + ausgegeben werden sollen. Der gestrichelte Briefbogen im Umschlag soll + hingegen grün eingefärbt werden. + \begin{lstcode} +\documentclass[visualize]{scrlttr2} +\usepackage{xcolor} +\setkomafont{field}{\color{yellow}} +\setkomafont{measure}{\color{red}\small} +\setkomafont{letter}{\color{green}} +\showfields{head,address,location,refline,foot} +\usepackage[ngerman]{babel} +\usepackage{lipsum} +\begin{document} +\setkomavar{fromname}{Peter Musterfrau} +\setkomavar{fromaddress}{Hinter dem Tal 2\\ + 54321 Musterheim} +\begin{letter}{% + Petra Mustermann\\ + Vor dem Berg 1\\ + 12345 Musterhausen% + } +\opening{Hallo,} +\lipsum[1] +\closing{Bis dann} +\end{letter} +\setlength{\unitlength}{1cm} +\renewcommand*{\unitfactor}{10} +\showISOenvelope{DL} +\end{document} + \end{lstcode} + Auf der ersten Seite findet sich nun der Briefbogen, auf der zweiten Seite + wird die Zeichnung des Umschlags ausgegeben. +\end{Example} + +Bezüglich der Bemaßung ist zu beachten, dass ungünstige Kombinationen von +\Length{unitlength} und \Macro{unitfactor} sehr schnell einen \TeX-Fehler der +Art \emph{arthmetic overflow} provozieren. Ebenso kann es geschehen, dass +ausgegebene Maßzahlen geringfügig vom tatsächlichen Wert abweichen. Beides +sind keine Fehler von \Option{visualize}, sondern lediglich +Implementierungsgrenzen. +% +\EndIndex{Cmd}{unitfactor}% +\EndIndex{Cmd}{showUScheck} +\EndIndex{Cmd}{showUScommercial} +\EndIndex{Cmd}{showISOenvelope} +\EndIndex{Cmd}{showenvelope} +% +\EndIndex{Option}{visualize}% % \EndIndex{File}{lco}% diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex index 348f42e0aeb..662a5a5d2d2 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex @@ -45,7 +45,7 @@ % % ============================================================================ -\ProvidesFile{scrlttr2.tex}[2009/03/16 KOMA-Script guide (chapter: scrlttr2)] +\ProvidesFile{scrlttr2.tex}[2009/06/12 KOMA-Script guide (chapter: scrlttr2)] \chapter{Die neue Briefklasse \Class{scrlttr2}} \labelbase{scrlttr2} @@ -2578,16 +2578,17 @@ verwendet werden, die für Paketautoren freigegeben sind. Bei \autoref{sec:scrlttr2-experts.pseudoLengths}). \KOMAScript{} liegen bereits einige \File{lco}-Dateien bei. Die Dateien -\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco} und \File{SN.lco} -dienen dazu, \Class{scrlttr2} an verschiedene Normen\Index{Norm} -anzupassen. Sie können von angehenden Experten sehr gut als Vorlage für eigene -Parametersätze verwendet werden. Die Datei \File{KOMAold.lco} dient hingegen -dazu, die Kompatibilität zu \Class{scrlettr}, der alten Briefklasse, zu -verbessern. Da hierbei auch auf Anweisungen zurückgegriffen wird, die nicht -für Paketautoren freigegeben sind, sollte man sie nicht als Vorlage für eigene -\File{lco}-Dateien verwenden. Eine Liste aller vordefinierten -\File{lco}-Dateien ist in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles} -zu finden. +\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco}, \File{SN.lco}, +\File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}, \File{UScommercial9} und +\File{UScommercial9DW} dienen dazu, \Class{scrlttr2} an verschiedene +Normen\Index{Norm} anzupassen. Sie können von angehenden Experten sehr gut als +Vorlage für eigene Parametersätze verwendet werden. Die Datei +\File{KOMAold.lco} dient hingegen dazu, die Kompatibilität zu +\Class{scrlettr}, der alten Briefklasse, zu verbessern. Da hierbei auch auf +Anweisungen zurückgegriffen wird, die nicht für Paketautoren freigegeben sind, +sollte man sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine +Liste aller vordefinierten \File{lco}-Dateien ist in \autoref{tab:lcoFiles}, +\autopageref{tab:lcoFiles} zu finden. Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von \KOMAScript{} unterstützt wird, erstellt haben, so sind Sie ausdrücklich @@ -2712,8 +2713,7 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem \standardfoot% \oentry{DIN}{% Parametersatz für Briefe im Format A4 nach DIN~676; geeignet für - Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)% - }% + Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% \oentry{DINmtext}{% Parametersatz für Briefe im Format A4 nach DIN~676, wobei die Alternative für mehr Text auf der ersten Briefseite verwendet wird; nur geeignet für @@ -2727,48 +2727,54 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei möglicherweise nicht genau wie bei Verwendung der übrigen \File{lco}-Dateien}% + \oentry{NF}{% + Parametersatz für französische Briefe nach NF~Z~11-001; geeignet für + Fensterbriefumschläge im Format DL (110\Unit{mm} auf 220\Unit{mm}) mit + einem Fenster von 45\Unit{mm} Breite und 100\Unit{mm} Höhe ca. jeweils + 20\Unit{mm} entfernt vom rechten unteren Rand; diese Datei wurde + ursprünglich von Jean-Marie Pacquet entwickelt, der auf \cite{www:NF.lco} + neben einer Erweiterung auch eine LyX-Einbindung bereit stellt.}% \oentry{NipponEL}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das - Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} - vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch + Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom + linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{NipponEH}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das - Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm} - vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch + Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm} vom + linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{NipponLL}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das - Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} - vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch + Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom + linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{NipponLH}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das - Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm} - vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch + Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm} vom + linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{NipponRL}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das - Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} - vom rechten und 28\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch + Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom + rechten und 28\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{KakuLL}{% Parametersatz für japanische Briefe im Format A4; geeignet für japanische Fensterbriefumschläge des Typs Kaku A4, bei denen das Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom linken und - 24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch - \iffree{den Anhang der englischen - \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% + 24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den + Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}% \oentry{SN}{% Parametersatz für Schweizer Briefe nach SN~010\,130 mit Anschrift rechts; geeignet für Schweizer Fensterbriefumschläge in den Formaten C4, C5, C6 @@ -2777,6 +2783,26 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem Parametersatz für Schweizer Briefe mit Anschrift links; geeignet für Schweizer Fensterbriefumschläge mit dem Fenster links in den Formaten C4, C5, C6 und C6/5 (C6 lang)}% + \oentry{UScommercial9}{% + Parametersatz für US-amerikanische Briefe im Format letter; + geeignet für US-amerikanische Fensterbriefumschläge der Größe + \emph{commercial~No.\,9} mit einem + Anschriftfenster der Breite 4\,1/2Unit{in} und Höhe 1\,1/8\Unit{in} an + einer Position 7/8\Unit{in} von links und 1/2\Unit{in} von unten ohne + Rücksendeadresse im Fenster; bei Faltung zunächst an der Mittelmarke und + dann an der oberen Faltmarke kann auch Papier im Format legal verwendet + werden, führt dann jedoch zu einer Papiergrößen-Warnung}% + \oentry{UScommercial9DW}{% + Parametersatz für US-amerikanische Briefe im Format letter; + geeignet für US-amerikanische Fensterbriefumschläge der Größe + \emph{commercial~No.\,9} mit einem + Anschriftfenster der Breite 3\,5/8Unit{in} und Höhe 1\,1/8\Unit{in} an + einer Position 3/4\Unit{in} von links und 1/2\Unit{in} von unten mit + einem Absenderfenster der Breite 3\,1/2\Unit{in} und Höhe 7/8\Unit{in} an + einer Position 5/16\Unit{in} von links und 2\,1/2\Unit{in} von unten, + jedoch ohne Rücksendeadresse im Fenster; bei Faltung zunächst an der + Mittelmarke und dann an der oberen Faltmarke kann auch Papier im Format + legal verwendet werden, führt dann jedoch zu einer Papiergrößen-Warnung}% \end{desctable} Die \File{lco}-Datei \File{DIN} wird übrigens immer als erste |