a152c05b99
svn: r20728
258 lines
10 KiB
ReStructuredText
258 lines
10 KiB
ReStructuredText
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).
|
||
|
||
|
||
-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.
|
||
|
||
|
||
-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 (gen‐
|
||
erates report, needs the OPTIONSTRING supplied by the -p flag).
|
||
|
||
The report option string should satisfy the following condi‐
|
||
tions:
|
||
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 val‐
|
||
ues. 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. How‐
|
||
ever, 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 std‐
|
||
out 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 file‐
|
||
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
|
||
|
||
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-man‐
|
||
ual/$LANG in de officiële brondistributie.
|
||
|
||
De ontwikkelingsdocumentatie kan gevonden worden op de http://develop‐
|
||
ers.gramps-project.org webstek.
|
||
|
||
|
||
|
||
August 2005 3.4.0 gramps(1)
|