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

From Gramps
Jump to: navigation, search
m
 
m (1 revision)
(No difference)

Revision as of 07:11, 14 January 2010

Dieser Anhang liefert eine Referent über die Möglichkeiten, wenn Sie GRAMPS aus dem Terminal starten.

Gramps-notes.png
Note

GRAMPS wurde als ein interaktives Programm entworfen. Deshalb benutzt es eine grafische Ansicht und kann nicht von eine echten nicht-grafischen Konsole gestartet werden. Es würde einen enormen Aufwand darstellen eine Ausführung in einem Nur-Text Terminal zu ermöglichen. Aus diesem Grund zielen die möglichen Befehlszeilenparameter nicht darauf ab, komplett auf die grafisch Anzeige zu verzichten. Eher machen sie einige typische Aufgaben angenehmer. Sie erlauben Ihnen auch diese Aufgaben aus Skripten heraus auszuführen. Jedenfalls muss die grafische Anzeige immer verfügbar sein!

Tango-Dialog-information.png
Tip

Zusammengefasst bietet die Benutzung der Befehlszeilenparameter nicht-interaktives Verhalten, aber beseitigt nicht die Abhängigkeit von der grafischen Anzeige. Mach, was du willst!



Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions


Zurück Index Nächste



Available options

Dieser Abschnitt bietet eine Liste aller in GRAMPS verfügbaren Befehlszeilen Parameter. Wenn Sie mehr wissen wollen als nur eine Liste von Parametern, schauen Sie in die nächsten Abaschnitte: Operation and Examples.

Format options

The format of any file destined for opening, importing, or exporting can be specified with the

-f format

option. The acceptable format values are listed below.

  • grdb GRAMPS database: GRAMPS Datenbank. Dieses Format ist für Öffnen, den Import und den Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .grdb endet.
  • gramps-xml GRAMPS XML database: GRAMPS XML Datenbank. Dieses Format ist für Öffnen, den Import und den Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .gramp endet.
  • gedcom GEDCOM file: GEDCOM-Datei. Dieses Format ist für den Import und den Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .ged endet.
  • gramps-pkg GRAMPS package: GRAMPS-Paket. Dieses Format ist für den Import und Export verfügbar. Falls nicht angegeben wird es gesetzt, wenn der Dateiname mit .gpkg endet.
  • geneweb GeneWeb file: 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.
  • wft Web Family Tree: 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.
  • iso CD image: CD-Image. Dieses Format ist nur für den Export verfügbar. Es muss immer ausdrücklich angegeben werden.

Opening options

Es gibt zwei Möglichkeiten GRAMPS den Namen der zu öffnenden Datei mitzuteilen:

  • supply bare file name
  • use this option :
    -O filename
    or
    --open=filename 

-O, Open of a family tree. This can be done also by just typing the name (name or database dir)

Examples:

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


Tango-Dialog-information.png
Beispiel Ratschlag

Wenn der Dateiname ohne Option angegeben wird, versucht GRAMPS die Datei zu öffnen und anschliessend eine interaktive Arbeitssitzung gestartet.


Das Format kann festgelegt werden mit dem

-f format

oder

--format=format

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

Tango-Dialog-information.png
Beispiel Ratschlag

Nur grdb, gramps-xml, und gedcom Formate können direkt geöffnet werden. Für andere Formate benötigen Sie die Importoption, welche die leere Datenbank einrichtet und dann die Daten in sie importiert.


Tango-Dialog-information.png
Beispiel Ratschlag

Es kann nur eine Datei geöffnet werden. Wenn Sie Daten aus verschiedenen Quellen kombinieren müssen, benötigen Sie die Importoption.


Import options

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

-i filename

oder

--import=Dateiname

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

Example:

  python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
  python gramps.py -i test.grdb -i data.gramps
Tango-Dialog-information.png
Beispiel Ratschlag

More than one file can be imported in one command. If this is the case, GRAMPS will incorporate the data from the next file into the database available at the moment.


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önnte verschiedene GRAMPS-ID's in der resultierenden Datenbank entstehen..

Export options

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, der sofort auf dem Dateinamen folgt. Falls er 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 grdb, gramps-xml, gedcom, wft und gramps-pkg ist der Dateiname der Name der resultierenden Datei.

-e, export a family tree in required format. It is not possible to export to a family tree.

