# GeneWeb - Personalisering van de pagina's

Hier wordt uitgelegd hoe u extra, bijbehorende pagina's kan toevoegen aan uw GeneWeb pagina's. Er wordt uitgelegd hoe u de ontvangstpagina kan aanpassen aan uw eigen wensen, noden (en grillen misschien). Deze uitleg is bedoeld voor mensen die GeneWeb al goed kennen, en die nu meer details willen weten. Deze pagina is erg nuttig voor mensen die met hun GeneWeb server wereldwijd via het Internet genealogische informatie willen aanbieden.

- Verwelkomingspagina
- Macros
- Extra pagina's

#### Verwelkomingspagina

De verwelkomingspagina van GeneWeb wordt opgebouwd aan de hand van een tekstbestand (start.txt). Voor elke taal is er een standaard tekstbestand. U kan deze bestanden aanpassen voor één databank, of voor alle databanken die u met GeneWeb beheert.

Deze tekstbestanden bevatten naast standaard HTML ook codes specifiek aan GeneWeb. We noemen deze codes "macros" (wordt hierna in detail uitgelegd). Om deze bestanden te wijzigen mag u bijgevolg geen HTML-editor gebruiken, maar enkel een gewone tekst-editor.

Om een ontvangstpagina voor de databank "appel" aan te maken, moet u weten dat GeneWeb zal zoeken op de volgende plaatsen, in de gegeven volgorde:

- bdir/lang/taal/appel.txt
- hdir/lang/taal/appel.txt
- bdir/lang/appel.txt
- hdir/lang/appel.txt
- bdir/lang/taal/start.txt
- hdir/lang/taal/start.txt
- bdir/lang/start.txt
- hdir/lang/start.txt

waarbij

- "bdir" = argument van "-bd" als optie bij "gwd" (verzuimwaarde: de directory waarin "gwd" werd gestart).
- "hdir" = argument van "-hd" als optie bij "gwd" (verzuimwaarde: de directory waarin "gwd" werd gestart). .
- "taal" = code van de taal waarin "gwd" pagina's serveert, bijvoorbeeld "nl" voor het Nederlands.

De bestanden "hdir/lang/taal/start.txt" zijn standaard meegeleverd met GeneWeb. De eenvoudigste en snelste manier om een eigen versie aan te maken is te vertrekken van een kopie van dit bestand. Als het bestand "start.txt" u niet bevalt, kan u dit bestand natuurlijk ook aanpassen.

Opmerking: Door de snelle ontwikkeling van GeneWeb zijn er regelmatig grote verbeteringen aan de meegeleverde "start.txt" bestanden. Het is aangewezen deze verbeteringen ook steeds op te nemen in uw aangepaste bestanden.

#### Macros

Zoals eerder aangegeven zijn de ontvangstpagina's niet geschreven in pure HTML. De "start.txt" bestanden bevatten "macros". Praktisch gezien zijn dit codes van de vorm "%letter" en "[tekst]", bijvoorbeeld "%s", "%x", "[*advanced request]".

De "%" codes worden bij het tonen vervangen door waarden die horen bij de desbetreffende databank: de naam van de databank, de taal, het aantal personen in de databank...

Andere codes zijn zoals aangegeven van de vorm "[tekst]". Deze codes worden vervangen door een vertaalde versie. De lijst van codes en hun vertalingen is opgeslagen in het bestand "lexicon.txt". De volgende regels zijn geldig voor het hanteren van deze codes.

- Als er een sterretje staat na "[", zal de eerste letter van de vertaling een hoofdletter worden.
- Als het sluitende haakje wordt gevolgd door een getal ( "...]15" ), dan correspondeert dit getal met de plaats van de vertaling in een lijst. Zo'n lijsten vindt u terug in "lexicon.txt". De lijsten beginnen bij het nul-de (0) element en de elementen in de lijst worden gescheiden door een "/". Als het getal foutief is wordt het eerste element in de lijst genomen.

Om goed te begrijpen hoe deze codes werken kan u best eens de bestanden "start.txt" bekijken.

Hieronder de uitleg over de "%"-macros:

- Databank

