Changes
m
→MS Windows
{{man index/de|De:Gramps 6.0 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 6.0 Wiki Handbuch - Anwenderverzeichnis|6.0}}
{{languages/de|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 6.0 Wiki Handbuch - Kommandozeilen Referenz}}
{{#vardefine:chapter|C}}
{{#vardefine:figure|0}}
Dieser Anhang liefert eine Referenz über die Möglichkeiten '''Gramps (für Desktops)''' aus dem Terminal starten.
Für '''Gramps Web''' siehe „Verwalten von Benutzern auf der Kommandozeile“ auf der Seite [https://www.grampsweb.org/install_setup/users/ User System] in der Gramps Web Dokumentation.
== Gramps über die Kommandozeile starten ==
Normalerweise startest du Gramps über die Grafischebenutzerschnittstelle (GUI) auf [[De:Gramps_5.2_Wiki_Handbuch_-_Erste_Schritte#Gramps_starten|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 [[De:Gramps_5.2_Wiki_Handbuch_-_Hauptfenster#Alle_Fehlermeldungen_sehen|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 ===
Die Linux-Plattform ist die einzige ''offiziell'' unterstützte Plattform. (Andere Plattformen werden von der Gemeinschaft unterstützt.) Das liegt daran, dass die Gramps-Entwickler den Quellcode auf dieser Plattform entwickeln, programmieren, verwenden und testen. Die Diagnose und Behebung von Problemen, die auftreten (sei es aufgrund von Upgrades oder anderen Ursachen), erfolgt also mit Linux-Werkzeugen.
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
Wenn du einen "build from source" gemacht hast, navigiere zu dem Ordner, in dem du die Anwendung installiert hast. (Dieser Ordner enthält die Datei <code>Gramps.py</code>.) Gib ein:
python3 Gramps.py
=== MS Windows ===
MS Windows ist eine [[De:Download|von der Gemeinschaft unterstützte]] Plattform. Wenn du die [[All_In_One_Gramps_Software_Bundle_for_Windows|Windows AIO]] GrampsAIO32 oder GrampsAIO64 installierst, wird ein Icon auf dem Desktop und ein Eintrag im Startmenü erstellt. Das Gramps-Installationsverzeichnis wird jedoch nicht zum Systempfad hinzugefügt und um Gramps über CLI auszuführen, müssen wir den Pfad zu diesem Verzeichnis kennen. Um den Installationsordner zu finden, siehe [[All_In_One_Gramps_Software_Bundle_for_Windows#Installation_folder|Abschnitt Installationsordner des AIO-Pakets]].
Um den Pfad stattdessen über ein Verknüpfungssymbol zu finden,
* Rechts klicke auf die <code>GrampsAIO64 {{template:Version windows AIO64}}-Terminal</code> Anwendung oder den entsprechenden Menüeintrag.
* Notiere dir den Speicherort der Datei (das Verzeichnis "Indem sie startet").
* Markiere den kompletten Pfad und kopiere ({{man key press|Strg|c}}) ihn.
Um Gramps von der Kommandozeile auszuführen, musst du ein Konsolenfenster starten:
* Starte im Startmenü cmd.exe.
* Wechsel in das Installationsverzeichnis, das Sie gefunden haben.
* Gib den Pfad ein oder füge ihn ein und setze ihn in Anführungszeichen, wenn Leerzeichen vorhanden sind.
* Drücke {{man key press|Enter}}.
Zum Beispiel kann das sein:
cd "C:\Program Files\GrampsAIO64-{{template:Version windows AIO64}}"
gramps
Du kannst jede der Befehlszeilenoptionen zusammen mit diesem verwenden. Um beispielsweise eine detaillierte Liste aller Stammbaum-Datenbanken in deinem standardmäßigen Stammbaum-Ordner zu erhalten, würdest du <code>-L</code> anhängen
cd "C:\Program Files\GrampsAIO64-{{template:Version windows AIO64}}"
gramps -L
Siehe Beispielverwendung https://github.com/gramps-project/addons-source/pull/121
=== macOS ===
MacOS ist eine [[De:Download|von der Gemeinschaft unterstützte]] Plattform. Wenn du das macOS 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.Der [https://github.com/Homebrew Homebrew-Paketmanager] ermöglicht auch die Installation der Anwendung im üblichen Anwendungsordner.
Um Gramps von der Kommandozeile zu starten, musst du Terminal starten, zu finden in dem Ordner Dienstprogramme des Hauptordners Anwendungen (/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, wie oben vorgeschlagen, 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/Contents/macOS/Gramps -L
Es gibt noch andere Möglichkeiten, Gramps unter macOS 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:
* <code>-E</code> Ignoriere alle PYTHON* Umgebungsvariablen z.B. <code>PYTHONPATH</code> und <code>PYTHONHOME</code>, die gesetzt sein könnten.
* <code>-O</code> Grundoptimierung anschalten. Dies ändert die Dateierweiterung für Kompilierte (Bytecode) Dateien von <code>.pyc</code> in <code>.pyo</code>. Siehe auch PYTHONOPTIMIZE.
Der <code>-O</code> Optimierungsbitschalter hat eine Reihe von Auswirkungen in Gamps:
* Wenn er nicht aktiviert ist, erscheint ein zusätzlicher {{man menu|[[De:Gramps_5.2_Wiki_Handbuch_-_Werkzeuge#Fehlersuche|Debug]]}} Eintrag im {{man menu|[[De:Gramps_5.2_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, [[Debugging_Gramps#Add_debug_statements|debug statements]] können aktiviert sein.
* Wenn er nicht aktiviert ist, sind zusätzliche Funktionen in der [[De:Gramps_5.2_Wiki_Handbuch_-_Zusatzmodulverwaltung|Zusatzmodulverwaltung]] verfügbar.
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|Bedienung]] und [[#Beispiele| Beispiele]]. Die Zusammenfassung unten wird ausgegeben von:
gramps -h
oder
gramps --help
<pre>
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=BENUTZERNAME Datenbank-Benutzername
-P, --password=KENNWORT Datenbankkennwort
-C, --create=STAMMBAUM Stammbaum beim Öffnen neu erstellen wenn er nicht existiert
-i, --import=DATEINAME Datei importieren
-e, --export=DATEINAME Datei exportieren
-r, --remove=STAMMBAUMMUSTER Übereinstimmende Stammbäume entfernen (verwende reguläre Ausdrücke).
-f, --format=FORMAT Stammbaumformat festlegen
-a, --action=AKTION Aktion festlegen
-p, --options=OPTIONEN_ZEICHENKETTE Optionen festlegen
-d, --debug=LOGGER_NAME Fehlerprotokollierung 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 'Abgesicherten Modus'
(Vorübergehend die Standardeinstellungen verwenden)
-D, --default=[APXFE] Setzt die Einstellungen auf die Standardeinstellungen zurück;
A - Erweiterungen werden entfernt
P - Einstellungen auf Standard zurücksetzen
X - Bücher werden gelöscht, Berichte und Werkzeugeinstellungen auf Standard gesetzt
F - Filter werden entfernt
E - Alles wird auf Standard gesetzt oder gelöscht
</pre>
Die Verwendungsnachricht lautet wie folgt:
gramps --usage
<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:
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.
</pre>
=== Listenoptionen ===
Eine Liste bekannter Stammbäume ausgeben:
;Kurz
-l, gibt eine Liste bekannter Stammbäume aus
gramps -l
<pre>
Liste bekannter Stammbäume in deinem Datenbankpfad
/home/<~username>/.gramps/grampsdb/5a46c1c3 mit Name "Beispielstammbaum"
</pre>
{{-}}
;Ausführlich
-L, gibt eine detaillierte Liste bekannter Stammbäume aus
gramps -L
<pre>
Gramps-Stammbäume:
Stammbaum "Beispielstammbaum":
Anzahl der Aufbewahrungsorte: 3
Anzahl der Ereignisse: 3432
Anzahl der Fundstellen: 2854
Anzahl der Markierungen: 2
Anzahl der Medien: 7
Anzahl der Notizen: 19
Anzahl der Orte: 1294
Anzahl der Quellen: 4
Datenbank: SQLite
Datenbankmodulversion: 2.6.0
Datenbankversion: 3.33.0
Familienanzahl: 762
Gesperrt?: False
Letzter Zugriff: 30.12.2017 09:29:37
Ort des Datenbankmoduls: /usr/lib/python3.8/sqlite3/__init__.py
Personenanzahl: 2157
Pfad: /home/<~username>/.gramps/grampsdb/5a46c1c3
Schemaversion: 18.0.0
Stammbaum: Beispielstammbaum
</pre>
{{man note|Beachte, das Daten im vorgegebenen LOCALE Format angezeigt werden.|Du änderst dies auf Systemebene. Zum Beispiel auf [[De:Gramps_Glossar#POSIX|POSIX]] basierenden Systemen kannst du folgendes eingeben:
<pre>LC_TIME=en_AU.UTF-8 gramps -L</pre>}}
{{-}}
=== Versionsoptionen ===
-v oder --version zeigt die Version von Gramps und Abhängigkeiten,
Informationen über Umgebungseinstellungen, Python und Systempfade
gramps -v
<pre>
Gramps Settings:
----------------
python : 3.8.2
gramps : 6.0.3
gtk++ : 3.24.20
pygobject : 3.36.0
pango : 1.44.7
cairo : 1.16.0
pycairo : 1.16.2
osmgpsmap : 1.0
GExiv2 : 0.10
ICU : 66.1
PyICU : 2.4.2
o.s. : linux
kernel : 5.4.0-40-generic
Environment settings:
---------------------
LANG : de_DE.UTF-8
LANGUAGE : de
GRAMPSI18N: not set
GRAMPSHOME: not set
GRAMPSDIR : not set
PYTHONPATH:
/usr/local/lib/python3.8/dist-packages/gramps
/usr/local/bin
/usr/lib/python38.zip
/usr/lib/python3.8
/usr/lib/python3.8/lib-dynload
/usr/local/lib/python3.8/dist-packages
/usr/lib/python3/dist-packages
Non-python dependencies:
------------------------
Graphviz : 2.43
Ghostscr. : 9.50
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.7
db version : 5.3.28
location : /usr/lib/python3/dist-packages/bsddb3/__init__.py
sqlite3 :
version : 3.31.1
py version : 2.6.0
location : /usr/lib/python3.8/sqlite3/__init__.py
</pre>
{{-}}
=== Formatoptionen ===
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 ====
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 3.0 Format: Import und Export
* '''vcs''' - VCalendar 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 : <code>-O Stammbaum</code> oder <code>--open=Stammbaum</code>
<code>-O</code>, Ö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
{{Man tip| Tipp|Wenn der Dateiname ohne Option angegeben wird, ignoriert Gramps den Rest der Kommandozeilenargumente. Verwende die <code>-O</code> Option zum öffnen, <code>-i</code> zum importieren und tue etwas mit den Daten.}}
{{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 |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 <code>-i Dateiname</code> oder <code>--import=Dateiname</code> Parameter angegeben werden. Das Format kann mit dem <code>-f Format</code> oder <code>--format=Format</code> 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
{{man tip | Tipp |In einem Befehl können mehrere Dateien importiert werden. In diesem Fall nimmt Gramps die Daten aus der nächsten Datei in die derzeit verfügbare Datenbank auf.}}
Wenn mehr als eine Eingabedatei angegeben ist, muss vor jeder das Flag <code>-i</code> stehen. Die Dateien werden in der angegebenen Reihenfolge importiert, z. B. <code> -i Datei1 -i Datei2 </code> und <code> -i Datei2 -i Datei1 </code> können unterschiedliche Gramps-IDs in der resultierenden Datenbank erzeugen.
=== Exportoptionen ===
Die für den Export vorgesehenen Dateien können mit dem Parameter <code>-e Dateiname</code> oder <code>--export=Dateinamean</code> gegeben werden. Das Format kann mit dem <code>-f</code> 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 !
{{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 angegeben ist, muss vor jeder das Flag <code>-e</code> stehen. Die Dateien werden einzeln in der angegebenen Reihenfolge geschrieben.
=== Aktionsoptionen ===
Die Aktion, die mit den importierten Daten durchgeführt werden soll, kann über die <code>-a Aktion</code> oder <code>--action=Aktion</code> 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 <code>-p Optionszeichenkette</code> oder <code>--options=Optionszeichenkette</code> Option übergeben.
Die Aktionen aus älteren Gramps Versionen, die in Gramps 3.3 umgezogen sind:
*''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'': 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'''.
==== Berichtaktionoption ====
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="
{{man tip| Berichtsoption Zeichenkette |Die Berichtsoption sollte folgende Bedingungen erfüllen: <br />Sie darf keine Leerzeichenenthalten. Wenn eine Option Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. <br />Eine Option besteht aus dem Optionsnamen und dem Wert. <br />In einer Option müssen der Optionsname und Optionswert durch ein Gleichheitszeichen getrennt werden. <br />Verschiedene Paare müssen durch Komma getrennt werden. Die meisten 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.
*<code>name=Berichtname</code>: Diese benötigte Option bestimmt welcher Bericht erzeugt wird.
{{man note|Berichtsname|Wenn der übergebene Berichtname nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefolgt von einer Liste verfügbarer Berichte ausgegeben.<br/>
<pre>
Verfügbare Namen sind:
ancestor_chart - Ahnenbaum
ancestor_report - Ahnentafelgrafik
AncestorFill - AncestorFill
birthday_report - Geburtstags- und Jahrestage-Bericht
calendar - Kalender
d3-ancestralcollapsibletree - Zusammenklappbarer Stammbaum
d3-ancestralfanchart - Ahnen Fan Chart
d3-descendantindentedtree - Nachkommend eingerückter Baum
database-differences-report - Datenbankunterschiedsbericht
denominoviso - DenominoViso
descend_chart - Nachkommenbaum
descend_report - Nachkommenbericht
DetailedDescendantBook - Detailliertes Nachkommenbuch
double_cousins - Double Cousins
DynamicWeb - Dynamischer Webbericht
DescendantBook - Nachkommen Buch
Descendants Lines - Nachkommen Linien
det_ancestor_report - Ausführlicher Ahnenbericht
det_descendant_report - Ausführlicher Nachkommenbericht
endofline_report - Sackgassen-Liste
family_descend_chart - Familiennachkommenbaum
family_group - Familien-Blockbericht
familylines_graph - Grafik der Familienlinien
FamilySheet - Familienblatt
FamilyTree - Familienstammbaum
fan_chart - Fächergrafik
gt_ancestor - Ahnenbaum
gt_descendant - Nachkomme Baum
gt_grandparent - Großelternbaum
gt_sandclock - Sanduhr Baum
gt_sandclock_family - Sanduhrbaum für eine Familie
Heatmap - Heatmap
hourglass_graph - Stundenglasdiagramm
indiv_complete - PersonAlles Bericht
kinship_report - Verwandtschaftsliste
LastChangeReport - Letzte Änderung Bericht
LinesOfDescendency - Bericht über Abstammungslinien
ListeEclair - Tiny Tafel
MediaReport - Medienbericht
navwebpage - Erzählende Website
networkchart - Netzwerkdiagramm
notelinkreport - Notizverknüppfungenbericht
number_of_ancestors - Anzahl der Vorfahren
PedigreeChart - Stammbaum
PersonEverythingReport - PersonEverything Report
place_report - Ortsliste
records - Rekorde-Liste
rel_graph - Beziehungengrafik
Repositories Report - Aufbewahrungsorte Bericht
SourcesCitationsReport - Sources and Citations Report
statistics_chart - Statistikdiagramme
summary - Datenbankübersichtbericht
tag_report - Tag Report
timeline - Zeitliniengrafik
TimePedigreeHTML - Timeline Pedigree Report
TodoReport - Todo Report
WebCal - Webkalender
</pre>}}
*<code>of</code> : Ausgabe Dateinam und optional Zielordner/-verzeichnis z.B.: <code>of="C:\Users\<username>\Desktop\FamilyTree.odt"</code>
*<code>off</code>: Ausgabeformat. Dies sind die Dateierweiterungen die das Ausgabeformat bestimmen, z.B., pdf, html, doc, ...
*<code>style</code>: für Textberichte, die zu verwendende Formartvorlage. Vorgabe 'default'.
*<code>show=all</code>: Dies erstellt eine Liste der Namen aller verfügbaren Optionen für den angegebenen Bericht.
*<code>show=option_name</code>: 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"
{{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.}}
Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede auf einem <code>-a</code> Parameter folgen. Die Aktionen werden nacheinander in der entsprechenden Reihenfolge durchgeführt.
{{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.}}
Auf der Kommandozeile müssen solche Listen immer mit einer linken eckigen Klammer beginnen <code>[</code> und müssen immer mit einer rechten eckigen Klammer enden <code>]</code> 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 mit jeder Shell, aber (unter Linux / UNIX) kannst du einer solchen eckigen Klammer normalerweise einen umgekehrten Schrägstrich <code>\</code> voranstellen oder Anführungszeichen um die eckige Klammer setzen, normalerweise 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.
Wenn du jedoch ein Komma in deinem Bericht haben möchtest, musst du Gramps irgendwie mitteilen, dass das Komma kein Trennzeichen zwischen den Zeilen ist. Du tust dies, indem du die Zeile mit dem Komma in Anführungszeichen setzen (entweder einfach oder doppelt).
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
{{man note|Werkzeugnamen|Wenn der angegebene Werkzeugname keinem verfügbaren Werkzeug entspricht, wird eine Fehlermeldung ausgegeben, gefolgt von dieser Liste der verfügbaren Werkzeuge.<br />
<pre>
Verfügbare Namen sind:
associationstool - Verbindungsdaten überprüfen
check - Datenbank prüfen und reparieren
chtype - Ereignisarten umbenennen
climerge - Command Line Merge
downloadmedia - Laden Sie Mediendateien aus dem Internet herunter
evname - Ereignisbeschreibung extrahieren
mediaverify - Medien Überprüfen
rebuild - Neuaufbau sekundäre Indexe
rebuild_genstats - Geschlechtsstatistik neu erstellen
rebuild_refmap - Interne Referenzen neu erstellen
reorder_ids - Ordne Gramps-IDs neu
thumbgen - Miniaturbild Generator
verify - Die Daten überprüfen
</pre>}}
==== Buchaktionoption ====
{{man note|Neue Funktion|Hinzugefügt in Gramps 5.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
{{man note|Buchnamen|Wenn der angegebene Buchname keinem verfügbaren Buch entspricht, wird eine Fehlermeldung ausgegeben, gefolgt von dieser Liste der verfügbaren Bücher. Beispiel: Nur eine Beispielauflistung, da die Bücher so heißen, wie du sie benannt hast.<br />
<pre>
Available names are:
Granny Jones
Grampa John
Smith Family History
</pre>}}
=== Entsperren erzwingen Option ===
*<code>-u</code>: du kannst den <code>-O</code> Parameter mit <code>-u</code> 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):
:<code>gramps -O "Stammbaum 1" -a report -u > /dev/null</code>
{{man note|Beachte|Es ist nicht möglich, Stammbäume die eine Reparatur benötigen von der Kommandozeile zu öffnen.}}
Siehe auch::
* [[De:Gramps_5.2_Wiki_Handbuch_-_Stammbäume_Verwalten#Einen_Stammbaum_entsperren|Stammbäume Verwalten:Einen Stammbaum entsperren]]
=== Konfiguration (config) Option ===
Wenn alle Konfigurationsvariable(n) festgelegt sind, beginnt Gramps mit diesen neuen Werten.
Die Option gibt es in drei Formen:
{{man note|Beachte|Bis auf die Beispiele <tt>1</tt> und <tt>3.2</tt>, verwenden all diese Beispiele,<code>behavior.database-path</code> als die zu ändernde Konfigurationsvariable.}}
;1) Alle Konfigurationswerte anzeigen: <code>-s</code> oder <code>--show</code>
<br>Zum Beispiel:
gramps --show
<pre>
Gramps Konfigurationseinstellungen von /home/mirko/.gramps/gramps51/gramps.ini:
export.proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]
database.compress-backup=True
database.backend='bsddb'
database.backup-path='/home/<~Nutzername>'
database.port=''
database.autobackup=0
database.path='/home/<~Nutzername>/.gramps/grampsdb'
database.host=''
database.backup-on-exit=True
geography.lock=False
....
</pre>
{{-}}
;2) Einen einzelnen Konfigurationswert einsehen: <code>--config=database.path</code> oder <code>-c database.path</code>
<br>Zum Beispiel:
gramps --config=database.path
<pre>
Aktuelle Gramps Konfigurationseinstellungen: database.path:'/home/<~Nutzername>/.gramps/grampsdb'
</pre>
;3) Einen Wert setzen: <code>--config=behavior.database-path:'/media/mydb'</code> oder <code>-c behavior.database-path:'/media/mydb'</code>
<br>Zum Beispiel:
;3.1) Einen Wert auf seinen Standard setzen:<code>--config=behavior.database-path:DEFAULT</code> oder <code>-c behavior.database-path:DEFAULT</code>
<br>Zum Beispiel:
;3.2) Mehr als einen Wert setzen:<code>--config=behavior.use-tips:False --config=behavior.autoload:True </code> oder <code>-c behavior.use-tips:False -c behavior.autoload:True</code>
<br>Zum Beispiel:
=== Abgesicherter Modus ===
<code>gramps -S</code> oder <code>gramps --safe</code>
Dieser CLI-Befehl startet Gramps so, als wäre es noch nie zuvor installiert worden. In diesem Modus können alle vorherigen Stammbäume noch geladen werden, solange sie im Standardordner gespeichert wurden. Alle anderen Einstellungen, Filter, Bücher, Addons usw. werden entweder gelöscht oder auf ihre Standardwerte zurückgesetzt. Andere CLI-Befehle können verwendet werden, oder wenn keine vorhanden sind, startet Gramps die GUI. Es werden nur die tatsächlichen Stammbaumdaten gespeichert.
Beachte, dass dies normalerweise verwendet wird, um festzustellen, ob sich Gramps besser verhält wenn es wie bei einer vollständig "sauberen" Installation ausgeführt wird. Es ist NICHT permanent (wenn du dies möchtest, siehe [[#Standardeinstellungen|Standardeinstellungen]] unten). Wenn du Gramps nach Verwendung dieses Befehls normal startest, sind alle deine vorherigen Einstellungen usw. noch vorhanden.
Dies funktioniert tatsächlich, indem der Ordner, in dem Gramps seine Benutzerdaten (mit Ausnahme von Stammbäumen) speichert, auf einem temporäres Verzeichnis festgelegt wird, das beim Schließen von Gramps gelöscht wird.
=== Standardeinstellungen===
<code>gramps -D E</code> oder <code>gramps --default=E</code>
Dieser CLI-Befehl bewirkt, dass Gramps die gewünschten Einstellungen löscht oder zu den Standardeinstellungen zurückkehrt. Die Stammbaumdatenbanken werden NICHT gelöscht oder entfernt. Die Unterbefehle (ersetze das 'E' in der obigen Beispielbefehlszeile durch eines oder mehrere der Unterbefehlszeichen) sind:
*<code>A</code> Erweiterungen werden gelöscht. Alle installierten Erweiterungen werden zusammen mit ihren Einstellungen entfernt.
*<code>F</code> Filter werden gelöscht. Alle benutzerdefinierten Filter werden entfernt.
*<code>P</code> Die Einstellungen werden auf ihre Standardwerte zurückgesetzt.
*<code>X</code> Bücher werden gelöscht, die Einstellungen für Berichte und Tools werden auf ihre Standardwerte zurückgesetzt.
*<code>Z</code> Alte '.zip'-Dateien aus Stammbaum-Versions-Upgrades werden gelöscht.
*<code>E</code> Alles außer den eigentlichen Stammbaumdaten wird auf die Standardeinstellungen zurückgesetzt. Dies führt alle oben genannten sowie einige weitere Elemente aus. löscht Miniaturansichten, Karten und das Benutzer-CSS (in Webberichten verwendet).
Beispielsweise:
gramps -D AP
bewirkt, dass Gramps alle Addons entfernt und die Einstellungen auf ihre Standardwerte zurücksetzt.
== 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 <code>-O</code> Parameter gesetzt ist, versucht Gramps den gelieferten Dateinamen zu öffnen und dann mit den Daten wie in weiteren Parametern angegeben zu arbeiten.
{{man note|1=Notiz |2=Pro Aufruf von Gramps kann nur eine Datei geöffnet werden. Wenn du Daten aus mehreren Quellen benötigst, verwende die Importoptionen über die <code>-i</code> Option.}}
Mit oder ohne den <code>-O</code> Parameter, können mehrere Importe, Exporte und Aktionen in der Kommandozeile weiter spezifiziert werden durch Verwendung der <code>-i</code>, <code>-e</code>, und <code>-a</code> Parameter.
Die Reihenfolge der <code>-i</code> , <code>-e</code> , oder <code>-a</code> Parameter spielt keine Rolle. Die tatsächliche Ausführungsreihenfolge ist immer: alle Importe (wenn vorhanden) -> alle Exporte (wenn vorhanden) -> alle Aktionen (wenn vorhanden).
{{man note| Notiz |Aber öffnen muss immer die Erste sein!}}
Wenn kein <code>-O</code> oder <code>-i</code> 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 <code>-e</code> oder <code>-a</code> 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 ''<code>~/.gramps/import/</code>'' 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:
:<code>gramps -i Datei1.ged -i Datei2.gpkg -i ~/DB3.gramps -i Datei4.wft -a check</code>
*Um die Formate in dem obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit den entsprechenden -f Optionen:
:<code>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</code>
*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):
:<code>gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg</code>
*Um jede Fehlermeldung aus dem obigen Beispiel in die Dateien ausgabedatei und fehlerdatei zu speichern, starte:
:<code>gramps -i Datei1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >ausgabedatei 2>fehlerdatei </code>
*Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis zu starten:
:<code>gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps </code>
*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:
:<code>gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf </code>
{{man tip|1=Zeitlinienberichtoptionen |2=Verwende <code>''name=timeline,show=all''</code> um alle Optionen für den Zeitlinien Bericht zu sehen. Um Einzelheiten einer bestimmten Option zu erhalten verwende <code>''show=Optionsname''</code>, z.B. <code>''name=timeline,show=off''</code>. Um mehr über verfügbare Berichtsnamen zu erfahren, verwende die <code>''name=show''</code> Zeichenfolge.}}
*Um eine grdb spontan in eine .gramps XML-Datei umzuwandeln:
:<code>gramps -O 'Stammbaum 1' -e ausgabe.gramps -f gramps-xml</code>
* Um eine Webseite in einer anderen Sprache (Deutsch) zu erstellen:
<code>LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de </code>
*Zum Abschluss um eine normale Interaktive Sitzung zu starten, tippe:
:<code>gramps </code>
== Umgebungsvariablen==
{{man warn|Warnung|Gramps kann diese [[Gramps_and_Windows#Environmental_Variables|Umgebungsvariablen]] berücksichtigen<br />('''Ändere sie nur wenn du weist was du tust.''')}}
===GRAMPSHOME===
* '''GRAMPSHOME'' - wenn gesetzt, [[Gramps_and_Windows#Setting_the_configuration_path|überschreibt es den Standardpfad]] zum Profil, sodass der Benutzer ein externes Netzlaufwerk zum Speichern von Daten und allen Einstellungen verwenden kann. Für technisch fortgeschrittene Benutzer, die mehrere Versionen von Gramps ausführen, ist das Festlegen eines anderen $GRAMPSHOME eine Möglichkeit, Interferenzen zwischen den verschiedenen Versionen im Gramps-[[De:Gramps_Glossar#Anwenderverzeichnis|Anwenderverzeichnis]] zu vermeiden. Es kann auch verwendet werden, um Gramps so zu konfigurieren, dass es [[Run_Gramps_from_a_portable_drive|von einem tragbaren Laufwerk ausgeführt]] wird, oder um eine [[De:Installation|manuelle Installation]] vorzubereiten. Der Pfad kann auch verwendet werden, um den Pfad zu einem [[Gramps_for_Windows_with_MSYS2#Keep_your_GRAMPSHOME_separate|separaten Testbaum]] oder [[Getting_started_with_Gramps_development|Entwicklungsbaum]] zu konfigurieren.
Zum Beispiel <pre>GRAMPSHOME=$HOME/familytrees/paternal</pre>
===LANG, LANGUAGE, LC_MESSAGES, LC_TIME===
* '''LANG''', '''LANGUAGE''', '''LC_MESSAGES''', und '''LC_TIME''' - werden von Gramps verwendet, um zu bestimmen, welche Sprachdatei(en) geladen werden sollen. Siehe [https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap07.html locale] für eine allgemeine Diskussion von '''LANG''', '''LC_MESSAGES''', und '''LC_TIME'''. Beachte, dass zusätzlich zum Festlegen von Datumsformaten (die in den Einstellungen für Gramps mit Einstellungen überschrieben werden) '''LC_TIME''' legt auch die Sprache fest, die für Wörter in Datumsangaben wie Monats- und Tagesnamen und im Kontext von ''Datumswörtern'' wie ''um'', ''zwischen'' und ''vor'' verwendet wird. '''LANGUAGE''' ist eine durch Kommas getrennte Liste von Sprachcodes (''keine Gebietsschemas'', obwohl bestimmte Sprachen wie pt_BR oder cn_TW regionale Varianten sind), die eine nach Präferenzen geordnete Liste der gewünschten Übersetzungen festlegt. Es überschreibt '''LANG''' aber nicht '''LC_MESSAGES''' oder '''LC_TIME'''.
{{man note|macOS|Aufgrund der Art und Weise, wie das Starten mit dem Finder funktioniert, sind die Umgebungsvariablen für das Gramps.app-Bündel in <code>Gramps.app/Contents/Resources/gramps_launcher.py</code> fest codiert. Wenn du sie aus irgendeinem Grund ändern musst, bearbeite die Datei mit TextEdit; stelle sicher, dass du sie als reinen Text zurückspeicherst. Siehe auch [[Run_GRAMPS_in_another_locale#Change_Mac_OS_X_application_defaults|Locale setzen]] für eine Alternative zur Verwendung der '''LANG''' und '''LANGUAGE''' Umgebungsvariablen.}}
===GRAMPSI18N===
* [[Translating_Gramps#.24GRAMPSI18N_.28for_your_locale.29| $GRAMPSI18N (für dein Gebietsschema) ]] - LANG geht davon aus, dass die Gramps-Übersetzungen global installiert sind. Ist dies nicht der Fall, musst du [[Translating_Gramps#.24GRAMPSI18N_.28for_your_locale.29|Gramps das Verzeichnis angeben]], in dem sich die Übersetzungen befinden. Dies kann verwendet werden, um [[Howto:Change_the_language_of_reports|die Sprache für die generierten Berichte vorübergehend zu ändern]].
Eine Übersetzung heißt <code>gramps.mo</code> und kann unter Linux mit dem locate Kommando gefunden werden. Wenn du beispielsweise Schwedisch im Verzeichnis <code>/home/me/gramps/mo/sv/gramps.mo</code> hast, kannst du Gramps mit folgenden Anweisungen dorthin leiten:
GRAMPSI18N=/home/me/gramps/mo LC_ALL=C.UTF-8 LANG="sv" python3 gramps
===GRAMPSDIR===
* Die Umgebungsvariable GRAMPSDIR ist der Pfad zu deinem [[Translating_Gramps#gramps.sh|Gramps Verzeichnis]].
===GRAMPS_RESOURCES===
* Die Umgebungsvariable GRAMPS_RESOURCES ist der Pfad zu den in Gramps integrierten Ressourcendateien. Du solltest diesen nur ändern, wenn du Gramps aus dem Quellcode oder einer benutzerdefinierten Umgebung verwendest. Ein Indikator, dass du diese Variable setzen musst, ist, wenn du einen der folgenden Fehler erhältst:
** ''Encoding error while parsing resource path/Codierungsfehler beim Parsen des Ressourcenpfads''
** ''Failed to open resource file/Ressourcendatei konnte nicht geöffnet werden''
** ''Resource Path {invalid/path/to/resources} is invalid/Der Ressourcenpfad {ungültig / Pfad / zu / Ressourcen} ist ungültig''
** ''Unable to determine resource path/Ressourcenpfad kann nicht ermittelt werden''
Beispiel [[Linux:Build_from_source#Running_from_a_tarball_release|Anwendungsbeispiel]]:
GRAMPS_RESOURCES=/home/username/gramps/branches/maintenance/gramps52/build/t PYTHONPATH=$GRAMPS_RESOURCES:$PYTHONPATH ./gramps
{{-}}
{{man index/de|De:Gramps 6.0 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 6.0 Wiki Handbuch - Anwenderverzeichnis|6.0}}
{{languages/de|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 6.0 Wiki Handbuch - Kommandozeilen Referenz}}
{{grampsmanualcopyright/de}}
[[Category:De:Dokumentation|K]]
{{languages/de|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 6.0 Wiki Handbuch - Kommandozeilen Referenz}}
{{#vardefine:chapter|C}}
{{#vardefine:figure|0}}
Dieser Anhang liefert eine Referenz über die Möglichkeiten '''Gramps (für Desktops)''' aus dem Terminal starten.
Für '''Gramps Web''' siehe „Verwalten von Benutzern auf der Kommandozeile“ auf der Seite [https://www.grampsweb.org/install_setup/users/ User System] in der Gramps Web Dokumentation.
== Gramps über die Kommandozeile starten ==
Normalerweise startest du Gramps über die Grafischebenutzerschnittstelle (GUI) auf [[De:Gramps_5.2_Wiki_Handbuch_-_Erste_Schritte#Gramps_starten|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 [[De:Gramps_5.2_Wiki_Handbuch_-_Hauptfenster#Alle_Fehlermeldungen_sehen|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 ===
Die Linux-Plattform ist die einzige ''offiziell'' unterstützte Plattform. (Andere Plattformen werden von der Gemeinschaft unterstützt.) Das liegt daran, dass die Gramps-Entwickler den Quellcode auf dieser Plattform entwickeln, programmieren, verwenden und testen. Die Diagnose und Behebung von Problemen, die auftreten (sei es aufgrund von Upgrades oder anderen Ursachen), erfolgt also mit Linux-Werkzeugen.
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
Wenn du einen "build from source" gemacht hast, navigiere zu dem Ordner, in dem du die Anwendung installiert hast. (Dieser Ordner enthält die Datei <code>Gramps.py</code>.) Gib ein:
python3 Gramps.py
=== MS Windows ===
MS Windows ist eine [[De:Download|von der Gemeinschaft unterstützte]] Plattform. Wenn du die [[All_In_One_Gramps_Software_Bundle_for_Windows|Windows AIO]] GrampsAIO32 oder GrampsAIO64 installierst, wird ein Icon auf dem Desktop und ein Eintrag im Startmenü erstellt. Das Gramps-Installationsverzeichnis wird jedoch nicht zum Systempfad hinzugefügt und um Gramps über CLI auszuführen, müssen wir den Pfad zu diesem Verzeichnis kennen. Um den Installationsordner zu finden, siehe [[All_In_One_Gramps_Software_Bundle_for_Windows#Installation_folder|Abschnitt Installationsordner des AIO-Pakets]].
Um den Pfad stattdessen über ein Verknüpfungssymbol zu finden,
* Rechts klicke auf die <code>GrampsAIO64 {{template:Version windows AIO64}}-Terminal</code> Anwendung oder den entsprechenden Menüeintrag.
* Notiere dir den Speicherort der Datei (das Verzeichnis "Indem sie startet").
* Markiere den kompletten Pfad und kopiere ({{man key press|Strg|c}}) ihn.
Um Gramps von der Kommandozeile auszuführen, musst du ein Konsolenfenster starten:
* Starte im Startmenü cmd.exe.
* Wechsel in das Installationsverzeichnis, das Sie gefunden haben.
* Gib den Pfad ein oder füge ihn ein und setze ihn in Anführungszeichen, wenn Leerzeichen vorhanden sind.
* Drücke {{man key press|Enter}}.
Zum Beispiel kann das sein:
cd "C:\Program Files\GrampsAIO64-{{template:Version windows AIO64}}"
gramps
Du kannst jede der Befehlszeilenoptionen zusammen mit diesem verwenden. Um beispielsweise eine detaillierte Liste aller Stammbaum-Datenbanken in deinem standardmäßigen Stammbaum-Ordner zu erhalten, würdest du <code>-L</code> anhängen
cd "C:\Program Files\GrampsAIO64-{{template:Version windows AIO64}}"
gramps -L
Siehe Beispielverwendung https://github.com/gramps-project/addons-source/pull/121
=== macOS ===
MacOS ist eine [[De:Download|von der Gemeinschaft unterstützte]] Plattform. Wenn du das macOS 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.Der [https://github.com/Homebrew Homebrew-Paketmanager] ermöglicht auch die Installation der Anwendung im üblichen Anwendungsordner.
Um Gramps von der Kommandozeile zu starten, musst du Terminal starten, zu finden in dem Ordner Dienstprogramme des Hauptordners Anwendungen (/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, wie oben vorgeschlagen, 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/Contents/macOS/Gramps -L
Es gibt noch andere Möglichkeiten, Gramps unter macOS 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:
* <code>-E</code> Ignoriere alle PYTHON* Umgebungsvariablen z.B. <code>PYTHONPATH</code> und <code>PYTHONHOME</code>, die gesetzt sein könnten.
* <code>-O</code> Grundoptimierung anschalten. Dies ändert die Dateierweiterung für Kompilierte (Bytecode) Dateien von <code>.pyc</code> in <code>.pyo</code>. Siehe auch PYTHONOPTIMIZE.
Der <code>-O</code> Optimierungsbitschalter hat eine Reihe von Auswirkungen in Gamps:
* Wenn er nicht aktiviert ist, erscheint ein zusätzlicher {{man menu|[[De:Gramps_5.2_Wiki_Handbuch_-_Werkzeuge#Fehlersuche|Debug]]}} Eintrag im {{man menu|[[De:Gramps_5.2_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, [[Debugging_Gramps#Add_debug_statements|debug statements]] können aktiviert sein.
* Wenn er nicht aktiviert ist, sind zusätzliche Funktionen in der [[De:Gramps_5.2_Wiki_Handbuch_-_Zusatzmodulverwaltung|Zusatzmodulverwaltung]] verfügbar.
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|Bedienung]] und [[#Beispiele| Beispiele]]. Die Zusammenfassung unten wird ausgegeben von:
gramps -h
oder
gramps --help
<pre>
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=BENUTZERNAME Datenbank-Benutzername
-P, --password=KENNWORT Datenbankkennwort
-C, --create=STAMMBAUM Stammbaum beim Öffnen neu erstellen wenn er nicht existiert
-i, --import=DATEINAME Datei importieren
-e, --export=DATEINAME Datei exportieren
-r, --remove=STAMMBAUMMUSTER Übereinstimmende Stammbäume entfernen (verwende reguläre Ausdrücke).
-f, --format=FORMAT Stammbaumformat festlegen
-a, --action=AKTION Aktion festlegen
-p, --options=OPTIONEN_ZEICHENKETTE Optionen festlegen
-d, --debug=LOGGER_NAME Fehlerprotokollierung 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 'Abgesicherten Modus'
(Vorübergehend die Standardeinstellungen verwenden)
-D, --default=[APXFE] Setzt die Einstellungen auf die Standardeinstellungen zurück;
A - Erweiterungen werden entfernt
P - Einstellungen auf Standard zurücksetzen
X - Bücher werden gelöscht, Berichte und Werkzeugeinstellungen auf Standard gesetzt
F - Filter werden entfernt
E - Alles wird auf Standard gesetzt oder gelöscht
</pre>
Die Verwendungsnachricht lautet wie folgt:
gramps --usage
<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:
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.
</pre>
=== Listenoptionen ===
Eine Liste bekannter Stammbäume ausgeben:
;Kurz
-l, gibt eine Liste bekannter Stammbäume aus
gramps -l
<pre>
Liste bekannter Stammbäume in deinem Datenbankpfad
/home/<~username>/.gramps/grampsdb/5a46c1c3 mit Name "Beispielstammbaum"
</pre>
{{-}}
;Ausführlich
-L, gibt eine detaillierte Liste bekannter Stammbäume aus
gramps -L
<pre>
Gramps-Stammbäume:
Stammbaum "Beispielstammbaum":
Anzahl der Aufbewahrungsorte: 3
Anzahl der Ereignisse: 3432
Anzahl der Fundstellen: 2854
Anzahl der Markierungen: 2
Anzahl der Medien: 7
Anzahl der Notizen: 19
Anzahl der Orte: 1294
Anzahl der Quellen: 4
Datenbank: SQLite
Datenbankmodulversion: 2.6.0
Datenbankversion: 3.33.0
Familienanzahl: 762
Gesperrt?: False
Letzter Zugriff: 30.12.2017 09:29:37
Ort des Datenbankmoduls: /usr/lib/python3.8/sqlite3/__init__.py
Personenanzahl: 2157
Pfad: /home/<~username>/.gramps/grampsdb/5a46c1c3
Schemaversion: 18.0.0
Stammbaum: Beispielstammbaum
</pre>
{{man note|Beachte, das Daten im vorgegebenen LOCALE Format angezeigt werden.|Du änderst dies auf Systemebene. Zum Beispiel auf [[De:Gramps_Glossar#POSIX|POSIX]] basierenden Systemen kannst du folgendes eingeben:
<pre>LC_TIME=en_AU.UTF-8 gramps -L</pre>}}
{{-}}
=== Versionsoptionen ===
-v oder --version zeigt die Version von Gramps und Abhängigkeiten,
Informationen über Umgebungseinstellungen, Python und Systempfade
gramps -v
<pre>
Gramps Settings:
----------------
python : 3.8.2
gramps : 6.0.3
gtk++ : 3.24.20
pygobject : 3.36.0
pango : 1.44.7
cairo : 1.16.0
pycairo : 1.16.2
osmgpsmap : 1.0
GExiv2 : 0.10
ICU : 66.1
PyICU : 2.4.2
o.s. : linux
kernel : 5.4.0-40-generic
Environment settings:
---------------------
LANG : de_DE.UTF-8
LANGUAGE : de
GRAMPSI18N: not set
GRAMPSHOME: not set
GRAMPSDIR : not set
PYTHONPATH:
/usr/local/lib/python3.8/dist-packages/gramps
/usr/local/bin
/usr/lib/python38.zip
/usr/lib/python3.8
/usr/lib/python3.8/lib-dynload
/usr/local/lib/python3.8/dist-packages
/usr/lib/python3/dist-packages
Non-python dependencies:
------------------------
Graphviz : 2.43
Ghostscr. : 9.50
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.7
db version : 5.3.28
location : /usr/lib/python3/dist-packages/bsddb3/__init__.py
sqlite3 :
version : 3.31.1
py version : 2.6.0
location : /usr/lib/python3.8/sqlite3/__init__.py
</pre>
{{-}}
=== Formatoptionen ===
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 ====
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 3.0 Format: Import und Export
* '''vcs''' - VCalendar 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 : <code>-O Stammbaum</code> oder <code>--open=Stammbaum</code>
<code>-O</code>, Ö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
{{Man tip| Tipp|Wenn der Dateiname ohne Option angegeben wird, ignoriert Gramps den Rest der Kommandozeilenargumente. Verwende die <code>-O</code> Option zum öffnen, <code>-i</code> zum importieren und tue etwas mit den Daten.}}
{{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 |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 <code>-i Dateiname</code> oder <code>--import=Dateiname</code> Parameter angegeben werden. Das Format kann mit dem <code>-f Format</code> oder <code>--format=Format</code> 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
{{man tip | Tipp |In einem Befehl können mehrere Dateien importiert werden. In diesem Fall nimmt Gramps die Daten aus der nächsten Datei in die derzeit verfügbare Datenbank auf.}}
Wenn mehr als eine Eingabedatei angegeben ist, muss vor jeder das Flag <code>-i</code> stehen. Die Dateien werden in der angegebenen Reihenfolge importiert, z. B. <code> -i Datei1 -i Datei2 </code> und <code> -i Datei2 -i Datei1 </code> können unterschiedliche Gramps-IDs in der resultierenden Datenbank erzeugen.
=== Exportoptionen ===
Die für den Export vorgesehenen Dateien können mit dem Parameter <code>-e Dateiname</code> oder <code>--export=Dateinamean</code> gegeben werden. Das Format kann mit dem <code>-f</code> 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 !
{{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 angegeben ist, muss vor jeder das Flag <code>-e</code> stehen. Die Dateien werden einzeln in der angegebenen Reihenfolge geschrieben.
=== Aktionsoptionen ===
Die Aktion, die mit den importierten Daten durchgeführt werden soll, kann über die <code>-a Aktion</code> oder <code>--action=Aktion</code> 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 <code>-p Optionszeichenkette</code> oder <code>--options=Optionszeichenkette</code> Option übergeben.
Die Aktionen aus älteren Gramps Versionen, die in Gramps 3.3 umgezogen sind:
*''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'': 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'''.
==== Berichtaktionoption ====
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="
{{man tip| Berichtsoption Zeichenkette |Die Berichtsoption sollte folgende Bedingungen erfüllen: <br />Sie darf keine Leerzeichenenthalten. Wenn eine Option Leerzeichen enthält, sollte sie in Anführungszeichen eingeschlossen werden. <br />Eine Option besteht aus dem Optionsnamen und dem Wert. <br />In einer Option müssen der Optionsname und Optionswert durch ein Gleichheitszeichen getrennt werden. <br />Verschiedene Paare müssen durch Komma getrennt werden. Die meisten 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.
*<code>name=Berichtname</code>: Diese benötigte Option bestimmt welcher Bericht erzeugt wird.
{{man note|Berichtsname|Wenn der übergebene Berichtname nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefolgt von einer Liste verfügbarer Berichte ausgegeben.<br/>
<pre>
Verfügbare Namen sind:
ancestor_chart - Ahnenbaum
ancestor_report - Ahnentafelgrafik
AncestorFill - AncestorFill
birthday_report - Geburtstags- und Jahrestage-Bericht
calendar - Kalender
d3-ancestralcollapsibletree - Zusammenklappbarer Stammbaum
d3-ancestralfanchart - Ahnen Fan Chart
d3-descendantindentedtree - Nachkommend eingerückter Baum
database-differences-report - Datenbankunterschiedsbericht
denominoviso - DenominoViso
descend_chart - Nachkommenbaum
descend_report - Nachkommenbericht
DetailedDescendantBook - Detailliertes Nachkommenbuch
double_cousins - Double Cousins
DynamicWeb - Dynamischer Webbericht
DescendantBook - Nachkommen Buch
Descendants Lines - Nachkommen Linien
det_ancestor_report - Ausführlicher Ahnenbericht
det_descendant_report - Ausführlicher Nachkommenbericht
endofline_report - Sackgassen-Liste
family_descend_chart - Familiennachkommenbaum
family_group - Familien-Blockbericht
familylines_graph - Grafik der Familienlinien
FamilySheet - Familienblatt
FamilyTree - Familienstammbaum
fan_chart - Fächergrafik
gt_ancestor - Ahnenbaum
gt_descendant - Nachkomme Baum
gt_grandparent - Großelternbaum
gt_sandclock - Sanduhr Baum
gt_sandclock_family - Sanduhrbaum für eine Familie
Heatmap - Heatmap
hourglass_graph - Stundenglasdiagramm
indiv_complete - PersonAlles Bericht
kinship_report - Verwandtschaftsliste
LastChangeReport - Letzte Änderung Bericht
LinesOfDescendency - Bericht über Abstammungslinien
ListeEclair - Tiny Tafel
MediaReport - Medienbericht
navwebpage - Erzählende Website
networkchart - Netzwerkdiagramm
notelinkreport - Notizverknüppfungenbericht
number_of_ancestors - Anzahl der Vorfahren
PedigreeChart - Stammbaum
PersonEverythingReport - PersonEverything Report
place_report - Ortsliste
records - Rekorde-Liste
rel_graph - Beziehungengrafik
Repositories Report - Aufbewahrungsorte Bericht
SourcesCitationsReport - Sources and Citations Report
statistics_chart - Statistikdiagramme
summary - Datenbankübersichtbericht
tag_report - Tag Report
timeline - Zeitliniengrafik
TimePedigreeHTML - Timeline Pedigree Report
TodoReport - Todo Report
WebCal - Webkalender
</pre>}}
*<code>of</code> : Ausgabe Dateinam und optional Zielordner/-verzeichnis z.B.: <code>of="C:\Users\<username>\Desktop\FamilyTree.odt"</code>
*<code>off</code>: Ausgabeformat. Dies sind die Dateierweiterungen die das Ausgabeformat bestimmen, z.B., pdf, html, doc, ...
*<code>style</code>: für Textberichte, die zu verwendende Formartvorlage. Vorgabe 'default'.
*<code>show=all</code>: Dies erstellt eine Liste der Namen aller verfügbaren Optionen für den angegebenen Bericht.
*<code>show=option_name</code>: 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"
{{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.}}
Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede auf einem <code>-a</code> Parameter folgen. Die Aktionen werden nacheinander in der entsprechenden Reihenfolge durchgeführt.
{{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.}}
Auf der Kommandozeile müssen solche Listen immer mit einer linken eckigen Klammer beginnen <code>[</code> und müssen immer mit einer rechten eckigen Klammer enden <code>]</code> 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 mit jeder Shell, aber (unter Linux / UNIX) kannst du einer solchen eckigen Klammer normalerweise einen umgekehrten Schrägstrich <code>\</code> voranstellen oder Anführungszeichen um die eckige Klammer setzen, normalerweise 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.
Wenn du jedoch ein Komma in deinem Bericht haben möchtest, musst du Gramps irgendwie mitteilen, dass das Komma kein Trennzeichen zwischen den Zeilen ist. Du tust dies, indem du die Zeile mit dem Komma in Anführungszeichen setzen (entweder einfach oder doppelt).
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
{{man note|Werkzeugnamen|Wenn der angegebene Werkzeugname keinem verfügbaren Werkzeug entspricht, wird eine Fehlermeldung ausgegeben, gefolgt von dieser Liste der verfügbaren Werkzeuge.<br />
<pre>
Verfügbare Namen sind:
associationstool - Verbindungsdaten überprüfen
check - Datenbank prüfen und reparieren
chtype - Ereignisarten umbenennen
climerge - Command Line Merge
downloadmedia - Laden Sie Mediendateien aus dem Internet herunter
evname - Ereignisbeschreibung extrahieren
mediaverify - Medien Überprüfen
rebuild - Neuaufbau sekundäre Indexe
rebuild_genstats - Geschlechtsstatistik neu erstellen
rebuild_refmap - Interne Referenzen neu erstellen
reorder_ids - Ordne Gramps-IDs neu
thumbgen - Miniaturbild Generator
verify - Die Daten überprüfen
</pre>}}
==== Buchaktionoption ====
{{man note|Neue Funktion|Hinzugefügt in Gramps 5.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
{{man note|Buchnamen|Wenn der angegebene Buchname keinem verfügbaren Buch entspricht, wird eine Fehlermeldung ausgegeben, gefolgt von dieser Liste der verfügbaren Bücher. Beispiel: Nur eine Beispielauflistung, da die Bücher so heißen, wie du sie benannt hast.<br />
<pre>
Available names are:
Granny Jones
Grampa John
Smith Family History
</pre>}}
=== Entsperren erzwingen Option ===
*<code>-u</code>: du kannst den <code>-O</code> Parameter mit <code>-u</code> 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):
:<code>gramps -O "Stammbaum 1" -a report -u > /dev/null</code>
{{man note|Beachte|Es ist nicht möglich, Stammbäume die eine Reparatur benötigen von der Kommandozeile zu öffnen.}}
Siehe auch::
* [[De:Gramps_5.2_Wiki_Handbuch_-_Stammbäume_Verwalten#Einen_Stammbaum_entsperren|Stammbäume Verwalten:Einen Stammbaum entsperren]]
=== Konfiguration (config) Option ===
Wenn alle Konfigurationsvariable(n) festgelegt sind, beginnt Gramps mit diesen neuen Werten.
Die Option gibt es in drei Formen:
{{man note|Beachte|Bis auf die Beispiele <tt>1</tt> und <tt>3.2</tt>, verwenden all diese Beispiele,<code>behavior.database-path</code> als die zu ändernde Konfigurationsvariable.}}
;1) Alle Konfigurationswerte anzeigen: <code>-s</code> oder <code>--show</code>
<br>Zum Beispiel:
gramps --show
<pre>
Gramps Konfigurationseinstellungen von /home/mirko/.gramps/gramps51/gramps.ini:
export.proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]
database.compress-backup=True
database.backend='bsddb'
database.backup-path='/home/<~Nutzername>'
database.port=''
database.autobackup=0
database.path='/home/<~Nutzername>/.gramps/grampsdb'
database.host=''
database.backup-on-exit=True
geography.lock=False
....
</pre>
{{-}}
;2) Einen einzelnen Konfigurationswert einsehen: <code>--config=database.path</code> oder <code>-c database.path</code>
<br>Zum Beispiel:
gramps --config=database.path
<pre>
Aktuelle Gramps Konfigurationseinstellungen: database.path:'/home/<~Nutzername>/.gramps/grampsdb'
</pre>
;3) Einen Wert setzen: <code>--config=behavior.database-path:'/media/mydb'</code> oder <code>-c behavior.database-path:'/media/mydb'</code>
<br>Zum Beispiel:
;3.1) Einen Wert auf seinen Standard setzen:<code>--config=behavior.database-path:DEFAULT</code> oder <code>-c behavior.database-path:DEFAULT</code>
<br>Zum Beispiel:
;3.2) Mehr als einen Wert setzen:<code>--config=behavior.use-tips:False --config=behavior.autoload:True </code> oder <code>-c behavior.use-tips:False -c behavior.autoload:True</code>
<br>Zum Beispiel:
=== Abgesicherter Modus ===
<code>gramps -S</code> oder <code>gramps --safe</code>
Dieser CLI-Befehl startet Gramps so, als wäre es noch nie zuvor installiert worden. In diesem Modus können alle vorherigen Stammbäume noch geladen werden, solange sie im Standardordner gespeichert wurden. Alle anderen Einstellungen, Filter, Bücher, Addons usw. werden entweder gelöscht oder auf ihre Standardwerte zurückgesetzt. Andere CLI-Befehle können verwendet werden, oder wenn keine vorhanden sind, startet Gramps die GUI. Es werden nur die tatsächlichen Stammbaumdaten gespeichert.
Beachte, dass dies normalerweise verwendet wird, um festzustellen, ob sich Gramps besser verhält wenn es wie bei einer vollständig "sauberen" Installation ausgeführt wird. Es ist NICHT permanent (wenn du dies möchtest, siehe [[#Standardeinstellungen|Standardeinstellungen]] unten). Wenn du Gramps nach Verwendung dieses Befehls normal startest, sind alle deine vorherigen Einstellungen usw. noch vorhanden.
Dies funktioniert tatsächlich, indem der Ordner, in dem Gramps seine Benutzerdaten (mit Ausnahme von Stammbäumen) speichert, auf einem temporäres Verzeichnis festgelegt wird, das beim Schließen von Gramps gelöscht wird.
=== Standardeinstellungen===
<code>gramps -D E</code> oder <code>gramps --default=E</code>
Dieser CLI-Befehl bewirkt, dass Gramps die gewünschten Einstellungen löscht oder zu den Standardeinstellungen zurückkehrt. Die Stammbaumdatenbanken werden NICHT gelöscht oder entfernt. Die Unterbefehle (ersetze das 'E' in der obigen Beispielbefehlszeile durch eines oder mehrere der Unterbefehlszeichen) sind:
*<code>A</code> Erweiterungen werden gelöscht. Alle installierten Erweiterungen werden zusammen mit ihren Einstellungen entfernt.
*<code>F</code> Filter werden gelöscht. Alle benutzerdefinierten Filter werden entfernt.
*<code>P</code> Die Einstellungen werden auf ihre Standardwerte zurückgesetzt.
*<code>X</code> Bücher werden gelöscht, die Einstellungen für Berichte und Tools werden auf ihre Standardwerte zurückgesetzt.
*<code>Z</code> Alte '.zip'-Dateien aus Stammbaum-Versions-Upgrades werden gelöscht.
*<code>E</code> Alles außer den eigentlichen Stammbaumdaten wird auf die Standardeinstellungen zurückgesetzt. Dies führt alle oben genannten sowie einige weitere Elemente aus. löscht Miniaturansichten, Karten und das Benutzer-CSS (in Webberichten verwendet).
Beispielsweise:
gramps -D AP
bewirkt, dass Gramps alle Addons entfernt und die Einstellungen auf ihre Standardwerte zurücksetzt.
== 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 <code>-O</code> Parameter gesetzt ist, versucht Gramps den gelieferten Dateinamen zu öffnen und dann mit den Daten wie in weiteren Parametern angegeben zu arbeiten.
{{man note|1=Notiz |2=Pro Aufruf von Gramps kann nur eine Datei geöffnet werden. Wenn du Daten aus mehreren Quellen benötigst, verwende die Importoptionen über die <code>-i</code> Option.}}
Mit oder ohne den <code>-O</code> Parameter, können mehrere Importe, Exporte und Aktionen in der Kommandozeile weiter spezifiziert werden durch Verwendung der <code>-i</code>, <code>-e</code>, und <code>-a</code> Parameter.
Die Reihenfolge der <code>-i</code> , <code>-e</code> , oder <code>-a</code> Parameter spielt keine Rolle. Die tatsächliche Ausführungsreihenfolge ist immer: alle Importe (wenn vorhanden) -> alle Exporte (wenn vorhanden) -> alle Aktionen (wenn vorhanden).
{{man note| Notiz |Aber öffnen muss immer die Erste sein!}}
Wenn kein <code>-O</code> oder <code>-i</code> 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 <code>-e</code> oder <code>-a</code> 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 ''<code>~/.gramps/import/</code>'' 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:
:<code>gramps -i Datei1.ged -i Datei2.gpkg -i ~/DB3.gramps -i Datei4.wft -a check</code>
*Um die Formate in dem obigen Beispiel explizit anzugeben, erweitere die Dateinamen mit den entsprechenden -f Optionen:
:<code>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</code>
*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):
:<code>gramps -i Datei1.ged -i Datei2.gpkg -e ~/new-package -f gramps-pkg</code>
*Um jede Fehlermeldung aus dem obigen Beispiel in die Dateien ausgabedatei und fehlerdatei zu speichern, starte:
:<code>gramps -i Datei1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >ausgabedatei 2>fehlerdatei </code>
*Um drei Datenbanken zu importieren und eine interaktive Gramps Sitzung mit dem Ergebnis zu starten:
:<code>gramps -i Datei1.ged -i Datei2.gpkg -i ~/db3.gramps </code>
*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:
:<code>gramps -O 'Stammbaum 1' -a report -p name=timeline,off=pdf,of=meine_zeitlinie.pdf </code>
{{man tip|1=Zeitlinienberichtoptionen |2=Verwende <code>''name=timeline,show=all''</code> um alle Optionen für den Zeitlinien Bericht zu sehen. Um Einzelheiten einer bestimmten Option zu erhalten verwende <code>''show=Optionsname''</code>, z.B. <code>''name=timeline,show=off''</code>. Um mehr über verfügbare Berichtsnamen zu erfahren, verwende die <code>''name=show''</code> Zeichenfolge.}}
*Um eine grdb spontan in eine .gramps XML-Datei umzuwandeln:
:<code>gramps -O 'Stammbaum 1' -e ausgabe.gramps -f gramps-xml</code>
* Um eine Webseite in einer anderen Sprache (Deutsch) zu erstellen:
<code>LANGUAGE=de_DE; LANG=de_DE.UTF-8 gramps -O 'Stammbaum 1' -a report -p name=navwebpage,target=/../de </code>
*Zum Abschluss um eine normale Interaktive Sitzung zu starten, tippe:
:<code>gramps </code>
== Umgebungsvariablen==
{{man warn|Warnung|Gramps kann diese [[Gramps_and_Windows#Environmental_Variables|Umgebungsvariablen]] berücksichtigen<br />('''Ändere sie nur wenn du weist was du tust.''')}}
===GRAMPSHOME===
* '''GRAMPSHOME'' - wenn gesetzt, [[Gramps_and_Windows#Setting_the_configuration_path|überschreibt es den Standardpfad]] zum Profil, sodass der Benutzer ein externes Netzlaufwerk zum Speichern von Daten und allen Einstellungen verwenden kann. Für technisch fortgeschrittene Benutzer, die mehrere Versionen von Gramps ausführen, ist das Festlegen eines anderen $GRAMPSHOME eine Möglichkeit, Interferenzen zwischen den verschiedenen Versionen im Gramps-[[De:Gramps_Glossar#Anwenderverzeichnis|Anwenderverzeichnis]] zu vermeiden. Es kann auch verwendet werden, um Gramps so zu konfigurieren, dass es [[Run_Gramps_from_a_portable_drive|von einem tragbaren Laufwerk ausgeführt]] wird, oder um eine [[De:Installation|manuelle Installation]] vorzubereiten. Der Pfad kann auch verwendet werden, um den Pfad zu einem [[Gramps_for_Windows_with_MSYS2#Keep_your_GRAMPSHOME_separate|separaten Testbaum]] oder [[Getting_started_with_Gramps_development|Entwicklungsbaum]] zu konfigurieren.
Zum Beispiel <pre>GRAMPSHOME=$HOME/familytrees/paternal</pre>
===LANG, LANGUAGE, LC_MESSAGES, LC_TIME===
* '''LANG''', '''LANGUAGE''', '''LC_MESSAGES''', und '''LC_TIME''' - werden von Gramps verwendet, um zu bestimmen, welche Sprachdatei(en) geladen werden sollen. Siehe [https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap07.html locale] für eine allgemeine Diskussion von '''LANG''', '''LC_MESSAGES''', und '''LC_TIME'''. Beachte, dass zusätzlich zum Festlegen von Datumsformaten (die in den Einstellungen für Gramps mit Einstellungen überschrieben werden) '''LC_TIME''' legt auch die Sprache fest, die für Wörter in Datumsangaben wie Monats- und Tagesnamen und im Kontext von ''Datumswörtern'' wie ''um'', ''zwischen'' und ''vor'' verwendet wird. '''LANGUAGE''' ist eine durch Kommas getrennte Liste von Sprachcodes (''keine Gebietsschemas'', obwohl bestimmte Sprachen wie pt_BR oder cn_TW regionale Varianten sind), die eine nach Präferenzen geordnete Liste der gewünschten Übersetzungen festlegt. Es überschreibt '''LANG''' aber nicht '''LC_MESSAGES''' oder '''LC_TIME'''.
{{man note|macOS|Aufgrund der Art und Weise, wie das Starten mit dem Finder funktioniert, sind die Umgebungsvariablen für das Gramps.app-Bündel in <code>Gramps.app/Contents/Resources/gramps_launcher.py</code> fest codiert. Wenn du sie aus irgendeinem Grund ändern musst, bearbeite die Datei mit TextEdit; stelle sicher, dass du sie als reinen Text zurückspeicherst. Siehe auch [[Run_GRAMPS_in_another_locale#Change_Mac_OS_X_application_defaults|Locale setzen]] für eine Alternative zur Verwendung der '''LANG''' und '''LANGUAGE''' Umgebungsvariablen.}}
===GRAMPSI18N===
* [[Translating_Gramps#.24GRAMPSI18N_.28for_your_locale.29| $GRAMPSI18N (für dein Gebietsschema) ]] - LANG geht davon aus, dass die Gramps-Übersetzungen global installiert sind. Ist dies nicht der Fall, musst du [[Translating_Gramps#.24GRAMPSI18N_.28for_your_locale.29|Gramps das Verzeichnis angeben]], in dem sich die Übersetzungen befinden. Dies kann verwendet werden, um [[Howto:Change_the_language_of_reports|die Sprache für die generierten Berichte vorübergehend zu ändern]].
Eine Übersetzung heißt <code>gramps.mo</code> und kann unter Linux mit dem locate Kommando gefunden werden. Wenn du beispielsweise Schwedisch im Verzeichnis <code>/home/me/gramps/mo/sv/gramps.mo</code> hast, kannst du Gramps mit folgenden Anweisungen dorthin leiten:
GRAMPSI18N=/home/me/gramps/mo LC_ALL=C.UTF-8 LANG="sv" python3 gramps
===GRAMPSDIR===
* Die Umgebungsvariable GRAMPSDIR ist der Pfad zu deinem [[Translating_Gramps#gramps.sh|Gramps Verzeichnis]].
===GRAMPS_RESOURCES===
* Die Umgebungsvariable GRAMPS_RESOURCES ist der Pfad zu den in Gramps integrierten Ressourcendateien. Du solltest diesen nur ändern, wenn du Gramps aus dem Quellcode oder einer benutzerdefinierten Umgebung verwendest. Ein Indikator, dass du diese Variable setzen musst, ist, wenn du einen der folgenden Fehler erhältst:
** ''Encoding error while parsing resource path/Codierungsfehler beim Parsen des Ressourcenpfads''
** ''Failed to open resource file/Ressourcendatei konnte nicht geöffnet werden''
** ''Resource Path {invalid/path/to/resources} is invalid/Der Ressourcenpfad {ungültig / Pfad / zu / Ressourcen} ist ungültig''
** ''Unable to determine resource path/Ressourcenpfad kann nicht ermittelt werden''
Beispiel [[Linux:Build_from_source#Running_from_a_tarball_release|Anwendungsbeispiel]]:
GRAMPS_RESOURCES=/home/username/gramps/branches/maintenance/gramps52/build/t PYTHONPATH=$GRAMPS_RESOURCES:$PYTHONPATH ./gramps
{{-}}
{{man index/de|De:Gramps 6.0 Wiki Handbuch - Tastenkürzel Referenz|De:Gramps 6.0 Wiki Handbuch - Anwenderverzeichnis|6.0}}
{{languages/de|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 6.0 Wiki Handbuch - Kommandozeilen Referenz}}
{{grampsmanualcopyright/de}}
[[Category:De:Dokumentation|K]]