Verwendung von GED2WWWF.EXE

ACHTUNG! 
WENN SIE IHRE GED2WWWF-VERSION AKTUALISIEREN (D.H. SIE RUFEN DIE VERSION 1.5 ODER 1.5.1
DAS ERSTE MAL AUF), LSCHEN SIE DIE DATEI GED2WWWF.DAT -- ODER UNVORHERSEHBARES 
VERHALTEN KANN AUFTRETEN.

Dieses 'Liesmich' ist zuerst am 17. Oktober 1998 erstellt worden.
Letzte Aktualisierung am 26. Juni 2000.


Wesentliche nderungen (Versionen 1.4 und 1.5)
----------------------------------------------
Option zwischen "klassischer Darstellung" oder "Darstellung mit Tabellen".
Option, Daten auf den Seiten nach rechts einrcken zu lassen.
Option, ob die Listen ORTE/NACHNAME & NACHNAMEN/ORTE erzeugt werden sollen oder nicht.
Dnische Version (Dank an Hans Albeck).
Schwedische Version (Dank an Gilles Delorme und Carl Sparrenius)
Option, ob Referenzen (REFN), Bemerkungen (NOTE) und Beruf (OCCU) gedruckt werden sollen.
Die Sortierreihenfolge ist jetzt an die akzentuierte Buchstaben Westeuropische Sprachen 
angepasst.
Option, Sosa-Nummmern zu drucken.

Copyright
---------
Dieses Programm ist Freeware; Sie knnen es weitergeben und/oder modifizieren,
solange Sie die Bestimmungen der 'GNU General Public License' anerkennen, die
von der Free Software Foundation herausgegeben wird. Auf jeden Fall unterliegt
dieses Programm dem Copyright.
Bitte beachten Sie das COPYING-Dokument, das von der Free Software Foundation
verffentlicht wurde.

Den Quellcode dieses Programmes knnen Sie erhalten von:
  Jean-Baptiste Fahy
  jbfahy@nordnet.fr

Dieses Programm wurde ursprnglich von Leslie Howard geschrieben.


Ausfhren von GED2WWWF.EXE
--------------------------
Diese Programmversion luft in einem Windows 95/98/NT/2000-DOS-Fenster.
Unter Windows NT oder 2000 muss das Programm Sort.exe (normalerweise im Verzeichnis 
C:\Winnt\System32) vorhanden und in einem DOS-Fenster ausfhrbar sein.
Das Programm bentigt die Datei TEXTE.TXT im Arbeitsverzeichnis. Diese Datei enthlt die 
Texte in der Sprache Ihrer Wahl. Bis heute wurden Franzsich, Englisch, Hollndisch, 
Dnisch und Deutsch herausgegeben.

Fr franzsische Texte ndern Sie FRANCAIS.TXT in TEXTE.TXT um.
Fr englische Texte ndern Sie ENGLISH.TXT in TEXTE.TXT um.
Fr hollndische Texte ndern Sie NEDERLND.TXT in TEXTE.TXT um.
Fr deutsche Texte ndern Sie GERMAN.TXT in TEXTE.TXT um.
Fr dnische Texte ndern Sie DANSK.TXT in TEXTE.TXT um.

GED2WWWF verwendet eine Datei im GEDCOM-Format.

Es erzeugt (sofern es nicht schon existiert) ein Unterverzeichnis namens HTML im aktuellen
Verzeichnis.
GED2WWWF stellt einige Fragen und erstellt anschlieend die HTML-Seiten in dem 
HTML-Verzeichnis. Die Bearbeitungsparameter knnen gespeichert werden (in der Datei 
'ged2www.dat'), um sie in spteren Durchlufen erneut verwenden zu knnen.

Das besondere Eigenschaft von Ged2wwwf ist die Fhigkeit, eine Liste mit den 'Orten und
den dortigen Nachnamen' und eine Liste mit den 'Nachnamen und den Orten, in denen sie
vorkommen', zu erzeugen. Die Orte dieser Listen knnen nach Ihrem Wunsch sortiert werden.
Beachten Sie den Hinweis 'Orte sortieren'.

