Merge pull request #1033 from bentley/rst-manpage
This commit is contained in:
Nick Hall
commit
62ee9d2c7d
510
data/man/en.rst
510
data/man/en.rst
@ -1,299 +1,307 @@
|
|||||||
English
|
gramps
|
||||||
=======
|
======
|
||||||
|
|
||||||
|
-----------------------------------------------------------------
|
||||||
|
Genealogical Research and Analysis Management Programming System.
|
||||||
|
-----------------------------------------------------------------
|
||||||
|
|
||||||
|
:Manual section: 1
|
||||||
|
:Manual group: @VERSION@
|
||||||
|
|
||||||
|
########
|
||||||
|
SYNOPSIS
|
||||||
|
########
|
||||||
|
|
||||||
|
**gramps**
|
||||||
|
\ [\ **-?** | **--help**]
|
||||||
|
\ [\ **--usage**]
|
||||||
|
\ [\ **--version**]
|
||||||
|
\ [\ **-l**]
|
||||||
|
\ [\ **-L**]
|
||||||
|
\ [\ **-u** | **--force-unlock**]
|
||||||
|
\ [\ **-O** | **--open**\ =\ *DATABASE* [\ **-f** | **--format**\ =\ *FORMAT*]]
|
||||||
|
\ [\ **-i** | **--import**\ =\ *FILE* [\ **-f** | **--format**\ =\ *FORMAT*]]
|
||||||
|
\ [\ **--remove**\ =\ *FAMILY_TREE_PATTERN*]
|
||||||
|
\ [\ **-e** | **--export**\ =\ *FILE* [**-f** | **--format**\ =\ *FORMAT*]]
|
||||||
|
\ [\ **-a** | **--action**\ =\ *ACTION*]
|
||||||
|
\ [\ **-p** | **--options**\ =\ *OPTION-STRING*]]
|
||||||
|
\ [\ *FILE*]
|
||||||
|
\ [\ **--version**]
|
||||||
|
|
||||||
|
###########
|
||||||
|
DESCRIPTION
|
||||||
|
###########
|
||||||
|
|
||||||
|
Gramps is a Free, Open Source genealogy program.
|
||||||
|
It is written in Python, using the GTK+/GNOME interface.
|
||||||
|
Gramps should seem familiar to anyone who has used other genealogy programs
|
||||||
|
before such as Family Tree Maker™, Personal Ancestral Files™,
|
||||||
|
or the GNU Geneweb.
|
||||||
|
It supports importing of the ever-popular GEDCOM format which is used worldwide
|
||||||
|
by almost all other genealogy software.
|
||||||
|
|
||||||
|
#######
|
||||||
|
OPTIONS
|
||||||
|
#######
|
||||||
|
|
||||||
|
**gramps** *FILE*
|
||||||
|
When *FILE* is given (without any flags) as a family tree name or as a
|
||||||
|
family tree database directory, then it is opened and an interactive
|
||||||
|
session is started.
|
||||||
|
If *FILE* is a file format understood by Gramps, an empty family tree is
|
||||||
|
created whose name is based on the *FILE* name, and the data is imported
|
||||||
|
into it.
|
||||||
|
Any other options are ignored.
|
||||||
|
This way of launching is suitable for using gramps as a handler for
|
||||||
|
genealogical data in e.g. web browsers.
|
||||||
|
This invocation can accept any data format native to gramps; see below.
|
||||||
|
|
||||||
|
**-f**, **--format**\ =\ *FORMAT*
|
||||||
|
Explicitly specify format of *FILE* given by preceding **-i** or **-e**
|
||||||
|
option.
|
||||||
|
If the **-f** option is not given for any *FILE*, the format of that file
|
||||||
|
is guessed according to its extension or MIME type.
|
||||||
|
|
||||||
|
Formats available for export are **gramps-xml** (guessed if *FILE* ends
|
||||||
|
with `.gramps`), **gedcom** (guessed if *FILE* ends with `.ged`), or any
|
||||||
|
file export available through the Gramps plugin system.
|
||||||
|
|
||||||
|
Formats available for import are **gramps-xml**, **gedcom**, **gramps-pkg**
|
||||||
|
(guessed if *FILE* ends with `.gpkg`), and **geneweb** (guessed if *FILE*
|
||||||
|
ends with `.gw`).
|
||||||
|
|
||||||
|
Formats available for export are **gramps-xml**, **gedcom**,
|
||||||
|
**gramps-pkg**, **wft** (guessed if *FILE* ends with `.wft`),
|
||||||
|
**geneweb**.
|
||||||
|
|
||||||
|
**-l**
|
||||||
|
Print a list of known family trees.
|
||||||
|
|
||||||
|
**-L**
|
||||||
|
Print a detailed list of known family trees.
|
||||||
|
|
||||||
|
**-u**, **--force-unlock**
|
||||||
|
Unlock a locked database.
|
||||||
|
|
||||||
|
**-O**, **--open**\ =\ *DATABASE*
|
||||||
|
Open *DATABASE* which must be an existing database directory or existing
|
||||||
|
family tree name.
|
||||||
|
If no action, import, or export options are given on the command line, then
|
||||||
|
an interactive session is started using that database.
|
||||||
|
|
||||||
|
**-i**, **--import**\ =\ *FILE*
|
||||||
|
Import data from *FILE*.
|
||||||
|
If no database was specified, then an empty database is created
|
||||||
|
called Family Tree *x* (where *x* is an incrementing number).
|
||||||
|
|
||||||
|
When more than one input file is given,
|
||||||
|
each has to be preceded by a **-i** flag.
|
||||||
|
The files are imported in the specified order, e.g.,
|
||||||
|
**-i** *FILE1* **-i** *FILE2*
|
||||||
|
and
|
||||||
|
**-i** *FILE2* **-i** *FILE1*
|
||||||
|
might produce different gramps IDs in the resulting database.
|
||||||
|
|
||||||
|
**-e**, **--export**\ =\ *FILE*
|
||||||
|
Export data into *FILE*.
|
||||||
|
For **gramps-xml**, **gedcom**, **wft**, **gramps-pkg**, and **geneweb**,
|
||||||
|
the *FILE* is the name of the resulting file.
|
||||||
|
|
||||||
|
When more than one output file is given,
|
||||||
|
each has to be preceded by a **-e** flag.
|
||||||
|
The files are written one by one, in the specified order.
|
||||||
|
|
||||||
|
**-a**, **--action**\ =\ *ACTION*
|
||||||
|
Perform *ACTION* on the imported data.
|
||||||
|
This is done after all imports are successfully completed.
|
||||||
|
Currently available actions are **summary** (same as
|
||||||
|
Reports→View→Summary), **check** (same as Tools→Database
|
||||||
|
Processing→Check and Repair), **report** (generates report), and tool
|
||||||
|
(runs a plugin tool).
|
||||||
|
Both **report** and **tool** need the *OPTION-STRING* supplied by the
|
||||||
|
**-p** flag).
|
||||||
|
|
||||||
|
The *OPTION-STRING* should satisfy the following conditions:
|
||||||
|
|
||||||
|
- It should not contain any spaces.
|
||||||
|
- If some arguments need to include spaces, the string should be enclosed
|
||||||
|
with quotation marks, following shell syntax.
|
||||||
|
- The option string is a list of pairs with name and value (separated by an
|
||||||
|
equals sign).
|
||||||
|
- The name and value pairs must be separated by commas.
|
||||||
|
|
||||||
|
Most of the report or tools options are specific for each report or tool.
|
||||||
|
However, there are some common options.
|
||||||
|
|
||||||
|
**name**\ =\ *name*
|
||||||
|
This mandatory option determines which report or tool will be run.
|
||||||
|
If the supplied *name* does not correspond to any available report or
|
||||||
|
tool, an error message will be printed followed by the list of
|
||||||
|
available reports or tools (depending on the *ACTION*).
|
||||||
|
|
||||||
|
**show**\ =\ **all**
|
||||||
|
This will produce the list of names for all options available for a
|
||||||
|
given report or tool.
|
||||||
|
|
||||||
gramps(1) @VERSION@ gramps(1)
|
**show**\ =\ *optionname*
|
||||||
|
This will print the description of the functionality supplied by
|
||||||
|
*optionname*, as well as what are the acceptable types and values for
|
||||||
|
this option.
|
||||||
|
|
||||||
|
Use the above options to find out everything about a given report.
|
||||||
|
|
||||||
|
When more than one output action is given, each has to be preceded by a
|
||||||
|
**-a** flag.
|
||||||
|
The actions are performed one by one, in the specified order.
|
||||||
|
|
||||||
**NAME**
|
**-d**, **--debug**\ =\ *LOGGER_NAME*
|
||||||
gramps - Genealogical Research and Analysis Management Programming Sys‐
|
Enable debug logs for development and testing.
|
||||||
tem.
|
Look at the source code for details.
|
||||||
|
|
||||||
|
**--version**
|
||||||
|
Print the version number of gramps and then exits.
|
||||||
|
|
||||||
**SYNOPSIS**
|
#########
|
||||||
**gramps** [**-?** | **--help**] [**--usage**] [**--version**]
|
OPERATION
|
||||||
[**-l**] [**-L**] [**-u** | **--force-unlock**] [**-O** | **--open=** *DATABASE*
|
#########
|
||||||
[**-f** | **--format=** *FORMAT*] [**-i** | **--import=** *FILE*
|
|
||||||
[**-f** | **--format=** *FORMAT*]] [**--remove=** *FAMILY_TREE_PATTERN*]
|
|
||||||
[**-e** | **--export=** *FILE* [**-f** | **--format=** *FORMAT*]]
|
|
||||||
[**-a** | **--action=** *ACTION*] [*-p* | **--options=** *OPTION‐
|
|
||||||
STRING*]] [*FILE*] [**--version**]
|
|
||||||
|
|
||||||
|
If the first argument on the command line does not start with dash (i.e., no
|
||||||
|
flag), gramps will attempt to open the file with the name given by the first
|
||||||
|
argument and start an interactive session, ignoring the rest of the command line
|
||||||
|
arguments.
|
||||||
|
|
||||||
**DESCRIPTION**
|
If the **-O** flag is given, then gramps will try opening the supplied database
|
||||||
Gramps is a Free/OpenSource genealogy program. It is written in Python,
|
and then work with that data, as instructed by the further command line
|
||||||
using the GTK+/GNOME interface. Gramps should seem familiar to anyone
|
parameters.
|
||||||
who has used other genealogy programs before such as Family Tree Maker
|
|
||||||
(TM), Personal Ancestral Files (TM), or the GNU Geneweb. It supports
|
|
||||||
importing of the ever popular GEDCOM format which is used world wide by
|
|
||||||
almost all other genealogy software.
|
|
||||||
|
|
||||||
|
With or without the **-O** flag, further imports, exports, and actions may be
|
||||||
|
specified on the command line by using **-i**, **-e**, and
|
||||||
|
**-a** flags.
|
||||||
|
|
||||||
**OPTIONS**
|
The order of **-i**, **-e**, or **-a** options does not matter.
|
||||||
**gramps** *FILE*
|
The actual order they are processed always is:
|
||||||
When *FILE* is given (without any flags) as a family tree name or
|
all imports (if any) → all actions (if any) → all exports (if any).
|
||||||
as a family tree database directory, then it is opened and an
|
But opening must always be first!
|
||||||
interactive session is started. If *FILE* is a file format under‐
|
|
||||||
stood by Gramps, an empty family tree is created whose name is
|
|
||||||
based on the *FILE* name and the data is imported into it. The
|
|
||||||
rest of the options is ignored. This way of launching is suit‐
|
|
||||||
able for using gramps as a handler for genealogical data in e.g.
|
|
||||||
web browsers. This invocation can accept any data format native
|
|
||||||
to gramps, see below.
|
|
||||||
|
|
||||||
|
If no **-O** or **-i** option is given,
|
||||||
|
gramps will launch its main window and start the usual interactive session with
|
||||||
|
an empty database, since there is no data to process anyway.
|
||||||
|
|
||||||
**-f** , **--format=** *FORMAT*
|
If no **-e** or **-a** options are given,
|
||||||
Explicitly specify format of *FILE* given by preceding **-i** ,
|
gramps will launch its main window and start the usual interactive session with
|
||||||
or **-e** option. If the **-f** option is not given for any
|
the database resulting from all imports.
|
||||||
*FILE* , the format of that file is guessed according to its extension
|
This database resides in the *import_db.grdb* under the *~/.gramps/import*
|
||||||
or MIME-type.
|
directory.
|
||||||
|
|
||||||
Formats available for export are **gramps-xml** (guessed if *FILE*
|
Any errors encountered during import, export, or action
|
||||||
ends with **.gramps** ), **gedcom** (guessed if *FILE* ends with
|
will be dumped either to *stdout* (if these are exceptions handled by gramps)
|
||||||
**.ged** ), or any file export available through the Gramps plugin
|
or to *stderr* (if these are not handled).
|
||||||
system.
|
Use usual shell redirections of *stdout* and *stderr* to save messages and
|
||||||
|
errors to files.
|
||||||
|
|
||||||
Formats available for import are **gramps-xml** , **gedcom** ,
|
########
|
||||||
**gramps-pkg** (guessed if *FILE* ends with **.gpkg** ),
|
EXAMPLES
|
||||||
and **geneweb** (guessed if *FILE* ends with **.gw** ).
|
########
|
||||||
|
|
||||||
Formats available for export are **gramps-xml** , **gedcom** ,
|
To open an existing family tree and import an xml file into it, one may type::
|
||||||
**gramps-pkg** , **wft** (guessed if *FILE* ends with **.wft** ),
|
|
||||||
**geneweb**.
|
|
||||||
|
|
||||||
|
gramps -O 'My Family Tree' -i ~/db3.gramps
|
||||||
|
|
||||||
**-l**
|
The above changes the opened family tree. To do the same, but import both in a
|
||||||
Print a list of known family trees.
|
temporary family tree and start an interactive session, one may type::
|
||||||
|
|
||||||
|
gramps -i 'My Family Tree' -i ~/db3.gramps
|
||||||
|
|
||||||
**-L**
|
To import four databases (whose formats can be determined from their names) and
|
||||||
Print a detailed list of known family trees.
|
then check the resulting database for errors, one may type::
|
||||||
|
|
||||||
|
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps -i file4.wft -a check
|
||||||
|
|
||||||
**-u** , **--force-unlock**
|
To explicitly specify the formats in the above example, append filenames with
|
||||||
Unlock a locked database.
|
appropriate **-f** options::
|
||||||
|
|
||||||
|
gramps -i file1.ged -f gedcom -i file2.tgz -f gramps-pkg \
|
||||||
|
-i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check
|
||||||
|
|
||||||
**-O** , **--open=** *DATABASE*
|
To record the database resulting from all imports, supply a **-e** flag (use
|
||||||
Open *DATABASE* which must be an existing database directory or
|
**-f** if the filename does not allow gramps to guess the format)::
|
||||||
existing family tree name. If no action, import or export
|
|
||||||
options are given on the command line then an interactive ses‐
|
|
||||||
sion is started using that database.
|
|
||||||
|
|
||||||
|
gramps -i file1.ged -i file2.tgz -e ~/new-package -f gramps-pkg
|
||||||
|
|
||||||
**-i** , **--import=** *FILE*
|
To import three databases and start an interactive gramps session with the
|
||||||
Import data from *FILE* . If you haven't specified a database, then
|
result::
|
||||||
an empty database is created for you called Family Tree x
|
|
||||||
(where x is an incrementing number).
|
|
||||||
|
|
||||||
When more than one input file is given, each has to be preceded
|
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps
|
||||||
by **-i** flag. The files are imported in the specified order, i.e.
|
|
||||||
**-i** *FILE1* **-i** *FILE2* and **-i** *FILE2* **-i** *FILE1*
|
|
||||||
might produce different gramps IDs in the resulting database.
|
|
||||||
|
|
||||||
|
To run the Verify tool from the commandline and output the result to
|
||||||
|
*stdout*::
|
||||||
|
|
||||||
**-e** , **--export=** *FILE*
|
gramps -O 'My Family Tree' -a tool -p name= verify
|
||||||
Export data into *FILE* . For **gramps-xml** , **gedcom**
|
|
||||||
, **wft** , **gramps-pkg** , and **geneweb** , the *FILE* is the
|
|
||||||
name of the resulting file.
|
|
||||||
|
|
||||||
When more than one output file is given, each has to be preceded
|
Finally, to start a normal interactive session type::
|
||||||
by **-e** flag. The files are written one by one, in the specified order.
|
|
||||||
|
|
||||||
|
gramps
|
||||||
|
|
||||||
**-a** , **--action=** *ACTION*
|
#####################
|
||||||
Perform *ACTION* on the imported data. This is done after all
|
ENVIRONMENT VARIABLES
|
||||||
imports are successfully completed. Currently available actions
|
#####################
|
||||||
are **summary** (same as Reports->View->Summary), **check** (same as
|
|
||||||
Tools->Database Processing->Check and Repair), **report** (generates
|
|
||||||
report), and tool (runs a plugin tool). Both **report** and **tool**
|
|
||||||
need the *OPTIONSTRING* supplied by the **-p** flag).
|
|
||||||
|
|
||||||
The *OPTIONSTRING* should satisfy the following conditions:
|
The program checks whether these environment variables are set:
|
||||||
It must not contain any spaces. If some arguments need to
|
|
||||||
include spaces, the string should be enclosed with quotation
|
|
||||||
marks, i.e., follow the shell syntax. Option string is a list
|
|
||||||
of pairs with name and value (separated by the equality sign).
|
|
||||||
The name and value pairs must be separated by commas.
|
|
||||||
|
|
||||||
Most of the report or tools options are specific for each report
|
``LANG``
|
||||||
or tool. However, there are some common options.
|
Describe which language to use.
|
||||||
|
E.g., for the Polish language this variable has to be set to `pl_PL.UTF-8`.
|
||||||
|
|
||||||
**name=name**
|
``GRAMPSHOME``
|
||||||
This mandatory option determines which report or tool will be
|
Force Gramps to use the specified directory to keep program
|
||||||
run. If the supplied name does not correspond to any available
|
settings and databases in.
|
||||||
report or tool, an error message will be printed followed by the
|
By default, this variable is not set and gramps assumes that the folder
|
||||||
list of available reports or tools (depending on the *ACTION* ).
|
with all databases and profile settings should be created within the user
|
||||||
|
profile folder (described by environment variable *HOME* for Linux or
|
||||||
|
*USERPROFILE* for Windows 2000/XP).
|
||||||
|
|
||||||
**show=all**
|
``CONCEPTS``
|
||||||
This will produce the list of names for all options available
|
Supports a python-based plugin system, allowing import and export writers,
|
||||||
for a given report or tool.
|
report generators, tools, and display filters to be added without
|
||||||
|
modification of the main program.
|
||||||
|
|
||||||
**show=optionname**
|
In addition to generating direct printer output, report generators also
|
||||||
This will print the description of the functionality supplied by
|
target other output formats, such as *LibreOffice*, *AbiWord*, *HTML*, or
|
||||||
*optionname*, as well as what are the acceptable types and values
|
*LaTeX* to allow the users to modify the format to suit their needs.
|
||||||
for this option.
|
|
||||||
|
|
||||||
Use the above options to find out everything about a given
|
#####
|
||||||
report.
|
FILES
|
||||||
|
#####
|
||||||
|
|
||||||
|
*${PREFIX}/bin/gramps*
|
||||||
|
|
||||||
When more than one output action is given, each has to be preceded by
|
*${PREFIX}/lib/python3/dist-packages/gramps/*
|
||||||
**-a** flag. The actions are performed one by one, in the specified order.
|
|
||||||
|
|
||||||
|
*${PREFIX}/share/*
|
||||||
|
|
||||||
**-d** , **--debug=** *LOGGER_NAME*
|
*${HOME}/.gramps*
|
||||||
Enables debug logs for development and testing. Look at the
|
|
||||||
source code for details
|
|
||||||
|
|
||||||
**--version**
|
#######
|
||||||
Prints the version number of gramps and then exits
|
AUTHORS
|
||||||
|
#######
|
||||||
|
|
||||||
|
Donald Allingham <don@gramps-project.org>
|
||||||
|
https://www.gramps-project.org/
|
||||||
|
|
||||||
|
This man page was originally written by:
|
||||||
|
Brandon L. Griffith <brandon@debian.org>
|
||||||
|
for inclusion in the Debian GNU/Linux system.
|
||||||
|
|
||||||
|
This man page is currently maintained by:
|
||||||
|
Gramps project <xxx@gramps-project.org>
|
||||||
|
|
||||||
**Operation**
|
#############
|
||||||
If the first argument on the command line does not start with dash
|
DOCUMENTATION
|
||||||
(i.e. no flag), gramps will attempt to open the file with the name
|
#############
|
||||||
given by the first argument and start interactive session, ignoring the
|
|
||||||
rest of the command line arguments.
|
|
||||||
|
|
||||||
|
The user documentation is available through a web browser in the form of the
|
||||||
|
Gramps Manual.
|
||||||
|
|
||||||
If the **-O** flag is given, then gramps will try opening the supplied
|
The developer documentation can be found on the
|
||||||
database and then work with that data, as instructed by the further
|
https://www.gramps-project.org/wiki/index.php/Portal:Developers
|
||||||
command line parameters.
|
portal.
|
||||||
|
|
||||||
|
|
||||||
With or without the **-O** flag, there could be multiple imports, exports,
|
|
||||||
and actions specified further on the command line by using **-i** ,
|
|
||||||
**-e** , and **-a** flags.
|
|
||||||
|
|
||||||
|
|
||||||
The order of **-i** , **-e** , or **-a** options does not matter. The actual order
|
|
||||||
always is: all imports (if any) -> all actions (if any) -> all exports
|
|
||||||
(if any). But opening must always be first!
|
|
||||||
|
|
||||||
|
|
||||||
If no **-O** or **-i** 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.
|
|
||||||
|
|
||||||
|
|
||||||
If no **-e** or **-a** 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 in the **import_db.grdb** under
|
|
||||||
**~/.gramps/import** directory.
|
|
||||||
|
|
||||||
|
|
||||||
The error encountered during import, export, or action, will be either
|
|
||||||
dumped to stdout (if these are exceptions handled by gramps) or to
|
|
||||||
*stderr* (if these are not handled). Use usual shell redirections of
|
|
||||||
*stdout* and *stderr* to save messages and errors in files.
|
|
||||||
|
|
||||||
|
|
||||||
**EXAMPLES**
|
|
||||||
To open an existing family tree and import an xml file into it, one
|
|
||||||
may type:
|
|
||||||
|
|
||||||
**gramps -O** *'My Family Tree'* **-i** *~/db3.gramps*
|
|
||||||
|
|
||||||
The above changes the opened family tree, to do the same, but import
|
|
||||||
both in a temporary family tree and start an interactive session, one
|
|
||||||
may type:
|
|
||||||
|
|
||||||
**gramps -i** *'My Family Tree'* **-i** *~/db3.gramps*
|
|
||||||
|
|
||||||
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.tgz* **-i** *~/db3.gramps*
|
|
||||||
**-i** *file4.wft* **-a** *check*
|
|
||||||
|
|
||||||
To explicitly specify the formats in the above example, append file‐
|
|
||||||
names with appropriate **-f** options:
|
|
||||||
|
|
||||||
**gramps -i** *file1.ged* **-f** *gedcom* **-i** *file2.tgz* **-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.tgz* **-e** *~/new-package*
|
|
||||||
**-f** *gramps-pkg*
|
|
||||||
|
|
||||||
To import three databases and start interactive gramps session with the
|
|
||||||
result:
|
|
||||||
|
|
||||||
**gramps -i** *file1.ged* **-i** *file2.tgz* **-i** *~/db3.gramps*
|
|
||||||
|
|
||||||
To run the Verify tool from the commandline and output the result to
|
|
||||||
stdout:
|
|
||||||
|
|
||||||
**gramps -O** *'My Family Tree'* **-a** *tool* **-p name=** *verify*
|
|
||||||
|
|
||||||
Finally, to start normal interactive session type:
|
|
||||||
|
|
||||||
**gramps**
|
|
||||||
|
|
||||||
|
|
||||||
**ENVIRONMENT VARIABLES**
|
|
||||||
The program checks whether these environment variables are set:
|
|
||||||
|
|
||||||
**LANG** - describe, which language to use: Ex.: for polish language this
|
|
||||||
variable has to be set to pl_PL.UTF-8.
|
|
||||||
|
|
||||||
**GRAMPSHOME** - if set, force Gramps to use the specified directory to
|
|
||||||
keep program settings and databases there. By default, this variable is
|
|
||||||
not set and gramps assumes that the folder with all databases and pro‐
|
|
||||||
file settings should be created within the user profile folder
|
|
||||||
(described by environment variable HOME for Linux or USERPROFILE for
|
|
||||||
Windows 2000/XP).
|
|
||||||
|
|
||||||
|
|
||||||
**CONCEPTS**
|
|
||||||
Supports a python-based plugin system, allowing import and export writ‐
|
|
||||||
ers, report generators, tools, and display filters to be added without
|
|
||||||
modification of the main program.
|
|
||||||
|
|
||||||
In addition to generating direct printer output, report generators also
|
|
||||||
target other systems, such as *LibreOffice.org* , *AbiWord* , *HTML*,
|
|
||||||
or *LaTeX* to allow the users to modify the format to suit their needs.
|
|
||||||
|
|
||||||
|
|
||||||
**KNOWN BUGS AND LIMITATIONS**
|
|
||||||
|
|
||||||
**FILES**
|
|
||||||
|
|
||||||
*${PREFIX}/bin/gramps*
|
|
||||||
|
|
||||||
*${PREFIX}/lib/python3/dist-packages/gramps/*
|
|
||||||
|
|
||||||
*${PREFIX}/share/*
|
|
||||||
|
|
||||||
*${HOME}/.gramps*
|
|
||||||
|
|
||||||
|
|
||||||
**AUTHORS**
|
|
||||||
Donald Allingham <don@gramps-project.org>
|
|
||||||
http://gramps-project.org/
|
|
||||||
|
|
||||||
This man page was originally written by:
|
|
||||||
Brandon L. Griffith <brandon@debian.org>
|
|
||||||
for inclusion in the Debian GNU/Linux system.
|
|
||||||
|
|
||||||
This man page is currently maintained by:
|
|
||||||
Gramps project <xxx@gramps-project.org>
|
|
||||||
|
|
||||||
|
|
||||||
**DOCUMENTATION**
|
|
||||||
The user documentation is available through standard web browser
|
|
||||||
in the form of Gramps Manual.
|
|
||||||
|
|
||||||
The developer documentation can be found on the
|
|
||||||
http://www.gramps-project.org/wiki/index.php?title=Portal:Developers
|
|
||||||
portal.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
gramps(1) @VERSION@ gramps(1)
|
|
||||||
|
|||||||
@ -1,8 +1,8 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH ENGLISH "" "" ""
|
.TH GRAMPS 1 "" "" "@VERSION@"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
English \-
|
gramps \- Genealogical Research and Analysis Management Programming System.
|
||||||
.
|
.
|
||||||
.nr rst2man-indent-level 0
|
.nr rst2man-indent-level 0
|
||||||
.
|
.
|
||||||
@ -30,62 +30,63 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||||
..
|
..
|
||||||
|
.SH SYNOPSIS
|
||||||
.sp
|
.sp
|
||||||
gramps(1) @VERSION@ gramps(1)
|
\fBgramps\fP
|
||||||
|
[\fB\-?\fP | \fB\-\-help\fP]
|
||||||
|
[\fB\-\-usage\fP]
|
||||||
|
[\fB\-\-version\fP]
|
||||||
|
[\fB\-l\fP]
|
||||||
|
[\fB\-L\fP]
|
||||||
|
[\fB\-u\fP | \fB\-\-force\-unlock\fP]
|
||||||
|
[\fB\-O\fP | \fB\-\-open\fP=\fIDATABASE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
|
||||||
|
[\fB\-i\fP | \fB\-\-import\fP=\fIFILE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
|
||||||
|
[\fB\-\-remove\fP=\fIFAMILY_TREE_PATTERN\fP]
|
||||||
|
[\fB\-e\fP | \fB\-\-export\fP=\fIFILE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
|
||||||
|
[\fB\-a\fP | \fB\-\-action\fP=\fIACTION\fP]
|
||||||
|
[\fB\-p\fP | \fB\-\-options\fP=\fIOPTION\-STRING\fP]]
|
||||||
|
[\fIFILE\fP]
|
||||||
|
[\fB\-\-version\fP]
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.sp
|
||||||
|
Gramps is a Free, Open Source genealogy program.
|
||||||
|
It is written in Python, using the GTK+/GNOME interface.
|
||||||
|
Gramps should seem familiar to anyone who has used other genealogy programs
|
||||||
|
before such as Family Tree Maker™, Personal Ancestral Files™,
|
||||||
|
or the GNU Geneweb.
|
||||||
|
It supports importing of the ever\-popular GEDCOM format which is used worldwide
|
||||||
|
by almost all other genealogy software.
|
||||||
|
.SH OPTIONS
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \fBNAME\fP
|
|
||||||
gramps \- Genealogical Research and Analysis Management Programming Sys‐
|
|
||||||
tem.
|
|
||||||
.TP
|
|
||||||
.B \fBSYNOPSIS\fP
|
|
||||||
\fBgramps\fP [\fB\-?\fP | \fB\-\-help\fP] [\fB\-\-usage\fP] [\fB\-\-version\fP]
|
|
||||||
[\fB\-l\fP] [\fB\-L\fP] [\fB\-u\fP | \fB\-\-force\-unlock\fP] [\fB\-O\fP | \fB\-\-open=\fP \fIDATABASE\fP
|
|
||||||
[\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP] [\fB\-i\fP | \fB\-\-import=\fP \fIFILE\fP
|
|
||||||
[\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP]] [\fB\-\-remove=\fP \fIFAMILY_TREE_PATTERN\fP]
|
|
||||||
[\fB\-e\fP | \fB\-\-export=\fP \fIFILE\fP [\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP]]
|
|
||||||
[\fB\-a\fP | \fB\-\-action=\fP \fIACTION\fP] [\fI\-p\fP | \fB\-\-options=\fP \fIOPTION‐
|
|
||||||
STRING\fP]] [\fIFILE\fP] [\fB\-\-version\fP]
|
|
||||||
.TP
|
|
||||||
.B \fBDESCRIPTION\fP
|
|
||||||
Gramps is a Free/OpenSource genealogy program. It is written in Python,
|
|
||||||
using the GTK+/GNOME interface. Gramps should seem familiar to anyone
|
|
||||||
who has used other genealogy programs before such as Family Tree Maker
|
|
||||||
(TM), Personal Ancestral Files (TM), or the GNU Geneweb. It supports
|
|
||||||
importing of the ever popular GEDCOM format which is used world wide by
|
|
||||||
almost all other genealogy software.
|
|
||||||
.TP
|
|
||||||
.B \fBOPTIONS\fP
|
|
||||||
.INDENT 7.0
|
|
||||||
.TP
|
|
||||||
.B \fBgramps\fP \fIFILE\fP
|
.B \fBgramps\fP \fIFILE\fP
|
||||||
When \fIFILE\fP is given (without any flags) as a family tree name or
|
When \fIFILE\fP is given (without any flags) as a family tree name or as a
|
||||||
as a family tree database directory, then it is opened and an
|
family tree database directory, then it is opened and an interactive
|
||||||
interactive session is started. If \fIFILE\fP is a file format under‐
|
session is started.
|
||||||
stood by Gramps, an empty family tree is created whose name is
|
If \fIFILE\fP is a file format understood by Gramps, an empty family tree is
|
||||||
based on the \fIFILE\fP name and the data is imported into it. The
|
created whose name is based on the \fIFILE\fP name, and the data is imported
|
||||||
rest of the options is ignored. This way of launching is suit‐
|
into it.
|
||||||
able for using gramps as a handler for genealogical data in e.g.
|
Any other options are ignored.
|
||||||
web browsers. This invocation can accept any data format native
|
This way of launching is suitable for using gramps as a handler for
|
||||||
to gramps, see below.
|
genealogical data in e.g. web browsers.
|
||||||
|
This invocation can accept any data format native to gramps; see below.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-f\fP , \fB\-\-format=\fP \fIFORMAT\fP
|
.B \fB\-f\fP, \fB\-\-format\fP=\fIFORMAT\fP
|
||||||
Explicitly specify format of \fIFILE\fP given by preceding \fB\-i\fP ,
|
Explicitly specify format of \fIFILE\fP given by preceding \fB\-i\fP or \fB\-e\fP
|
||||||
or \fB\-e\fP option. If the \fB\-f\fP option is not given for any
|
option.
|
||||||
\fIFILE\fP , the format of that file is guessed according to its extension
|
If the \fB\-f\fP option is not given for any \fIFILE\fP, the format of that file
|
||||||
or MIME\-type.
|
is guessed according to its extension or MIME type.
|
||||||
.sp
|
.sp
|
||||||
Formats available for export are \fBgramps\-xml\fP (guessed if \fIFILE\fP
|
Formats available for export are \fBgramps\-xml\fP (guessed if \fIFILE\fP ends
|
||||||
ends with \fB\&.gramps\fP ), \fBgedcom\fP (guessed if \fIFILE\fP ends with
|
with \fI\&.gramps\fP), \fBgedcom\fP (guessed if \fIFILE\fP ends with \fI\&.ged\fP), or any
|
||||||
\fB\&.ged\fP ), or any file export available through the Gramps plugin
|
file export available through the Gramps plugin system.
|
||||||
system.
|
|
||||||
.sp
|
.sp
|
||||||
Formats available for import are \fBgramps\-xml\fP , \fBgedcom\fP ,
|
Formats available for import are \fBgramps\-xml\fP, \fBgedcom\fP, \fBgramps\-pkg\fP
|
||||||
\fBgramps\-pkg\fP (guessed if \fIFILE\fP ends with \fB\&.gpkg\fP ),
|
(guessed if \fIFILE\fP ends with \fI\&.gpkg\fP), and \fBgeneweb\fP (guessed if \fIFILE\fP
|
||||||
and \fBgeneweb\fP (guessed if \fIFILE\fP ends with \fB\&.gw\fP ).
|
ends with \fI\&.gw\fP).
|
||||||
.sp
|
.sp
|
||||||
Formats available for export are \fBgramps\-xml\fP , \fBgedcom\fP ,
|
Formats available for export are \fBgramps\-xml\fP, \fBgedcom\fP,
|
||||||
\fBgramps\-pkg\fP , \fBwft\fP (guessed if \fIFILE\fP ends with \fB\&.wft\fP ),
|
\fBgramps\-pkg\fP, \fBwft\fP (guessed if \fIFILE\fP ends with \fI\&.wft\fP),
|
||||||
\fBgeneweb\fP\&.
|
\fBgeneweb\fP\&.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-l\fP
|
.B \fB\-l\fP
|
||||||
@ -94,209 +95,260 @@ Print a list of known family trees.
|
|||||||
.B \fB\-L\fP
|
.B \fB\-L\fP
|
||||||
Print a detailed list of known family trees.
|
Print a detailed list of known family trees.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-u\fP , \fB\-\-force\-unlock\fP
|
.B \fB\-u\fP, \fB\-\-force\-unlock\fP
|
||||||
Unlock a locked database.
|
Unlock a locked database.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-O\fP , \fB\-\-open=\fP \fIDATABASE\fP
|
.B \fB\-O\fP, \fB\-\-open\fP=\fIDATABASE\fP
|
||||||
Open \fIDATABASE\fP which must be an existing database directory or
|
Open \fIDATABASE\fP which must be an existing database directory or existing
|
||||||
existing family tree name. If no action, import or export
|
family tree name.
|
||||||
options are given on the command line then an interactive ses‐
|
If no action, import, or export options are given on the command line, then
|
||||||
sion is started using that database.
|
an interactive session is started using that database.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-i\fP , \fB\-\-import=\fP \fIFILE\fP
|
.B \fB\-i\fP, \fB\-\-import\fP=\fIFILE\fP
|
||||||
Import data from \fIFILE\fP . If you haven\(aqt specified a database, then
|
Import data from \fIFILE\fP\&.
|
||||||
an empty database is created for you called Family Tree x
|
If no database was specified, then an empty database is created
|
||||||
(where x is an incrementing number).
|
called Family Tree \fIx\fP (where \fIx\fP is an incrementing number).
|
||||||
.sp
|
.sp
|
||||||
When more than one input file is given, each has to be preceded
|
When more than one input file is given,
|
||||||
by \fB\-i\fP flag. The files are imported in the specified order, i.e.
|
each has to be preceded by a \fB\-i\fP flag.
|
||||||
\fB\-i\fP \fIFILE1\fP \fB\-i\fP \fIFILE2\fP and \fB\-i\fP \fIFILE2\fP \fB\-i\fP \fIFILE1\fP
|
The files are imported in the specified order, e.g.,
|
||||||
|
\fB\-i\fP \fIFILE1\fP \fB\-i\fP \fIFILE2\fP
|
||||||
|
and
|
||||||
|
\fB\-i\fP \fIFILE2\fP \fB\-i\fP \fIFILE1\fP
|
||||||
might produce different gramps IDs in the resulting database.
|
might produce different gramps IDs in the resulting database.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-e\fP , \fB\-\-export=\fP \fIFILE\fP
|
.B \fB\-e\fP, \fB\-\-export\fP=\fIFILE\fP
|
||||||
Export data into \fIFILE\fP . For \fBgramps\-xml\fP , \fBgedcom\fP
|
Export data into \fIFILE\fP\&.
|
||||||
, \fBwft\fP , \fBgramps\-pkg\fP , and \fBgeneweb\fP , the \fIFILE\fP is the
|
For \fBgramps\-xml\fP, \fBgedcom\fP, \fBwft\fP, \fBgramps\-pkg\fP, and \fBgeneweb\fP,
|
||||||
name of the resulting file.
|
the \fIFILE\fP is the name of the resulting file.
|
||||||
.sp
|
.sp
|
||||||
When more than one output file is given, each has to be preceded
|
When more than one output file is given,
|
||||||
by \fB\-e\fP flag. The files are written one by one, in the specified order.
|
each has to be preceded by a \fB\-e\fP flag.
|
||||||
|
The files are written one by one, in the specified order.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-a\fP , \fB\-\-action=\fP \fIACTION\fP
|
.B \fB\-a\fP, \fB\-\-action\fP=\fIACTION\fP
|
||||||
Perform \fIACTION\fP on the imported data. This is done after all
|
Perform \fIACTION\fP on the imported data.
|
||||||
imports are successfully completed. Currently available actions
|
This is done after all imports are successfully completed.
|
||||||
are \fBsummary\fP (same as Reports\->View\->Summary), \fBcheck\fP (same as
|
Currently available actions are \fBsummary\fP (same as
|
||||||
Tools\->Database Processing\->Check and Repair), \fBreport\fP (generates
|
Reports→View→Summary), \fBcheck\fP (same as Tools→Database
|
||||||
report), and tool (runs a plugin tool). Both \fBreport\fP and \fBtool\fP
|
Processing→Check and Repair), \fBreport\fP (generates report), and tool
|
||||||
need the \fIOPTIONSTRING\fP supplied by the \fB\-p\fP flag).
|
(runs a plugin tool).
|
||||||
|
Both \fBreport\fP and \fBtool\fP need the \fIOPTION\-STRING\fP supplied by the
|
||||||
|
\fB\-p\fP flag).
|
||||||
.sp
|
.sp
|
||||||
The \fIOPTIONSTRING\fP should satisfy the following conditions:
|
The \fIOPTION\-STRING\fP should satisfy the following conditions:
|
||||||
It must not contain any spaces. If some arguments need to
|
.INDENT 7.0
|
||||||
include spaces, the string should be enclosed with quotation
|
.IP \(bu 2
|
||||||
marks, i.e., follow the shell syntax. Option string is a list
|
It should not contain any spaces.
|
||||||
of pairs with name and value (separated by the equality sign).
|
.IP \(bu 2
|
||||||
|
If some arguments need to include spaces, the string should be enclosed
|
||||||
|
with quotation marks, following shell syntax.
|
||||||
|
.IP \(bu 2
|
||||||
|
The option string is a list of pairs with name and value (separated by an
|
||||||
|
equals sign).
|
||||||
|
.IP \(bu 2
|
||||||
The name and value pairs must be separated by commas.
|
The name and value pairs must be separated by commas.
|
||||||
.sp
|
|
||||||
Most of the report or tools options are specific for each report
|
|
||||||
or tool. However, there are some common options.
|
|
||||||
.sp
|
|
||||||
\fBname=name\fP
|
|
||||||
This mandatory option determines which report or tool will be
|
|
||||||
run. If the supplied name does not correspond to any available
|
|
||||||
report or tool, an error message will be printed followed by the
|
|
||||||
list of available reports or tools (depending on the \fIACTION\fP ).
|
|
||||||
.sp
|
|
||||||
\fBshow=all\fP
|
|
||||||
This will produce the list of names for all options available
|
|
||||||
for a given report or tool.
|
|
||||||
.sp
|
|
||||||
\fBshow=optionname\fP
|
|
||||||
This will print the description of the functionality supplied by
|
|
||||||
\fIoptionname\fP, as well as what are the acceptable types and values
|
|
||||||
for this option.
|
|
||||||
.sp
|
|
||||||
Use the above options to find out everything about a given
|
|
||||||
report.
|
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
When more than one output action is given, each has to be preceded by
|
Most of the report or tools options are specific for each report or tool.
|
||||||
\fB\-a\fP flag. The actions are performed one by one, in the specified order.
|
However, there are some common options.
|
||||||
.INDENT 7.0
|
.INDENT 7.0
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-d\fP , \fB\-\-debug=\fP \fILOGGER_NAME\fP
|
.B \fBname\fP=\fIname\fP
|
||||||
Enables debug logs for development and testing. Look at the
|
This mandatory option determines which report or tool will be run.
|
||||||
source code for details
|
If the supplied \fIname\fP does not correspond to any available report or
|
||||||
|
tool, an error message will be printed followed by the list of
|
||||||
|
available reports or tools (depending on the \fIACTION\fP).
|
||||||
|
.TP
|
||||||
|
.B \fBshow\fP=\fBall\fP
|
||||||
|
This will produce the list of names for all options available for a
|
||||||
|
given report or tool.
|
||||||
|
.TP
|
||||||
|
.B \fBshow\fP=\fIoptionname\fP
|
||||||
|
This will print the description of the functionality supplied by
|
||||||
|
\fIoptionname\fP, as well as what are the acceptable types and values for
|
||||||
|
this option.
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
Use the above options to find out everything about a given report.
|
||||||
|
.sp
|
||||||
|
When more than one output action is given, each has to be preceded by a
|
||||||
|
\fB\-a\fP flag.
|
||||||
|
The actions are performed one by one, in the specified order.
|
||||||
|
.TP
|
||||||
|
.B \fB\-d\fP, \fB\-\-debug\fP=\fILOGGER_NAME\fP
|
||||||
|
Enable debug logs for development and testing.
|
||||||
|
Look at the source code for details.
|
||||||
.TP
|
.TP
|
||||||
.B \fB\-\-version\fP
|
.B \fB\-\-version\fP
|
||||||
Prints the version number of gramps and then exits
|
Print the version number of gramps and then exits.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.TP
|
.SH OPERATION
|
||||||
.B \fBOperation\fP
|
|
||||||
If the first argument on the command line does not start with dash
|
|
||||||
(i.e. no flag), gramps will attempt to open the file with the name
|
|
||||||
given by the first argument and start interactive session, ignoring the
|
|
||||||
rest of the command line arguments.
|
|
||||||
.sp
|
.sp
|
||||||
If the \fB\-O\fP flag is given, then gramps will try opening the supplied
|
If the first argument on the command line does not start with dash (i.e., no
|
||||||
database and then work with that data, as instructed by the further
|
flag), gramps will attempt to open the file with the name given by the first
|
||||||
command line parameters.
|
argument and start an interactive session, ignoring the rest of the command line
|
||||||
|
arguments.
|
||||||
.sp
|
.sp
|
||||||
With or without the \fB\-O\fP flag, there could be multiple imports, exports,
|
If the \fB\-O\fP flag is given, then gramps will try opening the supplied database
|
||||||
and actions specified further on the command line by using \fB\-i\fP ,
|
and then work with that data, as instructed by the further command line
|
||||||
\fB\-e\fP , and \fB\-a\fP flags.
|
parameters.
|
||||||
.sp
|
.sp
|
||||||
The order of \fB\-i\fP , \fB\-e\fP , or \fB\-a\fP options does not matter. The actual order
|
With or without the \fB\-O\fP flag, further imports, exports, and actions may be
|
||||||
always is: all imports (if any) \-> all actions (if any) \-> all exports
|
specified on the command line by using \fB\-i\fP, \fB\-e\fP, and
|
||||||
(if any). But opening must always be first!
|
\fB\-a\fP flags.
|
||||||
.sp
|
.sp
|
||||||
If no \fB\-O\fP or \fB\-i\fP option is given, gramps will launch its main window and
|
The order of \fB\-i\fP, \fB\-e\fP, or \fB\-a\fP options does not matter.
|
||||||
start the usual interactive session with the empty database, since
|
The actual order they are processed always is:
|
||||||
there is no data to process, anyway.
|
all imports (if any) → all actions (if any) → all exports (if any).
|
||||||
|
But opening must always be first!
|
||||||
.sp
|
.sp
|
||||||
If no \fB\-e\fP or \fB\-a\fP options are given, gramps will launch its main window
|
If no \fB\-O\fP or \fB\-i\fP option is given,
|
||||||
and start the usual interactive session with the database resulted from
|
gramps will launch its main window and start the usual interactive session with
|
||||||
all imports. This database resides in the \fBimport_db.grdb\fP under
|
an empty database, since there is no data to process anyway.
|
||||||
\fB~/.gramps/import\fP directory.
|
|
||||||
.sp
|
.sp
|
||||||
The error encountered during import, export, or action, will be either
|
If no \fB\-e\fP or \fB\-a\fP options are given,
|
||||||
dumped to stdout (if these are exceptions handled by gramps) or to
|
gramps will launch its main window and start the usual interactive session with
|
||||||
\fIstderr\fP (if these are not handled). Use usual shell redirections of
|
the database resulting from all imports.
|
||||||
\fIstdout\fP and \fIstderr\fP to save messages and errors in files.
|
This database resides in the \fIimport_db.grdb\fP under the \fI~/.gramps/import\fP
|
||||||
.TP
|
directory.
|
||||||
.B \fBEXAMPLES\fP
|
.sp
|
||||||
To open an existing family tree and import an xml file into it, one
|
Any errors encountered during import, export, or action
|
||||||
may type:
|
will be dumped either to \fIstdout\fP (if these are exceptions handled by gramps)
|
||||||
.INDENT 7.0
|
or to \fIstderr\fP (if these are not handled).
|
||||||
|
Use usual shell redirections of \fIstdout\fP and \fIstderr\fP to save messages and
|
||||||
|
errors to files.
|
||||||
|
.SH EXAMPLES
|
||||||
|
.sp
|
||||||
|
To open an existing family tree and import an xml file into it, one may type:
|
||||||
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-O\fP \fI\(aqMy Family Tree\(aq\fP \fB\-i\fP \fI~/db3.gramps\fP
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-O \(aqMy Family Tree\(aq \-i ~/db3.gramps
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
The above changes the opened family tree, to do the same, but import
|
The above changes the opened family tree. To do the same, but import both in a
|
||||||
both in a temporary family tree and start an interactive session, one
|
temporary family tree and start an interactive session, one may type:
|
||||||
may type:
|
.INDENT 0.0
|
||||||
.INDENT 7.0
|
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-i\fP \fI\(aqMy Family Tree\(aq\fP \fB\-i\fP \fI~/db3.gramps\fP
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-i \(aqMy Family Tree\(aq \-i ~/db3.gramps
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
To import four databases (whose formats can be determined from their
|
To import four databases (whose formats can be determined from their names) and
|
||||||
names) and then check the resulting database for errors, one may type:
|
then check the resulting database for errors, one may type:
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-i\fP \fI~/db3.gramps\fP
|
.sp
|
||||||
\fB\-i\fP \fIfile4.wft\fP \fB\-a\fP \fIcheck\fP
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-i file1.ged \-i file2.tgz \-i ~/db3.gramps \-i file4.wft \-a check
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
To explicitly specify the formats in the above example, append file‐
|
To explicitly specify the formats in the above example, append filenames with
|
||||||
names with appropriate \fB\-f\fP options:
|
appropriate \fB\-f\fP options:
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-f\fP \fIgedcom\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-f\fP
|
.sp
|
||||||
\fIgramps\-pkg\fP \fB\-i\fP \fI~/db3.gramps\fP \fB\-f\fP \fIgramps\-xml\fP \fB\-i\fP \fIfile4.wft\fP
|
.nf
|
||||||
\fB\-f\fP \fIwft\fP \fB\-a\fP \fIcheck\fP
|
.ft C
|
||||||
|
gramps \-i file1.ged \-f gedcom \-i file2.tgz \-f gramps\-pkg \e
|
||||||
|
\-i ~/db3.gramps \-f gramps\-xml \-i file4.wft \-f wft \-a check
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
To record the database resulting from all imports, supply \fB\-e\fP flag (use
|
To record the database resulting from all imports, supply a \fB\-e\fP flag (use
|
||||||
\fB\-f\fP if the filename does not allow gramps to guess the format):
|
\fB\-f\fP if the filename does not allow gramps to guess the format):
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-e\fP \fI~/new\-package\fP
|
.sp
|
||||||
\fB\-f\fP \fIgramps\-pkg\fP
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-i file1.ged \-i file2.tgz \-e ~/new\-package \-f gramps\-pkg
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
To import three databases and start interactive gramps session with the
|
To import three databases and start an interactive gramps session with the
|
||||||
result:
|
result:
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-i\fP \fI~/db3.gramps\fP
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-i file1.ged \-i file2.tgz \-i ~/db3.gramps
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
To run the Verify tool from the commandline and output the result to
|
To run the Verify tool from the commandline and output the result to
|
||||||
stdout:
|
\fIstdout\fP:
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps \-O\fP \fI\(aqMy Family Tree\(aq\fP \fB\-a\fP \fItool\fP \fB\-p name=\fP \fIverify\fP
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps \-O \(aqMy Family Tree\(aq \-a tool \-p name= verify
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
Finally, to start normal interactive session type:
|
Finally, to start a normal interactive session type:
|
||||||
.INDENT 7.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fBgramps\fP
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
gramps
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.TP
|
.SH ENVIRONMENT VARIABLES
|
||||||
.B \fBENVIRONMENT VARIABLES\fP
|
.sp
|
||||||
The program checks whether these environment variables are set:
|
The program checks whether these environment variables are set:
|
||||||
.sp
|
.INDENT 0.0
|
||||||
\fBLANG\fP \- describe, which language to use: Ex.: for polish language this
|
.TP
|
||||||
variable has to be set to pl_PL.UTF\-8.
|
.B \fBLANG\fP
|
||||||
.sp
|
Describe which language to use.
|
||||||
\fBGRAMPSHOME\fP \- if set, force Gramps to use the specified directory to
|
E.g., for the Polish language this variable has to be set to \fIpl_PL.UTF\-8\fP\&.
|
||||||
keep program settings and databases there. By default, this variable is
|
.TP
|
||||||
not set and gramps assumes that the folder with all databases and pro‐
|
.B \fBGRAMPSHOME\fP
|
||||||
file settings should be created within the user profile folder
|
Force Gramps to use the specified directory to keep program
|
||||||
(described by environment variable HOME for Linux or USERPROFILE for
|
settings and databases in.
|
||||||
Windows 2000/XP).
|
By default, this variable is not set and gramps assumes that the folder
|
||||||
|
with all databases and profile settings should be created within the user
|
||||||
|
profile folder (described by environment variable \fIHOME\fP for Linux or
|
||||||
|
\fIUSERPROFILE\fP for Windows 2000/XP).
|
||||||
.TP
|
.TP
|
||||||
.B \fBCONCEPTS\fP
|
.B \fBCONCEPTS\fP
|
||||||
Supports a python\-based plugin system, allowing import and export writ‐
|
Supports a python\-based plugin system, allowing import and export writers,
|
||||||
ers, report generators, tools, and display filters to be added without
|
report generators, tools, and display filters to be added without
|
||||||
modification of the main program.
|
modification of the main program.
|
||||||
.sp
|
.sp
|
||||||
In addition to generating direct printer output, report generators also
|
In addition to generating direct printer output, report generators also
|
||||||
target other systems, such as \fILibreOffice.org\fP , \fIAbiWord\fP , \fIHTML\fP,
|
target other output formats, such as \fILibreOffice\fP, \fIAbiWord\fP, \fIHTML\fP, or
|
||||||
or \fILaTeX\fP to allow the users to modify the format to suit their needs.
|
\fILaTeX\fP to allow the users to modify the format to suit their needs.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.SH FILES
|
||||||
\fBKNOWN BUGS AND LIMITATIONS\fP
|
|
||||||
.sp
|
|
||||||
\fBFILES\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
\fI${PREFIX}/bin/gramps\fP
|
\fI${PREFIX}/bin/gramps\fP
|
||||||
@ -308,11 +360,10 @@ or \fILaTeX\fP to allow the users to modify the format to suit their needs.
|
|||||||
\fI${HOME}/.gramps\fP
|
\fI${HOME}/.gramps\fP
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.SH AUTHORS
|
||||||
.TP
|
.sp
|
||||||
.B \fBAUTHORS\fP
|
|
||||||
Donald Allingham <\fI\%don@gramps\-project.org\fP>
|
Donald Allingham <\fI\%don@gramps\-project.org\fP>
|
||||||
\fI\%http://gramps\-project.org/\fP
|
\fI\%https://www.gramps\-project.org/\fP
|
||||||
.sp
|
.sp
|
||||||
This man page was originally written by:
|
This man page was originally written by:
|
||||||
Brandon L. Griffith <\fI\%brandon@debian.org\fP>
|
Brandon L. Griffith <\fI\%brandon@debian.org\fP>
|
||||||
@ -320,16 +371,13 @@ for inclusion in the Debian GNU/Linux system.
|
|||||||
.sp
|
.sp
|
||||||
This man page is currently maintained by:
|
This man page is currently maintained by:
|
||||||
Gramps project <\fI\%xxx@gramps\-project.org\fP>
|
Gramps project <\fI\%xxx@gramps\-project.org\fP>
|
||||||
.TP
|
.SH DOCUMENTATION
|
||||||
.B \fBDOCUMENTATION\fP
|
.sp
|
||||||
The user documentation is available through standard web browser
|
The user documentation is available through a web browser in the form of the
|
||||||
in the form of Gramps Manual.
|
Gramps Manual.
|
||||||
.sp
|
.sp
|
||||||
The developer documentation can be found on the
|
The developer documentation can be found on the
|
||||||
\fI\%http://www.gramps\-project.org/wiki/index.php?title=Portal:Developers\fP
|
\fI\%https://www.gramps\-project.org/wiki/index.php/Portal:Developers\fP
|
||||||
portal.
|
portal.
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
gramps(1) @VERSION@ gramps(1)
|
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user