Gramps is a Free/OpenSource genealogy program. It is written in Python, using the GTK+/GNOME interface. Gramps should seem familiar to anyone who has used other genealogy programs before such as Family Tree Maker (TM), Personal Ancestral Files (TM), or the GNU Geneweb. It supports importing of the ever popular GEDCOM format which is used world wide by almost all other genealogy software.
Formats
available for export are gramps-xml (guessed if FILE ends with
.gramps), gedcom (guessed if FILE ends with .ged), or
any file export available through the Gramps plugin system.
Formats
available for import are grdb, gramps-xml, gedcom,
gramps-pkg (guessed if FILE ends with .gpkg), and
geneweb (guessed if FILE ends with .gw).
Formats available for export are gramps-xml, gedcom, gramps-pkg, wft (guessed if FILE ends with .wft), geneweb, and iso (never guessed, always specify with -f option).
When more than one input file is given, each has to be preceded by -i flag. The files are imported in the specified order, i.e. -i FILE1 -i FILE2 and -i FILE2 -i FILE1 might produce different gramps IDs in the resulting database.
The OPTIONSTRING should satisfy the following conditions:
It must not contain any spaces.
If some arguments need to include spaces, the string should
be enclosed with quotation marks, i.e., follow the shell syntax.
Option string is a list of pairs with name and value (separated by the
equality sign). The name and value pairs must be separated by commas.
Most of the report or tools options are specific for each report or tool. However, there are some common options.
name=name
This mandatory option determines which report or tool will be run.
If the supplied name does not correspond to any available report or
tool, an error message will be printed followed by the list of
available reports or tools (depending on the ACTION).
show=all
This will produce the list of names for all options available for a given
report or tool.
show=optionname
This will print the description of
the functionality supplied by optionname, as well as what are the
acceptable types and values for this option.
Use the above options to find out
everything about a given report.
When more than one output action is given, each has to be preceded by -a flag. The actions are performed one by one, in the specified order.
If the -O flag is given, then gramps will try opening the supplied database and then work with that data, as instructed by the further command line parameters.
With or without the -O flag, there could be multiple imports, exports, and actions specified further on the command line by using -i, -e, and -a flags.
The order of -i, -e, or -a options does not matter. The actual order always is: all imports (if any) -> all actions (if any) -> all exports (if any). But opening must always be first!
If no -O or -i option is given, gramps will launch its main window and start the usual interactive session with the empty database, since there is no data to process, anyway.
If no -e or -a options are given, gramps will launch its main window and start the usual interactive session with the database resulted from all imports. This database resides in the import_db.grdb under ~/.gramps/import directory.
The error encountered during import, export, or action, will be either dumped to stdout (if these are exceptions handled by gramps) or to stderr (if these are not handled). Use usual shell redirections of stdout and stderr to save messages and errors in files.
LANG - describe, which language to use: Ex.: for polish language this variable has to be set to pl_PL.UTF-8.
GRAMPSHOME - if set, force Gramps to use the specified directory to keep program settings and databases there. By default, this variable is not set and gramps assumes that the folder with all databases and profile settings should be created within the user profile folder (described by environment variable HOME for Linux or USERPROFILE for Windows 2000/XP).
In addition to generating direct printer output, report generators also target other systems, such as OpenOffice.org, AbiWord, HTML, or LaTeX to allow the users to modify the format to suit their needs.
${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps
This man page was originally written by:
Brandon L. Griffith <brandon@debian.org>
for inclusion in the Debian GNU/Linux system.
This man page is currently maintained by:
Gramps project <xxx@gramps-project.org>
The developer documentation can be found on the http://developers.gramps-project.org site.