Ged2wwf kann Fotos (im JPEG-Format) fr eine jede Person einfgen. Dies geschieht
automatisch, indem das Vorhandensein einer Datei I<n>.JPG in dem HTML-Unterverzeichnis
berprft wird, wobei <n> der Position einer Person in der Gedcom-Datei entspricht 
(Beispiel: Wenn die Datei I1.JPG existiert, werden ihre Inhalte bei den Daten der Person 
@I1@ der GEDCOM-Datei gezeigt. Vorsicht: Die I<n>.JPG-Dateien mssen in demselben 
Verzeichnis wie ihre HTML-Dateien liegen.) Vergessen Sie nicht, sie zur selben Zeit wie 
die HTML-Dateien zu bertragen. Denken Sie daran, da das Einfgen von Fotos die Ladezeit 
Ihrer Seiten vergrert.

GED2WWWF wird die Datei BOTTOM.TXT - sofern vorhanden - am Ende einer jeden erzeugten Seite
(ausgenommen der Hauptseite) einfgen. Dies kann einigen von Ihnen helfen, die 
Vereinbarungen mit ihren Internet-Service-Providern haben, um so einige Zustze auf ihren 
Seiten mit einzufgen.

Sie knnen die Gre der HTML-Seiten mit dem Parameter "Anzahl der Familien pro 
Ausgabedatei" einstellen. Ein kleiner Wert erzeugt kleinere Dateien fr die Daten-, 
Index-, Orte/Nachnamen- und Nachnamen/Orte-Seite.

Sie knnen ein Hintergrundbild angeben und die Informationen auf den erzeugten Seiten nach 
rechts einrcken lassen. Versuchen Sie beispielsweise "reliure.gif" als Hintergrund, und 
whlen Sie "Daten auf Seiten nach rechts einrcken".


"Liste clair"
--------------
From 1.5.5 version, Ged2wwwf generates again the 'Liste clair' file.
Ged2wwwf generates, in the default directory, the LISTEECL.TXT file, a 'Liste clair'
build according to your GEDCOM file.
In order to complete this file, GED2WWWF needs your locations declarations to like:
<town> (<state>)
For the present, the parenthesis are needed to isolate the town from the state.

Benennung Ihrer Homepage
------------------------
Fgen Sie kein 'http://' vor Ihrer Homepage ein. Geben Sie einfach ein:
  home.nordnet.fr/~jbfahy
wenn Ihre Hompepage lautet:
  http://home.nordnet.fr/~jbfahy


Orte sortieren
--------------
Die Antwort auf die Frage 'Geben Sie die Sortierungsmethode fr Orte ein' erlaubt Ihnen,
die Orte in der 'Orte/Nachnamen'- und 'Nachnamen/Orte'-Seite nach Wunsch zu sortieren, 
sofern Ihre Orte alle dieselbe Struktur haben.
Um nach Staat/Stadt zu sortieren:
- wenn Ihre Orte gem 'Stadt,Staat' kodiert sind, geben Sie '2,1' ein,
- wenn Ihre Orte gem 'Stadt (Staat)' kodiert sind, geben Sie '2(1)' ein,
Um nach Land/Staat/Stadt zu sortieren und die Gemeinden zu unterdrcken:
- wenn Ihre Orte gem 'Gemeinde,Stadt,Staat,Land' kodiert sind, geben Sie '0,3,2,1' ein.

'0' bedeutet, ein Feld zu unterdrcken.
Die gezeigten Felder knnen Werte zwischen 1 und 9 erhalten.
Als Abgrenzungszeichen knnen Sie alles auer Leerzeichen, Buchstaben und Ziffern verwenden.

Version 1.5 erlaubt, zwischen interner oder externer Sortierung zu whlen. Die interne 
Sortierung bentigt sehr, sehr, sehr lange Zeit (mehrere Stunden, wenn Ihre GEDCOM-Datei 
mehrere tausend Personen enthlt). Whlen Sie interne Sortierung NUR, wenn Sie die 
Orte-/Nachnamen-Seiten nicht durch externe Sortierung erhalten.


