Difference between revisions of "OSX/fr"

From GeneWeb
Jump to: navigation, search
(OSX (fr) pass 0)
 
(Commentaire sur `dirname $0` dans gwd et gwsetup)
 
(36 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:Installer GeneWeb sous OS X}}
 
{{DISPLAYTITLE:Installer GeneWeb sous OS X}}
 
{{languages|OSX}}
 
{{languages|OSX}}
 +
{{toc right}}
 +
L’'''installation de GeneWeb sous OS X''' se fait par une simple décompression de l’archive fournie en téléchargement.
  
==Installation simplel==
+
Ces étapes ont été testées sur OS X Yosemite avec geneweb-6.07.tgz<!--inexistant gw-6.07-OSXLion.tgz ?--> :
[[File:GeneWeb-Start-simple.png|thumb|320px|Traces sur une fenêtre terminal au démarrage de GeneWeb.]]
+
* [[Download/fr|télécharger GeneWeb]], il est conseillé de prendre la dernière version disponible pour OS X ;
L'installation la plus simple se apsse de la façon suivante (testée au moins sur OSX Yosemite) :
+
* double-cliquer sur l’archive téléchargée permet de la décompresser dans un sous-dossier du même nom ;
* [[Doanload/fr|Télécharger]] la version appropriée. La dernière version disponible sur [http://opensource.geneanet.org/projects/geneweb/wiki/Fr_home] est {{c|geneweb-6.07.tgz}}.
+
* (optionnel) déplacer ce dossier avec les autres programmes ;
* Cliquer deux fois sur le fichier {{c|.tgz}} construit dans votre dossier téléchargements un nouveau dossier appelé {{c|geneweb-6.07}}.
+
* démarrer GeneWeb en double-cliquant sur {{c|geneweb.command}} (et non sur {{c|gwd}} ou {{c|gwsetup}}).
* Deplacez ce dossier à l'endroit de votre choix.
+
* Démarrez GeneWeb en cliquant deux fois sur l'icône du fichier {{c|GeneWeb.command}} (et non sur els icônes de {{c|gwd}} ou {{c|gwsetup}}). Ceci devrait ouvrir une fenêtre terminal avec une trace du démarrage, et une page dans votre navigateur préféré avec la page de démarrage de GeneWeb.
+
[[File:GeneWeb-Start.png|thumb|400px|center|Page de démarrage de GeneWeb.]]
+
* Si la fenêtre terminal vous indique un échec au démarrage, ceci peut être du à certains aspects de vorte environnement.
+
: Essayez la procedure suivante :
+
:* Faites une copie de sauvegarde de {{c|GeneWeb.command}}
+
:* Ouvrez le fichier {{c|GeneWeb.command}} dans un éditeur de texte.
+
:* remplacez la ligne
+
: <code>trap 'kill $pids' 1 2</code>
+
:: par
+
: <code>killall gwd</code>
+
: <code>killall gwsetup</code>
+
:: et sauvegardez le résultat.
+
:* Démarrez GeneWeb en cliquant deux fois sur l'icône de la nouvelle version de {{c|GeneWeb.command}}.
+
  
==Installation de versions multiples==
+
Un terminal s’ouvre avec une trace de l’exécution et la page de démarrage de GeneWeb apparait dans le navigateur par défaut.
Il est possible d'installer sur vorte ordinateur  (ou serveur) plusieurs versions de GeneWeb qui pourront être démarrées alternativement.
+
<div><ul>
 +
<li style="display: inline-block;"> [[File:GeneWeb-Start-simple.png|420px|Traces sur un terminal au démarrage de GeneWeb.]] </li>
 +
<li style="display: inline-block;"> [[File:GeneWeb-Start.png|400px|center|Page de démarrage de GeneWeb.]] </li>
 +
</ul></div>
  
La première étape consiste à organiser une structure de dossier qui contiendra les divers éléments. Les options sont variées et dépendent des goûts personnels, mais la proposition faite ici à pour objectif d'expliciter le rôle de chaque dossier afin de vous permetrte de faire votre propre choix.
+
Si le terminal indique une erreur, éditer le fichier GeneWeb.command et remplacer la ligne {{c|trap 'kill $pids' 1 2}} par :
 +
killall gwd
 +
killall gwsetup
  
Nous faisons l'hypothèse que tous les dossiers sont rassemblés sous une racine appelée {{c|/Home/Genealogie}}. Ce dossier contiendra deux sous-dossiers :
+
Sur certaines versions, le fichier {{c|gwd.command}} est absent et/ou le fichier {{c|gwd}} ne s'exécute pas correctement. Y rajouter la ligne {{c|cd `dirname $0`}}.
* GeneWeb : contenant les fichiers exécutables et lcertains fichiers paramètre associés
+
#!/bin/sh
* GeneWeb-Bases : contenant toutes les données généalogique et des fichiers paramètres spécifiques aux bases
+
cd `dirname $0`
 +
mkdir -p bases
 +
cd bases
 +
exec ../gw/gwd -hd ../gw "$@"
  
 +
Il devient alors possible de démarrer directement {{c|gwd}} à partir d'une fenêtre terminal (l'action d'édition du fichier semble détruire sa capacité à s'exécuter en cliquant dessus!).
  
 +
