Difference between revisions of "De:Gramps 3.4 Wiki Handbuch - Kommandozeilen Referenz"

From Gramps
Jump to: navigation, search
(Verfügbare Optionen)
(Werkzeugaktionoption)
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
Dieser Anhang liefert eine Referenz über die Möglichkeiten Gramps aus dem Terminal starten.
 
 
 
{{grampsmanualcopyright/de}}
 
{{grampsmanualcopyright/de}}
  
 
{{man index/de|De:Gramps 3.4 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 3.4 Wiki Handbuch - Über Gramps|3.4}}  
 
{{man index/de|De:Gramps 3.4 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 3.4 Wiki Handbuch - Über Gramps|3.4}}  
  
{{languages/de|Gramps_3.4_Wiki_Manual_-_Command_Line}}
+
{{languages/de|Gramps_3.4_Wiki_Manual_-_Command_Line|Gramps 3.4 Wiki Handbuch - Kommandozeilen Referenz}}
 +
 
 +
Dieser Anhang liefert eine Referenz über die Möglichkeiten Gramps aus dem Terminal starten.
  
 
== Verfügbare Optionen ==
 
== Verfügbare Optionen ==
Line 48: Line 48:
 
=== Öffnen Optionen ===
 
=== Öffnen Optionen ===
  
You can open a family tree, or you can ''open'' a file by importing it in an empty family tree.
+
Du kannst einen Stammbaum öffnen, oder eine Datei durch Import in einen leeren Stammbaum '''öffnen'''.
  
 
Damit Gramps dies automatisch erledigt, übergebe einfach den Stammbaum oder die Datei, die du öffnen möchtest:
 
Damit Gramps dies automatisch erledigt, übergebe einfach den Stammbaum oder die Datei, die du öffnen möchtest:
Line 59: Line 59:
 
Zusätzlich kannst du Gramps den Namen des zu öffnenden Stammbaums mitgeben:
 
Zusätzlich kannst du Gramps den Namen des zu öffnenden Stammbaums mitgeben:
  
* verwende diese Option : <pre>-O filename</pre> or <pre>--open=filename </pre>
+
* verwende diese Option : <pre>-O Dateiname</pre> or <pre>--open=Dateiname </pre>
  
-O, Open of a family tree. This can be done also by just typing the name (name or database dir)
+
-O, Öffnen eines Stammbaum. Dies kann auch durch die einfache Eingabe des namens geschehen (Name oder Datenbankverzeichnis)
  
 
Beispiele:
 
Beispiele:
Line 72: Line 72:
 
{{Man tip| Tipp|Wenn der Dateiname ohne Option angegeben wird, versucht Gramps die Datei zu öffnen und anschließend eine interaktive Arbeitssitzung gestartet.}}
 
{{Man tip| Tipp|Wenn der Dateiname ohne Option angegeben wird, versucht Gramps die Datei zu öffnen und anschließend eine interaktive Arbeitssitzung gestartet.}}
  
Das Format kann festgelegt werden mit dem  <pre>-f format</pre> oder <pre>--format=format</pre> parameter, direkt gefolgt vom Dateinamen. Wenn nicht angegeben, wird versucht es aus dem Dateinamen zu ermitteln.  
+
Das Format kann festgelegt werden mit dem  <pre>-f Format</pre> oder <pre>--format=Format</pre> Parameter, direkt gefolgt vom Dateinamen. Wenn nicht angegeben, wird versucht es aus dem Dateinamen zu ermitteln.  
  
 
{{Man tip| Tipp |Nur Stammbäume können direkt geöffnet werden. Für andere Formate benötigst du die Importoption, welche die leere Datenbank einrichtet und dann die Daten in sie importiert.}}
 
{{Man tip| Tipp |Nur Stammbäume können direkt geöffnet werden. Für andere Formate benötigst du die Importoption, welche die leere Datenbank einrichtet und dann die Daten in sie importiert.}}
Line 80: Line 80:
 
=== Importoptionen ===
 
=== Importoptionen ===
  
Die für den Import vorgesehenen Dateien können mit dem <pre>-i filename</pre> oder <pre>--import=Dateiname</pre>  Parameter angegeben werden. Das Format kann mit dem -f oder --format=Format Parameter bestimmt werden, dem sofort der '''Dateiname''' folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem '''Dateiname''' zu ermitteln.
+
Die für den Import vorgesehenen Dateien können mit dem <pre>-i Dateiname</pre> oder <pre>--import=Dateiname</pre>  Parameter angegeben werden. Das Format kann mit dem -f oder --format=Format Parameter bestimmt werden, dem sofort der '''Dateiname''' folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem '''Dateiname''' zu ermitteln.
  
 
Beispiele:  
 
Beispiele:  
Line 86: Line 86:
 
   python gramps.py -i test.grdb -i daten.gramps
 
   python gramps.py -i test.grdb -i daten.gramps
  
{{man tip | Tipp |More than one file can be imported in one command. If this is the case, GRAMPS will incorporate the data from the next file into the database available at the moment.}}
+
{{man tip | Tipp |Es können mehr als eine Datei mit einem Kommando importiert werden. Wenn dies der Fall ist, integriert Gramps die Daten aus der nächsten Datei in die Datenbank, die in diesem Moment existiert.}}
  
Falls mehr als eine Eingabedatei angegeben wird, muss jeder einem -i folgen. Die Dateien werden in der angegebenen Reihenfolge importiert, z.B. <pre>-i Datei1 -i Datei2</pre> und <pre>-i Datei2 -i Datei1</pre> es können unterschiedliche GRAMPS-ID's in der resultierenden Datenbank entstehen..
+
Falls mehr als eine Eingabedatei angegeben wird, muss jeder einem -i folgen. Die Dateien werden in der angegebenen Reihenfolge importiert, z.B. <pre>-i Datei1 -i Datei2</pre> und <pre>-i Datei2 -i Datei1</pre> es können unterschiedliche Gramps-ID's in der resultierenden Datenbank entstehen..
  
 
=== Exportoptionen ===
 
=== Exportoptionen ===
  