Bemerkung zur Datei TEXTE.TXT
-----------------------------
1- GED2WWWF bentigt unbedingt die Datei TEXTE.TXT im aktuellen Verzeichnis. Wenn sie nicht
vorhanden ist, werden Sie folgende Meldung erhalten:

Fatal : Fichier des messages manquant
Fatal : Missing messages file

Den Rest dieses Abschnitts knnen Sie berlesen, wenn Sie die Datei TEXTE.TXT nicht ndern
wollen.

2- Sie knnen die Inhalte der Datei ndern, um Seiten in Ihrer eigenen Sprache zu erzeugen
oder um einige nderungen am Text vorzunehmen. Beispiel: Wenn Sie die Anzeige des Geschlechts
von Personen ndern wollen, ndern Sie einfach die Zeilen 218 und 219.
218#<BR>(weiblich)
219#<BR>(mnnlich)
Wenn Sie zustzlich das Geschlecht in derselben Zeile wie den Namen der Person erscheinen 
lassen wollen, lschen Sie einfach den HTML-Code <BR> aus den Zeilen 218 und 219.

3- Falls nach Modifikationen in TEXTE.TXT das Programm nicht mehr richtig luft, schreiben
Sie mir nicht sofort ... Machen Sie von der vorhergehenden Datei ein Backup, modifizieren 
Sie sie Schritt fr Schritt und berprfen Sie alle nderungen.

4- GED2WWWF erzeugt einen Copyright-Text auf der Hauptseite. Diese Meldung IST NICHT in
der TEXTE.TXT vorhanden. Sie ist in franzsisch, falls der dritte Buchstabe der Zeile 200 
ein 'F' ist, ansonsten in Englisch.

5- Die Zeile 200 ist wichtig: der erste Buchstabe steht fr JA (J), der zweite fr NEIN (N).
Sie knnen einen Buchstaben ihrer Wahl verwenden, zum Beispiel SN fr italienischen
Text (SI and NO). Denken Sie daran: Diese Zeile mu in Grobuchstaben geschrieben werden.
Vergessern Sie auerdem nicht, die Texte der Fragen zu verndern:
'Mchten Sie fortfahren (J/N) ?' sollte umgewandelt werden in:
'Mchten Sie fortfahren (O/N) ?', falls Sie ON als die ersten zwei Buchstaben der Zeile 200
whlen. 

6- Die Nummern in der Datei TEXTE.TXT knnen in beliebiger Reihenfolge erscheinen. Versuchen
Sie aber, doppelte Nummern zu vermeiden. Nur die letzte solcher Nummern wrde verwendet 
werden, aber Sie wrden einigen Speicher verschwenden.

7- Unterdrcken Sie niemals eine Zeilennummer. Das Programm knnte abstrzen.

8- Einige Zeilen enthalten Codes wie z.B. '%s', or '%7li'. Belassen Sie diese Codes, sie
ermglichen die Darstellung einiger Variablenwerte.
ALLGEMEIN GESAGT, ergnzen Sie KEINE Zeichen wie diese, das Programm knnte abstrzen oder
merkwrdig reagieren.

9- Die franzsche Version enthlt Akzente, in DOS, Windows oder HTML-Format entsprechend.
Dies kann berflssig aussehen, wenn Sie die Datei auflisten. Wenn Sie Akzente in die
201 und mehr Zeilen einbringen, beachten Sie das HTML-Format:
'&eacute;' for '', etc.

10- Keine Sorge, es ist leicht, diese Datei zu verndern. Wenn Sie auslndische Versionen
erstellt haben, knnen Sie mir diese senden, ich werde sie in der nchsten Ausgabe mit 
beifgen.


Wie bersetzt man die Monate ?
------------------------------
Die GEDCOM-Dateien haben blicherweise Datumsformate wie z.B. '14 AUG 1948'. Sie knnen
diese nun nach '14 August 1948' bersetzen (oder 14 aot 1948, wenn Sie wollen).
Die ENGLISH.TXT-Datei enthlt die 'bersetzungen' fr die 12 Monate JAN FEB ... und 
ABT (about) BEF (before) und AFT (after).
Diese bersetzungen sind in den M<nn>-Zeilen der ENGLISH.TXT-Datei (die Sie in TEXTE.TXT 
umbenennen mssen).
Sie knnen andere bersetzungen hinzufgen, wenn notwendig. Wenn Sie ein Datum wie
z.B. BET 1885 AND 1887 (between 1885 and 1887) haben, ergnzen Sie die folgenden Zeilen:
M16#BET#between
M17#AND#and
Sie knnen die Zeilen M1 bis M40 benutzen.
Die Zeilen M1 bis M12 sind (im Augenblick) nicht fr die 12 Monate
reserviert, werden es aber vielleicht spter sein.


