Programm zur Darstellung von gedcom Dateien mit Stammbäumen und Ahnenlisten im Internet und auf dem lokalen PC. Desweiteren eignet sich das Programm sehr gut, um es mit den genealogischen Daten auf CD zu schreiben und von dieser dann zu starten.

Inhaltsverzeichnis

neue Funktionen der Version 4.0:
-dynamische Fensteraufteilung
-neue Menüstruktur
-Wheelmouse
-Verwandtschaftanzeige
-erweiterte Texte
-erweiterter Datenschutz
-verbessertes Hilfesystem
-Paßwortanfrage
-Lokalisierung

Kurze Programmübersicht


Das Programm kann genealogische Daten, die in gedcom Dateien gespeichert sind, auf Ihrem lokalen PC oder im Internet als präsentieren, ohne daß die Daten in den Dateien modifiziert werden müssen. Wenn die gedcom Datei bei einzelnen Personen Verweise auf Bilder und Dokumente enthält, können diese durch ein einfachen Klick auf einen Link in einem eigenen Fenster ausgegeben werden.

Die Stammbäume und Ahnenlisten können als

ausgeben werden.

Während des Programmlauf ist es jederzeit möglich, zwischen den beiden Darstellungsformen und den beiden Ausgabeformaten zu wechseln.

Das Listenformat kann dazu benutzt werden, um alle Information zu einer Person zu bekommen, die in den Sätzen der gedcom Datei gespeichert ist. Die Grafikausgabe gibt einen guten Überblick über mehrere Generationen.

Es gibt mehrere Möglichkeiten innerhalb der aktuellen Ausgabe zu surfen. Zusätzlich zur aktuellen Ausgabe garantiert ein Index das schnelle Auffinden von speziellen Personen. Eine ausführliche Programmbeschreibung wird beim Start ausgeben und kann auch jederzeit angefordert werden.

Sie können das Programm lokal auf Ihrem System benutzen oder Sie stellen es zusammen mit Ihren gedcom Dateien auf Ihren Internet-Server, so daß jeder über das Web auf Ihren genealogischen Daten zugreifen kann. Es ist sehr einfach, das Programm zusammen mit Ihren Daten auf eine CD zu schreiben, die sie an die Verwandtschaft oder genealogische Forscher weitergeben können. Diese können dann das Programm direkt von der CD starten, ohne daß eine Installation notwendig ist.

Gedcom-Dateien enthalten vielfach sehr persönliche Daten, die mißbraucht werden können, wenn sie in falsche Hände fallen. Das Programm Ahn bietet Ihnen einen doppelten Schutz, wenn Sie Ihre gesamten Daten im Netz zur Verfügung stellen. Sie können jetzt Ihre gedcom Dateien verschlüsseln, so daß nur noch das Programm Ahn sie interpretieren kann. Ein einfaches Downladen Ihrer gedcom-Datei oder Ansehen mit einem Editor schützt Ihre Daten.

Desweiteren können Sie zusätzlich festlegen, zu welchen Daten allgemeine Netzbenutzer Zugang haben sollen. Das Programm bietet sechs Stufen der Sicherheit an. Durch entsprechenden Paßwortschutz können trotzdem berechtigte Benutzer auf sämtliche Daten zugreifen. Dazu sind keine Modifikationen an Ihren gedcom-Dateien notwendig.

Programmvoraussetzungen

Da das Programm Ahn ein Java-Programm ist, müssen Sie Ihren Browser so einstellen, daß das Starten von Java-Programmen zugelassen wird.

Die Version Ahn 4 setzt eine Java Version 1.4 oder größer voraus. Bei modernen Browsern wie Internet Explorer 6, Netscape 6, Mozilla 1 und Opera 7, die meistens zusammen mit Windows XP verwendet werden, muß die Java Version unabhängig vom Browser installiert worden sein. Wenn noch eine ältere Java Version installiert ist, ersetzen Sie die Java Version. Nach dem Download über die Seite Sun Java Download kann Java durch Ausführen der heruntergeladenen Datei installiert werden.

Die Version Ahn 4 enthält zusätzlich noch die Vorgängerversion Ahn 3, die mit jeder Java Version lauffähig ist, also z.B. auch mit Internet Explorer 4 bzw. 5 und Netscape 4.7x. In diesen Browsern ist die Java-Version 1.1 integriert und braucht deshalb nicht extra installiert worden zu sein. Sie können gezielt die Version Ahn 3 starten oder durch das Tool 'ahnSwitch' die geeignete Version auswählen lassen.

