2012-12-01 21:32:41 +05:30
|
|
|
|
gramps(1) 3.4.0 gramps(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAAM
|
|
|
|
|
gramps - Genealogisch Onderzoek en Analyse Beheersysteem.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SAMENVATTING
|
|
|
|
|
gramps [-?|--help] [--usage] [--version] [-O|--open= GEGEVENSBESTAND
|
|
|
|
|
[-f|--format= FORMAAT]] [-i|--import= BESTAND [-f|--format= FORMAAT]]
|
|
|
|
|
[-i|--import= ...] [-e|--export= BESTAND [-f|--format= FORMAAT]]
|
|
|
|
|
[-a|--action= ACTIE] [-p|--options= OPTIESTRING]] [ BESTAND ] [--ver‐
|
|
|
|
|
sion]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
BESCHRIJVING
|
|
|
|
|
Gramps is een Free/OpenSource genealogisch programma dat in Python,
|
|
|
|
|
geschreven is en gebruik maakt van de GTK+/GNOME interface. Gramps zal
|
|
|
|
|
voor iedereen die al gewerkt heeft met andere genealogische programma's
|
|
|
|
|
zoals Family Tree Maker (TM), Personal Ancestral Files (TM) of GNU
|
|
|
|
|
Geneweb. Importeren vanuit het gekende GEDCOM-formaat wordt onderste‐
|
|
|
|
|
und. Dit formaat wordt wereldwijd gebruikt door bijna alle genealogis‐
|
|
|
|
|
che software.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIES
|
|
|
|
|
grampsBESTAND
|
|
|
|
|
Wanneer BESTAND opgegeven wordt (zonder vlaggen) als een famili‐
|
|
|
|
|
estamboom of als een familistamboommap, dan wordt dit bestand
|
|
|
|
|
geopend en een interactieve sessie wordt gestart. Indien BESTAND
|
|
|
|
|
een bestandsformaat dat door Gramps herkent wordt, zal een lege
|
|
|
|
|
familiestamboom aangemaakt worden. De bestandsnaam wordt
|
|
|
|
|
gebaseerd op de BESTAND naam en de gegevens worden in dit
|
|
|
|
|
bestand geïmporteerd. Met resterende opties wordt geen rekening
|
|
|
|
|
gehouden. Deze wijze van opstarten is zeer bruikbaar om Gramps
|
|
|
|
|
te gebruiken voor genealogische gegevens via een webbrowser.
|
|
|
|
|
Deze opstartmethode kan gelijk welk gegevensformaat eigen aan
|
|
|
|
|
Gramps behandelen, zie onder.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-f,--format= FORMAAT
|
|
|
|
|
Expliciet een formaat opgeven voor BESTAND door de optie -i, of
|
|
|
|
|
-e mee te geven. Indien de -f optie niet opgegeven wordt voor
|
|
|
|
|
BESTAND, wordt het formaat gebaseerd op de bestandsextensie of
|
|
|
|
|
het MIME-type.
|
|
|
|
|
|
|
|
|
|
Formaten beschikbaar voor uitvoer zijn 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).
|
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**-O** , **--open=** *DATABASE*
|
|
|
|
|
Open *DATABASE* which must be an existing database directory or
|
|
|
|
|
existing family tree name. If no action, import or export
|
|
|
|
|
options are given on the command line then an interactive ses‐
|
|
|
|
|
sion is started using that database.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**-i** , **--import=** *FILE*
|
|
|
|
|
Import data from *FILE* . If you haven't specified a database then
|
|
|
|
|
a temporary database is used; this is deleted when you exit
|
|
|
|
|
gramps.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**-a** , **--action=** *ACTION*
|
|
|
|
|
Perform *ACTION* on the imported data. This is done after all
|
|
|
|
|
imports are successfully completed. Currently available actions
|
|
|
|
|
are **summary** (same as Reports->View->Summary), **check** (same as
|
|
|
|
|
Tools->Database Processing->Check and Repair), **report** (generates
|
|
|
|
|
report), and tool (runs a plugin tool). Both **report** and **tool**
|
|
|
|
|
need the *OPTIONSTRING* supplied by the **-p** flag).
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
Most of the report or tools options are specific for each report
|
|
|
|
|
or tool. However, there are some common options.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**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* ).
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**show=all**
|
|
|
|
|
This will produce the list of names for all options available
|
|
|
|
|
for a given report or tool.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
Use the above options to find out everything about a given
|
|
|
|
|
report.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**-d** , **--debug=** *LOGGER_NAME*
|
|
|
|
|
Enables debug logs for development and testing. Look at the
|
|
|
|
|
source code for details
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**--version**
|
|
|
|
|
Prints the version number of gramps and then exits
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**werking**
|
2012-12-01 21:32:41 +05:30
|
|
|
|
Indien het eerste argument in de opdrachtregel niet start met dash (dus
|
|
|
|
|
geen vlag) dan zal Gramps trachten om het bestand te openen met een
|
|
|
|
|
naam die in het eerste argument werd opgegeven. Vervolgens wordt een
|
|
|
|
|
interactieve sessie gestart en de overige argumenten van de
|
|
|
|
|
opdrachtregel worden genegeerd.
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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
|
2012-12-01 21:32:41 +05:30
|
|
|
|
command line parameters.
|
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
The order of **-i** , **-e** , or **-a** options does not matter. The actual order
|
2012-12-01 21:32:41 +05:30
|
|
|
|
always is: all imports (if any) -> all actions (if any) -> all exports
|
|
|
|
|
(if any). But opening must always be first!
|
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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
|
2012-12-01 21:32:41 +05:30
|
|
|
|
there is no data to process, anyway.
|
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
If no **-e** or **-a** options are given, gramps will launch its main window
|
2012-12-01 21:32:41 +05:30
|
|
|
|
and start the usual interactive session with the database resulted from
|
2012-12-01 22:58:43 +05:30
|
|
|
|
all imports. This database resides in the **import_db.grdb** under
|
|
|
|
|
**~/.gramps/import** directory.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
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.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
**EXAMPLES**
|
|
|
|
|
To open an existing family tree and import an xml file into it, one
|
2012-12-01 21:32:41 +05:30
|
|
|
|
may type:
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
**gramps -O** *'My Family Tree'* **-i** *~/db3.gramps*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
The above changes the opened family tree, to do the same, but import
|
|
|
|
|
both in a temporary family tree and start an interactive session, one
|
2012-12-01 21:32:41 +05:30
|
|
|
|
may type:
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
**gramps -i** *'My Family Tree'* **-i** *~/db3.gramps*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
2012-12-01 22:58:43 +05:30
|
|
|
|
To import four databases (whose formats can be determined from their
|
2012-12-01 21:32:41 +05:30
|
|
|
|
names) and then check the resulting database for errors, one may type:
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
**gramps -i** *file1.ged* **-i** *file2.tgz* **-i** *~/db3.gramps*
|
|
|
|
|
**-i** *file4.wft* **-a** *check*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
To explicitly specify the formats in the above example, append file‐
|
2012-12-01 22:58:43 +05:30
|
|
|
|
names with appropriate **-f** options:
|
|
|
|
|
|
|
|
|
|
**gramps -i** *file1.ged* **-f** *gedcom* **-i** *file2.tgz* **-f**
|
|
|
|
|
*gramps-pkg* **-i** *~/db3.gramps* **-f** *gramps-xml* **-i** *file4.wft*
|
|
|
|
|
**-f** *wft* **-a** *check*
|
|
|
|
|
|
|
|
|
|
To record the database resulting from all imports, supply **-e** flag (use
|
|
|
|
|
**-f** if the filename does not allow gramps to guess the format):
|
|
|
|
|
|
|
|
|
|
**gramps -i** *file1.ged* **-i** *file2.tgz* **-e** *~/new-package*
|
|
|
|
|
**-f** *gramps-pkg*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
To import three databases and start interactive gramps session with the
|
|
|
|
|
result:
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
**gramps -i** *file1.ged* **-i** *file2.tgz* **-i** *~/db3.gramps*
|
|
|
|
|
|
|
|
|
|
To run the Verify tool from the commandline and output the result to
|
|
|
|
|
stdout:
|
|
|
|
|
|
|
|
|
|
**gramps -O** *'My Family Tree'* **-a** *tool* **-p name=** *verify*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
Finally, to start normal interactive session type:
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
**gramps**
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
CONCEPTEN
|
|
|
|
|
Ondersteuning van een op python-gebaseerd plugin systeem. Dit laat toe
|
|
|
|
|
om verslagen, hulpgereedschappen en vensterfilters toe te voegen zonder
|
|
|
|
|
dat het hoofdprogramma dient aangepast.
|
|
|
|
|
|
|
|
|
|
De klassieke uitdrukken zijn mogelijk, maar daar bovenover kunnen de
|
|
|
|
|
meeste verslagen ook gebruik maken van OpenOffice.org, AbiWord, HTML,
|
|
|
|
|
of LaTeX. Zo kunnen gebruikers het formaat wijzigen naar eigen wens.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GEKENDE BUGS EN BEPERKINGEN
|
|
|
|
|
BESTANDEN
|
2012-12-01 22:58:43 +05:30
|
|
|
|
|
|
|
|
|
*${PREFIX}/bin/gramps*
|
|
|
|
|
|
|
|
|
|
*${PREFIX}/share/gramps*
|
|
|
|
|
|
|
|
|
|
*${HOME}/.gramps*
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
AUTEURS
|
|
|
|
|
Donald Allingham <don@gramps-project.org>
|
2012-12-01 23:22:29 +05:30
|
|
|
|
http://gramps-project.org/
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
Deze man pagina werd oorspronkelijk geschreven door:
|
|
|
|
|
Brandon L. Griffith <brandon@debian.org>
|
|
|
|
|
voor het Debian GNU/Linux systeem.
|
|
|
|
|
|
|
|
|
|
Deze man pagina wordt momenteel onderhouden door:
|
|
|
|
|
Alex Roitman <shura@gramps-project.org>
|
|
|
|
|
|
|
|
|
|
Deze nederlandstalige man pagina wordt momenteel onderhouden door:
|
|
|
|
|
Erik De Richter <frederik.de.richter@pandora.be>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DOCUMENTATIE
|
|
|
|
|
De gebruikersdocumentatie is beschikbaar via de normale GNOME Help
|
|
|
|
|
browser in de vorm van een Gramps-handleiding. De handleiding is ook
|
|
|
|
|
beschikbaar in XML-formaat: gramps-manual.xml onder doc/gramps-man‐
|
|
|
|
|
ual/$LANG in de officiële brondistributie.
|
|
|
|
|
|
2012-12-01 23:22:29 +05:30
|
|
|
|
De ontwikkelingsdocumentatie kan gevonden worden op de
|
|
|
|
|
http://www.gramps-project.org/wiki/index.php?title=Portal:Developers
|
|
|
|
|
webstek.
|
2012-12-01 21:32:41 +05:30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
August 2005 3.4.0 gramps(1)
|