GeneWeb - Komma igång

Detta kapitlet innehåller en introduktion till GeneWeb med en kortfattad beskrivning av kommandon och filer som behövs för att starta.

Introduktion

För att konfigurera och starta GeneWeb, måste du använda ett DOS fönster. Under Unix, starta ett xterm. Under Windows 95/98/NT, klicka på "Start", "Programs" och "Commands MSDOS".

I detta fönster, skriv in kommandot för att gå till den katalog där du installerade GeneWeb:


     cd /home/svensson/geneweb

     cd c:\program\geneweb

Alla GeneWeb kommandon kan startas med optionen -help som visar olika möjliga optioner, med en kort förklaring.

Till exempel, om du skriver:


     gwd -help

ska du se något sådant:


     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 och base updating

       -friend passwd: access to all dates

       -only address: only inet address accepted

Några kommandon visar viss text. Du kan dirigera om utmatningen till en fil genom att avsluta kommandot med "> fil". Exempel:

     gwd -help > foo.txt

GeneWeb databaser är kataloger med filändelsen ".gwb".

Kommandot gwc

För att använda GeneWeb, måste du skapa en databas. Du kan göra det antingen med kommandot "gwc", eller med "ged2gwb", (se nedan).

Kommandot "gwc", i dess enklaste användande, skapar en tom databas: i GeneWeb, som du kan fylla.

Du måste ge ett namn till din databas. Använd helst inte mer än 8 tecken.

Till exempel, om du vill kalla den "svensson", skriv:


     gwc -o svensson

Kommandot ged2gwb

Ett annat sätt att skapa en GeneWeb databas är att starta från en GEDCOM fil.

Kommandot "ged2gwb" låter dig konvertera en GEDCOM fil till en GeneWeb databas.

Det enklaste sättet är att först kopiera din GEDCOM fil till katalogen där du installerade GeneWeb. Gör det på vanligt vis, antingen i ett DOS fönster eller genom att flytta ikoner.

Om din GEDCOM fil har namn, till exempel, "foo.ged" och du vill skapa en databas benämnd "svensson", skriv:


     ged2gwb foo.ged -o svensson

Kommandot visar till viss del vad den gör, speciellt om det upptäcker fel i GEDCOM filen. Ignorera dessa fel i ett första steg: din databas kommer att skapas ändå. Om allt är Ok, måste kommandot avslutas med:


     *** Ok

Kommandot gwb2ged

Innan vi fortsätter, låt oss notera att det omvända kommandot, "gwb2ged", tillåter att återuppbygga en GEDCOM fil från en GeneWeb bas.

Kommandot gwd

När du har skapat en databas, med en av kommandona "gwc" eller "ged2gwb", kan du konsultera och utöka den.

Alltid i DOS fönstret, skriv:


     gwd

Kommandot startar GeneWeb "demonen". Kommandot måste visa:


     GeneWeb 1.0 - Copyright (c) INRIA 1998

     Possible addresses:

	http://localhost:2317/base

	http://127.0.0.1:2317/base

	http://address:2317/base

     where "base" is the name of the data base

     Type control C to stop the service

     Ready (day) (hour) port 2317...

Notera att du inte se prompt i DOS fönstret. Detta program väntar för förfrågningar som du kommer sända till den från din webbläsare. När den motar en förfrågan behandlas den och sedan väntar programmet igen. När du är klar med att använda GeneWeb, kan du stoppa den genom att trycka "Control-C" i DOS fönstret.

Nu kan du verkligen start. Eftersom du tittar på denna dokumentation, använder du en webbläsare. Starta ett nytt fönster i denna webbläsare och öppna den följande adressen. Byt ut "svensson" mot namnet för din databas. Varning: skriv inte in det kompletta namnet (like "c:\program\geneweb\svensson" eller "/home/geneweb/svensson"), just "svensson".


     http://localhost:2317/svensson

Du måste se GeneWebs välkomst sida på franska.

[Om det inte fungerar, klicka här]

Välj ett annat språk (t ex engelska), på flaggorna högst upp på sidan. (Det finns ett sätt att välja ett default språk annat än franska. Se vidare).

Från där, kan du konsultera den som klassisk webbtjänst, klicka på länkar och knappar, fylla i areas, etc. Tips: i ett första steg, klicka på "Ok" där efter "Alla efternamn i alfabetisk ordning", och sedan på den nya sidan som visar sig: "hela listan". Välj ett efternamn, sedan en person etc, och navigera.

Den endast möjliga att göra är att skapa en person och familjer. Klicka på "Lägg till familj". Hur du gör det kan du se här.

Under tiden, kan du notera att varje gång du klickar på en knapp eller en länk, visas en text rad i DOS fönstret. När du startar din GeneWeb server på Internet (se här), kan du se förfrågningarna som sänds till din databas på det här sättet.

Notera att om du trycker "Control-C" i ditt DOS fönster, svarar inte tjänsten inte längre i din webbläsaren. För att återstarta den, skriv "gwd" igen.