Beispiel: Stammbaum Braess

Der Start des Beispieles erfolgt über diesen Link. Wenn Sie sich mit Ihrem Browser den Quelltext dieser htm-Datei ansehen, erkennen Sie, wie einfach das Programm Ahn in eine Web-Seite zu integrieren ist.

Der Stammbaum ist ein Ausschnitt aus dem Stammbaum der Familie Braess, beginnend mit dem Stammvater Peter Braess und seinen Söhnen Peter und Elias. Gern können Sie sich auch die gesamte Stammfolge ansehen. Da dieser Ausschnitt keine lebenden Personen umfaßt, ist die gedcom-Datei Braess_a.ged unverschlüsselt, so daß Sie sich diese z.B. mit Ihrem Browser ansehen können.

Es ist empfehlenswert, das Browserfenster zu vergrößern, so daß es den gesamten Bildschirm einnimmt. Um durch die gesamte Liste zu scrollen, ist evt. der horizontale Scrollbar des Browsers zu bewegen, so daß der vertikale Scrollbar der Liste sichtbar wird.

Im Hilfefenster, wie auch im folgenden Abschnitt Programmbedienung , wird beschrieben, wie Sie in den Daten surfen können. Insbesondere möchte ich auf das Programmmenü und das Personenmenü mit dem '<->' Symbol bei jeder Person hinweisen, mit denen Sie die meisten Funktionen des Programmes aktivieren können.

Programmbedienung

Diese beschreibung bezieht sich auf die version Ahn 4.Die Beschreibung zur Version 3 kann nach dem Start über das Personenmenü angezeigt werden.

Download und lokale Installation

Wenn Sie das Programm mit Ihren genealogischen Daten testen möchten, können Sie es sich herunterladen. Ihre Daten müssen als gedcom-Datei zur Verfügung stehen.

Ich empfehle folgende Schritte für einen lokalen Test auf Ihrem PC:

Ihre genealogischen Daten werden im Stammbaumformat oder als Ahnenliste dargestellt. Das geöffnete Hilfefenster gibt wieder Hinweise zum Surfen in Ihren Daten.

Nach dem ersten Start des Programmes oder nach Änderungen an der gedcom Datei sollten Sie die Java Console anschauen, da dort Meldungen des Programmes abgelegt werden, z.B. nicht unterstützte Tags oder Zeilen der gedcom-Datei, die wegen ihres Formates nicht interpretiert werden konnten. Die meisten Meldungen werden mit der zugehörigen Zeilennummer der gedcom Datei versehen. Nicht unterstützte Tags werden nur beim ersten Auftreten protokolliert.

Die Aktivierung der Java Console ist abhänging vom verwendeten Browser, z.B. MS Internet Explorer oder Netscape Navigator/Communicator, und von der verwendeten Version des Browsers.

Ich wünsche Ihnen viel Erfolg und Freude bei dem Surfen in Ihren Daten.

Zur Deinstallation genügt das Löschen des verwendeten Dateiverzeichnisses. Es werden keine Daten innerhalb und außerhalb des Dateiverzeichnisses abgelegt. Auch die Registry wird nicht verändert.

Lokale Menüprogramme ahnStart

Die Menüprogramme ahnStart dienen zum schnellen und komfortablen Start des Programmes auf dem lokalen PC. Im einfachsten Fall ist nur der Name der gedcom-Datei einzutragen und das Programm über den Start-Button zu starten.

Das Menü gibt es in zwei Versionen:

Die Menüprogramme gestatten in einfacher Weise die verschiedenen Parameter der Programmes zu variieren, ohne html-Dateien zu editieren.

Über den Button htlm-Code kann der Code angezeigt werden, der für eine Internetpräsentation benötigt wird. Mit 'Cut and Paste' kann der Applet-Code direkt in die html-Datei kopiert werden.

Installation im Web