==Installation de versions multiples==
 +
Il est possible d’installer sur votre ordinateur (ou serveur) plusieurs versions de GeneWeb qui pourront être démarrées alternativement, ce qui peut être utile pour faire migrer des bases d’une version à l’autre.
  
(a suivre)
+
La première étape consiste à organiser une structure de dossier qui contiendra les divers éléments. Les options sont variées et dépendent des goûts personnels, mais la proposition faite ici a pour objectif d’expliciter le rôle de chaque dossier afin de vous permettre de faire votre propre choix.
  
 +
Tous les dossiers sont rassemblés sous une racine appelée {{c|/home/genealogy/}} qui contient deux sous-dossiers GeneWeb et GeneWeb-Bases ainsi que des fichiers commande de lancement de plusieurs versions de GeneWeb différentes. Le répertoire {{c|geneweb/}} contient les fichiers exécutables et certains fichiers paramètre associés. Le répertoire {{c|bases/}} contient toutes les données généalogique et des fichiers paramètres spécifiques aux bases.
  
Installing multiple versions of GeneWeb is possible. The following section describes one approach. One of its benefits is to make more explicit several aspects of the folder structure expected by GeneWeb.
+
{{arbre début}}
 +
* {{d}} {{c|genealogy}}
 +
** {{d}} {{c|geneweb}}
 +
** {{d}} {{c|bases}}
 +
** {{f}} {{c|gw-mac-6.08.command}}
 +
** {{branche finale}} {{f}} {{c|gw-mac-7.00.command}}
 +
{{arbre fin}}
  
The first step is to organise a folder structure which will contain the various elements. Although style and taste may vary, here is a proposal for such a structure which is rather general, identifies the various components associated with GeneWeb and is amenable to changes.
+
[[File:Folder-GeneWeb.png|thumb|320px|right|Structure du dossiers GeneWeb sous Mac OS X (binaries et code source).]]
  
All the genealogy files are located in a folder called '''Genealogy''' sitting in “Home”, and containing two sub-folders "GeneWeb" (sources and binaries.
+
=== Dossier des exécutables : {{c|geneweb/}}===
This folder may be called bases in subsequent discussions and examples) and “GeneWeb-Bases” (bases and other base specific data. a specific base may be called '''base''' in the following discussions and examples) and two command files launching each one particular version of '''gwd''' and '''gwsetup''' ([[gwd-start|Starting gwd]]):
+
Le contenu de {{c|GeneWeb/}} est organisé de la façon suivante :
  
