# Manuel de r?f?rence pour l'utilisation en ligne de commande

Cette annexe d?crit les possibilit?s offertes par &app; en ligne de commande, depuis un terminal.

Notons ici que &app; est ?crit pour ?tre pilot? ? travers son interface graphique. Il ne peut pas ?tre utilis? dans un mode strictement limit? au texte. Les modifications pour le faire seraient tr?s importantes. C'est pourquoi les options de la ligne de commande ne visent pas l'ind?pendance par rapport au mode graphique. En fait, elles rendent seulement certaines t?ches fr?quentes plus commodes et ex?cutables depuis des scripts. L'affichage graphique doit cependant toujours ?tre accessible.

En r?sum?, les options de la ligne de commande fournissent un mode non-interactif mais n'affranchissent pas d'un affichage graphique. C'est comme ?? !

## Options disponibles

Voici la liste des options de lancement de &app; :

Options de format

  Le format des fichiers de lecture ou d'?criture est donn? par l'option `-f` format format est ? choisir parmi un des choix suivants :

  gramps

    &app; chemin. Ce format est disponible en lecture comme en ?criture. Il est devin? d'apr?s la nature la nature (fichier ou r?pertoire) du chemin.

  gedcom

    fichier GEDCOM. Ce format est disponible en lecture comme en ?criture. Il est devin? si le nom de fichier a comme suffixe .ged.

  gramps-pkg

    &app; package. Ce format est disponible en lecture comme en ?criture. Il est devin? si le nom de fichier a comme suffixe .tgz .

  wft

    Web Family Tree. Ce format est disponible en ?criture seulement. Il est devin? si le nom de fichier a comme suffixe .wft.

  iso

    image de CD. Ce format est disponible en ?criture seulement. Il doit toujours ?tre pr?cis? explicitement.

Options de lecture

  Les fichiers ? lire sont sp?cifi?s avec l'option `-i` chemin. Le format peut ?tre pr?cis? avec l'option `-f` imm?diatement apr?s le chemin. Si le format n'est pas pr?cis?, il sera devin? d'apr?s le chemin donn?. Pour le format

gramps
, le chemin est en fait le nom du r?pertoire dans lequel les donn?es gramps sont plac?es. Pour les formats
gedcom
et
gramps-pkg
, le chemin est le nom du fichier de donn?es.

Quand plusieurs fichiers sont ? lire, chaque nom de fichier doit ?tre pr?c?d? par une commande `-i`. Les fichiers sont lus dans l'ordre des arguments, c'est ? dire que `-i` chemin1 `-i` chemin2 et `-i` chemin2 `-i` chemin1 peuvent ne pas donner les m?mes identifications gramps dans les donn?es apr?s chargement.

Options d'?criture

  Les fichiers ? ?crire sont pr?cis?s par l'option `-o` chemin. Le format peut ?tre sp?cifi? par l'option `-f` plac?e imm?diatement apr?s le chemin. Si ce n'est pas le cas, il sera devin? d'apr?s le chemin. Pour les formats

gramps
et
iso
, le chemin est en fait le nom du r?pertoire o? seront ?crites les donn?es gramps. Pour les formats
gedcom
,
wft
, et
gramps-pkg
, le chemin est le nom du fichier ?crit.

Quand plusieurs fichiers de sortie sont pr?cis?s, chacun doit ?tre pr?c?d? par une option `-o` . Les fichiers sont ?crits un par un dans l'ordre des arguments.

Options d'action

  L'action ? ex?cuter sur les donn?es lues peut ?tre pr?cis?e avec l'option `-a` action. Ceci est fait apr?s que toutes les lectures ont ?t? faites avec succ?s. Les actions actuellement disponibles sont

summary
(comme Reports View Summary) et
check
(comme Tools Database Processing Check and Repair).

Si plusieurs actions de sorties sont donn?es, chacune doit ?tre pr?c?d?e par une option `-a`. Les actions sont ex?cut?es une par une dans l'ordre des arguments.

## Operation

L'ordre des options `-i`, `-o`, ou `-a` entre elles n'a pas de signification. L'ordre r?el d'ex?cution est toujours : les lectures (s'il y en a) puis les ?critures (s'il y en a) et enfin les actions (s'il y en a).

Si aucune option`-i` n'est donn?e, gramps ouvrira sa fen?tre principale et commencera une session interactive avec un ensemble vide de donn?es puisqu'il n'y a pas de donn?es ? traiter.

Si aucune option`-o` ou `-a` n'est donn?e, gramps ouvrira sa fen?tre principale et commencera une session interactive avec les donn?es lues. Cet ensemble de donn?es se situe dans le r?pertoire ~/.gramps/import .

Les erreurs trouv?es pendant les phases de lecture, d'?criture et d'action sont rapport?es soit sur la sortie standard quand elles sont g?r?es par gramps, soit sur la sortie d'erreur dans le cas contraire. Utilisez les redirections du shell pour les conserver dans des fichiers.

## Exemples

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` chemin1.ged `-i` chemin2.tgz `-i` ~/db3 `-i` chemin4.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` chemin1.ged `-f` gedcom `-i` chemin2.tgz `-f` gramps-pkg `-i` ~/db3 `-f` gramps `-i` chemin4.wft `-f` wft `-a` check

Pour enregistrer le r?sultat des lectures, donnez l'option `-o` (utilisez l'option `-f` si le nom de fichier ne permet pas ? gramps de deviner le format) :

`gramps -i` chemin1.ged `-i` chemin2.tgz `-o` ~/nouvel-ensemble-gramps `-f` gramps-pkg

Pour sauver les erreurs de l'exemple pr?c?dent dans les fichiers sortie et erreur, lancez :

`gramps -i` chemin1.ged `-i` chemin2.tgz `-o` ~/nouvel-ensemble-gramps `-f` gramps-pkg >sortie 2>erreur

Pour lire trois ensembles de donn?es puis lancer une session interactive de gramps sur le tout :

`gramps -i` chemin1.ged `-i` chemin2.tgz `-i` ~/db3

Enfin, pour lancer une session interactive normale, entrez :

`gramps`