Under Windows, kan du enkelt dubbel klicka på ikonen "gwd" för att starta den. Den öppnar ett DOS fönster där "gwd" visar sina textrader. Om man trycker "Control-C" stoppar "gwd" och fönstret stängs. Om man skapar en genväg till "gwd" på skrivbordet, kan du starta den enkelt.

Kommandot consang

Detta kommando måste startas i ett DOS fönster, som de andra. Om "gwd" demonen körs, tryck "Control-C" för att stopps den. Ett annat sätt, om du inte vill stoppa demonen, består i att starta en andra DOS fönster och följa instruktionerna för introduktionen ovan.

Kommandot "consang" beräknar blodsbandet i en databas. Visandet av blodsband görs när man konsulterar databasen, i personliga sidan och medan man beräknar släktskap.

Men för att ha access till den måste du för beräkna de individuella blodsbanden för personerna i databasen. Detta är vad "consang" gör. Om din databas namn är "svensson", skriv:


     consang svensson

Program kommer att beräkna några sekunder eller minuter, beroende på storleken av din databas och visa utan att stoppa numret av återstående persons att behandla. Till slut, har du prompten igen i DOS fönstret och de individuella blodsbanden är lagrade.

Under denna beräkning, om du inte stoppade demonen, kan du återvända till webbläsare och konsulter din databas.

Kör "consang" ibland, om du gjorde modifieringar i din databas, speciellt om det är att lägga till, modifiera, radera familjer: blodsbandet beror på familj strukturen. Om den ändras, den individuella blodsbanden är inte längre åtkomliga och du måste beräkna om dem.

Vidare gör "consang" en intern "upprensning" av databasen, nödvändig efter ett antal uppdateringar.

Kommandot gwu

[Detta kommando hette "gwb2gw" i väldigt gamla versioner].

Detta kommando visar innehållet i databasen i text form. Om dirigering av denna display till en fil, kan constitute en saving av din databas.

Om din databas heter "svensson", och du vill spara den i filen "foo.gw", skriv:


     gwu svensson > foo.gw

Sparning i olika filer i olika versioner av din databas, du kan se olikheter, genom att använda ett kommando för att jämföra text filer. Detta är speciellt intressant om någon har gjort modifieringar i diin databas och du vill veta vem.

Den finn också en metod för att återskapa din databas när du använder en annan version av GeneWeb, i det fallet den inre representationen av databasen har ändrats.

För att återskapa din databas, måste du använda kommandot "gwc". Den sparade filen måste ha filändelse ".gw". För att skapa en databas benämnd "svensson", från filen "foo.gw", skriv:


     gwc foo.gw -o svensson

Filen a.cnf

Denna fil innehåller en konfigurations mall för en databas. Om din databas namn är "svensson", gör en kopia av "a.cnf" döp om den till "svensson.cnf" och editera filen "svensson.cnf".

De konfigurerbara värdena är de följande:


     body_prop=background=mybackg.jpg vlink=yellow

Detta gäller inte bara till välkomst sidan men också på alla visade sidor för denna databas.

Om du sätter ett värde för denna variabel, kommer bara personer som har skrivit in passordet på välkomst sidan att ha tillträde till dessa data.

Om du sätter ett värde till denna variabel, kan bara personer som har skrivit in passordet på välkomst sidan att ha tillträde till modifikationer.

Notera att vilken språk än som är valt default, kan du välja ett annat på välkomst sidan genom att klicka på flaggorna högst upp på sidan.

Katalogen "lang" - filen "lexicon.txt"

Filen innehåller ett lexikon för alla termer och fraser använt av programmet. För varje finns det en översättning till varje språk. Om du vill lägga till ett språk, välj en kod för detta språk och lägga till en rad för varje översättnings grupp som finns i filen.

Ytterligare, om någon av de föreslagna översättningarna på något av språken inte passar dig , kan du ändra den.

När du sparar filen "lexicon.txt", kommer detta att appliceras omedelbart på visningen i din webbläsare. Du behöver kanske trycka på "reload".

Katalogen "lang" - underkataloger

Varje underkatalogs namn är en språk kod. Varje innehåller en default välkomst sida för detta språk: filen är benämnd "start.txt".

Du kan ändra denna välkomst sida för en given databas. För databasen "svensson" i språket "xx", gör helt enkelt en kopia av filen "start.txt" i katalogen "xx" döpa den till "svensson.txt". Editera filen "svensson.txt" och gör de ändringar du vill. Du kan göra detta för varje språk.

Obs: dessa filer innehåller HTML kod med vissa indications: % tecken följt av en bokstav. Det finns makros som "gwd" kommer att byta ut med värden. Till exempel, "%t" är utbytt mot namnet för databasen, "%b" mot värdet för "body_prop" i konfigurationsfilen, etc.

Den kompletta beskrivningen för dessa makron finns här.

Tillbaka till bruksanvisningen.


© Copyright INRIA 1999 - GeneWeb