<pre>
+
Plusieurs dossiers {{c|geneWeb-x.yy-mac/}} contiennent, chacun pour une version de GeneWeb, le même ensemble de fichiers que dans l’installation simple.
iMac-H:Genealogy Henri$ cd ~/Genealogy/
+
iMac-H:Genealogy Henri$ pwd
+
/Users/Henri/Genealogy
+
iMac-H:Genealogy Henri$ ls -al
+
total 24
+
drwxr-xr-x   5 Henri  staff    170 14 oct 12:57 .
+
drwxr-xr-x+ 81 Henri  staff  2754 14 oct 13:28 ..
+
-rw-r--r--@  1 Henri  staff  10244 14 oct 13:28 .DS_Store
+
drwxr-xr-x  8 Henri  staff    272 14 oct 12:59 GeneWeb
+
drwxr-xr-x  13 Henri  staff    442 14 oct 13:04 GeneWeb-Bases
+
-rwxr-xr-x@  1 Henri  staff  3036  8 sep 12:14 Gw-Mac-6.08.command
+
-rwxr-xr-x@  1 Henri  staff  3160 20 sep 05:55 Gw-Mac-7.00.command
+
iMac-H:Genealogy Henri$
+
</pre>
+
  
[[File:Folder-GeneWeb.png|thumb|320px|right|Folder structure under Mac OS X for GeneWeb (source code and binaries).]]
+
Le dossier {{c|geneweb-6.08-mac/}} contient un dossier {{c|bases/}} inutilisé car l’exécution de la commande {{c|gwd.command}} qu’il contient aura pu le créé.
  
=== GeneWeb===
+
Dans chaque dossier {{c|geneweb-x.yy-mac/}} on trouvera la même structure de sous-dossiers :
The content of GeneWeb is organized as follows:
+
* CHANGES.txt
 +
* gw/ : le dossier contenant un ensemble cohérent d’exécutables pour une version de GeneWeb. On se réfèrera à se dossier très souvent dans la documentation.
 +
** a.gwf : le fichier de [[configuration/fr|configuration]] d’une base par défaut
 +
** consang : l’exécutable de calcul de [[consang/fr|consanguinité]]
 +
** css/ : le dossier de stockage des feuilles de [[CSS|style]]
 +
** etc/ : le dossier de stockage des fichiers [[templates/fr|template]]
 +
** ged2gwb : l’exécutable de [[gwsetup/fr|lecture d’un fichier]] au format format GEDCOM vers une base {{c|.gwb}}
 +
** ged2gwb2 :  l’exécutable de [[gwsetup/fr|lecture d’un fichier]] au format format GEDCOM vers une base {{c|.gwb}} (nouveau format optimisé pour les grosses bases)
 +
** gwb2ged : l’exécutable qui [[gwsetup/fr|exporte]] au format GEDCOM le contenu d’une base
 +
** gwc : un alias de gwc1
 +
** gwc1 : l’exécutable de [[gwsetup/fr|lecture d’un fichier]] au format [[GWformat/fr|GWformat]] vers une base {{c|.gwb}}
 +
** gwc2 : l’exécutable de [[gwsetup/fr|lecture d’un fichier]] au format format  [[GWformat/fr|GWformat]] vers une base {{c|.gwb}} (nouveau format optimisé pour les grosses bases)
 +
** gwd : l’exécutable du serveur HTTP qui reçoit les requêtes vers les bases en renvoie les pages HTML
 +
** gwd.arg : le fichier des paramètres de lancement de [[man/fr|gwd]]
 +
** gwd.log : la trace d’exécution de [[man/fr|gwd]]
 +
** gwd.xcl : fichier d’[[access/fr|exclusion]]
 +
** gwsetup : l’exécutable du serveur HTTP qui reçoit les requêtes de [[gwsetup/fr|gestion des bases]] (création, sauvegardes, suppression, renommage),
 +
** gwu : l’exécutable qui [[gwsetup/fr|exporte]] depuis une base un fichier au format [[GWformat/fr|GWformat]] ou GEDCOM
 +
** images/ : le dossier contenant les icônes utilisées par gwd et gwsetup
 +
