Démarrer avec GeneWeb

Ce chapitre contient une introduction à {GeneWeb}, avec une description succinte des
commandes et des fichiers afin de pouvoir démarrer.

<p>

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/gwsetup]]].

<p>

<ul>

<li> <a href="#Int">Introduction</a>

<li> <a href="#Gwc">Commande gwc</a>

<li> <a href="#Ged">Commande ged2gwb</a>

<li> <a href="#Gee">Commande gwb2ged</a>

<li> <a href="#Gwd">Commande gwd</a>

<li> <a href="#Csg">Commande consang</a>

<li> <a href="#Gwu">Commande gwu</a>

<li> <a href="#Cnf">Fichier a.gwf</a>

<li> <a href="#Lex">Répertoire "lang" - fichier "lexicon.txt"</a>

<li> <a href="#Lng">Répertoire "lang" - sous-répertoires</a>

</ul>

<a name="Int"></a>
== Introduction  ==

Pour configurer et démarrer {GeneWeb}, vous devez
utiliser des commandes interactives. Sous Unix, lancez un
xterm. Sous Windows 95/NT, cliquez sur "Démarrer", "Programmes"
et "Invite de Commandes" (ça s'appelle parfois "Commandes
MSdos").

<p>

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

<ul>

<li> Sous Unix, si vous l'avez installé par exemple dans
"/home/smith/geneweb":
<pre>
     cd /home/smith/geneweb
</pre>

<li> Sous Windows 95/NT, si vous l'avez installé par exemple dans
"C:\soft\geneweb":
<pre>
     cd c:\soft\geneweb
</pre>

</ul>

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

<pre>
     cd gw
</pre>

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.

<p>

Exemple, si vous tapez:
<pre>
     gwd -help
</pre>

vous devez voir quelque chose du genre:

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

<p>

Certaines commandes sont un peu bavardes. Vous pouvez rediriger leur
affichage dans un fichier en les terminant par "&gt;&nbsp;fichier".
Exemple:
<pre>
     gwd -help &gt; toto.txt
</pre>

<p>

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


<a name="Gwc"></a>
== 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.

<p>

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

<p>

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

<p>

Par exemple, si vous voulez l'appeler "dupont", tapez:
<pre>
     gwc -o dupont
</pre>


<a name="Ged"></a>
== Commande ged2gwb   ==

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

<p>

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

<p>

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 interactive, si
vous savez le faire, soit en déplaçant les icônes.

<p>

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

<pre>
     ged2gwb toto.ged -o dupont
</pre>

<p>

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:

<pre>
     *** Ok
</pre>


<a name="Gee"></a>
== Commande gwb2ged   ==

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


<a name="Gwd"></a>
== 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.

<p>

Toujours dans la fenêtre interactive, tapez simplement:

<pre>
     gwd
</pre>

<p>

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

<pre>
     GeneWeb - Copyright (c) 1998-2006 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...
</pre>

<p>


Remarquez que vous ne reprenez pas la main dans la fenêtre
interactive. 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
interactive.

<p>

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.

<pre>
     http://localhost:2317/dupont
</pre>

<p>

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

<p>

[Si cela ne fonctionne pas, cliquez [[[problem/ici]]]]

<p>

<ul>
<li>
Si vous êtes parti d'un fichier GEDCOM (ged2gwb), vous devez voir au
début le nombre de personnes de votre base.

<p>

À 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.

</ul>

<p>

<ul>

<li> Si vous êtes parti d'une base vide (gwc), la page
d'accueil vous dira que la base contient 0 personnes.

<p>

La seule chose possible est de commencer à remplir la base en
cliquant sur "Ajouter une famille". Voyez le chapitre: comment faire
des [[[update/modifications]]] dans la base de
données.

</ul>

<p>

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
[[[server/serveur]]] {GeneWeb} sur le
réseau, vous pourrez ainsi voir les requêtes qui seront
faites sur votre base.

<p>

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.

<p>

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.


<a name="Csg"></a>
== Commande consang   ==

Cette commande doit être lancée dans la fenêtre
interactive, 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 interactive, en suivant
l'indication de l'introduction.

<p>

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é.

<p>

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:

<p>

<pre>
     consang dupont
</pre>

<p>

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 interactive et les
consanguinités individuelles seront enregistrées.

<p>

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

<p>

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.

<p>

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


<a name="Gwu"></a>
== Commande gwu   ==

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.

<p>

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

<p>
<pre>
     gwu dupont > toto.gw
</pre>

<p>

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.

<p>

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é.

<p>

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:

<p>
<pre>
     gwc toto.gw -o durand
</pre>


<a name="Cnf"></a>
== Fichier a.gwf   ==

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

<p>

Les valeurs configurables sont les suivantes:

<ul><li> <strong>body_prop</strong> 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
"&lt;body&gt;" avant le "&gt;". Voyez votre documentation
HTML. Exemple:

<pre>
     body_prop=background=monfond.jpg vlink=yellow
</pre>

<p>

Ceci s'applique non seulement à la page d'accueil mais à
toutes les pages affichées de cette base.
</ul>

<p>

<ul><li> <strong>friend_passwd</strong> (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.

<p>

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.

</ul>

<p>

<ul><li> <strong>wizard_passwd</strong> (mot de passe "magicien")
permet de limiter le droit de faire des modifications dans votre base.

<p>

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.

</ul>

<p>

<ul><li> <strong>wizard_just_friend</strong> ("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 [[[maint/nettoyage]]] de votre base.

</ul>

<p>

<ul><li> <strong>default_lang</strong> 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),
"br" (breton),
"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),

<p>

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.

</ul>

<p>

<ul><li> <strong>can_send_image</strong> (peut envoyer des images)
permet d'autoriser les "magiciens" à envoyer (et supprimer) des
images. Dans ce cas, au moment des [[[update#MAJ/mises à jour]]], ils peuvent cliquer sur un lien [[[update#SndP/envoyer image]]] (et éventuellement un
autre intitulé [[[update#DelPh/supprimer image]]]). Par défaut, c'est "no" (on ne peut pas en envoyer);
pour l'autoriser, il faut mettre explicitement "yes".

<p>

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.

</ul>

<p>

<ul><li> <strong>renamed</strong> (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.

</ul>


<a name="Lex"></a>
== 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.

<p>

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

<p>

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".


<a name="Lng"></a>
== 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".

<p>

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.

<p>

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.

<p>

La description complète de ces macros est donnée [[[pcustom/ici]]].

<p>

<br>
<center>Retour vers [[[diruse/Mode d'Emploi]]]</center>