Wenn Sie Ihre genealogischen Daten auf einem Server bereitstellen wollen, damit sie im Internet zugreifbar sind, müssen Sie nur die folgenden Dateien auf Ihren Server kopieren:
-   AhnClass.jar
-   AhnLocal.txt
-   AhnLocalde.lcl
-   AhnLocalen.lcl
-   AhnLocalfr.lcl
-   AhnAhn.gif
-   AhnCode.class
-   ahnSwitch.class
-   ihre private gedcom Datei
-   ihre html Datei(en)

Vorher müssen Sie mir allerdings die URL Ihrer Homepage bzw. die Liste Ihrer URLs, wenn Sie Ihre Daten auf mehreren Servern bereitstellen wollen oder Ihr Server unter mehreren Adressen erreichbar ist, schicken, damit ich Ihnen einen speziellen Modul 'AhnCode.class' generieren kann, der den Start über Ihre Homepage erlaubt. Ohne einen speziellen Modul werden die Netzbenutzer die Fehlermeldung 'Registrierung für Internet fehlt' bekommen.

Falls Sie mehr als eine Datei und oder viele Bilder bereitstellen wollen, ist ein strukturierter Dateibaum zu empfehlen. Dabei ist zu beachten, daß die gedcom Dateien und Bilder im Dateiverzeichnis der Java-Module oder in Unterdateiverzeichnissen hierzu stehen.

Ältere Java Versionen

Die Version Ahn 4 setzt eine Java Version größer 1.4 voraus. Bei einem Browser, der eine ältere Version benutzt, misslingt der Start, so daß das Programm Ahn nicht ausgeführt wird. In diesem Fall kann die Version Ahn 3 gestartet werden.

Welche Java Version Ihr lokaler Browser unterstützt, können Sie am einfachsten mit der Browserversion von ahnStart feststellen. Nach dem Start des Menüprogrammes drücken Sie den Button 'Java Version'. Wenn Sie mehrere Browser installiert haben, können diese unterschiedliche Java Versionen benutzen.

Der Start des Programmes Ahn 3 unterscheidet sich nur im Code Parameter des applet Tags innerhalb der html Datei - s. Parameter des Programmes -, indem AhnApplet.class durch Ahn3Applet.class zu ersetzen ist. Ein beispiel finden Sie in der Datei ahn3.htm.

Das Programm ahnSwitch, das als Java Applet über eine html Datei gestartet wird, kann Ihnen helfen, das Programm Ahn in der richtigen Version einzusetzen. In den Parametern dieses Programmes geben Sie zwei html Dateien für die beiden Versionen an. Falls Ihre gedcom Datei die erweiterten Note Tags enthält, die noch nicht von Ahn 3 unterstützt wird, können Sie den Benutzer eine geeignete Meldung ausgeben. Falls Sie das Programm ahnSwitch ohne die beiden Parameter starten, zeigt es die aktuelle Java Version an.

Beispiel:
<APPLET code=ahnSwitch.class width=400 height=500>
<PARAM name=ahn4 value='ahn.htm'>
<PARAM name=ahn3 value='ahn3.htm'>
</APPLET>

Die Datei ahn.htm startet das Programm Ahn 4 und die Datei ahn3.htm das Programm Ahn 3. Die Datei ahn3.htm könnte auch eine Meldung enthalten, daß ihre genealogischen Daten leider mit der Browser/Java Kombination nicht darstellbar sind.

Doppelter Datenschutz

Gedcom-Dateien enthalten teilweise sehr persönliche Daten und nicht jeder Internetbenutzer soll den vollen Zugriff auf die Daten haben. Deshalb wird ein doppelter Datenschutz mit einer Verschlüsselung der gedcom-Dateien und einem Paßwortzugriff angeboten.

Jeder Internetbenutzer kann Ihre gedcom Dateien lesen und vom Internetserver herunterladen. Nach dem Start des Programmes kann er sich durch den Browser die aktuelle html-Seite anzeigen lassen. Innerhalb des Applet Aufrufes findet er den Namen der gedcom Datei. Wenn er diesen Namen in das URL Feld des Browsers einträgt, wird die gedcom Datei angezeigt und der Benutzer kann dann die Information abspeichern. Um dieses zu verhindern, kann Ihre gedcom Datei verschlüsselt werden.

Desweiteren legen Sie bei der Verschlüsselung fest, welche Daten der normale Netzbenutzer sehen soll und wie das Paßwort lautet, um auf alle Daten zugreifen zu können.

