Si vous voulez faire un rapport d'anomalie, des remarques, ou des suggestions, voyez cette page.
Dans cette fenêtre, tapez la commande pour aller dans le répertoire où vous avez installé GeneWeb:
$ cd /home/smith/geneweb
C:> cd c:\soft\geneweb
Exemple, si vous tapez:
gwd -help
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".
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
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
Toujours dans la fenêtre intéractive, tapez simplement:
gwd
Cette commande lance le "démon" GeneWeb. Ce programme attend des requêtes que vous allez lui faire par l'intérmédiaire de votre navigateur Web. 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. Le démon est en attente, va traiter des requêtes, et ne s'arrêtera que quand vous taperez 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):
http://localhost:2317/dupont
Vous devez voir apparaître la page d'accueil de GeneWeb.
À partir de là, vouz pouvez consulter comme un service Web classique, en cliquant sur les liens et les boutons, en remplissant des zones, etc. Conseil: dans un premier temps, cliquez sur le "Ok" après "Tous les noms par ordre alphabétique" et, dans la page qui apparaîtra, recliquez sur "Toute la liste". Sélectionnez alors un nom, puis une personne, et naviguez.
La seule chose possible est donc de créer des personnes et des familles. Cliquez sur "Ajouter une personne" ou "Ajouter une famille". La documentation d'explication de cette partie-là n'est pas encore écrite. Si vous êtes un peu curieux, essayez tout de même. Les différentes zones à remplir sont supposées être suffisamment auto-explicatives. En tâtonnant un peu vous arriverez à comprendre l'utilisation de ces différentes zones.
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 (explications pas encore écrites), 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.
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.
Si votre base s'appelle "dupont", et que vous pouvez la sauvegarder dans le fichier "toto.gw", tapez:
gwb2gw 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
Les valeurs configurables sont les suivantes:
body_prop=background=monfond.jpg vlink=yellow
Ceci s'applique non seulement à la page d'accueil mais à toutes les pages affichées de cette base.
Si vous mettez une valeur à ce champ, seulement les personnes qui auront mis le mot de passe à partir de la page d'accueil auront accès à ces données.
Si vous mettez une valeur à ce champ, seulement les personnes qui auront mis le mot de passe à partir de la page d'accueil auront accès aux modifications.
Notez que quelque soit la langue sélectionnée par défaut vous pouvez en choisir une autre dans la page d'accueil, en cliquant dans le tableau à la fin de cette page.
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".
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.