Archive and distribute your base on a removable media (CD-ROM)
(Redirected from Archive)
Jump to navigation
Jump to search
Language: | English • français |
---|
Archiving your GeneWeb base on a permanent and removable media such as a CD-ROM protects your data and is a convenient alternative to the publicly accessible server to facilitate sharing without forcing the user to pre-install GeneWeb.
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 computing (path between two individuals). The first occurrence of a relationship computing computes a file (
tstab
) which optimises further relationship computing. 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 following files or folders:
- 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. - The folders
etc
(template files),images
(portraits),lang
(language dictionaries) andsrc
(text and image files). They must be located in the same folder as gwd. - 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
- Perform the following tasks:
- In the
.gwf
configuration file associated with your base(s), add the linewizard_passwd=xyz
. This will prevent display of wizard related stuff which would be inoperative anyway. - If your base proposes portraits for persons, install the corresponding
.jpg
files in aimages/mybase
folder (see example below). - Do the same for base specific template files in
etc
, texts and images insrc
(see images for details) and language data inlang
.
- In the
- Verify and write-out:
- Identify a temporary writable folder. 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):
- Make a final test before writing out to your CD-ROM, verifying that while the
Staging
folder is written 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 should 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.
- This parameter is provided in the
- Clean-up.
Typical 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 installing and launch
- start.html # Some optional 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
cmd /c start "gwd - GeneWeb" /min gw\gwd -hd gw -bd bases -wd %temp%
Unix and Mac OSX
- gwd.arg
-bd ../bases -wd /tmp/geneweb
- gwd.command
#!/bin/sh # Shutdown daemon allready running killall gwd DIR=$(dirname "$0") cd $DIR ./gw/gwd -hd ./gw -bd ./bases -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.