Verschlüsselungsprogramm

Die Datei Ahn.zip enthält jetzt das Programm AhnCrypt.exe -für Windows95 und WindowsNT- zum Verschlüsseln der gedcom Dateien, die als .cgd (crypted gedcom) abgelegt werden, und zur Festlegung des Netzzuganges mit Paßwort. Das Programm Ahn benutzt die interne Decrypt-Routine, wenn als gedcom Datei eine .cgd Datei zugewiesen wurde. Nur wer den Schlüssel kennt, der bei der Verschlüsselung verwendet wurde, kann die Information wieder entschlüsseln.

Ein Aufruf des Programmes AhnCrypt mit dem Parameter -hilfe liefert eine Beschreibung des Programmes zum Verschlüsseln/Entschlüsseln der Daten und der Festlegung des Netzzuganges mit Paßwort.

Der Aufruf aus einer DOS-Shell:

AhnCrypt -hilfe|-help
oder
AhnCrypt key datei [zugriff passwort]
-hilfe
-help
Es wird die Beschreibung des Kommandos zum Starten des Programmes ausgegeben
key: Invidueller Schlüssel zum Ver-/Entschlüsseln von gedcom Dateien
  • Verschlüsseln: numerischer Wert zwischen 1 und 2147483647
  • Entschlüsseln: negativer Wert vom Verschlüsseln
datei: gedcom Datei zum Ver-/Entschlüsseln ohne Index
  • Verschlüsseln: Eine Datei mit dem Index .ged muss existieren, eine Datei mit dem Index .cgd wird erzeugt/überschrieben.
  • Entschlüsseln: Eine Datei mit dem Index .cgd muss existieren, eine Datei mit dem Index .ged wird erzeugt/überschrieben
zugriff: Der Zugriff legt fest, welche Information der gedcom-Datei als Standardausgabe ausgegeben wird. Folgende Zugriffsmodi sind möglich: ALL| LIVING_NODATA| LIVING_NONOTES| ALL_NODATA| ALL_NONOTES| PRIVATE
passwort: Paßwort für die Ausgabe der gesamten gedcom Information.

Zugriffsmodi:
ALL: Alle Benutzer können ohne Paßwortschutz sämtliche Daten Ihrer gedcom-Datei sehen. Diese Variante ist zu empfehlen, wenn die gedcom-Datei nur Vorfahren und Ahnen von Ihnen enthält.
LIVING_NODATA: Die Benutzer ohne Paßwortkennung erhalten sämtliche Daten Ihrer gedcom-Datei ausgenommen von lebenden Personen - geboren nach 1900 und es gibt keine Sterbedaten-, von denen die Geburts- und Hochzeitsdaten (Ort und Datum), Adressen sowie die Bilder unterdrückt werden. Diese Variante ist sehr gut geeignet, wenn auch Familienangehörige der aktuellen Generation in der gedcom-Datei enthalten sind.
LIVING_NONOTES: Gegenüber LIVING_NODATA wird für lebende Personen nur noch der Name ausgegeben. Ergänzende Agaben zur Person - NOTE Tags der gedcom-Datei - sind wie die Geburts- und Hochzeitsdaten nur über Paßwortzugriff erhältlich.
ALL_NODATA: Die Geburts-, Sterbe- und Hochzeitsdaten und Adressen aller Personen der gedcom-Datei sind nur mit Kenntnis des Paßwortes erhältlich. Ebenso werden keine Verweise auf Bilder ausgegeben.
ALL_NONOTES:Die Standardausgabe ohne Paßwortkenntnis enthält nur die Namen der Personen. Als Ahnenforscher möchten Sie, daß sich interessierte Genealogen an Sie wenden, um nähere Angaben zu den Personen, evt. durch Paßwortvergabe, zu erhalten.
PRIVATE: Ihre gedcom Daten sind nur Netzbenutzern, z.B. Familienangehörige, Freunde und spezielle Ahnenforschern, zugänglich, denen Sie das Paßwort mitgeteilt haben. Ihre gedcom Datei enthält viele sehr persönliche Information, die nur der Familie, die evt. sehr weit gestreut ist, zugänglich sein soll.
Beispiele für Verschlüsselung:
Die zugrunde liegenden gedcom Dateien sind in allen Fällen dieselben. Für alle Beispiele ist das Paßwort einheitlich 'AhnCrypt'.

