GeneWeb - Erste Schritte |
Warnung: Dieser Ansatz unterstellt, dass du dich mit "Dateien" und "Verzeichnissen" auskennst und keine Angst vor der Eingabe von Kommandos hast; ansonsten verwende lieber das Programm gwsetup.
In diesem Fenster wechsle in das Verzeichnis, wo du GeneWeb installiert hast:
Unter Unix, falls du das Programm unter "/home/meier/geneweb" installiert hast: | |
Unter Window 95/NT, falls du das Programm unter "C:\soft\geneweb" installiert hast: |
Wenn du zum Beispiel eingibst:
gwd -helperhältst du so etwas wie:
Usage: gwd [options] where options are: -hd <dir> Directory where the directory lang is installed. -bd dir> Directory where the databases are installed. -cgi Force cgi mode. -p <number> Select a port number (default = 2317); > 1024 for normal users. -wizard <passwd> Set a wizard passord: access to all dates and updating. -friend <passwd> Set a friend password: access to all dates. -lang <lang> Set a default language (default: fr). -only <address> Only inet address accepted. -auth <file> Authorization file to restrict access. The file must hold lines of the form "user:password". -log <file> Redirect log trace to this file. -nolock Do not lock files before writing.Einige Befehle sind ziemlich "geschwätzig". Du kannst ihre Anzeige in eine Datei umleiten, indem du an das Kommando ein "> Datei" anhängst. Beispiel:
gwd -help > bla.txtGeneWeb-Datenbanken sind Verzeichnisse mit der Erweiterung ".gwb".
Der Befehl "gwc" legt in seiner einfachsten Form eine leere Datenbank an: Mit GeneWeb kann sie dann gefüllt werden.
Du mußt dieser Datenbank einen Namen geben. Ein beliebiger Name ist möglich. Vorzugsweise sollten nicht mehr als 8 Zeichen verwendet werden.
Wenn die Datenbank zum Beispiel "meier" heißen soll, dann schreibe:
gwc -o meier
Der Befehl "ged2gwb" erlaubt es, eine GEDCOM-Datei in eine GeneWeb-Datenbank umzuwandeln.
Am einfachsten geht das, indem du zuerst die GEDCOM-Datei in das Verzeichnis kopierst, wo GeneWeb installiert wurde. Mache das so, wie du immer Dateien kopierst, entweder mit einem interaktiven Befehl, oder per Icon-Bewegung.
Wenn deine GEDCOM-Datei zum Beispiel "bla.ged" heißt und du Deine Datenbank "meier" nennen willst, gib ein:
ged2gwb bla.ged -o meierDer Befehl ist etwas mitteilsam, besonders wenn er Fehler in der GEDCOM-Datei findet. Du kannst diese Fehler zuerst einmal ignorieren: Deine Datenbank wird trotzdem erzeugt. Wenn alles in Ordnung ist, muß die Ausgabe enden mit:
*** Ok
Gib im Eingabefenster ein:
gwdDieser Befehl startet den GeneWeb-"Daemon". Das Programm muß ausgeben:
GeneWeb 1.0 - Copyright (c) 2001 INRIA Possible addresses: http://localhost:2317/base http://127.0.0.1:2317/base http://address:2317/base where "base" is the name of the database Type control C to stop the service Ready (Tag) (Uhrzeit) port 2317...Beachte, daß du im Eingabefenster keinen Prompt siehst. Das Programm wartet auf Anfragen, die du per Webbrowser sendest. Wenn es eine Anfrage erhält, wird diese verarbeitet und wieder gewartet. Beenden kann man GeneWeb durch Drücken von Control-C (bzw. Strg-C) im Eingabefenster.
So, jetzt können wir wirklich anfangen. Da du diese Dokumentation liest, benutzt du einen Webbrowser. Mache in diesem Browser ein neues Fenster auf und gehe zur folgenden URL. Ersetze "meier" durch den Namen deiner Datenbank. Achtung: Setze nicht den kompletten Namen ein (wie "c:\geneweb\meier" oder "/home/geneweb/meier"), sondern nur "meier":
http://localhost:2317/meierNun siehst Du die GeneWeb-Startseite in Französisch.
[Wenn das nicht klappt, klicke hier]
Wähle eine andere Sprache (z. B. Deutsch) in der Flaggenreihe am Anfang der Seite. (Es gibt eine Möglichkeit, eine andere Standardsprache als Französisch zu wählen. Siehe unten).
Wenn du mit einer GEDCOM-Datei ("ged2gwb") begonnen hast, mußt du am Anfang der Seite die Zahl der Personen deiner Datenbank sehen. |
Wenn Du mit einer leeren Datenbank begonnen hast ("gwc"), sagt die Startseite, daß die Datenbank 0 Personen enthält. |
Beachte, daß der Dienst beim Drücken von Control-C (bzw. Strg-C) im Terminalfenster nicht mehr die Anfragen des Webbrowsers beantwortet. Um ihn wieder zu starten, gib wieder "gwd" ein.
Unter Windows kannst du einfach auf das Icon von "gwd" doppelklicken
um zu starten. Es öffnet sich ein Terminalfenster, wo "gwd" seinen
Ablauf anzeigt.
Drücken von Control-C (bzw. Strg-C) stoppt "gwd" und
schließt das Fenster. Wenn man eine Verknüpfung auf "gwd"
auf der Arbeitsoberfläche
erzeugt, kann man es sehr leicht erreichen.
Der Befehl "consang" berechnet die Blutsverwandschaften in einer Datenbank. Die Anzeige der Blutsverwandschaften erfolgt bei der Abfrage von Personendatensätzen aus der Datenbank und bei der Berechnung der Verwandtschaften.
Aber um darauf Zugriff zu haben, müssen die einzelnen Blutsverwandtschaften der Personen in der Datenbank vorherberechnet werden. Das macht "consang". Wenn der Name deiner Datenbank "meier" ist, gib ein:
consang meierDas Programm rechnet dann einige Sekunden oder Minuten, je nach Größe deiner Datenbank. Während der Berechnung wird die Zahl der noch zu bearbeitenden Personen angezeigt. Am Ende steht wieder das Prompt im Terminalfenster und die einzelnen Blutsverwandtschaften sind gespeichert.
Während dieser Berechnung kann man auf jeden Fall in den Webbrowser zurückkehren und die Datenbank abfragen, falls man den Daemon nicht gestoppt hat.
Starte "consang" von Zeit zu Zeit, wenn du Änderungen an deiner Datenbank gemacht hast, besonders wenn Familien hinzukommen, geändert oder gelöscht werden: Die Blutsverwandtschaft hängt von der Struktur der Familien ab. Wenn sie sich ändert, sind die einzelnen Blutsverwandtschaften nicht verfügbar und man muß sie neu berechnen.
Zudem führt "consang" eine interne "Säuberung" der Datenbank durch, die nach einer gewissen Zahl von Änderungen notwendig wird.
Wenn deine Datenbank "meier" heißt und du sie in der Datei "bla.gw" speichern willst, gib ein:
gwu meier > bla.gwWenn du deine Datenbank in verschiedenen Versionen und Dateien abspeicherst, kannst Du die Unterschiede unter Verwendung eines Vergleichsprogrammes sehen. Das ist besonders interessant, wenn jemand Veränderungen deiner Datenbank vorgenommen hat und du wissen willst, welche das sind.
Das ist auch eine Methode, die Datenbank wiederherzustellen, wenn du eine andere Version von GeneWeb benutzt, für den Fall, daß sich die interne Repräsentation der Datenbanken geändert hat.
Um deine Datenbank wiederherzustellen, kannst du den Befehl "gwc" nutzen. Die gespeicherte Datei muß die Erweiterung ".gw" haben. Um eine Datenbank namens "mueller" aus der Datei "bla.gw" aufzubauen, gib ein:
gwc bla.gw -o mueller
Die konfigurierbaren Werte sind wie folgt:
body_prop erlaubt die Einstellung einer
Hintergrundfarbe oder eines Hintergrundbildes
und die Änderung der Text- und Linkfarben. Seine Syntax
entspricht der
HTML-Syntax, die in der "<body>"-Anweisung vor dem ">" steht.
Sieh in deine HTML Dokumentation (oder frage einen Experten).
Beispiel:
body_prop=background=mybackg.jpg vlink=yellowDas wirkt sich nicht nur auf die Startseite aus, sondern auf alle Seiten dieser Datenbank.
friend_passwd erlaubt die Sichtbarkeit von noch lebenden Personen
zu beschränken, d. h. hier alle Personen, die vor weniger als
hundert Jahren geboren wurden oder gestorben sind.
| Wenn du dieser Variablen einen Wert gibst, können nur Personen, die das Kennwort auf der Startseite eingegeben haben, auf diese Daten zugreifen.
wizard_passwd erlaubt die Beschränkung des Rechtes,
Änderungen an der Datenbank durchzuführen.
| Wenn du dieser Variable einen Wert gibst, haben nur Personen Änderungsberechtigung, die dieses Kennwort auf der Startseite eingegeben haben.
wizard_just_friend erlaubt es, die Änderungsberechtigung
wieder zu entziehen.
Setze die Variable auf "yes" um das zu tun,
auf "no" um die Erlaubnis wieder zu erteilen. Es kann nützlich
sein, "yes" zeitweise hinzuschreiben, während man die Datenbank säubert.
|
default_lang erlaubt es, eine Standardsprache für die Startseite
zu definieren. Ohne Angabe ist die Sprache Französisch. Die möglichen
Werte sind:
"af" (Afrikaans),
"cn" (Chinesisch),
"ct" (Catalan),
"cz" (Tschechisch),
"de" (Deutsch),
"dk" (Dänisch),
"en" (Englisch),
"eo" (Esperanto),
"es" (Spanisch),
"et" (Estonisch),
"fi" (Finnisch),
"fr" (Französisch),
"he" (Hebräisch),
"it" (Italienisch),
"lv" (Litauisch),
"nl" (Holländisch),
"no" (Norwegisch),
"pt" (Portugiesisch),
"ru" (Russisch),
"se" (Schwedisch).
| Beachte, dass unabhängig von der gewählten Standardssprache, jederzeit eine andere Sprache auf der Startseite gewählt werden kann, indem man auf die Flaggenreihe am Kopf der Seite klickt. |
can_send_image erlaubt den "Wizards" Fotos zu senden
(und zu löschen).
In diesem Fall können sie bei der Aktualisierung
auf einen Link namens Bild senden
klicken (und möglicherweise einen anderen namens
Bild löschen). Standard ist "no"
(keine Berechtigung Fotos zu senden); um die Berechtigung zu
erteilen, trage "yes" ein.
Vorsicht: die Fotos werden auf deinem Computer abgespeichert und können viel Platz wegnehmen, wenn viele Fotos eingesandt werden.
renamed erlaubt anzuzeigen, daß sich der Name einer Datenbank geändert
hat. Wenn deine Webseite sehr häufig besucht wurde und die Datenbank
in vielen persönlichen Lesezeichen gespeichert wurde, ist das ein
Weg, auf die neue Datenbank mit dem neuen Namen umzuleiten. Wenn jemand
versucht, über den alten Namen darauf zuzugreifen, sieht derjenige
eine Seite mit einem Link mit der gleichen Abfrage für den neuen Namen.
| |
Darüberhinaus kannst du die vorgegebenen Übersetzungen ändern, wenn sie nicht passen.
Wenn du die Datei "lexicon.txt" speicherst, wird das sofort in der Browseranzeige angewendet. Möglicherweise muß man aber auf "reload" klicken.
Du kannst diese Startseite für eine bestimmte Datenbank ändern. Für die Datenbank "meier" in der Sprache "xx", kopiere einfach die Datei "start.txt" in das Verzeichnis "xx" und benenne sie in "meier.txt" um. Dann editiere die Datei "meier.txt" und mache die Anpassungen die du willst. Wenn du möchtest, kannst du das für jede Sprache tun.
Anmerkung: Diese Dateien beinhalten HTML-Code mit einigen besonderen Angaben: % Zeichen gefolgt von einem Buchstaben. Das sind Makros, die "gwd" durch Werte ersetzt. Zum Beispiel wird "%t" durch den Namen der Datenbank ersetzt, "%b" durch den Wert von "body_prop" der Konfigurationsdatei usw.
Die komplette Beschreibung dieser Makros befindet sich hier.