** lang/ : le dossier contenant les fichiers utilisés pour la [[lexicon/fr|traduction]] de l’interface utilisateur
 +
** only.txt : un fichier contenant une liste d’adresses IP contrôlant l’accès au serveur
 +
** setup/ : un dossier contenant les fichiers [[templates/fr|template]] utilisés par [[gwsetup/fr|gwsetup]]
 +
** tags.txt : un fichier donnant la liste des [[Tags]] HTML autorisés dans les notes
 +
**update_nldb : l’exécutable recalculant les index des pages de notes de la base
 +
* gwd : un fichier script lançant l’exécution de gwd
 +
* gwsetup : un fichier script lançant l’exécution de gwsetup
 +
* LICENSE.txt : le fichier décrivant la license de GeneWeb
 +
* START.html : la page HTML de démarrage de GeneWeb (qui apparaîtra après l’exécution de l’un des fichiers commande {{c|GeneWeb/Gw-Mac-x.yy.command}}).
  
The folders '''GeneWeb-x.yy-Mac''' contain copies (or moves) of the distribution folders created from sources for each version,
+
On ignore dans l’immédiat les deux dossiers gw-6.08-alpha-src et gw-7.00-Mac (code source) et le fichier gwget-7-00.sh
or directly downloaded (zip file) from a trusted source.
+
  
The folder GeneWeb-6.08-Mac contains a {{c|bases}} subfolder because the file {{c|gwd.command}} was executed which creates a {{c|bases}} folder right there. This folder is not used anywhere else in this setup (and could have been removed).
+
===Dossier des bases : {{c|GeneWeb-Bases/}}===
  
This setup has the advantage of maintaining active at least two running versions of GeneWeb which may be handy for moving bases from one version to the other.
+
Le dossier GeneWeb-Bases est organisé de la façon suivante :
In each '''GeneWeb-x.yy-Mac''' folder, a sub-folder '''gw''' contains all the executable files and associated data (default a.gwf, etc, images, lang, src sub-folders). '''gwsetup''' itself uses the setup sub-folder for its data.
+
  
'''gwd.arg''' contains the execution arguments for gwd (see [[gwd|Gwd]]).
+
[[File:Folder-Bases.png|thumb|320px|right|Folder structure under Mac OS X for GeneWeb-Bases (Genealogy data).]]
  
'''gwd.log''' contains the log traces produced by gwd. May be useful for some debuging!
+
* mabase-i.gwb/ : chaque base est conservée dans un dossier séparé
 
+
* mabase-i.gwf : un fichier de configuration spécifique à chaque base. Si absent gw/a.gwf
Note the '''tags.txt''' file containing the list of HTML tags authorized within the notes associated with each person (see [[Tags]]).
+
* cnt/ : contient les compteurs d’accès à chaque base et le fichier '''robot''' listant les adresses IP  devant être exclues suite à leur comportement.
 
