\documentstyle[german,12pt,makeidx]{script} \input{briefini.tex} \makeindex \parindent0em \parskip2ex \begin{document} % \batchmode \title{Dokumentation zu Brief.STY} \author{Gundolf Frank\footnotemark} \footnotetext[1]{\begin{tabular}[t]{ll} Tel.: &++49 (0)241/532520\\ E-Mail:&Gundolf\_Frank@AC.maus.de \end{tabular}} \maketitle \tableofcontents \chapter{Einfhrung} Der Brief-Style ist eine Mischung aus dem orginal Letter-Style von Leslie Lamport, den Erweiterungen von Helmut Kopka aus \cite{Kopka}. Da ich immer noch einige Sachen vermiáte, habe ich diese erweitert. Am meisten st”rte mich, daá der "`Luxus"' einer Adressverwaltung mit Serienbrieffunktion unter \TeX\ noch nicht verwirklicht worden ist. Dies konnte doch jedes andere popelige Textverarbeitungsprogramm\footnote{Ich weiá, daá \TeX\ keine Textverarbeitung ist, sondern ein Textsatzsystem; trotzdem wird es von vielen -auch von mir- als Ersatztextverarbeitung benutzt.}, also hatte ich mir eingebildet, daá \TeX dies auch k”nnen muáte. Und so ist dann dieser Style entstanden.\par Da es viele geben wird, die zwar die Serienbrief- und Adressbuchfunktion m”gen, aber die ganzen anderen Funktionen nicht m”gen, habe ich die Serienbrieffunktion noch in einen eigenen Style eingepackt. Dieser heiát "`Serienbr.STY"'.\par Nun viel Spaá beim Briefeschreiben -mit oder ohne meinen Brief-Style!\par Gundolf Frank \chapter{Allgemeine {\em Variablen} und {\bf Befehle}} \section{{\bf $\backslash$begin\{letter\}}} {\bf Syntax:} $\backslash$begin\{letter\}[Suchkriterum]\{Adressat\}\par Markiert den Beginn eines Briefes an {\em Adressat\/} und beginnt eine neue Seite \section{{\bf $\backslash$end\{letter\}}} {\bf Syntax:} $\backslash$end\{letter\}\par Markiert das Ende eines Briefes \section{{\bf $\backslash$opening} oder {\bf $\backslash$anrede}} {\bf Syntax:} $\backslash$opening[Abkrzungen]\{Name\}\\ {\bf Syntax:} $\backslash$anrede[Abkrzungen]\{Name\}\par Die beiden Befehle "`$\backslash$anrede"` oder "`$\backslash$opening"' haben die selbe Funktion. Sie setzen die Anrede ber dem Brief.\\ Im Namen kann entweder der ganze Text stehen, wenn keine Abkrzung angegeben ist, oder nur der Vor- oder Nachname.\\ Wenn keine Abkrzung angegeben ist, k”nnen die eckigen Klammern wegfallen.\par Folgende Abkrzungen stehen zur Auswahl:\\ \begin{tabular}{lll} &Anrede &und dazugeh”rige Gruáformel\\ sgdh &Sehr geehrte Damen und Herren, &Mit freundlichen Gráen\\ l &Liebe {\em "`Name"'}, &Mit $\heartsuit$-lichen Gráen\\ lr &Lieber {\em "`Name"'}, &Mit $\heartsuit$-lichen Gráen\\ ls &Liebes {\em "`Name"'}, &Mit $\heartsuit$-lichen Gráen\\ sgh &Sehr geehrter Herr {\em "`Name"'},&Mit freundlichen Gráen\\ sgf &Sehr geehrte Frau {\em "`Name"'}, &Mit freundlichen Gráen\\ sgH &Sehr geehrte Herren, &Mit freundlichen Gráen\\ sgF &Sehr geehrte Damen, &Mit freundlichen Gráen\\ sgs &Sehr geehrtes {\em "`Name"'}, &Mit freundlichen Gráen\\ {\em leer} &{\em "`Name"'} &Mit freundlichen Gráen \end{tabular}\par In Zusammenarbeit mit dem Adressbuch werden die Anrede entsprechend dem Geschlecht und dem Kontakt gesetzt:\\ \begin{tabular}{cll} Geschlecht & Kontakt & Anrede \\ w & herzlich & Liebe {\em "`Name"'},\\ & formal & Sehr geehrte Frau {\em "`Name"'},\\ m & herzlich & Lieber {\em "`Name"'},\\ & formal & Sehr geehrte Frau {\em "`Name"'},\\ n & & Sehr geehrte Damen und Herren,\\ \end{tabular} \section{{\bf $\backslash$closing} oder {\bf $\backslash$gruss}} \label{Gruss} {\bf Syntax:} $\backslash$closing\{Text\}\\ {\bf Syntax:} $\backslash$gruss\{Text\}\par Die beiden Befehle "`$\backslash$gruss"` oder "`$\backslash$closing"' haben die selbe Funktion. Sie setzen den Abschluágruá unter den Brief. Wie schon bei "`$\backslash$anrede"' oder "`$\backslash$opening"' k”nnen auch hier wieder Abkrzungen eingegeben werden. Sie werden anstatt des Textes plaziert.\par \begin{tabular}{ll} mfg& Mit freundlichen Gráen\\ mHg& Mit $\heartsuit$-lichen Gráen\\ mhg& Mit herzlichen Gráen\\ al& Alles Liebe\\ mvdiv& Mit vielem Dank im voraus \end{tabular} \section{{\bf $\backslash$ps}} {\bf Syntax:$\backslash$ps}\par Setzt ein {\em Postskriptum} \section{{\bf $\backslash$cc} oder {\bf $\backslash$kopiean}} {\bf Syntax:$\backslash$cc\{Text\}}\\ {\bf Syntax:$\backslash$kopiean\{Text\}}\par Setzt eine Verteilerliste (Eintr„ge durch $\backslash\backslash$ abgetrennt) \section{{\bf $\backslash$encl} oder {\bf $\backslash$anlagen}} {\bf Syntax:$\backslash$encl\{Text\}}\\ {\bf Syntax:$\backslash$anlagen\{Text\}}\par Setzt eine Anlagenliste (Eintr„ge durch $\backslash\backslash$ abgetrennt) \section{{\em $\backslash$greetings}} \label{greetings} {\bf Syntax:} $\backslash$def $\backslash$greetings\{Text\}\par In dieser Variable steht entweder die unter Punkt \ref{Gruss} auf Seite \pageref{Gruss} genannten Abkrzungen oder eine ausgeschriebene eigene Grussformel. Diese Variable dient eigentlich fr die Bestimmung der Grussformel bei Serienbriefen. \chapter{Pers”nliche einmalige Einstellungen} Die hier beschriebenen Einstellungen werden einmalig in "`Briefini.\TeX"' eingestellt. \section{{\em $\backslash$@myref} und {\bf $\backslash$myref} oder {\bf $\backslash$meinzeichen}} {\bf Syntax:} $\backslash$def $\backslash$@myref\{Text\}\\ {\bf Syntax:} $\backslash$myref\{Text\}\\ {\bf Syntax:} $\backslash$meinzeichen\{Text\}\par Hier wird das Krzel des Absenders geschrieben. \section{{\em $\backslash$bilddateiname}} {\bf Syntax:} $\backslash$def $\backslash$bilddateiname\{Text\}\par \label{Bild} Wenn ein Bild fr die rechte obere Ecke vorhanden ist, wird er in diese Variable gespeichert. Ist hier keiner eingetragen, bleibt auch die obere Ecke weiá. Das Bild muá mit BM2Font\footnote{siehe auch die Anleitung zu BM2Font} umgewandelt worden sein.\\ Z.B. existiert das Bild Logo.PCX als PCX-Datei. Dann wird dies mit BM2Font mit\\ \verb+ BM2Font -fBilddateiname.pcx+\\ \verb+ -hAufl”sungX+\\ \verb+ -vAufl”sungY+\\ \verb+ -mSollbreite+\\ \verb+ -nSollh”he+\\ und auf das Beispiel bezogen:\\ \verb+ BM2Font -fLogo.pcx -h360 -v360 -m15mm+\\ Dies erzeugt die Dateien Logo.\TeX, LogoA.TFM, LogoA.PK. Es k”nnen jedoch auch weitere *.TFM und *.PK, wenn das Bild zu groá ist, um in einen Zeichensatz zu passen. Dies werden dann mit LogoB.TFM bzw LogoB.PK usw. benannt. \section{{\em $\backslash$unterschriftdateiname}} {\bf Syntax:} $\backslash$def $\backslash$unterschriftdateiname\{Text\}\par Wenn eine eingescannte und wie bei Kapitel \ref{Bild} umgewandelete Unterschrift vorhanden ist, wird dies hier eingetragen. Sobald die Variable leer ist, wird keine Unterschrift gedruckt. \section{{\em $\backslash$dateinameadresse}} {\bf Syntax:} $\backslash$def $\backslash$dateinameadresse\{Text\}\par Dateiname, aus der die Adressen genommen werden sollen. \section{{\em $\backslash$fromsig}} {\bf Syntax:} $\backslash$def $\backslash$fromsig\{Text\}\par Der Inhalt der Variable wird unter die Unterschrift bzw. den Platz der dafr vorgesehen ist, gesetzt. \section{{\em $\backslash$fromname}} {\bf Syntax:} $\backslash$def $\backslash$fromname\{Text\}\par Text der rechts oben auf dem Briefkopf erscheint. \section{{\em $\backslash$fromstreet}} {\bf Syntax:} $\backslash$def $\backslash$fromstreet\{Text\}\par In Text steht die Straáe der Absenderadresse. \section{{\em $\backslash$fromlocation}} {\bf Syntax:} $\backslash$def $\backslash$fromlocation\{Text\}\par $\ldots$ und der Ort. \section{{\em $\backslash$fromaddress}} {\bf Syntax:} $\backslash$def $\backslash$fromaddress\{Text\}\par $\ldots$ und nochmal die komplette Adresse. Sie besteht meistens aus $\backslash$fromname, $\backslash$fromstreet, $\backslash$fromlocation. \section{{\em $\backslash$telephonnum}} {\bf Syntax:} $\backslash$def $\backslash$telephonnum\{Text\}\par $\ldots$ und Absendertelefonnummer. \section{{\em $\backslash$fax}} {\bf Syntax:} $\backslash$def $\backslash$fax\{Text\}\par $\ldots$ und die Faxnummer. \section{{\em $\backslash$email}} {\bf Syntax:} $\backslash$def $\backslash$email\{Text\}\par $\ldots$ und die E-Mail-Adresse. \section{{\em $\backslash$precode}} {\bf Syntax:} $\backslash$def $\backslash$precode\{Text\}\par $\ldots$ Vorwahl fr Absendertelefon- und Faxnummer. \section{{\em $\backslash$bankname}} {\bf Syntax:} $\backslash$def $\backslash$bankname\{Text\}\par Name der Bank, bei der der Absender sein Konto hat. \section{{\em $\backslash$blz}} {\bf Syntax:} $\backslash$def $\backslash$blz\{Text\}\par $\ldots$ und deren Bamkleitzahl. \section{{\em $\backslash$ktonr}} {\bf Syntax:} $\backslash$def $\backslash$ktonr\{Text\}\par $\ldots$ und zuletzt die Kontonummer. \chapter[Im Brief zu definierende {\em Variablen} und {\bf Befehle}]{Benutzerdefinierte {\em Variablen} und {\bf Befehle}, die im Brief gesetzt werden} \section{{\em $\backslash$@yref} und {\bf $\backslash$yref} oder {\bf $\backslash$ihrzeichen}} {\bf Syntax:} $\backslash$def $\backslash$@yref\{Text\}\\ {\bf Syntax:} $\backslash$yref\{Text\}\par {\bf Syntax:} $\backslash$ihrzeichen\{Text\}\par \section{{\em $\backslash$@ymail} und {\bf $\backslash$ymail} oder {\bf $\backslash$ihrnachrichtvom}} {\bf Syntax:} $\backslash$def $\backslash$@ymail\{Text\}\\ {\bf Syntax:} $\backslash$ymail\{Text\}\\ {\bf Syntax:} $\backslash$ihrnachrichtvom\{Text\}\par \chapter[Sprachabh„ngige Variablen]{Sprachabh„ngige Variablen in Briefini.\TeX} An diesen Variablen braucht normalerweise nichts eingestellt zu werden. \section{$\backslash$myrefname} \section{$\backslash$yrefname} \section{$\backslash$ymailname} \section{$\backslash$subjectname} \section{$\backslash$myrefname} \section{$\backslash$anredekurzo$\ast$} \section{$\backslash$anredeo$\ast$} \section{$\backslash$anredekurz$\ast$} \section{$\backslash$anredea$\ast$} \section{$\backslash$grusskurz$\ast$} \section{$\backslash$gruss$\ast$} \chapter{Serienbrief\/\/funktion} \index{Serienbrief} \begin{quote} {\bf Serienbrief} \cite{LexikonderInformatik}\\ Teilgebiet: Textverarbeitung und Broautomation\\ Synonym: Massenpost\\ \\ Serienbriefe werden erstellt, wenn an unterschiedliche Personen „hnliche Informatioenen bermittelt werden sollen. Dabei sind von Brief zu Brief nur geringe Unterschiede (z.B. die Anrede und Adresse) vorhanden. Der Vorgang des Einlesens der Werte in die Briefe wird Mischen genannt. \begin{flushright} Richter \end{flushright} \end{quote} \newpage \section{Adressbuch} Fr eine Serienbrieffunktion sollte ein Adressbuch vorhanden sein, aus dem die Adressen herausgesucht werden. Diese sehen beim Style "`Serienbrief"' und beim Style "`Brief"' gleich aus.\\ Hier ein Beispiel: \begin{verbatim} --- Mustermann Marcus Karl \& Sohn GmbH Buchhaltung Teststr.1 04711 Duftstadt 0815/47\,11 0815/47\/12 Marcus_Mustermann@K.maus.de Marco 10.06.57 m herzlich --- Mustermann Brigitte Teststr.2 0815 Duftstadt 0815/12\,15 Biggi 10.11.23 w herzlich \end{verbatim} usw.\par Neue Adressen fangen immer mit "`--\,--\,--"' an.\par Jede Adresse hat folgende Eintr„ge: \begin{verbatim} --- Nachname Vorname Firmenname Abteilung Strasse Ort Telefonnummer Faxnummer E-Mailadresse Cosename Geburtsdatum Zusatz 1 Zusatz 2 Geschlecht Kontakt \end{verbatim} Die meisten Begriffe erkl„ren sich von selbst. Hier noch einige Erg„nzungen: \begin{itemize} \item {\em Nachname:}\\ Wenn unter "`Firma"' etwas eingetragen ist, kommt in der Anschrift "`z.H."' hinzu. \item {\em Abteilung:}\\ Wenn dieser Eintrag ausgefllt wird, wird in der Anschrift dieser unter der Firma mit dem Zusatz "`Abteilung "' ausgegeben. \item {\em Cosenamen:}\\ Wenn unter "`Kontakt"' "`herzlich"' eingetragen ist, wird bei der Anrede nicht der Vorname, sondern der Cosename eingetragen. Ist dieser leer, wird der Vorname genommen. \item {\em Zusatz 1:}\\ Hat bisher keine Funktion. Kann daher fr eigene Zwecke benutzt werden, z.B. Faxnummer. \item {\em Zusatz 2:}\\ Hat bisher keine Funktion. Kann daher fr eigene Zwecke benutzt werden. \item {\em Geschlecht}\\ Wie der Name schon sagt, ist dieser Eintrag fr die Unterscheidung des Geschlechtes:\\ "`w"' weiblich\\ "`m"' m„nnlich\\ "`n"' neutral\\ \item {\em Kontakt}\\ Hiermit wird das Verh„ltnis zwischen Briefschreiber und Empf„nger angegeben: \begin{itemize} \item "`herzlich"'\\ Es wird eine pers”nliche Anrede und Grussformel angegeben, z.B. "`Liebe Biggi"' und "`Mit $\heartsuit$-lichen Gráen"'. \item "`formal"'\\ Es wird eine unpers”nlichere Anrede und Grussformel angegeben, z.B. "`Sehr geehrte Frau Mustermann"' und "`Mit freundlichen Gráen"'. \end{itemize} \end{itemize} Zwischen dem letzten Eintrag einer Adresse (Kontakt) kann noch beliebiger Text folgen. Wichtig ist nur, daá die n„chste Adresse mit "`--\,--\,--"' anf„ngt.\par Die verschiedenen Felder stehen im Text auch zur Verfgung. Sie werden ber folgende Variablen aufgerufen: \begin{verbatim} \nachname \vorname \firma \abteilung \strasse \ort \tel \fax \email \cosename \geburtsdatum \paraer \parazw \geschlecht \kontakt \end{verbatim} \pagebreak {\em Beispiel 1:} Im Feld $\backslash$paraer soll die 2.Telefonnummer stehen. Wenn nun eine 2. Nummer vorhanden ist, soll dies im Text stehen. \begin{verbatim} \ifx\paraer\empty Ein 2. Telefonanschlu\3 ist nicht vorhanden. \else Ein 2. Telefonanschluá ist unter der Nummer \paraer zu erreichen. \fi \end{verbatim} {\em Beispiel 2:} Bei den Briefen soll unterschieden werden, ob die angesprochene Person ge"`sie"'st wird. \begin{verbatim} \def\test{herzlich} Wenn \ifx\kontakt\test Du \else Sie \fi morgen kommen \ifx\kontakt\test k"onntest, \else k"onnen, \fi w"urde ich mich sehr freuen. \end{verbatim} Durch diese Abfragen sind natrlich sehr indviduelle Briefe m”glich. Es sieht zwar sehr kompliziert aus, ist aber ein sehr m„chtiges Werkzeug fr Serienbriefe. Weiteres aber unter Kapitel \ref{Aufruf und Funktion} auf Seite \pageref{Aufruf und Funktion}. \section{Aufruf und Funktion} \label{Aufruf und Funktion} {\bf Syntax:} $\backslash$serienbrief[Suchkriterium]\{Suchtext\}\par Folgende {\em Suchkriterien} stehen zur Verfgung:\par \begin{tabular}{l@{ fr die Suche in }l} {\em Nachname} & \verb+\nachname+\\ {\em Vorname} & \verb+\vorname+\\ {\em Firma} & \verb+\firma+\\ {\em Abteilung} & \verb+\abteilung+\\ {\em Straáe} & \verb+\strasse+\\ {\em Ort} & \verb+\ort+\\ {\em Telefonnummer} & \verb+\tel+\\ {\em Faxnummer} & \verb+\fax+\\ {\em E-Mail} & \verb+\email+\\ {\em Cosename} & \verb+\cosename+\\ {\em Geburtsdatum} & \verb+\geburtsdatum+\\ {\em Zusatz 1} & \verb+\paraer+\\ {\em Zusatz 2} & \verb+\parazw+\\ {\em Geschlecht} & \verb+\geschlecht+\\ {\em Kontakt} & \verb+\kontakt+ \end{tabular}\par {\em Suchtext} kann jede beliebige Zeichenfolge sein, die in dem Suchkriterium vorkommen soll.\\ Mit der Variable \verb+\greetings+ kann die Abschluágruáformel gesetzt werden. Siehe dazu auch unter Kapitel \ref{Gruss} auf Seite \pageref{Gruss} und Kapitel \ref{greetings} auf Seite \pageref{greetings}.\par \subsection{Beispiele:} \verb+\serienbrief[Geschlecht]{w}+ schreibt einen Brief mit dem Text $\backslash$text an alle Frauen, die in der Adressdatei stehen.\\ \verb+\serienbrief{Frank}+ schreibt einen Brief mit dem Text $\backslash$text an alle die den Nachnamen "`Frank"' haben. \chapter{Geschichte} \begin{itemize} \item \underline{2.3.94} 0.53$\beta$\\ Kleinere Žnderungen:\\ Schriftgr”áe 10pt jetzt auch m”glich.\\ Bei Serienbriefen kann jetzt auch ein eigene Gruáformel gesetzt werden.\\ Faxnummer und E-Mailadresse ist jetzt in der Adressenliste hinzugekommen.\\ In der Adressendatei brauchen nicht mehr die \% hinter jeder Zeile erscheinen. \item \underline{28.2.94} 0.52$\beta$\\ Kleinere Žnderungen:\\ Bei Kontakt kann jetzt nur noch "`m"', "`w"', "`n"' angegeben werden.\\ Ungewollte Kontrollausgabe bei Serienbrief ist weggefallen.\\ Fehler bei nicht angegebenen Nachnamen behoben.\par Erste Version der Anleitung.\par Die Serienbrief\/funktion gibt es nun auch einzeln, um sie auch mit anderen Letter-Styles zu benutzen. \item \underline{26.2.94} 0.51$\beta$\\ Kleinere Žnderungen:\\ Seitenl„nge wird bei der Angabe der vollen Adresse in der Fuázeile angepaát.\\ Neu:\\ Bei der Faxoption wird jetzt in der Statuszeile die Gesamtseitenzahl angegeben. \item \underline{24.2.94} 0.50$\beta$\\ Erste offizelle Betaversion\\ Neu: Serienbrief\/funktion \item \underline{15.1.94} 0.4$\beta$\\ Interne Version Neu: Adressbuchfunktion \item \underline{20.10.92} 0.1$\beta$\\ Interne erste Version\\ \end{itemize} \begin{appendix} \bibliographystyle{plain} \bibliography{brief} \printindex \end{appendix} \end{document}