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