+
* etc/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers template spécifiques à chaque base qui viennent se substituer à ceux de gw/etc. L’ordre de recherche des fichiers est :
The two folders gw-6.08-alpha-src and gw-7.00-Mac and file gwget-7-00.sh relate to GeneWeb sources and will be discussed in section [[#From sources]].
+
 
+
===GeneWeb-Bases===
+
The content of GeneWeb-Bases is organized as follows:
+
[[File:Folder-Bases.png|thumb|320px|right|Folder structure under Mac OSX for GeneWeb-Bases (Genealogy data).]]
+
 
+
Bases are stored in '''.gwb''' folders (base-1 and base-2 in our example). Each base may have its parameter '''.gwf''' file. If no parameter file exist, gwd will use the '''a.gwf''' default parameter file found in GeneWeb/GeneWeb-x.yy-Mac/gw
+
 
+
Other folders contain the following data:
+
* '''cnt''': contains access count for each base, and possibly a '''robot''' file remembering IP adresses behaving as robots and to be excluded.
+
* '''etc''': contains base specific '''etc''' files. When searching for etc files, '''gwd''' will scan the file system in the following order:
+
 
**.../bases/etc/base
 
**.../bases/etc/base
 
**.../bases/etc
 
**.../bases/etc
 
**.../gw/etc/base
 
**.../gw/etc/base
 
**.../gw/etc
 
**.../gw/etc
 +
* images/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers images associées aux personnes.
 +
* lang/ :
 +
* src/ : contient, dans autant de dossiers mabase-i/ que nécessaire, des fichiers .txt, et un dossier images/ (voir [[Images|Insérer des images dans les notes]], et les commandes m=SRC or m=IMH).
 +
* un ou plusieurs fichiers .auth référencé dans mabase-i.gwf définissant le contrôle d’accès pour les visiteurs, amis et magiciens (voir [[access/fr|Accès]]).
  
* '''images''': each {{c|base}} sub-folder contains the images associated with each person of a particular base. The naming convention is {{c|firstname.occ.lastname.jpg}}.
+
===Démarrage de gwd and gwsetup===
 
+
[[File:GeneWeb-Start-terminal.png|thumb|320px|right|Traces du lancement de GeneWeb dans la fenêtre terminal.]]
* '''lang''':
+
* '''src''': each {{c|base}} sub-folder contains text files and image files loaded by '''gwd''' with the m=SRC or m=IMH command (see [[Images|Inserting images in notes]]).
+
 
+
One or several '''.auth''' file may reside here, as referenced in the '''.gwf''' files for friends and/or wizard authentication.
+
  
==Starting Gwd and Gwsetup==
+
Avec cette organisation de dossiers, cliquer deux fois sur le fichier commande {{c|genealogy/gw-mac-7.00.command}} (dont le contenu est [[gwd-start|]]) ouvrira une fenêtre terminal, stoppera les autres versions de gwd et gwsetup en cours d’exécution, et lancera l’exécution d’une copie fraîche de GeneWeb version 7.00 (respectivement GeneWeb version 6.08 pour l’autre fichier commande).
[[File:GeneWeb-Start-terminal.png|thumb|320px|right|Traces in terminal window at GeneWeb start.]]
+
With this folder organisation, clicking on {{c|$HOME/Genealogy/Gw-Mac-7.00.command}} (whose content is [[gwd-start|here]]) will open a terminal window, kill previously running versions of gwd and gwsetup, start a fresh one and open the same start page as above.
+
  
 +
Cette page du [[man/fr|manuel]] donne la liste des paramètres de démarrage de gwd (et pour info des autres exécutables aussi).
  
For the diehards, here are all the parameters that '''gwd''' accepts at launch time:
+
== Installation depuis le code source ==
<pre>
+
iMac-H:gw Henri$ ./gwd -help
+
Usage: gwd [options] where options are:
+
  -hd <dir>
+
      Directory where the directory lang is installed.
+
  -dd <dir>
+
      Directory where the documentation is installed.
+
  -bd <dir>
+
      Directory where the databases are installed.
+
  -wd <dir>
+
      Directory for socket communication (Windows) and access count.
+
  -cgi
+
      Force cgi mode.
+
  -images_url <url>
+
      URL for GeneWeb images (default: gwd send them)
+
  -images_dir <dir>
+
      Same than previous but directory name relative to current
+
  -a <address>
+
      Select a specific address (default = any address of this computer)
+
  -p <number>
+
      Select a port number (default = 2317); > 1024 for normal users.
+
  -setup_link
+
      Display a link to local gwsetup in bottom of pages.
+
  -allowed_tags <file>
+
      HTML tags which are allowed to be displayed. One tag per line in file.
+
  -wizard <passwd>
+
      Set a wizard password: access to all dates and updating.
+
  -friend <passwd>
+
      Set a friend password: access to all dates.
+
  -wjf
+
      Wizard just friend (permanently)
+
  -lang <lang>
+
      Set a default language (default: fr).
+
  -blang
+
      Select the user browser language if any.
+
  -only <address>
+
      Only inet address accepted.
+
  -auth <file>
+
      Authorization file to restrict access. The file must hold lines
+
      of the form "user:password".
+
  -no_host_address
+
      Force no reverse host by address
+
  -digest
+
      Use Digest authorization scheme (more secure on passwords)
+
  -add_lexicon <lexicon>
+
      Add file as lexicon.
+
  -log <file>
+
      Redirect log trace to this file.
+
  -robot_xcl <cnt>,<sec>
+
      Exclude connections when more than <cnt> requests in <sec> seconds.
+
  -min_disp_req
+
      Minimum number of requests in robot trace (default: 6)
+
  -login_tmout <sec>
+
      Login timeout for entries with passwords in CGI mode (default 1800s)
+
  -redirect <addr>
+
      Send a message to say that this service has been redirected to <addr>
+
  -trace_failed_passwd
+
      Print the failed passwords in log (except if option -digest is set)
+
  -nolock
+
      Do not lock files before writing.
+
  -max_clients <num>
+
      Max number of clients treated at the same time (default: no limit)
+
      (not cgi).
+
  -conn_tmout <sec>
+
      Connection timeout (default 120s; 0 means no limit)
+
  -daemon
+
      Unix daemon mode.
+
  -chwd <comm>
+
      Call command when wdoc changed
+
iMac-H:gw Henri$
+
</pre>
+
  
== From sources ==
+
L’architecture de dossiers proposée ici conserve les sources de GeneWeb dans des dossiers nommés {{c|geneweb/gw-x.yy}}. Après avoir [[OCaml|installé Ocaml]] sur votre machine, il suffit de faire :
The folders '''gw-x.yy''' contain sources for version x.yy of GeneWeb. Executing the Makefile in this folder (after having  [[OCaml|Installed OCaml]]) will create a '''distribution''' folder containing all data necessary for execution of GeneWeb. Renaming this distribution folder to GeneWeb-x.yy-Mac and moving it into the <code>GeneWeb</code> folder discussed above brings us to a known situation.
+
cd ~/genealogy/geneweb/gw-x.yy
 +
makefile
 +
mv ~/genealogie/geneweb/gw-x.yy/distribution    ~/genealogie/geneWeb/geneWeb-x.yy/
 +
pour ajouter la nouvelle version {{c|x.yy}} de GeneWeb à l’organisation multiversion proposée.
  
The file gwget-7-00.sh is a shell script that will fetch the latest version of GeneWeb (currently version 7.00) from the GitHub repository, compile it and move the resulting distribution folder appropriately.
+
Le fichier {{c|gwget-7-00.sh}} est un exemple de script {{c|shell}} qui va chercher sur [https://github.com/geneweb/geneweb GitHub] la dernière version de GeneWeb, déclenche le {{c|Makefile}} et renomme le fichier distribution selon la convention prévue.
  
Of course, the structure above can be extended to more that two versions of GeneWeb, and to more than two bases. Appropriate editing of the shell scripts and command files may be necessary.
+
La structure de dossiers proposée ici s’étend à autant de versions de GeneWeb et de bases que souhaitées.
 +
[[Category:Manuel]]

Latest revision as of 21:23, 22 November 2016

150px-Geographylogo svg.png Language: English • français

L’installation de GeneWeb sous OS X se fait par une simple décompression de l’archive fournie en téléchargement.

Ces étapes ont été testées sur OS X Yosemite avec geneweb-6.07.tgz :

  • télécharger GeneWeb, il est conseillé de prendre la dernière version disponible pour OS X ;
  • double-cliquer sur l’archive téléchargée permet de la décompresser dans un sous-dossier du même nom ;
  • (optionnel) déplacer ce dossier avec les autres programmes ;
  • démarrer GeneWeb en double-cliquant sur geneweb.command (et non sur gwd ou gwsetup).

Un terminal s’ouvre avec une trace de l’exécution et la page de démarrage de GeneWeb apparait dans le navigateur par défaut.

  • Traces sur un terminal au démarrage de GeneWeb.
  • Page de démarrage de GeneWeb.

Si le terminal indique une erreur, éditer le fichier GeneWeb.command et remplacer la ligne trap 'kill $pids' 1 2 par :

killall gwd
killall gwsetup

Sur certaines versions, le fichier gwd.command est absent et/ou le fichier gwd ne s'exécute pas correctement. Y rajouter la ligne cd `dirname $0`.

#!/bin/sh
cd `dirname $0`
mkdir -p bases
cd bases
exec ../gw/gwd -hd ../gw "$@"

Il devient alors possible de démarrer directement gwd à partir d'une fenêtre terminal (l'action d'édition du fichier semble détruire sa capacité à s'exécuter en cliquant dessus!).

Installation de versions multiples

Il est possible d’installer sur votre ordinateur (ou serveur) plusieurs versions de GeneWeb qui pourront être démarrées alternativement, ce qui peut être utile pour faire migrer des bases d’une version à l’autre.

La première étape consiste à organiser une structure de dossier qui contiendra les divers éléments. Les options sont variées et dépendent des goûts personnels, mais la proposition faite ici a pour objectif d’expliciter le rôle de chaque dossier afin de vous permettre de faire votre propre choix.

Tous les dossiers sont rassemblés sous une racine appelée /home/genealogy/ qui contient deux sous-dossiers GeneWeb et GeneWeb-Bases ainsi que des fichiers commande de lancement de plusieurs versions de GeneWeb différentes. Le répertoire geneweb/ contient les fichiers exécutables et certains fichiers paramètre associés. Le répertoire bases/ contient toutes les données généalogique et des fichiers paramètres spécifiques aux bases.

  • directory genealogy
    • directory geneweb
    • directory bases
    • file gw-mac-6.08.command
    • file gw-mac-7.00.command
Structure du dossiers GeneWeb sous Mac OS X (binaries et code source).

Dossier des exécutables : geneweb/

Le contenu de GeneWeb/ est organisé de la façon suivante :

Plusieurs dossiers geneWeb-x.yy-mac/ contiennent, chacun pour une version de GeneWeb, le même ensemble de fichiers que dans l’installation simple.

Le dossier geneweb-6.08-mac/ contient un dossier bases/ inutilisé car l’exécution de la commande gwd.command qu’il contient aura pu le créé.

Dans chaque dossier geneweb-x.yy-mac/ on trouvera la même structure de sous-dossiers :

  • CHANGES.txt
  • gw/ : le dossier contenant un ensemble cohérent d’exécutables pour une version de GeneWeb. On se réfèrera à se dossier très souvent dans la documentation.
    • a.gwf : le fichier de configuration d’une base par défaut
    • consang : l’exécutable de calcul de consanguinité
    • css/ : le dossier de stockage des feuilles de style
    • etc/ : le dossier de stockage des fichiers template
    • ged2gwb : l’exécutable de lecture d’un fichier au format format GEDCOM vers une base .gwb
    • ged2gwb2 : l’exécutable de lecture d’un fichier au format format GEDCOM vers une base .gwb (nouveau format optimisé pour les grosses bases)
    • gwb2ged : l’exécutable qui exporte au format GEDCOM le contenu d’une base
    • gwc : un alias de gwc1
    • gwc1 : l’exécutable de lecture d’un fichier au format GWformat vers une base .gwb
    • gwc2 : l’exécutable de lecture d’un fichier au format format GWformat vers une base .gwb (nouveau format optimisé pour les grosses bases)
    • gwd : l’exécutable du serveur HTTP qui reçoit les requêtes vers les bases en renvoie les pages HTML
    • gwd.arg : le fichier des paramètres de lancement de gwd
    • gwd.log : la trace d’exécution de gwd
    • gwd.xcl : fichier d’exclusion
    • gwsetup : l’exécutable du serveur HTTP qui reçoit les requêtes de gestion des bases (création, sauvegardes, suppression, renommage),
    • gwu : l’exécutable qui exporte depuis une base un fichier au format GWformat ou GEDCOM
    • images/ : le dossier contenant les icônes utilisées par gwd et gwsetup
    • lang/ : le dossier contenant les fichiers utilisés pour la traduction de l’interface utilisateur
    • only.txt : un fichier contenant une liste d’adresses IP contrôlant l’accès au serveur
    • setup/ : un dossier contenant les fichiers template utilisés par gwsetup
    • tags.txt : un fichier donnant la liste des Tags HTML autorisés dans les notes
    • update_nldb : l’exécutable recalculant les index des pages de notes de la base
  • gwd : un fichier script lançant l’exécution de gwd
  • gwsetup : un fichier script lançant l’exécution de gwsetup
  • LICENSE.txt : le fichier décrivant la license de GeneWeb
  • START.html : la page HTML de démarrage de GeneWeb (qui apparaîtra après l’exécution de l’un des fichiers commande GeneWeb/Gw-Mac-x.yy.command).

On ignore dans l’immédiat les deux dossiers gw-6.08-alpha-src et gw-7.00-Mac (code source) et le fichier gwget-7-00.sh

Dossier des bases : GeneWeb-Bases/

Le dossier GeneWeb-Bases est organisé de la façon suivante :

Folder structure under Mac OS X for GeneWeb-Bases (Genealogy data).
  • mabase-i.gwb/ : chaque base est conservée dans un dossier séparé
  • mabase-i.gwf : un fichier de configuration spécifique à chaque base. Si absent gw/a.gwf
  • cnt/ : contient les compteurs d’accès à chaque base et le fichier robot listant les adresses IP devant être exclues suite à leur comportement.
  • etc/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers template spécifiques à chaque base qui viennent se substituer à ceux de gw/etc. L’ordre de recherche des fichiers est :
    • .../bases/etc/base
    • .../bases/etc
    • .../gw/etc/base
    • .../gw/etc
  • images/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers images associées aux personnes.
  • lang/ :
  • src/ : contient, dans autant de dossiers mabase-i/ que nécessaire, des fichiers .txt, et un dossier images/ (voir Insérer des images dans les notes, et les commandes m=SRC or m=IMH).
  • un ou plusieurs fichiers .auth référencé dans mabase-i.gwf définissant le contrôle d’accès pour les visiteurs, amis et magiciens (voir Accès).

Démarrage de gwd and gwsetup

Traces du lancement de GeneWeb dans la fenêtre terminal.

Avec cette organisation de dossiers, cliquer deux fois sur le fichier commande genealogy/gw-mac-7.00.command (dont le contenu est ) ouvrira une fenêtre terminal, stoppera les autres versions de gwd et gwsetup en cours d’exécution, et lancera l’exécution d’une copie fraîche de GeneWeb version 7.00 (respectivement GeneWeb version 6.08 pour l’autre fichier commande).

Cette page du manuel donne la liste des paramètres de démarrage de gwd (et pour info des autres exécutables aussi).

Installation depuis le code source

L’architecture de dossiers proposée ici conserve les sources de GeneWeb dans des dossiers nommés geneweb/gw-x.yy. Après avoir installé Ocaml sur votre machine, il suffit de faire :

cd ~/genealogy/geneweb/gw-x.yy
makefile
mv ~/genealogie/geneweb/gw-x.yy/distribution    ~/genealogie/geneWeb/geneWeb-x.yy/

pour ajouter la nouvelle version x.yy de GeneWeb à l’organisation multiversion proposée.

Le fichier gwget-7-00.sh est un exemple de script shell qui va chercher sur GitHub la dernière version de GeneWeb, déclenche le Makefile et renomme le fichier distribution selon la convention prévue.

La structure de dossiers proposée ici s’étend à autant de versions de GeneWeb et de bases que souhaitées.