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