Sosa-Nummern
------------
Warnung: diese Mglichkeit ist nur whlbar, wenn Sie die Darstellung mit Tabellen whlen.
Als erstes mssen Sie whlen, welche Person die Sosa-Nummer 1 haben soll. 
Diese Person mssen Sie sich in Ihrer GEDCOM-Datei ansehen und sich die entsprechende 
(alphanumerische) Nummer merken (das ist die Angabe zwischen den zwei @ in der Zeile 
@xxx@ INDI direkt vor der Beschreibung der Person).
Wenn Sie GED2WWWF ausfhren und die Frage, ob Sosa-Nummern gedruckt werden sollen, mit Ja 
beantwortet haben, mssen Sie als nchstes die entsprechende Nummer fr Sosa 1 angeben. 
Achten Sie, wenn Buchstaben in der Nummer vorkommen, auf Gro-/Kleinschreibung.


Notizen (NOTE) drucken
----------------------
Die Notizen und Quellenangaben (NOTEs und SOURces) werden gleich behandelt; sie werden auf 
der Stufe der Person oder der Familie gedruckt -- nicht auf der Stufe des Ereignisses, zu 
dem sie angegeben sind. Indirekte Aufrufe von NOTEs oder SOURces werden nicht verarbeitet 
(Beispiel: 2 NOTE @N1@).

Wenn Sie NOTEs (und SOURces) drucken, knnen Sie whlen:
1 - druckt NOTEs auf den Datenseiten (wenn alle Ihre Notizen kurz sind)
2 - druckt alle NOTE-Eintrge in separate HTML-Seiten
3 - druckt kurze NOTE-Eintrge in die Datenseiten, lange Notizen in separate Seiten.

Bei Auswahl 1: antworten Sie mit 0 (Null) auf die 2 Fragen zu den Grenangaben
Bei Auswahl 2: antworten Sie mit 1 (Eins) auf die 2 Fragen zu den Grenangaben, dann geben 
               Sie die Anzahl der Notizen pro Seite an.
Bei Auswahl 3: geben Sie die Gre (in Zeilen und Zeichen) an, die dazu fhrt, dass eine 
               Notiz in einer separaten Datei auftaucht; dann geben Sie die Anzahl Notizen
               pro separater Datei an. 

Die Parameter Zeilen und Zeichen erlauben Ihnen, das Aussehen Ihrer Seiten zu steuern. 
Beispiel: Sie knnen whlen, einen NOTE-Eintrag in einer separaten Datei auszugeben, wenn 
der Eintrag mindestens 5 Zeilen oder mindestens 200 Zeichen gro ist.


Bemerkungen
-----------
Die Zeichencodierung der GEDCOM-Datei kann ANSI, ANSEL oder IBMPC (DOS) sein.


Bekannte Probleme
-----------------
DOPPELTE PERSONEN #
Das Programm hlt an, falls Ihre GEDCOM-Datei dieselbe Referenz-Numemr fr 2 Personen 
enthlt.

INKONSISTENZ IN FAMILIEN
Wenn Ihre GEDCOM-Datei angibt, dass Paul John's Sohn ist, aber nicht angibt, dass John 
Paul's Vater ist, hlt GED2WWWF an.

Seit Version 1.5: Wenn Inkonsistenzen in der GECOM-Datei entdeckt werden, wartet GED2WWWF 
darauf, dass Return gedrckt wird, bevor es abbricht. Das erlaubt zu sehen, was passiert 
ist.