Example:

 python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -e mergdeDB.gramps

Note that above does not change 'Family Tree 1' as everything happens via a temporary database, whereas:

 python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -e mergdeDB.gramps

will import test.grdb into Family Tree 1, and then export to a file !

Tango-Dialog-information.png
Exporting more files

More than one file can be exported in one command. If this is the case, GRAMPS will attempt to write several files using the data from the database available at the moment.


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

Action options

The action to perform on the imported data can be specified with the

-a action

or

--action=action

option. This is done after all imports are successfully completed.

Zur Zeit verfügbare Aktionen sind:

  • summary: Diese Aktion ist die selbe wie BerichteAnsichtenDatenbankübersicht Reports ->View ->Summary
  • check: Diese Aktion ist die selbe wie WerkzeugeReparieren der DatenbankDatenbank prüfen und reparieren. Tools ->Database Processing ->Check and Repair .
  • tool: This action allow to run a tool from a command line.
  • report: Diese Aktion erlaubt das erstellen von Berichten über die Kommandozeile. Da Berichte eine Reihe eigener Optionen haben, sollten dieser Aktion die Berichtsoptionenzeichenkette folgen. Die Zeichenkette wird mit der
    -p Optionszeichenkette
    oder
    --options=Optionszeichenkette
    Option übergeben.
Tango-Dialog-information.png
Report option string

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


Most of the report options are specific for every report. However, there some common options.

  • name=report_name: Diese benötigte Option bestimmt welcher Bericht erzeugt wird. Wenn der übergebene Bericht_Name nicht mit einem verfügbaren Bericht übereinstimmt, wird eine Fehlermeldung gefollgt von einer Liste verfügbarer Berichte ausgegeben.
  • 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.

Benutzen Sie die obigen Optionen um alles über einen angegebenen Bericht herauszufinden.

Tango-Dialog-information.png
Tip

Wenn ein Parameter nicht angegeben wird, wird der zuletzt verwendete Wert benutzt. Wenn dieser Bericht vorher nie erstellt wurde, wird wenn möglich der Wert des zuletzt erstellten Berichts benutzt. 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.

List option

-l, print a list of known family trees

Operation

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

-e

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 Sie Daten aus mehreren Quellen benötigen, benutzen Sie die import Optionen über das -i Flag.

Mit oder ohne den

-e

Parameter, können mehrere Importe, Exporte und Aktionen weiter spezifiert in der Kommandozeile durch benutzung -i, -o, and -a Parameter. Die Reihenfolge der

-i

,

-e

, oder

-a

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

'

Gramps-notes.png
Notiz

Aber öffnen muß 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.

Wenn kein -o oder -a Parameter angegeben ist, startet GRAMPS sein Hauptfenster und startet die gewöhnliche interaktive Sitzung mit der, aus öffnen und allen Importen (wenn überhaupt) resultierenden Datenbank. Die Datenbank liegt dann in der Datei import_db.grdb in dem Verzeichnis ~/.gramps/import/.

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

Examples

  • To import four databases (whose formats can be determined from their names) and then check the resulting database for errors, one may type:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check
  • To explicitly specify the formats in the above example, append filenames with appropriate -f options:
gramps -i file1.ged -f gedcom -i file2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check
  • To record the database resulting from all imports, supply -e flag (use -f if the filename does not allow GRAMPS to guess the format):
gramps -i file1.ged -i file2.gpkg -e ~/new-package -f gramps-pkg
  • To save any error messages of the above example into files outfile and errfile, run:
gramps -i file1.ged -i file2.dpkg -e ~/new-package -f gramps-pkg >outfile 2>errfile 
  • To import three databases and start interactive GRAMPS session with the result:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps 
  • To open a database and, based on that data, generate timeline report in PDF format putting the output into the my_timeline.pdf file:
gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf 
Tango-Dialog-information.png
Timeline report options

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


  • To convert a grdb on the fly to a .gramps xml file:
gramps -O myoriginal.grdb -e output.gramps -f gramps-xml
  • Finally, to start normal interactive session type:
gramps 

Environment variables

GRAMPS can take advantage of these environment variables (but do not change them if you do not know what are you doing):

  • GRAMPSHOME - if set, override default path to profile allowing user to use ex. network drive to store data and all settings.
  • LANG - is used by GRAMPS to determine which language file should be loaded.


Zurück Index Nächste