Die für den Export vorgesehenen Dateien können mit dem Parameter <pre>-e Dateiname</pre> oder <pre>--export=Dateinamean</pre> gegeben werden. Das Format kann mit dem <pre>-f</pre> Parameter bestimmt werden, dem sofort der '''Dateinamen''' folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem '''Dateinamen''' zu ermitteln. Für iso-Formate, ist der '''Dateiname''' der Name des Verzeichnisses, in das die Gramps-Datenbank geschrieben wird. Für gramps-xml, gpkg, gedcom, wft, geneweb und gramps-pkg ist der '''Dateiname''' der Name der resultierenden Datei.
+
Die für den Export vorgesehenen Dateien können mit dem Parameter <pre>-e Dateiname</pre> oder <pre>--export=Dateinamean</pre> gegeben werden. Das Format kann mit dem <pre>-f</pre> Parameter bestimmt werden, dem sofort der '''Dateinamen''' folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem '''Dateinamen''' zu ermitteln. Für ISO-Formate, ist der '''Dateiname''' der Name des Verzeichnisses, in das die Gramps-Datenbank geschrieben wird. Für gramps-xml, gpkg, gedcom, wft, geneweb und gramps-pkg ist der '''Dateiname''' der Name der resultierenden Datei.
  
-e, export a family tree in required format. It is not possible to export to a family tree.
+
-e, exportiert einen Stammbaum in das gewünschte Format. Es ist nicht möglich in einen Stammbaum zu exportieren.
  
 
Beispiele:
 
Beispiele:
   python gramps.py -i 'Stammbaum 1' -i test.grdb -f grdb -e mergdeDB.gramps
+
   python gramps.py -i 'Stammbaum 1' -i test.grdb -f grdb -e verschmolzeneDB.gramps
Note that above does not change 'Stammbaum 1' as everything happens via a temporary database, whereas:
+
Beachte das das obige Beispiel 'Stammbaum 1' nicht verändert, da alles über eine temporäre Datenbank geschieht, wohingegen:
   python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -e mergdeDB.gramps
+
   python gramps.py -O 'Stammbaum 1' -i test.grdb -f grdb -e verschmolzeneDB.gramps
will import test.grdb into Stammbaum 1, and then export to a file !
+
test.grdb nach 'Stammbaum 1' importiert und dann das Ergebnis in eine Datei exportiert !
  
{{man tip| Exporting more files |More than one file can be exported in one command. If this is the case, GRAMPS will attempt to write several files using the data from the database available at the moment.}}
+
{{man tip| Mehrere Dateien exportieren |Es können mehr als eine Datei mit einem Kommando exportiert werden. In diesem Fall versucht Gramps mehrere Dateien unter Verwendung der in diesem Moment verfügbaren Datenbank zuschreiben.}}
  
 
Wenn mehr als eine Ausgabedatei angeben wird, muss jede auf einem -e-Parameter folgen. Diese Dateien werden nacheinander geschrieben, in der angegebenen Reihenfolge.
 
Wenn mehr als eine Ausgabedatei angeben wird, muss jede auf einem -e-Parameter folgen. Diese Dateien werden nacheinander geschrieben, in der angegebenen Reihenfolge.
Line 108: Line 108:
 
=== Aktionsoptionen ===
 
=== Aktionsoptionen ===
  
The action to perform on the imported data can be specified with the <pre>-a action</pre> or <pre>--action=action</pre> option. This is done after all imports are successfully completed.
+
Die Aktion, die mit den importierten Daten durchgeführt werden soll, kann über die <pre>-a Aktion</pre> oder <pre>--action=Aktion</pre> Option angegeben werden. Diese wird ausgeführt, nachdem alle Importe erfolgreich abgeschlossen sind.
  
  
The following actions remain the same:
+
Die folgenden Aktionen sind gleich geblieben:
  
 
*''report'': Diese Aktion erlaubt das erstellen von Berichten über die Kommandozeile.
 
*''report'': Diese Aktion erlaubt das erstellen von Berichten über die Kommandozeile.
  
*''tool'': This action allow to run a tool from a command line.
+
*''tool'': Diese Aktion ermöglicht ein Werkzeug von einer Kommandozeile zu starten.
  
 
Da Berichte und Werkzeuge eine Reihe eigener Optionen haben, sollten diese Aktionen die Berichts/Werkzeug Optionenzeichenkette folgen. Die Zeichenkette wird mit der <pre>-p Optionszeichenkette</pre> oder <pre>--options=Optionszeichenkette</pre> Option übergeben.
 
Da Berichte und Werkzeuge eine Reihe eigener Optionen haben, sollten diese Aktionen die Berichts/Werkzeug Optionenzeichenkette folgen. Die Zeichenkette wird mit der <pre>-p Optionszeichenkette</pre> oder <pre>--options=Optionszeichenkette</pre> Option übergeben.
  
The actions available in older versions of Gramps which were relocated in Gramps 3.4 are:
+
Die Aktionen aus älteren Gramps Versionen, die in Gramps 3.3 umgezogen sind:
  
*''summary'': This action was the same as ''' Reports ->View ->Summary '''. In Gramps 3.4 it was replaced by (or renamed to)  '''-a report -p name=summary'''.
+
*''summary'': Diese Aktion war dieselbe wie {{man menu|Berichte ->Ansicht ->Zusammenfassung}}. In Gramps 3.3 wurde es ersetzt durch (oder umbenannt in)  '''-a report -p name=summary'''.
  
*''check'': This action was the same as ''' Tools ->Database Processing ->Check and Repair ''' . In Gramps 3.4 it was replaced by (or renamed to) '''-a tool -p name=check'''.
+
*''check'': Diese Aktion war dieselbe wie {{man menu|Werkzeuge ->Datenbankverarbeitung ->Überprüfen und reparieren}} . In Gramps 3.3 wurde es ersetzt durch (oder umbenannt in) '''-a tool -p name=check'''.
  
 
==== Berichtaktionoptionen ====
 
==== Berichtaktionoptionen ====
You can generate most reports from the command line using the report action.  
+
 
An example:
+
Du kannst die meisten Berichte von der Kommandozeile aus mit Hilfe der report Aktion erstellen.  
 +
Ein Beispiel:
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html"
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html"
  
In version 3.4, you can provide the css style to use here with the css option:
+
Du kannst den css Stil der verwendet werden soll mit der css Option angeben:
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css=Web_Nebraska.css"
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css=Web_Nebraska.css"
or without css in the html output:
+
oder ohne css in der HTMl Ausgabe:
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css="
 
  gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css="
  
