Démarrer avec GeneWeb

Cette documentation contient une introduction à GeneWeb, avec une description succinte des commandes et des fichiers afin de pouvoir démarrer.

Introduction

Pour configurer et démarrer GeneWeb, vous devez utiliser des commandes intéractives. Sous Unix, lancez un xterm. Sous Windows 95/NT, cliquez sur "Démarrer", "Programmes" et "Invite de Commandes".

Dans cette fenêtre, tapez la commande pour aller dans le répertoire où vous avez installé GeneWeb:

Toutes les commandes de GeneWeb peuvent être lancées avec l'option -help qui affiche les différentes options possibles, avec une petite explication, en anglais.

Exemple, si vous tapez:

     gwd -help
vous devez voir quelque chose du genre:
     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

Les bases de données GeneWeb sont des répertoires avec l'extension ".gwb".

Commande gwc

Pour utiliser GeneWeb, vous devez créer une base de données. Vous pouvez le faire soit avec cette commande-ci, "gwc", soit avec "ged2gwb", section suivante.

La commande "gwc", dans son utilisation la plus simple, crée une base de données vide: sous GeneWeb, vous allez pouvoir la remplir.

Vous devez donner un nom à cette base. N'importe quel nom convient. Ne dépassez pas, de préférence, 8 lettres.

Par exemple, si vous voulez l'appeler "dupont", tapez:

     gwc -o dupont

Commande ged2gwb

Un autre moyen de créer une base de données GeneWeb est de partir d'un fichier GEDCOM.

La commande "ged2gwb" vous permet de convertir un fichier GEDCOM en base de données GeneWeb.

Le plus simple est d'abord de copier votre fichier GEDCOM dans le répertoire où vous avez installé GeneWeb. Faites-le avec votre méthode habituelle pour copier des fichiers, soit avec une commande intéractive, si vous savez le faire, soit en déplaçant les icônes.

Si votre fichier GEDCOM s'appelle, par exemple, "toto.ged" et que vous voulez créer une base de nom "dupont", tapez:

     ged2gwb toto.ged -o dupont

La commande est un peu bavarde, surtout si elle découvre des erreurs dans le fichier GEDCOM. Ignorez ces erreurs dans un premier temps: votre base sera quand même fabriquée. Si tout se passe bien, la commande doit se terminer par:

     *** Ok

Commande gwb2ged

Avant de continuer, notons en passant la commande inverse, "gwb2ged", permettant de reconstituer un fichier GEDCOM à partir d'une base GeneWeb.

Commande gwd

Une fois que vous avez créé une base, avec une des deux commandes "gwc" ou "ged2gwb", vous allez pouvoir enfin la consulter et l'étendre.

Toujours dans la fenêtre intéractive, tapez simplement:

     gwd

Cette commande lance le "démon" GeneWeb. La commande doit afficher:

     GeneWeb 1.0 - Copyright (c) INRIA 1998
     Possible addresses:
	http://localhost:2317/base
	http://127.0.0.1:2317/base
	http://adresse:2317/base
     where "base" is the name of the data base
     Type control C to stop the service
     Ready (jour) (heure) port 2317...

Remarquez que vous ne reprenez pas la main dans la fenêtre intéractive. Ce programme attend des requêtes que vous allez lui faire par l'intérmédiaire de votre navigateur Web. Pour l'arrêter, faites control-C.

Maintenant, on va pouvoir y aller. Puisque vous consultez cette documentation, vous êtes donc en train d'utiliser un navigateur Web. Prenez une nouvelle fenêtre dans ce navigateur et ouvrez la location suivante. Remplacez "dupont" par le nom de votre base. Attention: ne mettez pas le nom complet (style "c:\geneweb\dupont" ou "/home/geneweb/dupont"), mais juste "dupont" tout court.

     http://localhost:2317/dupont

Vous devez voir apparaître la page d'accueil de GeneWeb.

[Si cela ne fonctionne pas, cliquez ici]

Pendant ce temps, vous pouvez constater que chaque fois que vous cliquez sur un bouton ou un lien, une trace apparait dans la fenêtre intéractive. Quand vous ferez fonctionner votre serveur GeneWeb sur le réseau, vous pourrez ainsi voir les requêtes qui seront faites sur votre base.

Notez que si vous tapez control-C dans la fenêtre intéractive, le service ne répondra plus dans votre navigateur. Pour le relancer, tapez simplement "gwd" de nouveau.

Commande consang