Parameter des Programmes

Die einfachste Methode, die Parameter für den Start festzulegen, ist eines der beiden ahnStart Menüs zu benutzen und sich über den Button den html Code anzeigen zu lassen. Dieser Code kann dann mit Drag-and-Drop in die html Datei kopiert werden.

Das Applet Tag für das Programm Ahn innerhalb einer htm-Datei hat folgende Syntax:

<APPLET [codebase=pfad] archive=AhnClass.jar code=AhnApplet.class height=höhe width=breite MAYSCRIPT>
<PARAM name=gedfile value='gedcom-Datei'>
[<PARAM name=base value='Basisnummer'>]
[<PARAM name=lang value='Sprache'>]
[<PARAM name=help value='off'>]
[<PARAM name=index value='off'>]
[<PARAM name=password value='off'>]
[<PARAM name=date value='Datumsformat'>]
[<PARAM name=logo value='logo-Datei'>]
[<PARAM name=background value='Hintergrundfarbe'>]
</APPLET>

Es muß mindestens der Parameter gedfile existieren, die weiteren Parameter sind optional.Die Parameter können in beliebiger Reihnfolge definiert werden. Die htm-Datei kann selbstverständlich beliebig weitere htm Tags enthalten.

Unterstützte Systeme

Das Programm ist auf allen Systemen ablauffähig, deren Browser Java unterstützen und die lange Dateinamen mit Groß- und Kleinschreibung zulassen.
Da Java korrekte Dateinamen erwartet, muß beim Extrahieren ein geeignetes zip Programm verwendet werden. Bei Windows 95/98/NT/XP kann das Programm winzip verwendet werden. In Linux ist häufig unzip integriert.

Falls kein geeignetes unzip Programm zur Verfügung steht, evt. bei Linux, OS/2, ... , kann über
http://www.cdrom.com/pub/tex/ctan/tools/zip/info-zip/Info-ZIP.html
ein unzip Programm geladen werden.

Wegen der kurzen Dateinamen der Systeme Windows 3.1/3.11 ist das Programm leider nicht auf diesen Systemen ablauffähig.

Große gedcom Dateien

Moderne Prozessoren mit einer Taktfrequenz von über 1 GHz und die neuste Browsergeneration, die Java 1.4 verwenden, gestatten es auch, in großen gedcom Dateien mit dem Programm Ahn zu surfen. Lokal habe ich schon mit einer 5,8 MB gedcom Datei mit über 25000 Personen und 10000 Familiensätzen gearbeitet. Für das Internet sollten derart große gedcom-Dateien vermieden werden, denn selbst bei einer sehr guten DSL Verbindung dauert das Lesen einige Minuten.

Zur Zeit können gedcom-Dateien mit maximal 30000 Personen- und 12000 Familiensätze verarbeitet werden. Die Ahnenliste darf 120000 Zeilen nicht überschreiten.

Bei großen gedcom Dateien von einigen 100 K kann der Start in Abhängigkeit von der Prozessorleistung, Datenübertragung und Java-Version des Browsers etwas dauern, bis die erste Liste auf dem Bildschirm erscheint. Ebenso wird bei einem Wechsel zwischen Stammbaum und Ahnenliste einige Rechenzeit benötigt, die jedoch ab der Java-Version 1.3 der Browser stark reduziert wurde. Die Reaktionszeit innerhalb eines Stammbaumes oder Ahnenliste, auch beim Wechsel zwischen Listenform und Grafik, ist auch bei großen Dateien sehr gut.

Bitte bedenken Sie, wenn Sie gedcom-Dateien ins Internet stellen, daß nicht alle Internetbesucher über modernstes Equipment verfügen. Prozessoren mit 300 Mhz, Datenverbindungen mit 28.8 KBaud und Browser mit Java 1.1 ( z.B. Netscape 4.7 und Internet Explorer 4.0 ) sind noch weit verbreitet. Schlechte Reaktionszeiten durch zu große gedcom-Dateien verärgert die Besucher Ihrer Seiten.

Bei großen Datenmengen empfiehlt sich eine Aufteilung in mehrere gedcom Dateien, z.B. die Nachkommen oder Vorfahren einer Person in eigene gedcom Datei. Ich habe z.B. meine Daten in 14 Dateien aufgeteilt. Erst seit kurzem biete ich auch mit entsprechendem Hinweis meine gesamten genealogischen Daten von 850 KB als Gesamtdaten an.