{{man tip| Report option string |Die Berichtsoption sollte folgende Bedingungen erfüllen: Sie darf keine Leerzeichenenthalten. Wenn eine Option Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden.
+
{{man tip| Berichtsoption Zeichenkette |Die Berichtsoption sollte folgende Bedingungen erfüllen: Sie darf keine Leerzeichenenthalten. Wenn eine Option Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden.
 
Eine Option besteht aus dem Optionsnamen und dem Wert. In einer Option müssen der Optionsname und Optionswert durch ein Gleichheitszeichen getrennt werden. Verschiedene Paare müssen durch Komma getrennt werden. Die meiten Bericht Optionen sind speziell für jeden Bericht. Allerdings gibt es einige allgemeine Optionen.}}
 
Eine Option besteht aus dem Optionsnamen und dem Wert. In einer Option müssen der Optionsname und Optionswert durch ein Gleichheitszeichen getrennt werden. Verschiedene Paare müssen durch Komma getrennt werden. Die meiten Bericht Optionen sind speziell für jeden Bericht. Allerdings gibt es einige allgemeine Optionen.}}
  
Most of the report options are specific for every report. However, there some common options.
+
Die meisten Berichtsoptionen sind berichtspezifisch. Jedoch gibt es einige übliche Optionen.
  
*name=report_name: Diese benötigte Option bestimmt welcher Bericht erzeugt wird. Wenn der übergebene Bericht_Name nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefollgt von einer Liste verfügbarer Berichte ausgegeben.
+
*name=Berichtname: Diese benötigte Option bestimmt welcher Bericht erzeugt wird. Wenn der übergebene Berichtname nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefolgt von einer Liste verfügbarer Berichte ausgegeben.
*of : output filename
+
*of : Ausgabe Dateiname
*off: output format. These are the extension an output format makes available, eg, pdf, html, doc, ...
+
*off: Ausgabeformat. Dies sind die Dateierweiterungen die das Ausgabeformat bestimmen, z.B., pdf, html, doc, ...
*style: for text reports, the stylesheet to use. Defaults to 'default'.
+
*style: für Textberichte, die zu verwendende Formatvorlage. Vorgabe 'default'.
 
*show=all: Dies erstellt eine Liste der Namen aller verfügbaren Optionen für den angegebenen Bericht.
 
*show=all: Dies erstellt eine Liste der Namen aller verfügbaren Optionen für den angegebenen Bericht.
*show=option_name: Dies zeigt die Beschreibung der funktionalität die durch Option_Name bereit gestellt wird, genauso wie die akzeptierten Arten und Werte für diese Option.
+
*show=option_name: Dies zeigt die Beschreibung der Funktionalität die durch Option_Name bereit gestellt wird, genauso wie die akzeptierten Arten und Werte für diese Option.
  
So, to learn to use a report, do for example:
+
So, um die Verwendung von report zu lernen, führe folgendes als Beispiel aus:
  gramps -O "Family Tree 1" -a report -p "name=family_group,show=all"
+
  gramps -O "Stammbaum 1" -a report -p "name=family_group,show=all"
  
 
{{man tip| Tipp |Wenn ein Parameter nicht angegeben wird, wird der zuletzt verwendete Wert genommen. Wenn dieser Bericht vorher nie erstellt wurde, wird wenn möglich der Wert des zuletzt erstellten Berichts verwendet. Sonnst wird der Standardwert verwendet.}}
 
{{man tip| Tipp |Wenn ein Parameter nicht angegeben wird, wird der zuletzt verwendete Wert genommen. Wenn dieser Bericht vorher nie erstellt wurde, wird wenn möglich der Wert des zuletzt erstellten Berichts verwendet. Sonnst wird der Standardwert verwendet.}}
Line 154: Line 155:
 
Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede auf einem -a Parameter folgen. Die Aktionen werden nacheinander in der entsprechenden Reihenfolge durchgeführt.
 
Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede auf einem -a Parameter folgen. Die Aktionen werden nacheinander in der entsprechenden Reihenfolge durchgeführt.
  