Untersttzung
------------
Wenn Sie irgendwelche Probleme bei der Benutzung dieses Programms haben oder gewisse
Verbesserungen wnschen, schreiben Sie mir einfach (jbfahy@nordnet.fr)
Wenn sich Ihre Anfrage mit der Zeit, die ich fr dieses Programm habe, vereinbaren lsst,
wird sie schnell bercksichtigt.


nderungshistorie
-----------------
Version 0.22, 11. Januar 1998
Erstellt basierend auf Leslie Howard's Quelltext (0.22).
Franzsisch aussehendes Programm.
Fehlerbeseitigung: Personen ohne jegliche Verbindung werden nun dargestellt.
Erstellung der Nachnamen/Orte- und Orte/Nachnamen-Listen.

Version 0.1jbf, 2. Mrz 1998
Ergnzung der 'Liste clair'.

Version 0.2jbf, 21. Mrz 1998
Hinzufgen der Anzahl der Geburten und Tode in der Orte-/Nachnamen-Liste.
Orte werden bei lebenden Personen nicht mehr gezeigt.

Version 1.0f&w, 5. Juli 1998
Automatische Erzeugung des HTML-Unterverzeichnisses.
Internationalisierung: Texte befinden sich in der Datei TEXTE.TXT
Parameter werden in der Datei GED2WWW.DAT gespeichert (Danke, Frank Waarsenburg).
Es knnen Fotos eingefgt werden (Danke, Frank Waarsenburg).
Hinzufgen der Datei BOTTOM.TXT in die erzeugten Seiten (Frank Waarsenburg, nach einer
Idee von John Hitcock).
Temporre Dateien werden nun bei Programmende gelscht.
Der Grobuchststabe Y wird nun (so hoffe ich) korrekt behandelt (Hinweis an Marie-Claiere
Bauche).
'Heiraten' 'Eltern' und 'Kinder' sind nun fett dargestellt (nach einer Idee von Guy
Gasiorowski).
Automatische Erzeugung des HTML-Unterverzeichnisses (jetzt funktioniert es ...) und Lschung
mglicher *.htm und *.txt Dateien in diesem Verzeichnis.
Sortierungsmglichkeit fr die Nachnamen/Orte- und Orte/Nachnamen-Liste.
IBMPC-Codierung (i.A. DOS) wird akzeptiert, mit akzentversehenen Buchstaben.

Version 1.2f&w
bersetzung der Monate (nach einer Idee von vielen von Ihnen, und besonders Paul-Marc Heudre,
der auf Vielem bestand ;-))
Nur das erste NAME-Feld einer Person wird betrachtet, das/die nchste(n) wird/werden 
ignoriert (betrachtet als Spitzname).
Links auf Index-Seiten auf jeder Index-Seite (nach einer Idee von Jean-Louis Mejecaze).
Die Liste der Nachnamen ist hervorgehoben: Zeilenvorschub nach nderung des 
Anfangsbuchstabens. nach einer Idee von Alain Bourreau).
Link auf die Hauptseite am Ende der Nachnamen/Orte- und Orte/Nachnamen-Liste.
Das kleine y sollte nun richtig behandelt werden.

Version 1.3f&w, 28. November 1998
Heiratsdaten in den Orte-/Nachnamen- und Nachnamen-/Orte-Seiten.
Steuerung der Seitengre (Index-, Orte-/Nachnamen-, Nachname-/Orte-Seite).
Taufe, Begrbnis und Beruf in den Datenseiten.
Orte-Sortierung nun unabhngig von Gro- und Kleinschreibung (vermeiden Sie Zeilen fr 
denselben Ort, die einmal in Grobuchstaben und einmal in Kleinbuchstaben geschrieben sind). 
Direkter Zugriff auf betreffende Personen von der Nachnamen-/Orte- und Orte-/Nachnamen-Seite aus.
Beseitigung eines Fehlers, der die Behandlung der Link-Farben betraf.
Erklrung der Symbole  x + in den Orte/Nachnamen- und Nachnamen/Orte-Listen.
Der Buchstabe Beta wird nun untersttzt.
Management der HTML-Seitengre.
Beseitigung eines Fehlers, der bei Nachnamen mit nur einem Buchstaben auftrat.

