Dans cette fenêtre, tapez la commande pour aller dans le répertoire où vous avez installé GeneWeb:
cd /home/smith/geneweb
cd c:\soft\geneweb
Exemple, si vous tapez:
gwd -helpvous 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
Certaines commandes sont un peu bavardes. Vous pouvez rediriger leur affichage dans un fichier en les terminant par "> fichier". Exemple:
gwd -help > toto.txt
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. La commande doit afficher:
GeneWeb 1.0 - Copyright (c) INRIA 1999 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'intermédiaire de votre navigateur Web. Quand vous avez fini d'utiliser Geneweb, vous pouvez l'arręter en faisant control-C dans la fenêtre intéractive.
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]
À partir de là, vous 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 de commencer à remplir la base en cliquant sur "Ajouter une famille". Voyez le chapitre: comment faire des modifications dans la base de données.
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.
Sous Windows, vous pouvez simplement double-cliquer sur l'icône de "gwd" pour le lancer. Cela ouvrira une fenêtre intéractive où "gwd" affichera ses traces. En tapant Control-C, "gwd" s'arrêtera et la fenêtre se fermera. En créant un raccourci de "gwd" sur le bureau, vous pourrez l'utiliser de manière très simple.
La commande "consang" calcule les consanguinités dans une base de données. 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.
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
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 son drapeau en haut de la 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 description complète de ces macros est donnée ici.
Retour vers Mode d'Emploi.