{{man tip| lists |Some reports have options or arguments which are interpreted (by the report) to be on multiple lines. For instance some reports allow you to format how the information will be shown, perhaps with a name on one line and the person's birth date on the next line. Such multiple-line options or arguments are called "lists" by GRAMPS.}}
+
{{man tip| Listen |Einige Berichte besitzen Optionen oder Argumente, die als mehrzeiler interpretiert werden (von den Berichten). Zum Beispiel ermöglichen dir manche Berichte zu formatieren, wie die Informationen dargestellt werden eventuell mit dem Namen in der einen Zeile und dem Geburtsdatum der Person auf der nächsten. Solche mehrzeiligen Optionen oder Argumente werden von Gramps "Listen" genannt.}}
  
On the command line such lists must always start with a left square bracket
+
Auf der Kommandozeile müssen solche Listen immer mit einer linken eckigen Klammer beginnen
 
<pre>[</pre>
 
<pre>[</pre>
and must always end with a right square bracket
+
und müssen immer mit einer rechten eckigen Klammer enden
 
<pre>]</pre>
 
<pre>]</pre>
but since such square brackets are usually "special" to the "shell" (they mean something to the command interpreter you are typing the command to), you must "escape" them so that they are ignored by your shell.
+
aber da solche eckigen Klammern im Normalfall etwas "spezielles" für die "Shell" sind (sie bedeuten etwas für den Kommandozeileninterpreter in den du das Kommando eingibst), musst du sie "maskieren" so das sie von deiner Shell ignoriert werden.
  
The details vary with each shell but (in linux/UNIX) usually you can precede such a square bracket with a backslash
+
Die Details variieren für jede Shell aber (in Linux/UNIX) normalerweise kannst du solch einer eckigen Klammer einen Backslash (Rückwärtsschrägstrich) voranstellen.
 
<pre>\</pre>
 
<pre>\</pre>
or put quotation marks around the square bracket, usually either "single" or "double" ones.
+
oder setze Anführungszeichen um die eckige Klammer, gewöhnlich entweder "einfache" oder "doppelte".
 +
 
 +
Der Stundenglasbericht erlaubt dir eine "Notiz" über den Bericht zu setzen und solch eine "Notiz" ist ein Beispiel für eine "Listen" Option.  Hier ist ein Beispiel:
 +
gramps -O "Stammbaum 1" -a report -p name=hourglass_graph,note='[Zeile eins,Zeile zwei]'
 +
was zeigt, das innerhalb solch einer Liste Zeilen durch Komma getrennt werden und Leerzeichen erlaubt sind, solange die Anführungszeichen wegen den eckigen Klammer bereits vorhanden sind.
  
The Hourglass Graph report allows you to put a "note" at the top of the report and such a "note" is an example of a "list" option.  Here is an example:
+
Aber wenn du Kommas in deinem Bericht haben möchtest, musst du Gramps irgendwie mitteilen, das diese Kommas keine Zeilentrenner sind. Du machst dies, indem du die Zeile mit dem Komma in Anführungszeichen setzt (entweder einfache oder doppelte).
gramps -O "Family Tree 1" -a report -p name=hourglass_graph,note='[line one,line two]' which shows that inside such a list different lines are separated by commas, and that spaces are acceptable since the quotation marks are already there for the square brackets.
 
  
But if you want to have a comma inside your report you have to somehow tell GRAMPS that
+
Wenn du aber bereits ein Paar Anführungszeichen verwendest (um deine eckigen Klammern einzuschließen) musst du die andere Art verwenden, um die Zeile mit dem Komma einzuschließen. Hier ist ein Beispiel:
comma is not one which separates lines.  You do that by enclosing the line with the comma in quotation marks (either single or double).
+
gramps -O "Stammbaum 1" -a report -p name=hourglass_graph,note="['Zeile 1, auch Zeile 1','Zeile 2, auch Zeile 2']"
  
But if you are already using a set of quotation marks (to enclose your square brackets) you have to use the other type to enclose the line with your comma. Here is an example:
+
Es ist möglich, jedes Zeichen in einer Liste aufzunehmen aber die Details gehen über den Umfang einer Anleitung für die Kommandozeile von Gramps hinaus.
gramps -O "Family Tree 1" -a report -p name=hourglass_graph,note="['line one, also line one','line two, also line two']"
 
  
It is possible to include any character in a list but the details
+
Du musst die genauen Methoden deines Kommandozeileninterpreters kennen, um ein Zeichen welches für deine Shell oder Gramps "speziell" ist (wie das Komma im obigen Beispiel) aufzunehmen aber generell musst du es zweifach "maskieren" einmal für deine Shell und zweiten für Gramps da du nicht willst, das deine Shell denkt es sei ein Kommando, auf das sie achten muss und du willst auch nicht das Gramps dies denkt.
are beyond the scope of this command-line introduction to GRAMPS.
 
You will need to know the precise methods available in your particular
 
command shell interpreter to include a character which is "special"
 
to your shell or "special" to GRAMPS (like the comma in the example above) but in general you will have to "escape" it twice, once
 
to your shell and once again to GRAMPS, since you don't want your shell
 
to think it is some instruction it should pay attention to and
 
you don't want GRAMPS to think that either.
 
  
 
==== Werkzeugaktionoption ====
 
==== Werkzeugaktionoption ====
  
You can run most tools from the command line using the 'tool' action.
+
Du kannst die meisten Werkzeuge durch Verwendung der 'tool' Aktion von der Kommandozeile ausführen.
To see which ones, say:
+
Anzeigen aller verfügbaren Werkzeuge:
gramps -O "Stammbaum 1" -a tool -p show=all
+
gramps -O "Stammbaum 1" -a tool -p show=all
To see a tool's available options, for instance the "verify" tool:
+
Die verfügbaren Optionen für ein Werkzeug anzeigen etwa für das "verify" Werkzeug:
gramps -O "Stammbaum 1" -a tool -p name=verify,show=all
+
gramps -O "Stammbaum 1" -a tool -p name=verify,show=all
To run a tool, for instance the "verify" tool:
+
Ein Werkzeug ausführen etwas das "verify" Werkzeug:
gramps -O "Stammbaum 1" -a tool -p name=verify
+
gramps -O "Stammbaum 1" -a tool -p name=verify
  
=== Force unlock option ===
+
==== Buchaktionoptionen (neu in 4.0) ====
 +
Du kannst Bücher aus der Kommandozeile mit der 'book' Aktion erstellen.
 +
Um zu sehen welche sage:
 +
gramps -O "Stammbaum 1" -a book
 +
Um alle für ein Buch, zum Beispiel "meinBuch", verfügbaren Optionen zu sehen:
 +
gramps -O "Stammbaum 1" -a book -p name=meinBuch,show=all
 +
Um ein Buch, zum Beispiel ein Buch "meinBuch" zu erstellen:
 +
gramps -O "Stammbaum 1" -a book -p name=meinBuch
  
-u, you can extend the -O flag with -u to force a locked family to be unlocked. This allows to recover from a crash that leaves the family tree (database)locked from the command line.
+
=== Entsperren erzwingen Option ===
  
 +
-u, du kannst den -O Parameter mit -u erweitern, um das Entsperren eines Stammbaum zu erzwingen. Dies ermöglicht den Wiedereinstieg von der Kommandozeile nach einem Absturz der den Stammbaum (Datenbank) gesperrt hinterlassen hat.
 
 
An example (to unlock the "Family Tree 1" database):
+
Ein Beispiel (um die "Stammbaum 1" Datenbank zu entsperren):
gramps -O "Family Tree 1" -a report -u > /dev/null
+
gramps -O "Stammbaum 1" -a report -u > /dev/null
Note that it is not possible to open family trees that need repair from the command line
+
Beachte es ist nicht möglich, Stammbäume die eine Reparatur benötigen von der Kommandozeile zu öffnen.
  
 
=== Konfiguration (config) Option ===
 
=== Konfiguration (config) Option ===
The option takes three forms:
+
Die Option gibt es in drei Formen:
(the following examples, exept 3.2, use behavior.database-path as the configuration variable to change.)
+
(Die folgenden Beispiele, außer 3.2, verwenden behavior.database-path als die zu ändernde Konfigurationsvariable.)
  
1) See all config values
+
1) Alle Konfigurationswerte anzeigen
  
   -s or --show
+
   -s oder --show
  
2) See a value:
+
2) Einen Wert zeigen:
  
 
  --config=behavior.database-path
 
  --config=behavior.database-path
or
+
oder
-c behavior.database-path
+
-c behavior.database-path
  
3) Set a value:
+
3) Einen Wert setzen:
  
 
  --config=behavior.database-path:'/media/mydb'
 
  --config=behavior.database-path:'/media/mydb'
oder
+
oder
-c behavior.database-path:'/media/mydb'
+
-c behavior.database-path:'/media/mydb'
  
3.1) Set a value to its default:
+
3.1) Einen Wert auf seinen Standard setzen:
  
 
  --config=behavior.database-path:DEFAULT
 
  --config=behavior.database-path:DEFAULT
oder
+
oder
-c behavior.database-path:DEFAULT
+
-c behavior.database-path:DEFAULT
  
 
 
3.2) Set more than one value:
+
3.2) Mehr als einen Wert setzen:
  
--config=behavior.use-tips:False --config=behavior.autoload:True
+
--config=behavior.use-tips:False --config=behavior.autoload:True
oder
+
oder
-c behavior.use-tips:False -c behavior.autoload:True
+
-c behavior.use-tips:False -c behavior.autoload:True
  
