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

From Gramps
Jump to: navigation, search
Line 43: Line 43:
  
 
Zum Beispiel kann das sein:
 
Zum Beispiel kann das sein:
  cd "\Program Files\GrampsAIO64\bin
+
  cd "\Program Files\GrampsAIO64"
  "C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py
+
  gramps
  
 
Wenn die Anweisungen weiter unten dir mitteilen, etwas nach dem Startkommando einzugeben, gibst du dies einfach am Ende der letzten Zeile ein zum Beispiel:
 
Wenn die Anweisungen weiter unten dir mitteilen, etwas nach dem Startkommando einzugeben, gibst du dies einfach am Ende der letzten Zeile ein zum Beispiel:
  cd "\Program Files\GrampsAIO64\bin
+
  cd "\Program Files\GrampsAIO64"
  "C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py -L
+
  gramps -L
  
 
Es gibt noch andere Möglichkeiten, Gramps unter Windows zu installieren, diese sind aber weit komplizierter und werden hier nicht behandelt.
 
Es gibt noch andere Möglichkeiten, Gramps unter Windows zu installieren, diese sind aber weit komplizierter und werden hier nicht behandelt.
Line 69: Line 69:
  
 
In den Beispielen für verschiedene Plattformen oben und auch in Kommandos in verschiedenen Dateien, kann es sein, dass du einige Optionen nach dem 'python' Kommando siehst, zum Beispiel '-EO' in
 
In den Beispielen für verschiedene Plattformen oben und auch in Kommandos in verschiedenen Dateien, kann es sein, dass du einige Optionen nach dem 'python' Kommando siehst, zum Beispiel '-EO' in
  "C:\Program Files\GrampsAIO64\bin\pythonw.exe" -EO ..\share\gramps\gramps.py -L
+
  "python3 -EO ..\share\gramps\gramps.py -L
  
 
Es ist wichtig, zu unterscheiden zwischen den '''Python Optionen''' in diesem Fall:
 
Es ist wichtig, zu unterscheiden zwischen den '''Python Optionen''' in diesem Fall:
Line 81: Line 81:
  
 
Der <code>-O</code> Optimierungsbitschalter hat eine Reihe von Auswirkungen in Gamps:
 
