# GeneWeb - Getting Started

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.

- Inleiding
- Bevel gwc
- Bevel ged2gwb
- Bevel gwb2ged
- Bevel gwd
- Bevel consang
- Bevel gwu
- Bestand a.gwf
- Directory "lang" - bestand "lexicon.txt"
- Directory "lang" - subdirectories

#### Inleiding

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:

- Onder Unix, als je GeneWeb geïnstalleerd hebt in vb. "/home/smith/geneweb":

          cd /home/smith/geneweb/gw

- Onder Window 95/NT, als je GeneWeb geïnstalleerd hebt in vb. "C:\soft\geneweb":

         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".

#### Bevel gwc

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

#### Bevel ged2gwb

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

#### Bevel gwb2ged

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.

#### Bevel gwd

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 - Copyright (c) 1998-2006 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).

- Als je gestart bent vanaf een GEDCOM bestand ("ged2gwb"), zal je bovenaan het aantal personen in de databank zien.

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.

- Als je begonnen bent met een lege databank ("gwc"), zegt de verwelkomingspagina dat de databank 0 personen bevat.

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.

#### Bevel consang

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.

#### Bevel gwu

[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

#### Bestand a.gwf

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 laat toe om de achtergrond van de web pagina's te wijzigen in een andere kleur of zelfs een foto in te stellen als achtergrond. De syntax is volledig volgens de HTML regels. Kijk eens naar wat HTML documentatie, bezoek een specialist in HTML, of bekijk gewoon de volgende voorbeelden:

         body_prop=background=mybackg.jpg vlink=yellow

Deze achtergrond wordt gebruikt in ALLE pagina's die je opvraagt, niet enkel de verwelkomingspagina.

- friend_passwd laat toe je gegevens te beschermen. Wie het paswoord niet kent, krijgt niet alle gegevens te zien van nog levende personen.

- wizard_passwd laat toe de mogelijkheid tot het wijzigen van de gegevens te beveiligen. Enkel de personen die het paswoord kennen mogen wijzigingen aanbrengen in de databank.

- default_lang laat toe een standaard taal in te stellen. Zonder instelling is deze taal het Frans. GeneWeb ondersteunt momenteel de volgende talen. "cn" (chinese), "de" (german), "en" (english), "eo" (esperanto), "es" (spanish), "fr" (french), "is" (icelandic), "it" (italian), "nl" (dutch), "pt" (portuguese), "se" (swedish).

Je kan nog steeds met de vlaggen een andere taal kiezen, welk ook de standaardtaal is die je ingeseteld hebt.

#### Directory "lang" - bestand "lexicon.txt"

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.

#### Directory "lang" - subdirectories

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.

Copyright (c) 1998-2006 INRIA - GeneWeb