When all configuration variable(s) are set Gramps will start with these new values.
+
Wenn alle Konfigurationsvariablen gesetzt sind, startet Gramps mit diesen neuen Werten.
  
== Operation ==
+
== Bedienung ==
  
 
Wenn das erste Argument auf der Kommandozeile nicht mit einem Strich beginnt (z.B. kein Parameter), versucht Gramps die Datei mit dem Namen des ersten Arguments zu öffnen und eine interaktive Sitzung zu starten. Der rest der Kommandozeilenargumente wird ignoriert.
 
Wenn das erste Argument auf der Kommandozeile nicht mit einem Strich beginnt (z.B. kein Parameter), versucht Gramps die Datei mit dem Namen des ersten Arguments zu öffnen und eine interaktive Sitzung zu starten. Der rest der Kommandozeilenargumente wird ignoriert.
Line 260: Line 264:
 
== Beispiele ==
 
== Beispiele ==
  
*To import four databases (whose formats can be determined from their names) and then check the resulting database for errors, one may type:
+
*Um vier Datenbanken zu importieren (deren Format aus ihrem Namen erschlossen werden kann) und die sich ergebende Datenbank auf Fehler zu überprüfen, kann man folgendes eingeben:
  
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -i ~/DB3.gramps -i Datei4.wft -a check</pre>
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -i ~/DB3.gramps -i Datei4.wft -a check</pre>
  
*To explicitly specify the formats in the above example, append filenames with appropriate -f Optionen:
+
*Um die Formate in dem obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit den entsprechenden -f Optionen:
  
 
:<pre>gramps -i Datei1.ged -f gedcom -i Datei2.gpkg -f gramps-pkg -i ~/DB3.gramps -f gramps-xml -i Datei4.wft -f wft -a check</pre>
 
:<pre>gramps -i Datei1.ged -f gedcom -i Datei2.gpkg -f gramps-pkg -i ~/DB3.gramps -f gramps-xml -i Datei4.wft -f wft -a check</pre>
  
*To record the database resulting from all imports, supply -e flag (use -f if the filename does not allow Gramps to guess the format):
+
*Um die Datenbank die sich aus den Importen ergibt aufzuzeichnen, verwende das -e Flag (verwende -f wenn der Dateiname es Gramps nicht erlaubt das Format zu vermuten):
  
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg</pre>
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg</pre>
  
*To save any error messages of the above example into files outfile and errfile, run:
+
*Um jede Fehlermeldung aus dem obigen Beispiel in die Dateien ausgabedatei und fehlerdatei zu speichern, starte:
  
:<pre>gramps -i Datei1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >outfile 2>errfile </pre>
+
:<pre>gramps -i Datei1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >ausgabedatei 2>fehlerdatei </pre>
  
 
*Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis zu starten:
 
*Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis zu starten:
Line 280: Line 284:
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps </pre>
 
:<pre>gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps </pre>
  
*To open a database and, based on that data, generate timeline report in PDF format putting the output into the meine_zeitlinie.pdf file:
+
*Um eine Datenbank zu öffnen und basierend auf diesen Daten einen Zeitlinienbericht im PDF-Format zu erstellen und inder Datei meine_zeitlinie.pdf zu speichern:
  
 
:<pre>gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf </pre>
 
:<pre>gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf </pre>
Line 288: Line 292:
 
*Um eine grdb spontan in eine .gramps XML-Datei umzuwandeln:
 
*Um eine grdb spontan in eine .gramps XML-Datei umzuwandeln:
  
:<pre>gramps -O 'Family Tree 1' -e output.gramps -f gramps-xml</pre>
+
:<pre>gramps -O 'Stammbaum 1' -e ausgabe.gramps -f gramps-xml</pre>
  
 
* Um eine Webseite in einer anderen Sprache (Deutsch) zu erstellen:
 
* Um eine Webseite in einer anderen Sprache (Deutsch) zu erstellen:
Line 306: Line 310:
 
{{man index/de|De:Gramps 3.4 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 3.4 Wiki Handbuch - Über Gramps|3.4}}  
 
{{man index/de|De:Gramps 3.4 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 3.4 Wiki Handbuch - Über Gramps|3.4}}  
  
{{languages/de|Gramps_3.4_Wiki_Manual_-_Command_Line}}
+
{{languages/de|Gramps_3.4_Wiki_Manual_-_Command_Line|Gramps 3.4 Wiki Handbuch - Kommandozeilen Referenz}}
  
 
[[Category:De:Documentation|H]]
 
[[Category:De:Documentation|H]]

Revision as of 09:02, 8 October 2012

Gnome-important.png Spezielle Copyright Notiz: Alle Änderungen auf dieser Seite müssen unter zwei copyright Lizenzen stehen:

Diese Lizenzen ermöglichen es dem Gramps-Projekt die bestmögliche Verwendung dieses Handbuchs als freien Inhalt in zukünftigen Gramps Versionen. Wenn du mit dieser dual Lizenzierung nicht einverstanden bist, bearbeite diese Seite nicht. Du darfst zu anderen Seiten des Wiki die nur unter die GFDL Lizenz fallen nur über externe Links (verwende die Syntax: [http://www.gramps-project.org/...]), nicht über interne Links verlinken.
Außerdem verwende nur die Bekannten Drucktechnische Konventionen


Zurück Index Nächste


Dieser Anhang liefert eine Referenz über die Möglichkeiten Gramps aus dem Terminal starten.

Verfügbare Optionen

Dieser Abschnitt bietet eine Liste aller in Gramps verfügbaren Befehlszeilen Parameter. Wenn du mehr wissen willst als nur eine Liste von Parametern, schaue in die nächsten Abschnitte: Operation und Beispiele. Eine Liste ist auch auf dieser Seite verfügbar (in englisch).

Listenoptionen

-l, gibt eine Liste bekannter Stammbäume aus -L, gibt eine detaillierte Liste bekannter Stammbäume aus


Versionsoptionen

-v oder --version zeigt die Version von Gramps und Abhängigkeiten, Informationen über Umgebungseinstellungen, Python und Systempfade

Formatoptionen

Das Format jeder Datei, die geöffnet, importiert oder exportiert werden soll, kann mit der

-f format

Option festgelegt werden. Die zulässigen format Werte sind unten aufgelistet.

Volle Stammbaum Unterstützung

Diese Formate enthalten deine gesamten Daten die in einem Stammbaum enthalten sind.

  • gramps - Gramps XML Format: Dieses Format ist für Öffnen, den Import und den Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .gramps endet.
  • gpkg - Gramps Paket XML Format: Dieses Format ist für den Import und Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .gpkg endet.
  • grdb - vor Gramps 3.x Datenbank: Dieses Format ist für den Import zur Unterstützung älterer Dateiformate von Gramps verfügbar. Alles in der grdb Datei wird importiert. Falls nicht angegeben wird es angenommen wenn die Dateiendung .grdb lautet.
  • burn - GNOME ISO brennen: Export, nur unter GNOME verfügbar wenn das Brennprotokoll existiert.

Eingeschränkte Stammbaum Unterstützung

Diese Formate enthalten die meisten aber nicht alle Daten, die mit Gramps erstellt werden können

  • ged - GEDCOM Format: Dieses Format ist für den Import und den Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .ged endet.
  • gw - GeneWeb Datei: Dieses Format ist für den Import und Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .gw endet.

Teilmenge deiner Daten

Diese Formate enthalten einen bestimmten Teilbereich deiner Daten

  • csv - Komma getrennte Werte: Dieses Format ist für Import und Export verfügbar. Sei jedoch vorsichtig, der Import muss mit Werten erfolgen wie sie vom Export erstellt werden. Nur ein Teil deiner Daten ist in dieser Ausgabe enthalten.
  • vcf - VCard Format: Import und Export
  • vcs - VCalandar Format: Export
  • def - altes Pro-Gen Format: Import
  • wft - Web Family Tree: Dieses Format ist nur für den Export verfügbar. Falls nichts angegeben wird es gesetzt, wenn der Dateiname mit .wft endet.

Öffnen Optionen

Du kannst einen Stammbaum öffnen, oder eine Datei durch Import in einen leeren Stammbaum öffnen.

Damit Gramps dies automatisch erledigt, übergebe einfach den Stammbaum oder die Datei, die du öffnen möchtest:

python gramps.py 'Mein Stammbaum'
python gramps.py Mustermann.ged

Das erste öffnet einen Stammbaum, das zweite importiert eine GEDCOM Datei in einen leeren Stammbaum.

Zusätzlich kannst du Gramps den Namen des zu öffnenden Stammbaums mitgeben:

  • verwende diese Option :
    -O Dateiname
    or
    --open=Dateiname 

-O, Öffnen eines Stammbaum. Dies kann auch durch die einfache Eingabe des namens geschehen (Name oder Datenbankverzeichnis)

Beispiele:

python gramps.py 'Stammbaum 1'
python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
python gramps.py -O 'Stammbaum 1'
python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d


Tango-Dialog-information.png
Tipp

Wenn der Dateiname ohne Option angegeben wird, versucht Gramps die Datei zu öffnen und anschließend eine interaktive Arbeitssitzung gestartet.


Das Format kann festgelegt werden mit dem

-f Format

oder

--format=Format

Parameter, direkt gefolgt vom Dateinamen. Wenn nicht angegeben, wird versucht es aus dem Dateinamen zu ermitteln.

Tango-Dialog-information.png
Tipp

Nur Stammbäume können direkt geöffnet werden. Für andere Formate benötigst du die Importoption, welche die leere Datenbank einrichtet und dann die Daten in sie importiert.


Tango-Dialog-information.png
Tipp

Es kann nur ein Stammbaum geöffnet werden. Wenn du Daten aus verschiedenen Quellen kombinieren musst, benötigst du die Importoption.


Importoptionen

Die für den Import vorgesehenen Dateien können mit dem

-i Dateiname

oder

--import=Dateiname

Parameter angegeben werden. Das Format kann mit dem -f oder --format=Format Parameter bestimmt werden, dem sofort der Dateiname folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem Dateiname zu ermitteln.

Beispiele:

  python gramps.py -i 'Stammbaum 1' -i 'Stammbaum 2'
  python gramps.py -i test.grdb -i daten.gramps
Tango-Dialog-information.png
Tipp

Es können mehr als eine Datei mit einem Kommando importiert werden. Wenn dies der Fall ist, integriert Gramps die Daten aus der nächsten Datei in die Datenbank, die in diesem Moment existiert.


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

es können unterschiedliche Gramps-ID's in der resultierenden Datenbank entstehen..

Exportoptionen

Die für den Export vorgesehenen Dateien können mit dem Parameter

-e Dateiname

oder

--export=Dateinamean

gegeben werden. Das Format kann mit dem

-f

Parameter bestimmt werden, dem sofort der Dateinamen folgt. Falls es nicht angegeben wird, wird versucht das Format aus dem Dateinamen zu ermitteln. Für ISO-Formate, ist der Dateiname der Name des Verzeichnisses, in das die Gramps-Datenbank geschrieben wird. Für gramps-xml, gpkg, gedcom, wft, geneweb und gramps-pkg ist der Dateiname der Name der resultierenden Datei.

-e, exportiert einen Stammbaum in das gewünschte Format. Es ist nicht möglich in einen Stammbaum zu exportieren.

Beispiele:

 python gramps.py -i 'Stammbaum 1' -i test.grdb -f grdb -e verschmolzeneDB.gramps

Beachte das das obige Beispiel 'Stammbaum 1' nicht verändert, da alles über eine temporäre Datenbank geschieht, wohingegen:

 python gramps.py -O 'Stammbaum 1' -i test.grdb -f grdb -e verschmolzeneDB.gramps

test.grdb nach 'Stammbaum 1' importiert und dann das Ergebnis in eine Datei exportiert !

Tango-Dialog-information.png
Mehrere Dateien exportieren

Es können mehr als eine Datei mit einem Kommando exportiert werden. In diesem Fall versucht Gramps mehrere Dateien unter Verwendung der in diesem Moment verfügbaren Datenbank zuschreiben.


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

Aktionsoptionen

Die Aktion, die mit den importierten Daten durchgeführt werden soll, kann über die

-a Aktion

oder

--action=Aktion

Option angegeben werden. Diese wird ausgeführt, nachdem alle Importe erfolgreich abgeschlossen sind.


Die folgenden Aktionen sind gleich geblieben:

  • report: Diese Aktion erlaubt das erstellen von Berichten über die Kommandozeile.
  • tool: Diese Aktion ermöglicht ein Werkzeug von einer Kommandozeile zu starten.

Da Berichte und Werkzeuge eine Reihe eigener Optionen haben, sollten diese Aktionen die Berichts/Werkzeug Optionenzeichenkette folgen. Die Zeichenkette wird mit der

-p Optionszeichenkette

oder

--options=Optionszeichenkette

Option übergeben.

Die Aktionen aus älteren Gramps Versionen, die in Gramps 3.3 umgezogen sind:

  • summary: Diese Aktion war dieselbe wie Berichte ->Ansicht ->Zusammenfassung. In Gramps 3.3 wurde es ersetzt durch (oder umbenannt in) -a report -p name=summary.
  • check: Diese Aktion war dieselbe wie Werkzeuge ->Datenbankverarbeitung ->Überprüfen und reparieren . In Gramps 3.3 wurde es ersetzt durch (oder umbenannt in) -a tool -p name=check.

Berichtaktionoptionen

Du kannst die meisten Berichte von der Kommandozeile aus mit Hilfe der report Aktion erstellen. Ein Beispiel:

gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html"

Du kannst den css Stil der verwendet werden soll mit der css Option angeben:

gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css=Web_Nebraska.css"

oder ohne css in der HTMl Ausgabe:

gramps -O "Stammbaum 1" -a report -p "name=family_group,style=default,off=html,of=test.html,css="
Tango-Dialog-information.png
Berichtsoption Zeichenkette

Die Berichtsoption sollte folgende Bedingungen erfüllen: Sie darf keine Leerzeichenenthalten. Wenn eine Option Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. Eine Option besteht aus dem Optionsnamen und dem Wert. In einer Option müssen der Optionsname und Optionswert durch ein Gleichheitszeichen getrennt werden. Verschiedene Paare müssen durch Komma getrennt werden. Die meiten Bericht Optionen sind speziell für jeden Bericht. Allerdings gibt es einige allgemeine Optionen.


Die meisten Berichtsoptionen sind berichtspezifisch. Jedoch gibt es einige übliche Optionen.

  • name=Berichtname: Diese benötigte Option bestimmt welcher Bericht erzeugt wird. Wenn der übergebene Berichtname nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefolgt von einer Liste verfügbarer Berichte ausgegeben.
  • of : Ausgabe Dateiname
  • off: Ausgabeformat. Dies sind die Dateierweiterungen die das Ausgabeformat bestimmen, z.B., pdf, html, doc, ...
  • style: für Textberichte, die zu verwendende Formatvorlage. Vorgabe 'default'.
  • show=all: Dies erstellt eine Liste der Namen aller verfügbaren Optionen für den angegebenen Bericht.
  • show=option_name: Dies zeigt die Beschreibung der Funktionalität die durch Option_Name bereit gestellt wird, genauso wie die akzeptierten Arten und Werte für diese Option.

So, um die Verwendung von report zu lernen, führe folgendes als Beispiel aus:

gramps -O "Stammbaum 1" -a report -p "name=family_group,show=all"
Tango-Dialog-information.png
Tipp

Wenn ein Parameter nicht angegeben wird, wird der zuletzt verwendete Wert genommen. Wenn dieser Bericht vorher nie erstellt wurde, wird wenn möglich der Wert des zuletzt erstellten Berichts verwendet. Sonnst wird der Standardwert verwendet.


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

Tango-Dialog-information.png
Listen

Einige Berichte besitzen Optionen oder Argumente, die als mehrzeiler interpretiert werden (von den Berichten). Zum Beispiel ermöglichen dir manche Berichte zu formatieren, wie die Informationen dargestellt werden eventuell mit dem Namen in der einen Zeile und dem Geburtsdatum der Person auf der nächsten. Solche mehrzeiligen Optionen oder Argumente werden von Gramps "Listen" genannt.


Auf der Kommandozeile müssen solche Listen immer mit einer linken eckigen Klammer beginnen

[

und müssen immer mit einer rechten eckigen Klammer enden

]

aber da solche eckigen Klammern im Normalfall etwas "spezielles" für die "Shell" sind (sie bedeuten etwas für den Kommandozeileninterpreter in den du das Kommando eingibst), musst du sie "maskieren" so das sie von deiner Shell ignoriert werden.

Die Details variieren für jede Shell aber (in Linux/UNIX) normalerweise kannst du solch einer eckigen Klammer einen Backslash (Rückwärtsschrägstrich) voranstellen.

\

oder setze Anführungszeichen um die eckige Klammer, gewöhnlich entweder "einfache" oder "doppelte".

Der Stundenglasbericht erlaubt dir eine "Notiz" über den Bericht zu setzen und solch eine "Notiz" ist ein Beispiel für eine "Listen" Option. Hier ist ein Beispiel:

gramps -O "Stammbaum 1" -a report -p name=hourglass_graph,note='[Zeile eins,Zeile zwei]' 

was zeigt, das innerhalb solch einer Liste Zeilen durch Komma getrennt werden und Leerzeichen erlaubt sind, solange die Anführungszeichen wegen den eckigen Klammer bereits vorhanden sind.

Aber wenn du Kommas in deinem Bericht haben möchtest, musst du Gramps irgendwie mitteilen, das diese Kommas keine Zeilentrenner sind. Du machst dies, indem du die Zeile mit dem Komma in Anführungszeichen setzt (entweder einfache oder doppelte).

Wenn du aber bereits ein Paar Anführungszeichen verwendest (um deine eckigen Klammern einzuschließen) musst du die andere Art verwenden, um die Zeile mit dem Komma einzuschließen. Hier ist ein Beispiel:

gramps -O "Stammbaum 1" -a report -p name=hourglass_graph,note="['Zeile 1, auch Zeile 1','Zeile 2, auch Zeile 2']"

Es ist möglich, jedes Zeichen in einer Liste aufzunehmen aber die Details gehen über den Umfang einer Anleitung für die Kommandozeile von Gramps hinaus.

Du musst die genauen Methoden deines Kommandozeileninterpreters kennen, um ein Zeichen welches für deine Shell oder Gramps "speziell" ist (wie das Komma im obigen Beispiel) aufzunehmen aber generell musst du es zweifach "maskieren" einmal für deine Shell und zweiten für Gramps da du nicht willst, das deine Shell denkt es sei ein Kommando, auf das sie achten muss und du willst auch nicht das Gramps dies denkt.

Werkzeugaktionoption

Du kannst die meisten Werkzeuge durch Verwendung der 'tool' Aktion von der Kommandozeile ausführen. Anzeigen aller verfügbaren Werkzeuge:

gramps -O "Stammbaum 1" -a tool -p show=all

Die verfügbaren Optionen für ein Werkzeug anzeigen etwa für das "verify" Werkzeug:

gramps -O "Stammbaum 1" -a tool -p name=verify,show=all

Ein Werkzeug ausführen etwas das "verify" Werkzeug:

gramps -O "Stammbaum 1" -a tool -p name=verify

Buchaktionoptionen (neu in 4.0)

Du kannst Bücher aus der Kommandozeile mit der 'book' Aktion erstellen. Um zu sehen welche sage:

gramps -O "Stammbaum 1" -a book

Um alle für ein Buch, zum Beispiel "meinBuch", verfügbaren Optionen zu sehen:

gramps -O "Stammbaum 1" -a book -p name=meinBuch,show=all

Um ein Buch, zum Beispiel ein Buch "meinBuch" zu erstellen:

gramps -O "Stammbaum 1" -a book -p name=meinBuch

Entsperren erzwingen Option

-u, du kannst den -O Parameter mit -u erweitern, um das Entsperren eines Stammbaum zu erzwingen. Dies ermöglicht den Wiedereinstieg von der Kommandozeile nach einem Absturz der den Stammbaum (Datenbank) gesperrt hinterlassen hat.

Ein Beispiel (um die "Stammbaum 1" Datenbank zu entsperren):

gramps -O "Stammbaum 1" -a report -u > /dev/null

Beachte es ist nicht möglich, Stammbäume die eine Reparatur benötigen von der Kommandozeile zu öffnen.

Konfiguration (config) Option

Die Option gibt es in drei Formen: (Die folgenden Beispiele, außer 3.2, verwenden behavior.database-path als die zu ändernde Konfigurationsvariable.)

1) Alle Konfigurationswerte anzeigen

 -s oder --show

2) Einen Wert zeigen:

--config=behavior.database-path
oder
-c behavior.database-path

3) Einen Wert setzen:

--config=behavior.database-path:'/media/mydb'
oder
-c behavior.database-path:'/media/mydb'

3.1) Einen Wert auf seinen Standard setzen:

--config=behavior.database-path:DEFAULT
oder
-c behavior.database-path:DEFAULT


3.2) Mehr als einen Wert setzen:

--config=behavior.use-tips:False --config=behavior.autoload:True
oder
-c behavior.use-tips:False -c behavior.autoload:True

Wenn alle Konfigurationsvariablen gesetzt sind, startet Gramps mit diesen neuen Werten.

Bedienung

Wenn das erste Argument auf der Kommandozeile nicht mit einem Strich beginnt (z.B. kein Parameter), versucht Gramps die Datei mit dem Namen des ersten Arguments zu öffnen und eine interaktive Sitzung zu starten. Der rest der Kommandozeilenargumente wird ignoriert.

Wenn der

-O

Parameter gesetzt ist, versucht Gramps den gelieferten Dateinamen zu öffnen und dann mit den Daten wie in weiteren Parametern angegeben zu arbeiten.

Gramps-notes.png
Notiz

Pro Aufruf von Gramps kann nur eine Datei geöffnet werden. Wenn du Daten aus mehreren Quellen benötigst, verwende die Importoptionen über die
-i
Option.

