c8a72267ae
* doc/gramps-manual/fr/filtref.xml: Update. * doc/gramps-manual/fr/mainwin.xml: Update. * doc/gramps-manual/fr/usage.xml: Update. svn: r2777
230 lines
12 KiB
XML
230 lines
12 KiB
XML
<?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>.
|
|
Le <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>
|