- "`%t`" : naam van de databank.
- "`%f`" : in gebruik van "gwd" als server, de naam van de databank, eventueel gevolgd door een wachtwoord (bijvoorbeeld: "appel_xyzzy"); bij gebruik van "gwd" CGI, naam van het CGI bevel (bijvoorbeeld: "gwd.exe").
- "`%g`" : in gebruik van "gwd" als server, zoals "%f" in gebruik van "gwd" als server; bij gebruik van "gwd" in CGI, de naam van het CGI bevel gevolgd door "?b=", de naam van de databank en een punt komma (bijvoorbeeld: "gwd.exe?b=appel;").
- "`%s`" : waarde van "%f" gevold door een vraagteken en de waarde van zogenaamde van contextuele variabelen (zie verder) gevolgd door een punt komma (bijvoorbeeld: "appel?lang=it;iz=8233;").

- Boekhouding

- "`%c`" : aantal "hits" op de verwelkomingspagina.
- "`%q`" : totaal aantal vragen aan "gwd" (over de huidige databank)
- "`%d`" : datum van de eerste raadpleging van de databank.

- Toestanden (booleaanse waarden)

- "`%w...%w`" : toont of u een "tovenaar" (En: wizard) bent.
- "`%x...%x`" : toont of u een "tovenaar" of "vriend" bent.
- "`%y...%y`" : toont of "gwd" als zelfstandige server werkt (niet in CGI) en of men geen "tovenaar" is.
- "`%z...%z`" : toont of "gwd" als zelfstandige server werkt (niet in CGI) en of men geen "tovenaar" of "vriend" is.
- "`%i...%i`" : toont of "gwd" in CGI modus werkt.

- Andere

- "`%r`" gevolgd door de naam van een bestand en een line-break: invoegen van het bestand "naam.txt"
- "`%b`" : waarde van de variabele "body_prop" van het bestand "appel.gwf" voor de databank "appel".
- "`%h`" : contextuele variabelen (zie hieronder) onder de vorm "<input type=hidden name=var value=val>".
- "`%l`" : taal.
- "`%n`" : aantal personen in de databank.
- "`%%`" : een "%" teken.
- "`%[`" : een "[" teken.
- "`%]`" : een "]" teken.

Sommige macros zijn verwijzingen naar zogenaamde contextuele variabelen. Dit zijn:

- b : in CGI-modus, de naam van de databank.
- lang : taal.
- iz : de index (een getal) van een eventuele proband (de beginpersoon bij een kwartierstaat opzoeking).

De codes voor toestanden mogen niet genest worden: men mag bijvoorbeeld "`%w...%w`" niet invoegen in "`%i...%i`".

#### Extra pagina's

In uw gepersonalliseerde verwelkomingspagina kan uw links plaatsen naar extra, eigen bestanden. Deze bijgevoegde pagina's zullen door GeneWeb op dezelfde manier verwerkt worden als zijn eigen bestanden. U mag dus macros gebruiken.

Als u bijvoorbeeld een speciale pagina wil maken over uw beroemde voorouders kan u een bestand "beroemd.txt" aanmaken in "bdir/lang/taal" of in "bdir/lang" (zie boven voor uitleg over deze locaties).

U kan een link maken naar dit bestand als volgt: "m=H;v=beroemd". In de ontvangstpagina plaatst u dus iets als dit:

       De <a href="%sm=H;v=beroemd">beroemde</a> mensen in mijn
    databank.

In "beroemd.txt" kan u links leggen naar personen in uw databank zonder de naam van uw databank te moeten gebruiken. Dit heeft als voordeel dat de naam van uw databank mag wijzigen, terwijl u links toch nog werken.

De meest aangewezen macros om dit te bekomen zijn:

- "`%b`" : U kan dit plaatsen aan in de tag "<body>" als volgt "<body%b>".
- "`%s`" : U kan dit plaatsen in de hyperlinks die u maakt.

Een voorbeeldje:

       Mijn neef <a href="%sp=louis;n=de+bourbon;oc=5">
       Louis XIV</a> en mijn
       <a href="%sem=R;ep=jean;en=dupont;m=NG;n=louis+xiv;t=PN">
       lijn van verwantschap;</a> met hem.

Lees ook de documentatie over het correct plaatsen van links naar GeneWeb pagina's.

GeneWeb werkt zelf deels volgens het bovenstaande principe. Kijk maar eens naar het bestand "advanced.txt".

Terugkeren naar de gebruiksaanwijzing.

Copyright (c) 1998-2006 INRIA - GeneWeb