Größe des Monitors

Die Ausgabe des Programmes kann an die Bildschirmgröße angepaßt werden, so daß möglichst der rechte Scrollbar des Programmes sichtbar ist, wenn der Browser die gesamte Monitorfläche nutzt. Seit der ersten Version des Programmes, als der Standardmonitor der 14" Monitor mit 640 x 480 Pixel war, ist die Entwicklung der Monitore weitergegangen, so daß heute der Durchschnittsmonitor mit 17" eine Auflösung von 1024 x 768 besitzt. Einzelne Monitore habe auch eine Auflösung von 1680 und mehr für die Bildschirmbreite.
Die Anzahl der darstellbaren Generationen im Grafikbereich wird durch den width Parameter bestimmt. Durch das Ausschalten des Indexbereiches kann die Anzahl mindestens um eins erhöht werden. Auch eine Verschiebung der Trennlinie verändert die Anzahl der Generationen.

Bei eingeschaltetetem Indexbereich gilt nach dem Start folgende Zuordnung zwischen dem width Parameter und der Generationenanzahl:
WidthGenerationenanzahl
600 - 7403
750 - 8904
900 - 10405
1050 - 11906
1200 - 13407
1350 - 14908
1500 - 16409
1650 - 179010

Version 3:
Bei den unteren Werten eines width Bereiches wird ein kleiner Indexbereich, der nicht verändert werden kann, angelegt, so daß nur ein Kurzname, bestehend aus dem Rufname und dem Hauptname des Nachnamens, gelistet werden kann. Bei dem oberen Wert wird ein größerer Indexbereich verwendet, so daß in den meisten Fällen der gesamte Name aufgenommen werden kann. Bei einem zu langen Namen werden evt. außer dem Rufnamen die weiteren Vornamen weggelassen.
Wenn eine htm-Datei ins Internet gestellt wird, empfiehlt es sich, eine Breite für 4 bis 6 Generationen zu verwenden, da ungewiß ist, welche Monitorgröße der Internetbenutzer verwendet. Bei Integration des Programmes in eine umfangreiche Internetseite sind teilweise kleinere Werte zu empfehlen.

Zuordnung von Bildern/Dokumenten und Internetseiten

Eine Ahnenliste bzw. eine Familienchronik wird erst lebendig und wertvoll, wenn zusätzlich zu den Daten noch Bilder und Kopien von Dokumenten und Verweise auf Internetseiten abgelegt werden. Die Internetverweise können global sein, z.B. die Homepage der Person, oder auch lokal. Durch eigene lokale Internetseiten zu Personen können die Gestaltungsmöglichkeiten des Internets voll genutzt werden, um die Informationen zu präsentieren. Die Links zu den Bildern und Internetseiten werden in den Listenformen des Stammbaumes und Ahnenliste ausgegeben. Durch einen Klick auf die Links werden die Bilder geladen oder die Internetseiten in einem eigenen Browserfenster gestartet. Jedes Bild wird in einem eigenem Fenster mit Titel und Unterschrift ausgegeben. Wenn ein Titel definiert wurde, wird er zusätzlich zum Link in der Liste ausgegeben, so daß mehrere Bilder oder Internetseiten zu einer Person unterschieden werden können.

Das Programm Ahn unterstützt die Definition des gedcom Standards, die auch von einigen Erfassungsprogrammen benutzt werden. Eine Objektdefinition des gedcom Standard besteht aus folgenden Tags:
1 OBJE
2 TYPE #optional
2 TITL #optional
2 FILE
2 NOTE #optional
TYPE: Beschreibt den Typ des Objektes. Wird z.Zt. nicht ausgewertet, sollte evt. auf 'Image' gesetzt werden, um später zwischen verschiedenen Objekttypen zu unterscheiden.
TITL: Überschrift zum Bild. Der Titel wird auch zur Erläuterung des Links in der Liste verwendet.
FILE: Name der Bilddatei oder URL der Internerseite.
Der Name der Bilddatei, die im gif- oder jpg-Format vorliegen kann. Wenn die Datei nicht im Dateiverzeichnis der Javaprogramme liegt, ist der relative Pfadname mit anzugeben. Wie bei der gedcom-Datei muß das Dateiverzeichnis unterhalb des Dateiverzeichnisses der Javaprogramme liegen.
Die Namen der Bilddateien dürfen Blanks enthalten. Bei anderen Sonderzeichen, z.B. Umlauten, kann es bei einigen Bowsern passieren, daß die Bilddateien bei Internetbetrieb nicht gefunden werden.