Mit oder ohne den

-O

Parameter, können mehrere Importe, Exporte und Aktionen in der Kommandozeile weiter spezifiziert werden durch Verwendung der

-i

,

-e

, und

-a

Parameter. Die Reihenfolge der

-i

,

-e

, oder

-a

Parameter spielt keine Rolle. Die tatsächliche Ausführungsreihenfolge ist immer: alle Importe (wenn vorhanden) -> alle Exporte (wenn vorhanden) -> alle Aktionen (wenn vorhanden).

'

Gramps-notes.png
Notiz

Aber öffnen muss immer die Erste sein!

Wenn kein

-O

oder

-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. (Außer du hast schon eine "Präferenz" gesetzt, das es mit der letzten verwendeten Datenbank starten soll.) Wenn kein

-e

oder

-a

Parameter angegeben ist, startet Gramps sein Hauptfenster und startet die gewöhnliche interaktive Sitzung mit der, aus öffnen und allen Importen (wenn vorhanden) resultierenden Datenbank. Die Datenbank liegt dann in der Datei import_db.grdb in dem Verzeichnis ~/.gramps/import/.

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

Beispiele

  • Um vier Datenbanken zu importieren (deren Format aus ihrem Namen erschlossen werden kann) und die sich ergebende Datenbank auf Fehler zu überprüfen, kann man folgendes eingeben:
gramps -i Datei1.ged -i Datei2.gpkg -i ~/DB3.gramps -i Datei4.wft -a check
  • Um die Formate in dem obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit den entsprechenden -f Optionen:
gramps -i Datei1.ged -f gedcom -i Datei2.gpkg -f gramps-pkg -i ~/DB3.gramps -f gramps-xml -i Datei4.wft -f wft -a check
  • Um die Datenbank die sich aus den Importen ergibt aufzuzeichnen, verwende das -e Flag (verwende -f wenn der Dateiname es Gramps nicht erlaubt das Format zu vermuten):
gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg
  • Um jede Fehlermeldung aus dem obigen Beispiel in die Dateien ausgabedatei und fehlerdatei zu speichern, starte:
gramps -i Datei1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >ausgabedatei 2>fehlerdatei 
  • Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis zu starten:
gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps 
  • Um eine Datenbank zu öffnen und basierend auf diesen Daten einen Zeitlinienbericht im PDF-Format zu erstellen und inder Datei meine_zeitlinie.pdf zu speichern:
gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf 
Tango-Dialog-information.png
Zeitlinienberichtoptionen

Verwende name=timeline,show=all um alle Optionen für den Zeitlinien Bericht zu sehen. Um Einzelheiten einer bestimmten Option zu erhalten verwende show=Optionsname, z.B. name=timeline,show=off. Um mehr über verfügbare Berichtsnamen zu erfahren, verwende die name=show Zeichenfolge.


  • Um eine grdb spontan in eine .gramps XML-Datei umzuwandeln:
gramps -O 'Stammbaum 1' -e ausgabe.gramps -f gramps-xml
  • Um eine Webseite in einer anderen Sprache (Deutsch) zu erstellen:
LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de 
  • Zum Abschluss um eine normale Interaktive Sitzung zu starten, tippe:
gramps 

Umgebungsvariablen

Gramps kann diese Umgebungsvariablen berücksichtigen (Aber ändere sie nur wenn du weist was du tust):

  • GRAMPSHOME - wenn gesetzt, überschreibt es den Standardpfad zum Profil, und ermöglicht Anwendern externe Netzlaufwerke zur Speicherung der Daten und aller Einstellungen zu verwenden. Für technisch erfahrene Anwender, die verschiedene Versionen von Gramps starten, ist das setzen von verschiedenen $GRAMPSHOME ein Weg, Störungen zwischen verschiedenen Versionen im Gramps Anwenderverzeichnis zu vermeiden.
  • LANG - wird von Gramps verwendet, um festzulegen welche Sprachdatei geladen wird.
Zurück Index Nächste