# Befehlszeilen-Referenz

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 Programm 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 Befehlszeilenparameter 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 verfü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 verfügbar. Es muss immer ausdrücklich angegeben werden.

Import-Parameter

  Die für den Import vorgesehenen Dateien können mit dem `-i` Dateiname Parameter angegeben werden. Das Format kann mit dem `-f` Parameter bestimmt werden, der sofort auf dem Dateinamen 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-ID's in der resultierenden Datenbank resultieren.

Export-Parameter

  Die für den Export vorgesehenen Dateien können mit dem `-o` Dateiname Parameter angegeben werden. Das Format kann mit dem `-f` Parameter bestimmt werden, der sofort auf dem Dateinamen folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem Dateinamen zu ermitteln. Für die

gramps
- und
iso
-Formate, ist der Dateiname der Name eines Verzeichnisses, in das die gramps-Datenbank geschrieben wird. Für
gedcom
,
wft
und
gramps-pkg
ist der Dateiname der Name der resultierenden Datei.

Wenn mehr als eine Ausgabedatei angeben wird, muss jede auf einem `-o`-Parameter folgen. Diese Dateien werden nacheinander geschrieben, in der angegebenen Reihenfolge.

Aktion-Parameter

  Die Aktion, die mit den importierten Daten durchgeführt werden soll, kann mit dem `-a` Aktion Parameter festgelegt werden. Dies wird getan, wenn alle Importe erfolgreich durchgeführt worden sind. Die momentan verfügbaren Aktionen sind

summary
(dasselbe wie Berichte Ansichten Datenbankübersicht) und
check
(dasselbe wie Werkzeuge Datenbankverarbeitung Datenbank prüfen und reparieren).

Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede auf einem `-a` Parameter folgen. Die Aktionen werden nacheinander in der entsprechenden Reihenfolge durchgeführt.

## Operationen

Die Reihenfolge der `-i`, `-o`, oder `-a` Parameter spielt keine Rolle. Die tatsächliche Ausführungsreihenfolge ist immer: alle Import -> alle Exporte -> alle Aktionen.

Wenn kein `-i` Parameter angegeben wird, startet gramps sein Hauptfenster und startet die gewöhnliche interaktive Sitzung mit der leeren Datenbank (denn es gibt keine Daten zu verarbeiten).

Wenn kein `-o` oder `-a` Parameter angegeben ist, startet gramps sein Hauptfenster und startet die gewöhnliche interaktive Sitzung mit der, aus allen Importen resultierenden Datenbank. Die Datenbank liegt dann in dem Verzeichnis ~/.gramps/import.

Fehler, die während des Imports, Exports oder einer Aktion auftreten, werden entweder auf stdout (wenn es Exceptions sind, die von gramps behandelt werden) oder auf stderr (wenn sie nicht behandelt werden). Benutzen Sie die gewöhnlichen Shell-Umleitungen von stdout und stderr um diese Nachrichten und Fehler in Dateien zu speichern.

## Beispiele

Um vier Datenbanken (dessen Format aus ihren Namen bestimmt werden kann) zu importieren und die resultieren Datenbank auf Fehler zu überprüfen, kann man schreiben:

`gramps -i` datei1.ged `-i` datei2.tgz `-i` ~/db3 `-i` datei4.wft `-a` check

Um explizit die Formate im oberen Beispiel anzugeben, hängen Sie an die Dateinamen die entsprechenden `-f` Parameter:

`gramps -i` datei1.ged `-f` gedcom `-i` datei2.tgz `-f` gramps-pkg `-i` ~/db3 `-f` gramps `-i` datei4.wft `-f` wft `-a` check

Um die aus allen Importen resultierende Datenbank aufzuzeichnen, benutzen Sie ein `-o` Parameter (benutzen Sie `-f`, wenn der Dateiname es gramps nicht ermöglicht das Format zu raten):

`gramps -i` datei1.ged `-i` datei2.tgz `-o` ~/neues-paket `-f` gramps-pkg

Um Fehlermeldungen der oberen Beispiele in die Dateien outfile und errfile zu speichern, führen Sie aus:

`gramps -i` datei1.ged `-i` datei2.tgz `-o` ~/neues-paket `-f` gramps-pkg >outfile 2>errfile

Um drei Datenbanken zu importieren und ein interaktive gramps- Sitzung zu starten:

`gramps -i` datei1.ged `-i` datei2.tgz `-i` ~/db3

Schließlich, um eine normale interaktive Sitzung zu starten, tippen Sie:

`gramps`