Die URL der Interseite kann als weltweite Internetseite, beginnend mit http:, angegeben werden oder als lokale htm-/html-Datei, die relativ zum Dateiverzeichnis der Java Module anzugeben ist.

NOTE: Unterschrift zum Bild. Ein langer Text wird evt. in mehrere Zeilen aufgebrochen. Bei Internetseiten ist dieser Tag ohne Bedeutung.
Das folgende Beispiel enthät für Hans Musterfamilie zwei Dokumente und einen Verweis auf eine Homepage.

Auszugsliste

Der Eigentümer der gedcom-Datei entscheidet, ob der Internetbenutzer die Möglichkeit haben soll, Auszugslisten aus den gedcom-Daten zu erstellen und diese dann mit Hilfe des Browsers weiter zu verarbeiten, z.B. abzuspeichern oder auszudrucken.

Wenn das applet Tag in der html-Datei um die Spezifikation MAYSCRIPT -in Großbuchstaben- erweitert wird, z.B.
<APPLET archive=AhnClass.jar code=AhnApplet.class width=900 height=600 MAYSCRIPT>
so wird dem Internetbenutzer im Pulldownmenü zu jeder Person ein weiterer Menüpunkt 'Auszugsliste' angeboten. In einem zweiten Schritt kann der Benutzer die Anzahl der gewünschten Generationen auswählen. Je nach der aktuellen Darstellungsform - Ahnenliste oder Stammbaum - wird eine Auszugsliste für die ausgewählte Person in einem separaten Fenster erstellt. Die Auszugsliste enthält die Information, die dem Benutzer auch durch das Javaprogramm angeboten werden, so daß auch die Auszugsliste die durch die Verschlüsselung verborgenen Daten nicht enthält. Bilder werden nicht in die Auszugsliste aufgenommen.

Der Benutzer muß im Browser zusätzlich zu Java auch die Javascript Ausführbarkeit aktivieren.

Beim Starten von Ahn als Java Application - direkt mit dem Kommando 'java -cp AhnClass.jar' AhnApplic ... ' oder indirekt über das Menüprogramm ahnStart in der Java Application Version - können keine Auszugslisten im Menü angeboten werden.

Lokalisierung

Nach dem Download ist die deutsche Sprache voreingestellt. Die Voreinstellung einer anderen Sprache kann durch Aufruf einer der batch Dateien 'english', 'francais' oder 'deutsch' geändert werden.

Das Programm enthält Lokalisierungsdateien für deutsch (AhnLocalde.lcl), englisch (AhnLocalen.lcl) und französich (AhnLocalfr.lcl), sowie die Datei AhnLocal.txt, die entsprechend der eingestellten Sprache mit einer der sprachspezifischen Dateien identisch ist. Durch Ändern der Sprache wird auch das richtige htm Menüprogramm ahnStart eingestellt.

Eine Anpassung an weitere Sprachen kann leicht erreicht werden, indem neue Lokalisierungsdateien AhnLocalxx.lcl, z.B. für dänisch, ungarisch, spanisch, ... oder eine neue Voreinstellungsdatei hinzugefügt werden. Diese Lokalisierungsdateien können durch den Parameter 'lang' im applet Statement verwendet werden.

Wenn Sie eine eigene Lokalisierungsdatei in einer anderer Sprache erstellen wollen, wenden Sie sich bitte an mich, damit ich Ihnen ein paar Hinweise zum Übersetzen der Lokalisierungsdateien geben kann.

Erstellung einer CD/Diskette

Neben der lokalen Darstellung eignet sich das Programm sehr gut, um es zusammen mit Ihren Daten auf eine CD zu brennen. Diese können Sie an Ihre Verwandtschaft weitergeben, ohne daß Sie gegen Lizenzen verstoßen. Ihre Verwandten können durch einen Doppelklick auf eine index.htm Datei auf der CD das Programm Ahn mit Ihren Daten mit dem voreingestellten Browser starten. Dazu ist keine Installation, kein Kopieren irgendwelcher Dateien oder ein Internetzugang notwendig.

