# 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. Le 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`