diff options
author | Norbert Preining <norbert@preining.info> | 2019-12-30 03:01:34 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-12-30 03:01:34 +0000 |
commit | 0af8a1a375250bdab8576ca414baae91122ea6a3 (patch) | |
tree | 712572d132615517c42be58f815bdda7e0bb71a1 /macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex | |
parent | d42fde796d40a1fe4936ff2a7d96c1524109db7a (diff) |
CTAN sync 201912300301
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex')
-rw-r--r-- | macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex | 2843 |
1 files changed, 2143 insertions, 700 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex index 0e558f33bb..3486cf407b 100644 --- a/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex +++ b/macros/latex/contrib/koma-script/source-doc/ngerman/scrlttr2.tex @@ -7,7 +7,7 @@ % 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 +% https://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. % @@ -23,7 +23,7 @@ % 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 +% https://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. % @@ -46,7 +46,7 @@ % ============================================================================ \KOMAProvidesFile{scrlttr2.tex}% - [$Date: 2019-10-10 10:25:29 +0200 (Thu, 10 Oct 2019) $ + [$Date: 2019-12-03 09:41:21 +0100 (Tue, 03 Dec 2019) $ KOMA-Script guide (chapter: scrlttr2)] \chapter{Briefe mit Klasse \Class{scrlttr2} oder Paket \Package{scrletter}} @@ -55,27 +55,39 @@ \BeginIndexGroup \BeginIndex{Class}{scrlttr2}\BeginIndex{Package}{scrletter}% \BeginIndex{}{Briefe}% +\iffalse% Wird eigentlich nicht mehr als Einleitung benötigt Briefe sind in vielerlei Hinsicht etwas ganz anderes als Artikel, Berichte, Bücher oder Ähnliches. Schon allein deshalb gibt es für Briefe ein eigenes -Kapitel. Aber auch aus weiteren Gründen ist ein eigenes Kapitel für -\Class{scrlttr2} und \Package{scrletter} gerechtfertigt. +Kapitel.% +\iffalse% Umbruchkorrektur +Aber auch aus weiteren Gründen ist ein eigenes Kapitel für +\Class{scrlttr2} und \Package{scrletter} gerechtfertigt.% +\fi% +\fi% +\iffalse% Braucht nach 17 Jahren kein Mensch mehr Die Klasse \Class{scrlttr2}\important{\Class{scrlttr2}} wurde 2002 von Grund auf neu entwickelt. Sie hat daher auch ein komplett anderes Bedienkonzept als alle übrigen mir bekannten Klassen. Die neue Art der Bedienung ist möglicherweise etwas ungewohnt, bietet jedoch nicht nur dem geübten Anwender -einige Vorteile. +einige Vorteile.% +\fi% Das Paket \Package{scrletter}\important{\Package{scrletter}}% -\ChangedAt{v3.15}{\Package{scrletter}} wiederum verstärkt \KOMAScript{} seit -Version 3.15. Es stellt die gesamte auf Briefe ausgelegte Funktionalität von -\Class{scrlttr2} auch für andere Klassen bereit. Empfohlen wird die Verwendung -mit einer der \KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} oder -\Class{scrartcl}, die im vorherigen Kapitel erklärt sind. Mit geringfügigen -Einschränkungen funktioniert \Package{scrletter} aber auch mit den -Standardklassen. - -Ausgangspunkt für die Entwicklung von \Package{scrletter} waren einerseits +\ChangedAt{v3.15}{\Package{scrletter}} verstärkt \KOMAScript{} seit Version +3.15. Es stellt die auf Briefe ausgelegte Funktionalität von \Class{scrlttr2} +auch für andere Klassen bereit. Empfohlen wird die Verwendung mit einer der +\KOMAScript-Klassen \Class{scrbook}, \Class{scrreprt} oder \Class{scrartcl}, +die im vorherigen Kapitel erklärt sind. % +\iffalse % +Mit geringfügigen Einschränkungen funktioniert \Package{scrletter}% +\else % +Auf Anwenderwunsch funktioniert \Package{scrletter} mit geringfügigen +Einschränkungen % +\fi % +aber auch mit den Standardklassen. + +Ausgangspunkt für die Entwicklung von \Package{scrletter} waren Nachfragen von Anwendern, die Elemente wie Gliederungsüberschriften,\textnote{Überschriften, Gleitumgebungen, Verzeichnisse} Gleitumgebungen oder ein Literaturverzeichnis auch in Briefen @@ -88,9 +100,38 @@ Gegenüber der Briefklasse hat das Briefpaket einige, kleine Änderungen, die notwendig waren, um Konflikte mit den anderen Klassen zu vermeiden. Diese betreffen vor allem die Seitenstile und sind explizit dokumentiert (siehe \autoref{sec:\LabelBase.pagestyle}, ab -\autopageref{sec:\LabelBase.pagestyle}). Wo \Package{scrletter} nicht explizit -erwähnt ist, gilt dafür alles, was für \Class{scrlttr2} dokumentiert ist, ohne -Änderung. +\autopageref{sec:\LabelBase.pagestyle}). % +\iffalse % Umbruchkorrektur +Wo \Package{scrletter} nicht explizit erwähnt ist, gilt dafür alles, was für +\Class{scrlttr2} dokumentiert ist, ohne Änderung. % +\fi% + +\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} + +\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} + +%\iffree{}{\vfill}% Umbruchoptimierung! + +\LoadCommonFile{draftmode} % \section{Entwurfsmodus} + +\LoadCommonFile{typearea} % \section{Seitenauf"|teilung} + +Die Unterscheidung zwischen ein- und doppelseitigem Satz ist bei Briefen +jedoch in der Regel nicht sinnvoll. Da Briefe normalerweise nicht gebunden +werden, betrachtet man bei Briefen jede Seite für sich. Das gilt auch dann, +wenn ausnahmsweise Vorder- und Rückseite bedruckt werden. Daher spielt bei +Briefen normalerweise auch der vertikale Ausgleich keine Rolle. Sollten Sie +diesen trotzdem benötigen +\iffalse% +% Umbruchkorrekturtext +oder wissen wollen, was das ist, % +\fi% +sei auf die in \autoref{sec:maincls.typearea}, +\DescPageRef{maincls.cmd.flushbottom} erklärten Anweisungen +\DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} und +\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} verwiesen.% +% +\EndIndexGroup \section{Variablen} @@ -108,19 +149,21 @@ Namen\Index{Variablen>Name}\textnote{Namen}, über den sie angesprochen werden, und einen Inhalt\Index{Variablen>Inhalt}\textnote{Inhalt}. Der Inhalt einer Variablen kann zeitlich bzw. räumlich getrennt von ihrer Verwendung gesetzt werden, so wie der Inhalt einer Anweisung getrennt von ihrer Ausführung -definiert werden kann. Ein Hauptunterschied einer Variablen zu einer Anweisung -besteht darin, dass eine Anweisung normalerweise eine Aktion auslöst, während -der Inhalt einer Variablen normalerweise aus einem Text besteht, der dann von -einer Anweisung ausgegeben wird. Außerdem kann eine Variable zusätzlich eine +definiert werden kann. Hauptunterschied zwischen Variablen und Anweisungen +ist, dass Anweisungen üblicherweise Aktionen auslösen, während der Inhalt +einer Variablen normalerweise aus einem Text besteht, der dann von einer +Anweisung ausgegeben wird. Er kann aber auch von mehreren Anweisungen an +unterschiedlichen Stellen verwendet und so mehrfach ausgegeben +werden. Außerdem kann eine Variable zusätzlich eine Bezeichnung\Index{Variablen>Bezeichnung}\textnote{Bezeichnung} besitzen, die ebenfalls gesetzt und ausgegeben werden kann. Dieser Abschnitt beschränkt sich bewusst auf die Einführung des Begriffs der Variablen. Die zur Verdeutlichung verwendeten Beispiele sind ohne tiefere Bedeutung. Konkretere Anwendungsbeispiele gibt es bei der Erläuterung der in -der Klasse und Paket bereits definierten und von ihnen verwendeten Variablen in -den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine -Übersicht über alle definierten Variablen. +der Klasse und dem Paket bereits definierten und von ihnen verwendeten +Variablen in den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} +gibt eine Übersicht über alle definierten Variablen. % \begin{desclist} \desccaption{Von \Class{scrlttr2} und \Package{scrletter} unterstützte @@ -209,13 +252,13 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine (\autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.variable.myref})}% \ventry{nextfoot}{Seitenfuß\ChangedAt{v3.08}{\Class{scrlttr2}} im Seitenstil - \PageStyle{headings}\IndexPagestyle{headings} oder - \PageStyle{myheadings}\IndexPagestyle{myheadings} + \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings} oder + \DescRef{\LabelBase.pagestyle.myheadings}\IndexPagestyle{myheadings} (\autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.variable.nextfoot})}% \ventry{nexthead}{Kopf\ChangedAt{v3.08}{\Class{scrlttr2}} im Seitenstil - \PageStyle{headings}\IndexPagestyle{headings} oder - \PageStyle{myheadings}\IndexPagestyle{myheadings} + \DescRef{\LabelBase.pagestyle.headings}\IndexPagestyle{headings} oder + \DescRef{\LabelBase.pagestyle.myheadings}\IndexPagestyle{myheadings} (\autoref{sec:\LabelBase.pagestyle}, \DescPageRef{\LabelBase.variable.nexthead})}% \ventry{phoneseparator}{Trennzeichen zwischen Telefonbezeichner und @@ -272,8 +315,8 @@ den nachfolgenden Abschnitten. \autoref{tab:\LabelBase.variables} gibt eine \end{Declaration} Mit der Anweisung \Macro{setkomavar} wird der \PName{Inhalt} der Variablen \PName{Name} gesetzt. Dabei kann per optionalem Argument gleichzeitig auch die -\PName{Bezeichnung} der Variablen geändert werden. Demgegenüber kann mit der -Sternvariante \Macro{setkomavar*} auch nur die \PName{Bezeichnung} der +\PName{Bezeichnung} der Variablen mit geändert werden. Mit der +Sternvariante \Macro{setkomavar*} kann auch nur die \PName{Bezeichnung} der Variablen \PName{Name} gesetzt werden. \begin{Example} In Briefen ist es üblich, den Absender im Briefkopf stehen zu haben. Dazu @@ -283,9 +326,10 @@ Variablen \PName{Name} gesetzt werden. \setkomavar{fromname}{Peter Musterfrau} \end{lstcode} Die voreingestellte Bezeichnung für den Namen des Absenders ist - »Von«. Angenommen, Herr Musterfrau will aber an den Stellen, an denen - \KOMAScript{} diese Bezeichnung verwendet, lieber »Absender« haben, so - müsste er zusätzlich + »Von«. Angenommen, Herr Musterfrau will % + \iffalse aber \fi % Umbruchkorrektur + an den Stellen, an denen \KOMAScript{} diese Bezeichnung verwendet, lieber + »Absender« haben, so müsste er zusätzlich \begin{lstcode} \setkomavar*{fromname}{Absender} \end{lstcode} @@ -311,12 +355,16 @@ Bezeichnung der Variablen gelöscht werden. \setkomavar{fromname}[]{Peter Musterfrau} \end{lstcode} verwenden. Dadurch wird gleichzeitig der Inhalt der Variablen gesetzt und - ihre Bezeichnung gelöscht. -\end{Example} -% + ihre Bezeichnung gelöscht.% +\end{Example}% +\iftrue% Umbruchkorrektur +Ein\textnote{Achtung!} leeres optionales Argument ist also nicht +gleichbedeutend mit dem Weglassen des optionalen Arguments.% +\else % +\vskip -1\ht\strutbox plus .75\strutbox% Beispiel am Ende der Bechreibung +\fi% \EndIndexGroup - \begin{Declaration} \Macro{usekomavar}\OParameter{Anweisung}\Parameter{Name} \Macro{usekomavar*}\OParameter{Anweisung}\Parameter{Name} @@ -334,35 +382,35 @@ Variablen ist \autoref{sec:scrlttr2-experts.variables}, \begin{Declaration} - \Macro{ifkomavar}\Parameter{Name}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} + \Macro{Ifkomavar}\Parameter{Name}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Mit\ChangedAt{v3.03}{\Class{scrlttr2}} dieser Anweisung kann man feststellen, -ob eine Variable definiert ist. Der \PName{Dann-Teil} wird nur dann -ausgeführt, wenn die Variable existiert. Dabei wird der Inhalt der Variablen -nicht getestet, kann also auch leer sein. Der \PName{Sonst-Teil} wird hingegen -ausgeführt, wenn die Variable nicht existiert. Solche Tests können -beispielsweise dann sinnvoll sein, wenn eigene Variablen in einer +Mit\ChangedAt{v3.03}{\Class{scrlttr2}}% +\ChangedAt{v3.28}{\Class{scrlttr2}\and \Package{scrletter}} dieser Anweisung +kann man feststellen, ob eine Variable definiert ist. Der \PName{Dann-Teil} +wird nur dann ausgeführt, wenn die Variable existiert. Dabei wird der Inhalt +der Variablen nicht getestet, kann also auch leer sein. Der \PName{Sonst-Teil} +wird hingegen ausgeführt, wenn die Variable nicht existiert. Solche Tests +können beispielsweise dann sinnvoll sein, wenn eigene Variablen in einer \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} (siehe \autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) definiert werden und in einer anderen \File{lco}-Datei diese Variable nur dann -verwendet werden soll, wenn sie existiert. -\EndIndexGroup +verwendet werden soll, wenn sie existiert. \EndIndexGroup \begin{Declaration} - \Macro{ifkomavarempty} + \Macro{Ifkomavarempty} \Parameter{Name}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} - \Macro{ifkomavarempty*} + \Macro{Ifkomavarempty*} \Parameter{Name}\Parameter{Dann-Teil}\Parameter{Sonst-Teil} \end{Declaration} -Mit\ChangedAt{v2.9i}{\Class{scrlttr2}} Hilfe dieser Anweisungen kann man -feststellen, ob der Inhalt oder die Bezeichnung einer Variablen leer -ist oder nicht. Der \PName{Dann-Teil} wird nur dann ausgeführt, -wenn der expandierte Inhalt oder die expandierte Bezeichnung der -Variablen \PName{Name} leer ist. Anderenfalls wird der -\PName{Sonst-Teil} ausgeführt. Die Sternvariante der Anweisung -bezieht sich dabei auf die Bezeichnung der Variablen, während die -normale Variante den Inhalt behandelt.% +Mit\ChangedAt{v2.9i}{\Class{scrlttr2}}% +\ChangedAt{v3.28}{\Class{scrlttr2}\and \Package{scrletter}} Hilfe dieser +Anweisungen kann man feststellen, ob der Inhalt oder die Bezeichnung einer +Variablen leer ist oder nicht. Der \PName{Dann-Teil} wird nur dann ausgeführt, +wenn der expandierte Inhalt oder die expandierte Bezeichnung der Variablen +\PName{Name} leer ist. Anderenfalls wird der \PName{Sonst-Teil} ausgeführt. +Die Sternvariante der Anweisung bezieht sich dabei auf die Bezeichnung der +Variablen, während die normale Variante den Inhalt behandelt.% \EndIndexGroup % \EndIndexGroup @@ -382,44 +430,441 @@ in Makros gespeicherten Längen mit ähnlichen Anweisungen zu verarbeiten wie echte Längen. Diese eigentlich in Makros abgelegten Längen heißen bei \KOMAScript{} daher Pseudolängen. -Eine Liste aller in \Class{scrlttr2} definierten Pseudolängen findet sich in -\autoref{tab:scrlttr2-experts.pseudoLengths}, -\autopageref{tab:scrlttr2-experts.pseudoLengths}. Eine grafische Darstellung -der Bedeutungen der wichtigsten Pseudolängen des Briefbogens ist -\autoref{fig:scrlttr2-experts.pseudoLengths}, -\autopageref{fig:scrlttr2-experts.pseudoLengths} zu entnehmen. Die verwendeten -Maße sind dabei an die Voreinstellungen von \Class{scrlttr2} angelehnt. Nähere -Beschreibungen zu den einzelnen Pseudolängen finden sich in den einzelnen -Abschnitten dieses Kapitels. - -Da der Anwender normalerweise keine eigenen Pseudolängen definieren muss, wird -dieser Teil nicht hier, sondern im Expertenteil in -\autoref{sec:scrlttr2-experts.pseudoLengths}, -\DescPageRef{scrlttr2-experts.cmd.newplength} behandelt. Ebenso ist das -Setzen von Pseudolängen eher dem fortgeschrittenen Anwender vorbehalten. Also -wird auch dies im Abschnitt für Experten ab -\DescPageRef{scrlttr2-experts.cmd.setplength} erklärt. - Bitte beachten\textnote{Achtung!} Sie unbedingt, dass die Pseudolängen zwar intern als Makros implementiert sind, bei den Befehlen zur Nutzung der Pseudolängen jedoch nur die Namen anzugeben sind. Diese werden wie die Namen von \LaTeX-Zählern und im Gegensatz zu Makros oder echten Längen ohne umgekehrten Schrägstrich geschrieben! +\begin{Explain} + Historisch gesehen arbeitet \TeX{} mit einem festen Satz an Registern. Es + gibt jeweils 256~Register für Token, Boxen, Zähler, Abstände (englisch: + \emph{skip}) und Größen (englisch: \emph{dimension}). Für \LaTeX{}-Längen, + die mit \Macro{newlength} angefordert werden, werden Abstandsregister + belegt. Sind alle diese Register verbraucht, kann man keine weiteren Längen + definieren. Sowohl \Class{scrlttr2} als auch \Package{scrletter} würden + normalerweise allein für die erste Seite mehr als 20 solche Register + verbrauchen. \LaTeX{} selbst belegt bereits 40 dieser Register. Das + \hyperref[cha:typearea]{\Package{typearea}}% + \IndexPackage{typearea}-Paket benötigt ebenfalls einige, so dass ein Viertel + der kostbaren Register verbraucht wäre. Dies war 2002 der Hauptgrund für die + Einführung der Pseudolängen bei \Class{scrlttr2}. + + Wer nun einwenden will, dass \LaTeX{} in der empfohlenen und für + \KOMAScript{} benötigten Installation mit \eTeX{} inzwischen das oben + genannte Beschränkungsproblem nicht mehr besitzt, hat recht. Allerdings kam + diese Entscheidung für \Class{scrlttr2} ein wenig zu spät. Bei + \Package{scrletter} wurde das Konzept der Pseudolängen aus Gründen der + Kompatibilität übernommen. +\end{Explain} + +Eine Auf"|listung aller von \KOMAScript{} definierten und verwendeten +Pseudolängen ist \autoref{tab:\LabelBase.pseudoLengths} zu +entnehmen. Dabei ist auch angegeben, wo in den nachfolgenden Abschnitten +nähere Erklärungen zu der jeweiligen Pseudolänge zu finden +sind.% + +\autoref{fig:\LabelBase.pseudoLengths} auf +\autopageref{fig:\LabelBase.pseudoLengths} zeigt eine schematische +Darstellung der wichtigsten Abstände auf dem Briefbogen. Dabei sind neben den +Pseudolängen für die veränderbaren Abstände zusätzlich in heller Schrift +die Längen angegeben, die für einige wenige fest programmierte Abstände +verwendet werden. Aus Gründen der Übersichtlichkeit wurde in der Darstellung +auf einige weniger häufig benötigte Pseudolängen jedoch verzichtet. +% +\begin{desclist} + \renewcommand{\abovecaptionskipcorrection}{-\normalbaselineskip}% + \desccaption{% + Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen% + \label{tab:\LabelBase.pseudoLengths}% + }{% + Von \Class{scrlttr2} und \Package{scrletter} verwendete Pseudolängen + (\emph{Fortsetzung})% + }% + \pentry{backaddrheight}{% + Höhe der Rücksendeadresse am oberen Rand des Anschriftfeldes + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.backaddrheight})% + }% + \pentry{bfoldmarklength}{% + Länge der unteren horizontalen Faltmarke + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.bfoldmarkvpos})% + }% + \pentry{bfoldmarkvpos}{% + Abstand der unteren horizontalen Faltmarke von der oberen Kante des + Papiers (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.bfoldmarkvpos})% + }% + \pentry{firstfoothpos}{% + Abstand des Brief"|fußes von der linken Kante des Papiers; Werte größer + der Breite oder kleiner der negativen Breite des Papiers werden gesondert + behandelt (\autoref{sec:\LabelBase.firstFoot}, + \DescPageRef{\LabelBase.plength.firstfoothpos})%| + }% + \pentry{firstfootvpos}{% + Abstand des Brief"|fußes von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.firstFoot}, + \DescPageRef{\LabelBase.plength.firstfootvpos})%| + }% + \pentry{firstfootwidth}{% + Breite des Brief"|fußes (\autoref{sec:\LabelBase.firstFoot}, + \DescPageRef{\LabelBase.plength.firstfootwidth})%| + }% + \pentry{firstheadhpos}{% + Abstand des Briefkopfes von der linken Kante des Papiers; Werte größer der + Breite oder kleiner der negativen Breite des Papiers werden gesondert + behandelt (\autoref{sec:\LabelBase.firstHead}, + \DescPageRef{\LabelBase.plength.firstheadhpos})% + }%\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!! + \pentry{firstheadvpos}{% + Abstand des Briefkopfes von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.firstHead}, + \DescPageRef{\LabelBase.plength.firstheadvpos})% + }% + \pentry{firstheadwidth}{% + Breite des Briefkopfes (\autoref{sec:\LabelBase.firstHead}, + \DescPageRef{\LabelBase.plength.firstheadwidth})% + }% + \pentry{foldmarkhpos}{% + Abstand der horizontalen Faltmarken von der linken Kante des Papiers + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.foldmarkhpos})% + }% + \pentry{foldmarkvpos}{% + Abstand der vertikalen Faltmarken von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.foldmarkvpos})% + }% + \pentry{fromrulethickness}{% + Dicke einer optionalen \iftrue horizontalen \fi% Umbruchkorrektur + Linie im Briefkopf (\autoref{sec:\LabelBase.firstHead}, + \DescPageRef{\LabelBase.plength.fromrulethickness})% + }% + \pentry{fromrulewidth}{% + Länge einer optionalen \iftrue horizontalen \fi% Umbruchkorrektur + Linie im Briefkopf (\autoref{sec:\LabelBase.firstHead}, + \DescPageRef{\LabelBase.plength.fromrulewidth})% + }% + \pentry{lfoldmarkhpos}{% + Abstand der vertikalen Faltmarke von der linken Kante des Papiers + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.lfoldmarkhpos})% + }% + \pentry{lfoldmarklength}{% + Länge der vertikalen Faltmarke (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.lfoldmarklength})% + }% + \pentry{locheight}{% + Höhe der Absenderergänzung, falls der Wert nicht 0 ist; bei 0 wird + stattdessen \DescRef{\LabelBase.plength.toaddrheight} verwendet + (\autoref{sec:\LabelBase.locationField}, + \DescPageRef{\LabelBase.plength.locheight})% + }% + \pentry{lochpos}{% + Abstand der Absenderergänzung von der rechten Papierkante, falls der Wert + positiv ist, oder negativer Abstand der Absenderergänzung von der linken + Papierkante, falls der Wert negativ ist; bei 0 wird stattdessen der + negative Wert von \DescRef{\LabelBase.plength.toaddrhpos} verwendet + (\autoref{sec:\LabelBase.locationField}, + \DescPageRef{\LabelBase.plength.lochpos})% + }% + \pentry{locvpos}{% + Abstand der Absenderergänzung von der oberen Papierkante, falls der Wert + nicht 0 ist; bei 0 wird stattdessen + \DescRef{\LabelBase.plength.toaddrvpos} verwendet + (\autoref{sec:\LabelBase.locationField}, + \DescPageRef{\LabelBase.plength.locvpos})% + }% + \pentry{locwidth}{% + Breite des Feldes für die Absenderergänzung, wobei bei einem Wert von 0 + die Breite automatisch aufgrund der in \autoref{sec:\LabelBase.firstpage}, + \DescPageRef{\LabelBase.option.locfield} beschriebenen Option + \DescRef{\LabelBase.option.locfield} berechnet wird + (\autoref{sec:\LabelBase.locationField}, + \DescPageRef{\LabelBase.plength.locwidth})% + }%\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchkorrektur!!!% + \pentry{mfoldmarklength}{% + Länge der mittleren horizontalen Faltmarke + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.mfoldmarklength})% + }% + \pentry{mfoldmarkvpos}{% + Abstand der mittleren horizontalen Faltmarke von der oberen Kante des + Papiers (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.mfoldmarkvpos})% + }% + \pentry{pfoldmarklength}{% + Länge der Lochermarke (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.pfoldmarklength})% + }% + \pentry{PPdatamatrixvskip}{% + vertikaler Abstand zwischen Port-Payé-Kopf und Data-Matrix bei + \OptionValueRef{scrlttr2}{addrfield}{PP} + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.PPdatamatrixvskip})% + }% + \pentry{PPheadheight}{% + Höhe für den Port-Payé-Kopf (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.PPheadheight})% + }% + \pentry{PPheadwidth}{% + Breite des linken Port-Payé-Feldes bei + \OptionValueRef{scrlttr2}{addrfield}{PP} + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.PPheadwidth})% + }% + \pentry{refaftervskip}{% + vertikaler Abstand nach der Geschäftszeile + (\autoref{sec:\LabelBase.refLine}, + \DescPageRef{\LabelBase.plength.refaftervskip})% + }% + \pentry{refhpos}{% + Abstand der Geschäftszeile von der linken Papierkante, wobei bei einem + Wert von 0 automatisch relativ zur Papierbreite zentriert wird + (\autoref{sec:\LabelBase.refLine}, + \DescPageRef{\LabelBase.plength.refhpos})% + }% + \pentry{refvpos}{% + Abstand der Geschäftszeile von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.refLine}, + \DescPageRef{\LabelBase.plength.refvpos})% + }% + \pentry{refwidth}{% + Breite der Geschäftszeile (\autoref{sec:\LabelBase.refLine}, + \DescPageRef{\LabelBase.plength.refwidth})% + }% + \pentry{sigbeforevskip}{% + vertikaler Abstand zwischen Gruß und Signatur + (\autoref{sec:\LabelBase.closing}, + \DescPageRef{\LabelBase.plength.sigbeforevskip})% + }% + \pentry{sigindent}{% + Einzug der Signatur gegenüber dem Textkörper + (\autoref{sec:\LabelBase.closing}, + \DescPageRef{\LabelBase.plength.sigindent})% + }% + \pentry{specialmailindent}{% + linker Einzug der Versandart innerhalb des Anschriftfeldes + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.specialmailindent})% + }% + \pentry{specialmailrightindent}{% + rechter Einzug der Versandart innerhalb des Anschriftfeldes + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.specialmailrightindent})% + }% + \pentry{subjectaftervskip}{% + vertikaler Abstand nach dem Betreff (\autoref{sec:\LabelBase.subject}, + \DescPageRef{\LabelBase.plength.subjectaftervskip})% + }% + \pentry{subjectbeforevskip}{% + zusätzlicher vertikaler Abstand vor dem Betreff + (\autoref{sec:\LabelBase.subject}, + \DescPageRef{\LabelBase.plength.subjectbeforevskip})% + }% + \pentry{subjectvpos}{% + Abstand des Betreffs von der oberen Kante des Papiers, wobei ein Wert von + 0 stattdessen den Betreff gemäß Option \DescRef{\LabelBase.option.subject} + setzt (\autoref{sec:\LabelBase.subject}, + \DescPageRef{\LabelBase.plength.subjectaftervskip})% + }% + \pentry{tfoldmarklength}{% + Länge der oberen horizontalen Faltmarke + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.tfoldmarklength})% + }% + \pentry{tfoldmarkvpos}{% + Abstand der oberen horizontalen Faltmarke von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.foldmarks}, + \DescPageRef{\LabelBase.plength.tfoldmarkvpos})% + }% + \pentry{toaddrheight}{% + Höhe des Anschriftfeldes (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.toaddrheight})% + }% + \pentry{toaddrhpos}{% + Abstand des Anschriftfeldes von der linken Papierkante, falls der Wert + positiv ist, oder negativer Abstand des Anschriftfeldes von der rechten + Papierkante, falls der Wert negativ ist + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.toaddrhpos})% + }% + \pentry{toaddrindent}{% + linker und rechter Einzug der Anschrift innerhalb des Anschrift\-feldes + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.toaddrindent})% + }%\iffree{}{\enlargethispage*{\baselineskip}}% Umbruchoptimierung!!! + \pentry{toaddrvpos}{% + Abstand des Anschriftfeldes von der oberen Kante des Papiers + (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.toaddrvpos})% + }% + \pentry{toaddrwidth}{% + Breite des Anschriftfeldes (\autoref{sec:\LabelBase.addressee}, + \DescPageRef{\LabelBase.plength.toaddrwidth})% + }% +\end{desclist} + +\begin{figure} + \centering + \includegraphics{plenDIN} + \caption[{Schematische Darstellung der wichtigsten Pseudolängen für den + Briefbogen}]{Schematische Darstellung der wichtigsten Pseudolängen für den + Briefbogen angelehnt an das Ergebnis bei Verwendung von \File{DIN.lco}} + \label{fig:\LabelBase.pseudoLengths} +\end{figure} + +%\iffree{}{\clearpage}% Im Buch erst Tabelle und Abbildung vollständig ausgeben. + +\begin{Declaration} + \Macro{newplength}\Parameter{Name} +\end{Declaration} +Mit\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} Hilfe dieser +Anweisung wird eine neue Pseudolänge definiert. Die neue Pseudolänge ist dann +über ihren \PName{Namen} eindeutig identifiziert. Jeder Name kann also nur +einmal vergeben werden. +% +\iffalse % Umbruchoptimierungstext +Es wird sichergestellt, dass jeder \PName{Name} nur +einmal vergeben wird.% +\else +\iffalse +Wird versucht, eine bereits vorhandene Pseudolänge erneut +zu definieren, so wird dies mit einer Fehlermeldung quittiert.% +\fi +% +\fi + +\BeginIndex{Cmd}{@newplength}% +\iffree{% + Da der Anwender selbst normalerweise keine eigenen Pseudolängen definieren + muss, handelte es sich bei diesem Befehl bis \KOMAScript~3.25 um keine + Benutzeranweisung. Stattdessen existierte bis dahin nur \Macro{@newplength} + mit derselben Funktionalität. Diese sollte nicht mehr verwendet werden. }{% + \iffalse% Umbruchkorrektur + Ausschließlich aus Gründen der Kompatibilität zu älteren + \KOMAScript-Versionen existiert für Paketautoren auch die interne Anweisung + \Macro{@newplength} mit identischer Bedeutung.% + \else% + \begin{Explain}% + Die\textnote{obsolete} interne Anweisung \Macro{@newplength} sollte nicht + mehr verwendet werden.% + \end{Explain}% + \fi% +}% +\EndIndexGroup + + +\begin{Declaration} + \Macro{Ifplength}\Parameter{Pseudolänge}% + \Parameter{Dann-Code}\Parameter{Sonst-Code} +\end{Declaration} +Mit\ChangedAt{v3.27}{\Class{scrlttr2}\and \Class{scrletter}} dieser Anweisung +kann geprüft werden, ob eine \PName{Pseudolänge} definiert ist. Ist dies der +Fall, so wird der \PName{Dann-Code} ausgeführt, anderenfalls wird der +\PName{Sonst-Code} ausgeführt.% +\iffree{}{\par% + \BeginIndex{Cmd}{if@plength}% + \iffalse% Umbruchkorrektur + Ausschließlich aus Konsistenzgründen existiert für Paketautoren auch die + interne Anweisung \Macro{if@plength} mit identischer Bedeutung.% + \else% + \begin{Explain}% + Die\textnote{obsolete} interne Anweisung \Macro{if@plength} sollte nicht + mehr verwendet werden.% + \end{Explain}% + \fi% +}% +\EndIndexGroup + + \begin{Declaration} \Macro{useplength}\Parameter{Name} \end{Declaration} Mit Hilfe dieser Anweisung wird auf den Wert der Pseudolänge mit dem -angegebenen \PName{Namen} zugegriffen. Dies ist eine der wenigen -Benutzeranweisung rund um Pseudolängen. Natürlich kann diese Anweisung dennoch -auch innerhalb einer \File{lco}-Datei\Index{lco-Datei=\File{lco}-Datei} (siehe -\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) -verwendet werden.% +angegebenen \PName{Namen} zugegriffen. Anwender benötigen dies eher +selten. Innerhalb von \File{lco}-Dateien\Index{lco-Datei=\File{lco}-Datei} +(siehe \autoref{sec:\LabelBase.lcoFile} ab +\autopageref{sec:\LabelBase.lcoFile}) wird die Anweisung häufig bei der +Berechnung abhängiger Pseudolängen verwendet.% % \EndIndexGroup \begin{Declaration} + \Macro{setplength}% + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} + \Macro{addtoplength}% + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Wert} +\end{Declaration} +Mit\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} Hilfe von +\Macro{setplength} kann einer \PName{Pseudolänge} das Vielfache eines +\PName{Wertes} zugewiesen werden. Der \PName{Faktor} wird dabei als optionales +Argument übergeben (siehe auch \DescRef{\LabelBase.cmd.setlengthtoplength}, +\DescPageRef{\LabelBase.cmd.setlengthtoplength}). + +Mit \Macro{addtoplength} kann man zu einer \PName{Pseudolänge} das Vielfache +eines \PName{Wertes} addieren. Auch dabei wird der \PName{Faktor} als +optionales Argument übergeben. + +Um einer \PName{Pseudolänge} das Vielfache einer anderen Pseudolänge +zuzuweisen oder zu ihr zu addieren, verwendet man innerhalb von \PName{Wert} +die Anweisung \DescRef{\LabelBase.cmd.useplength}. Um von einer +\PName{Pseudolänge} den Wert einer anderen \PName{Pseudolänge} zu +subtrahieren, verwendet man gleichzeitig als \PName{Faktor} ein Minuszeichen +oder \PValue{-1} oder einen anderen negativen Faktor. + +\BeginIndex{Cmd}{@setplength}% +\BeginIndex{Cmd}{@addtoplength}% +\iffree{% + Da der Anwender selbst normalerweise keine Pseudolängen ändern muss, + handelte es sich bis \KOMAScript~3.25 bei diesen Befehlen um keine + Benutzeranweisungen. Stattdessen existierten bis dahin nur + \Macro{@setplength} und \Macro{@addtoplength} mit derselben + Funktionalität. Diese sollten nicht mehr verwendet werden. +}{% + \iffalse% Umbruchkorrektur + Ausschließlich aus Gründen der Kompatibilität zu älteren + \KOMAScript-Versionen existieren für Paketautoren auch die internen + Anweisungen \Macro{@setplength} und \Macro{@addtoplength} mit identischen + Bedeutungen.% + \else% + \begin{Explain}% + Die\textnote{obsolete} internen Anweisungen + \Macro{@setplength} und \Macro{@addtoplength} sollten nicht mehr verwendet + werden.% + \end{Explain}% + \fi% +}% +\EndIndexGroup + + +\begin{Declaration} + \Macro{setplengthtowidth} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \Macro{setplengthtoheight} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \Macro{setplengthtodepth} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} + \Macro{setplengthtototalheight} + \OParameter{Faktor}\Parameter{Pseudolänge}\Parameter{Inhalt} +\end{Declaration} +Die\ChangedAt{v3.26}{\Class{scrlttr2}\and \Package{scrletter}} ersten drei +Anweisungen sind vergleichbar mit \Macro{settowidth}, +\Macro{settoheight} und \Macro{settodepth} aus dem \LaTeX-Kern, setzen aber +keine Länge, sondern eine \PName{Pseudolänge}. Entsprechend +\DescRef{\LabelBase.cmd.setplength} sind sie ebenfalls um einen optionalen +\PName{Faktor} erweitert. Sie setzen also eine \PName{Pseudolänge} auf die +Breite, Höhe oder Tiefe von \PName{Inhalt} multipliziert mit dem optional +angegebenen \PName{Faktor}. Die zusätzliche Anweisung +\Macro{setplengthtototalheight} setzt die \PName{Pseudolänge} auf die Summe +der Höhe und Tiefe von \PName{Inhalt} multipliziert mit dem optionalen +\PName{Faktor}.% +\EndIndexGroup + + +\begin{Declaration} \Macro{setlengthtoplength} \OParameter{Faktor}\Parameter{Länge}\Parameter{Pseudolänge} \Macro{addtolengthplength} @@ -427,9 +872,11 @@ verwendet werden.% \end{Declaration} Mit der Anweisung \Macro{setlengthtoplength}\important{\Macro{setlengthtoplength}} kann man -einer echten \PName{Länge} das Vielfache einer \PName{Pseudolänge} zuweisen. -Allerdings wird hier ein \PName{Faktor} nicht direkt der \PName{Pseudolänge} -vorangestellt, sondern als optionales Argument übergeben. Man sollte diese +einer \LaTeX-\PName{Länge} das Vielfache einer \PName{Pseudolänge} zuweisen. +Auch hier wird ein \PName{Faktor} nicht direkt der \PName{Pseudolänge} +vorangestellt, sondern als optionales Argument übergeben. +\iffalse % Umbruchkorrektur +Man sollte diese Anweisung auch verwenden, wenn man einer \PName{Länge} den negativen Wert einer \PName{Pseudolänge} zuweisen will. % \iffalse % Umbruchkorrektur @@ -439,43 +886,23 @@ einer \PName{Pseudolänge} zuweisen will. % \else % \PName{Faktor} ist dann \PValue{-1}. % -\fi +\fi % +\fi % % +\iffalse % Umbruchkorrektur Die Anweisung\important{\Macro{addtolengthplength}} \Macro{addtolengthplength} arbeitet ähnlich. Nur wird die mit \PName{Faktor} multiplizierte \PName{Pseudolänge} zur \PName{Länge} addiert.% +\else % +Mit \Macro{addtolengthplength}\important{\Macro{addtolengthplength}} wird die +mit \PName{Faktor} multiplizierte \PName{Pseudolänge} zur \PName{Länge} +addiert.% +\fi % % \EndIndexGroup % \EndIndexGroup -\LoadCommonFile{options} % \section{Frühe oder späte Optionenwahl} - -\LoadCommonFile{compatibility} % \section{Kompatibilität zu früheren Versionen von \KOMAScript} - -%\iffree{}{\vfill}% Umbruchoptimierung! - -\LoadCommonFile{draftmode} % \section{Entwurfsmodus} - -\LoadCommonFile{typearea} % \section{Seitenauf"|teilung} - -Die Unterscheidung zwischen ein- und doppelseitigem Satz ist bei Briefen -jedoch in der Regel nicht sinnvoll. Da Briefe normalerweise nicht gebunden -werden, betrachtet man bei Briefen jede Seite für sich. Das gilt auch dann, -wenn ausnahmsweise Vorder- oder Rückseite bedruckt werden. Daher spielt bei -Briefen normalerweise auch der vertikale Ausgleich keine Rolle. Sollten Sie -diesen trotzdem benötigen -\iffalse% -% Umbruchkorrekturtext -oder wissen wollen, was das ist, % -\fi% -sei auf die in \autoref{sec:maincls.typearea}, -\DescPageRef{maincls.cmd.flushbottom} erklärten Anweisungen -\DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} und -\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} verwiesen.% -% -\EndIndexGroup - \section{Genereller Aufbau eines Briefdokuments} \seclabel{document} @@ -484,8 +911,8 @@ sei auf die in \autoref{sec:maincls.typearea}, Der generelle Aufbau eines Briefdokuments weicht etwas vom Aufbau eines normalen Dokuments ab. Während ein Buchdokument normalerweise nur ein Buch -enthält, kann ein einzelnes Briefdokument mehrere Briefe enthalten. Wie in -\autoref{fig:\LabelBase.document} veranschaulicht wird, besteht ein +enthält, kann ein Briefdokument mehrere Briefe enthalten. Wie in +\autoref{fig:\LabelBase.document} veranschaulicht, besteht ein Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. \begin{figure} @@ -500,26 +927,27 @@ Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. \begin{minipage}[b]{.667\linewidth} \centering\small\setlength{\fboxsep}{1.5ex}% \addtolength{\linewidth}{-\dimexpr2\fboxrule+2\fboxsep\relax}% + \setlength{\topsep}{.5\topsep}% \fbox{\parbox{\linewidth}{\raggedright% \Macro{documentclass}\OParameter{\dots}\PParameter{scrlttr2}\\ - \dots\\ - {\centering\emph{Einstellungen für alle Briefe}\\} - \dots\\ - \Macro{begin}\PParameter{document}\\ - \dots\\ - {\centering\emph{Einstellungen für alle Briefe}\\} - \dots\\ - }}\\ + \begin{center} + \emph{Einstellungen für alle Briefe} + \end{center} + \Macro{begin}\PParameter{document} + }}\\[1pt] \fbox{\parbox{\linewidth}{\raggedright% + \begin{center} + \emph{Einstellungen ab dem nächsten Brief} + \end{center} \Macro{begin}\PParameter{letter}\Parameter{Empfänger}\\ - \dots\\ - {\centering\emph{Inhalt eines einzelnen Briefes}\\} - \dots\\ + \begin{center} + \emph{Inhalt eines einzelnen Briefs} + \end{center} \Macro{end}\PParameter{letter}\\ }}\\[2pt] \parbox{\linewidth}{\raggedright\vspace{-.5ex}\vdots\vspace{1ex}}\\ \fbox{\parbox{\linewidth}{\raggedright% - \Macro{end}\PParameter{document}\\ + \Macro{end}\PParameter{document} }}\\[\dimexpr\fboxsep+\fboxrule\relax] \end{minipage} \end{captionbeside} @@ -527,12 +955,7 @@ Briefdokument aus einem Vorspann, den einzelnen Briefen und dem Abschluss. Der Vorspann beinhaltet dabei alle Einstellungen, die generell alle Briefe betreffen. Diese können in den Einstellungen der einzelnen Briefe jedoch -zumindest teilweise überschrieben werden. Die einzige Einstellung, die derzeit -nicht innerhalb eines einzelnen Briefes überschrieben werden kann, ist die -Version von \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}}, zu der Kompatibilität -erreicht werden soll (siehe Option \DescRef{\LabelBase.option.version} in -\autoref{sec:\LabelBase.compatibilityOptions}, -\DescPageRef{\LabelBase.option.version}). +zumindest teilweise überschrieben werden. Bei Verwendung von \Package{scrletter}\important{scrletter} ändert sich lediglich, dass eine andere Klasse geladen und dafür zusätzlich @@ -565,28 +988,32 @@ zusätzliche Kommentare einfügen. \begin{minipage}[b]{.667\linewidth}% \centering\small\setlength{\fboxsep}{1.5ex}% \addtolength{\linewidth}{-\dimexpr2\fboxrule+2\fboxsep\relax}% + \setlength{\topskip}{.5\topskip}% \fbox{\parbox{\linewidth}{\raggedright% + \begin{center} + \emph{Einstellungen ab diesem Brief} + \end{center} \Macro{begin}\PParameter{letter}% - \OParameter{Optionen}\Parameter{Empfänger}\\ - \dots\\[\dp\strutbox] - {\centering\emph{Einstellungen für diesen Brief}\\} - \dots\\ - \DescRef{\LabelBase.cmd.opening}\Parameter{Anrede}\\ + \OParameter{Optionen}\Parameter{Empfänger} + \begin{center} + \emph{(Einstellungen für diesen Brief)} + \end{center} + \DescRef{\LabelBase.cmd.opening}\Parameter{Anrede} }}\\[1pt] \fbox{\parbox{\linewidth}{\raggedright% - \dots\\[\dp\strutbox] - {\centering\emph{Brief"|text}\\} - \dots\\ + \begin{center} + \emph{Brief"|text} + \end{center} }}\\[1pt] \fbox{\parbox{\linewidth}{\raggedright% \DescRef{\LabelBase.cmd.closing}\Parameter{Grußformel}\\ - \DescRef{\LabelBase.cmd.ps}\\ - \dots\\[\dp\strutbox] - {\centering\emph{Postscriptum}\\} - \dots\\ + \DescRef{\LabelBase.cmd.ps} + \begin{center} + \emph{Postscriptum} + \end{center} \DescRef{\LabelBase.cmd.encl}\Parameter{Anlagen}\\ \DescRef{\LabelBase.cmd.cc}\Parameter{Verteiler}\\ - \Macro{end}\PParameter{letter}\\ + \Macro{end}\PParameter{letter} }}\\[\dimexpr\fboxsep+\fboxrule\relax] \end{minipage} \end{captionbeside} @@ -595,8 +1022,10 @@ zusätzliche Kommentare einfügen. Wie in \autoref{fig:\LabelBase.letter} verdeutlicht wird, bestehen die einzelnen Briefe wiederum aus einer Einleitung, dem eigentlichen Brief"|text und einem Schlussteil. In der Einleitung werden alle Einstellungen -vorgenommen, die nur für diesen einen Brief gelten sollen. Entscheidend ist -hierbei, dass diese Einleitung immer mit +vorgenommen, die ab diesem oder nur für diesen einen Brief gelten sollen. Es +sei ausdrücklich darauf hingewiesen, dass Einstellungen, die vor oder zwischen +den einzelnen Briefen getroffen werden, für alle nachfolgenden Briefe +gelten. Entscheidend ist hierbei, dass diese Einleitung immer mit \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} endet. Ebenso beginnt der Schlussteil immer mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing}. Gegebenenfalls können die @@ -604,19 +1033,7 @@ Argumente \PName{Anrede} und \PName{Grußformel} der beiden Anweisungen leer bleiben, die Anweisungen müssen jedoch gesetzt werden und haben immer ein Argument. -Es soll an dieser Stelle nicht verschwiegen werden, dass zwischen den -einzelnen Briefen weitere Einstellungen getroffen werden können. Diese -gelten dann für alle nachfolgenden Briefe. Um Briefdokumente -übersichtlich und wartbar zu halten, sollte man sich jedoch gut -überlegen, ob man zwischen die Briefe tatsächlich weitere generelle -Einstellungen mit beschränkter Gültigkeit setzen will. Ich kann dies -nicht empfehlen% -\iffalse -% Umbruchergänzungstext -, da die Suche nach Einstellungen dadurch erschwert wird% -\fi -% -. Dagegen spricht bei Verwendung von \Package{scrletter2} nichts dagegen, vor, +Bei Verwendung von \Package{scrletter} spricht nichts dagegen, vor, zwischen oder nach Briefen weitere Dokumentteile einzufügen, die nicht im Briefkontext stehen sollen. So kann man beispielsweise Anschreiben und Lebenslauf in einem Dokument zusammenfassen. @@ -626,16 +1043,25 @@ Lebenslauf in einem Dokument zusammenfassen. \end{Environment} \end{Declaration} \BeginIndex{}{Anschrift}% +\iffalse% Umbruchkorrektur Die Briefumgebung \Environment{letter} ist einer der zentralen Dreh- und Angelpunkte der Briefklasse und des Briefpakets. Als Besonderheit\textnote{\KOMAScript{} vs. Standardklassen} kann man bei \Class{scrlttr2} und \Package{scrletter} der Briefumgebung zusätzliche \PName{Optionen} mit auf den Weg geben. Diese werden dann intern per -\DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt. +\DescRef{\LabelBase.cmd.KOMAoptions}-Anweisung ausgeführt.% +\else% +Die Briefumgebung \Environment{letter} ist der Hauptzweck der Briefklasse und +des Briefpakets. Bei\textnote{\KOMAScript{} vs. Standardklassen} +\Class{scrlttr2} und \Package{scrletter} kann man der Briefumgebung +\PName{Optionen} mit auf den Weg geben, die dann per +\DescRef{\LabelBase.cmd.KOMAoptions} nur für diese Umgebung ausgeführt +werden.% +\fi% Der \PName{Empfänger} wird als obligatorischer Parameter an die Umgebung übergeben. Dabei\textnote{Achtung!} dient der doppelte Backslash als -Trennzeichen zwischen einzelnen Teilen der Anschrift. Diese einzelnen Teile +Trennzeichen zwischen einzelnen Teilen der Anschrift. Diese Teile werden im Anschriftfeld als einzelne Zeilen ausgegeben. Dennoch sollte der doppelte Backslash hier nicht als fester Zeilenumbruch verstanden werden. Absätze, vertikaler Leerraum und Ähnliches sind in der Anschrift nicht @@ -675,7 +1101,7 @@ erklärten Anweisungen \DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} \Macro{AtBeginLetter}\Parameter{Anweisungen} \Macro{AtEndLetter}\Parameter{Anweisungen} \end{Declaration} -\iftrue% Umbruchvarianten +\iffalse% Umbruchvarianten Wie\textnote{Haken}\Index[indexmain]{Haken} in \cite{latex:clsguide} erwähnt, gibt es bei \LaTeX{} die Möglichkeit, zu bestimmten Gelegenheiten während des \LaTeX-Laufs eines Dokuments zusätzliche \PName{Anweisungen} ausführen zu @@ -764,6 +1190,7 @@ geben.\Index[indexmain]{Haken} Das folgende Beispiel zeigt dies.% \fi % \EndIndexGroup +\ExampleEndFix% Beispiel am Ende der Beschreibung \begin{Declaration} @@ -782,6 +1209,7 @@ referenzierbar um eins erhöht wird. \Macro{begin}\PParameter{letter} zurückzusetzen, kann dies auch implizit erfolgen, indem der Zähler \Counter{Frage} abhängig von \Counter{letter} definiert wird: +\iffalse % Umbruchkorrektur entsprechende der Beispielauswahl oben! \begin{lstcode} \newcounter{Frage}[letter] \newcommand{\Frage}[1]{% @@ -793,8 +1221,19 @@ referenzierbar um eins erhöht wird. \end{tabularx}% }% \end{lstcode} +\else % +\begin{lstcode} + \newcounter{Frage}[letter] + \newcommand{\Frage}[1]{% + \refstepcounter{Frage}\par + \noindent\begin{tabularx}{\textwidth}{l@{}X} + \theFrage:~ & #1\\ + \end{tabularx}% + }% +\end{lstcode} +\fi % Damit wird der Zähler automatisch zu Beginn jedes Briefs wieder auf Null - zurück gesetzt, so dass die erste Frage in jedem Brief wieder mit der Nummer + zurückgesetzt, so dass die erste Frage in jedem Brief wieder mit der Nummer Eins beginnt. \end{Example} @@ -858,6 +1297,8 @@ gesetzt werden, so muss eben das Argument von \Macro{opening} leer bleiben. eine Anrede verzichtet, da individualisierte Serienbriefe kaum möglich waren. Heute sind persönliche Anreden auch bei Massensendungen üblich.% \end{Explain}% +\else +\ExampleEndFix% Beispiel am Ende der Beschreibung \fi \EndIndexGroup @@ -871,9 +1312,13 @@ gesetzt. Diese kann auch mehrzeilig sein. Die einzelnen Zeilen sollten dann mit doppeltem Backslash voneinander getrennt werden. Absätze innerhalb der \PName{Grußfloskel} sind jedoch nicht gestattet. -Darüber hinaus setzt diese Anweisung aber auch noch gleich den Inhalt der -Variablen \DescRef{\LabelBase.variable.signature} als Signatur. Näheres zur -Signatur und deren Konfiguration ist \autoref{sec:\LabelBase.closing} ab +Darüber hinaus setzt diese Anweisung % +\iffalse% Umbruchkorrekturgelabler +aber auch noch gleich % +\fi% +den Inhalt der Variablen \DescRef{\LabelBase.variable.signature} als +Signatur. Näheres zur Signatur und deren Konfiguration ist +\autoref{sec:\LabelBase.closing} ab \DescPageRef{\LabelBase.variable.signature} zu entnehmen. \begin{Example} @@ -894,12 +1339,13 @@ Signatur und deren Konfiguration ist \autoref{sec:\LabelBase.closing} ab \end{Example} % \EndIndexGroup +\ExampleEndFix% Beispiel am Ende der Beschreibung \begin{Declaration} \Macro{ps} \end{Declaration}% -Diese Anweisung schaltet lediglich auf das +Diese Anweisung schaltet auf das Postskriptum\Index{Postskriptum} um. Dazu wird ein neuer Absatz begonnen und ein vertikaler Abstand -- in der Regel zur Signatur -- eingefügt. Auf die Anweisung \Macro{ps} kann beliebiger Text folgen. @@ -923,24 +1369,27 @@ automatisch noch optional. \end{captionbeside} \label{fig:\LabelBase.letter-2} \end{figure} -\end{Example} - +\end{Example}% +\iffalse % Umbruchkorrektur \begin{Explain}% Als Briefe noch von Hand geschrieben wurden, war das Postskriptum sehr beliebt. Es handelte sich bei diesen Nachsätzen ursprünglich um Angaben, die im eigentlichen Brief vergessen wurden. Bei Briefen, die mit \LaTeX{} geschrieben werden, ist es natürlich einfach, Vergessenes nachträglich in den Brief einzuarbeiten. % -\iffalse % Umbruchkorrektur +\iftrue % Umbruchkorrektur Trotzdem ist das Postskriptum noch immer sehr beliebt, kann man damit doch sehr schön noch einmal auf ganz andere äußerst wichtige oder eigentlich ganz unwichtige Dinge hinweisen.% -\fi -\iftrue % Umbruchkorrektur +\fi% +\iffalse % Umbruchkorrektur Heutzutage verwendet man das Postskriptum dagegen eher für Hinweise, die mit dem eigentlichen Briefinhalt wenig zu tun haben. -\fi -\end{Explain} +\fi% +\end{Explain}% +\else% +\ExampleEndFix% Beispiel am Ende +\fi% % \EndIndexGroup @@ -950,8 +1399,11 @@ automatisch noch optional. \Variable{ccseparator} \end{Declaration} Ein \PName{Verteiler}\Index{Verteiler} kann mit der Anweisung \Macro{cc} -gesetzt werden. Der \PName{Verteiler} wird der Anweisung dabei als Argument -übergeben. Wenn der \PName{Inhalt} der Variablen +gesetzt werden. % +\iftrue% Umbruchkorrektur +Der \PName{Verteiler} wird der Anweisung dabei als Argument übergeben. % +\fi% +Wenn der \PName{Inhalt} der Variablen \Variable{ccseparator}\Index{Trennzeichen} nicht leer ist, wird dem \PName{Verteiler} die \PName{Bezeichnung} und der \PName{Inhalt} dieser Variablen vorangestellt. Der \PName{Verteiler} selbst wird dann um die @@ -963,7 +1415,9 @@ trennen. Der Beispielbrief soll dieses Mal nicht nur an die Vorsitzende, sondern mit Verteiler auch an alle Mitglieder des Vereins gehen: \lstinputcode[xleftmargin=1em]{letter-3.tex}% - Das Ergebnis ist in \autoref{fig:\LabelBase.letter-3} zu sehen. + \iftrue % Umbruchkorrektur (siehe auch unten) + Das Ergebnis ist in \autoref{fig:\LabelBase.letter-3} zu sehen.% + \fi% \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit Anschrift, @@ -976,7 +1430,12 @@ trennen. \label{fig:\LabelBase.letter-3} \end{figure} \end{Example} +\iftrue% Umbruchkorrektur in Korrelation zu der im Beispiel Vor dem Verteiler wird automatisch ein Abstand eingefügt.% +\else% +Wie in \autoref{fig:\LabelBase.letter-3} zu sehen, wird vor dem Verteiler +automatisch ein Abstand eingefügt.% +\fi% % \EndIndexGroup @@ -1012,7 +1471,6 @@ hier von der \PName{Bezeichnung} und dem \PName{Inhalt} der Variablen % \EndIndexGroup - \LoadCommonFile{fontsize} % \section{Wahl der Schriftgröße für das Dokument} \LoadCommonFile{textmarkup} % \section{Textauszeichnungen} @@ -1050,23 +1508,27 @@ Briefseiten abgesehen von der ersten. \end{figure} +\subsection{Faltmarken} +\seclabel{foldmarks} +\BeginIndexGroup +\BeginIndex{}{Faltmarke}% + +Falt- oder Falzmarken sind kleine horizontale Striche am linken und kleine +vertikale Striche am oberen Rand. \KOMAScript{} unterstützt für den Briefbogen +derzeit drei konfigurierbare horizontale und eine konfigurierbare vertikale +Faltmarke. Dazu wird noch eine horizontale Loch- oder Seitenmittenmarke +unterstützt, die nicht in der Vertikalen verschoben werden kann. + \begin{Declaration} \OptionVName{foldmarks}{Einstellung} \end{Declaration} -Falt- oder Falzmarken\Index{Faltmarken}\textnote{Faltmarken} sind kleine -horizontale Striche am linken und kleine vertikale Striche am oberen -Rand. \KOMAScript{} unterstützt für den Briefbogen derzeit drei -konfigurierbare horizontale und eine konfigurierbare vertikale Faltmarke. Dazu -wird noch eine horizontale Loch- oder Seitenmittenmarke unterstützt, die nicht -in der Vertikalen verschoben werden kann. - Mit der Option \Option{foldmarks} können Faltmarken\Index{Faltmarke} für eine vertikale Zwei"~, Drei- oder Vierteilung und eine horizontale Zweiteilung aktiviert oder deaktiviert werden. Die einzelnen Teile müssen dabei nicht äquidistant sein. Die Positionen von drei der vier horizontalen und der vertikalen Marke sind über Pseudolängen konfigurierbar (siehe -\autoref{sec:scrlttr2-experts.foldmarks} ab -\DescPageRef{scrlttr2-experts.plength.foldmarkvpos}). +\autoref{sec:\LabelBase.pseudoLength}, +\autopageref{sec:\LabelBase.pseudoLength}). Über die Option \Option{foldmarks} können entweder mit den Standardwerten für einfache Schalter, die in \autoref{tab:truefalseswitch}, @@ -1143,44 +1605,177 @@ abhängig. Voreingestellt sind \PValue{true} und \BeginIndex{FontElement}{foldmark}\LabelFontElement{foldmark}% Über\ChangedAt{v2.97c}{\Class{scrlttr2}} das Element \FontElement{foldmark} kann die Farbe der Faltmarken geändert werden. Dazu werden die Anweisungen -\DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe -\autoref{sec:\LabelBase.textmarkup}, -\DescPageRef{\LabelBase.cmd.setkomafont}) verwendet. Voreingestellt ist -keine Änderung.% +\DescRef{\LabelBase.cmd.setkomafont} und +\DescRef{\LabelBase.cmd.addtokomafont} (siehe +\autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) +verwendet. Voreingestellt ist keine Änderung.% \EndIndexGroup \begin{Declaration} - \OptionVName{enlargefirstpage}{Ein-Aus-Wert} + \PLength{tfoldmarkvpos} + \PLength{mfoldmarkvpos} + \PLength{bfoldmarkvpos} \end{Declaration} -\begin{Explain} - Die erste Seite eines Briefes fällt % - \iftrue % Umbruchkorrektur - aufgrund der vielen Konsultationselemente, wie dem Briefkopf oder der - Anschrift, - % - \fi % - immer aus dem normalen Satzspiegel. Von \Class{scrlttr2} werden Mechanismen - bereitgestellt, um die Höhe und vertikale Ausrichtung von Kopf und Fuß der - ersten Seite unabhängig von den Folgeseiten zu bestimmen. Würde dadurch der - Fuß der ersten Seite in den Textbereich\Index{Text>Bereich} ragen, so wird - der Textbereich der ersten Seite automatisch mit Hilfe von - \Macro{enlargethispage}\IndexCmd{enlargethispage} verkleinert. -\end{Explain} -Soll der Textbereich auch automatisch mit \Macro{enlargethispage} vergrößert -werden, falls der Fuß der ersten Seite dies erlaubt, so kann das mit dieser -Option erreicht werden. Es passt dann bestenfalls etwas mehr Text auf die -erste Seite. Siehe hierzu auch die Erklärung zur Pseudolänge -\PLength{firstfootvpos} auf -\DescPageRef{scrlttr2-experts.plength.firstfootvpos}. Als -\PName{Ein-Aus-Wert} kann dabei einer der Standardwerte für einfache Schalter -aus \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet -werden. Voreingestellt ist \PValue{false}.\textnote{Voreinstellung}% +\KOMAScript{} kennt für Briefe \Class{scrlttr2} insgesamt drei in der vertikalen +Platzierung konfigurierbare Faltmarken. Die Position der oberen Faltmarke vom +oberen Papierrand wird von der Pseudolänge \PLength{tfoldmarkvpos} +bestimmt. Für die Position der mittleren Faltmarke ist Pseudolänge +\PLength{mfoldmarkvpos}\ChangedAt{v2.97e}{\Class{scrlttr2}}, für die untere +Faltmarke \PLength{bfoldmarkvpos} zuständig. Mit der +Locher-\Index{Lochermarke} oder Seitenmittenmarke kommt noch eine weitere +horizontale Marke dazu. Diese wird jedoch immer in der vertikalen Seitenmitte +platziert. +\iffalse% Umbruchkorrekturtext! +Da ihre vertikale Position also nicht konfigurierbar ist, existiert +auch keine Pseudolänge dafür. +\fi + +Die\important{Achtung!} obere und untere Faltmarke dienen nicht der exakten +Drittelung des Papiers beim Falten. Vielmehr soll das Papier mit ihrer Hilfe +so geknickt werden können, dass das Feld für die Anschrift in einem +Fensterbriefumschlag zu sehen ist. Die Einstellungen sind daher von den +\File{lco}-Dateien\textnote{\File{lco}-Datei}% +\Index{lco-Datei=\File{lco}-Datei} abhängig. Eine +Besonderheit\textnote{Achtung!} stellt \Option{DINmtext} dar. Hier wird +von einem Briefumschlag im Format C6/5 (auch »C6 lang« genannt) +ausgegangen. Briefe, die mit dieser Option erstellt wurden, sind normalerweise +nicht für Fensterbriefumschläge im Format C5 oder C4 geeignet. + +Die mittlere Faltmarke wird für abendländische Briefe normalerweise nicht +benötigt. Beispielsweise in Japan gibt es jedoch so unterschiedliche +Briefumschläge, dass eine weitere Faltmarke benötigt wurde (siehe die +japanischen \File{lco}-Dateien). An dieser Stelle sei darauf hingewiesen, dass +die Bezeichnungen »obere«, »mittlere« und »untere« Faltmarke lediglich eine +Sprachkonvention darstellen. Tatsächlich ist nicht festgelegt, dass +\PLength{tfoldmarkvpos} kleiner als \PLength{mfoldmarkvpos} und dieses kleiner +als \PLength{bfoldmarkvpos} sein muss. Ist\textnote{Achtung!} eine der +Pseudolängen hingegen Null, so wird die entsprechende Faltmarke auch dann +nicht gesetzt, wenn sie per Option \DescRef{\LabelBase.option.foldmarks}% +\IndexOption{foldmarks~=\PName{Einstellung}}% +\important{\DescRef{\LabelBase.option.foldmarks}} (siehe +\DescPageRef{\LabelBase.option.foldmarks}) explizit aktiviert wurde.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{tfoldmarklength} + \PLength{mfoldmarklength} + \PLength{bfoldmarklength} + \PLength{pfoldmarklength} +\end{Declaration} +Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} vier Pseudolängen bestimmen die +Länge der vier horizontalen Marken. Dabei gilt eine +Besonderheit. Ist\textnote{Achtung!} die Länge nämlich mit Null angegeben, so +werden bei den Pseudolängen \PLength{tfoldmarklength}, +\PLength{mfoldmarklength} und \PLength{bfoldmarklength} für die drei in der +vertikalen Position konfigurierbaren Faltmarken stattdessen 2\Unit{mm} als +Länge verwendet. Die Länge der Lochermarke, \PLength{pfoldmarklength}, wird +hingegen auf 4\Unit{mm} gesetzt.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{foldmarkhpos} +\end{Declaration} +Diese Pseudolänge gibt den Abstand aller horizontalen Faltmarken vom linken +Papier\-rand an. Normalerweise sind das 3{,}5\Unit{mm}. Sie\textnote{Tipp!} +können den Wert aber auch in Ihrer eigenen \File{lco}-Datei ändern, falls Sie +einen Drucker verwenden, der einen breiteren unbedruckbaren linken Rand +hat. Ob die Faltmarken überhaupt gesetzt werden, hängt außerdem von der Option +\DescRef{\LabelBase.option.foldmarks}% +\important{\DescRef{\LabelBase.option.foldmarks}}% +\IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe +\DescPageRef{\LabelBase.option.foldmarks}).% % \EndIndexGroup \begin{Declaration} + \PLength{lfoldmarkhpos} +\end{Declaration} +Neben\ChangedAt{v2.97e}{\Class{scrlttr2}} den horizontalen Faltmarken gibt es +auch noch eine vertikale Faltmarke. Deren Abstand von der linken Papierkante +wird über die Pseudolänge \PLength{lfoldmarkhpos} bestimmt. Diese Faltmarke +wird beispielsweise bei Briefen für einige japanische Chou- oder You-Umschläge +benötigt, wenn man diese für A4-Papier verwenden +will. In\textnote{Voreinstellung} den japanischen +\File{lco}-Dateien\Index{lco-Datei=\File{lco}-Datei} (siehe +\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) ist +daher ein Wert von 202\Unit{mm} voreingestellt. Mit der Voreinstellung Null +der übrigen \File{lco}-Dateien wird auch dann keine Marke ausgegeben, wenn sie +per Option \DescRef{\LabelBase.option.foldmarks}% +\important{\DescRef{\LabelBase.option.foldmarks}}% +\IndexOption{foldmarks~=\PName{Einstellung}} (siehe +\DescPageRef{\LabelBase.option.foldmarks}) aktiviert wird.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{lfoldmarklength} +\end{Declaration} +Die Pseudolänge \PLength{lfoldmarklength} bestimmt +die\ChangedAt{v2.97e}{\Class{scrlttr2}} Länge der vertikalen +Faltmarke. Auch\textnote{Achtung!} hier gibt es die Besonderheit, dass bei +einer angegebenen Länge von Null stattdessen 4\Unit{mm} verwendet werden.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{foldmarkvpos} +\end{Declaration} +Die\ChangedAt{v2.97e}{\Class{scrlttr2}} Pseudolänge gibt den Abstand +\iffree{aller}{der} vertikalen Faltmarke\iffree{n}{} vom oberen Papier\-rand +an. Normalerweise\textnote{Voreinstellung} sind das 3{,}5\Unit{mm}. % +\iffalse% Umbruchkorrektur +Sie\textnote{Tipp!} können den Wert aber auch in Ihrer eigenen +\File{lco}-Datei ändern, falls Sie einen Drucker verwenden, der einen +breiteren unbedruckbaren oberen Rand hat. % +\fi% +Ob die Faltmarke\iffree{n}{} überhaupt gesetzt \iffree{werden}{wird}, hängt +außerdem von der Option \DescRef{\LabelBase.option.foldmarks}% +\important{\DescRef{\LabelBase.option.foldmarks}}% +\IndexOption{foldmarks~=\PName{Einstellung}} ab (siehe +\DescPageRef{\LabelBase.option.foldmarks}).\iffree{ Derzeit gibt es nur eine + einzige vertikale Faltmarke, die als linke vertikale Faltmarke bezeichnet + wird.}{}% +\EndIndexGroup + + +\begin{Declaration} + \PLength{foldmarkthickness} +\end{Declaration} +Diese\ChangedAt{v2.97c}{\Class{scrlttr2}} Pseudolänge gibt die Dicke aller +Faltmarken an. Voreingestellt\textnote{Voreinstellung} sind 0,2\Unit{pt}, also +eine sehr dünne Haarlinie. Insbesondere wenn die Farbe der Faltmarken +geändert wird, kann dies zu wenig sein!% +\EndIndexGroup +% +\EndIndexGroup + + +\subsection{Briefkopf} +\seclabel{firstHead} +\BeginIndexGroup +\BeginIndex{}{Briefkopf}% + +Unter dem Briefkopf verstehen wir alle Angaben, die den Absender betreffen und +die über der Anschrift stehen. Normalerweise würde man erwarten, dass diese +über den Seitenstil gesetzt werden. % +\iffalse% Umruchkorrektur +Bei der alten Briefklasse \Class{scrlettr} war dies auch so. % +\fi% +Bei\textnote{Achtung!} \Class{scrlttr2} und \Package{scrletter} wird der +Briefkopf jedoch unabhängig vom Seitenstil von der Anweisung +\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} ausgegeben. +\iffalse% Umbruchkorrektur +Dabei wird der Briefkopf absolut positioniert, ist also vom Satzspiegel +unabhängig. Die erste Seite eines Briefes, also die Seite mit dem Briefkopf, +wird tatsächlich mit dem Seitenstil +\DescRef{\LabelBase.pagestyle.empty}\IndexPagestyle{empty} gesetzt.% +\fi + +\begin{Declaration} \OptionVName{firsthead}{Ein-Aus-Wert} \end{Declaration} \iffalse% Umbruchkorrekturtext @@ -1211,12 +1806,21 @@ Absenderergänzung\Index{Absenderergaenzung=Absenderergänzung} unterzubringen. Gleichzeitig\textnote{Achtung!} dient diese Option als zentraler Schalter, um die Erweiterungen der Briefkopfgestaltung überhaupt zu aktivieren oder zu deaktivieren. Sind die Erweiterungen deaktiviert, so -bleiben die übrigen nachfolgend angegebenen Optionen ohne Wirkung. Mögliche -Werte für \Option{fromalign} sind \autoref{tab:\LabelBase.fromalign} zu -entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}% -% +bleiben % +\iffalse % Umbruchkorrektur +die Optionen \DescRef{\LabelBase.option.fromrule}, +\DescRef{\LabelBase.option.fromphone}, +\DescRef{\LabelBase.option.frommobilephone}, +\DescRef{\LabelBase.option.fromemail}, \DescRef{\LabelBase.option.fromurl} und +\DescRef{\LabelBase.option.fromlogo} % +\else% +diverse Optionen für den Absender % +\fi % +ohne Wirkung. Mögliche Werte für \Option{fromalign} sind +\autoref{tab:\LabelBase.fromalign} zu entnehmen. Voreingestellt ist der Wert +\PValue{left}.\textnote{Voreinstellung}% \EndIndexGroup - +% \begin{table} \Index{Briefkopf}% \caption[{Mögliche Werte für Option @@ -1226,36 +1830,89 @@ entnehmen. Voreingestellt ist der Wert \PValue{left}.\textnote{Voreinstellung}% \label{tab:\LabelBase.fromalign} \begin{desctabular} \entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{% - Absender wird innerhalb des Briefkopfes zentriert; ein Logo wird + Der Absender wird innerhalb des Briefkopfes zentriert; ein Logo wird gegebenenfalls am Anfang der erweiterten Absenderangabe platziert; die - Erweiterungen der Briefkopfgestaltung werden aktiviert.}% + Erweiterungen der Briefkopfgestaltung werden + aktiviert.}\\[-1.7ex] \entry{\PValue{false}, \PValue{no}, \PValue{off}}{% - Standardgestalt für den Absender wird verwendet; die Erweiterungen der - Briefkopfgestaltung werden deaktiviert.}% + Die einfache Form des Absender wird verwendet; die Erweiterungen der + Briefkopfgestaltung werden deaktiviert; die Optionen + \DescRef{\LabelBase.option.fromrule}, + \DescRef{\LabelBase.option.fromphone}, + \DescRef{\LabelBase.option.frommobilephone}, + \DescRef{\LabelBase.option.fromemail}, + \DescRef{\LabelBase.option.fromurl} und + \DescRef{\LabelBase.option.fromlogo} werden + wirkungslose.}\\[-1.7ex] \entry{\PValue{left}}{% - Absender steht linksbündig im Briefkopf; ein Logo wird gegebenenfalls - rechtsbündig platziert; die Erweiterungen der Briefkopfgestaltung werden - aktiviert.}% + Der Absender steht linksbündig im Briefkopf; ein Logo wird + gegebenenfalls rechtsbündig platziert; die Erweiterungen der + Briefkopfgestaltung werden + aktiviert.}\\[-1.7ex] \entry{\PValue{locationleft}, \PValue{leftlocation}}{% - Absender steht linksbündig in der Absenderergänzung; ein Logo wird + Der Absender steht linksbündig in der Absenderergänzung; ein Logo wird gegebenenfalls darüber platziert; der Briefkopf wird automatisch deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} - wieder aktiviert werden.}% + wieder aktiviert werden.}\\[-1.7ex] \entry{\PValue{locationright}, \PValue{rightlocation}, \PValue{location}}{% - Absender steht rechtsbündig in der Absenderergänzung; ein Logo wird + Der Absender steht rechtsbündig in der Absenderergänzung; ein Logo wird gegebenenfalls darüber platziert; der Briefkopf wird automatisch deaktiviert, kann aber über Option \DescRef{\LabelBase.option.firsthead} - wieder aktiviert werden.}% + wieder aktiviert werden.}\\[-1.7ex] \entry{\PValue{right}}{% - Absender steht rechtsbündig im Briefkopf; ein Logo wird gegebenenfalls - linksbündig platziert; die Erweiterungen der Briefkopfgestaltung werden - aktiviert.}% + Der Absender steht rechtsbündig im Briefkopf; ein Logo wird + gegebenenfalls linksbündig platziert; die Erweiterungen der + Briefkopfgestaltung werden aktiviert.}% \end{desctabular} \end{table} \begin{Declaration} + \PLength{firstheadvpos} +\end{Declaration} +Die Pseudolänge \PLength{firstheadvpos} gibt den Abstand des Briefkopfes von +der oberen Papierkante an. Der Wert wird in den vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +unterschiedlich gesetzt. Ein typischer Wert ist 8\Unit{mm}.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{firstheadhpos} +\end{Declaration} +Die Pseudolänge \PLength{firstheadhpos}\ChangedAt{v3.05}{\Class{scrlttr2}} +gibt bei einem positiven Wert den Abstand des Briefkopfes von der linken +Papierkante an. Ist\textnote{Achtung!} der Wert sogar größer oder gleich der +Breite des Papiers, +\Length{paperwidth}\important{\Length{paperwidth}}\IndexLength{paperwidth}, so +wird der Briefkopf horizontal zentriert auf dem Briefbogen platziert. Ein +negativer Wert gibt den Abstand des Briefkopfes von der rechten Papierkante +an. Ist der Wert jedoch kleiner oder gleich der negativen Breite des Papiers, +so wird der Briefkopf bündig zum linken Rand des Satzspiegels platziert. +Voreingestellt\textnote{Voreinstellung} ist typischerweise ein Wert von +\Length{maxdimen}\IndexLength{maxdimen}% +\iffalse % Umbruchkorrektur +, also der größtmögliche Wert für eine Länge% +\fi% +\ und infolge dessen horizontale Zentrierung.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{firstheadwidth} +\end{Declaration} +Die Pseudolänge \PLength{firstheadwidth} gibt die Breite des Briefkopfes +an. Der Wert wird in den vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +unterschiedlich gesetzt. Während er normalerweise\textnote{Voreinstellung} von +der Papierbreite und dem horizontalen Abstand der Empfängeradresse vom linken +Papierrand abhängt, entspricht er bei \Option{KOMAold} der Breite des +Satzspiegels und ist bei \Option{NF} fest auf 170\Unit{mm} eingestellt.% +\EndIndexGroup + + +\begin{Declaration} \OptionVName{fromrule}{Position} \Variable{fromname} \Variable{fromaddress} @@ -1272,8 +1929,9 @@ folgen. Alternativ\important{\OptionValue{fromrule}{afteraddress}} kann die Linie mit \OptionValue{fromrule}{afteraddress} auch unterhalb des kompletten Absenders gesetzt werden. Eine Übersicht über alle möglichen Einstellungen für die Linie bietet \autoref{tab:\LabelBase.fromrule}. Die Länge der Linie wird -über die Pseudolänge \PLength{fromrulewidth}\IndexPLength{fromrulewidth} -bestimmt. +über die Pseudolänge +\DescRef{\LabelBase.plength.fromrulewidth}\IndexPLength{fromrulewidth} +bestimmt (siehe \DescPageRef{\LabelBase.plength.fromrulewidth}). \begin{table} \KOMAoptions{captions=topbeside}% @@ -1281,8 +1939,7 @@ bestimmt. % \caption \begin{captionbeside} [{% - Mögliche Werte für Option \Option{fromrule} bei - \Class{scrlttr2} und \Package{scrletter}% + Mögliche Werte für Option \Option{fromrule}% }]{% \label{tab:\LabelBase.fromrule}% Mögliche Werte für Option \Option{fromrule} zur @@ -1307,8 +1964,8 @@ bestimmt. \end{table} In der Voreinstellung\textnote{Voreinstellung} ist die Linie im erweiterten -Briefkopf nicht aktiviert. Im Standardbriefkopf wird die Linie immer nach dem -Namen gesetzt. +Briefkopf nicht aktiviert. Im einfachen Briefkopf wird die Linie immer nach +dem Namen gesetzt. Unter\important{\Variable{fromaddress}} dem Namen folgt die Anschrift des Absenders. Diese wird über die Variable \Variable{fromaddress} bestimmt. Im @@ -1320,24 +1977,35 @@ gesetzt. \BeginIndex{FontElement}{fromaddress}\LabelFontElement{fromaddress}% \BeginIndex{FontElement}{fromname}\LabelFontElement{fromname}% \BeginIndex{FontElement}{fromrule}\LabelFontElement{fromrule}% -Die Schrift, die für den kompletten Absender verwendet wird, kann über das -Element \FontElement{fromaddress}\IndexFontElement{fromaddress}% +Die Schrift, die für den Absender verwendet wird, kann über das Element +\FontElement{fromaddress}\IndexFontElement{fromaddress}% \important{\FontElement{fromaddress}} eingestellt werden. Abweichungen davon können für den Absendernamen über das Element \FontElement{fromname}\IndexFontElement{fromname}% -\important{\FontElement{fromname}} und für die mit \Option{fromrule} gesetzte +\important{\FontElement{fromname}} und für die % +\iffalse% Umbruchkorrektur +mit \Option{fromrule} gesetzte % +\else % +optionale % +\fi% Linie über das Element \FontElement{fromrule}\IndexFontElement{fromrule}% \important{\FontElement{fromrule}} eingestellt werden. In der Voreinstellung erfolgt keinerlei Schriftumschaltung. Bei der Linie ist die Möglichkeit der -Schriftumschaltung hauptsächlich dazu gedacht, die Farbe der Linie ändern zu -können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu -\cite{package:xcolor}.% +Schriftumschaltung hauptsächlich dazu gedacht, die Farbe % +\iffalse % Umbruchkorrektur +der Linie % +\fi +ändern zu können% +\iffalse% Umbruchkorrektur +, um etwa Grau anstelle von Schwarz zu verwenden% +\fi% +. Siehe hierzu \cite{package:xcolor}.% % \EndIndexGroup - +% \begin{Example} Geben wir nun dem Absender - \iftrue % Umbruchkorrektur + \iffalse % Umbruchkorrektur aus den bisherigen Beispielen \fi % einen Namen. @@ -1351,18 +2019,21 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu {Ergebnis eines kleinen Briefes mit Absender, Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen und Verteiler (Datum und Faltmarken entstammen den Voreinstellungen für DIN-Briefe); links der - Standardbriefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, + einfache Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} \label{fig:\LabelBase.letter-8-9} \end{figure} - Dabei wird zunächst einmal nicht der erweiterte Briefkopf, sondern nur der - Standardbriefkopf verwendet. Das Ergebnis ist in + Dabei wird zunächst % + \iffalse % Umbruchkorrektur + einmal nicht der erweiterte Briefkopf, sondern % + \fi % + nur der einfache Briefkopf verwendet. Das Ergebnis ist in \autoref{fig:\LabelBase.letter-8-9} links zu sehen. Im Vergleich dazu ist rechts daneben das gleiche Beispiel, jedoch mit Option \OptionValueRef{\LabelBase}{fromalign}{center}, also mit den aktivierten Erweiterungen für den Briefkopf, abgebildet. Wie zu sehen ist, hat diese - Variante zunächst einmal keine Linie. + Variante zunächst einmal keine Linie. In \autoref{fig:\LabelBase.letter-8-9} taucht nun auch erstmals eine Signatur unter dem Gruß auf. Diese wird automatisch aus dem Absendername @@ -1374,12 +2045,12 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu der Option \Option{fromrule} auch noch eine Linie unter dem Namen erhalten:% \lstinputcode[xleftmargin=1em]{letter-11.tex}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-10-11} rechts zu sehen. % - \iftrue % Umbruchkorrektur + \iffalse % Umbruchkorrektur Im Vergleich dazu ist links daneben das gleiche Beispiel noch einmal mit dem - Standardbriefkopf und ohne Reaktion auf die zusätzliche Option. + einfachen Briefkopf und ohne Reaktion auf die zusätzliche Option. % \else % - Links steht zum Vergleich ein Beispiel mit Standardbriefkopf. + Links steht zum Vergleich ein Beispiel mit dem einfachen Briefkopf. % \fi % @@ -1392,7 +2063,7 @@ können, um etwa Grau anstelle von Schwarz zu verwenden. Siehe hierzu Lochermarke}]{Ergebnis eines kleinen Briefes mit Absender, Trennlinie, Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke (das Datum entstammt den Voreinstellungen für - DIN-Briefe); links der Standardbriefkopf mit + DIN-Briefe); links der einfache Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} \label{fig:\LabelBase.letter-10-11} @@ -1407,7 +2078,7 @@ Länderangabe. Dieser doppelte Backslash wird je nach Verwendung der Absenderadresse unterschiedlich interpretiert und ist nicht zwangsläufig als Zeilenumbruch zu verstehen. Absätze, vertikale Abstände und Ähnliches sind innerhalb der Absenderangaben normalerweise nicht gestattet% -\iftrue % Umbruchkorrektur +\iffalse % Umbruchkorrektur . Man muss \KOMAScript{} schon sehr genau kennen, um solche Mittel gegebenenfalls sinnvoll im Absender einsetzen zu können. Außerdem sollte man in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable @@ -1427,6 +2098,28 @@ in dem Fall unbedingt die Variablen für Rücksendeadresse (siehe Variable \begin{Declaration} + \PLength{fromrulethickness} + \PLength{fromrulewidth} +\end{Declaration} +Wie bereits bei Option +\DescRef{\LabelBase.option.fromrule}\IndexOption{fromrule} auf +\DescPageRef{\LabelBase.option.fromrule} erwähnt wurde, kann in den +vordefinierten Briefköpfen eine Linie im oder unter dem Absender gesetzt +werden. Hat\textnote{Achtung!} die Pseudolänge \PLength{fromrulewidth} die +Länge 0, so wird dabei die Länge dieser Linie automatisch bestimmt. Dies ist +die Voreinstellung\textnote{Voreinstellung} bei den vordefinierten +\File{lco}-Dateien. % +\iffalse % Umbruchkorrekturtext +Der Wert kann mit \DescRef{\LabelBase.cmd.setplength} (siehe +\DescPageRef{\LabelBase.cmd.setplength}) in eigenen \File{lco}-Dateien aber +auch abweichend gesetzt werden. % +\fi% +Die voreingestellte Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, +\PLength{fromrulethickness}, der Linie beträgt 0,4\Unit{pt}.% +\EndIndexGroup + + +\begin{Declaration} \OptionVName{symbolicnames}{Wert} \OptionVName{fromphone}{Ein-Aus-Wert} \OptionVName{frommobilephone}{Ein-Aus-Wert} @@ -1461,8 +2154,8 @@ eingefügt werden, \autoref{tab:\LabelBase.fromSeparator}. Mit\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}} Option \Option{symbolicnames} kann diese Voreinstellung auf einen Schlag -geändert werden. Die Option versteht als \PName{Wert} die -\PName{Ein-Aus-Werte} für einfache Schalter, wie sie in +geändert werden. Die Option versteht die +Ein-Aus-Werte für einfache Schalter, wie sie in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Die\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} Aktivierung der Option entspricht dabei dem \PName{Wert} \PValue{marvosym}, @@ -1474,7 +2167,7 @@ wodurch statt der sprachabhängigen Bezeichner \Package{marvosym}\IndexPackage{marvosym}-Paket verwendet werden. Gleichzeitig entfällt der Doppelpunkt bei der Definition der Trennzeichen. Für die URL entfallen in diesem Fall sowohl der sprachabhängige Bezeichner als auch das -Trennzeichen. Mit \OptionValue{symbolicnames}{fontawsome} oder +Trennzeichen. Mit \OptionValue{symbolicnames}{fontawesome} oder \OptionValue{symbolicnames}{awesome} werden stattdessen Symbole von Paket \Package{fontawesome}\IndexPackage{fontawesome} verwendet. Dabei wird auch für die URL ein passendes Symbol aktiviert. Es ist zu beachten\textnote{Achtung!}, @@ -1488,7 +2181,7 @@ aktiviert wird. \caption[{Vordefinierte Bezeichnungen der Variablen für die\newline Absenderangaben im Briefkopf}]{Vordefinierte Bezeichnungen der Variablen für die Absenderangaben im Briefkopf (die Bezeichnungen und Inhalte der - verwendeten Variablen für Trennzeichen ist + verwendeten Variablen für Trennzeichen sind \autoref{tab:\LabelBase.fromSeparator} zu entnehmen)} \begin{desctabular}[1.8em] \ventry{fromemail}{% @@ -1544,10 +2237,16 @@ aktiviert wird. entsprechenden Optionen an und setzt auch die zugehörigen Variablen:% \lstinputcode[xleftmargin=1em]{letter-12.tex}% Das Ergebnis aus \autoref{fig:\LabelBase.letter-12-13} links ist jedoch - ernüchternd. Die Optionen werden ignoriert. Das liegt daran, dass diese - zusätzlichen Variablen und Optionen nur im erweiterten Briefkopf verwendet - werden. Es muss also, wie in \autoref{fig:\LabelBase.letter-12-13}, rechts die - Option \DescRef{\LabelBase.option.fromalign} verwendet werden: + ernüchternd. Die Optionen werden ignoriert. Das liegt % + \iffalse% Umbruchkorrektur + daran, dass diese zusätzlichen Variablen und Optionen nur im erweiterten + Briefkopf verwendet werden. % + \else% + an Option \OptionValueRef{\LabelBase}{fromalign}{false}. % + \fi% + Es muss also, wie in \autoref{fig:\LabelBase.letter-12-13}, rechts + beispielsweise Option \OptionValueRef{\LabelBase}{fromalign}{center} + verwendet werden:% \begin{figure} \centering \frame{\includegraphics[width=.4\textwidth]{letter-12}}\quad @@ -1558,7 +2257,7 @@ aktiviert wird. kleinen Briefes mit erweitertem Absender, Trennlinie, Anschrift, Anrede, Text, Grußfloskel, Signatur, Postskriptum, Anlagen, Verteiler und Lochermarke (das Datum entstammt den Voreinstellungen für DIN-Briefe); - links der Standardbriefkopf mit + links der einfache Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{false}, rechts der erweiterte Briefkopf mit \OptionValueRef{\LabelBase}{fromalign}{center}} \label{fig:\LabelBase.letter-12-13} @@ -1588,6 +2287,7 @@ aktiviert wird. \end{Example} % \EndIndexGroup +\ExampleEndFix% Beispiel am Ende \begin{Declaration} @@ -1603,8 +2303,7 @@ der Standardwerte für einfache Schalter aus \autoref{tab:truefalseswitch}, werden. Voreingestellt\textnote{Voreinstellung} ist \PValue{false}, also kein Logo. Das Logo selbst wird über die Variable \Variable{fromlogo} definiert. Die \PName{Bezeichnung} für das Logo ist in der Voreinstellung leer -und wird von \KOMAScript{} auch nicht verwendet (siehe auch -\autoref{tab:\LabelBase.fromTerm}, \autopageref{tab:\LabelBase.fromTerm}).% +und wird von \KOMAScript{} auch nicht verwendet.% \begin{Example} Herr Musterfrau findet es besonders schick, wenn er seine Briefe mit einem Logo versieht. Sein Logo hat er als Grafikdatei gespeichert, die er gerne @@ -1612,10 +2311,10 @@ und wird von \KOMAScript{} auch nicht verwendet (siehe auch zusätzlich das Paket \Package{graphics}\IndexPackage{graphics} (siehe \cite{package:graphics}) ein.% \lstinputcode[xleftmargin=1em]{letter-16}% - Das Ergebnis ist in \autoref{fig:\LabelBase.letter-16-18}, - \autopageref{fig:\LabelBase.letter-16-18} links oben zu sehen. Die beiden - anderen Bilder in dieser Abbildung zeigen das Ergebnis bei rechtsbündigem - und bei zentriertem Absender. + Das Ergebnis ist in \autoref{fig:\LabelBase.letter-16-18} + % ,\autopageref{fig:\LabelBase.letter-16-18} + links oben zu sehen. Die beiden anderen Bilder in dieser Abbildung zeigen + das Ergebnis bei rechtsbündigem und bei zentriertem Absender. \begin{figure} \setcapindent{0pt}% {\hfill @@ -1637,6 +2336,7 @@ und wird von \KOMAScript{} auch nicht verwendet (siehe auch \end{Example}% % \EndIndexGroup +\ExampleEndFix% Beispiel am Ende \begin{Declaration} @@ -1653,12 +2353,38 @@ definiert man den gewünschten Aufbau über den \PName{Inhalt} der Variablen \Macro{parbox}-Anweisung (siehe \cite{latex:usrguide}) mehrere Boxen neben- und untereinander gesetzt werden. Einem versierten Anwender sollte es so möglich sein, seinen eigenen Briefkopf zu gestalten. Natürlich kann und sollte -man dabei auch Zugriffe auf andere Variablen mit Hilfe von +man dabei auch Zugriff auf andere Variablen mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} nehmen. Die \PName{Bezeichnung} der Variablen \Variable{firsthead} wird von \KOMAScript{} nicht verwendet. -\iffree{}{Ein ausführliches Beispiel für Definition eines Briefkopfes wird in +\iffree{Ein ausführliches Beispiel für die Definition eines Briefkopfes ist + beispielsweise im Anhang von \cite{book:komascript} und + \cite{ebook:komascript} zu finden.% +}{Ein ausführliches Beispiel für die Definition eines Briefkopfes wird in \autoref{cha:modernletters} behandelt.}% \EndIndexGroup +% +\EndIndexGroup + + +\subsection{Anschrift} +\seclabel{addressee}% +\BeginIndexGroup +\BeginIndex{}{Anschrift}% + +% Verschiedene Umbruchvarianten +Unter der Anschrift versteht man normalerweise nur den Namen und die Adresse +des Empfängers. % +\iffalse% +Als \iffree{erste }{}Erweiterung zur Anschrift kann die +Versandart betrachtet werden, die etwa bei \iffree{Einschreiben oder +}{}Infobriefen zur Anwendung kommt. Bei Fensterbriefumschlägen wird auch die +sogenannte Rücksendeadresse \iffree{zur Anschrift}{dazu} gezählt, da sie im +Anschriftfenster zu sehen \iffree{sein wird}{ist}. Die Anschrift folgt +unmittelbar auf den Briefkopf.% +\else% +Aber auch die Versandart, beispielsweise bei Infobriefen, oder die +Rücksendeadresse werden als Teil des Anschriftfeldes gesetzt.% +\fi \begin{Declaration} @@ -1714,8 +2440,7 @@ Adresse des Empfängers beziehen. Für \FontElement{toname} und \EndIndexGroup % \begin{table} - \caption[{Mögliche Werte für Option \Option{addrfield} bei - \Class{scrlttr2} und \Package{scrletter}}] + \caption[{Mögliche Werte für Option \Option{addrfield}}]% {Mögliche Werte für Option \Option{addrfield} zur Auswahl der Art der Anschrift% \label{tab:\LabelBase.addrfield}}% @@ -1726,26 +2451,26 @@ Adresse des Empfängers beziehen. Für \FontElement{toname} und \PValue{ppBackGroundImage}}{% Es wird eine Anschrift mit einer in Variable \Variable{addresseeimage} abgelegten Hintergrundgrafik als Port-Payé-Kopf (P.\,P.-Kopf), aber ohne - Rücksendeadresse und Versandart gesetzt.}% + Rücksendeadresse und Versandart gesetzt.}\\[-1.7ex] \entry{\PValue{false}, \PValue{off}, \PValue{no}}{% - Es wird keine Anschrift gesetzt.}% + Es wird keine Anschrift gesetzt.}\\[-1.7ex] \entry{\PValue{image}, \PValue{Image}, \PValue{PPimage}, \PValue{PPImage}, \PValue{ppimage}, \PValue{ppImage}}{% Eine in Variable \Variable{addresseeimage} abgelegte Abbildung wird als Anschrift mit Port-Payé gesetzt. Adressinformationen und Angaben für - Rücksendeadresse, Versandart oder Priorität werden ignoriert.}% + Rücksendeadresse, Versandart oder Priorität werden ignoriert.}\\[-1.7ex] \entry{\PValue{PP}, \PValue{pp}, \PValue{PPexplicite}, \PValue{PPExplicite}, \PValue{ppexplicite}, \PValue{ppExplicite}}{% Es wird eine Anschrift mit explizit über die Variablen \Variable{fromzipcode}, \Variable{place} und \Variable{PPcode} ausgefülltem Port-Payé-Kopf (P.\,P.-Kopf), gegebenenfalls mit Priorität und über Variable \Variable{PPdatamatrix} gesetzter Data-Matrix, aber - ohne Rücksendeadresse und Versandart gesetzt.}% + ohne Rücksendeadresse und Versandart gesetzt.}\\[-1.7ex] \entry{\PValue{topaligned}, \PValue{alignedtop}% \ChangedAt{v3.17}{\Class{scrlttr2}\and \Package{scrletter}}}{% Es wird eine Anschrift mit Rücksendeadresse und Versandart oder Priorität gesetzt. Die Anschrift wird dabei unter der Versandart nicht - vertikal zentriert.}% + vertikal zentriert.}\\[-1.7ex] \entry{\PValue{true}, \PValue{on}, \PValue{yes}}{% Es wird eine Anschrift mit Rücksendeadresse und Versandart oder Priorität gesetzt.}% @@ -1842,17 +2567,19 @@ verfügbaren Platz gesetzt. \end{table} \BeginIndexGroup -\BeginIndex{FontElement}{specialmail}\LabelFontElement{specialmail} -Zwischen Rücksendeadresse und Empfängeradresse kann bei \iffree{der -}{}Standardeinstellung \OptionValue{addrfield}{true} noch eine optionale -Versandart\Index{Versandart} gesetzt werden. Diese wird genau dann gesetzt, -wenn die Variable \Variable{specialmail} einen \PName{Inhalt} hat und -\OptionValue{priority}{manual}\ChangedAt{v3.03}{\Class{scrlttr2}} gewählt -wird, was der Voreinstellung entspricht. Die \PName{Bezeichnung} von -\Variable{specialmail} wird durch \Class{scrlttr2} nicht genutzt. Die -Ausrichtung wird mit Hilfe der Pseudolängen \PLength{specialmailindent} und -\PLength{specialmailrightindent} (siehe -\DescPageRef{scrlttr2-experts.plength.specialmailindent}) festgelegt. Die +\BeginIndex{FontElement}{specialmail}\LabelFontElement{specialmail} Zwischen +Rücksendeadresse und Empfängeradresse kann bei der Standardeinstellung +\OptionValue{addrfield}{true}\important{\OptionValue{addrfield}{true}} noch +eine optionale Versandart\Index{Versandart} gesetzt werden. Diese wird genau +dann gesetzt, wenn die Variable \Variable{specialmail} einen \PName{Inhalt} +hat und +\OptionValue{priority}{manual}\important{\OptionValue{priority}{manual}}% +\ChangedAt{v3.03}{\Class{scrlttr2}} gewählt wird, was der Voreinstellung +entspricht. Die \PName{Bezeichnung} von \Variable{specialmail} wird durch +\Class{scrlttr2} nicht genutzt. Die Ausrichtung wird mit Hilfe der +Pseudolängen \DescRef{\LabelBase.plength.specialmailindent} und +\DescRef{\LabelBase.plength.specialmailrightindent} (siehe +\DescPageRef{\LabelBase.plength.specialmailindent}) festgelegt. Die voreingestellte Schriftart des Elements\ChangedAt{v2.97c}{\Class{scrlttr2}} \FontElement{specialmail}\important{\FontElement{specialmail}}, die Sie \autoref{tab:\LabelBase.AddresseeElements} entnehmen können, kann mit Hilfe @@ -1865,42 +2592,42 @@ verändert werden.% \BeginIndexGroup \BeginIndex{FontElement}{priority}\LabelFontElement{priority}% \BeginIndex{FontElement}{prioritykey}\LabelFontElement{prioritykey}% -Wird\ChangedAt{v3.03}{\Class{scrlttr2}}\important{\normalcolor - \OptionValue{priority}{A}\\ +Wird\ChangedAt{v3.03}{\Class{scrlttr2}}% +\important[i]{\normalcolor\OptionValue{priority}{A}\\ \normalcolor\OptionValue{priority}{B}} hingegen mit \OptionValue{priority}{A} oder \OptionValue{priority}{B} (siehe \autoref{tab:\LabelBase.priority}) eine internationale Priorität ausgewählt, so wird diese bei \OptionValue{addrfield}{true} als Versandart und bei -\OptionValue{addrfield}{PP}\important{\OptionValue{addrfield}{PP}} an -entsprechender Stelle im Port-Payé-Kopf gesetzt. Dabei wird die +\OptionValue{addrfield}{PP} an entsprechender Stelle im Port-Payé-Kopf +gesetzt. Dabei wird die Grundschrift\important{\FontElement{priority}\\ \FontElement{prioritykey}} über das Element \FontElement{priority} und die davon abweichende Schrift für den Prioritätsschlüssel, »A« oder »B«, über das Element \FontElement{prioritykey} bestimmt. Die voreingestellten Schriftarten der beiden Elemente, die Sie \autoref{tab:\LabelBase.AddresseeElements} -entnehmen können, kann mit Hilfe der Anweisungen +entnehmen können, lassen sich mit den Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) -verändert werden.% +ändern.% \EndIndexGroup \begin{table} - \caption[{Mögliche Werte für Option \Option{priority} bei - \Class{scrlttr2} und \Class{scrletter}}] + \caption[{Mögliche Werte für Option \Option{priority}}] {Mögliche Werte für Option \Option{priority} zur Auswahl einer internationalen Priorität im Adressfeld} \label{tab:\LabelBase.priority} \begin{desctabular} \entry{\PValue{false}, \PValue{off}, \PValue{no}, \PValue{manual}}{% - Es wird keine Priorität gesetzt.}% + Es wird keine Priorität gesetzt.}\\[-1.7ex] \entry{\PValue{B}, \PValue{b}, \PValue{economy}, \PValue{Economy}, - \PValue{ECONOMY}, \PValue{B-ECONOMY}, \PValue{B-Economy}, + \PValue{ECONOMY}, \PValue{B-ECONOMY}, \PValue{B-Economy}, \PValue{b-economy}}{% Es wird die internationale Priorität B-Economy gesetzt. Bei - \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}% + \OptionValue{addrfield}{true} erfolgt dies anstelle der + Versandart.}\\[-1.7ex] \entry{\PValue{A}, \PValue{a}, \PValue{priority}, \PValue{Priority}, - \PValue{PRIORITY}, \PValue{A-PRIORITY}, \PValue{A-Priority}, + \PValue{PRIORITY}, \PValue{A-PRIORITY}, \PValue{A-Priority}, \PValue{a-priority}}{% Es wird die internationale Priorität A-Priority gesetzt. Bei \OptionValue{addrfield}{true} erfolgt dies anstelle der Versandart.}% @@ -1913,10 +2640,11 @@ Variablen \Variable{fromzipcode} und der Ort aus der Variablen \Variable{place} gesetzt. Dabei wird der Postleitzahl, also dem \PName{Inhalt} von \Variable{fromzipcode}, die \PName{Bezeichnung} der Variablen \Variable{fromzipcode}, gefolgt vom \PName{Inhalt} von -\Variable{zipcodeseparator} vorangestellt. Für diese \PName{Bezeichnung} hängt -die Voreinstellung von der verwendeten \File{lco}-Datei (siehe -\autoref{sec:\LabelBase.lcoFile} ab \autopageref{sec:\LabelBase.lcoFile}) -ab. Für den \PName{Inhalt} von \Variable{zipcodeseparator} ist hingegen +\Variable{zipcodeseparator} vorangestellt. Für diese +\PName{Bezeichnung}\textnote{Voreinstellung} hängt die Voreinstellung von der +verwendeten \File{lco}-Datei (siehe \autoref{sec:\LabelBase.lcoFile} ab +\autopageref{sec:\LabelBase.lcoFile}) ab. Für den \PName{Inhalt} von +\Variable{zipcodeseparator} ist hingegen % \iffalse % Umbruchvarianten ein kleiner Abstand, gefolgt von einem Streckenstrich, gefolgt von einem kleinen Abstand (\Macro{,}\texttt{-{}-}\Macro{,}) % @@ -1966,34 +2694,257 @@ obligatorischen Argument der \DescRef{\LabelBase.env.letter}-Umgebung ausgegeben. Die Anordnung des Port-Payé-Kopfes wird ebenso wie die Anordnung der -Port-Payé-Anschrift über die Pseudolängen \PLength{toaddrindent} (siehe -\DescPageRef{scrlttr2-experts.plength.toaddrindent}) sowie -\PLength{PPheadwidth} und \PLength{PPheadheight} (siehe -\DescPageRef{scrlttr2-experts.plength.PPheadheight}) bestimmt. Für die -Anordnung der Data-Matrix ist die Pseudolänge \PLength{PPdatamatrixvskip} -(siehe \DescPageRef{scrlttr2-experts.plength.PPdatamatrixvskip}) -zuständig. +Port-Payé-Anschrift über die Pseudolängen +\DescRef{\LabelBase.plength.toaddrindent} (siehe +\DescPageRef{\LabelBase.plength.toaddrindent}) sowie +\DescRef{\LabelBase.plength.PPheadwidth} und +\DescRef{\LabelBase.plength.PPheadheight} (siehe +\DescPageRef{\LabelBase.plength.PPheadheight}) bestimmt. Für die Anordnung der +Data-Matrix ist die Pseudolänge \DescRef{\LabelBase.plength.PPdatamatrixvskip} +(siehe \DescPageRef{\LabelBase.plength.PPdatamatrixvskip}) zuständig. Es\textnote{Achtung!} wird an dieser Stelle ausdrücklich darauf hingewiesen, -dass \KOMAScript{} selbst keine externen Abbildungen setzen kann, sollen also -über die Variablen \Variable{addresseeimage} oder \Variable{PPdatamatrix} -externe Abbildungen gesetzt werden, so ist beispielsweise das Grafikpaket -\Package{graphics}\IndexPackage{graphics} oder +dass \KOMAScript{} selbst keine externen Abbildungen setzen kann. % +\iffalse % Umbruchkorrektur +Verwenden Sie für solche Abbildungen beispielsweise das Paket +\Package{graphicx}\IndexPackage{graphicx} und dessen Anweisung +\Macro{includegraphics}.% +\else% +Sollen also über die Variablen \Variable{addresseeimage} oder +\Variable{PPdatamatrix} externe Abbildungen gesetzt werden, so ist +beispielsweise das Grafikpaket \Package{graphics}\IndexPackage{graphics} oder \Package{graphicx}\IndexPackage{graphicx} zu laden und in den Variablen dessen Anweisung \Macro{includegraphics} zu verwenden.% +\fi% +\EndIndexGroup + + +\begin{Declaration} + \PLength{toaddrvpos} + \PLength{toaddrhpos} +\end{Declaration} +Diese Pseudolängen geben den Abstand des Anschriftfensters eines +Fensterbriefumschlags vom oberen und vom linken Rand des Papiers an. Sie +werden in den vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +unterschiedlich eingestellt. Für \PLength{toaddrhpos} gilt außerdem eine +Besonderheit. Ist\textnote{Achtung!} der Wert \iffree{}{wie bei \Option{SN} + oder \Option{NF} }negativ, so ist sein Betrag der Abstand des +Anschriftfeldes vom rechten Rand des Papiers. % +\iffree{% + Sie\textnote{Beispiele!} 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.% +}{% + Große Briefköpfe\textnote{Achtung!} können bei kleinem \PLength{toaddrvpos}, + beispielsweise bei \Option{DINmtext}, bis in das Anschriftfeld ragen.% +} Ob das Anschriftfenster überhaupt gesetzt wird, hängt von der Option +\DescRef{\LabelBase.option.addrfield}\IndexOption{addrfield} ab (siehe +\DescPageRef{\LabelBase.option.addrfield}).% +\EndIndexGroup + + +\begin{Declaration} + \PLength{toaddrheight} +\end{Declaration} +Diese Pseudolänge gibt die Höhe des Anschriftfeldes einschließlich der +Versandart an. Ob Name und Adresse des Empfängers unter Berücksichtigung der +Versandart im Anschriftfeld vertikal zentriert werden, hängt von Option +\DescRef{\LabelBase.option.addrfield}\IndexOption{addrfield} ab.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{toaddrwidth} +\end{Declaration} +Diese Pseudolänge gibt die Breite des Anschriftfensters an. Sie wird in den +vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +entsprechend der unterschiedlichen Normen unterschiedlich +eingestellt. Typische Werte liegen zwischen 70\Unit{mm} und 100\Unit{mm}. + +\begin{Example} + Angenommen, Sie haben das Problem, dass Ihr Drucker einen \iffree{sehr + breiten }{}unbedruckbaren rechten \iffree{oder linken }{}Rand von + 15\Unit{mm} besitzt. Dadurch kann bei Option \Option{SN} der Briefkopf, die + Absenderergänzung und die Anschrift nicht komplett gedruckt werden. Sie + erstellen daher eine neue \iffree{\File{lco}-Datei mit folgendem Inhalt}{Datei + \File{SNmmarg.lco}, die Sie anstelle von \Option{SN} verwenden}: +\begin{lstcode} + \ProvidesFile{SNmmarg.lco} + [2002/06/04 v0.1 my own lco] + \LoadLetterOption{SN} + \addtoplength{toaddrwidth}{% + -\useplength{toaddrhpos}} + \setplength{toaddrhpos}{-15mm} + \addtoplength{toaddrwidth}{% + \useplength{toaddrhpos}} + \endinput +\end{lstcode}% + \iffree{ Bis Sie sich einen Drucker mit kleineren Rändern zugelegt haben, + verwenden Sie \Option{SNmmarg} anstelle von + \Option{SN}.}{}% Umbruchoptimierung +\end{Example} +% +\EndIndexGroup +\ExampleEndFix + + +\begin{Declaration} + \PLength{toaddrindent} +\end{Declaration} +Manchmal will man, dass die Anschrift nicht am linken Rand des +Anschriftfensters beginnt und bis zum rechten Rand des Fensters reicht, +sondern ein wenig eingezogen wird. Der Wert dieses Einzugs kann über die +Pseudolänge \PLength{toaddrindent} festgelegt +werden. Typischerweise\textnote{Voreinstellung} ist dieser Wert jedoch +0\Unit{pt}. + +Bei\textnote{Achtung!} jeder der +Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}} +\OptionValueRef{scrlttr2}{addrfield}{PP}\important{% + \OptionValueRef{scrlttr2}{addrfield}{PP}\\ + \OptionValueRef{scrlttr2}{addrfield}{image}\\ + \OptionValueRef{scrlttr2}{addrfield}{backgroundimage} +}\IndexOption{addrfield~=\textKValue{PP}}, +\OptionValueRef{scrlttr2}{addrfield}{image}% +\IndexOption{addrfield~=\textKValue{image}} und +\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}% +\IndexOption{addrfield~=\textKValue{backgroundimage}} (siehe +\DescPageRef{\LabelBase.option.addrfield}) wird beim Wert 0\Unit{pt} +stattdessen ein Einzug von 8\Unit{mm} verwendet. Soll hier tatsächlich kein +Einzug verwendet werden, so kann mit 1\Unit{sp} ein vernachlässigbar kleiner +Einzug gesetzt werden. Des Weiteren wird \PLength{toaddrindent} bei den +genannten Einstellungen für +\DescRef{\LabelBase.option.addrfield}\IndexOption{addrfield} auch für den +Abstand zum rechten Rand des Anschriftfensters verwendet.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{backaddrheight} +\end{Declaration} +Bei Fensterbriefumschlägen wird der Absender häufig in einer kleinen Schrift +einzeilig über der Empfängeradresse ausgegeben. Diese Absenderangabe nennt man +Rücksendeadresse\textnote{Rücksendeadresse}% +\Index{Ruecksendeadresse=Rücksendeadresse}, da sie \iffree{im Anschriftfenster + sichtbar ist und }{}der Post bei unzustellbaren Briefen für die Rücksendung +an den Absender dient. In dieser Adresse muss daher auch nur die Information +enthalten sein, die zur Rücksendung notwendig ist. + +Die Höhe, die innerhalb des Anschriftfensters für die Rücksendeadresse zur +Verfügung steht, ist in der Pseudolänge \PLength{backaddrheight} abgelegt. Der +Wert\textnote{Voreinstellung} wird in den vordefinierten \File{lco}-Dateien +typischerweise auf 5\Unit{mm} eingestellt. Ob die Rücksendeadresse überhaupt +gesetzt wird, bestimmt der Anwender mit den Optionen +\DescRef{\LabelBase.option.addrfield}\IndexOption{addrfield} (siehe +\DescPageRef{\LabelBase.option.addrfield}) und +\DescRef{\LabelBase.option.backaddress} (siehe +\DescPageRef{\LabelBase.option.backaddress}).% +\iftrue% Umbruchkorrektur +\ Ein Abschalten der Rücksendeadresse ist beispielsweise sinnvoll, wenn gar +keine Fensterbriefumschläge verwendet werden.% +\fi% +\EndIndexGroup + + +\begin{Declaration} + \PLength{specialmailindent} + \PLength{specialmailrightindent} +\end{Declaration} +Zwischen Rücksendeadresse und Empfängeradresse kann noch eine optionale +Versandart\Index{Versandart} gesetzt werden\iffree{. Diese wird genau dann + gesetzt}{}, wenn die Variable \DescRef{\LabelBase.variable.specialmail} +einen Inhalt hat. Die Ausrichtung wird mit Hilfe der Pseudolängen +\PLength{specialmailindent} und \PLength{specialmailrightindent} +festgelegt. Diese geben den linken und rechten Einzug der Zeile an. In den +vordefinierten\textnote{Voreinstellung} \File{lco}-Dateien ist +\PLength{specialmailindent} auf den dehnbaren Wert \Macro{fill} gesetzt, +während \PLength{specialmailrightindent} auf 1\Unit{em} eingestellt ist. Damit +wird die Versandart 1\Unit{em} vom rechten Rand des Anschriftfensters +gesetzt.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{PPheadheight} + \PLength{PPheadwidth} +\end{Declaration} +Die Pseudolänge \PLength{PPheadheight} gibt bei den beiden +Einstellungen\ChangedAt{v3.03}{\Class{scrlttr2}} +\OptionValueRef{scrlttr2}{addrfield}{PP}\important{% + \OptionValueRef{scrlttr2}{addrfield}{PP}\\ + \OptionValueRef{scrlttr2}{addrfield}{backgroundimage}}% +\IndexOption{addrfield~=\textKValue{PP}} und +\OptionValueRef{scrlttr2}{addrfield}{backgroundimage}% +\IndexOption{addrfield~=\textKValue{backgroundimage}} die Höhe an, die am +Anfang des Adressfeldes für den Port-Payé-Kopf reserviert wird. Die +Pseudolänge \PLength{PPheadwidth} wird nur bei +\OptionValueRef{scrlttr2}{addrfield}{PP} (siehe +\DescPageRef{\LabelBase.option.addrfield}) verwendet und gibt die Breite des +linken Feldes des Port-Payé-Kopf mit dem P.\,P.-Logo, der Postleitzahl und dem +Ort an. Die Breite des rechten Feldes mit dem Code für den Absender und der +Priorität ist durch die Restbreite bestimmt. + +Den\textnote{Achtung!\\Voreinstellung} normalerweise voreingestellten Wert von +0\Unit{mm} für Pseudolänge \PLength{PPheadheight} ändert \KOMAScript{} +selbstständig in 20,74\Unit{pt}. Den normalerweise voreingestellten Wert von +0\Unit{mm} für \PLength{PPheadwidth} ändert \KOMAScript{} selbstständig in +42\Unit{mm}.% +% \EndIndexGroup \begin{Declaration} + \PLength{PPdatamatrixvskip} +\end{Declaration} +Durch\ChangedAt{v3.03}{\Class{scrlttr2}} diese Pseudolänge wird der vertikale +Abstand zwischen dem Port-Payé-Kopf und der Data-Matrix bei +\OptionValueRef{scrlttr2}{addrfield}{PP}% +\important{\OptionValueRef{scrlttr2}{addrfield}{PP}}% +\IndexOption{addrfield~=\textKValue{PP}} (siehe +\DescPageRef{\LabelBase.option.addrfield}) +festgelegt. Den\textnote{Achtung!\\Voreinstellung} normalerweise +voreingestellten Wert von 0\Unit{mm} ändert \KOMAScript{} selbstständig in +9\Unit{mm}. Die Data-Matrix wird rechtsbündig zum Port-Payé-Kopf gesetzt.% +\EndIndexGroup +% +\EndIndexGroup + + +\subsection{Absenderergänzung} +\seclabel{locationField} +\BeginIndexGroup +\BeginIndex{}{Absenderergaenzung=Absenderergänzung}% + +\iffalse% Umbruchvarianten +Insbesondere bei Geschäftsbriefen reicht der Platz im Briefkopf und im +Seitenfuß oftmals nicht aus, um alle Angaben des Absenders unterzubringen. Für +die zusätzlichen Informationen kann der Platz neben der Anschrift +genutzt werden. In dieser Anleitung wird dieses Feld \emph{Absenderergänzung} +genannt.% +\else% +\iffalse% +Reicht der Raum in Briefkopf und Seitenfuß nicht aus, um alle Angaben zum +Absender unterzubringen, kann der Platz neben der Anschrift als +\emph{Absenderergänzung} genutzt werden.% +\else% +Der freie Platz neben der Anschrift kann für zusätzliche Angaben zum Absender +genutzt werden.% +\fi% +\fi + +\begin{Declaration} \OptionVName{locfield}{Einstellung} \end{Declaration} \BeginIndex{}{Absenderergaenzung=Absenderergänzung}% -Neben dem Anschriftfeld setzt \Class{scrlttr2} noch ein Feld mit erweiterter -Absenderangabe. Der Inhalt ist frei wählbar. Je\important{% +Der Inhalt der Absenderergänzung neben der Anschrift ist frei wählbar. +Je\important{% \OptionValueRef{\LabelBase}{fromalign}{locationleft}\\ \OptionValueRef{\LabelBase}{fromalign}{center}\\ \OptionValueRef{\LabelBase}{fromalign}{locationright}} nach Einstellung der -oben erklärten Option \DescRef{\LabelBase.option.fromalign} wird es außerdem +oben erklärten Option \DescRef{\LabelBase.option.fromalign} wird sie außerdem für das Logo des Absenders oder den Absender selbst mitverwendet. Die Breite dieses Feldes kann beispielsweise in einer \File{lco}-Datei (siehe \autoref{sec:\LabelBase.lcoFile}) gesetzt werden. Wird dort die Breite 0 @@ -2001,8 +2952,8 @@ gesetzt, so kann über die Option \Option{locfield} zwischen zwei unterschiedlichen Voreinstellungen für die Breite dieses Feldes gewählt werden. Dies ist bei der Mehrzahl der \File{lco}-Dateien der Fall, die \KOMAScript{} beiliegen. Siehe hierzu auch die Erklärungen zur Pseudolänge -\PLength{locwidth} in \autoref{sec:scrlttr2-experts.locationField}, -\DescPageRef{scrlttr2-experts.plength.locwidth}. Mögliche Werte für die Option +\DescRef{\LabelBase.plength.locwidth}, +\DescPageRef{\LabelBase.plength.locwidth}. Mögliche Werte für die Option sind \autoref{tab:\LabelBase.locfield} zu entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}. % @@ -2011,28 +2962,28 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{narrow}. \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% \begin{captionbeside} - [{Mögliche Werte für Option \Option{locfield} bei - \Class{scrlttr2}}] + [{Mögliche Werte für Option \Option{locfield}}] {Mögliche Werte für Option \Option{locfield} zur Wahl der Breite des - Feldes für die Absenderergänzung bei \Class{scrlttr2}% + Feldes für die Absenderergänzung (Erklärung im Text beachten!)% \label{tab:\LabelBase.locfield}}% [l] - \begin{minipage}[t]{.55\linewidth} + \begin{minipage}[t]{.58\linewidth} \begin{desctabular}[t] - \pventry{narrow}{schmales Feld für Absenderergänzungen}% - \pventry{wide}{breites Feld für Absenderergänzungen}% + \pventry{narrow}{schmales Feld für die Absenderergänzung}% + \pventry{wide}{breites Feld für die Absenderergänzung}% \end{desctabular} \end{minipage} \end{captionbeside} \end{table} + \begin{Declaration} \Variable{location} \end{Declaration} Der Inhalt der Absenderergänzung, soweit er nicht durch Logo oder den Absender selbst belegt ist, wird mit der Variablen \Variable{location} festgelegt. Für -den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen, wie -\Macro{raggedright}, verwendet werden. Die \PName{Bezeichnung} dieser Variablen +den \PName{Inhalt} dieser Variablen dürfen auch Formatierungsanweisungen wie +\Macro{raggedright} verwendet werden. Die \PName{Bezeichnung} dieser Variablen wird von \KOMAScript{} nicht genutzt. \begin{Example} @@ -2058,19 +3009,74 @@ wird von \KOMAScript{} nicht genutzt. % \EndIndexGroup \EndIndexGroup +\ExampleEndFix % Beispiel am Ende der Beschreibung \begin{Declaration} + \PLength{locheight} + \PLength{lochpos} + \PLength{locvpos} + \PLength{locwidth} +\end{Declaration} +Die Pseudolängen \PLength{locwidth} und +\PLength{locheight}\ChangedAt{v2.97d}{\Class{scrlttr2}} geben die Breite und +Höhe der Absenderergänzung an. Die Pseudolängen \PLength{lochpos} und +\PLength{locvpos} geben die Abstände von der rechten, oberen +Papierecke an. Die Werte werden in den vordefinierten \File{lco}-Dateien +typischerweise auf 0\Unit{pt} gesetzt. Dieser\textnote{Achtung!} Wert nimmt +eine Sonderstellung ein. Er bedeutet, dass die Werte erst bei +\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} anhand der Breite des +Papiers, der Breite des Anschriftfensters, des Abstandes des +Anschriftfensters von der linken, oberen Papierecke und +Option \DescRef{\LabelBase.option.locfield} (siehe +\DescPageRef{\LabelBase.option.locfield}) +gesetzt werden. Wie\textnote{Achtung!} bei \PLength{toaddrhpos} nehmen +negative Werte für \PLength{lochpos} eine Sonderstellung ein. Es wird dann +statt des Abstandes vom rechten Papierrand der Betrag von \PLength{lochpos} +als Abstand vom linken Papierrand verwendet. Die Bedeutung ist also genau +umgekehrt zu der bei \PLength{toaddrhpos} (siehe +\DescPageRef{\LabelBase.plength.toaddrhpos}).% +\EndIndexGroup +% +\EndIndexGroup + + +\subsection{Geschäftszeilen} +\seclabel{refLine}% +\BeginIndexGroup +\BeginIndex{}{Geschaeftszeile=Geschäftszeile}% + +\iftrue % Umbruchkorrektur +Die Geschäftszeilen enthalten typischerweise Angaben wie Namenskürzel oder +Durchwahlnummern. \KOMAScript{} setzt automatisch nur nicht leere Felder. Ist +nur das Datum nicht leer, wird die Geschäftzeile zur Datumszeile. +\else% +Die Geschäftszeile kann auch länger als eine Zeile sein. Sie wird nur gesetzt, +wenn mindestens eine der Variablen für die Geschäftszeile nicht leer ist. Es +werden nur nicht leere Felder gesetzt. Um\textnote{Tipp!} ein scheinbar leeres +Feld zu setzen, kann man einen scheinbar leeren Variableninhalt wie +\Macro{mbox}\Parameter{} verwenden. Wird auf die Geschäftszeile verzichtet, so +werden an ihrer Stelle Bezeichnung und Inhalt der Variablen +\DescRef{\LabelBase.variable.date} ausgegeben. % +\iffalse% Umbruchoptimierung +Informationen, wie Variablen zur Geschäftszeile hinzugefügt oder entfernt +werden, sind in \autoref{sec:scrlttr2-experts.variables}, +\DescPageRef{scrlttr2-experts.cmd.removereffields} zu finden.% +\fi% +\fi + +\begin{Declaration} \OptionVName{numericaldate}{Ein-Aus-Wert} \end{Declaration} Mit dieser Option kann zwischen der sprachabhängigen Standarddarstellung des -Datums\Index{Datum}\Index{Geschaeftszeile=Geschäftszeile} und einem ebenfalls -sprachabhängigen, kurzen, rein nummerischen Datum umgeschaltet werden. Die +Datums\Index{Datum} in +\Macro{today}\IndexCmd[indexmain]{today}\important{\Macro{today}} und einem +ebenfalls sprachabhängigen rein numerischen Datum umgeschaltet werden. Die Standarddarstellung wird nicht von \KOMAScript{} bereitgestellt. Sie kann -wahlweise von einem Paket wie \Package{ngerman}\IndexPackage{ngerman}, -\Package{babel}\IndexPackage{babel} oder auch +wahlweise vom \LaTeX-Kern oder einem Paket wie +\Package{babel}\IndexPackage{babel} oder \Package{isodate}\IndexPackage{isodate} -stammen. Das\important{\OptionValue{numericaldate}{true}} kurze nummerische +stammen. Das\important{\OptionValue{numericaldate}{true}} kurze numerische Datum wird hingegen von \Class{scrlttr2} selbst erzeugt. Die Option versteht die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben @@ -2080,12 +3086,19 @@ Verwendung der Standarddarstellung. \begin{Declaration} \Variable{date} \end{Declaration} -Das Datum in der gewählten Darstellung wird im \PName{Inhalt} der Variablen -\Variable{date} abgelegt. Die Einstellung von -\DescRef{\LabelBase.option.numericaldate}% -\important{\DescRef{\LabelBase.option.numericaldate}} hat keine Auswirkung, -wenn diese Variable überschrieben wird. Gesetzt wird das Datum normalerweise -als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten leer bleibt +Das Datum \iffalse % Umbruchkorektur (stimmt das so?) +in der gewählten Darstellung % +\fi % +wird im \PName{Inhalt} der Variablen \Variable{date} +abgelegt. Voreingestellt\textnote{Voreinstellung} ist das mit +\Macro{date}\IndexCmd{date} gesetzte Datum, das selbst mit +\Macro{today}\important{\Macro{date}, \Macro{today}}\IndexCmd{today} +voreingestellt ist. Damit ist der \PName{Inhalt} der Variablen nur indirekt +von Option \DescRef{\LabelBase.option.numericaldate}% +\important{\DescRef{\LabelBase.option.numericaldate}} abhängig. + +Gesetzt wird das Datum normalerweise +als Teil der Geschäftszeile. Wenn die Geschäftszeile ansonsten leer bleibt, wird allerdings nur eine Datumszeile, bestehend aus dem Ort und dem Datum, gesetzt. Trotzdem haben auch in diesem Fall die Einstellungen der nachfolgend beschriebenen Option \DescRef{\LabelBase.option.refline} Auswirkungen auf @@ -2102,26 +3115,29 @@ Beschreibung zur Variablen \OptionVName{refline}{Einstellung} \end{Declaration} \BeginIndex{}{Geschaeftszeile=Geschäftszeile}% +\iffalse% Überflüssig Insbesondere bei Geschäftsbriefen findet sich häufig eine Zeile mit Angaben wie Namenskürzeln\Index{Kuerzel=Kürzel}, Durchwahl\Index{Durchwahl}, Kunden-\Index{Kundennummer} und Rechnungsnummer\Index{Rechnungsnummer} oder zur Bezugnahme auf ein früheres Schreiben. Diese Zeile wird in dieser Anleitung \emph{Geschäftszeile}\textnote{Geschäftszeile} genannt. +\fi% Bei \Class{scrlttr2} und \Package{scrletter} können Kopf, Fuß, Anschrift und das Feld mit der Absenderergänzung links und rechts aus dem normalen Satzspiegel herausragen. Über \OptionValue{refline}{wide}\important{\OptionValue{refline}{wide}} kann -gewählt werden, dass dies auch für die Geschäftszeile gelten soll. Die -Geschäftszeile enthält normalerweise zumindest das Datum, kann aber auch -weitere Angaben aufnehmen. Mögliche Werte für diese Option sind -\autoref{tab:\LabelBase.refline} zu +gewählt werden, dass dies auch für die Geschäftszeile gelten soll. % +\iffalse% Hier überflüssig +Die Geschäftszeile enthält normalerweise zumindest das Datum, kann aber auch +weitere Angaben aufnehmen. % +\fi% +Mögliche Werte für diese Option sind \autoref{tab:\LabelBase.refline} zu entnehmen. Voreingestellt\textnote{Voreinstellung} sind \PValue{narrow} und \PValue{dateright}\ChangedAt{v3.09}{\Class{scrlttr2}}.% % \begin{table} - \caption[{Mögliche Werte für Option \Option{refline} bei - \Class{scrlttr2} und \Package{scrletter}}] + \caption[{Mögliche Werte für Option \Option{refline}}] {Mögliche Werte für Option \Option{refline} zur Konfiguration der Geschäftszeile} \label{tab:\LabelBase.refline} @@ -2139,6 +3155,7 @@ entnehmen. Voreingestellt\textnote{Voreinstellung} sind \PValue{narrow} und \end{desctabular} \end{table} + \begin{Declaration} \Variable{yourref} \Variable{yourmail} @@ -2230,53 +3247,68 @@ verwendet. Die Voreinstellungen der \iffree{beiden }{}Elemente sind \end{Declaration}% Sind bis auf \DescRef{\LabelBase.variable.date}% \important{\DescRef{\LabelBase.variable.date}}\IndexVariable{date} alle -Variablen der Geschäftszeile leer, so wird keine eigentliche Geschäftszeile -gesetzt. Stattdessen werden dann nur Ort\Index{Ort} und Datum\Index{Datum} -ausgegeben. Dabei bestimmt der \PName{Inhalt} der Variablen -\DescRef{\LabelBase.variable.place} den Ort. Für das Trennzeichen, das in -diesem Fall nach dem Ort gesetzt wird, ist der \PName{Inhalt} der Variablen -\Variable{placeseparator} zuständig. Der +Variablen der Geschäftszeile leer, so wird keine echte Geschäftszeile +gesetzt. Stattdessen\textnote{Datumszeile} werden dann nur Ort\Index{Ort} und +Datum\Index{Datum} ausgegeben. Dabei bestimmt der \PName{Inhalt} der Variablen +\DescRef{\LabelBase.variable.place}\IndexVariable{place}% +\important{\DescRef{\LabelBase.variable.place}} den Ort. Für das Trennzeichen, +das in diesem Fall nach dem Ort gesetzt wird, ist der \PName{Inhalt} der +Variablen \Variable{placeseparator} zuständig. Der vordefinierte\textnote{Voreinstellung} \PName{Inhalt} des Trennzeichens ist dabei ein Komma, gefolgt von einem nicht umbrechbaren Leerzeichen. Ist der Ort -leer, so wird auch das Trennzeichen nicht gesetzt. Der vordefinierte -\PName{Inhalt} der Variablen \DescRef{\LabelBase.variable.date} ist -\Macro{today}\IndexCmd{today}\important{\Macro{today}} und hängt von der -Einstellung der Option \DescRef{\LabelBase.option.numericaldate}% +leer, so wird auch das Trennzeichen nicht gesetzt.% +\iffalse % Umbruchkorrektur +\ Der vordefinierte \PName{Inhalt} der Variablen +\DescRef{\LabelBase.variable.date} ist +\Macro{today}\IndexCmd{today}\important{\Macro{today}} und hängt indirekt von +der Einstellung der Option \DescRef{\LabelBase.option.numericaldate}% \important{\DescRef{\LabelBase.option.numericaldate}}% \IndexOption{numericaldate} ab (siehe -\DescPageRef{\LabelBase.option.numericaldate}). - -Seit Version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} werden Ort und Datum -nicht mehr zwingend rechtsbündig ausgegeben. Stattdessen findet auch im Falle -der Datumszeile die Datumseinstellung von Option -\DescRef{\LabelBase.option.refline}\IndexOption{refline}% -\important{\DescRef{\LabelBase.option.refline}}, wie sie in -\autoref{tab:\LabelBase.refline} angegeben ist, Anwendung. +\DescPageRef{\LabelBase.option.numericaldate}).% +\fi % \BeginIndexGroup \BeginIndex{FontElement}{placeanddate}\LabelFontElement{placeanddate}% -Falls\ChangedAt{v3.12}{\Class{scrlttr2}} statt der Geschäftszeile eine solche -Datumszeile mit Ort gesetzt wird, so findet nicht die Schrifteinstellung des -Elements \DescRef{\LabelBase.fontelement.refvalue} Anwendung. Stattdessen wird -in diesem Fall das Element -\FontElement{placeanddate}\important{\FontElement{placeanddate}} verwendet, -dessen leere Voreinstellung wie gewohnt mit Hilfe der Anweisungen +Für\ChangedAt{v3.12}{\Class{scrlttr2}} eine solche Datumszeile mit Ort findet +nicht die Schrifteinstellung des Elements +\DescRef{\LabelBase.fontelement.refvalue} Anwendung. Stattdessen wird das +Element \FontElement{placeanddate}\important{\FontElement{placeanddate}} +verwendet, dessen leere Voreinstellung mit Hilfe der Anweisungen \DescRef{\LabelBase.cmd.setkomafont} und \DescRef{\LabelBase.cmd.addtokomafont} (siehe \autoref{sec:\LabelBase.textmarkup}, \DescPageRef{\LabelBase.cmd.setkomafont}) geändert werden kann.% \EndIndexGroup +\iffalse% Umbruchkorrektur +Seit Version~3.09\ChangedAt{v3.09}{\Class{scrlttr2}} werden Ort und Datum +nicht mehr zwingend rechtsbündig ausgegeben. Stattdessen findet auch im Falle +der Datumszeile die Datumseinstellung von Option +\DescRef{\LabelBase.option.refline}\IndexOption{refline}% +\important{\DescRef{\LabelBase.option.refline}}, wie sie in +\autoref{tab:\LabelBase.refline} angegeben ist, Anwendung.% +\else% +Die in \autoref{tab:\LabelBase.refline} angegebenen Datumseinstellungen +\iffree{für \DescRef{\LabelBase.option.refline}\IndexOption{refline}% + \important{\DescRef{\LabelBase.option.refline}} }{}% Umbruchkorrektur +werden auch von der Datumszeile +beachtet. Voreingestellt\textnote{Voreinstellung} ist rechtsbündig.% +\fi + \begin{Example} Herr Musterfrau setzt nun auch die Variable für den Ort: \lstinputcode[xleftmargin=1em]{letter-20.tex}% - Damit erscheint vor dem Datum, wie in \autoref{fig:\LabelBase.letter-20}, - \autopageref{fig:\LabelBase.letter-20} zu sehen, der Ort, gefolgt von den - automatischen Trennzeichen vor dem Datum. Dieses Datum wurde im Beispielcode - über Variable \DescRef{\LabelBase.variable.date} ebenfalls explizit gesetzt, - damit bei einem späteren \LaTeX-Durchlauf des Briefes das ursprüngliche - Datum erhalten bleibt und nicht etwa automatisch das Datum des \LaTeX-Laufs - verwendet wird. + \iffalse% Umbruchkorrektur + Damit erscheint vor dem Datum, wie in \autoref{fig:\LabelBase.letter-20} zu + sehen, % + \else% + In \autoref{fig:\LabelBase.letter-20} erscheint damit % + \fi % + der Ort, gefolgt von den automatischen Trennzeichen vor dem Datum. Dieses + Datum wurde im Beispielcode über Variable \DescRef{\LabelBase.variable.date} + explizit gesetzt, damit bei einem späteren \LaTeX-Durchlauf des Briefes das + ursprüngliche Datum erhalten bleibt und nicht automatisch das Datum des + \LaTeX-Laufs verwendet wird. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, @@ -2290,13 +3322,109 @@ geändert werden kann.% \end{captionbeside} \label{fig:\LabelBase.letter-20} \end{figure} -\end{Example} -% +\end{Example}% +\EndIndexGroup +\EndIndexGroup \EndIndexGroup +\ExampleEndFix% Beispiel am Ende der Beschreibung + + +\begin{Declaration} + \PLength{refvpos} +\end{Declaration} +Diese Pseudolänge gibt den Abstand der Geschäftszeile von der Oberkante des +Papiers an. Ihr Wert wird in den vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +unterschiedlich eingestellt. % +\iffalse% +Typische Werte liegen zwischen 80{,}5\Unit{mm} und 98{,}5\Unit{mm}.% +\fi% +\EndIndexGroup + + +\begin{Declaration} + \PLength{refwidth} + \PLength{refhpos} +\end{Declaration} +Die Pseudolänge \PLength{refwidth} gibt die Breite an, die für die +Geschäftszeile zur Verfügung steht. Ihr Wert wird in den vordefinierten +\File{lco}-Dateien typischerweise auf 0\Unit{pt} +gesetzt. Dieser\textnote{Achtung!} Wert hat eine besondere Bedeutung. % +\iffalse% Umbruchoptimierung +Es wird damit keineswegs festgelegt, dass für die Geschäftszeile keine Breite +zur Verfügung steht. Vielmehr bedeutet der Wert% +\else% +Damit wird festgelegt% +\fi% +, dass die verfügbare Breite erst innerhalb von +\DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} ermittelt wird. Die% +\iffalse% Umbruchoptimierung +\ dort ermittelte % +\else% +se % +\fi% +Breite richtet sich \iffree{dann }{}nach der Einstellung der Option +\DescRef{\LabelBase.option.refline}\important{\DescRef{\LabelBase.option.refline}}% +\IndexOption{refline~=\PName{Einstellung}} (siehe +\DescPageRef{\LabelBase.option.refline}). Gleichzeitig wird +\PLength{refhpos} entsprechend der Option gesetzt. Bei +\OptionValueRef{scrlttr2}{refline}{wide}% +\IndexOption{refline~=\textKValue{wide}} wird die Geschäftszeile zentriert, +wohingegen sie bei \OptionValueRef{scrlttr2}{refline}{narrow}% +\IndexOption{refline~=\textKValue{narrow}} am Satzspiegel links ausgerichtet +wird. + +Ist \PLength{refwidth} von Null verschieden, wird die Breite der +Geschäftszeile nicht von der Option \DescRef{\LabelBase.option.refline} +bestimmt, sondern \PLength{refhpos} ist der Abstand der Geschäftszeile von der +linken Papierkante. Ist\textnote{Achtung!} dieser Abstand Null, so wird die +Geschäftszeile so ausgerichtet, dass das Verhältnis zwischen ihrem Abstand von +der linken Papierkante zu ihrem Abstand von der rechten Papierkante dem +Verhältnis zwischen den Abständen des Satzspiegels von der linken und rechten +Papierkante entspricht. Bei auf dem Papier horizontal zentriertem Satzspiegel +wird also auch die Geschäftszeile zentriert. + +In der Regel werden diese Sonderfälle für die % +\iffalse% Umbruchkorrektur +häufigsten Anwendungen % +\else % +meisten Anwender % +\fi % +von geringem Interesse sein. Die\textnote{Tipp!} einfachste Regel lautet hier: +Entweder wird \PLength{refwidth} auf Null belassen und die Breite und +Ausrichtung der Geschäftszeile über die Option +\DescRef{\LabelBase.option.refline} bestimmt oder sowohl \PLength{refwidth} als +auch \PLength{refhpos} werden vom Anwender vorgegeben.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{refaftervskip} +\end{Declaration} +Diese Pseudolänge gibt den vertikalen Abstand an, der nach der Geschäftszeile +eingefügt werden soll. Der Wert wird in den vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +eingestellt. Er wirkt sich unmittelbar auf die Höhe des Textbereichs der +ersten Seite aus.% +\iffalse % Umbruchkorrektur +\ Der typische Wert liegt zwischen einer und zwei Zeilen.% +\fi % \EndIndexGroup +% \EndIndexGroup +\subsection{Titel und Betreff} +\seclabel{subject}% +\BeginIndexGroup +\BeginIndex{}{Betreff} + +Der Betreff eine Briefes wird in unterschiedlichen Ländern unterschiedlich +gesetzt. Die einen haben ihn gerne vor der Anrede, die anderen setzen ihn +danach. Einige Berufsgruppen wollen ihn teilweise sogar vor der Geschäftszeile +haben. + + \begin{Declaration} \Variable{title} \end{Declaration} @@ -2355,7 +3483,20 @@ werden soll oder nicht. Der Titel wird über die Bezeichnung der Variablen \Variable{subject} bestimmt (siehe \autoref{tab:\LabelBase.subjectTerm}). Der\textnote{Voreinstellung} vordefinierte Inhalt des Trennzeichens\Index{Trennzeichen} \Variable{subjectseparator} besteht aus -einem Doppelpunkt, gefolgt von einem Leerzeichen. +einem Doppelpunkt, gefolgt von einem Leerzeichen. Zum% +\important{\OptionValue{subject}{afteropening}\\ + \OptionValue{subject}{beforeopening}} +anderen kann über +\OptionValue{subject}{afteropening} +gewählt werden, dass der Betreff +abweichend von der Voreinstellung \OptionValue{subject}{beforeopening} erst +nach der Anrede gesetzt werden soll. Eine% +\important{\OptionValue{subject}{underlined}\\ + \OptionValue{subject}{centered}\\ + \OptionValue{subject}{right}} andere Formatierung kann mit +\OptionValue{subject}{underlined} und \OptionValue{subject}{centered} oder +\OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}} eingestellt +werden. \begin{table} % \centering @@ -2382,48 +3523,40 @@ einem Doppelpunkt, gefolgt von einem Leerzeichen. \label{tab:\LabelBase.subjectTerm} \end{table} -Zum anderen kann über \OptionValue{subject}{afteropening}% -\important{\OptionValue{subject}{afteropening}\\ - \OptionValue{subject}{beforeopening}} gewählt werden, dass der Betreff -abweichend von der Voreinstellung -\OptionValue{subject}{beforeopening} erst nach der Anrede gesetzt werden -soll. Eine andere Formatierung% -\important{\OptionValue{subject}{underlined}\\ - \OptionValue{subject}{centered}\\ - \OptionValue{subject}{right}} kann mit \OptionValue{subject}{underlined} und -\OptionValue{subject}{centered} oder -\OptionValue{subject}{right}\ChangedAt{v2.97c}{\Class{scrlttr2}} eingestellt -werden. Mögliche Werte für Option \Option{subject} sind -\autoref{tab:\LabelBase.subject} zu entnehmen. Es\textnote{Achtung!} wird -ausdrücklich darauf hingewiesen, dass bei der Einstellung -\OptionValue{subject}{underlined} der Betreff komplett in eine Zeile passen -muss! Voreingestellt\textnote{Voreinstellung} sind -\OptionValue{subject}{left}, \OptionValue{subject}{beforeopening} und -\OptionValue{subject}{untitled}.% -% +Mögliche Werte für Option \Option{subject} sind +\autoref{tab:\LabelBase.subject} zu entnehmen. % +\iffalse% Umbruchkorrektur +Es wird ausdrücklich\textnote{Achtung!} darauf hingewiesen, dass bei der +Einstellung \OptionValue{subject}{underlined} der Betreff komplett in eine +Zeile passen muss!% +\else% +Es wird\textnote{Achtung!} darauf hingewiesen, dass bei Einstellung +\OptionValue{subject}{underlined} der Betreff in eine Zeile passen muss!% +\fi% \begin{table} % \centering \KOMAoptions{captions=topbeside}% \setcapindent{0pt}% % \caption \begin{captionbeside} - [{Mögliche Werte für Option \Option{subject} bei \Class{scrlttr2}}] + [{Mögliche Werte für Option \Option{subject}}] {\hspace{0pt plus 1ex}% Mögliche Werte für Option \Option{subject} zur Platzierung und - Formatierung eines Betreffs bei \Class{scrlttr2}% + Formatierung eines Betreffs% \label{tab:\LabelBase.subject}} [l] \begin{minipage}[t]{.667\linewidth} \begin{desctabular}[t] - \pventry{afteropening}{Betreff nach der Anrede setzen}% - \pventry{beforeopening}{Betreff vor der Anrede setzen}% - \pventry{centered}{Betreff zentrieren}% - \pventry{left}{Betreff linksbündig setzen}% - \pventry{right}{Betreff rechtsbündig setzen}% - \pventry{titled}{Betreff mit Titel versehen}% - \pventry{underlined}{Betreff unterstreichen (Hinweis im - Text beachten!)}% - \pventry{untitled}{Betreff nicht mit Titel versehen}% + \pventry{afteropening}{Betreff nach der Anrede setzen.}\\[-1.7ex] + \pventry{beforeopening}{Betreff vor der Anrede setzen + (Voreinstellung).}\\[-1.7ex] + \pventry{centered}{Betreff zentrieren.}\\[-1.7ex] + \pventry{left}{Betreff linksbündig setzen (Voreinstellung).}\\[-1.7ex] + \pventry{right}{Betreff rechtsbündig setzen.}\\[-1.7ex] + \pventry{titled}{Betreff mit Titel versehen.}\\[-1.7ex] + \pventry{underlined}{Betreff unterstreichen. (Hinweis im Text + beachten!)}\\[-1.7ex] + \pventry{untitled}{Betreff nicht mit Titel versehen (Voreinstellung).}% \end{desctabular} \end{minipage} \end{captionbeside} @@ -2451,10 +3584,17 @@ existiert. \EndIndexGroup \begin{Example} - Herr Musterfrau setzt nun auch den Betreff. Als eher traditioneller - veranlagter Mensch möchte er außerdem, dass der Betreff mit einer - entsprechenden Spitzmarke versehen wird, und setzt deshalb auch die - zugehörige Option:% + Herr Musterfrau setzt nun auch den Betreff. % + \iftrue % Umbruchkorrektur + Als eher traditioneller veranlagter Mensch möchte er % + \else % + Er möchte % + \fi % + außerdem, dass der Betreff mit einer % + \iftrue % Umbruchkorrektur + entsprechenden % + \fi % + Spitzmarke versehen wird, und setzt deshalb auch die zugehörige Option:% \lstinputcode[xleftmargin=1em]{letter-21.tex}% Das Ergebnis ist in \autoref{fig:\LabelBase.letter-21} zu sehen. \begin{figure} @@ -2471,20 +3611,245 @@ existiert. \label{fig:\LabelBase.letter-21} \end{figure} \end{Example} +Voreingestellt\textnote{Voreinstellung} sind +\OptionValue{subject}{beforeopening}, \OptionValue{subject}{left} sowie +\OptionValue{subject}{untitled}.% +\EndIndexGroup + +\begin{Declaration} + \PLength{subjectvpos} +\end{Declaration} +\ChangedAt{v3.01}{\Class{scrlttr2}}% +Ist\textnote{Achtung!} der Wert dieser Pseudolänge 0\Unit{pt}, so bestimmt die +Option +\DescRef{\LabelBase.option.subject}\important{\DescRef{\LabelBase.option.subject}}% +\IndexOption{subject~=\PName{Einstellung}} (siehe +\DescPageRef{\LabelBase.option.subject}) die +Position des Betreffs. Dabei spielen dann auch die nachfolgend erklärten +Pseudolängen \DescRef{\LabelBase.plength.subjectbeforevskip} und \DescRef{\LabelBase.plength.subjectaftervskip} ihre +Rolle. Bei allen anderen Werten wird der Betreff mit dem entsprechenden +Abstand von der oberen Papierkante platziert. Es\textnote{Tipp!} wird +empfohlen in diesem Fall darauf zu achten, dass genügend Platz zur Verfügung +steht, damit Überschneidungen mit anderen Elementen unwahrscheinlich sind. +\begin{Example} + Einige wenige Berufsgruppen ziehen es vor, wenn der Betreff noch vor der + Geschäftszeile steht. Hierzu kann man die Position wie folgt wählen, wobei + auch die Position der Geschäftszeile angepasst wird: +\begin{lstcode} + \ProvidesFile{lawsubj.lco} + [2008/11/03 lawyers lco file] + \setplength{subjectvpos}{\useplength{refvpos}} + \addtoplength{refvpos}{3\baselineskip} + \endinput +\end{lstcode} + Will man, dass zwischen Betreff und Geschäftszeile noch mindestens eine + Zeile frei bleibt, hat man so Platz für maximal zwei Zeilen Betreff.% + \iftrue % Umbruchkorrektur + \ Das sollte in den allermeisten Fällen genügen.% + \fi% +\end{Example} +\EndIndexGroup +\ExampleEndFix + + +\begin{Declaration} + \PLength{subjectbeforevskip} + \PLength{subjectaftervskip} +\end{Declaration} +\ChangedAt{v3.01}{\Class{scrlttr2}}% +Wird der Betreff nicht absolut platziert, sondern vor oder nach der Anrede, so +kann vor und nach dem Betreff ein zusätzlicher Abstand eingefügt werden. Der +Abstand vor dem Betreff trifft dabei gegebenenfalls mit anderen Abständen, +etwa dem automatischen Abstand von einer Zeile nach dem Titel, zusammen. In +der Voreinstellung\textnote{Voreinstellung} wird daher in der Regel kein +weiterer Abstand an dieser Stelle eingefügt. Der Abstand nach dem Betreff +beträgt in der Voreinstellung von Klasse und Paket zwei Zeilen.% +\EndIndexGroup +% +\EndIndexGroup + + +\subsection{Schlussgruß} +\seclabel{closing} +\BeginIndexGroup +\BeginIndex{}{Schlussgruss=Schlussgruß}% +\BeginIndex{}{Gruss=Gruß} + +Dass der Schlussgruß mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing} +gesetzt wird, wurde bereits in \autoref{sec:\LabelBase.document}, +\DescPageRef{\LabelBase.cmd.closing} erklärt. % +\iffalse % Umbruchkorrektur +Unter dem Schlussgruß wird häufig noch eine Signatur, eine Art Erläuterung zur +Unterschrift, gesetzt. Die Unterschrift wiederum findet Platz zwischen dem +Schlussgruß und der Signatur.% +\else% +Unter Schlussgruß und Unterschrift wird häufig noch eine Signatur als eine Art +Erläuterung oder Klartext der Unterschrift gesetzt.% +\fi% + +\begin{Declaration} + \Variable{signature} +\end{Declaration} +Die Variable \Variable{signature}\Index{Signatur} nimmt eine Art Erläuterung +zur Unterschrift\Index{Unterschrift} auf. Ihr \PName{Inhalt} ist mit +\DescRef{\LabelBase.cmd.usekomavar}\PParameter{fromname} vordefiniert. Eine +solche Erläuterung kann auch mehrzeilig sein. Die einzelnen Zeilen sollten +dann mit doppeltem Backslash voneinander getrennt +werden. Absätze\textnote{Achtung!} innerhalb der Erläuterung sind jedoch nicht +gestattet.% +% +\EndIndexGroup + + +\begin{Declaration} + \Macro{raggedsignature} +\end{Declaration} +Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der +Unterschrift\Index{Unterschrift} werden innerhalb einer gemeinsamen Box +gesetzt. Die Breite dieser Box wird durch die längste Zeile innerhalb von +Grußfloskel und Erläuterung bestimmt. + +Wo genau diese Box platziert wird, ist durch die Pseudolängen +\DescRef{\LabelBase.plength.sigindent}\IndexPLength{sigindent} und +\DescRef{\LabelBase.plength.sigbeforevskip}\IndexPLength{sigbeforevskip} +(siehe \DescPageRef{\LabelBase.plength.sigindent}) bestimmt. Durch den Befehl +\Macro{raggedsignature} wird die Ausrichtung innerhalb der Box bestimmt. In +den vordefinierten\textnote{Voreinstellung} \File{lco}-Dateien ist die +Anweisung entweder auf \Macro{centering} oder +auf \Macro{raggedright} (nur \Option{KOMAold}) gesetzt. Um innerhalb der Box +beispielsweise eine linksbündige oder rechtsbündige Ausrichtung zu erhalten, +kann der Befehl in gleicher Weise umdefiniert werden wie +\DescRef{maincls.cmd.raggedsection} (siehe % +\iffalse % Umbruchkorrektur +das entsprechende Beispiel in % +\fi % +\autoref{sec:maincls.structure}, \DescPageRef{maincls.cmd.raggedsection}). + +\begin{Example} + Herr Musterfrau will sich nun wirklich wichtig machen und deshalb in der + Signatur nochmals darauf hinweisen, dass er selbst schon Vereinsvorsitzender + war. Deshalb ändert er die Variable + \DescRef{\LabelBase.variable.signature}. Außerdem will er, dass die Signatur + linksbündig unter dem Schlussgruß steht, und definiert dazu + \Macro{raggedsignature} um:% + {\phantomsection\xmpllabel{letterwithoutlco}}% + \lstinputcode[xleftmargin=1em]{letter-22}% + Das Ergebnis ist in \autoref{fig:\LabelBase.letter-22} zu sehen.% + \iffalse % Umbruchkorrektur (Achtung wegen unten!) + Dieses Beispiel zeigt die wichtigsten Elemente des Briefbogens und kann so + als Muster für eigene Briefe dienen.% + \fi % + \begin{figure} + \setcapindent{0pt}% + \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, + Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, + Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und + Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, + Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, + Anrede, Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, + Verteiler und Lochermarke}[l] + \frame{\includegraphics[width=.4\textwidth]{letter-22}} + \end{captionbeside} + \label{fig:\LabelBase.letter-22} + \end{figure} +\end{Example} +\iffalse% Umbruchkorrekturtext (Achtung wegen oben!) + Das vorausgehende Beispiel zeigt die wichtigsten, aber nicht alle möglichen + Elemente eines Briefes. Es kann jedoch sehr gut als allgemeines Muster + dienen.% +\else + \ExampleEndFix% Beispiel am Ende der Erklärung +\fi % \EndIndexGroup \begin{Declaration} + \PLength{sigindent} + \PLength{sigbeforevskip} +\end{Declaration} +Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der +Unterschrift\Index{Unterschrift} werden innerhalb einer Box gesetzt. Die +Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und +Erläuterung bestimmt. + +Die Box wird mit dem durch die Pseudolänge \PLength{sigindent} festgelegten +Einzug gesetzt. In den vordefinierten\textnote{Voreinstellung} +\File{lco}-Dateien ist der Einzug auf 0\Unit{mm} gesetzt. + +Zwischen Grußfloskel und Erläuterung wird ein vertikaler Abstand eingefügt, +der mit der Pseudolänge \PLength{sigbeforevskip} festgelegt ist. In den +vordefinierten\textnote{Voreinstellung} \File{lco}-Dateien ist der Wert auf +zwei Zeilen eingestellt. In diese Lücke setzen Sie dann Ihre Unterschrift.% +\iffalse% Umbruchkorrekturtext +\ Sollten\textnote{Tipp!} Sie sich dazu entschließen in die Variable +\DescRef{\LabelBase.variable.signature}\IndexVariable{signature}% +\important{\DescRef{\LabelBase.variable.signature}} mit Paket +\Package{graphicx}\IndexPackage{graphicx} ein Faksimile Ihrer Unterschrift +einzufügen, wäre es also sinnvoll den Wert von \PLength{sigbeforevskip} und +damit die Lücke zwischen Schlussgruß und Signatur zu verringern.% +\fi% +\EndIndexGroup +% +\EndIndexGroup + + +\subsection{Briefbogenfuß} +\seclabel{firstFoot}% +\BeginIndexGroup +\BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% + +Die erste Seite eines Briefes, der Briefbogen, enthält nicht nur einen eigenen +Kopf, den Briefkopf. Diese Seite enthält auch einen eigenen +Fuß\Index{Fuss=Fuß}, den Briefbogenfuß. % +\iftrue% Umbruchvarianten +Dieser wird ebenfalls nicht über den Seitenstil% +\else% +Genau wie der Briefkopf wird der Briefbogenfuß nicht über den Seitenstil% +\fi% +, sondern unmittelbar von \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening}% +\important{\DescRef{\LabelBase.cmd.opening}} ausgegeben. + + +\begin{Declaration} + \OptionVName{enlargefirstpage}{Ein-Aus-Wert} +\end{Declaration} +\begin{Explain} + Die erste Seite eines Briefes fällt % + \iftrue % Umbruchkorrektur + aufgrund der vielen Konsultationselemente, wie dem Briefkopf oder der + Anschrift, + % + \fi % + immer aus dem normalen Satzspiegel. Von \KOMAScript{} werden Mechanismen + bereitgestellt, um die Höhe und vertikale Ausrichtung von Kopf und Fuß der + ersten Seite unabhängig von den Folgeseiten zu bestimmen. Würde dadurch der + Fuß der ersten Seite in den Textbereich\Index{Text>Bereich} ragen, so wird + der Textbereich der ersten Seite automatisch mit Hilfe von + \Macro{enlargethispage}\IndexCmd{enlargethispage} verkleinert. +\end{Explain} +Soll der Textbereich auch automatisch mit \Macro{enlargethispage} vergrößert +werden, falls der Fuß der ersten Seite dies erlaubt, so kann das mit dieser +Option erreicht werden. Es passt dann bestenfalls etwas mehr Text auf die +erste Seite. Siehe hierzu auch die Erklärung zur Pseudolänge +\DescRef{\LabelBase.plength.firstfootvpos} auf +\DescPageRef{\LabelBase.plength.firstfootvpos}. Als \PName{Ein-Aus-Wert} kann +einer der Standardwerte für einfache Schalter aus +\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} verwendet +werden. Voreingestellt\textnote{Voreinstellung} ist +\PValue{false}.% +\EndIndexGroup + + +\begin{Declaration} \OptionVName{firstfoot}{Ein-Aus-Wert} \end{Declaration} \BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% Diese\ChangedAt{v2.97e}{\Class{scrlttr2}} Option bestimmt, ob der Briefbogenfuß überhaupt gesetzt wird. Das Abschalten mit \OptionValue{firstfoot}{false}\important{\OptionValue{firstfoot}{false}} hat -Auswirkungen wenn gleichzeitig Option -\DescRef{\LabelBase.option.enlargefirstpage} (siehe -\DescPageRef{\LabelBase.option.enlargefirstpage}) verwendet wird, da sich +Auswirkungen wenn gleichzeitig die zuvor dokumentierte Option +\DescRef{\LabelBase.option.enlargefirstpage} verwendet wird, da sich dadurch die Seite logisch nach unten verlängert. Zwischen dem Ende des Satzspiegels und dem Seitenende bleibt dann nur der normale Abstand zwischen Satzspiegel und Seitenfuß. @@ -2493,7 +3858,6 @@ Die Option versteht die Standardwerte für einfache Schalter, die in \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} angegeben sind. Voreingestellt\textnote{Voreinstellung} ist das Setzen des Briefbogenfußes.% -% \EndIndexGroup @@ -2501,16 +3865,22 @@ Briefbogenfußes.% \Variable{firstfoot} \end{Declaration}% \BeginIndex{}{Briefbogenfuss=Briefbogenfuß}% -Der Fuß der ersten Seite ist in der Voreinstellung leer. Es besteht jedoch die -Möglichkeit, über den \PName{Inhalt} der -Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{firstfoot} einen -neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von -\KOMAScript{} nicht genutzt. +\iffalse % Umbruchkorrektur +Der Fuß der ersten Seite ist in der Voreinstellung\textnote{Voreinstellung} +leer. Es besteht jedoch die Möglichkeit, über den \PName{Inhalt} der +Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} \Variable{firstfoot} einen neue +Festlegung zu treffen. % +\else % +Der Inhalt der Variablen\ChangedAt{v3.08}{\Class{scrlttr2}} +\Variable{firstfoot} und damit des Fußes der ersten Seite ist in der +Voreinstellung\textnote{Voreinstellung} leer. % +\fi % +Die \PName{Bezeichnung} der Variablen wird von \KOMAScript{} nicht genutzt. \BeginIndex{Variable}{frombank}% \begin{Example} - Sie wollen den Inhalt der Variablen \DescRef{\LabelBase.variable.frombank}, also die - Bankverbindung im Fuß der ersten Seite ausgeben. Der doppelte + Sie wollen den Inhalt der Variablen \DescRef{\LabelBase.variable.frombank}, + also die Bankverbindung, im Fuß der ersten Seite ausgeben. Der doppelte Backslash soll dabei durch ein Komma ersetzt werden: \begin{lstcode} \setkomavar{firstfoot}{% @@ -2520,7 +3890,10 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von } \end{lstcode} Natürlich können Sie für das Trennzeichen auch eine eigene Variable - definieren. Ich überlasse dem Leser dies als Übung. + definieren.% + \iffalse % Umbruchkorrektunr + Ich überlasse dem Leser dies als Übung.% + \fi% Will man eine Art Brief"|fuß als Gegengewicht zum Briefkopf verwenden, so kann dieser beispielsweise wie folgt definiert werden: @@ -2539,7 +3912,7 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von \multicolumn{1}{@{}l@{}}{Gerichtsstand:}\\ Hinterdupfeldingen \end{tabular}% - \ifkomavarempty{frombank}{}{% + \Ifkomavarempty{frombank}{}{% \hfill \begin{tabular}[t]{l@{}}% \multicolumn{1}{@{}l@{}}{% @@ -2564,10 +3937,10 @@ neue Festlegung zu treffen. Die \PName{Bezeichnung} der Variablen wird von \ Abhängig\textnote{Achtung!} von den Voreinstellungen ist ein solch hoher Fuß jedoch eventuell nicht vorgesehen und wird deshalb möglicherweise zu tief platziert. In einem solchen Fall kann die vertikale Position über die - Pseudolänge \DescRef{scrlttr2-experts.plength.firstfootvpos}% - \important{\DescRef{scrlttr2-experts.plength.firstfootvpos}}% + Pseudolänge \DescRef{\LabelBase.plength.firstfootvpos}% + \important{\DescRef{\LabelBase.plength.firstfootvpos}}% \IndexPLength{firstfootvpos} angepasst werden (siehe - \DescPageRef{scrlttr2-experts.plength.firstfootvpos}).% + \DescPageRef{\LabelBase.plength.firstfootvpos}).% \fi \end{Example} @@ -2577,8 +3950,8 @@ Kompatibilitätseinstellung ab Version \DescRef{\LabelBase.option.version} in \autoref{sec:\LabelBase.compatibilityOptions}, \DescPageRef{\LabelBase.option.version}) reicht der Platz dafür in der Regel -nicht aus. Sie sollten dann \PLength{firstfootvpos} (siehe -\DescPageRef{scrlttr2-experts.plength.firstfootvpos}) entsprechend +nicht aus. Sie sollten dann \DescRef{\LabelBase.plength.firstfootvpos} (siehe +\DescPageRef{\LabelBase.plength.firstfootvpos}) entsprechend verringern.% \EndIndexGroup @@ -2594,9 +3967,94 @@ Absenderergänzungsfeld (siehe Variable \DescRef{\LabelBase.variable.location}, setzen.% % \EndIndexGroup + +\begin{Declaration} + \PLength{firstfootvpos} +\end{Declaration} +Diese Pseudolänge gibt den Abstand des Fußes der ersten Briefseite von der +Oberkante des Papiers an. Es wird außerdem dafür gesorgt, dass der Textbereich +nicht in den Fuß hineinragt. Hierzu wird auf der ersten Seite gegebenenfalls +die Höhe des Textbereichs mit Hilfe von +\Macro{enlargethispage}\IndexCmd{enlargethispage}% +\important{\Macro{enlargethispage}} verkleinert. Mit Hilfe der Option +\DescRef{\LabelBase.option.enlargefirstpage}% +\important{\DescRef{\LabelBase.option.enlargefirstpage}} (siehe +\DescPageRef{\LabelBase.option.enlargefirstpage}) kann dafür gesorgt werden, +dass die Höhe des Textbereichs umgekehrt gegebenenfalls auch vergrößert +wird. Damit kann dann der Abstand zwischen Textbereich und Fuß der ersten +Seite auf den Wert der Länge +\Length{footskip}\IndexLength{footskip}\important{\Length{footskip}} +verringert werden. + +Bei\textnote{\OptionValueRef{\LabelBase}{version}{2.9t}} +Kompatibilitätseinstellungen\ChangedAt{v2.9t}{\Class{scrlttr2}} bis +Version~2.9t (siehe \DescRef{\LabelBase.option.version} in +\autoref{sec:\LabelBase.compatibilityOptions}, +\DescPageRef{\LabelBase.option.version}) wird außer bei \Option{KOMAold} und +\Option{NF} in allen vordefinierten +\File{lco}-Dateien\textnote{\File{lco}-Datei}\Index{lco-Datei=\File{lco}-Datei} +(siehe \autoref{sec:\LabelBase.lcoFile}) der Fuß abhängig vom Satzspiegel +gesetzt% +\iffalse % Umbruchkorrektur +. Damit hat dann auch \DescRef{\LabelBase.option.enlargefirstpage}% +\important{\DescRef{\LabelBase.option.enlargefirstpage}} keine Wirkung. % +\else % +\ und \DescRef{\LabelBase.option.enlargefirstpage}% +\important{\DescRef{\LabelBase.option.enlargefirstpage}} ignoriert. % +\fi % +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 \DescRef{\LabelBase.option.enlargefirstpage} abhängig. + +Wird der Briefbogenfuß mit Option +\OptionValueRef{scrlttr2}{firstfoot}{false}% +\important{\OptionValueRef{scrlttr2}{firstfoot}{false}}% +\IndexOption{firstfoot~=\textKValue{false}}\ChangedAt{v2.97e}{\Class{scrlttr2}} +(siehe \DescPageRef{\LabelBase.option.firstfoot}) abgeschaltet, so wird +\PLength{firstfootvpos} ignoriert und stattdessen +\Length{paperheight}\IndexLength{paperheight} angenommen. Es bleibt dann +ein minimaler unterer Rand von \Length{footskip}\IndexLength{footskip}.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{firstfoothpos} +\end{Declaration} +Die\textnote{Achtung!} Pseudolänge +\PLength{firstfoothpos}\ChangedAt{v3.05}{\Class{scrlttr2}} gibt bei einem +positiven Wert den Abstand des Briefbogenfußes von der linken Papierkante +an. Ist der Wert sogar größer oder gleich der Breite des Papiers, +\Length{paperwidth}\IndexLength{paperwidth}, so wird der Fuß horizontal +zentriert auf dem Briefbogen platziert. Ein negativer Wert gibt den Abstand +des Fußes von der rechten Papierkante an. Ist der Wert jedoch kleiner oder +gleich der negativen Breite des Papiers, so wird der Fuß bündig zum linken +Rand des Satzspiegels platziert. + +Voreingestellt\textnote{Voreinstellung} ist typischerweise ein Wert von +\Length{maxdimen}\IndexLength{maxdimen}% +\iffalse % Umbruchkorrektur +, also der größtmögliche Wert für eine Länge% +\fi% +\ und infolge dessen horizontale Zentrierung.% +\EndIndexGroup + + +\begin{Declaration} + \PLength{firstfootwidth} +\end{Declaration} +Diese Pseudolänge gibt die Breite des Fußes der ersten Briefseite, also des +Briefbogens, an. Der Wert stimmt in den vordefinierten \File{lco}-Dateien mit +\DescRef{\LabelBase.plength.firstheadwidth}\important{\DescRef{\LabelBase.plength.firstheadwidth}}% +\IndexPLength{firstheadwidth} überein.% +% +\EndIndexGroup % \EndIndexGroup +% +\EndIndexGroup +\iffree{}{\clearpage}% Umbruchkorrektur \LoadCommonFile{parmarkup}% \section{Absatzauszeichnung} \LoadCommonFile{oddorevenpage}% \section{Erkennung von rechten und linken Seiten} @@ -2651,7 +4109,7 @@ eingestellt ist. \begin{lstcode} \renewcommand*{\letterpagestyle}{} \end{lstcode} - in die Dokumentpräambel. Dabei ist übrigens der Stern bei + in die Dokumentpräambel. Dabei\textnote{Achtung!} ist übrigens der Stern bei \Macro{renewcommand*} wichtig!% \end{Example} Natürlich haben die Anweisung \DescRef{\LabelBase.cmd.pagestyle} und @@ -2678,8 +4136,9 @@ ein. Ein\important{\OptionValue{footsepline}{true}} Aktivieren der Option der Optionen schaltet die jeweilige Linie aus. Beim Seitenstil \DescRef{\LabelBase.pagestyle.empty}% -\important{\DescRef{\LabelBase.pagestyle.empty}} (siehe später in -diesem Abschnitt) haben die Optionen \Option{headsepline} und +\important{\DescRef{\LabelBase.pagestyle.empty}} (siehe +\DescPageRef{\LabelBase.pagestyle.empty}) % später in diesem Abschnitt) +haben die beiden Optionen \Option{headsepline} und \Option{footsepline} selbstverständlich keine Auswirkung. Bei diesem Seitenstil soll ja auf Seitenkopf\Index{Seiten>Kopf} und Seitenfuß\Index{Seiten>Fuss=Fuß} ausdrücklich verzichtet werden. @@ -2688,9 +4147,9 @@ Typografisch\important{\DescRef{\LabelBase.pagestyle.headings}\\ \DescRef{\LabelBase.pagestyle.myheadings}\\ \DescRef{\LabelBase.pagestyle.plain}} betrachtet hat eine solche Linie immer die Auswirkung, dass der Kopf oder Fuß optisch näher an den Text heranrückt. -Dies bedeutet nun nicht, dass Kopf oder Fuß räumlich weiter vom +Dies bedeutet aber nicht, dass Kopf oder Fuß räumlich weiter vom Textkörper\Index{Text>Bereich} weggerückt werden müssten. Stattdessen sollten -sie dann bei der Berechnung des Satzspiegels als zum Textkörper gehörend +sie bei der Berechnung des Satzspiegels als zum Textkörper gehörend betrachtet werden. Dies wird bei \Class{scrlttr2} dadurch erreicht, dass bei Verwendung der Klassenoption \Option{headsepline} automatisch die Paketoption \DescRef{typearea.option.headinclude}% @@ -2703,9 +4162,9 @@ wird. Entsprechendes gilt bei \DescRef{\LabelBase.option.footsepline} für Die Optionen führen selbst keine automatische Neuberechnung des Satzspiegels aus. Zur Neuberechnung des Satzspiegels siehe Option \DescRef{typearea.option.DIV} mit den Werten \PValue{last} oder -\PValue{current} (siehe \DescPageRef{typearea.option.DIV.last}) oder die -Anweisung \DescRef{typearea.cmd.recalctypearea} (siehe -\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}. +\PValue{current} (\DescPageRef{typearea.option.DIV.last}) oder Anweisung +\DescRef{typearea.cmd.recalctypearea} +(\DescPageRef{typearea.cmd.recalctypearea}) in \autoref{cha:typearea}. Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% @@ -2713,16 +4172,13 @@ Das Paket \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \autoref{cha:scrlayer-scrpage}) bietet weitere Einflussmöglichkeiten für Linien im Kopf und Fuß und kann auch mit \Class{scrlttr2} kombiniert werden. Das Paket \Package{scrletter} verwendet hingegen automatisch -\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} zur -Definition der Seitenstile \DescRef{\LabelBase.pagestyle.letter} und -\DescRef{\LabelBase.pagestyle.plain.letter}. - -Die von \Package{scrletter}\OnlyAt{\Package{scrletter}} definierten Seitenstile -\DescRef{\LabelBase.pagestyle.letter} und -\DescRef{\LabelBase.pagestyle.plain.letter} unterliegen den Regeln von -\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. Dies betrifft -insbesondere das Setzen der Linien in Kopf und Fuß des -\PageStyle{plain}-Seitenstils +\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} zur Definition der +Seitenstile \DescRef{\LabelBase.pagestyle.letter} und +\DescRef{\LabelBase.pagestyle.plain.letter}. Die von +\Package{scrletter}\OnlyAt{\Package{scrletter}} definierten Seitenstile +unterliegen damit den Regeln jenes Pakets. Dies betrifft insbesondere das +Setzen der Linien in Kopf und Fuß des +\hyperref[desc:\LabelBase.pagestyle.plain.letter]{\PageStyle{plain}}-Seitenstils \DescRef{\LabelBase.pagestyle.plain.letter}. Siehe dazu in \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.option.headsepline} und @@ -2758,37 +4214,38 @@ wird (siehe \autoref{cha:scrlayer-scrpage}). Es gibt Werte, die sich nur auf die horizontale Position auswirken, Werte, die nur die vertikale Position beeinflussen, und Werte, die zugleich die vertikale und die horizontale Position festlegen. Mögliche Werte sind \autoref{tab:\LabelBase.pagenumber} zu -entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{botcenter}. - +entnehmen. Voreingestellt\textnote{Voreinstellung} ist \PValue{botcenter}.% +% \begin{table}[t!]% Umbruchkorrektur - \caption[{Mögliche Werte für Option \Option{pagenumber} bei \Class{scrlttr2} - und \Package{scrletter}}]{Mögliche Werte für Option \Option{pagenumber} - zur Positionierung der Paginierung innerhalb der Seitenstile} + \caption[{Mögliche Werte für Option \Option{pagenumber}}]% + {Mögliche Werte für Option \Option{pagenumber} zur Positionierung der + Paginierung innerhalb der Seitenstile} \label{tab:\LabelBase.pagenumber} \begin{desctabular} \entry{\PValue{bot}, \PValue{foot}}{% - Seitenzahl im Fuß ohne Änderung der horizontalen Position}% + Seitenzahl im Fuß ohne Änderung der horizontalen Position}\\[-1.7ex] \entry{\PValue{botcenter}, \PValue{botcentered}, \PValue{botmittle}, \PValue{footcenter}, \PValue{footcentered}, \PValue{footmiddle}}{% - Seitenzahl zentriert innerhalb des Fußes}% + Seitenzahl zentriert innerhalb des Fußes}\\[-1.7ex] \entry{\PValue{botleft}, \PValue{footleft}}{% - Seitenzahl links im Fuß}% - \entry{\PValue{botright}, \PValue{footright}}{ Seitenzahl rechts im Fuß}% + Seitenzahl links im Fuß}\\[-1.7ex] + \entry{\PValue{botright}, \PValue{footright}}{% + Seitenzahl rechts im Fuß}\\[-1.7ex] \entry{\PValue{center}, \PValue{centered}, \PValue{middle}}{% - Seitenzahl zentriert ohne Änderung der vertikalen Position}% + Seitenzahl zentriert ohne Änderung der vertikalen Position}\\[-1.7ex] \entry{\PValue{false}, \PValue{no}, \PValue{off}}{% - keine Seitenzahl}% + keine Seitenzahl}\\[-1.7ex] \entry{\PValue{head}, \PValue{top}}{% - Seitenzahl im Kopf ohne Änderung der horizontalen Position}% + Seitenzahl im Kopf ohne Änderung der horizontalen Position}\\[-1.7ex] \entry{\PValue{headcenter}, \PValue{headcentered}, \PValue{headmiddle}, \PValue{topcenter}, \PValue{topcentered}, \PValue{topmiddle}}{% - Seitenzahl zentriert innerhalb des Kopfes}% + Seitenzahl zentriert innerhalb des Kopfes}\\[-1.7ex] \entry{\PValue{headleft}, \PValue{topleft}}{% - Seitenzahl links im Kopf}% + Seitenzahl links im Kopf}\\[-1.7ex] \entry{\PValue{headright}, \PValue{topright}}{% - Seitenzahl rechts im Kopf}% + Seitenzahl rechts im Kopf}\\[-1.7ex] \entry{\PValue{left}}{% - Seitenzahl links ohne Änderung der vertikalen Position}% + Seitenzahl links ohne Änderung der vertikalen Position}\\[-1.7ex] \entry{\PValue{right}}{% Seitenzahl rechts ohne Änderung der vertikalen Position}% \end{desctabular} @@ -2809,16 +4266,18 @@ Bei Briefen mit \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} wird zwischen vier verschiedenen Seitenstilen unterschieden. Dagegen definiert \Package{scrletter}\OnlyAt{\Package{scrletter}} nur zwei eigene Seitenstile. \begin{description}\setkomafont{descriptionlabel}{} -\item[{\PageStyle{empty}}] - \LabelPageStyle{empty}% - ist der Seitenstil, bei dem Kopf- und Fußzeile von - Folgeseiten vollständig leer bleiben. Dieser Seitenstil wird auch - automatisch für die erste Briefseite verwendet, da auf dieser Seite Kopf und - Fuß über \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} (siehe +\item[{\PageStyle{empty}}] \LabelPageStyle{empty}% + ist der Seitenstil, bei dem Kopf- und Fußzeile von Folgeseiten vollständig + leer bleiben. Dieser Seitenstil wird auch automatisch für die erste + Briefseite verwendet, da auf dieser Seite Kopf und Fuß über + \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening}% + \important{\DescRef{\LabelBase.cmd.opening}} (siehe \autoref{sec:\LabelBase.firstpage}, \DescPageRef{\LabelBase.cmd.opening}) - mit anderen Mitteln gesetzt werden. -\item[{\PageStyle{headings}}] - \LabelPageStyle{headings}% + mit anderen Mitteln gesetzt werden. Die Klasse \Class{scrlttr2} verlässt + sich bei diesem Seitenstil auf den \LaTeX-Kern, während bei + \Package{scrletter} der Stil von \hyperref[cha:scrlayer]{\Package{scrlayer}} + bereitgestellt wird. +\item[{\PageStyle{headings}}] \LabelPageStyle{headings}% ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für automatische Kolumnentitel auf Folgeseiten. Dabei werden als automatisch gesetzte Marken der Absendername aus der Variablen @@ -2830,16 +4289,19 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \DescPageRef{\LabelBase.variable.subject}). Wo genau diese Marken und die Seitenangabe ausgegeben werden, hängt von der oben erklärten Option \DescRef{\LabelBase.option.pagenumber} und dem Inhalt der Variablen - \DescRef{\LabelBase.variable.nexthead}\IndexVariable{nexthead} und - \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} ab. Der Autor - kann die Marken aber auch noch nach \DescRef{\LabelBase.cmd.opening} manuell + \DescRef{\LabelBase.variable.nexthead}\IndexVariable{nexthead}% + \important{\DescRef{\LabelBase.variable.nexthead}} und + \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot}% + \important{\DescRef{\LabelBase.variable.nextfoot}} ab. Der Autor kann die + Marken aber auch noch nach \DescRef{\LabelBase.cmd.opening} manuell beeinflussen. Hierzu stehen wie üblich die Anweisungen \DescRef{\LabelBase.cmd.markboth} und \DescRef{\LabelBase.cmd.markright}, bei Verwendung von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% \IndexPackage{scrlayer-scrpage}% - \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} - auch \DescRef{scrlayer-scrpage.cmd.markleft} (siehe + \important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} auch + \DescRef{scrlayer-scrpage.cmd.markleft} und + \DescRef{scrlayer-scrpage.cmd.markdouble} (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.cmd.markleft}), zur Verfügung. @@ -2850,41 +4312,40 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \DescRef{scrlayer-scrpage.pagestyle.scrheadings} umdefiniert. Näheres zu diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren. -\item[{\PageStyle{letter}}] - \LabelPageStyle{letter}% - Da der Seitenstil \PageStyle{headings} im allgemeinen bereits von den - Klassen belegt ist, definiert das Paket - \Package{scrletter}\OnlyAt{scrletter} stattdessen einen Seitenstil - \PageStyle{letter}. Dies geschieht mit Hilfe von +\item[{\PageStyle{letter}}] \LabelPageStyle{letter}% + wird nur von \Package{scrletter}\OnlyAt{scrletter} definiert, da der + Seitenstil \PageStyle{headings} im allgemeinen bereits von den Klassen + belegt ist. Dies geschieht mit Hilfe von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} aus \autoref{cha:scrlayer-scrpage}, \autopageref{cha:scrlayer-scrpage}. Bei der Einstellung \OptionValueRef{scrlayer-scrpage}{automark}{true}% \important{\OptionValueRef{scrlayer-scrpage}{automark}{true}}% \IndexOption{automark} übernimmt \PageStyle{letter} dann die Rolle, die bei - \Class{scrlttr2} von \PageStyle{headings} ausgefüllt wird. Bei - \OptionValueRef{scrlayer-scrpage}{automark}{false}% + \Class{scrlttr2} von \DescRef{\LabelBase.pagestyle.headings} ausgefüllt + wird. Bei \OptionValueRef{scrlayer-scrpage}{automark}{false}% \important{\OptionValueRef{scrlayer-scrpage}{automark}{false}}% \IndexOption{automark} übernimmt \PageStyle{letter} dagegen die Rolle von - \PageStyle{myheadings}. + \DescRef{\LabelBase.pagestyle.myheadings}. Durch\textnote{Achtung!} die Verwendung von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} kann das - veraltete Paket \Package{scrpage2}\IndexPackage{scrpage2} - oder das mit \KOMAScript{} wenig kompatible Paket + veraltete Paket \Package{scrpage2}\IndexPackage{scrpage2} oder das mit + \KOMAScript{} wenig kompatible \iffalse Paket \fi% Umbruchkorrektur \Package{fancyhdr}\IndexPackage{fancyhdr} nicht zusammen mit \Package{scrletter} verwendet werden. -\item[{\PageStyle{myheadings}}] - \LabelPageStyle{myheadings}% +\item[{\PageStyle{myheadings}}] \LabelPageStyle{myheadings}% ist bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} der Seitenstil für manuelle Kolumnentitel auf Folgeseiten. Im Unterschied zu \PValue{headings} müssen die Marken vom Anwender gesetzt werden. Er verwendet dazu die Anweisungen \DescRef{\LabelBase.cmd.markboth}\IndexCmd{markboth} und \DescRef{\LabelBase.cmd.markright}\IndexCmd{markright}. Bei Verwendung von - \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} steht außerdem - \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} zur Verfügung. + \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} stehen außerdem + \DescRef{scrlayer-scrpage.cmd.markleft}\IndexCmd{markleft} und + \DescRef{scrlayer-scrpage.cmd.markdouble}\IndexCmd{markdouble} zur + Verfügung. - Beim Paket \Package{scrletter}\OnlyAt{\Package{scrletter}} übernimmt der - Seitenstil \PageStyle{letter} ebenfalls die Rolle von + Bei \Package{scrletter}\OnlyAt{\Package{scrletter}} übernimmt der + Seitenstil \DescRef{\LabelBase.pagestyle.letter} ebenfalls die Rolle von \PageStyle{myheadings}. \item[{\PageStyle{plain}}] \LabelPageStyle{plain}% @@ -2900,18 +4361,23 @@ verschiedenen Seitenstilen unterschieden. Dagegen definiert \DescRef{scrlayer-scrpage.pagestyle.plain.scrheadings} umdefiniert. Näheres zu diesem Seitenstil ist in \autoref{cha:scrlayer-scrpage} auf \DescPageRef{scrlayer-scrpage.pagestyle.scrheadings} zu erfahren. -\item[{\PageStyle{plain.letter}}] +\item[{\PageStyle{plain.letter}}]% \LabelPageStyle{plain.letter}% - Da der Seitenstil \PageStyle{plain} im allgemeinen bereits von den Klassen - belegt ist, definiert das Paket \Package{scrletter}\OnlyAt{scrletter} - stattdessen einen Seitenstil \PageStyle{plain.letter}. Dies geschieht mit - Hilfe von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. - Durch\textnote{Achtung!} diese Verwendung von - \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} kann das - veraltete Pakete \Package{scrpage2}\IndexPackage{scrpage2} oder das mit - \KOMAScript{} wenig kompatible Paket + wird von \Package{scrletter}\OnlyAt{scrletter} zusammen mit + \DescRef{\LabelBase.pagestyle.letter} definiert. Dies geschieht mit Hilfe + von \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}. Nach der + Aktivierung von \DescRef{\LabelBase.pagestyle.letter} bis zum Ende des + Briefes ist \PageStyle{plain} dann ein Alias für diesen Stil. + \iffalse% Umbruchkorrektur (steht auch schon oben bei letter) + + Durch\textnote{Achtung!} die Verwendung von + \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% + \IndexPackage{scrlayer-scrpage} kann das veraltete Pakete + \Package{scrpage2}\IndexPackage{scrpage2} oder das mit \KOMAScript{} wenig + kompatible \iffalse Paket \fi% Umbruchkorrektur \Package{fancyhdr}\IndexPackage{fancyhdr} nicht zusammen mit - \Package{scrletter} verwendet werden. + \Package{scrletter} verwendet werden.% + \fi% \end{description} Die Form der Seitenstile wird außerdem durch die oben erklärten @@ -2925,18 +4391,30 @@ der aktuellen Seite. \KOMAScript\textnote{Achtung!} verwendet \Macro{thispagestyle}\PParameter{empty} selbst innerhalb von \DescRef{\LabelBase.cmd.opening}\IndexCmd{opening} für die erste Briefseite. -\BeginIndexGroup -\BeginIndex[indexother]{}{Schrift>Art}% +\BeginIndexGroup \BeginIndex[indexother]{}{Schrift>Art}% \BeginIndex{FontElement}{pageheadfoot}\LabelFontElement{pageheadfoot}% +\BeginIndex{FontElement}{pagehead}\LabelFontElement{pagehead}% \BeginIndex{FontElement}{pagefoot}\LabelFontElement{pagefoot}% \BeginIndex{FontElement}{pagenumber}\LabelFontElement{pagenumber}% +\iffalse % Umbruchkorrektur Um die Schriftart von Kopf und Fuß der Seite oder der Seitenangabe zu ändern, verwenden Sie die Benutzerschnittstelle, die in -\autoref{sec:\LabelBase.textmarkup} beschrieben ist. Für den Kopf und den Fuß -ist dabei das gleiche Element zuständig, das Sie wahlweise mit -\FontElement{pageheadfoot}\important{\FontElement{pagehead}} oder -\FontElement{pagehead} benennen können. Für den -Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist zusätzlich auch noch das Element +\autoref{sec:\LabelBase.textmarkup} beschrieben ist. Für den Kopf und den +Fuß % +\else % +Für die Schriftart von Kopf und Fuß der Seite % +\fi % +gibt es das gemeinsame Element +\FontElement{pagehheadfoot}\important{\iffree{}{\normalcolor}% Linkfarbe + % blutet in die Marginalienspalte aus + \FontElement{pageheadfoot}}. Bei +Verwendung von \hyperref[cha:scrlayer-scrpage]{scrlayer-scrpage} und damit +auch bei Verwendung von \Package{scrletter} wird im Kopf zusätzlich das +Element \FontElement{pagehead}\important{\FontElement{pagehead}} +verwendet. Ohne das Paket ist bei \Class{scrlttr2} hingegen +\FontElement{pagehead} eine alternative Bezeichnung für +\FontElement{pageheadfoot}. Für den Fuß\ChangedAt{v3.00}{\Class{scrlttr2}} ist +zusätzlich das Element \FontElement{pagefoot}\important{\FontElement{pagefoot}} zuständig, das nach \FontElement{pageheadfoot} in mit Variable \DescRef{\LabelBase.variable.nextfoot}\IndexVariable{nextfoot} oder per Paket @@ -2966,29 +4444,36 @@ Optionen und Variablen für die Gestaltung des Seitenkopfes\Index{Kopf} und -fußes\Index{Fuss=Fuß} auf Folgeseiten\Index{Folgeseite} zur Verfügung stellt, vollkommen ausreichen. Dies gilt umso mehr, als man zusätzlich mit \Macro{markboth} und \Macro{markright} die Möglichkeit hat, die Angaben zu -ändern, die \Class{scrlttr2} oder \Package{scrletter} in den Kopf setzt. Die -Anweisungen \Macro{markboth}\IndexCmd{markboth} und -\Macro{markright}\IndexCmd{markright} können insbesondere mit dem Seitenstil -\PageStyle{myheadings}% -\IndexPagestyle{myheadings}\important{\PageStyle{myheadings}} verwendet -werden. Bei Verwendung des Pakets +ändern, die \KOMAScript{} in den Kopf setzt. Die Anweisungen +\Macro{markboth}\IndexCmd{markboth} und \Macro{markright}\IndexCmd{markright} +können insbesondere mit dem Seitenstil +\DescRef{\LabelBase.pagestyle.myheadings}\IndexPagestyle{myheadings}% +\important{\DescRef{\LabelBase.pagestyle.myheadings}, + \DescRef{\LabelBase.pagestyle.letter}} beziehungsweise +\DescRef{\LabelBase.pagestyle.letter}\IndexPagestyle{letter} genutzt +werden. Bei Verwendung des Pakets% +\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}\\ + \DescRef{scrlayer-scrpage.pagestyle.scrheadings}} \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}% -\IndexPackage{scrlayer-scrpage}% -\important{\hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}}} gilt -dies natürlich auch für den Seitenstil \PageStyle{scrheadings}% -\IndexPagestyle{scrheadings}\important{\PageStyle{scrheadings}}. Dort steht -außerdem die Anweisung \DescRef{scrlayer-scrpage.cmd.markleft}% -\IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}} zur -Verfügung (siehe \autoref{sec:scrlayer-scrpage.pagestyle.content}, +\IndexPackage{scrlayer-scrpage} +gilt dies auch für den +Seitenstil \DescRef{scrlayer-scrpage.pagestyle.scrheadings}% +\IndexPagestyle{scrheadings}. Außerdem stehen dann die Anweisungen +\DescRef{scrlayer-scrpage.cmd.markleft}% +\IndexCmd{markleft}\important{\DescRef{scrlayer-scrpage.cmd.markleft}\\ + \DescRef{scrlayer-scrpage.cmd.markdouble}} und +\DescRef{scrlayer-scrpage.cmd.markdouble}% +\IndexCmd{markdouble} zur Verfügung (siehe +\autoref{sec:scrlayer-scrpage.pagestyle.content}, \DescPageRef{scrlayer-scrpage.cmd.markleft}). \begin{Declaration} \Variable{nexthead} \Variable{nextfoot} \end{Declaration} -In einigen wenigen Fällen will man jedoch den Kopf oder Fuß der Folgeseiten -ähnlich dem Briefbogen freier gestalten. In\textnote{Achtung!} diesen Fällen -muss auf die vordefinierten Möglichkeiten, die per oben erklärter Option +In einigen wenigen Fällen will man den Kopf oder Fuß der Folgeseiten ähnlich +dem Briefbogen freier gestalten. In\textnote{Achtung!} diesen Fällen muss auf +die vordefinierten Möglichkeiten, die per oben erklärter Option \DescRef{\LabelBase.option.pagenumber}\IndexOption{pagenumber} auswählbar sind, verzichtet werden. Stattdessen gestaltet man sich den Kopf und Fuß der Folgeseiten bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} im Seitenstil @@ -3006,11 +4491,10 @@ beziehungsweise \Variable{nextfoot}. Innerhalb des Inhalts von der \Macro{parbox}-Anweisung (siehe \cite{latex:usrguide}) mehrere Boxen neben- und untereinander gesetzt werden. Einem versierten Anwender sollte es so möglich sein, eigene Seitenköpfe und "~füße zu gestalten. Natürlich kann -und sollte im Wert mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} auch auf -weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von -\KOMAScript{} bei beiden Variablen nicht genutzt.% -\EndIndexGroup -\EndIndexGroup +und sollte im \PName{Inhalt} mit Hilfe von \DescRef{\LabelBase.cmd.usekomavar} +auch auf weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird +von \KOMAScript{} bei beiden Variablen nicht genutzt.% +\EndIndexGroup \EndIndexGroup % \EndIndexGroup @@ -3029,26 +4513,44 @@ weitere Variablen zugegriffen werden. Die \PName{Bezeichnung} wird von \BeginIndex{}{Formeln}% \BeginIndex{}{Gleichungen}% -Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische -Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik -bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll -und ganz auf den \LaTeX-Kern. Da\textnote{Achtung!} jedoch Mathematik in Form -von nummerierten Gleichungen und Formeln in Briefen eher ungewöhnlich ist, -unterstützt \KOMAScript{} dies nicht aktiv. Daher gibt es auch nicht die -Optionen \DescRef{maincls.option.leqno} und \DescRef{maincls.option.fleqn}, -die in \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für -\Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} dokumentiert sind.% -\iffalse% Umbruchkorrekturtext - \par - Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also - \Environment{displaymath}\IndexEnv{displaymath}, - \Environment{equation}\IndexEnv{equation} und - \Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle - verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für - mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die - Verwendung von \Package{amsmath}\IndexPackage{amsmath} empfohlen (siehe - \cite{package:amsmath}).% -\fi +\iffalse % Umbruchkorrektur + Die \KOMAScript-Klassen stellen keine eigenen Umgebungen für mathematische + Formeln, Gleichungssysteme oder ähnliche Elemente der Mathematik + bereit. Stattdessen stützt sich \KOMAScript{} im Bereich der Mathematik voll + und ganz auf den \LaTeX-Kern. Da\textnote{Achtung!} jedoch Mathematik in Form + von nummerierten Gleichungen und Formeln in Briefen eher ungewöhnlich ist, % + \iffalse % Umbruchkorrektur + unterstützt \Class{scrlttr2} dies nicht aktiv. Daher gibt es auch % + \else% + gibt es bei \Class{scrlttr2} % + \fi% + nicht die Optionen \DescRef{maincls.option.leqno} und + \DescRef{maincls.option.fleqn}, die in \autoref{sec:maincls.math}, + \autopageref{sec:maincls.math} für \Class{scrbook}, \Class{scrreprt} und + \Class{scrartcl} dokumentiert sind.% + \iffalse% Umbruchkorrekturtext + \ Bei \Package{scrletter} ist für dergleichen ohnehin die verwendete + Klasse zuständig.% + \par + Auf eine Beschreibung der Mathematikumgebungen des \LaTeX-Kerns, also + \Environment{displaymath}\IndexEnv{displaymath}, + \Environment{equation}\IndexEnv{equation} und + \Environment{eqnarray}\IndexEnv{eqnarray}, wird an dieser Stelle + verzichtet. Wer diese verwenden möchte, sei auf \cite{l2kurz} verwiesen. Für + mehr als nur einfachste mathematische Formeln und Gleichungen sei jedoch die + Verwendung von \Package{amsmath}\IndexPackage{amsmath} empfohlen (siehe + \cite{package:amsmath}).% + \fi% +\else% + Da in Briefen ausladende Mathematik in Form nummerierter Gleichungen und + Formeln eher ungewöhnlich ist, gibt es bei \Class{scrlttr2} die Optionen + \DescRef{maincls.option.leqno} und \DescRef{maincls.option.fleqn}, die in + \autoref{sec:maincls.math}, \autopageref{sec:maincls.math} für + \Class{scrbook}, \Class{scrreprt} und \Class{scrartcl} dokumentiert sind, + nicht. Dennoch können die vom \LaTeX-Kern oder von Zusatzpaketen wie + \Package{amsmath}\IndexPackage{amsmath} bereitgestellten + Mathematikumgebungen verwendet werden.% +\fi% % \EndIndexGroup @@ -3068,89 +4570,9 @@ Hilfe von \hyperref[cha:tocbasic]{\Package{tocbasic}}\IndexPackage{tocbasic}% \important{\hyperref[cha:tocbasic]{\Package{tocbasic}}}, wie sie in \autoref{cha:tocbasic} dokumentiert sind, können ebenfalls genutzt werden. -\LoadCommonFile{marginpar}% \section{Randnotizen} - - -\section{Schlussgruß} -\seclabel{closing} -\BeginIndexGroup -\BeginIndex{}{Schlussgruss=Schlussgruß} - -Dass der Schlussgruß mit \DescRef{\LabelBase.cmd.closing}\IndexCmd{closing} -gesetzt wird, wurde bereits in \autoref{sec:\LabelBase.document}, -\DescPageRef{\LabelBase.cmd.closing} erklärt. Unter dem Schlussgruß wird häufig -noch eine Signatur, eine Art Erläuterung zur Unterschrift, gesetzt. Die -Unterschrift wiederum findet Platz zwischen dem Schlussgruß und der Signatur. -\begin{Declaration} - \Variable{signature} -\end{Declaration} -Die Variable \Variable{signature}\Index{Signatur} nimmt eine Art Erläuterung -zur Unterschrift\Index{Unterschrift} auf. Ihr \PName{Inhalt} ist mit -\DescRef{\LabelBase.cmd.usekomavar}\PParameter{fromname} vordefiniert. Eine -solche Erläuterung kann auch mehrzeilig sein. Die einzelnen Zeilen sollten -dann mit doppeltem Backslash voneinander getrennt -werden. Absätze\textnote{Achtung!} innerhalb der Erläuterung sind jedoch nicht -gestattet.% -% -\EndIndexGroup - - -\begin{Declaration} - \Macro{raggedsignature} -\end{Declaration} -Grußfloskel\Index{Gruss=Gruß}\Index{Signatur} und Erläuterung der -Unterschrift\Index{Unterschrift} werden innerhalb einer Box gesetzt. Die -Breite dieser Box wird durch die längste Zeile innerhalb von Grußfloskel und -Erläuterung bestimmt. - -Wo genau diese Box platziert wird, ist durch die Pseudolängen -\PLength{sigindent}\IndexPLength{sigindent} und -\PLength{sigbeforevskip}\IndexPLength{sigbeforevskip} (siehe -\autoref{sec:scrlttr2-experts.closing}, -\DescPageRef{scrlttr2-experts.plength.sigindent}) bestimmt. Durch den Befehl -\Macro{raggedsignature} wird die Ausrichtung innerhalb der Box bestimmt. In -den vordefinierten \File{lco}-Dateien ist die Anweisung entweder auf -\Macro{centering} (alle außer \Option{KOMAold}) oder auf \Macro{raggedright} -(\Option{KOMAold}) gesetzt. Um innerhalb der Box beispielsweise eine -linksbündige oder rechtsbündige Ausrichtung zu erhalten, kann der Befehl in -gleicher Weise umdefiniert werden wie \DescRef{maincls.cmd.raggedsection} -(siehe das entsprechende Beispiel in \autoref{sec:maincls.structure}, -\DescPageRef{maincls.cmd.raggedsection}). - -\begin{Example} - Herr Musterfrau will sich nun wirklich wichtig machen und deshalb in der - Signatur nochmals darauf hinweisen, dass er selbst auch mal - Vereinsvorsitzender war. Deshalb ändert er die Variable - \DescRef{\LabelBase.variable.signature}. Außerdem will er, dass die Signatur - linksbündig unter dem Schlussgruß steht, und definiert daher auch noch - \Macro{raggedsignature} um:% - \lstinputcode[xleftmargin=1em]{letter-22}% - Das Ergebnis ist in \autoref{fig:\LabelBase.letter-22} zu sehen. - \begin{figure} - \setcapindent{0pt}% - \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, - Anschrift, Absenderergänzung, Ort, Datum, Betreff, Anrede, Text, - Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, Verteiler und - Lochermarke}]{Ergebnis eines kleinen Briefes mit erweitertem Absender, - Logo, Anschrift, Absenderergänzung, Ort, Datum, Betreff, - Anrede, Text, Grußfloskel, geänderter Signatur, Postskriptum, Anlagen, - Verteiler und Lochermarke}[l] - \frame{\includegraphics[width=.4\textwidth]{letter-22}} - \end{captionbeside} - \label{fig:\LabelBase.letter-22} - \end{figure} -\end{Example} +\LoadCommonFile{marginpar}% \section{Randnotizen} -\iftrue% Umbruchkorrekturtext - Das vorausgehende Beispiel zeigt die wichtigsten, aber nicht alle möglichen - Elemente eines Briefes. Es kann jedoch sehr gut als allgemeines Muster - dienen.% -\fi -% -\EndIndexGroup -% -\EndIndexGroup \section{\emph{Letter-Class-Option}-Dateien} \seclabel{lcoFile}% @@ -3169,37 +4591,44 @@ Briefklassenoption. Dennoch finden diese Dateien für \Package{scrletter} ebenso Anwendung. In \File{lco}-Dateien können alle Anweisungen verwendet werden, die auch an -der Stelle im Dokument verwendet werden könnten, an der %die \File{lco}-Datei +der Stelle im Dokument verwendet werden könnten, an der sie mit \DescRef{\LabelBase.cmd.LoadLetterOption} geladen werden. Außerdem können interne Anweisungen verwendet werden, die für -Paketautoren freigegeben sind. Bei \Class{scrlttr2} und \Package{scrletter} +Paketautoren freigegeben sind.% +\iffalse % Das ist hier Unfug, der durch die Umwandlung interner Anweisungen + % entstanden ist. +Bei \Class{scrlttr2} und \Package{scrletter} sind dies insbesondere die Anweisungen -\DescRef{scrlttr2-experts.cmd.newplength}\IndexCmd{newplength}, -\DescRef{scrlttr2-experts.cmd.setplength}\IndexCmd{setplength} und -\DescRef{scrlttr2-experts.cmd.addtoplength}\IndexCmd{addtoplength} (siehe -\autoref{sec:scrlttr2-experts.pseudoLengths}). +\DescRef{\LabelBase.cmd.newplength}\IndexCmd{newplength}, +\DescRef{\LabelBase.cmd.setplength}\IndexCmd{setplength} und +\DescRef{\LabelBase.cmd.addtoplength}\IndexCmd{addtoplength} (siehe +\autoref{sec:\LabelBase.pseudoLength}).% +\fi \KOMAScript{} liegen bereits einige \File{lco}-Dateien bei. Die Dateien -\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco}, \File{SN.lco}, -\File{UScommercial9}, \File{UScommercial9DW} und +\File{DIN.lco}, \File{DINmtext.lco}, +\File{DIN5008A.lco}\ChangedAt{v3.26}{\File{DIN5008A.lco}}, +\File{DIN5008B.lco}\ChangedAt{v3.26}{\File{DIN5008B.clo}}, \File{SN.lco}, +\File{SNleft.lco}, \File{UScommercial9}, \File{UScommercial9DW} und \File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} dienen dazu, \Class{scrlttr2} und \Package{scrletter} 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}\IndexClass{scrlettr} zu verbessern. Diese -Klasse wurde schon vor über 15~Jahren aus \KOMAScript{} entfernt. Es wird -daher nicht mehr näher darauf eingegangen. 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. +Klasse wurde schon vor über \the\numexpr \year-2002\relax~Jahren aus +\KOMAScript{} entfernt. Es wird daher nicht mehr näher darauf eingegangen. 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 gebeten, diesen Parametersatz an die Supportadresse von \KOMAScript{} zu schicken. Bitte geben Sie dabei auch die Erlaubnis zur Weiterverbreitung unter den Lizenzbedingungen von \KOMAScript{} (siehe dazu die Datei -\href{http://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/lppl-de.txt}% +\href{https://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/lppl-de.txt}% {\File{lppl-de.txt}} im \KOMAScript-Paket). Wenn Sie zwar über die notwendigen Maße aus einer bisher nicht unterstützen Briefnorm verfügen, sich jedoch nicht in der Lage sehen, selbst eine passende \File{lco}-Datei zu erstellen, so @@ -3242,8 +4671,8 @@ Reihenfolge der Angabe in der Liste geladen. \File{DINmtext} verwendet werden. Bei dieser steht das Adressfeld weiter oben, damit mehr Text auf die erste Seite passt. Dafür ist die Faltung so angepasst, dass das Adressfeld bei - DIN~C6/5-Umschlägen trotzdem in das Adressfenster passt. Sie - erreichen das so: + DIN~C6/5-Umschlägen trotzdem in das Adressfenster passt. Er + erreicht das so: \begin{lstcode} \begin{letter}{% Petra Mustermann\\ @@ -3270,10 +4699,12 @@ haben. neuen Brief kopieren zu müssen. Zu seiner Erleichterung schreibt er deshalb eine \File{lco}-Datei, die ihm die Arbeit erleichtert:% \lstinputcode[xleftmargin=1em]{ich.lco}% - Damit schrumpft sein Brief aus dem letzten Beispiel erheblich zusammen: + Damit schrumpft sein Brief aus dem Beispiel von + \PageRefxmpl{\LabelBase.letterwithoutlco} erheblich zusammen: \lstinputcode[xleftmargin=1em]{letter-23.tex}% - Das Ergebnis ändert sich jedoch nicht, wie \autoref{fig:\LabelBase.letter-23} - zeigt. + Das Ergebnis ändert sich dabei natürlich nicht, wie ein Vergleich von + \autoref{fig:\LabelBase.letter-22}, \autopageref{fig:\LabelBase.letter-22} + mit \autoref{fig:\LabelBase.letter-23} zeigt. \begin{figure} \setcapindent{0pt}% \begin{captionbeside}[{Beispiel: Brief mit erweitertem Absender, Logo, @@ -3297,7 +4728,9 @@ ein Paket zur Sprachumschaltung, beispielsweise für die neue, deutsche Rechtschreibung mit \Macro{usepackage}\POParameter{ngerman}\PParameter{babel}, noch bei älteren \LaTeX-Versionen ein Paket für die Eingabecodierung, beispielsweise mit \Macro{usepackage}\POParameter{utf8}\PParameter{inputenc} -für moderne Editoren, geladen ist. +für moderne Editoren, geladen ist. Wird mit Sicherheit eine \LaTeX-Version ab +April~2018 verwendet und wird die \File{lco}-Datei UTF-8 codiert, so können +Umlaute und Sonderzeichen natürlich auch direkt eingegeben werden. In \autoref{tab:lcoFiles} finden Sie eine Liste aller vordefinierten \File{lco}-Dateien. Falls\textnote{Achtung!} Sie einen Drucker verwenden, der @@ -3314,12 +4747,11 @@ der Einstellung \DescPageRef{\LabelBase.option.refline}). Sollten\textnote{Tipp!} Sie damit ein Problem haben, erstellen Sie sich eine eigene \File{lco}-Datei, die zunächst \Option{SN} lädt und in der -\DescRef{scrlttr2-experts.plength.toaddrhpos}\IndexPLength{toaddrhpos} (siehe -\autoref{sec:scrlttr2-experts.addressee}, -\DescPageRef{scrlttr2-experts.plength.toaddrvpos}) dann auf einen kleineren +\DescRef{\LabelBase.plength.toaddrhpos}\IndexPLength{toaddrhpos} (siehe +\DescPageRef{\LabelBase.plength.toaddrvpos}) dann auf einen kleineren Wert gesetzt wird. Verringern Sie dann außerdem -\DescRef{scrlttr2-experts.plength.toaddrwidth}\IndexPLength{toaddrwidth} -entsprechend.% +\DescRef{\LabelBase.plength.toaddrwidth}\IndexPLength{toaddrwidth} +entsprechend. Die\textnote{Tipp!}\phantomsection\label{tipp:\LabelBase.DIN} \File{lco}-Datei \File{DIN}\important{\Option{DIN}} wird übrigens immer als erste @@ -3327,6 +4759,16 @@ Die\textnote{Tipp!}\phantomsection\label{tipp:\LabelBase.DIN} \File{lco}-Datei weniger sinnvoll vordefiniert sind. Es ist daher nicht notwendig diese voreingestellte Datei selbst zu laden. +Zu den \File{lco}-Dateien \File{DIN5008A}\important{\File{DIN5008A}, + \File{DIN5008B}} und \File{DIN5008B} sei angemerkt, dass die entsprechenden +Vorschriften gewisse Spielräume aufweisen und, wie diversen Anfragen beim +Autor zu entnehmen ist, viele Anwender diese nicht nur auszureizen wünschen, +sondern auch die eine oder andere Abweichung von der Norm bevorzugen. Die +beiden Dateien implementieren jedoch jeweils nur eine einzige Interpretation +der Norm. Der Leser sei daher daran erinnert, dass diese Dateien lediglich als +Vorlagen zu begreifen sind, um das Erstellen eigener angepasster +\File{lco}-Dateien zu erleichtern.% +% \begin{desclist} \renewcommand*{\abovecaptionskipcorrection}{-\normalbaselineskip}% \desccaption{% @@ -3337,8 +4779,21 @@ voreingestellte Datei selbst zu laden. \oentry{DIN}{% \leavevmode% \IndexOption[indexmain]{DIN}\IndexFile[indexmain]{DIN.lco}% - 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)}% + voreingestellter 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)}% + \oentry{DIN5008A}{% + \leavevmode% + \IndexOption[indexmain]{DIN5008A}\IndexFile[indexmain]{DIN5008A.lco}% + experimenteller Parametersatz für Briefe angelehnt an Variante~A im Format + A4 nach DIN~5008; geeignet für Fensterbriefumschläge in den Formaten C4, + C5, C6 und C6/5 (C6 lang)}% + \oentry{DIN5008B}{% + \leavevmode% + \IndexOption[indexmain]{DIN5008B}\IndexFile[indexmain]{DIN5008B.lco}% + experimenteller Parametersatz für Briefe angelehnt an Variante~B im Format + A4 nach DIN~5008; geeignet für Fensterbriefumschläge in den Formaten C6 + und C6/5 (C6 lang)}% \oentry{DINmtext}{% \leavevmode% \IndexOption[indexmain]{DINmtext}\IndexFile[indexmain]{DINmtext.lco}% @@ -3356,10 +4811,10 @@ voreingestellte Datei selbst zu laden. \oentry{KOMAold}{% \leavevmode% \IndexOption[indexmain]{KOMAold}\IndexFile[indexmain]{KOMAold.lco}% - \iffalse + \iftrue% existiert nur noch aus Kompatibilitätsgründen; die Verwendung wird nicht mehr empfohlen% - \else + \else% Parametersatz für Briefe im Format A4 mit Annäherung an das Aussehen von Briefen der obsoleten Briefklasse \Class{scrlettr}; geeignet für Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang); es @@ -3368,8 +4823,7 @@ voreingestellte Datei selbst zu laden. definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei möglicherweise nicht genau wie bei Verwendung der übrigen \File{lco}-Dateien% - \fi - }% + \fi }% \oentry{NF}{% \leavevmode% \IndexOption[indexmain]{NF}\IndexFile[indexmain]{NF.lco}% @@ -3440,38 +4894,28 @@ voreingestellte Datei selbst zu laden. \leavevmode% \IndexOption[indexmain]{UScommercial9}% \IndexFile[indexmain]{UScommercial9.lco}% - 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/2\Unit{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}% + 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/2\Unit{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}{% \leavevmode% \IndexOption[indexmain]{UScommercial9DW}% \IndexFile[indexmain]{UScommercial9DW.lco}% - 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/8\Unit{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}% + 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/8\Unit{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{desclist} - -Beachten\textnote{Achtung!} Sie bitte noch, dass es nicht möglich ist, -innerhalb einer \File{lco}-Datei mittels \Macro{PassOptionsToPackage} Optionen -an Pakete zu übergeben, die von der Klasse bereits geladen sind. Normalerweise -betrifft dies nur die Pakete -\hyperref[cha:typearea]{\Package{typearea}}\IndexPackage{typearea}, -\hyperref[cha:scrlfile]{\Package{scrlfile}}\IndexPackage{scrlfile}, -\hyperref[cha:scrbase]{\Package{scrbase}}\IndexPackage{scrbase} und -\Package{keyval}\IndexPackage{keyval}.% % \EndIndexGroup % @@ -3582,7 +5026,6 @@ Datenbanksysteme möglich, solche Massenpostsendungen zu erstellen. \begin{lstcode} \documentclass{scrlttr2} \usepackage[ngerman]{babel} - \usepackage[utf8]{inputenc} \begin{document} \renewcommand*{\adrentry}[8]{% @@ -3673,7 +5116,7 @@ Argument einzufügen. \Class{scrlttr2} und \Package{scrletter} selbst ignorieren diese Anweisung ebenso wie \Macro{addrchar}. % \begin{Example} - Angenommen Sie haben folgende, eher winzige Adressdatei für die ein + Angenommen Sie haben folgende, eher winzige Adressdatei, für die ein Adressbuch erstellt werden soll: % In der folgenden lstcode-Umgebung je nach Umbruchbedarf einzelne % Elemente löschen oder hinzufügen. MICHAEL und GABRIEL sollten jedoch |