Archive and distribute your base on a removable media (CD-ROM)
Jump to navigation
Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Language: | English • français |
---|
Archiving your GeneWeb base on a permanent and removable media such as a CD-ROM protects your data and facilitates sharing withour requiring GeneWeb installation.
Archiving on a write-once media
Here are the steps necessary to construct an autonomous CD_ROM containing one or several bases and the necessary executables.
- Clean your base(s), in particular if you have made several updates.
- Launch update_nldb (notes index construction) and consanguinity computation if you have requested their display on personal pages (
show_consang=yes
, see configuration) - Connect to your base, and perform one relationship conputing (path between two individuals). The first occurence of a relationship computing computes a file (
tstab
) which optimises further relationship computings. When on a CD-ROM, creation of this file would not be possible, but its absence does not prevent relationship computing from happening. - Create a
Staging
folder whose entire content will be written on the removable media. In this folder, place copies of:
- The
gwd
executable file (on windows systems, it usually has.exe
extension), and its.arg
argument file. Make sure that this files has the proper executable property. - Any
tags.txt
(see tags) andfile.auth
(see access) files needed for proper execution of your base. - The bases folders whose extensions are
.gwb
. - The
.gwf
configuration file(s) associated with your bases. - The folders
etc
(template files),images
(portraits),lang
(language dictionnaries) andsrc
(text and image files). They must be located iin the same folder as gwd.
- The
- In the
.gwf
configuration file associated with your base(s), add the linewizard_passwd=xyz
- If your base proposes portraits for persons, install the corresponding
.jpg
files in aimages/mybase
folder (see example below). - Important step: gwd builds several temporary files (in its working directory by default). If executed from a non writable media, a parameter must indicate where temporary files can be written. These files are of modest size, and can be deleted with no harm.
- This parameter is provided in the
gwd.arg
or in the command launching gwd (see example below):
- Before writing out to your CD-ROM, make a final test, verifying that while the
Staging
folder is write protected, you still have complete functionality.
- Launching GeneWeb should be done by clicking on the appropriate
gwd.bat
,gwd.sh
orgwd.command
file. Make sure that those files have the proper executable property. - After launch, opening your base will be done by entering
http://127.0.0.1:2317/mybase1
into the URL line of your browser, or by clicking on a link of astart.html
page that you may have prepared.
- Write-out the content of
Staging
to the removable media.
Typicall structure for a multi-platform, multi-base distribution
This structure can obviously be simplified in the case of a single platform and/or single base.
- Staging
- Windows
- bases
- gw
- README # Some explanations for install and launch
- start.html # Some optionnal start file containing the various <a href="http://127.0.0.1:2317/mybase1">MyBase1</a> lines
- gwd.bat # gwd launch file
- Linux
- Mac-OSX
- Windows
With the structure as above, the content of gwd.bat
, gwd.command
and the two gwd.arg
files should be:
Windows
Note that arguments can be passed to gwd either through the .arg
file, or through the launch command line.
- gwd.arg
-bd ../bases -wd c:\temp\geneweb
- gwd.bat
to be completed
Unix and Mac OSX
- gwd.arg
-bd ../bases -wd /tmp/geneweb
- gwd.command
#!/bin/sh cd ./bases ../gw/gwd -hd ../gw -bd . -wd /tmp/geneweb
GeneWeb Manual
- Download and install GeneWeb program under GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD; on Mac OS X, Linux or Windows using Docker; or in CGI mode behind a web server.
- Understand GeneWeb server, homonym, consanguinity.
Use and manage genealogical databases
- Import Gedcom
.ged
or GeneWeb.gw
files with gwsetup or in command-line. - Update datas (add/remove individuals and families), merge duplicates, type dates.
- Use wikitext syntax, macros, keyboard shortcuts.
- Clean, recover, rename, save, archive a database.
- Merge and split multiples databases.
Technical annex
- Personalize CSS, header and trailer, templates, lexicon and declension.
- Configuration file
.gwf
(for templm), wizard notes, passwords for friends/wizards and access restrictions to databases. - Add images in notes, further remarks for experts.