<?xml version="1.0" encoding="UTF-8"?>
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS
distributed with this manual.
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-cmdline">
<title>Manuel de référence pour l'utilisation en ligne de commande</title>
<para>Cette annexe décrit les possibilités offertes par &app; en
ligne de commande, depuis un terminal. </para>
<para>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.
</para>
<para>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 çà !
</para>
<sect3 id="cmdline-options">
<title>Options disponibles</title>
<para>Voici la liste des options de lancement de &app; : </para>
<variablelist>
<varlistentry><term>Options de format</term>
<listitem><para> Le format des fichiers de lecture ou d'écriture est donné par l'option
<command>-f</command> <replaceable>format</replaceable>
<replaceable>format</replaceable> est à choisir parmi un des choix suivants :
<variablelist>
<varlistentry><term>gramps</term>
<listitem><para> &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.
</para></listitem></varlistentry>
<varlistentry><term>gedcom</term>
<listitem><para> fichier GEDCOM. Ce format est disponible
en lecture comme en écriture. Il est deviné
si le nom de fichier a comme suffixe .ged.
</para></listitem></varlistentry>
<varlistentry><term>gramps-pkg</term>
<listitem><para> &app; package. Ce format est disponible
en lecture comme en écriture. Il est deviné
si le nom de fichier a comme suffixe .tgz .
</para></listitem></varlistentry>
<varlistentry><term>wft</term>
<listitem><para>Web Family Tree. Ce format est disponible
en écriture seulement. Il est deviné
si le nom de fichier a comme suffixe .wft.
</para></listitem></varlistentry>
<varlistentry><term>iso</term>
<listitem><para>image de CD. Ce format est disponible
en écriture seulement. Il doit toujours être
précisé explicitement.
</para></listitem></varlistentry>
</variablelist>
</para></listitem>
</varlistentry>
<varlistentry><term>Options de lecture</term>
<listitem><para> Les fichiers à lire sont spécifiés avec l'option
<command>-i</command> <replaceable>chemin</replaceable>.
Le format peut être précisé avec l'option <command>-f</command>
immédiatement après le <replaceable>chemin</replaceable>.
Si le format n'est pas précisé, il sera deviné d'après le
<replaceable>chemin</replaceable> donné. Pour le format <term>gramps</term>,
le <replaceable>chemin</replaceable> est en fait le
nom du répertoire dans lequel les données gramps sont placées. Pour les formats
<term>gedcom</term> et <term>gramps-pkg</term>, le
<replaceable>chemin</replaceable> est le nom du fichier de données. </para>
<para>Quand plusieurs fichiers sont à lire, chaque nom de fichier doit être
précédé par une commande <command>-i</command>.
Les fichiers sont lus dans l'ordre des arguments, c'est à dire que
<command>-i</command> <replaceable>chemin1</replaceable>
<command>-i</command> <replaceable>chemin2</replaceable>
et
<command>-i</command> <replaceable>chemin2</replaceable>
<command>-i</command> <replaceable>chemin1</replaceable>
peuvent ne pas donner les mêmes identifications gramps dans les données après chargement.
</para></listitem>
</varlistentry>
<varlistentry><term>Options d'écriture</term>
<listitem><para> Les fichiers à écrire sont précisés par l'option
<command>-o</command> <replaceable>chemin</replaceable>.
Le format peut être spécifié par l'option <command>-f</command>
placée immédiatement après le <replaceable>chemin</replaceable>.
Si ce n'est pas le cas, il sera deviné d'après le
<replaceable>chemin</replaceable>. Pour les formats <term>gramps</term>
et <term>iso</term>, le <replaceable>chemin</replaceable>
est en fait le nom du répertoire où seront écrites les données gramps.
Pour les formats <term>gedcom</term>, <term>wft</term>,
et <term>gramps-pkg</term>, le <replaceable>chemin</replaceable>
est le nom du fichier écrit.
</para>
<para>Quand plusieurs fichiers de sortie sont précisés, chacun doit être
précédé par une option <command>-o</command> . Les fichiers sont écrits
un par un dans l'ordre des arguments. </para></listitem>
</varlistentry>
<varlistentry><term>Options d'action</term>
<listitem><para>L'action à exécuter sur les données lues peut être précisée
avec l'option <command>-a</command> <replaceable>action</replaceable>.
Ceci est fait après que toutes les lectures ont été faites avec succès.
Les actions actuellement disponibles sont <term>summary</term> (comme
<menuchoice><guimenu>Reports</guimenu> <guisubmenu>View</guisubmenu>
<guimenuitem>Summary</guimenuitem></menuchoice>)
et <term>check</term> (comme <menuchoice><guimenu>Tools</guimenu>
<guisubmenu>Database Processing</guisubmenu>
<guimenuitem>Check and Repair</guimenuitem></menuchoice>).
</para>
<para>Si plusieurs actions de sorties sont données, chacune doit être précédée par une option
<command>-a</command>. Les actions sont exécutées une par une dans l'ordre des arguments.
</para></listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="cmdline-operation">
<title>Operation</title>
<para>L'ordre des options <command>-i</command>, <command>-o</command>,
ou <command>-a</command> 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).</para>
<para>Si aucune option<command>-i</command> 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.</para>
<para>Si aucune option<command>-o</command> ou <command>-a</command> 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
<replaceable>~/.gramps/import</replaceable> .</para>
<para>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. </para>
</sect3>
<sect3 id="cmdline-examples">
<title>Exemples</title>
<para>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 : </para>
<para><command>gramps -i</command> <replaceable>chemin1.ged</replaceable>
<command>-i</command> <replaceable>chemin2.tgz</replaceable>
<command>-i</command> <replaceable>~/db3</replaceable>
<command>-i</command> <replaceable>chemin4.wft</replaceable>
<command>-a</command> <replaceable>check</replaceable>
</para>
<para>Si vous voulez préciser les formats de fichiers dans l'exemple ci-dessus,
complétez les noms de fichiers par les options
<command>-f</command> appropriées : </para>
<para><command>gramps -i</command> <replaceable>chemin1.ged</replaceable>
<command>-f</command> <replaceable>gedcom</replaceable>
<command>-i</command> <replaceable>chemin2.tgz</replaceable>
<command>-f</command> <replaceable>gramps-pkg</replaceable>
<command>-i</command> <replaceable>~/db3</replaceable>
<command>-f</command> <replaceable>gramps</replaceable>
<command>-i</command> <replaceable>chemin4.wft</replaceable>
<command>-f</command> <replaceable>wft</replaceable>
<command>-a</command> <replaceable>check</replaceable>
</para>
<para>Pour enregistrer le résultat des lectures, donnez l'option
<command>-o</command> (utilisez l'option <command>-f</command>
si le nom de fichier ne permet pas à gramps de deviner le format) : </para>
<para><command>gramps -i</command> <replaceable>chemin1.ged</replaceable>
<command>-i</command> <replaceable>chemin2.tgz</replaceable>
<command>-o</command> <replaceable>~/nouvel-ensemble-gramps</replaceable>
<command>-f</command> <replaceable>gramps-pkg</replaceable>
</para>
<para>Pour sauver les erreurs de l'exemple précédent dans les fichiers
<replaceable>sortie</replaceable> et
<replaceable>erreur</replaceable>, lancez : </para>
<para><command>gramps -i</command> <replaceable>chemin1.ged</replaceable>
<command>-i</command> <replaceable>chemin2.tgz</replaceable>
<command>-o</command> <replaceable>~/nouvel-ensemble-gramps</replaceable>
<command>-f</command> <replaceable>gramps-pkg</replaceable>
><replaceable>sortie</replaceable>
2><replaceable>erreur</replaceable>
</para>
<para>Pour lire trois ensembles de données puis lancer une session interactive de gramps
sur le tout : </para>
<para><command>gramps -i</command> <replaceable>chemin1.ged</replaceable>
<command>-i</command> <replaceable>chemin2.tgz</replaceable>
<command>-i</command> <replaceable>~/db3</replaceable>
</para>
<para>Enfin, pour lancer une session interactive normale, entrez : </para>
<para> <command>gramps</command></para>
</sect3>
</sect2>