2003-12-09 04:37:14 +05:30
|
|
|
|
<?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">
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<title>Befehlszeilenreferenz</title>
|
|
|
|
|
|
<para>Dieser Anhang liefert eine Referent <20>ber die M<>glichkeiten,
|
|
|
|
|
|
wenn Sie &app; aus dem Terminal starten.</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>Lassen Sie uns anmerken, dass &apps als ein interaktives
|
|
|
|
|
|
Program 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<73>hrung in einem Nur-Text
|
|
|
|
|
|
Terminal zu erm<72>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<75>hren. Jedenfalls muss die grafische Anzeige immer
|
|
|
|
|
|
verf<72>gbar sein!</para>
|
2003-12-09 04:37:14 +05:30
|
|
|
|
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<para>Zusammengefasst bietet die Benutzung der Befehlzeilenparameter
|
|
|
|
|
|
nicht-interaktives Verhalten, aber beseitigt nicht die Abh<62>ngigkeit
|
|
|
|
|
|
von der grafischen Anzeige. Take it or leave it!
|
2003-12-09 04:37:14 +05:30
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<sect3 id="cmdline-options">
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<title>Verf<EFBFBD>gbare Parameter</title>
|
2003-12-09 04:37:14 +05:30
|
|
|
|
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<para>Hier ist ein Liste der m<>glichen Parameter in &apps;:</para>
|
2003-12-09 04:37:14 +05:30
|
|
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
|
|
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<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:
|
|
|
|
|
|
|
2003-12-09 04:37:14 +05:30
|
|
|
|
<variablelist>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>gramps</term>
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<listitem><para> &app; database. This format is available
|
|
|
|
|
|
for both import and export. When not specified, it can be
|
|
|
|
|
|
guessed if the filename represents a directory.
|
2003-12-09 04:37:14 +05:30
|
|
|
|
</para></listitem></varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>gedcom</term>
|
2004-01-25 22:52:02 +05:30
|
|
|
|
<listitem><para> GEDCOM file. This format is available
|
|
|
|
|
|
for both import and export. When not specified, it can be
|
2003-12-09 04:37:14 +05:30
|
|
|
|
guessed if the filename ends with .ged
|
|
|
|
|
|
</para></listitem></varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>gramps-pkg</term>
|
|
|
|
|
|
<listitem><para> &app; package. This format is available
|
|
|
|
|
|
for both import and export. When not specified, it can be
|
|
|
|
|
|
guessed if the filename ends with .tgz
|
|
|
|
|
|
</para></listitem></varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>wft</term>
|
|
|
|
|
|
<listitem><para> Web Family Tree. This format is available
|
|
|
|
|
|
for export only. When not specified, it can be guessed
|
|
|
|
|
|
if the filename ends with .wft
|
|
|
|
|
|
</para></listitem></varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>iso</term>
|
|
|
|
|
|
<listitem><para> CD image. This format is available
|
|
|
|
|
|
for export only. It must always be specified explicitly.
|
|
|
|
|
|
</para></listitem></varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
|
|
|
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>Import options</term>
|
|
|
|
|
|
<listitem><para> The files destined for import can be specified with
|
|
|
|
|
|
the
|
|
|
|
|
|
<command>-i</command> <replaceable>filename</replaceable>
|
|
|
|
|
|
option. The format can be specified with the <command>-f</command>
|
|
|
|
|
|
option immediately following the <replaceable>filename</replaceable>.
|
|
|
|
|
|
If not specified, the guess will be attempted based on
|
|
|
|
|
|
the <replaceable>filename</replaceable>. For <term>gramps</term>
|
|
|
|
|
|
format, the <replaceable>filename</replaceable> is actually the
|
|
|
|
|
|
name of directory under which the gramps database resides. For
|
|
|
|
|
|
<term>gedcom</term> and <term>gramps-pkg</term>, the
|
|
|
|
|
|
<replaceable>filename</replaceable> is the name of the
|
|
|
|
|
|
corresponding file.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>When more than one input file is given, each has to be preceded
|
|
|
|
|
|
by <command>-i</command> flag. The files are imported in the
|
|
|
|
|
|
specified order, i.e.
|
|
|
|
|
|
<command>-i</command> <replaceable>file1</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2</replaceable>
|
|
|
|
|
|
and
|
|
|
|
|
|
<command>-i</command> <replaceable>file2</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file1</replaceable>
|
|
|
|
|
|
might produce different gramps IDs in the resulting database.
|
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>Export options</term>
|
|
|
|
|
|
<listitem><para> The files destined for export can be specified with
|
|
|
|
|
|
the
|
|
|
|
|
|
<command>-o</command> <replaceable>filename</replaceable>
|
|
|
|
|
|
option. The format can be specified with the <command>-f</command>
|
|
|
|
|
|
option immediately following the <replaceable>filename</replaceable>.
|
|
|
|
|
|
If not specified, the guess will be attempted based on
|
|
|
|
|
|
the <replaceable>filename</replaceable>. For <term>gramps</term>
|
|
|
|
|
|
and <term>iso</term> formats, the <replaceable>filename</replaceable>
|
|
|
|
|
|
is actually the name of directory the gramps database will be written
|
|
|
|
|
|
into. For <term>gedcom</term>, <term>wft</term>,
|
|
|
|
|
|
and <term>gramps-pkg</term>, the <replaceable>filename</replaceable>
|
|
|
|
|
|
is the name of the resulting file.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para> When more than one output file is given, each has to be
|
|
|
|
|
|
preceded by <command>-o</command> flag. The files are written one
|
|
|
|
|
|
by one, in the specified order.
|
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>Action options</term>
|
|
|
|
|
|
<listitem><para> The action to perform on the imported data can be
|
|
|
|
|
|
specified with the
|
|
|
|
|
|
<command>-a</command> <replaceable>action</replaceable>
|
|
|
|
|
|
option. This is done after all imports are successfully completed.
|
|
|
|
|
|
Currently available actions are <term>summary</term> (same as
|
|
|
|
|
|
<menuchoice><guimenu>Reports</guimenu><guisubmenu>View</guisubmenu>
|
|
|
|
|
|
<guimenuitem>Summary</guimenuitem></menuchoice>)
|
|
|
|
|
|
and <term>check</term> (same as
|
|
|
|
|
|
<menuchoice><guimenu>Tools</guimenu>
|
|
|
|
|
|
<guisubmenu>Database Processing</guisubmenu>
|
|
|
|
|
|
<guimenuitem>Check and Repair</guimenuitem></menuchoice>).
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>When more than one output action is given, each has to be
|
|
|
|
|
|
preceded by <command>-a</command> flag. The actions are performed
|
|
|
|
|
|
one by one, in the specified order.
|
|
|
|
|
|
</para></listitem>
|
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
|
|
|
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<sect3 id="cmdline-operation">
|
|
|
|
|
|
<title>Operation</title>
|
|
|
|
|
|
|
|
|
|
|
|
<para>The order of <command>-i</command>, <command>-o</command>,
|
|
|
|
|
|
or <command>-a</command> options with respect to each does not matter.
|
|
|
|
|
|
The actual execution order always is: all imports (if any) -> all
|
|
|
|
|
|
exports (if any) -> all actions (if any).</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>If no <command>-i</command> option is given, gramps will launch
|
|
|
|
|
|
its main window and start the usual interactive session with the empty
|
|
|
|
|
|
database (since there is no data to process, anyway).</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>If no <command>-o</command> or <command>-a</command> options
|
|
|
|
|
|
are given, gramps will launch its main window and start the usual
|
|
|
|
|
|
interactive session with the database resulted from all imports.
|
|
|
|
|
|
This database resides under
|
|
|
|
|
|
<replaceable>~/.gramps/import</replaceable> directory.</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>Any errors encountered during import, export, or action, will
|
|
|
|
|
|
be either dumped to stdout (if these are exceptions handled by gramps)
|
|
|
|
|
|
or or to stderr (if these are not handled). Use usual shell redirections
|
|
|
|
|
|
of stdout and stderr to save messages and errors in files.</para>
|
|
|
|
|
|
|
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
|
|
<sect3 id="cmdline-examples">
|
|
|
|
|
|
<title>Examples</title>
|
|
|
|
|
|
<para>To import four databases (whose formats can be determined from
|
|
|
|
|
|
their names) and then check the resulting database for errors, one may
|
|
|
|
|
|
type:</para>
|
|
|
|
|
|
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>~/db3</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file4.wft</replaceable>
|
|
|
|
|
|
<command>-a</command> <replaceable>check</replaceable>
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>To explicitly specify the formats in the above example, append
|
|
|
|
|
|
filenames with appropriate <command>-f</command> options:</para>
|
|
|
|
|
|
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
|
|
|
|
|
<command>-f</command> <replaceable>gedcom</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2.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>file4.wft</replaceable>
|
|
|
|
|
|
<command>-f</command> <replaceable>wft</replaceable>
|
|
|
|
|
|
<command>-a</command> <replaceable>check</replaceable>
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>To record the database resulting from all imports, supply
|
|
|
|
|
|
<command>-o</command> flag (use <command>-f</command>
|
|
|
|
|
|
if the filename does not allow gramps to guess the format):</para>
|
|
|
|
|
|
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
|
|
|
|
|
<command>-o</command> <replaceable>~/new-package</replaceable>
|
|
|
|
|
|
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>To save any error messages of the above example into files
|
|
|
|
|
|
<replaceable>outfile</replaceable> and
|
|
|
|
|
|
<replaceable>errfile</replaceable>, run:</para>
|
|
|
|
|
|
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
|
|
|
|
|
<command>-o</command> <replaceable>~/new-package</replaceable>
|
|
|
|
|
|
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
|
|
|
|
|
><replaceable>outfile</replaceable>
|
|
|
|
|
|
2><replaceable>errfile</replaceable>
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>To import three databases and start interactive gramps
|
|
|
|
|
|
session with the result:</para>
|
|
|
|
|
|
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
|
|
|
|
|
<command>-i</command> <replaceable>~/db3</replaceable>
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<para>Finally, to start normal interactive session type:</para>
|
|
|
|
|
|
<para> <command>gramps </command></para>
|
|
|
|
|
|
|
|
|
|
|
|
</sect3>
|
|
|
|
|
|
|
|
|
|
|
|
</sect2>
|
