\documentclass{article}
\usepackage{german}

\title{Address guide\\Version 1.2}
\author{Axel Kielhorn}
\date{1. November 1999}
\begin{document}

\maketitle

\section{Einleitung}

Anfang 1996 kam in \texttt{comp.text.tex} die Frage nach einer 
Adressdatenbank auf Basis von Bib\TeX\ auf. Die einzige Antwort kam 
von \textsc{Gerd Neugebauer}, der 1994 ein Datenbankformat definiert 
hat und mit Hilfe einer \texttt{bst} und einer \texttt{tex} Datei 
daraus ein recht komplexes Datenbanksystem gebaut hat.

Das Datenbankformat hat mir sehr gut gefallen, die Styles hatten nur 
einen Nachteil, sie waren nicht zu \texttt{dir.tex} bzw. 
\texttt{scrlettr.cls} kompatibel.

\section{Ein \texttt{bib} nach \texttt{adr} Konverter}

Um nicht alle Arbeiten doppelt zu machen, wollte ich das von 
\textsc{Frank Neukam} entwickelte \texttt{adr} Format weiterbenutzen.  
Also mu"sten die Informationen aus der Datenbank entsprechend 
aufbereitet werden.  Das Sortieren der Eintr"age "ubernimmt dann 
Bib\TeX.

Da ich mich bereits fr"uher mit Bib\TeX\ Programmierung besch"aftigt 
habe, war bereits nach einem Nachmittag der erste Bib\TeX\ Style 
fertig.  Nat"urlich ohne Kommentare und Anleitung.  Dementsprechend 
gering war auch das Interesse an den Dateien.