Der <code>-O</code> Optimierungsbitschalter hat eine Reihe von Auswirkungen in Gamps:
* Wenn er nicht aktiviert ist, erscheint ein zusätzlicher {{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools#Debug|Debug]]}} Eintrag im {{man menu|[[Gramps_5.1_Wiki_Manual_-_Tools|Werkzeug]]}} Menü.
+
* Wenn er nicht aktiviert ist, erscheint ein zusätzlicher {{man menu|[[De:Gramps_5.1_Wiki_Handbuch_-_Werkzeuge#Debug|Debug]]}} Eintrag im {{man menu|[[De:Gramps_5.1_Wiki_Handbuch_-_Werkzeuge|Werkzeug]]}} Menü.
 
* Wenn er nicht aktiviert ist, werden [[Logging_system#So_how_logging_works_in_Gramps_after_all.3F|info Lognachrichten ausgegeben]].
 
* Wenn er nicht aktiviert ist, werden [[Logging_system#So_how_logging_works_in_Gramps_after_all.3F|info Lognachrichten ausgegeben]].
 
* Wenn er nicht aktiviert ist, [[Debugging_Gramps#Add_debug_statements|debug statements]] können aktiviert sein.
 
* Wenn er nicht aktiviert ist, [[Debugging_Gramps#Add_debug_statements|debug statements]] können aktiviert sein.
Line 95: Line 95:
 
   gramps --help
 
   gramps --help
  
Verwendung: gramps.py [OPTION...]
+
<pre>
    --load-modules=MODUL1,MODUL2,...    Dynamische Module laden
+
Verwendung: gramps.py [OPTION...]
 +
  --load-modules=MODUL1,MODUL2,...    Dynamische Module laden
 +
 
 +
Hilfe Optionen
 +
  -?, --help                            Zeigt diese Hilfe Information
 +
  --usage                                Zeigt eine kurze Anwendungsinformation
  
  Hilfe Optionen
+
Anwendungsoptionen
  -?, --help                             Zeigt diese Hilfe Information
+
  -O, --open=STAMMBAUM                  Stammbaum öffnen
  --usage                                Zeigt eine kurze Anwendungsinformation
+
  -U, --username=USERNAME                Database username
 +
  -P, --password=PASSWORD                Database password
 +
  -C, --create=STAMMBAUM                Stammbaum beim Öffnen neu erstellen wenn er nicht existiert
 +
  -i, --import=DATEINAME                Datei importieren
 +
  -e, --export=DATEINAME                Datei exportieren
 +
  -r, --remove=FAMILY_TREE_PATTERN      Remove matching Family Tree(s) (use regular expressions)
 +
  -f, --format=FORMAT                    Stammbaumformat festlegen
 +
  -a, --action=AKTION                    Aktion festlegen
 +
  -p, --options=OPTIONEN_ZEICHENKETTE    Optionen festlegen
 +
  -d, --debug=LOGGER_NAME                Fehlerprotokolierung aktivieren
 +
  -l  [FAMILY_TREE_PATTERN...]          Stammbäume auflisten
 +
  -L  [FAMILY_TREE_PATTERN...]          Stammbäume mit Details auflisten
 +
  -t [FAMILY_TREE_PATTERN...]          Stammbäume durch Tab. getrennt auflisten
 +
  -u, --force-unlock                    Entsperren des Stammbaum erzwingen
 +
  -s, --show                            Konfig. Einstellungen zeigen
 +
  -c, --config=[config.setting[:Wert]]  Konfig. Einstellung(en) setzen und Gramps starten
 +
  -y, --yes                              Bei gefährlichen Aktionen nicht nachfragen (nur im nicht Grafikmodus)
 +
  -q, --quiet                            Fortschrittsausgabe unterdrücken (nur im nicht Grafikmodus)
 +
  -v, --version                          Versionen zeigen
 +
  -S, --safe                             Start Gramps in 'Safe mode'
 +
                                          (temporarily use default settings)
 +
  -D, --default=[APXFE]                  Reset settings to default;
 +
                A - addons are cleared
 +
                P - Preferences to default
 +
                X - Books are cleared, reports and tool settings to default
 +
                F - filters are cleared
 +
                E - Everything is set to default or cleared
 +
</pre>
  
Anwendungsoptionen
+
Die Verwendungsnachricht lautet wie folgt:
 
  -O, --open=STAMMBAUM                  Stammbaum öffnen
 
  -C, --create=STAMMBAUM                Stammbaum beim Öffnen neu erstellen wenn er nicht existiert
 
  -i, --import=DATEINAME                Datei importieren
 
  -e, --export=DATEINAME                Datei exportieren
 
  -f, --format=FORMAT                    Stammbaumformat festlegen
 
  -a, --action=AKTION                    Aktion festlegen
 
  -p, --options=OPTIONEN_ZEICHENKETTE    Optionen festlegen
 
  -d, --debug=LOGGER_NAME                Fehlerprotokolierung aktivieren
 
  -l                                    Stammbäume auflisten
 
  -L                                    Stammbäume mit Details auflisten
 
  -t                                    Stammbäume durch Tab. getrennt auflisten
 
  -u, --force-unlock                    Entsperren des Stammbaum erzwingen
 
  -s, --show                            Konfig. Einstellungen zeigen
 
  -c, --config=[config.setting[:Wert]]  Konfig. Einstellung(en) setzen und Gramps starten
 
  -y, --yes                              Bei gefährlichen Aktionen nicht nachfragen (nur im nicht Grafikmodus)
 
  -q, --quiet                            Fortschrittsausgabe unterdrücken (nur im nicht Grafikmodus)
 
  -v, --version                          Versionen zeigen
 
  
Die Anwendungsinformation ist folgende:
+
gramps --usage
  
Beispiel zur Verwendung der Gramps Kommandozeilenschnittstelle                                                   
+
<pre>
 +
Beispiel zur Verwendung der Gramps Kommandozeilenschnittstelle                                                   
 
                                                                                                                  
 
                                                                                                                  
1. Zum Import von vier Datenbanken (deren Format aus deren Namen erkennbar ist) und Fehlerprüfung der resultierenden Datenbank kann man folgendes eingeben:                                     
+
1. Zum Import von vier Datenbanken (deren Format aus deren Namen erkennbar ist) und Fehlerprüfung der resultierenden Datenbank kann man folgendes eingeben:                                     
 
  gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps -i Datei4.wft -a check                                       
 
  gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps -i Datei4.wft -a check                                       
 
   
 
   
2. Um das Format im obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit der passenden -f Option:
+
2. Um das Format im obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit der passenden -f Option:
 
  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
 
  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
 
   
 
   
3. Zum Aufzeichnen der Datenbank, die aus allen Importen resultiert, verwende das -e Flag
+
3. Zum Aufzeichnen der Datenbank, die aus allen Importen resultiert, verwende das -e Flag
 
  (verwende -f wenn der Dateiname es Gramps nicht ermöglicht das Dateiformat zu erkennen):
 
  (verwende -f wenn der Dateiname es Gramps nicht ermöglicht das Dateiformat zu erkennen):
 
  gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg
 
  gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg
 
   
 
   
4. Zum Speichern aller Fehlermeldungen aus dem obigen Beispiel in die Dateien Ausgabedatei und Fehlerdatei, starte:
+
4. Zum Speichern aller Fehlermeldungen aus dem obigen Beispiel in die Dateien Ausgabedatei und Fehlerdatei, starte:
 
  gramps -i Datei1.ged -i Datei2.dpkg -e ~/new-package -f gramps-pkg >Ausgabedatei 2>Fehlerdatei
 
  gramps -i Datei1.ged -i Datei2.dpkg -e ~/new-package -f gramps-pkg >Ausgabedatei 2>Fehlerdatei
 
   
 
   
5. Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis:
+
5. Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis:
 
  gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps
 
  gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps
 
   
 
   
6. Eine Datenbank öffnen und anhand ihrer Daten einen Zeitlinienbericht als PDF-Dokument der meine_zeitlinie.pdf Datei:
+
6. Eine Datenbank öffnen und anhand ihrer Daten einen Zeitlinienbericht als PDF-Dokument der meine_zeitlinie.pdf Datei:
 
  gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf
 
  gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf
 
   
 
   
7. Um eine Zusammenfassung der Datenbank zu erstellen, verwende:
+
7. Um eine Zusammenfassung der Datenbank zu erstellen, verwende:
 
  gramps -O 'Stammbaum 1' -a report -p name=summary
 
  gramps -O 'Stammbaum 1' -a report -p name=summary
 
   
 
   
8. Berichtsoptionen listen
+
8. Berichtsoptionen listen
 
  Verwende name=timeline,show=all um alle Optionen für den Zeitlinienbericht zu erhalten.
 
  Verwende name=timeline,show=all um alle Optionen für den Zeitlinienbericht zu erhalten.
 
  Um Details zu einer bestimmten Option zu erhalten, verwende show=Optionsname , z.B.. name=timeline,show=off string.
 
  Um Details zu einer bestimmten Option zu erhalten, verwende show=Optionsname , z.B.. name=timeline,show=off string.
 
  Um die verfügbaren Berichtsnamen zu sehen, verwende name=show string.
 
  Um die verfügbaren Berichtsnamen zu sehen, verwende name=show string.
 
   
 
   
9. Um einen Stammbaum schnell in eine Gramps XML Datei umzuwandeln, verwende:
+
9. Um einen Stammbaum schnell in eine Gramps XML Datei umzuwandeln, verwende:
 
  gramps -O 'Stammbaum 1' -e Ausgabe.gramps -f gramps-xml
 
  gramps -O 'Stammbaum 1' -e Ausgabe.gramps -f gramps-xml
 
   
 
   
10. Um einen Webauftritt in einer anderen Sprache zu erstellen (in deutsch), verwende:
+
10. Um einen Webauftritt in einer anderen Sprache zu erstellen (in deutsch), verwende:
 
  LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de
 
  LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de
 
   
 
   
11. Um abschließend eine normale interaktive Sitzung zu starten, gib folgendes ein:
+
11. Um abschließend eine normale interaktive Sitzung zu starten, gib folgendes ein:
 
  gramps
 
  gramps
 
   
 
   
Bemerkung: Die Beispiele sind für die bash Shell
+
Bemerkung: Die Beispiele sind für die bash Shell.
Die Syntax kann sich für andere Shells oder Windows ändern.
+
Die Syntax kann sich für andere Shells oder Windows ändern.
 +
 
 +
</pre>
  
 
=== Listenoptionen ===
 
=== Listenoptionen ===
Line 171: Line 188:
 
  -l, gibt eine Liste bekannter Stammbäume aus
 
  -l, gibt eine Liste bekannter Stammbäume aus
  
[[Image:CommandLineExampleOutput-l-40.png|400px|thumb|right|Abb. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Kommandozeile Beispielausgabe für ''python gramps.py -l'']]
+
gramps -l
 +
 
 +
<pre>
 +
List of known Family Trees in your database path
 +
 
 +
/home/<~username>/.gramps/grampsdb/5a46c1c3 with name "Example Family Tree"
 +
</pre>
 
{{-}}
 
{{-}}
  
Line 177: Line 200:
 
  -L, gibt eine detaillierte Liste bekannter Stammbäume aus
 
  -L, gibt eine detaillierte Liste bekannter Stammbäume aus
  
[[Image:CommandLineExampleOutput_L-40.png|400px|thumb|right|Abb. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Kommandozeile Beispielausgabe für ''python gramps.py -L'']]
+
gramps -L
 
 
{{-}}
 
 
 
Beachte, das Daten im vorgegebenen LOCALE Format angezeigt werden. Du änderst dies auf Systemebene. Zum Beispiel auf POSIX basierenden Systemen kannst du folgendes eingeben:
 
  
LC_TIME=en_AU.UTF-8 gramps -L
+
<pre>
 +
Gramps Family Trees:
 +
Family Tree "Example Family Tree":
 +
  Database: SQLite
 +
  Database module location: /usr/lib/python3.5/sqlite3/__init__.py
 +
  Database module version: 2.6.0
 +
  Database version: 3.11.0
 +
  Last accessed: 30/12/17 09:29:37
 +
  Locked?: False
 +
  Number of citations: 2854
 +
  Number of events: 3432
 +
  Number of families: 762
 +
  Number of media: 7
 +
  Number of notes: 19
 +
  Number of people: 2157
 +
  Number of places: 1294
 +
  Number of repositories: 3
 +
  Number of sources: 4
 +
  Number of tags: 2
 +
  Path: /home/<~username>/.gramps/grampsdb/5a46c1c3
 +
  Schema version: 18.0.0
 +
</pre>
  
 +
{{man note|Beachte, das Daten im vorgegebenen LOCALE Format angezeigt werden.|Du änderst dies auf Systemebene. Zum Beispiel auf [[Gramps_Glossary#posix|POSIX]] basierenden Systemen kannst du folgendes eingeben:
 +
<pre>LC_TIME=en_AU.UTF-8 gramps -L</pre>}}
 
{{-}}
 
{{-}}
  
Line 192: Line 234:
 
         Informationen über Umgebungseinstellungen, Python und Systempfade
 
         Informationen über Umgebungseinstellungen, Python und Systempfade
  
[[Image:CommandLineExampleOutput-v-40.png|200px|thumb|right|Abb. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Kommandozeile Beispielausgabe für ''python gramps.py -v'']]
+
gramps -v
 +
 
 +
<pre>
 +
Gramps Settings:
 +
----------------
 +
python    : 3.7.5
 +
gramps    : 5.1.1
 +
gtk++    : 3.24.12
 +
pygobject : 3.34.0
 +
pango    : 1.42.3
 +
cairo    : 1.16.0
 +
pycairo  : 1.16.2
 +
osmgpsmap : 1.0
 +
GExiv2    : 0.10
 +
ICU      : 63.1
 +
PyICU    : 2.2
 +
o.s.      : linux
 +
kernel    : 5.3.0-24-generic
 +
 
 +
Environment settings:
 +
---------------------
 +
LANG      : en_GB.UTF-8
 +
LANGUAGE  : en_GB:en
 +
GRAMPSI18N: not set
 +
GRAMPSHOME: not set
 +
GRAMPSDIR : not set
 +
PYTHONPATH:
 +
    /usr/lib/python3/dist-packages/gramps
 +
    /usr/bin
 +
    /usr/lib/python37.zip
 +
    /usr/lib/python3.7
 +
    /usr/lib/python3.7/lib-dynload
 +
    /usr/local/lib/python3.7/dist-packages
 +
    /usr/lib/python3/dist-packages
 +
 
 +
Non-python dependencies:
 +
------------------------
 +
Graphviz  : 2.40
 +
Ghostscr. : 9.27
 +
 
 +
System PATH env variable:
 +
-------------------------
 +
    /usr/local/sbin
 +
    /usr/local/bin
 +
    /usr/sbin
 +
    /usr/bin
 +
    /sbin
 +
    /bin
 +
    /usr/games
 +
    /usr/local/games
 +
    /snap/bin
 +
 
 +
Databases:
 +
-------------------------
 +
bsddb    :
 +
    version    : 6.2.6
 +
    db version  : 5.3.28
 +
    location    : /usr/lib/python3/dist-packages/bsddb3/__init__.py
 +
sqlite3  :
 +
    version    : 3.29.0
 +
    py version  : 2.6.0
 +
    location    : /usr/lib/python3.7/sqlite3/__init__.py
 +
</pre>
 +
 
 
{{-}}
 
{{-}}
  
 
=== Formatoptionen ===
 
=== Formatoptionen ===
  
Das Format jeder Datei, die geöffnet, importiert oder exportiert werden soll, kann mit der <code>-f format</code> Option festgelegt werden. Die zulässigen <tt>''format''</tt> Werte sind unten aufgelistet.
+
Das Format jeder Datei, die geöffnet, importiert oder exportiert werden soll, kann mit der <pre>-f format</pre> Option festgelegt werden. Die zulässigen <tt>''format''</tt> Werte sind unten aufgelistet.
  
 
==== Volle Stammbaum Unterstützung ====
 
==== Volle Stammbaum Unterstützung ====

Revision as of 21:07, 10 July 2020

Zurück Index Nächste


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

Gramps über die Kommandozeile starten

Normalerweise startest du Gramps über die Grafischebenutzerschnittstelle (GUI) auf deiner Plattform.

Es ist auch möglich, Gramps über eine Kommandozeilenschnittstelle zu starten (CLI). Über die CLI kannst du

  • Berichte erstellen, die nicht über die GUI verfügbar sind,
  • Berichte erstellen, Konvertierungen usw. durchführen ohne ein Fenster zu öffnen und
  • kann zusätzliche Informationen im Fall von Problemen liefern.

Dieser Abschnitt des Benutzerhandbuchs beschreibt, wie Gramps über das CLI gestartet wird, und die zur Verfügung stehenden Funktionen.

Die Art wie du Gramps über das CLI startest, hängt von dem Betriebssystem, das du verwendest ab.

Zur Vereinfachung der Beschreibung, sind die Beispiele unten aus der Sicht von der Verwendung von Gramps unter Linux geschrieben. Die Beispiele müssen bei Bedarf für andere Plattformen angepasst werden.

Linux

Nur die Linux Plattform wird offiziell unterstützt da die Gramps Entwickler den Quelltext auf dieser Plattform verwenden, testen und alle Probleme beheben, die durch Aktualisierungen auftreten.

Angenommen, du hast die Standardpaketverwaltung deiner Distribution (CLI oder GUI) verwendet, um Gramps zu installieren, startest du Gramps in der Kommandozeile (CLI) durch die Eingabe von

gramps

MS Windows

MS Windows ist eine von der Gemeinschaft unterstützte Plattform. Wenn du die Windows AIO GrampsAIO32 oder GrampsAIO64 installierst, wird ein Icon auf dem Desktop und ein Eintrag im Startmenü erstellt.

Was ist der beste Weg, um herauszufinden, welches Kommando ich eingeben muss?

Das Starten von Gramps aus der Kommandozeile (cmd.exe) hängt davon ab, wo du Gramps installiert hast.

  • Rechts klicke auf die Terminal Gramps Anwendung oder den entsprechenden Menüeintrag.
  • Notiere dir das Startverzeichnis.
  • Markiere das gesamte Kommando und kopiere (Strg+C) es.
  • Starte im Startmenü cmd.exe.
  • Wechsel in das Startverzeichnis, welches du notiert hast.
  • Rechts-klicken und Einfügen wählen.
  • Drücke Enter.

Zum Beispiel kann das sein:

cd "\Program Files\GrampsAIO64"
gramps

Wenn die Anweisungen weiter unten dir mitteilen, etwas nach dem Startkommando einzugeben, gibst du dies einfach am Ende der letzten Zeile ein zum Beispiel:

cd "\Program Files\GrampsAIO64"
gramps -L

Es gibt noch andere Möglichkeiten, Gramps unter Windows zu installieren, diese sind aber weit komplizierter und werden hier nicht behandelt.

Mac OS X

Mac OS X ist eine von der Gemeinschaft unterstützte Plattform. Wenn du das Mac OS X disk image (.dmg) herunter geladen hast, dann ziehst du die Anwendung einfach in dein Anwendungsverzeichnis (oder irgendwo anders wo du sie speichern willst) und startest Gramps wie üblich durch doppelt klicken auf die Anwendung.

Um Gramps von der Kommandozeile zu starten, musst du Terminal starten, zu finden unter Anwendungen:Utilities. Wenn du ein Terminalfenster geöffnet hast, gib an der Eingabeaufforderung folgendes ein

/Pfad/zur/Gramps.app/Contents/MacOS/Gramps

Wenn du Gramps unter Applications neben den meisten anderen Anwendungen installiert hast, ist dies

 /Applications/Gramps.app/Contents/MacOS/Gramps

Du kannst damit zusammen jede Kommandozeilenoption verwenden. Zum Beispiel, um eine detaillierte Liste aller Stammbaumdatenbankern in deinem Standardstammbaumverzeichnis zu erhalten, würdest du folgendes eingeben:

 /Applications/Gramps.app/Content/MacOS/Gramps -L

Es gibt noch andere Möglichkeiten, Gramps unter Mac OS X zu installieren, diese sind aber weit komplizierter und werden hier nicht behandelt.

Python Optionen

In den Beispielen für verschiedene Plattformen oben und auch in Kommandos in verschiedenen Dateien, kann es sein, dass du einige Optionen nach dem 'python' Kommando siehst, zum Beispiel '-EO' in

"python3 -EO ..\share\gramps\gramps.py -L

Es ist wichtig, zu unterscheiden zwischen den Python Optionen in diesem Fall:

-EO

und der Gramps Option, in diesem Fall

-L

Die Python Optionen die dir begegnen können sind:

  • -E Ignoriere alle PYTHON* Umgebungsvariablen z.B. PYTHONPATH und PYTHONHOME, die gesetzt sein könnten.
  • -O Grundoptimierung anschalten. Dies ändert die Dateierweiterung für Kompilierte (Bytecode) Dateien von .pyc in .pyo. Siehe auch PYTHONOPTIMIZE.

Der -O Optimierungsbitschalter hat eine Reihe von Auswirkungen in Gamps:

Die Gramps Optionen werden unten beschrieben.

Verfügbare Gramps 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: Bedienung und Beispiele. Die Zusammenfassung unten wird ausgegeben von:

 gramps -h

oder

 gramps --help
Verwendung: gramps.py [OPTION...]
  --load-modules=MODUL1,MODUL2,...     Dynamische Module laden

Hilfe Optionen
  -?, --help                             Zeigt diese Hilfe Information
  --usage                                Zeigt eine kurze Anwendungsinformation

Anwendungsoptionen
  -O, --open=STAMMBAUM                   Stammbaum öffnen
  -U, --username=USERNAME                Database username
  -P, --password=PASSWORD                Database password
  -C, --create=STAMMBAUM                 Stammbaum beim Öffnen neu erstellen wenn er nicht existiert
  -i, --import=DATEINAME                 Datei importieren
  -e, --export=DATEINAME                 Datei exportieren
  -r, --remove=FAMILY_TREE_PATTERN       Remove matching Family Tree(s) (use regular expressions)
  -f, --format=FORMAT                    Stammbaumformat festlegen
  -a, --action=AKTION                    Aktion festlegen
  -p, --options=OPTIONEN_ZEICHENKETTE    Optionen festlegen
  -d, --debug=LOGGER_NAME                Fehlerprotokolierung aktivieren
  -l  [FAMILY_TREE_PATTERN...]           Stammbäume auflisten
  -L  [FAMILY_TREE_PATTERN...]           Stammbäume mit Details auflisten
  -t  [FAMILY_TREE_PATTERN...]           Stammbäume durch Tab. getrennt auflisten
  -u, --force-unlock                     Entsperren des Stammbaum erzwingen
  -s, --show                             Konfig. Einstellungen zeigen
  -c, --config=[config.setting[:Wert]]   Konfig. Einstellung(en) setzen und Gramps starten
  -y, --yes                              Bei gefährlichen Aktionen nicht nachfragen (nur im nicht Grafikmodus)
  -q, --quiet                            Fortschrittsausgabe unterdrücken (nur im nicht Grafikmodus)
  -v, --version                          Versionen zeigen
  -S, --safe                             Start Gramps in 'Safe mode'
                                          (temporarily use default settings)
  -D, --default=[APXFE]                  Reset settings to default;
                 A - addons are cleared
                 P - Preferences to default
                 X - Books are cleared, reports and tool settings to default
                 F - filters are cleared
                 E - Everything is set to default or cleared

Die Verwendungsnachricht lautet wie folgt:

gramps --usage
Beispiel zur Verwendung der Gramps Kommandozeilenschnittstelle                                                   
                                                                                                                 
1. Zum Import von vier Datenbanken (deren Format aus deren Namen erkennbar ist) und Fehlerprüfung der resultierenden Datenbank kann man folgendes eingeben:                                     
 gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps -i Datei4.wft -a check                                       
 
2. Um das Format im obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit der passenden -f Option:
 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
 
3. Zum Aufzeichnen der Datenbank, die aus allen Importen resultiert, verwende das -e Flag
 (verwende -f wenn der Dateiname es Gramps nicht ermöglicht das Dateiformat zu erkennen):
 gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg
 
4. Zum Speichern aller Fehlermeldungen aus dem obigen Beispiel in die Dateien Ausgabedatei und Fehlerdatei, starte:
 gramps -i Datei1.ged -i Datei2.dpkg -e ~/new-package -f gramps-pkg >Ausgabedatei 2>Fehlerdatei
 
5. Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis:
 gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps
 
6. Eine Datenbank öffnen und anhand ihrer Daten einen Zeitlinienbericht als PDF-Dokument der meine_zeitlinie.pdf Datei:
 gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf
 
7. Um eine Zusammenfassung der Datenbank zu erstellen, verwende:
 gramps -O 'Stammbaum 1' -a report -p name=summary
 
8. Berichtsoptionen listen
 Verwende name=timeline,show=all um alle Optionen für den Zeitlinienbericht zu erhalten.
 Um Details zu einer bestimmten Option zu erhalten, verwende show=Optionsname , z.B.. name=timeline,show=off string.
 Um die verfügbaren Berichtsnamen zu sehen, verwende name=show string.
 
9. Um einen Stammbaum schnell in eine Gramps XML Datei umzuwandeln, verwende:
 gramps -O 'Stammbaum 1' -e Ausgabe.gramps -f gramps-xml
 
10. Um einen Webauftritt in einer anderen Sprache zu erstellen (in deutsch), verwende:
 LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de
 
11. Um abschließend eine normale interaktive Sitzung zu starten, gib folgendes ein:
 gramps
 
Bemerkung: Die Beispiele sind für die bash Shell.
Die Syntax kann sich für andere Shells oder Windows ändern.

Listenoptionen

Eine Liste bekannter Stammbäume ausgeben:

Kurz
-l, gibt eine Liste bekannter Stammbäume aus
gramps -l
List of known Family Trees in your database path

/home/<~username>/.gramps/grampsdb/5a46c1c3 with name "Example Family Tree"


Ausführlich
-L, gibt eine detaillierte Liste bekannter Stammbäume aus
gramps -L
Gramps Family Trees:
Family Tree "Example Family Tree":
   Database: SQLite
   Database module location: /usr/lib/python3.5/sqlite3/__init__.py
   Database module version: 2.6.0
   Database version: 3.11.0
   Last accessed: 30/12/17 09:29:37
   Locked?: False
   Number of citations: 2854
   Number of events: 3432
   Number of families: 762
   Number of media: 7
   Number of notes: 19
   Number of people: 2157
   Number of places: 1294
   Number of repositories: 3
   Number of sources: 4
   Number of tags: 2
   Path: /home/<~username>/.gramps/grampsdb/5a46c1c3
   Schema version: 18.0.0
Gramps-notes.png
Beachte, das Daten im vorgegebenen LOCALE Format angezeigt werden.

Du änderst dies auf Systemebene. Zum Beispiel auf POSIX basierenden Systemen kannst du folgendes eingeben:

LC_TIME=en_AU.UTF-8 gramps -L


Versionsoptionen

-v oder --version zeigt die Version von Gramps und Abhängigkeiten, 
       Informationen über Umgebungseinstellungen, Python und Systempfade
gramps -v
Gramps Settings:
----------------
 python    : 3.7.5
 gramps    : 5.1.1
 gtk++     : 3.24.12
 pygobject : 3.34.0
 pango     : 1.42.3
 cairo     : 1.16.0
 pycairo   : 1.16.2
 osmgpsmap : 1.0
 GExiv2    : 0.10
 ICU       : 63.1
 PyICU     : 2.2
 o.s.      : linux
 kernel    : 5.3.0-24-generic

Environment settings:
---------------------
 LANG      : en_GB.UTF-8
 LANGUAGE  : en_GB:en
 GRAMPSI18N: not set
 GRAMPSHOME: not set
 GRAMPSDIR : not set
 PYTHONPATH:
    /usr/lib/python3/dist-packages/gramps
    /usr/bin
    /usr/lib/python37.zip
    /usr/lib/python3.7
    /usr/lib/python3.7/lib-dynload
    /usr/local/lib/python3.7/dist-packages
    /usr/lib/python3/dist-packages

Non-python dependencies:
------------------------
 Graphviz  : 2.40
 Ghostscr. : 9.27

System PATH env variable:
-------------------------
     /usr/local/sbin
     /usr/local/bin
     /usr/sbin
     /usr/bin
     /sbin
     /bin
     /usr/games
     /usr/local/games
     /snap/bin

Databases:
-------------------------
 bsddb     :
     version     : 6.2.6
     db version  : 5.3.28
     location    : /usr/lib/python3/dist-packages/bsddb3/__init__.py
 sqlite3   :
     version     : 3.29.0
     py version  : 2.6.0
     location    : /usr/lib/python3.7/sqlite3/__init__.py


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 oder --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, ignoriert Gramps den Rest der Kommandozeilenargumente. Verwende die -O Option zum öffnen, -i zum importieren und tue etwas mit den Daten.


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 Format 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.
Gramps-notes.png
Berichtsname

Wenn der übergebene Berichtname nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefolgt von einer Liste verfügbarer Berichte ausgegeben.

Available names are:
  ancestor_chart            - Ancestor Tree
  ancestor_report          - Ahnentafel Report
  birthday_report          - Birthday and Anniversary Report
  calendar                  - Calendar
  descend_chart            - Descendant Tree
  descend_report            - Descendant Report
  det_ancestor_report      - Detailed Ancestral Report
  det_descendant_report    - Detailed Descendant Report
  endofline_report          - End of Line Report
  family_descend_chart      - Family Descendant Tree
  family_group              - Family Group Report
  familylines_graph        - Family Lines Graph
  fan_chart                - Fan Chart
  hourglass_graph          - Hourglass Graph
  indiv_complete            - Complete Individual Report
  kinship_report            - Kinship Report
  navwebpage                - Narrated Web Site
  notelinkreport            - Note Link Report
  number_of_ancestors      - Number of Ancestors Report
  place_report              - Place Report
  records                  - Records Report
  rel_graph                - Relationship Graph
  statistics_chart          - Statistics Charts
  summary                  - Database Summary Report
  tag_report                - Tag Report
  timeline                  - Timeline Chart
  WebCal                    - Web Calendar
  • 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 Formartvorlage. 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


Gramps-notes.png
Tool names

If the supplied tool_name does not correspond to any available tool, an error message will be printed followed by this list of available tools.

Available names are:
  check                    - Check and Repair Database
  chtype                    - Rename Event Types
  dgenstats                - Dump Gender Statistics
  evname                    - Extract Event Description
  populatesources          - Populate Sources and Citations
  rebuild                  - Rebuild Secondary Indexes
  rebuild_genstats          - Rebuild Gender Statistics
  rebuild_refmap            - Rebuild Reference Maps
  reorder_ids              - Reorder Gramps IDs
  test_for_date_parser_and_displayer - Check Localized Date Displayer and Parser
  testcasegenerator        - Generate Testcases for Persons and Families
  verify                    - Verify the Data

Buchaktionoptionen

Gramps-notes.png
New feature

Added in Gramps 5.1

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
Gramps-notes.png
Book names

If the supplied book_name does not correspond to any available Book, an error message will be printed followed by this list of available Books. eg: Example listing only as the Books will be whatever you have named them.

Available names are:
  Granny Jones
  Grampa John
  Smith Family History

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
Gramps-notes.png
Beachte

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

Konfiguration (config) Option

When all configuration variable(s) are set Gramps will start with these new values.

Die Option gibt es in drei Formen:

Gramps-notes.png
Beachte

Bis auf die Beispiele 1 und 3.2, verwenden all diese Beispiele,behavior.database-path als die zu ändernde Konfigurationsvariable.

1) Alle Konfigurationswerte anzeigen: -s oder --show
Zum Beispiel:

$python gramps.py -show
Gramps config settings from /home/username/.gramps/gramps41/gramps.ini:
behavior.max-age-prob-alive=110
behavior.betawarn=false
behavior.check-for-updates=0
behavior.check-for-update-types=['new']
behavior.avg-generation-gap=20
behavior.database-path='/home/grampsdev/.gramps/grampsdb'
behavior.startup=0
behavior.database-backend='bsddb'
Abb. C.1 Kommandozeilen Beispielausgabe für python gramps.py -s


2) Einen Wert zeigen: --config=behavior.database-path oder-c behavior.database-path
Zum Beispiel:

$python gramps.py --config=behavior.database-path
Current Gramps config setting: behavior.database-path:'/home/username/.gramps/grampsdb'

3) Einen Wert setzen: --config=behavior.database-path:'/media/mydb' oder -c behavior.database-path:'/media/mydb'
Zum Beispiel:

3.1) Einen Wert auf seinen Standard setzen:--config=behavior.database-path:DEFAULT oder -c behavior.database-path:DEFAULT
Zum Beispiel:

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
Zum Beispiel:

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 einem Verzeichnis unter dem ~/.gramps/import/ Verzeichnis.

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

Gnome-important.png
Warnung

Gramps kann diese Umgebungsvariablen berücksichtigen
(Ändere sie nur wenn du weist was du tust.)

GRAMPSHOME

  • 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.

Zum Beispiel GRAMPSHOME=$HOME/familytrees/paternal

LANG

  • LANG - wird von Gramps verwendet, um festzulegen welche Sprachdatei geladen wird.
Gramps-notes.png
MacOSX

Wegen der Art, wie das Starten über Finder arbeitet, sind die Variablen für das Gramps.app Paket in Gramps.app/Contents/MacOS/Gramps hart kodiert. Wenn du sie aus irgendeinem Grund ändern musst, bearbeite diese Datei mit TestEdit; stelle sicher, das du sie wieder als reine Textdatei speicherst. Siehe auch locale einstellen für eine Alternative zur Verwendung von den LANG und LANGUAGE Umgebungsvariablen.

GRAMPSI18N

  • $GRAMPSI18N (for your locale) - LANG setzt voraus, das die Grampsübersetzung global installiert ist. Wenn dies nicht der Fall ist, musst du Gramps angeben, wo es die Übersetzung findet. Eine Grampsübersetzung heist gramps.mo, unter Linux kannst du sie mit dem locate Kommando finden. Zum Beispiel: wenn du Deutsch in dem Verzeichnis /home/me/gramps/mo/de/gramps.mo hast, kannst du Gramps mit folgendem Befehl dorthin verweisen:
GRAMPSI18N=/home/me/gramps/mo LC_ALL=C.UTF-8 LANG="de" python3 gramps

GRAMPSDIR


Zurück Index Nächste


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