Dit hoofdstuk bevat een inleiding tot het gebruik van GeneWeb met een uitleg over de bevelen en gebruikte bestanden. Na het lezen weet je (hopelijk) genoeg om GeneWeb te kunnen gebruiken.
Om GeneWeb te installeren en in te stellen, moet je interactieve bevelen gebruiken. Onder Unix, start een xterm. Onder Window 95/NT, klik op "Start", "Programmas" en "MSDOS bevel".
In dit venster, typ het bevel om naar de directory te gaan waarin je GeneWeb geïnstalleerd hebt:
cd /home/smith/geneweb/gw
cd c:\soft\geneweb\gw
Alle GeneWeb bevelen kunnen gebruikt worden met de optie -help. Dit toont alle mogelijke opties met een korte uitleg.
Als je bijvoorbeeld typt:
gwd -help
moet je iets dergelijks zien:
Usage: gwd [args]
-hd dir: directory where the directory lang is installed
-cgi query addr: called from a cgi-bin
-p #: port number; greater than 1024 for normal users
-wizard passwd: access to all dates and base updating
-friend passwd: access to all dates
-only address: only inet address accepted
GeneWeb databanken zijn directories met de extensie ".gwb".
Om GeneWeb te kunnen gebruiken, moet je eerst een databank aanmaken. Je kan dit doen met het bevel "gwc", of met "ged2gwb", dat later wordt uitgelegd.
Het bevel "gwc", in zijn eenvoudigste gebruik, maakt een lege databank aan: met GeneWeb zal je er gegevens aan kunnen toevoegen.
Je moet een naam geven aan de databank. Zowat elke naam is goed, maar gebruik best niet meer dan 8 letters.
Bijvoorbeeld, als je de databank "smith" wil noemen, typ dan:
gwc -o smith
Een andere manier om een GeneWeb databank aan te maken is te vertrekken met een GEDCOM bestand.
Het bevel "ged2gwb" laat toe een conversie uit te voeren van een GEDCOM bestand naar een GeneWeb databank.
De eenvoudigste manier is eerst je GEDCOM bestand kopiëren naar de directory waar je GeneWeb geïnstalleerd hebt. Ja kan dit doen zoals je wil: lijngericht of met het verslepen van grafische icoontjes.
Als je GEDCOM bestand bijvoorbeeld "foo.ged" heet en je wil een databank aanmaken met de naam "smith", typ dan:
ged2gwb foo.ged -o smith
Dit bevel zal rapporteren wat er gebeurt, vooral als er fouten ontdekt worden in het GEDCOM bestand. Trek je daarvan voorlopig niet te veel aan: de databank zal toch worden aangemaakt. Als de conversie correct is verlopen , eindigt het bevel als volgt:
*** Ok
Alvorens verder te gaan, wijzen we even op het tegengestelde bevel "gwb2ged", dat toelaat om een GEDCOM bestand aan te maken op basis van een GeneWeb databank.
Van zodra een databank gecreeërd is met het bevel "gwc" of "ged2gwb", kan je dit bevel gebruiken.
Nog steeds in een interactief venster, typ:
gwd
Dit bevel start een GeneWeb "daemon" op. Een "daemon" is een "background proces", een niet interactief programma dat in de achtergrond wordt uitgevoerd. Bij uitvoeren van "gwd" zie je normaal het volgende:
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 (day) (hour) port 2317...
Merk op dat je geen "prompt" ziet. Dit programma wacht op vragen die jij er aan zal stellen via je Web browser. Als "gwd" een vraag gesteld wordt, beantwoordt hij die en wacht daarna opniew. Als je stopt met het gebruik van GeneWeb kan je "gwd" stoppen door control-c te typen.
Nu ben je echt klaar om te beginnen. Aangezien je deze documentatie leest, gebruik je een Web browser. Maak een nieuw venster aan met je browser en surf naar de volgende locatie. Vervang "smith" door de naam van je eigen databank. Gebruik niet de volledige naam (c:\geneweb\gw\smith of /home/geneweb/gw/smith) maar enkel "smith".
http://localhost:2317/smith
Je zal de GeneWeb verwelkomingspagina zien in het Frans.
[Als dit niet werkt, klik hier]
Kies een andere taal (bv. nederlands) door op de vlag te klikken. (Er bestaat een manier om een andere taal te kiezen dan Frans om te beginnen. Zie later).
Vanaf de welkompagina, kan je je bestand aanpassen alsof je op het web rondsurft. Je kan klikken op "hyperlinks", knoppen... er zijn invoervelden.... Hint: probeer eerst eens "Alle voornamen volgens alfabet" (klik op "OK"). In de nieuwe pagina die verschijnt kan je een achternaam kiezen, een persoon... kortom: eindeloos rondsurfen.
Het enige dat je kan doen is personen en families invoeren. Klik op "Invoeren van een familie". Je zal waarschijnlijk zelf je weg kunnen vinden, zo niet is de volledige documentatie hier te vinden.
Intussen merk je op dat telkens je een link aanklikt, "gwd" dit toont. Je kan zo zien wie je databank gebruikt als je GeneWeb op een netwerk gebruikt. Volledige documentatie voor het gebruik van GeneWeb in een netwerk vindt je hier.
Merk ook op dat als je "gwd" afsluit met control-c je niet meer kan werken met GeneWeb. Je moet dan gewoon opnieuw "gwd" intikken.
Onder Windows kan je eenvoudig op het icoontje van "gwd" klikken om "gwd" op te starten. Dit opent een interactief venster waarin "gwd" zijn output toont. Control-c typen stopt "gwd" en sluit dit venster. Je kan op het bureaublad een snelkoppeling plaatsen naar "gwd" om het allemaal nog wat eenvoudiger te maken.
Dit bevel moet uitgevoerd worden in een interactief venster, net als ander bevelen.
Het bevel "consang" berekent de verwantschappen in een databank. Het tonen van verwantschappen gebeurt als je de databank raadpleegt voor informatie over personen en bij het tonen van verwantschappen.
Maar om dan correcte informatie te kunnen zien moet je vooraf de verwantschappen tussen de personen in de databank berekenen. Dit gebeurt met behulp van "consang". Als je databank "smith" heet, typ dan:
consang smith
Dit programma zal enkele ogenblikken of minuten rekenen, afhankelijk van de grootte van je bestand. Het toont het aantal personen waarvan nog verwantschappen berekend moeten worden en op het einde krijg je je "prompt" terug. De verwantschappen zijn dan berekend.
Als de berekeningen lang duren mag je ondertussen gewoon verder gaan met het gebruik van GeneWeb.
Voer "consang" nu en dan eens uit, als je wijzigingen hebt aangebracht . Vooral als je families hebt toegevoegd, verwijderd of gewijzigd: verwantschap hangt af van de structuur van de families. Individuele verwantschappen zijn dan niet onmiddelijk beschikbaar, maar pas na uitvoering van "consang".
Bovendien zorgt "consang" voor een interne "opruiming" van de databank, wat noodzakelijk is na een zeker aantal wijzigingen.
[Het bevel heette vroeger "gwb2gw"].
Dit bevel toont de inhoud van een databank als tekst. Je kan deze tekst opslaan in een bestand, vb. met behulp van een unix "shell redirection".
Als je databank "smith" heet, en je wil het bestand opslaan in het bestand "foo.gw", typ dan: type:
gwu smith > foo.gw
Nu en dan eens een dergelijk *.gw bestand opslaan laat toe na te gaan welke wijzigingen er gebeurd zijn als iemand anders gegevens heeft ingebracht.
Dit bevel laat ook toe om een databank te converteren naar een nieuwe versie van GeneWeb. Dit is natuurlijk enkel nodig als de interne voorstelling van GeneWeb gewijzigd werd. Dit wordt steeds vermeld bij het uitbrengen ban een nieuwe versie van GeneWeb.
Om op basis van een "*.gw" bestand een databank aan te maken gebruik je het bevel "gwc". Om op basis van een bestand "peeters.gw" een databank met de naam "peeters" aan te maken, typ je:
gwc foo.gw -o jones
Dit bestand bevat de algemene instellingen voor een databank. Als jouw databank "jansen" heet, kopieer dan het bestand "a.gwf" naar "jansen.gwf". In het bestand "jansen.gwf" mag je dan naar hartelust wijzigingen aanbrengen.
De instelbare waarden zijn de volgende:
body_prop=background=mybackg.jpg vlink=yellow
Deze achtergrond wordt gebruikt in ALLE pagina's die je opvraagt, niet enkel de verwelkomingspagina.
Je kan nog steeds met de vlaggen een andere taal kiezen, welk ook de standaardtaal is die je ingeseteld hebt.
Dit bestand bevat een lexicon van alle termen en zinnnen die gebruikt worden in het programma, samen met verschillende vertalingen.
Als een van de vertalingen je niet bevalt kan je dit gerust wijzigen.
Weet ook dat de wijzigingen die je aanbrengt in "lexicon.txt" onmiddellijk zichtbaar zijn. Je moet enkel de "reload" functie van je Web browser gebruiken.
Elke subdirectory van de directory "lang" is genoemd naar een taal (vb. "nl" voor het Nederlands). Je vindt er de standaard verwelkomingspagina voor die taal in het bestand "start.txt".
Je kan de verwelkomingspagina voor elke databank anders instellen als je wil. Voor de databank "jansen" in de taal "xx", kopieer je gewoon het bestand "start.txt" naar "jansen.txt" in de directory "xx". Je kan het bestand "jansen.txt" aanpassen zoveel je wil.
Opmerking: Deze bestanden ("start.txt" en "jansen.txt) bevatten specifieke HTML codes: %-tekens gevolgd door een letter. Dit zijn "macros" die door "gwd" worden vervangen door cijfers, namen, ... Vb.: "%t" wordt vervangen door de naam van de databank.
De documentatie voor deze macros vindt je hier.
Terugkeren naar de gebruiksaanwijzing.