Démarrer avec GeneWeb

Attention: cette approche suppose que vous êtes à l'aise avec la notion de "fichier" et de "répertoire" et que vous n'avez pas peur de taper des commandes; sinon, utilisez plutôt le programme gwsetup.

	Introduction
	Commande gwc
	Commande ged2gwb
	Commande gwb2ged
	Commande gwd
	Commande consang
	Commande gwu
	Fichier a.gwf
	Répertoire "lang" - fichier "lexicon.txt"
	Répertoire "lang" - sous-répertoires

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

	Sous Unix, si vous l'avez installé par exemple dans "/home/smith/geneweb": cd /home/smith/geneweb
	Sous Windows 95/NT, si vous l'avez installé par exemple dans "C:\soft\geneweb": cd c:\soft\geneweb

Puis allez dans le sous-répertoire "gw", en tapant:

     cd gw

Exemple, si vous tapez:

     gwd -help

     Usage: gwd [options] where options are:
       -hd <dir>
	    Directory where the directory lang is installed.
       -bd dir>
	    Directory where the databases are installed.
       -cgi 
	    Force cgi mode.
       -p <number>
	    Select a port number (default = 2317); > 1024 for normal users.
       -wizard <passwd>
	    Set a wizard passord: access to all dates and updating.
       -friend <passwd>
	    Set a friend password: access to all dates.
       -lang <lang>
	    Set a default language (default: fr).
       -only <address>
	    Only inet address accepted.
       -auth <file>
	    Authorization file to restrict access. The file must hold lines
	    of the form "user:password".
       -log <file>
	    Redirect log trace to this file.
       -nolock 
	    Do not lock files before writing.

Certaines commandes sont un peu bavardes. Vous pouvez rediriger leur affichage dans un fichier en les terminant par "> fichier". Exemple:

     gwd -help > toto.txt

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

     gwc -o dupont

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 interactive, tapez simplement:

     gwd

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

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

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\gw\dupont" ou "/home/geneweb/gw/dupont"), mais juste "dupont" tout court.

     http://localhost:2317/dupont

Si vous êtes parti d'un fichier GEDCOM (ged2gwb), vous devez voir au début le nombre de personnes de votre base. À 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.

Si vous êtes parti d'une base vide (gwc), la page d'accueil vous dira que la base contient 0 personnes. 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 interactive. 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 interactive, 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 interactive 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.

     consang dupont

     gwu dupont > toto.gw

     gwc toto.gw -o durand

Les valeurs configurables sont les suivantes:

body_prop permet de configurer les couleurs de fond, ou d'y mettre un motif et de changer la couleur du texte et des liens. Sa syntaxe est la syntaxe HTML acceptée dans le tag "<body>" avant le ">". Voyez votre documentation HTML. Exemple: 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.

friend_passwd (mot de passe "ami") permet de limiter la visibilité des données sur les personnes encore vivantes, en fait sur toutes les personnes nées ou décédées depuis moins d'un siècle. 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.

wizard_passwd (mot de passe "magicien") permet de limiter le droit de faire des modifications dans votre 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 aux modifications.

wizard_just_friend ("magicien" seulement "ami") permet d'interdire la mise à jour de la base. Mettez "yes" pour le faire, "no" pour remettre l'autorisation. Il peut être utile de mettre "yes", temporairement, pendant la nettoyage de votre base.

default_lang permet de spécifier une langue par défaut de la page d'accueil. Sans précision, la langue est le français. Les valeurs possibles sont: "af" (afrikaans), "bg" (bulgare), "cs" (tchèque), "ca" (catalan), "de" (allemand), "da" (danois), "en" (anglais), "eo" (espéranto), "es" (espagnol), "et" (estonien), "fi" (finlandais), "fr" (français), "he" (hébreu), "is" (islandais), "it" (italien), "lv" (letton), "nl" (néerlandais), "no" (norvégien), "pl" (polonais), "pt" (portugais), "pt-br" (portugais brésilien), "ro" (roumain), "ru" (russe), "sl" (slovène), "sv" (suédois), "zh" (chinois), 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.

can_send_image (peut envoyer des images) permet d'autoriser les "magiciens" à envoyer (et supprimer) des images. Dans ce cas, au moment des mises à jour, ils peuvent cliquer sur un lien envoyer image (et éventuellement un autre intitulé supprimer image). Par défaut, c'est "no" (on ne peut pas en envoyer); pour l'autoriser, il faut mettre explicitement "yes". Attention: les images seront enregistrées sur votre ordinateur, et peuvent donc consommer beaucoup d'espace disque, s'il y a beaucoup d' images envoyées.

renamed (renommée) permet d'indiquer qu'une base a été renommée. Si votre site a beaucoup éte consulté et que votre base a été mise dans beaucoup de signets de beaucoup de personnes, c'est un moyen pour les rediriger vers votre base, avec son nouveau nom. S'ils essaient d'accéder à l'ancien nom, ils verront une page avec un lien de la même requête vers le nouveau nom.