Difference between revisions of "Fr:Manuel wiki pour Gramps 3.0 - Les lignes de commande"

From Gramps
Jump to: navigation, search
(Options disponibles)
m
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Cette annexe décrit les possibilités offertes par GRAMPS en ligne de commande, depuis un terminal.
 
Cette annexe décrit les possibilités offertes par GRAMPS en ligne de commande, depuis un terminal.
  
{{Man note| Note |GRAMPS was designed to be an interactive program. Therefore it uses graphical display and cannot run from the true non-graphical console. It would take an enormous amount of effort to enable it to run in a text-only terminal. This is why the set of command line options does not aim to completely get rid of dependency on the graphical display. Rather, it merely makes certain (typical) tasks more convenient. It also allows one to execute these tasks from the scripts. However, the graphical display must be accessible at all times!}}
+
{{Man note| 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 !}}
  
{{Man tip| Tip |To summarize, the use of the command line options provides non-interactive behavior, but does not get rid of graphical display dependency. Take it or leave it!}}
+
{{Man tip| 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 çà !}}
  
{{grampsmanualcopyright}}
+
{{grampsmanualcopyright/fr}}
 +
 
 +
{{languages|Gramps_3.0_Wiki_Manual - Command Line}}
  
{{languages|Gramps_3.0_Wiki_Manual}}
 
  
 
== Options disponibles ==
 
== Options disponibles ==
  
Voici la liste des options de lancement de GRAMPS. Si vous voulez connaître plus d'options, voir [[Gramps-command line#Opération|Opération]] et [[Gramps-command line#Exemples| Exemples]].
+
Voici la liste des options de lancement de GRAMPS. Si vous voulez connaître plus d'options, voir [[Gramps-command line/fr#Operation|Opération]] et [[Gramps-command line/fr#Examples| Exemples]].
 
=== Options de format ===
 
=== Options de format ===
  
The format of any file destined for opening, importing, or exporting can be specified with the <pre>-f format</pre> option. The acceptable <tt>''format''</tt> values are listed below.
+
Le format des fichiers de lecture ou d'écriture est donné par l'option <pre>-f format</pre> Les valeurs acceptables <tt>format</tt> sont énumérées ci-dessous.
*grdb GRAMPS database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .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 GRAMPS XML database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .gramps
+
*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 GEDCOM file: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .ged
+
*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 GRAMPS package: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gpkg
+
*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 .gpkg
*geneweb GeneWeb file: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gw
+
*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: This format is available for export only. When not specified, it can be guessed if the filename ends with .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 CD image: This format is available for export only. It must always be specified explicitly.
+
*Image de CD. Ce format est prêt à l'exportation seulement. Il doit toujours être indiquer explicitement.
  
 
=== Options d'ouverture ===
 
=== Options d'ouverture ===
Line 27: Line 28:
 
Il y a deux manières de donner à GRAMPS le nom du fichier à ouvrir :
 
Il y a deux manières de donner à GRAMPS le nom du fichier à ouvrir :
  
* supply bare file name
+
* chemin du fichier* utilisez l'option : <pre>-O nom_du_fichier</pre> ou <pre>--open=nom_du_fichier</pre>
* use this option : <pre>-O filename</pre> or <pre>--open=filename </pre>
 
  
-O, Open of a family tree. This can be done also by just typing the name  (name or database dir)
+
-O, ouvre un arbre familial. Ceci est également possible en saisissant le nom (nom ou répertoire de la base de données)
  
Examples:
+
Exemples :
  python gramps.py 'Family Tree 1'
+
  python gramps.py 'Arbre familial 1'
 
  python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
 
  python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
  python gramps.py -O 'Family Tree 1'
+
  python gramps.py -O 'Arbre familial 1'
 
  python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d
 
  python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d
  
 
Si le nom du fichier est donné sans options, GRAMPS ouvrira sa fenêtre principale et commencera une session.
 
Si le nom du fichier est donné sans options, GRAMPS ouvrira sa fenêtre principale et commencera une session.
  
