Installer GeneWeb sous OS X
 Language: |
English • français |
|---|
Contents
Installation simple
L'installation la plus simple se passe de la façon suivante (testée au moins sur OSX Yosemite) :
- Télécharger la version appropriée. La dernière version disponible sur geneanet.org est
geneweb-6.07.tgz. - Cliquer deux fois sur le fichier
.tgzconstruit dans votre dossier téléchargements un nouveau dossier appelégeneweb-6.07. - Déplacez ce dossier à l'endroit de votre choix.
- Démarrez GeneWeb en cliquant deux fois sur l'icône du fichier
GeneWeb.command(et non sur els icônes degwdougwsetup). 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.
- 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
GeneWeb.command - Ouvrez le fichier
GeneWeb.commanddans un éditeur de texte. - remplacez la ligne
- Faites une copie de sauvegarde de
-
trap 'kill $pids' 1 2- par
-
killall gwd -
killall gwsetup- et sauvegardez le résultat.
- Démarrez GeneWeb en cliquant deux fois sur l'icône de la nouvelle version de
GeneWeb.command.
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 à pour objectif d'expliciter le rôle de chaque dossier afin de vous permettre de faire votre propre choix.
Nous faisons l'hypothèse que tous les dossiers sont rassemblés sous une racine appelée /Home/Genealogie. Ce dossier contiendra deux sous-dossiers :
- GeneWeb : contenant les fichiers exécutables et certains fichiers paramètre associés
- GeneWeb-Bases : contenant toutes les données généalogique et des fichiers paramètres spécifiques aux bases. Dans la suite de ce document, ce dossier sera appelé
bases/.
et des fichiers commande de lancement de plusieurs versions de GeneWeb différentes.
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$
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 :
- mabase-i.gwb/ : chaque bases 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
Avec cette organisation de dossiers, cliquer deux fois sur le fichier commande Genealogy/Gw-Mac-7.00.command (dont le contenu est là) 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 ~/Genealogie/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 multi-version proposée.
Le fichier gwget-7-00.sh est un exemple de script shell qui va chercher sur [1] 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
