Annexe D. Références en ligne de commande

Table des matières

Options disponibles

Options de format
Options d'ouverture
Options d'importation
Options d'exportation
Options d'action

Opération

Exemples

Cette annexe décrit les possibilités offertes par GRAMPS en ligne de commande, depuis un terminal.

	Note
GRAMPS 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!

Note

GRAMPS 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!

	Astuce
	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 GRAMPS. Si vous voulez connaître plus d'options, voir la section intitulée « Opération » et la section intitulée « Exemples ».

Options de format

Le format des fichiers de lecture ou d'écriture est donné par l'option -f format Les valeurs acceptables format sont énumérées ci-dessous.

grdb: Base de données de GRAMPS.Ce format est prêt à l'ouverture, à l'importation, et à l'exportation. Une fois indiqué, il peut deviner si le fichier porte l'extension grdb
gramps-xml: Base de données de GRAMPS. Ce format est prêt à l'ouverture, à l'importation, et à l'exportation. Une fois indiqué, il peut deviner si le fichier représente un nom de fichier gramps
gedcom: Fichier GEDCOM.Ce format est prêt à l'ouverture, à l'importation, et à l'exportation. Une fois indiqué, il peut deviner si le fichier porte l'extension ged
gramps-pkg: Paquet de GRAMPS.Ce format est prêt à l'importation et à l'exportation. Une fois indiqué, il peut deviner si le fichier porte l'extension tgz
geneweb: Le fichier GeneWeb. Ce format est prêt à l'importation et à l'exportation. Une fois indiqué, il peut deviner si le fichier porte l'extension gw
wft: Web Family Tree. Ce format est prêt à l'exportation seulement. Une fois indiqué, il peut deviner si le fichier porte l'extension wft
iso: Image de CD. Ce format est prêt à l'exportation seulement. Il doit toujours être indiquer explicitement.

Options d'ouverture

Il y a deux manières de donner à GRAMPS le nom du fichier à ouvrir:

chemin du fichier
utiliser -O nom du fichier ou -open=nom du fichier

Si le nom du fichier est donné sans options, GRAMPS ouvrira sa fenêtre principale et commencera une session.

	Astuce
	Si aucune option n'est donnée, juste le nom de fichier, GRAMPS ignorera le reste des arguments de ligne de commande. Employer -o pour ouvrir le fichier et pour faire quelque chose avec les données.

Le format peut être indiqué avec l'option -f format ou --format=format juste après le nom du fichier. Pour le format gramps-xml,nom de fichier est réellement le nom du répertoire sous lequel la base de données de gramps réside. Pour le grdb et le gedcom, le nom de fichier est le nom du fichier correspondant.

	Astuce
	Seulement grdb, gramps-xml, et les formats gedcom peuvent être ouverts directement. Pour d'autres formats, vous devrez employer l'option d'importation qui installera la base de données vide puis importera des données.

	Astuce
	Seulement un fichier simple peut être ouvert. Si vous devez combiner des données depuis plusieurs sources, vous devrez employer l'option d'importation.

Options d'importation

Les dossiers destinés à l'importation peuvent être indiqués avec -i nom du fichier ou --import=nom du fichier Le format peut être indiqué avec l'option -f format ou --format=format juste aprèsnom de fichier. Pour le format gramps-xml,le nom du fichier est réellement le nom du répertoire sous lequel la base de données de gramps réside. Pour grdb, gedcom, gramps-pkg, et geneweb, le nom du fichier est le nom du fichier correspondant.

	Astuce
	Plus d'un fichier peut être importé dans une commande. Si c'est le cas, GRAMPS incorporera les données à partir du prochain fichier à la base de données disponible à l'heure actuelle.

Quand plus d'un dossier d'entrée est donné, chacun doit être par précédé de-iLes dossiers sont importés dans l'ordre indiqué, c.-à-d.. -i fichier1 -i fichier2 and -i fichier2 -i fichier1 pourraient produire différentes versions dans la base de données résultant.

Options d'exportation

Les dossiers destinés à l'exportation peuvent être indiqués avec -o nom du fichier ou --output=nom du fichier Le format peut être indiqué avec l'option -f juste après le nom du fichier. Pour gramps-xml et les formats iso, nom du fichier est réellement le nom du répertoire la base de données de gramps. Pour grdb, gedcom, wft, geneweb, et gramps-pkg,le nom du fichier est le nom du dossier résultant.

	Astuce
	Plus d'un fichier peut être exporté dans une commande. Si c'est le cas, GRAMPS essayera d'écrire plusieurs fichiers en utilisant les données de la base de données disponible à l'heure actuelle.

Quand plus d'un fichier est donné, chacun doit être par précédé par -o Les dossiers sont écrits dans l'ordre indiqué.

Options d'action

L'action à exécuter sur les données importées peut être indiquée avec -a action ou --action=action Ceci est fait après que toutes les importations soient accomplies avec succès.

Les actions actuellement disponibles sont:

résumé

Cette action est identique à Rapports → Vue → Sommaire

contrôle

Cette action est identique à Outils → Traitement de la Base de données → contrôle et réparation.

rapport

Cette action laisse produire des rapports à partir de la ligne de commande. Car les rapports ont généralement beaucoup d'options propres, cette action devrait être suivie de la chaîne d'option du rapport. La chaîne est donnée en utilisant -p option_string ou --options=option_string.

Astuce

La chaîne d'option de rapport devrait satisfaire les conditions suivantes:

Elle ne doit contenir aucun espaces. Si quelques arguments doivent inclure les espaces, la chaîne devrait être enfermée avec des guillemets.
La chaîne d'option doit lister des paires de nom et valeur.
La chaîne d'option doit énumérer une paire de nom et de valeur séparée par le signe égal.
Différentes paires doivent être séparées par des virgules.

La plupart des options de rapport sont spécifiques pour chaque rapport. Cependant, il y a quelques options communes.

name=report_name: Cette option obligatoire détermine quel rapport sera produit. Si le report_name ne correspond à aucun rapport disponible, le message d'erreur sera affiché à la suite de la liste de rapports disponibles.
show=all: Ceci affichera la liste de noms pour toutes les options disponibles pour un rapport présenté.
show=option_name: Ceci affichera la description de la fonctionnalité assurée par l'option_name, pour les types et les valeurs acceptables pour cette option.

Employez les options ci-dessus pour découvrir tout au sujet d'un rapport présenté.

	Astuce
	Si une option n'est pas assurée, la dernière valeur utilisée sera employée. Si ce rapport n'a jamais été produit avant, alors la valeur du dernier rapport produit sera employée comme applicable. Autrement, la valeur par défaut sera employée.

Quand plus d'une action à produire est donnée, chacunes doivent être par précédé-a . Les actions sont effectuées dans l'ordre indiqué.


Filtres divers		Opération