263 lines
12 KiB
XML
263 lines
12 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!--
|
|
User Manual for Gramps - a GTK+/GNOME based genealogy program
|
|
|
|
Copyright (C) 2003 Alexander Roitman
|
|
|
|
Permission is granted to copy, distribute and/or modify this
|
|
document under the terms of the GNU Free Documentation
|
|
License (GFDL), Version 1.1 or any later version published
|
|
by the Free Software Foundation with no Invariant Sections,
|
|
no Front-Cover Texts, and no Back-Cover Texts.
|
|
A copy of the license is included in the file COPYING-DOCS
|
|
distributed with this manual.
|
|
-->
|
|
|
|
<!-- $Id$ -->
|
|
|
|
<!-- =============== Appendices Subsection ================ -->
|
|
<sect2 id="append-cmdline">
|
|
<title>Befehlszeilen-Referenz</title>
|
|
<para>Dieser Anhang liefert eine Referent über die Möglichkeiten,
|
|
wenn Sie &app; aus dem Terminal starten.</para>
|
|
|
|
<para>Lassen Sie uns anmerken, dass &app; als ein interaktives
|
|
Programm entworfen wurde. Deshalb benutzt es eine grafische Ansicht und
|
|
kann nicht von eine echten nicht-grafischen Konsole gestartet werden. Es
|
|
würde einen enormen Aufwand darstellen eine Ausführung in einem Nur-Text
|
|
Terminal zu ermöglichen. Aus diesem Grund zielen die möglichen
|
|
Befehlszeilenparameter nicht darauf ab, komplett auf die grafisch
|
|
Anzeige zu verzichten. Eher machen sie einige typische Aufgaben
|
|
angenehmer. Sie erlauben Ihnen auch diese Aufgaben aus Skripten
|
|
heraus auszuführen. Jedenfalls muss die grafische Anzeige immer
|
|
verfügbar sein!</para>
|
|
|
|
<para>Zusammengefasst bietet die Benutzung der Befehlszeilenparameter
|
|
nicht-interaktives Verhalten, aber beseitigt nicht die Abhängigkeit
|
|
von der grafischen Anzeige. Take it or leave it!
|
|
</para>
|
|
|
|
|
|
<sect3 id="cmdline-options">
|
|
<title>Verfügbare Parameter</title>
|
|
|
|
<para>Hier ist ein Liste der möglichen Parameter in &app;:</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry><term>Format-Parameter</term>
|
|
<listitem><para>Das Format der Dateien für den Import oder
|
|
Export kann festgelegt werden mit dem
|
|
<command>-f</command> <replaceable>Format</replaceable>
|
|
Parameter. <replaceable>Format</replaceable> kann eines der
|
|
folgenden sein:
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry><term>gramps</term>
|
|
<listitem><para> &app;-Datenbank. Dieses Format ist sowohl
|
|
für den Import als auch für den Export verfügbar. Falls
|
|
nicht gegeben wird es geraten, wenn der Dateiname ein
|
|
Verzeichnis darstellt.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry><term>gedcom</term>
|
|
<listitem><para> GEDCOM-Datei. Dieses Format ist für den
|
|
Import und den Export verfügbar. Falls nicht angegeben
|
|
wird es geraten, wenn der Dateiname mit .ged endet.
|
|
</para></listitem></varlistentry>
|
|
|
|
<varlistentry><term>gramps-pkg</term>
|
|
<listitem><para> &app;-Paket. Dieses Format ist für den
|
|
Import und Export verfügbar. Falls nicht angegeben wird es
|
|
geraten, wenn der Dateiname mit .tgz endet.
|
|
</para></listitem></varlistentry>
|
|
|
|
<varlistentry><term>wft</term>
|
|
<listitem><para> Web Family Tree. Dieses Format ist nur für
|
|
den Export verfügbar. Falls nichts angegeben wird es
|
|
geraten, wenn der Dateiname mit .wft endet.
|
|
</para></listitem></varlistentry>
|
|
|
|
<varlistentry><term>iso</term>
|
|
<listitem><para> CD-Image. Dieses Format ist nur für den
|
|
Export verfügbar. Es muss immer ausdrücklich angegeben
|
|
werden.
|
|
</para></listitem></varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry><term>Import-Parameter</term>
|
|
<listitem><para>Die für den Import vorgesehenen Dateien können
|
|
mit dem
|
|
<command>-i</command> <replaceable>Dateiname</replaceable>
|
|
Parameter angegeben werden. Das Format kann mit dem
|
|
<command>-f</command> Parameter bestimmt werden, der sofort
|
|
auf dem <replaceable>Dateiname</replaceable>n folgt.
|
|
Falls es nicht angegeben wird, wird versucht das Format aus
|
|
dem <replaceable>Dateiname</replaceable>n zu ermitteln. Für
|
|
das <term>gramps</term>-Format, ist
|
|
<replaceable>Dateiname</replaceable> der Name eines Verzeichnisses,
|
|
unter dem sich die gramps Datenbank befindet. Für
|
|
<term>gedcom</term> und <term>gramps-pkg</term> ist
|
|
<replaceable>Dateiname</replaceable> des Name der entsprechenden
|
|
Datei.</para>
|
|
|
|
<para>Falls mehr als eine Eingabedatei angegeben wird, muss
|
|
jeder einem <command>-i</command> folgen. Die Dateien werden in
|
|
der angegebenen Reihenfolge importiert, z.B.
|
|
<command>-i</command> <replaceable>Datei1</replaceable>
|
|
<command>-i</command> <replaceable>Datei2</replaceable>
|
|
und
|
|
<command>-i</command> <replaceable>Datei2</replaceable>
|
|
<command>-i</command> <replaceable>Datei1</replaceable>
|
|
könnte verschiedene gramps-ID's in der resultierenden
|
|
Datenbank resultieren.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry><term>Export-Parameter</term>
|
|
<listitem><para>Die für den Export vorgesehenen Dateien können
|
|
mit dem
|
|
<command>-o</command> <replaceable>Dateiname</replaceable>
|
|
Parameter angegeben werden. Das Format kann mit dem
|
|
<command>-f</command> Parameter bestimmt werden, der sofort auf
|
|
dem <replaceable>Dateiname</replaceable>n folgt.
|
|
Falls es nicht angegeben wird, wird versucht das Format aus
|
|
dem <replaceable>Dateiname</replaceable>n zu ermitteln.
|
|
Für die <term>gramps</term>- und <term>iso</term>-Formate,
|
|
ist der <replaceable>Dateiname</replaceable> der Name eines
|
|
Verzeichnisses, in das die gramps-Datenbank geschrieben wird.
|
|
Für <term>gedcom</term>, <term>wft</term> und <term>gramps-pkg</term>
|
|
ist der <replaceable>Dateiname</replaceable> der Name der
|
|
resultierenden Datei.
|
|
</para>
|
|
|
|
<para>Wenn mehr als eine Ausgabedatei angeben wird, muss jede auf
|
|
einem <command>-o</command>-Parameter folgen. Diese Dateien werden
|
|
nacheinander geschrieben, in der angegebenen Reihenfolge.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry><term>Aktion-Parameter</term>
|
|
<listitem><para>Die Aktion, die mit den importierten Daten
|
|
durchgeführt werden soll, kann mit dem
|
|
<command>-a</command> <replaceable>Aktion</replaceable>
|
|
Parameter festgelegt werden. Dies wird getan, wenn alle Importe
|
|
erfolgreich durchgeführt worden sind. Die momentan verfügbaren
|
|
Aktionen sind <term>summary</term> (dasselbe wie
|
|
<menuchoice><guimenu>Berichte</guimenu>
|
|
<guisubmenu>Ansichten</guisubmenu>
|
|
<guimenuitem>Datenbankübersicht</guimenuitem></menuchoice>)
|
|
und <term>check</term> (dasselbe wie
|
|
<menuchoice><guimenu>Werkzeuge</guimenu>
|
|
<guisubmenu>Datenbankverarbeitung</guisubmenu>
|
|
<guimenuitem>Datenbank prüfen und reparieren</guimenuitem></menuchoice>).
|
|
</para>
|
|
|
|
<para>Wenn mehr als eine Ausgabeaktion angegeben wird, muss jede
|
|
auf einem <command>-a</command> Parameter folgen. Die Aktionen
|
|
werden nacheinander in der entsprechenden Reihenfolge durchgeführt.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="cmdline-operation">
|
|
<title>Operationen</title>
|
|
|
|
<para>Die Reihenfolge der <command>-i</command>, <command>-o</command>,
|
|
oder <command>-a</command> Parameter spielt keine Rolle. Die
|
|
tatsächliche Ausführungsreihenfolge ist immer: alle Import ->
|
|
alle Exporte -> alle Aktionen.</para>
|
|
|
|
<para>Wenn kein <command>-i</command> 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). </para>
|
|
|
|
<para>Wenn kein <command>-o</command> oder <command>-a</command>
|
|
Parameter angegeben ist, startet gramps sein Hauptfenster und
|
|
startet die gewöhnliche interaktive Sitzung mit der, aus allen
|
|
Importen resultierenden Datenbank. Die Datenbank liegt dann in
|
|
dem Verzeichnis <replaceable>~/.gramps/import</replaceable>.</para>
|
|
|
|
<para>Fehler, die während des Imports, Exports oder einer Aktion
|
|
auftreten, werden entweder auf stdout (wenn es Exceptions sind, die
|
|
von gramps behandelt werden) oder auf stderr (wenn sie nicht
|
|
behandelt werden). Benutzen Sie die gewöhnlichen Shell-Umleitungen
|
|
von stdout und stderr um diese Nachrichten und Fehler in Dateien
|
|
zu speichern.</para>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="cmdline-examples">
|
|
<title>Beispiele</title>
|
|
<para>Um vier Datenbanken (dessen Format aus ihren
|
|
Namen bestimmt werden kann) zu importieren und die resultieren
|
|
Datenbank auf Fehler zu überprüfen, kann man schreiben:</para>
|
|
<para><command>gramps -i</command> <replaceable>datei1.ged</replaceable>
|
|
<command>-i</command> <replaceable>datei2.tgz</replaceable>
|
|
<command>-i</command> <replaceable>~/db3</replaceable>
|
|
<command>-i</command> <replaceable>datei4.wft</replaceable>
|
|
<command>-a</command> <replaceable>check</replaceable>
|
|
</para>
|
|
|
|
<para>Um explizit die Formate im oberen Beispiel anzugeben, hängen
|
|
Sie an die Dateinamen die entsprechenden <command>-f</command>
|
|
Parameter:</para>
|
|
<para><command>gramps -i</command> <replaceable>datei1.ged</replaceable>
|
|
<command>-f</command> <replaceable>gedcom</replaceable>
|
|
<command>-i</command> <replaceable>datei2.tgz</replaceable>
|
|
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
|
<command>-i</command> <replaceable>~/db3</replaceable>
|
|
<command>-f</command> <replaceable>gramps</replaceable>
|
|
<command>-i</command> <replaceable>datei4.wft</replaceable>
|
|
<command>-f</command> <replaceable>wft</replaceable>
|
|
<command>-a</command> <replaceable>check</replaceable>
|
|
</para>
|
|
|
|
<para>Um die aus allen Importen resultierende Datenbank aufzuzeichnen,
|
|
benutzen Sie ein <command>-o</command> Parameter (benutzen Sie
|
|
<command>-f</command>, wenn der Dateiname es gramps nicht
|
|
ermöglicht das Format zu raten):</para>
|
|
<para><command>gramps -i</command> <replaceable>datei1.ged</replaceable>
|
|
<command>-i</command> <replaceable>datei2.tgz</replaceable>
|
|
<command>-o</command> <replaceable>~/neues-paket</replaceable>
|
|
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
|
</para>
|
|
|
|
<para>Um Fehlermeldungen der oberen Beispiele in die Dateien
|
|
<replaceable>outfile</replaceable> und
|
|
<replaceable>errfile</replaceable> zu speichern, führen Sie aus:
|
|
</para>
|
|
<para><command>gramps -i</command> <replaceable>datei1.ged</replaceable>
|
|
<command>-i</command> <replaceable>datei2.tgz</replaceable>
|
|
<command>-o</command> <replaceable>~/neues-paket</replaceable>
|
|
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
|
><replaceable>outfile</replaceable>
|
|
2><replaceable>errfile</replaceable>
|
|
</para>
|
|
|
|
<para>Um drei Datenbanken zu importieren und ein interaktive gramps-
|
|
Sitzung zu starten:</para>
|
|
<para><command>gramps -i</command> <replaceable>datei1.ged</replaceable>
|
|
<command>-i</command> <replaceable>datei2.tgz</replaceable>
|
|
<command>-i</command> <replaceable>~/db3</replaceable>
|
|
</para>
|
|
|
|
<para>Schließlich, um eine normale interaktive Sitzung zu starten,
|
|
tippen Sie:</para>
|
|
<para> <command>gramps </command></para>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|