Nachdem auch das Problem mit dem \verb+\adrchar+ gel"o"st war, kam der 
Wunsch nach einem Geburtstagskalender auf.  Da es sehr viele 
verschiedene M"oglichkeiten gibt, ein Datum zu schreiben, habe ich ein 
zus"atzliches Feld f"ur das numerische Geburtsdatum definiert.  Das 
l"a"st sich maschinell viel einfacher auswerten und l"a"st auch 
Geburtstage wie "`Vorletzter Januar"' oder "`Ostersonntag"' zu.  
(obwohl es bei letzterem Schwierigkeiten beim Sortieren geben 
d"urfte) Inzwischen gibt es noch einen \texttt{email} Style, der 
anstelle der Telephonnummer die e-mail Adresse ausgibt. Da Adressen 
im Maus-Netz Unterstriche enthalten k"onnen, mu"s der Unterstrich in 
dem Style deaktiviert werden.

\section{Endspurt}

Anfang 2000 soll eine neue KOMA-Script-Version herauskommen. Da 
Markus wenig Zeit hat, bat er mich, die Bibstyles zur Adressverwaltung 
als eigenst"andiges Paket herauszubringen. Dies ist daher die erste 
Version die unabh"angig von KOMA-Script erscheint. Das ADRconv-Paket 
besteht zur Zeit aus 4 BibTeX-Programmen:

\begin{description}
	\item[adrconv]  Ein Konvertierer zum Erstellen von Adressb"uchern.

	\item[adrfax]  Ein Konvertierer zum Erstellen von Faxb"uchern.

	\item[birthday]  Ein Konvertierer zum Erstellen von Geburtstagslisten.

	\item[email]  Ein Konvertierer zum Erstellen von E-Mail Verzeichnissen.
\end{description}


\section{Anwendung}

Bib\TeX\ erwartet eine \texttt{aux}-Datei aus der es Informationen 
"uber die zu verwendende Datenbank und den gew"unschten Bibstyle 
herauslie"st. Im einfachsten Fall l"a"st sich so eine Datei von Hand 
erstellen:

\begin{verbatim}
    \citation{*}
    \bibstyle{addrconv} % oder adrfax, birthday, email
    \bibdata{example}   % koennen auch mehrere Dateien sein
\end{verbatim}

\verb+\citation{*}+ w"ahlt alle Eintr"age der Datenbank aus, 
\verb+\bibstyle+ den gew"unschten Stil und \verb+\bibdata+ die 
Datenbank(en). Es k"onnen auch mehrere Datenbanken gleichzeitig 
ausgew"ahlt werden. Dadurch kann man private und berufliche Adressen 
in unterschiedlichen Datenbanken pflegen und bei Bedarf eine 
gemeinsame Adressliste erstellen.

Die von Bib\TeX\ erstellte \texttt{bbl} Datei mu"s dann nur noch in 
\texttt{adr} umbenannt werden und schon kann sie mit \texttt{dir.tex} 
in ein Adressbuch umgewandelt werden. Das beiligende \texttt{adrdir.tex} 
enth"alt eine etwas modifizierte Version von \texttt{dir.tex}. Diese 
Version kann "uber Konfigurationsdateien f"ur verschiedene Formate 
angepa"st werden:

\begin{description}
    \item[adrdir]  Das Originalformat aus \texttt{dir.tex}, die 
    Einzelseiten sind DIN A6 gro"s und k"onnen so platzsparend auf DIN 
    A4 ausgedruckt werden.

    \item[adrschmal]  Ist ein etwas schmaleres Format, das in viele 
    Taschenkalender pa"st, z. B. in den Kalender den mir meine 
    Sparkasse jedes Jahr schenkt.

    \item[adrplaner]  Diese Woche hatte Aldi einen Taschenkalender im 
    Angebot, wie "ublich auch mit Adressbuch. Aber warum soll ich 
    jetzt alle Adressen von Hand eintragen, also mu"ste eine neue 
    Konfigurationsdatei her. Die sollte problemlos auch in andere 
    Organizer passen. (Ich w"urde mich "uber R"uckmeldungen freuen.)
\end{description}

In den Konfigurationsdateien befinden sich auch die Parameter f"ur 
DVIDVI, damit man die Einzelseiten problemlos auf ein Blatt A4 
verteilen kann. 

\section{Das Datenbankformat}

\begin{verbatim}
@address{RalfK,
   name =         {Ralf Kielhorn},
   title =        {MdE},
   organization = {nicht organisiert},
   city =         {Braunschweig},
   country =      {D -},
   zip =          38118,
   street =       {Stra{\ss}e des 17.~Juni 17},
   phone =        {0531 / 12 34 56},
   fax =          {0531 / 65 34 21},
   mobile =       {0171 / 34 56 78},
   url =          {http://www.kielhorn.de/ralf/index.html}
   email =        {Ralf{@}kielhorn.de},
   key =          {Rki},
   birthday =     {05.08.1969},
   nbirthday =    0805,
}
\end{verbatim}

Die \texttt{ADRconv} Bibstyles benutzen 
den \verb+@address+ Typ, der von "`normalen"' Bibstyles nicht 
verwendet wird. Dadurch ist es m"oglich, Adressen in eine normale 
Datenbank zu integrieren. (Z.\,B. die Adresse eines Authors oder 
Verlages). Version 1.2 des Formates benutzt folgende Felder:

\begin{description}
	\item[name]  Der Name im normalen Bib\TeX\ Format: Vorname von 
	Nachname

	\item[title] Akademischer Titel oder "ahnliches (Wird z.\,Zt.  
	nicht unterst"uzt)
	
	\item[organization] Organisation, Firma, Gewerkschaft, Verein 
	(Wird z.\,Zt.  nicht unterst"uzt)
	
	\item[city]  Stadt
	
	\item[country] Das L"anderkennzeichen (Wird z.\,Zt.  nicht 
	unterst"uzt)

	\item[zip]  Postleitzahl (ZIP-Code ist die US Bezeichnung)

	\item[street]  Stra"se

	\item[phone]  Telephonnummer
	
	\item[mobile] Zweite Telephonnummer, z.\,B. f"ur Mobiltelephon

	\item[fax] Telfaxnummer, wird von \texttt{adrfax.bst} zum 
	Erstellen eines Telefaxbuches verwendet.
	
	\item[email] E-mail Adresse, wird von \texttt{email.bst} zum 
	erstellen eines E-mail Verzeichnisses benutzt.
	
	\item[url] Ein Link auf die Homepage. Hier w"are jetzt ein Konverter 
	nach HTML gefragt.
	
	\item[key]  Das K"urzel unter dem der betreffende Name in 
	\texttt{scrletr} aufgerufen werden kann

	\item[note]  Notiz (Wird z.\,Zt. nicht unterst"uzt)
	
	\item[birthday] Geburtstagstext, so wie er gedruckt wird
	
	\item[nbirthday] Numerischer Geburtstag, wird zum Sortieren 
	verwendet. Format: Monat zweistelig Tag zweistellig (MMDD)
\end{description}

\section{Disclaimer}

Die angegebenen Adressen und Telephonnummern sind nat"urlich nicht echt.

\end{document}
