Befehlszeilenreferenz
Dieser Anhang liefert eine Referent über die Möglichkeiten,
wenn Sie &app; aus dem Terminal starten.
Lassen Sie uns anmerken, dass &apps als ein interaktives
Program entworfen wurde. Deshalb benutzt es eine grafische Ansicht und
kann nicht von eine echten nicht-grafischen Konsole gestartet werden. Es
würde einen enormen Aufwand darstellen eine Ausführung in einem Nur-Text
Terminal zu ermöglichen. Aus diesem Grund zielen die möglichen
Befehlszeilenparameter nicht darauf ab, komplett auf die grafisch
Anzeige zu verzichten. Eher machen sie einige typische Aufgaben
angenehmer. Sie erlauben Ihnen auch diese Aufgaben aus Skripten
heraus auszuführen. Jedenfalls muss die grafische Anzeige immer
verfügbar sein!
Zusammengefasst bietet die Benutzung der Befehlzeilenparameter
nicht-interaktives Verhalten, aber beseitigt nicht die Abhängigkeit
von der grafischen Anzeige. Take it or leave it!
Verfügbare Parameter
Hier ist ein Liste der möglichen Parameter in &apps;:
Format-Parameter
Das Format der Dateien für den Import oder
Export kann festgelegt werden mit dem
-f Format
Parameter. Format kann eines der
folgenden sein:
gramps
&app;-Datenbank. Dieses Format ist sowohl
für den Import als auch für den Export verfügbar. Falls
nicht gegeben wird es geraten, wenn der Dateiname ein
Verzeichnis darstellt.
gedcom
GEDCOM-Datei. Dieses Format ist für den
Import und den Export vefügbar. Falls nicht angegeben
wird es geraten, wenn der Dateiname mit .ged endet.
gramps-pkg
&app;-Paket. Dieses Format ist für den
Import und Export verfügbar. Falls nicht angegeben wird es
geraten, wenn der Dateiname mit .tgz endet.
wft
Web Family Tree. Dieses Format ist nur für
den Export verfügbar. Falls nichts angegeben wird es
geraten, wenn der Dateiname mit .wft endet.
iso
CD-Image. Dieses Format ist nur für den
Export vefügbar. Es muss immer ausdrücklich angegeben
werden.
Import-Parameter
Die für den Import vorgesehenden Dateien können
mit dem
-i Dateiname
Parameter angegeben werden. Das Format kann mit dem
-f Parameter, der sofort auf dem
Dateiname folgt.
Falls es nicht angegeben wird, wird versucht das Format aus
dem Dateinamen zu ermitteln. Für
dasgramps-Format, ist
Dateiname der Name eines Verzeichnisses,
unter dem sich die gramps Datenbank befindet. Für
gedcom und gramps-pkg ist
Dateiname des Name der entsprechenden
Datei.
Falls mehr als eine Eingabedatei angegeben wird, muss
jeder einem -i folgen. Die Dateien werden in
der angegebenen Reihenfolge importiert, z.B.
-i Datei1
-i Datei2
und
-i Datei2
-i Datei1
könnte verschiedene gramps-IDs in der resultierenden
Datenbank resultieren.
Export options
The files destined for export can be specified with
the
-o filename
option. The format can be specified with the -f
option immediately following the filename.
If not specified, the guess will be attempted based on
the filename. For gramps
and iso formats, the filename
is actually the name of directory the gramps database will be written
into. For gedcom, wft,
and gramps-pkg, the filename
is the name of the resulting file.
When more than one output file is given, each has to be
preceded by -o flag. The files are written one
by one, in the specified order.
Action options
The action to perform on the imported data can be
specified with the
-a action
option. This is done after all imports are successfully completed.
Currently available actions are summary (same as
ReportsView
Summary)
and check (same as
Tools
Database Processing
Check and Repair).
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.
Operation
The order of -i, -o,
or -a options with respect to each does not matter.
The actual execution order always is: all imports (if any) -> all
exports (if any) -> all actions (if any).
If no -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 under
~/.gramps/import directory.
Any errors encountered during import, export, or action, will
be either dumped to stdout (if these are exceptions handled by gramps)
or 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 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
-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
-f gramps
-i file4.wft
-f wft
-a check
To record the database resulting from all imports, supply
-o flag (use -f
if the filename does not allow gramps to guess the format):
gramps -i file1.ged
-i file2.tgz
-o ~/new-package
-f gramps-pkg
To save any error messages of the above example into files
outfile and
errfile, run:
gramps -i file1.ged
-i file2.tgz
-o ~/new-package
-f gramps-pkg
>outfile
2>errfile
To import three databases and start interactive gramps
session with the result:
gramps -i file1.ged
-i file2.tgz
-i ~/db3
Finally, to start normal interactive session type:
gramps