Version 1.3.0f&w, 13. Dezember 1998 (kleinere Fehler beseitigt)
Taufe: CHR wird jetzt, wie BAPM, akzeptiert (Danke, Frank)
Nachnamenliste: Der Verweis auf den letzten Nachnamen ist jetzt korrekt.
NAME-Tag: im rechten Teil des Nameneintrags (Titel bei einigen Softwareprodukten, Vorname 
bei anderen) werden nun auch Akzente richtig behandelt.

Version 1.4f&w beta, 3. Mrz 1999
Korrektur der Versionen 1.3 & 1.3.0: alle Individuen erscheinen jetzt.
Neue Darstellung (Tabellen) fr die Datenseiten.
Mglichkeit, Daten auf den Seiten nach rechts zu rcken.
Option, ORTE-/NACHNAMEN- & NACHNAMEN-/ORTE-Listen erzeugen zu lassen.
Option, Referenzen anzeigen zu lassen (REFN tag).
Parameter fr den Titel auf den Datenseiten.
Der Inhalt der Datei "top.txt" (wenn vorhanden) wird am Anfang jeder Seite ausgegeben. Damit 
knnen die Seiten unter ein Thema gestellt werden.
Zwischenberschrift (Alphabet) in der Nachnamenliste verbessert die Lesbarkeit.

Version 1.5, 15. Januar 2000
Der Name der GEDCOM-Datei wird jetzt in der Parameter-Datei ged2www.dat gespeichert.
Die Sortierreihenfolge bei Namen ist nun an Westeeuropische Sprachen angepasst. Das heisst,
das Buchstaben wie e    und  wie e behandelt werden. Die Buchstaben     und  werden 
aber anders als a, e und o behandelt.
Druck von Sosa-Nummern.
Druck von NOTEs.
bersichtstabelle fr Orte.
Unpassende Kommata in Ortsnamen werden entfernt (solche Kommata werden von einigen
Genealogieprogrammen erzeugt).
Fehler bei Bildern beseitigt.

Version 1.5.1, 20. Januar 2000
Korrektur eines Fehlers bei Nachnamen, wenn das erste Zeichen kein Buchstabe ist.
Dateiendung .ged wird automatisch ergnzt, wenn der Name einer GEDCOM-Datei angegeben wird.

Version 1.5.2, 22. Januar, 2000
Korrektur eines Fehlers bei NOTEs, die lnger als 1024 Zeichen sind. Notizen (NOTEs) knnen 
nun bis 32 KB gro sein; falls sie grer sind, werden sie abgeschnitten.
Orte-Sortierung korrigiert; sie ist nun unabhngig von Gro-/Kleinschreibung.
HTML-Code wurde "verschnert".

Version 1.5.3, 31. Januar, 2000
Fehler (Crash) beseitigt, wenn gewhlt wurde, Sosa-Nujmmern zu drucken.
Fehler (Crash) beseitigt, der beim Bearbeiten der GEDCOM-Datei (in Durchgang 1/2 oder 2/2) 
auftreten konnte.
Erweiterte Mglichkeit, NOTEs zu drucken. Mglichkeit, NOTEs in Hochzeitseintrgen (MARR) 
zu drucken.
Es wirs weniger Zeit fr die Orte-/Nachnamen-Seiten gebraucht.

Version 1.5.4, 13. Februar, 2000
Fehler (Crash) beseitigt, der auftrat, wenn kein Datum auf den Index-Seiten gedruckt wurde.
Informationen des CONF-Eintrags werden gedruckt.
Informationen des DIV-Eintrags werden gedruckt.
Option, interne oder extern Sortierung zu nutzen. (Nutzen Sie die interne Sortierung nur, 
wenn keine Orte-/Nachnamen-Listen erzeugt werden.)

Version 1.5.5 june 24, 2000
Liste clair is back.
Fixed a bug about special characters as     in ANSEL coding.
If pages are right shifted, the first separator of each page is now right shifted too.
Fixed hyperlink incoherence toward index or in index.
Error message and stop if more than 30 children in a family, or more than 20 marriages for an
individual.
If multiple parents, first declaration of parents is took into account (instead of last), and
you get a warning message for subsequent parents.