{{Man tip| Tip |If no option is given, just the file name, GRAMPS will ignore the rest of the command line arguments. Use the -O flag to open the file and do something with the data.}}
+
{{Man tip| Astuce|Si aucune option n'est donnée, juste le nom de fichier, GRAMPS ignorera le reste des arguments de ligne de commande. Utilisez l'option -O pour et pour faire quelque chose avec les données.}}
  
The format can be specified with the <pre>-f format</pre> or <pre>--format=format</pre> option, immediately following the ''filename'' . If not specified, the guess will be attempted based on the ''filename''. Format possible: 'gedcom','gramps-xml','gramps-pkg', 'grdb','geneweb'.
+
Le format peut être spécifié avec <pre>-f format</pre> ou l'option <pre>--format=format</pre>, suivi immédiatement par le ''nom_du_fichier'' . Si non spécifié, GRAMPS devinera d'après le ''nom_du_fichier''. Format possible: 'gedcom','gramps-xml','gramps-pkg', 'grdb','geneweb'.
  
{{Man tip| Tip |Only grdb, gramps-xml, and gedcom formats can be opened directly. For other formats, you will need to use the import option which will set up the empty database and then import data into it.}}
+
{{Man tip| 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 créera une base de données vide puis importera des données.}}
  
 
{{Man tip| Tip |Seulement, un fichier peut être ouvert par GRAMPS. Si vous avez besoin d'ouvrir depuis plusieurs sources, utilisez l'option d'importation <pre>-i</pre>.}}
 
{{Man tip| Tip |Seulement, un fichier peut être ouvert par GRAMPS. Si vous avez besoin d'ouvrir depuis plusieurs sources, utilisez l'option d'importation <pre>-i</pre>.}}
Line 52: Line 52:
 
Les dossiers destinés à l'importation peuvent être indiqués avec <pre>-i ''nom du fichier''</pre> ou <pre>--import=''nom du fichier''</pre> Le format peut être indiqué avec l'option <pre>-f format</pre> ou <pre>--format=format</pre> juste après''nom 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.
 
Les dossiers destinés à l'importation peuvent être indiqués avec <pre>-i ''nom du fichier''</pre> ou <pre>--import=''nom du fichier''</pre> Le format peut être indiqué avec l'option <pre>-f format</pre> ou <pre>--format=format</pre> juste après''nom 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.
  
Example:  
+
Exemple:  
   python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
+
   python gramps.py -i 'Arbre familial 1' -i 'Arbre familial 2'
   python gramps.py -i test.grdb -i data.gramps
+
   python gramps.py -i test.grdb -i données.gramps
  
 
{{Man tip| Tip |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.}}
 
{{Man tip| Tip |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.}}
Line 64: Line 64:
 
Les dossiers destinés à l'exportation peuvent être indiqués avec <pre>-o ''nom du fichier''</pre> ou <pre>--output=''nom du fichier''</pre> Le format peut être indiqué avec l'option <pre>-f</pre> 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.
 
Les dossiers destinés à l'exportation peuvent être indiqués avec <pre>-o ''nom du fichier''</pre> ou <pre>--output=''nom du fichier''</pre> Le format peut être indiqué avec l'option <pre>-f</pre> 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.
  
-o, output a family tree in required format. It is not possible to export to a family tree.
+
-o, sortie de l'arbre familial dans le format requis. Ce n'est pas possible d'exporter vers un arbre familial.
  
Example:
+
Exemple:
   python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
+
   python gramps.py -i 'Arbre familial 1' -i test.grdb -f grdb -o mergdeDB.gramps
Note that above does not change 'Family Tree 1' as everything happens via a temporary database, whereas:
+
Notez qu'on ne modifie pas 'Arbre familial 1' puisque l'on utilise une base temporaire, et:
   python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
+
   python gramps.py -O 'Arbre familial 1' -i test.grdb -f grdb -o mergdeDB.gramps
will import test.grdb into Family Tree 1, and then export to a file !
+
qui importera test.grdb dans Arbre familial 1, puis l'exporte dans un fichier !
  
{{man tip| Exporting more files |More than one file can be exported in one command. If this is the case, GRAMPS will attempt to write several files using the data from the database available at the moment.}}
+
{{man tip| Exporter plusieurs fichiers|Plus d'un fichier peut être exporté dans une commande. Si c'est le cas, GRAMPS écrira les données à partir de la base de données disponible.}}
  
 
Quand plus d'un fichier est donné, chacun doit être par précédé par <pre>-o</pre> Les dossiers sont écrits dans l'ordre indiqué.
 
Quand plus d'un fichier est donné, chacun doit être par précédé par <pre>-o</pre> Les dossiers sont écrits dans l'ordre indiqué.
Line 90: Line 90:
 
*''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 <pre>-p option_string</pre> ou <pre>--options=option_string</pre>.
 
*''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 <pre>-p option_string</pre> ou <pre>--options=option_string</pre>.
  
{{man tip| Report option string |The report option string should satisfy the following conditions:It must not contain any spaces. If some arguments need to include spaces, the string should be enclosed with quotation marks.
+
{{man tip| L'option rapport|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.
Option string must list pairs of option names and values.
+
La chaîne d'option doit lister des paires de nom et valeur.
Within a pair, option name and value must be separated by the equal sign.
+
La chaîne d'option doit énumérer une paire de nom et de valeur séparée par le signe égal.
Different pairs must be separated by commas.}}
+
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.
 
La plupart des options de rapport sont spécifiques pour chaque rapport. Cependant, il y a quelques options communes.
Line 99: Line 99:
 
*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.
 
*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: This will produce the list of names for all options available for a given report.
+
*show=all : ceci affichera la liste de noms pour toutes les options disponibles pour un rapport présenté.
  
*show=option_name: This will print the description of the functionality supplied by the option_name, as well as what are the acceptable types and values for this option.
+
*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é.
 
Employez les options ci-dessus pour découvrir tout au sujet d'un rapport présenté.
  
{{man tip| Tip |If an option is not supplied, the last used value will be used. If this report has never been generated before, then the value from last generated report will be used when applicable. Otherwise, the default value will be used.}}
+
{{man tip| 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é<pre>-a</pre> . Les actions sont effectuées dans l'ordre indiqué.
 
Quand plus d'une action à produire est donnée, chacunes doivent être par précédé<pre>-a</pre> . Les actions sont effectuées dans l'ordre indiqué.
Line 117: Line 117:
 
Si le premier argument sur la ligne de commande ne commence pas par le tiret, GRAMPS essayera d'ouvrir le dossier avec le nom donné par le premier argument et de commencer la session interactive, ignorant le reste des arguments de ligne de commande.
 
Si le premier argument sur la ligne de commande ne commence pas par le tiret, GRAMPS essayera d'ouvrir le dossier avec le nom donné par le premier argument et de commencer la session interactive, ignorant le reste des arguments de ligne de commande.
  
If the <pre>-O</pre> flag is given, then GRAMPS will try opening the supplied file name and then work with that data, as instructed by the further command line parameters.
+
Si <pre>-O</pre> est donné, alors GRAMPS essayera d'ouvrir le nom de fichier fourni et fonctionnera alors avec ces données.
  
{{man note|1=Note |2=Only one file can be opened in a single invocation of GRAMPS. If you need to get data from multiple sources, use the importing options by using <pre>-i</pre> flag.}}
+
{{man note|1=Note |2=Seulement, un fichier peut être ouvert par GRAMPS. Si vous avez besoin d'ouvrir depuis plusieurs sources, utilisez l'option d'importation <pre>-i</pre>.}}
  
With or without the <pre>-O</pre> flag, there could be multiple imports, exports, and actions specified further on the command line by using <pre>-i</pre> , <pre>-o</pre> , and <pre>-a</pre> flags.
+
Avec ou sans l'argument <pre>-O</pre>, il peut y avoir de multiples importations , exportations, et actions spécifiées par la ligne de commande par les arguments <pre>-i</pre> , <pre>-o</pre> , et <pre>-a</pre>.
  
 
L'ordre des options <pre>-i</pre>, <pre>-o</pre>, ou <pre>-a</pre> 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).
 
L'ordre des options <pre>-i</pre>, <pre>-o</pre>, ou <pre>-a</pre> 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).
Line 137: Line 137:
 
*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 :
 
*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 :
  
:<pre>gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check</pre>
+
:<pre>gramps -i fichier1.ged -i fichier2.gpkg -i ~/db3.gramps -i fichier4.wft -a check</pre>
  
 
*Si vous voulez préciser les formats de fichiers dans l'exemple ci-dessus, complétez les noms de fichiers par les options <pre>-f</pre> appropriées :
 
*Si vous voulez préciser les formats de fichiers dans l'exemple ci-dessus, complétez les noms de fichiers par les options <pre>-f</pre> appropriées :
  
:<pre>gramps -i file1.ged -f gedcom -i file2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check</pre>
+
:<pre>gramps -i fichier1.ged -f gedcom -i fichier2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i fichier4.wft -f wft -a check</pre>
  
 
*Pour enregistrer le résultat des lectures, donnez l'option <pre>-o</pre> (utiliser <pre>-f</pre> si le nom de fichier ne permet pas à gramps de deviner le format) :
 
*Pour enregistrer le résultat des lectures, donnez l'option <pre>-o</pre> (utiliser <pre>-f</pre> si le nom de fichier ne permet pas à gramps de deviner le format) :
  
:<pre>gramps -i file1.ged -i file2.gpkg -o ~/new-package -f gramps-pkg</pre>
+
:<pre>gramps -i fichier1.ged -i fichier2.gpkg -o ~/nouveau-paquet -f gramps-pkg</pre>
  
 
*Pour sauver les erreurs de l'exemple précédent dans les fichiers outfile et errfile, lancez :
 
*Pour sauver les erreurs de l'exemple précédent dans les fichiers outfile et errfile, lancez :
  
:<pre>gramps -i file1.ged -i file2.dpkg -o ~/new-package -f gramps-pkg >outfile 2>errfile </pre>
+
:<pre>gramps -i fichier1.ged -i fichier2.dpkg -o ~/nouveau-paquet -f gramps-pkg >outfile 2>errfile </pre>
  
 
*Pour lire trois ensembles de données puis lancer une session interactive de gramps sur le tout:
 
*Pour lire trois ensembles de données puis lancer une session interactive de gramps sur le tout:
  
:<pre>gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps </pre>
+
:<pre>gramps -i fichier1.ged -i fichier2.gpkg -i ~/db3.gramps </pre>
  
 
*Pour ouvrir une base de données, produisant un rapport temporel dans le format pdf et l'enregistrant sous le fichier <pre>my_timeline.pdf</pre>  :
 
*Pour ouvrir une base de données, produisant un rapport temporel dans le format pdf et l'enregistrant sous le fichier <pre>my_timeline.pdf</pre>  :
  
:<pre>gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf </pre>
+
:<pre>gramps -O fichier.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf </pre>
  
{{man tip|1=Timeline report options |2=Use the <tt>''name=timeline,show=all''</tt> to find out about all available options for the timeline report. To find out details of a particular option, use <tt>''show=option_name''</tt> , e.g. <tt>''name=timeline,show=off''</tt> string. To learn about available report names, use <tt>''name=show''<tt> string.}}
+
{{man tip|1= Options du rapport temporel |2=Utilisez <tt>''name=timeline,show=all''</tt> pour trouver toutes les options disponibles pour le rapport temporel. Pour obtenir plus de détails, utilisez <tt>''show=option_name''</tt> , par exemple la chaîne <tt>''name=timeline,show=off''</tt>. Pour découvrir les noms de rapport, utilisez la chaîne <tt>''name=show''<tt>.}}
  
*To convert a grdb on the fly to a .gramps xml file:
+
*Pour convertir un grdb vers un fichier gramps xml :
  
:<pre>gramps -O myoriginal.grdb -o output.gramps -f gramps-xml</pre>
+
:<pre>gramps -O mon_original.grdb -o sortie.gramps -f gramps-xml</pre>
  
 
*Enfin, pour lancer une session interactive normale, entrez :
 
*Enfin, pour lancer une session interactive normale, entrez :
Line 171: Line 171:
 
== Variables d'environnement ==
 
== Variables d'environnement ==
  
GRAMPS can take advantage of these environment variables (but do not change them if you do not know what are you doing):
+
GRAMPS peut tenir compte de ces variables d'environnement (mais ne les changez pas si vous ne savez pas pourquoi):
* '''GRAMPSHOME''' - if set, override default path to profile allowing user to use ex. network drive to store data and all settings.
+
*'''GRAMPSHOME''' - si définit, écrase le chemin par défaut du profile permettant d'utiliser un disque réseau pour sauvegarder ses données et préférences.
* '''LANG''' - is used by GRAMPS to determine which language file should be loaded.
+
*'''LANG''' - est utilisé par GRAMPS pour déterminer quelle langue doit être chargée.
  
{{man index|Gramps 3.0 Wiki Manual - Filters/fr|Gramps 3.0 Wiki Manual - About/fr}}  
+
{{man index/fr|Gramps_3.0_Wiki_Manual_-_Keybindings/fr|Gramps 3.0 Wiki Manual - About/fr|3.0}}  
  
[[Category:Fr:Documentation]]
+
[[Category:Fr:Documentation|M]]

Latest revision as of 09:52, 16 March 2012

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

Gramps-notes.png
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 !

Tango-Dialog-information.png
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 çà !


Gnome-important.png Notice spéciale pour le droit à la copie: Toutes les éditions de cette page ont besoin des deux différentes licences pour la réutilisation:

Ces licences permettent au projet Gramps de maximiser l'utilisation du manuel wiki en tant que contenu libre pour les prochaines versions de Gramps. Si vous êtes en désaccord avec cette double licence, alors n'éditez pas cette page. Vous pouvez ajouter un lien pour cette page, ce dernier sera sous licence GFDL via le lien externe (utilisant la syntaxe: [http://www.gramps-project.org/...]), et non via les liens internes.
Utilisez également les conventions typographiques.



Options disponibles

Voici la liste des options de lancement de GRAMPS. Si vous voulez connaître plus d'options, voir Opération et 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.

  • 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
  • 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
  • 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
  • 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 .gpkg
  • 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
  • Web Family Tree. Ce format est prêt à l'exportation seulement. Une fois indiqué, il peut deviner si le fichier porte l'extension .wft
  • 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* utilisez l'option :
    -O nom_du_fichier
    ou
    --open=nom_du_fichier

-O, ouvre un arbre familial. Ceci est également possible en saisissant le nom (nom ou répertoire de la base de données)

Exemples :

python gramps.py 'Arbre familial 1'
python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
python gramps.py -O 'Arbre familial 1'
python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d

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

Tango-Dialog-information.png
Astuce

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


Le format peut être spécifié avec

-f format

ou l'option

--format=format

, suivi immédiatement par le nom_du_fichier . Si non spécifié, GRAMPS devinera d'après le nom_du_fichier. Format possible: 'gedcom','gramps-xml','gramps-pkg', 'grdb','geneweb'.

Tango-Dialog-information.png
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 créera une base de données vide puis importera des données.


Tango-Dialog-information.png
Tip

Seulement, un fichier peut être ouvert par GRAMPS. Si vous avez besoin d'ouvrir depuis plusieurs sources, utilisez l'option d'importation
-i
.


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.

Exemple:

  python gramps.py -i 'Arbre familial 1' -i 'Arbre familial 2'
  python gramps.py -i test.grdb -i données.gramps
Tango-Dialog-information.png
Tip

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 dossier d'entrée est donné, chacun doit être par précédé de

-i

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

-o, sortie de l'arbre familial dans le format requis. Ce n'est pas possible d'exporter vers un arbre familial.

Exemple:

 python gramps.py -i 'Arbre familial 1' -i test.grdb -f grdb -o mergdeDB.gramps

Notez qu'on ne modifie pas 'Arbre familial 1' puisque l'on utilise une base temporaire, et:

 python gramps.py -O 'Arbre familial 1' -i test.grdb -f grdb -o mergdeDB.gramps

qui importera test.grdb dans Arbre familial 1, puis l'exporte dans un fichier !

Tango-Dialog-information.png
Exporter plusieurs fichiers

Plus d'un fichier peut être exporté dans une commande. Si c'est le cas, GRAMPS écrira les données à partir de la base de données disponible.


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 :

  • summary : cette action est identique à Rapports ->Vue ->Sommaire
  • check : cette action est identique à Outils ->Traitement de la Base de données ->contrôle et réparation.
  • tool : cette annexe décrit les possibilités offertes par GRAMPS en ligne de commande, depuis un terminal.
  • 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
    .
Tango-Dialog-information.png
L'option rapport

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.

  • 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é.

Tango-Dialog-information.png
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é.

Liste des options

-l

, rapporte une liste des arbres familiaux

Opération

Si le premier argument sur la ligne de commande ne commence pas par le tiret, GRAMPS essayera d'ouvrir le dossier avec le nom donné par le premier argument et de commencer la session interactive, ignorant le reste des arguments de ligne de commande.

Si

-O

est donné, alors GRAMPS essayera d'ouvrir le nom de fichier fourni et fonctionnera alors avec ces données.

Gramps-notes.png
Note

Seulement, un fichier peut être ouvert par GRAMPS. Si vous avez besoin d'ouvrir depuis plusieurs sources, utilisez l'option d'importation
-i
.

Avec ou sans l'argument

-O

, il peut y avoir de multiples importations , exportations, et actions spécifiées par la ligne de commande par les arguments

-i

,

-o

, et

-a

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

'

Gramps-notes.png
Note

Mais ouvrir doit toujours être en premier !

Si aucune option

-O

ou

-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. import_db.grdb se situera 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 fichier1.ged -i fichier2.gpkg -i ~/db3.gramps -i fichier4.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 fichier1.ged -f gedcom -i fichier2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i fichier4.wft -f wft -a check
  • Pour enregistrer le résultat des lectures, donnez l'option
    -o
    (utiliser
    -f
    si le nom de fichier ne permet pas à gramps de deviner le format) :
gramps -i fichier1.ged -i fichier2.gpkg -o ~/nouveau-paquet -f gramps-pkg
  • Pour sauver les erreurs de l'exemple précédent dans les fichiers outfile et errfile, lancez :
gramps -i fichier1.ged -i fichier2.dpkg -o ~/nouveau-paquet -f gramps-pkg >outfile 2>errfile 
  • Pour lire trois ensembles de données puis lancer une session interactive de gramps sur le tout:
gramps -i fichier1.ged -i fichier2.gpkg -i ~/db3.gramps 
  • Pour ouvrir une base de données, produisant un rapport temporel dans le format pdf et l'enregistrant sous le fichier
    my_timeline.pdf
     :
gramps -O fichier.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf 
Tango-Dialog-information.png
Options du rapport temporel

Utilisez name=timeline,show=all pour trouver toutes les options disponibles pour le rapport temporel. Pour obtenir plus de détails, utilisez show=option_name , par exemple la chaîne name=timeline,show=off. Pour découvrir les noms de rapport, utilisez la chaîne name=show.


  • Pour convertir un grdb vers un fichier gramps xml :
gramps -O mon_original.grdb -o sortie.gramps -f gramps-xml
  • Enfin, pour lancer une session interactive normale, entrez :
gramps 

Variables d'environnement

GRAMPS peut tenir compte de ces variables d'environnement (mais ne les changez pas si vous ne savez pas pourquoi):

  • GRAMPSHOME - si définit, écrase le chemin par défaut du profile permettant d'utiliser un disque réseau pour sauvegarder ses données et préférences.
  • LANG - est utilisé par GRAMPS pour déterminer quelle langue doit être chargée.
Précédent Index Suivant