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