Difference between revisions of "man"
(direct link to Ged2gwb) |
|||
Line 27: | Line 27: | ||
==Importing a GEDCOM file (ged2gwb)== | ==Importing a GEDCOM file (ged2gwb)== | ||
− | See [[ | + | See [[GED|ged2gwb]]. |
==Exporting a GEDCOM file (gwb2ged)== | ==Exporting a GEDCOM file (gwb2ged)== |
Revision as of 07:35, 20 April 2016
Language: | English • français |
---|
Using GeneWeb with command lines assumes that you are familiar with the notions of files, folders and that you are not afraid of entering commands directly in a terminal window. If this was not the case, you should limit yourself to the use of gwsetup which provides a web based interface for most of the needed actions.
In order to configure and launch GeneWeb, you may use interactive commands in terminal window:
- a xterm virtual console under Unix/Linux or a terminal window under OS X,
- with cmd.exe under Windows (various ways to start cmd.exe depending on Windows version).
In this window, type the command to position yourself in the folder where GeneWeb is installed (see GeneWeb installation) which could be:
- under Unix or OSX:
cd /home/user/geneweb/gw/
- under Windows,:
cd c:\program files (x86)\geneweb\gw
Starting a GeneWeb server (gwd)
See the gwd page.
Creating a base (gwc, gwc1, gwc2)
see page Gwc
Importing a GEDCOM file (ged2gwb)
See ged2gwb.
Exporting a GEDCOM file (gwb2ged)
The command gwb2ged will export GEDCOM file from a GeneWeb base.
Usage: ./gwb2ged <base> [options] If both options -a and -d are used, intersection is assumed. If several options -s are used, union is assumed. Options are: -charset [ASCII|ANSEL|UTF-8]: set charset; default is UTF-8. -o <ged>: output file name (default: a.ged) -mem : save memory space, but slower -a "<1st_name>" [num] "<surname>": select ancestors of -d "<1st_name>" [num] "<surname>": select descendants of -aws "<1st_name>" [num] "<surname>" : select ancestors with siblings -s "<surname>" : select this surname (option usable several times) -nsp : no spouses' parents (for options -s and -d) -nn : no (database) notes -c <num> : When a person is born less than <num> years ago, it is not exported unless it is Public. All the spouses and descendants are also censored.
Exporting a GW file (gwu)
The command gwu will export a textual file following the GW file format from a GeneWeb base.
gwu dupont > toto.gw
If you save a base into successive files after sets of modifications, you have the possibility of comparing the results with standards tools such as diff
.
The GW file format is the preferred method for archiving a base, and the required method to transfer a base from one version of GeneWeb to another.
gwc toto.gw -o durand
Usage: ./gwu [options] <base_file> If both options -a and -d are used, intersection is assumed. If several options -s are used, union is assumed. Options are: -o <file> output file name (else stdout) -odir <dir> create files from original name in directory (else on -o file) -mem save memory space, but slower -a "<1st_name>" [num] "<surname>" : select ancestors of... -d "<1st_name>" [num] "<surname>" : select descendants of... -ad "<1st_name>" [num] "<surname>" : select ancestors of... and all their descendants (has no effect if -a and/or -d used, option -nsp is forced). -aws "<1st_name>" [num] "<surname>" : select ancestors with siblings -s "<surname>" : select this surname (option usable several times) -maxlev "<level>" : maximum level of generations of descendants -nsp : no spouses' parents (for options -s and -d) -nn : no (database) notes -nopicture : Don't extract individual picture. -c <num> : When a person is born less than <num> years ago, it is not exported unless it is Public. All the spouses and descendants are also censored. -old_gw : Do not export additional fields (for backward compatibility: < 7.00) -raw raw output (without possible utf-8 conversion) -v verbose -sep "1st_name.num surname" : To use together with the option "-odir": separate this person and all his ancestors and descendants sharing the same surname. All the concerned families are displayed on standard output instead of their associated files. This option can be used several times. -sep_only_file <file> : With option "-sep", tells to separate only groups of that file. -sep_limit <num> : When using the option "-sep", groups of families can become isolated in the files. Gwu reconnects them to the separated families (i.e. displays them to standard output) if the size of these groups is less than 21. The present option changes this limit.
Computing consanguinity (consang)
The command consang will compute consanguinity in a GeneWeb base.
Display of consanguinity level for each individual is optional and controlled by the variable show_consang=
in the .gwf
parameter file.
consang -i dupont
usage: ./consang -i [options] <file_name> -q : quiet mode -i : build the indexes again -scratch : from scratch -mem : Save memory, but slower when rewritting database -nolock : do not lock database.
NB : Option « -i » is mandatory, otherwise indexes will not be recomputed and the base will not perform adequately.
The program executes in seconds or minutes depending on the size of your base, and displays a progress bar.
During computation, querying the base is allowed. If you perform a large number of updates on your base, it is recommended that you perform a consanguinity computation from time to time, which has the added benefit of cleaning the base from unused space resulting from suppressions.
Indexing linked pages (update_nldb)
The command update_nldb creates the index of the various auxiliary pages created in notes with the wiki syntax [[[linked_page/displayed text]]]. Listing of these pages is obtained with the link m=MISC_NOTES
in URL.
usage: ./update_nldb [options] <file_name>
Return to the main page of the manual.
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.