Kreieren Sie eine Datei index.htm mit folgendem Inhalt, wenn Ihr lokales Dateiverzeichnis, das das Programm und die gedcom Datei enthält, ahn heißt. Der Aufruf der Datei index.htm bewirkt ein sofortiges Weiterschalten auf Ihre eigentliche htm Datei, in diesem Fall ahn.htm im Dateiverzeichnis ahn.

<html>
<head>
<meta http-equiv="refresh" content="0; URL=ahn/ahn.htm">
</head>
</html>

Kopieren Sie das Dateiverzeichnis ahn und die Datei index.htm auf die CD. Sie brauchen nur die Dateien aus dem Dateiverzeichnis ahn auf die CD zu kopieren, die auch zum Internetserver transferiert werden müssen. Wenn Sie evt. noch eine readme Datei hinzufügen, haben Ihre Verwandten keine Schwierigkeiten, sich die Familiendaten anzusehen.

Wenn Ihre gedcom Datei nicht allzu groß ist und nur wenige Verweise auf Bilder enthält, kann evt. auch eine 3.5" Diskette genügen, da die Programmdateien nur ca 270 KB Speicher belegen. Für Ihre gedcom Datei und Bilder stehen noch ca. 1 MB zur Verfügung.

Unterstützte gedcom Tags

Nach dem gedcom Standard sind auch Note Rerenzdefinitionen auf der Stufe 0 möglich und ein Note Tag kann auf diese Referenzen verweisen. Diese Note Definition wird ab Ahn 4 unterstützt.

Es werden nicht alle gedcom Tags unterstützt. Eine vollständige Liste wird demnächst hier veröffentlicht. Es werden keine Tags, die mit '_' beginnen, unterstützt.
Auf der Java Console, die je nach Browser unterschiedlich eingeschaltet werden kann, wird protokolliert, welche Tags aus der aktuellen gedcom Datei nicht unterstützt werden. Die mit '_' beginnenden Tags werden nicht protokolliert.

Java Console

Nach dem ersten Start des Programmes oder nach Änderungen an der gedcom Datei sollte die Java Console angeschaut werden, da dort Meldungen des Programmes abgelegt werden, z.B. nicht unterstützte Tags oder Zeilen der gedcom-Datei, die wegen ihres Formates nicht interpretiert werden konnten. Die meisten Meldungen werden mit der zugehörigen Zeilennummer der gedcom Datei versehen.
Die Aktivierung der Java Console ist abhänging vom verwendeten Browser, z.B. MS Internet Explorer oder Netscape Navigator, und von der verwendeten Version des Browsers.

Start als Java Application

Lokal kann das Programm auch als Java Application gestartet werden. Dazu ist ein Java Laufzeitsystem oder ein Java-Plugin für moderne Browser notwendig. Der große Vorteil gegenüber dem Start mit einem Browser liegt darin, daß Sie die Größe des Fensters des Programmes während der Laufzeit beliebig vergrößern oder verkleinern können. Bei Start über einen Browser wird die Größe durch die width und height Parameter festgelegt.

Am einfachsten geschieht dieses durch den Aufruf der Batch-Datei 'ahnStart.bat' und Benutzung des Startmenüs. In einer DOS-Shell kann das Programm wie folgt gestartet werden:

java -cp AhnClass.jar AhnApplic [-lang=de | en | fr] [-help=off] [-logo=datei | -] [-password=off] [-date=ddmmyyyy | mmddyyyy | ddmmmyyyy1 | ddmmmyyyy2] [-background=#......] [-index=off] gedcom-Datei [Basisperson]

Die Parameter sind im Abschnitt Parameter des Programmes beschrieben.

Wenn der Start nicht aus dem Dateiverzeichnis erfolgt, in dem die Java-Module, die gedcom-Datei und Logo-Datei liegen, sollte der vollständige Pfadname der Dateien, z.B. c:\temp\data\gedcom\ahn.ged, angegeben werden.


Anregungen, Ergänzungen und Korrekturen bitte an:

Helmut Braess     -bitte Betreff nicht löschen, sondern evt. ergänzen-


München, August 2006