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 ]
[
--version]
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
ondersteund. Dit formaat wordt wereldwijd gebruikt door bijna alle
genealogische software.
OPTIES¶
- grampsBESTAND
- Wanneer BESTAND opgegeven wordt (zonder vlaggen) als
een familiestamboom 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).
- -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 session is
started using that database.
- -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.
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.
- -e,--export= FILE
- Export data into FILE. For iso format, the
FILE is actually the name of directory the gramps database will be
written into. For gramps-xml, gedcom, wft,
gramps-pkg, and geneweb, the FILE is the name of the
resulting file.
When more than one output file is given, each has to be preceded by
-e flag. The files are written one by one, in the specified order.
- -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), and
report (generates report, needs the OPTIONSTRING supplied by
the -p flag).
The report option string 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. Option string must
list pairs of option names and values. Withing a pair, option name and
value must be separated by the equality sign. Different pairs must be
separated by commas.
Most of the report options are specific for every report. However, there
some common options.
name=reportname
This mandatory option determines which report will be generated. If the
supplied report_name does not correspond to any available report, the
error message will be printed followed by the list of available reports.
show=all
This will produce the list of names for all options available for a given
report.
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.
- -d,--debug= LOGGER_NAME
- Enables debug logs for development and testing. Look at the
source code for details
- --version
- Prints the version number of gramps and then exits
werking¶
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.
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
-o 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.
EXAMPLES¶
- To open an existing family tree and import an xml file into
it, one may type:
- gramps -O 'My Family Tree' -i
~/db3.gramps
- 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 may type:
- gramps -i 'My Family Tree' -i
~/db3.gramps
- To import four databases (whose formats can be determined
from their names) and then check the resulting database for errors, one may
type:
- gramps -i file1.ged -i
file2.tgz -i ~/db3.gramps -i file4.wft
-a check
- To explicitly specify the formats in the above example,
append filenames 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
- To import three databases and start interactive gramps
session with the result:
- gramps -i file1.ged -i
file2.tgz -i ~/db3.gramps
- Finally, to start normal interactive session type:
- gramps
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¶
${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps
AUTEURS¶
Donald Allingham
<don@gramps-project.org>
http://gramps.sourceforge.net
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-manual/$LANG in
de officiële brondistributie.
De ontwikkelingsdocumentatie kan gevonden worden op de
http://developers.gramps-project.org webstek.