NOM
gramps - Gramps est une application de généalogie. Gramps est
l’acronyme de Genealogical Research and Analysis Management Programming
System (Systeme de Programmation pour Recherche, Analyse et Gestion de
données généalogiques)
SYNOPSIS
gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock]
[-O|--open= BASE_DE_DONNEES [-f|--format= FORMAT]] [-i|--import=
FICHIER [-f|--format= FORMAT]] [-i|--import= ...] [-e|--export=
FICHIER [-f|--format= FORMAT]] [-a|--action= ACTION] [-p|--options=
OPTION]] [ FICHIER ] [--version]
Gramps est un programme Libre/OpenSource de généalogie. Il est écrit en
python, et utilise une interface GTK+/GNOME. Gramps est semblable à
d’autres programmes de généalogie tel que Family Tree Maker (FTM),
Personal Ancestral Files, ou le programme GNU Geneweb. Il peut
importer/exporter le format le plus utilisé par les autres logiciels de
généalogie : GEDCOM.
OPTIONS
gramps FICHIER
Si FICHIER est désigné (sans autres commandes) comme arbre
familial ou comme répertoire d’arbre familial, alors une session
interactive est ouverte. Si FICHIER est un format de fichier
supporté par Gramps, une base vide est créée dont le nom est
celui du FICHIER et les données y seront importées. Les autres
options sont ignorées. Ce type de lancement permet d’utiliser
gramps pour manipuler des données comme dans un navigateur web.
Les formats natifs de gramps sont acceptés, voir ci-dessous.
-f,--format= FORMAT
Le format spécifique du FICHIER est précédé par les arguments
-i, ou -e. Si l’option -f n’est pas donnée pour le FICHIER,
alors le format sera celui de l’extension ou du type-MIME.
Les formats de sortie disponibles sont gramps-xml (deviné si
FICHIER se termine par .gramps), et gedcom (deviné si FICHIER se
termine par .ged), ou tout autre fichier d’exportation
disponible dans le système de plugin Gramps.
Les formats disponibles pour l’importation sont grdb,
gramps-xml, gedcom, gramps-pkg (deviné si FICHIER se termine par
.gpkg), et geneweb (deviné si FICHIER se termine par .gw).
Les formats disponibles pour l’exportation sont gramps-xml,
gedcom, gramps-pkg, wft (deviné si FICHIER se termine par .wft),
geneweb, et iso (jamais deviné, toujours spécifié avec l’option
-f).
-l Imprime une liste des arbres familiaux disponibles.
-u,--force-unlock
Débloquer une base de données verrouillée.
-O,--open= BASE_DE_DONNEES
Ouvrir une BASE_DE_DONNEES qui doit être une base présente dans
le répertoire des bases ou le nom d’un arbre familial existant.
Si aucune action n’est définie, les options d’import ou d’export
sont données par la ligne de commande puis une session
interactive est ouverte, utilisant cette base de données.
Seulement une base peut être ouverte. Si vous utilisez plusieurs
sources, vous devez utiliser l’option d’import.
-i,--import= FICHIER
Importer des données depuis un FICHIER. Si vous n’avez pas
spécifié de base de données alors une base de données temporaire
est utilisée; elle sera effacée quand vous quitterez gramps.
Quand plus d’un fichier doit être importé, chacun doit être
précédé par la commande -i. Ces fichiers sont importés dans le
même ordre, i.e. -i FICHIER1 -i FICHIER2 et -i FICHIER2 -i
FICHIER1 vont tous les deux produire différents IDs gramps.
-e,--export= FICHIER
Exporter des données dans un FICHIER. Pour le format iso, le
FICHIER est le nom du répertoire dans lequel la base de données
gramps est écrite. Pour gramps-xml, gedcom, wft, gramps-pkg, et
geneweb, le FICHIER est le nom du fichier de sortie
Quand plus d’un fichier doit être exporté, chacun doit être
précédé par la commande -e. Ces fichiers sont importés dans le
même ordre.
-a,--action= ACTION
Accomplir une ACTION sur les données importées. C’est effectué à
la fin de l’importation. Les actions possibles sont summary
(comme le rapport -> Afficher -> Statistiques sur la base),
check (comme l’outil -> Réparation de la base -> Vérifier et
réparer), report (produit un rapport) et tool (utilise un
outil), ces derniers ont besoin de OPTION précédé par la
commande -p.
L’OPTION doit satisfaire ces conditions:
Il ne doit pas y avoir d’espace. Si certains arguments doivent
utiliser des espaces, la chaîne doit être encadrée par des
guillemets. Les options vont par paire nom et valeur. Une
paire est séparée par un signe égal. Différentes paires sont
séparées par une virgule.
La plupart des options sont spécifiques à chaque rapport. Même
s’il existe des options communes.
name=name
Cette option est obligatoire, elle détermine quel rapport ou
outil sera utilisé. Si le name saisi ne correspond à aucun
module disponible, un message d’erreur sera ajouté.
show=all
Cette option produit une liste avec les noms des options
disponibles pour un rapport donné.
show=optionname
Cette option affiche une description de toutes les
fonctionnalités proposées par optionname, aussi bien les types
que les valeurs pour une option.
Utiliser les options ci-dessus pour trouver tout sur un rapport
choisi.
Quand plus d’une action doit être effectuée, chacune doit être précédée
par la commande -a. Les actions seront réalisées une à une, dans
l’ordre spécifié.
-d,--debug= NOM_LOGGER
Permet les logs de debug pour le développement et les tests.
Regarder le code source pour les détails.
--version
Imprime le numéro de version pour gramps puis quitte.
Operation
Si le premier argument de la ligne de commande ne commence pas par un
tiret (i.e. pas d’instruction), gramps va essayer d’ouvrir la base de
données avec le nom donné par le premier argument et démarrer une
session interactive, en ignorant le reste de la ligne de commande.
Si la commande -O est notée, alors gramps va essayer le fichier défini
et va travailler avec ses données, comme pour les autres paramètres de
la ligne de commande.
Avec ou sans la commande -O, il peut y avoir plusieurs imports,
exports, et actions dans la ligne de commande -i, -e, et -a.
L’ordre des options -i, -e, ou -a n’a pas de sens. L’ordre actuel est
toujours : imports -> actions -> exports. Mais l’ouverture doit
toujours être la première!
Si aucune option -O ou -i n’est donnée, gramps lancera sa propre
fenêtre et demarrera avec une base vide, puisqu’il n’y a pas données.
Si aucune option -e ou -a n’est donnée, gramps lancera sa propre
fenêtre et démarrera avec la base de données issue de tout les imports.
Cette base sera import_db.grdb sous le répertoire ~/.gramps/import.
Les erreurs rencontrées lors d’import, export, ou action, seront
mémorisées en stdout (si elles sont le fait de la manipulation par
gramps) ou en stderr (si elles ne sont pas le fait d’une manipulation).
Utilisez les shell de redirection de
stdout et stderr pour sauver les messages et les erreurs dans les
fichiers.
EXEMPLES
Pour ouvrir un arbre familial et y importer un fichier XML, on peut
saisir:
gramps -O Mon Arbre Familal -i ~/db3.gramps
Ceci ouvre un arbre familal, pour faire la même chose, mais importer
dans un arbre familial temporaire et démarrer une session interactive,
on peut saisir:
gramps -i Mon Arbre Familal -i ~/db3.gramps
Lecture de quatre bases de données dont les formats peuvent être
devinés d’après les noms, puis vérification des données:
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps -i file4.wft -a
check
Si vous voulez préciser les formats de fichiers dans l’exemple ci-
dessus, complétez les noms de fichiers par les options -f appropriées:
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
Pour enregistrer le résultat des lectures, donnez l’option -e
(utiliser -f si le nom de fichier ne permet pas à gramps de deviner le
format):
gramps -i file1.ged -i file2.tgz -e ~/new-package -f gramps-pkg
Pour lire trois ensembles de données puis lancer une session
interactive de gramps sur le tout :
gramps -i file1.ged -i file2.tgz -i ~/db3.gramps
Pour lancer l’outil de vérification de la base de données depuis la
ligne de commande et obtenir le résultat:
gramps -O file.grdb -a tool -p name=verify
Enfin, pour lancer une session interactive normale, entrer : gramps
VARIABLES D’ENVIRONMENT
Le programme vérifie si ces variables d’environnement sont déclarées:
LANG - décrit, quelle langue est utilisée: Ex.: pour le français on
peut définir fr_FR.UTF-8.
GRAMPSHOME - si défini, force Gramps à utiliser un répertoire
spécifique pour y conserver ses préférences et bases de données. Par
défaut, cette variable n’est pas active et Gramps sait que les options
et bases de données doivent être créées dans le répertoire par défaut
de l’utilisateur (la variable d’environnement HOME pour Linux ou
USERPROFILE pour Windows 2000/XP).
CONCEPTS
Gramps est un système basé sur le support de plugin-python, permettant
d’importer et d’exporter, la saisie, générer des rapports, des outils,
et afficher des filtres pouvant être ajoutés sans modifier le
programme.
Par ailleurs, gramps permet la génération directe : impression,
rapports avec sortie vers d’autres formats, comme OpenOffice.org,
AbiWord, HTML, ou LaTeX pour permettre à l’utilisateur de choisir selon
ses besoins
BUGS CONNUS ET LIMITATIONS
FICHIERS
${PREFIX}/bin/gramps
${PREFIX}/share/gramps
${HOME}/.gramps
AUTEURS
Donald Allingham <don@gramps-project.org>
http://gramps.sourceforge.net
Cette page man a d’abord été écrite par:
Brandon L. Griffith <brandon@debian.org>
pour Debian GNU/Linux système.
Cette page man est maintenue par:
Gramps project <xxx@gramps-project.org>
La traduction française:
Jérôme Rapinat <romjerome@yahoo.fr>
DOCUMENTATION
La documentation-utilisateur est disponible par le navigateur d’aide de
GNOME sous la forme du manuel Gramps. Ce manuel est également
disponible sous format XML comme gramps-manual.xml sous doc/gramps-
manual/$LANG dans les sources officielles.
La documentation pour développeur est disponible sur le site
http://developers.gramps-project.org.