# Befehlszeilenreferenz

Dieser Anhang liefert eine Referent über die Möglichkeiten, wenn Sie &app; aus dem Terminal starten.

Lassen Sie uns anmerken, dass &app; 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 &app;:

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 das

gramps
-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 Reports View 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`