Provided by: gramps_3.1.2-1.1_all bug

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]

DESCRIPTION

       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 DENVIRONMENT
       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.