Revision as of 15:33, 14 October 2015

Installing under OSX

From sources

Installing GeneWeb from sources gives total freedom as to where things are.

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.

All the genealogy files are located in a folder called Genealogy sitting in "Home", and containing two sub-folders "GeneWeb" (sources and binaries. 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 (Starting gwd):

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$ 

Folder structure under Mac OSX for GeneWeb (source code and binaries).

The content of GeneWeb is organized as follows:

The folders gw-x.yy contain sources for version x.yy of GeneWeb. Executing the Makefile in this folder (see Installing Ocaml) will create a distribution folder containing all data necessary for execution if GeneWeb.

The file gwget-7-00.sh is a shell script that will fetch the latest version of GeneWeb version 7.00 from the GitHub repository, compile it and move the resulting distribution folder appropriately.

From a compiled distribution

The folders GeneWeb-x.yy-Mac contain copies (or moves) of the distribution folders created from sources for each version, or directly downloading (zip file) from a trusted source.

The folder GeneWeb-6.08-Mac contains a bases subfolder because the file gwd.command was executed which creates a bases folder right there. This folder is not used anywhere else in this setup (and could have been removed).

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. 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.log contains the log traces produced by gwd. May be useful for some debuging!

Note the tags.txt file containing the list of HTML tags authorized within the notes associated with each person.

The content of GeneWeb-Bases is organized as follows:

Folder structure under Mac OSX for GeneWeb-Bases (Genealogy data).

Bases are stored in .gwb folders. 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-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
  • .../gw/etc/base
  • .../gw/etc

• images: each base sub-folder contains the images associated with each person of a particular base. The naming convention is firstname.occ.lastname.jpg.

• lang:
• src: each base sub-folder contains text files and image files loaded by gwd with the m=SRC or m=IMH command (see 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

Traces in terminal window at GeneWeb start.

Starting page for GeneWeb.

With this folder organisation, clicking on $HOME/Genealogy/Gw-Mac-7.00.command will open a terminal window, kill previously running versions of gwd and gwsetup, start a fresh one and open the start page.