Cette commande doit être lancée dans la fenêtre intérative, comme les autres. Si le démon "gwd" tourne, tapez control-c pour l'arrêter. Une autre solution, si vous ne voulez pas arrêter le démon, consiste à lancer une autre fenêtre de commande intéractives, en suivant l'indication de l'introduction.

La commande "consang" calcule les consanguinités dans une base de données. Le calcul des consanguinités est une spécialité de GeneWeb. L'affichage des consanguinités se fait à la consultation de la base, dans les fiches personnelles, et au moment des calculs de parenté.

Mais pour y avoir accès, il faut précalculer les consanguinités individuelles des personnes de la base. C'est ce que permet "consang". Si votre base s'appelle toujours "dupont", tapez:

     consang dupont

Le programme va calculer quelques secondes ou minutes, suivant la taille de votre base, en affichant sans arrêt le nombre de personnes restant à traiter. À la fin, vous reprendrez la main dans la fenêtre intéractive et les consanguinités individuelles seront enregistrées.

Pendant ce calcul, si vous n'avez pas arrêté le démon, vous pouvez parfaitement retourner dans votre navigateur et consulter votre base.

Lancez "consang" de temps en temps, si vous avez fait des modifications dans votre base, surtout si ce sont des ajouts, modications, suppressions de familles: la consanguinité dépend de la structure des familles. Si celle-ci change, les consanguinités individuelles ne sont plus valables et il faut les recalculer.

En outre "consang" fait un "nettoyage" interne de votre base, nécessaire après un certain nombre de mises à jour.

Commande gwu

[Cette commande s'appelait "gwb2gw" dans de précédentes versions].

Cette commande permet d'afficher le contenu de la base sous forme de texte. En redirigeant cet affichage vers un fichier, cela peut constituer une sauvegarde de votre base.

Si votre base s'appelle "dupont", et que vous pouvez la sauvegarder dans le fichier "toto.gw", tapez:

     gwu dupont > toto.gw

En sauvegardant dans des fichiers différents, après avoir fait des modifications, vous pourrez ainsi comparer différentes versions de votre base, et voir les modifications faites, en utilisant une commande de comparaisons de fichiers. Ceci est particulièrement intéressant si quelqu'un d'autre a fait des modifications dans votre base.

C'est enfin une méthode pour reconstituer votre base quand vous prenez une nouvelle version de GeneWeb, dans le cas où la représention interne des bases a changé.

Pour reconstituer votre base, vous devez utiliser la commande "gwc". Le fichier sauvegardé doit avoir obligatoirement l'extension ".gw". Pour fabriquer une base de nom "durand" à partir du fichier "toto.gw" ci dessus, tapez:

     gwc toto.gw -o durand

Fichier a.cnf

Ce fichier contient une configuration-type pour une base de données. Si votre base s'appelle "dupont", faites une copie de "a.cnf" en l'appelant "dupont.cnf" et éditez le fichier "dupont.cnf".

Les valeurs configurables sont les suivantes:

Répertoire "lang" - fichier "lexicon.txt"

Ce fichier contient le lexique. Pour chaque terme utilisé dans le programme, il y a une traduction dans chaque langue. Si vous voulez ajouter une langue, choisissez un code pour cette langue, et ajoutez une ligne avec ce code pour chaque groupe de traduction des termes que vous voyez dans le fichier.

De plus, si une des traductions proposées dans une des langues déjà présentes ne vous convient pas, vous pouvez la changer.

Quand vous sauvegarderez le fichier "lexicon.txt", cela sera immédiatement visible à l'affichage dans le navigateur. Il faudra tout de même faire "recharger la page".

Répertoire "lang" - sous-répertoires

Chaque nom de sous-répertoire est un code de langue. Chacun contient la page d'accueil dans cette langue: le fichier s'appelle "start.txt".

Vous pouvez changer cette page d'accueil pour une base donnée. Pour la base "dupont", il vous suffit de créer un fichier "dupont.txt" dans le ou les sous-répertoires de langues. Le plus simple est de partir d'une copie du fichier "start.txt" du sous-répertoire en question et de l'adapter.

Remarque: ces fichiers contiennent du code HTML avec des indications particulières: des signes % suivis d'une lettre. Ce sont des macros que "gwd" va remplacer par des valeurs. Par exemple, "%t" est remplacé par le nom de la base, "%b" par la valeur de "body_prop" du fichier de configuration, etc.

La doc complète de ces macros n'est pas encore écrite.

Retour vers Mode d'Emploi.


© Copyright INRIA 1998 - GeneWeb