346 lines
13 KiB
Groff
346 lines
13 KiB
Groff
.TH "GRAMPS" "1" "December 01, 2012" "4.0" "Gramps"
|
||
.SH NAME
|
||
gramps \- Gramps Documentation
|
||
.
|
||
.nr rst2man-indent-level 0
|
||
.
|
||
.de1 rstReportMargin
|
||
\\$1 \\n[an-margin]
|
||
level \\n[rst2man-indent-level]
|
||
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
-
|
||
\\n[rst2man-indent0]
|
||
\\n[rst2man-indent1]
|
||
\\n[rst2man-indent2]
|
||
..
|
||
.de1 INDENT
|
||
.\" .rstReportMargin pre:
|
||
. RS \\$1
|
||
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||
. nr rst2man-indent-level +1
|
||
.\" .rstReportMargin post:
|
||
..
|
||
.de UNINDENT
|
||
. RE
|
||
.\" indent \\n[an-margin]
|
||
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.nr rst2man-indent-level -1
|
||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||
..
|
||
.\" Man page generated from reStructeredText.
|
||
.
|
||
gramps(1) 4.0.0 gramps(1)
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \fBNOM\fP
|
||
gramps \- Gramps est une application de généalogie. Gramps est
|
||
l\(aqacronyme de Genealogical Research and Analysis Management Programming
|
||
System (Systeme de Programmation pour Recherche, Analyse et Gestion de
|
||
données généalogiques)
|
||
.TP
|
||
.B \fBSYNOPSIS\fP
|
||
\fBgramps\fP [\fB\-?\fP | \fB\-\-help\fP] [\fB\-\-usage\fP] [\fB\-\-version\fP]
|
||
[\fB\-l\fP] [\fB\-L\fP] [\fB\-u\fP | \fB\-\-force\-unlock\fP] [\fB\-O\fP | \fB\-\-open=\fP \fIBASE_DE_DONNEES\fP
|
||
[\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP]] [\fB\-i\fP | \fB\-\-import=\fP \fIFILE\fP
|
||
[\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP]] [\fB\-i\fP | \fB\-\-import=\fP \fI...\fP]
|
||
[\fB\-e\fP | \fB\-\-export=\fP \fIFICHIER\fP [\fB\-f\fP | \fB\-\-format=\fP \fIFORMAT\fP]]
|
||
[\fB\-a\fP | \fB\-\-action=\fP \fIACTION\fP] [\fI\-p\fP | \fB\-\-options=\fP \fICHAÎNE‐
|
||
OPTION\fP]] [\fIFICHIER\fP] [\fB\-\-version\fP]
|
||
.TP
|
||
.B \fBDESCRIPTION\fP
|
||
Gramps est un programme Libre/OpenSource de généalogie. Il est écrit en
|
||
python, et utilise une interface GTK+/GNOME. Gramps est semblable à
|
||
d\(aqautres programmes de généalogie tel que Family Tree Maker (FTM),
|
||
Personal Ancestral Files, ou le programme GNU Geneweb. Il peut
|
||
importer/exporter le format le plus utilisé par les autres logiciels de
|
||
généalogie : GEDCOM.
|
||
.TP
|
||
.B \fBOPTIONS\fP
|
||
.INDENT 7.0
|
||
.TP
|
||
.B \fBgramps\fP \fIFICHIER\fP
|
||
Si FICHIER est désigné (sans autres commandes) comme arbre
|
||
familial ou comme répertoire d\(aqarbre familial, alors une session
|
||
interactive est ouverte. Si FICHIER est un format de fichier
|
||
supporté par Gramps, une base vide est créée dont le nom est
|
||
celui du FICHIER et les données y seront importées. Les autres
|
||
options sont ignorées. Ce type de lancement permet d\(aqutiliser
|
||
gramps pour manipuler des données comme dans un navigateur web.
|
||
Les formats natifs de gramps sont acceptés, voir ci\-dessous.
|
||
.TP
|
||
.B \fB\-f\fP , \fB\-\-format=\fP \fIFORMAT\fP
|
||
Le format spécifique du FICHIER est précédé par les arguments
|
||
\-i, ou \-e. Si l\(aqoption \-f n\(aqest pas donnée pour le FICHIER,
|
||
alors le format sera celui de l\(aqextension ou du type\-MIME.
|
||
.sp
|
||
Les formats de sortie disponibles sont gramps\-xml (deviné si
|
||
FICHIER se termine par .gramps), et gedcom (deviné si FICHIER se
|
||
termine par .ged), ou tout autre fichier d\(aqexportation
|
||
disponible dans le système de plugin Gramps.
|
||
.sp
|
||
Les formats disponibles pour l\(aqimportation sont grdb,
|
||
gramps\-xml, gedcom, gramps\-pkg (deviné si FICHIER se termine par
|
||
.gpkg), et geneweb (deviné si FICHIER se termine par .gw).
|
||
.sp
|
||
Les formats disponibles pour l\(aqexportation sont gramps\-xml, ged‐
|
||
com, gramps\-pkg, wft (deviné si FICHIER se termine par .wft),
|
||
geneweb, et iso (jamais deviné, toujours spécifié avec l\(aqoption
|
||
\-f).
|
||
.UNINDENT
|
||
.sp
|
||
\fB\-l\fP Imprime une liste des arbres familiaux disponibles.
|
||
.INDENT 7.0
|
||
.TP
|
||
.B \fB\-u\fP , \fB\-\-force\-unlock\fP
|
||
Débloquer une base de données verrouillée.
|
||
.TP
|
||
.B \fB\-O\fP , \fB\-\-open=\fP \fIBASE_DE_DONNEES\fP
|
||
Ouvrir une BASE_DE_DONNEES qui doit être une base présente dans
|
||
le répertoire des bases ou le nom d\(aqun arbre familial existant.
|
||
Si aucune action n\(aqest définie, les options d\(aqimport ou d\(aqexport
|
||
sont données par la ligne de commande puis une session interac‐
|
||
tive est ouverte, utilisant cette base de données.
|
||
.sp
|
||
Seulement une base peut être ouverte. Si vous utilisez plusieurs
|
||
sources, vous devez utiliser l\(aqoption d\(aqimport.
|
||
.TP
|
||
.B \fB\-i\fP , \fB\-\-import=\fP \fIFICHIER\fP
|
||
Importer des données depuis un FICHIER. Si vous n\(aqavez pas
|
||
spécifié de base de données alors une base de données temporaire
|
||
est utilisée; elle sera effacée quand vous quitterez gramps.
|
||
.sp
|
||
Quand plus d\(aqun fichier doit être importé, chacun doit être
|
||
précédé par la commande \-i. Ces fichiers sont importés dans le
|
||
même ordre, i.e. \-i FICHIER1 \-i FICHIER2 et \-i FICHIER2 \-i
|
||
FICHIER1 vont tous les deux produire différents IDs gramps.
|
||
.TP
|
||
.B \fB\-e\fP , \fB\-\-export=\fP \fIFICHIER\fP
|
||
Exporter des données dans un FICHIER. Pour le format iso, le
|
||
FICHIER est le nom du répertoire dans lequel la base de données
|
||
gramps est écrite. Pour gramps\-xml, gedcom, wft, gramps\-pkg, et
|
||
geneweb, le FICHIER est le nom du fichier de sortie
|
||
.sp
|
||
Quand plus d\(aqun fichier doit être exporté, chacun doit être
|
||
précédé par la commande \-e. Ces fichiers sont importés dans le
|
||
même ordre.
|
||
.TP
|
||
.B \fB\-a\fP , \fB\-\-action=\fP \fIACTION\fP
|
||
Accomplir une ACTION sur les données importées. C\(aqest effectué à
|
||
la fin de l\(aqimportation. Les actions possibles sont summary
|
||
(comme le rapport \-> Afficher \-> Statistiques sur la base),
|
||
check (comme l\(aqoutil \-> Réparation de la base \-> Vérifier et
|
||
réparer), report (produit un rapport) et tool (utilise un
|
||
outil), ces derniers ont besoin de OPTION précédé par la com‐
|
||
mande \-p.
|
||
.sp
|
||
L\(aqOPTION doit satisfaire ces conditions:
|
||
Il ne doit pas y avoir d\(aqespace. Si certains arguments doivent
|
||
utiliser des espaces, la chaîne doit être encadrée par des
|
||
guillemets. Les options vont par paire nom et valeur. Une
|
||
paire est séparée par un signe égal. Différentes paires sont
|
||
séparées par une virgule.
|
||
.sp
|
||
La plupart des options sont spécifiques à chaque rapport. Même
|
||
s\(aqil existe des options communes.
|
||
.sp
|
||
\fBname=name\fP
|
||
Cette option est obligatoire, elle détermine quel rapport ou
|
||
outil sera utilisé. Si le name saisi ne correspond à aucun mod‐
|
||
ule disponible, un message d\(aqerreur sera ajouté.
|
||
.sp
|
||
\fBshow=all\fP
|
||
Cette option produit une liste avec les noms des options
|
||
disponibles pour un rapport donné.
|
||
.sp
|
||
\fBshow=optionname\fP
|
||
Cette option affiche une description de toutes les fonction‐
|
||
nalités proposées par optionname, aussi bien les types que les
|
||
valeurs pour une option.
|
||
.sp
|
||
Utiliser les options ci\-dessus pour trouver tout sur un rapport
|
||
choisi.
|
||
.UNINDENT
|
||
.sp
|
||
Quand plus d\(aqune action doit être effectuée, chacune doit être précédée
|
||
par la commande \fB\-a\fP . Les actions seront réalisées une à une, dans
|
||
l\(aqordre spécifié.
|
||
.INDENT 7.0
|
||
.TP
|
||
.B \fB\-d\fP , \fB\-\-debug=\fP \fINOM_LOGGER\fP
|
||
Permet les logs de debug pour le développement et les tests.
|
||
Regarder le code source pour les détails.
|
||
.TP
|
||
.B \fB\-\-version\fP
|
||
Imprime le numéro de version pour gramps puis quitte.
|
||
.UNINDENT
|
||
.TP
|
||
.B \fBOperation\fP
|
||
Si le premier argument de la ligne de commande ne commence pas par un
|
||
tiret (i.e. pas d\(aqinstruction), gramps va essayer d\(aqouvrir la base de
|
||
données avec le nom donné par le premier argument et démarrer une ses‐
|
||
sion interactive, en ignorant le reste de la ligne de commande.
|
||
.sp
|
||
Si la commande \-O est notée, alors gramps va essayer le fichier défini
|
||
et va travailler avec ses données, comme pour les autres paramètres de
|
||
la ligne de commande.
|
||
.sp
|
||
Avec ou sans la commande \-O, il peut y avoir plusieurs imports,
|
||
exports, et actions dans la ligne de commande \-i, \-e, et \-a.
|
||
.sp
|
||
L\(aqordre des options \-i, \-e, ou \-a n\(aqa pas de sens. L\(aqordre actuel est
|
||
toujours : imports \-> actions \-> exports. Mais l\(aqouverture doit tou‐
|
||
jours être la première!
|
||
.sp
|
||
Si aucune option \fB\-O\fP ou \fB\-i\fP n\(aqest donnée, gramps lancera sa propre
|
||
fenêtre et demarrera avec une base vide, puisqu\(aqil n\(aqy a pas données.
|
||
.sp
|
||
Si aucune option \fB\-e\fP ou \fB\-a\fP n\(aqest donnée, gramps lancera sa propre
|
||
fenêtre et démarrera avec la base de données issue de tout les imports.
|
||
Cette base sera \fBimport_db.grdb\fP sous le \fBrépertoire ~/.gramps/import\fP.
|
||
.sp
|
||
Les erreurs rencontrées lors d\(aqimport, export, ou action, seront
|
||
mémorisées en stdout (si elles sont le fait de la manipulation par
|
||
gramps) ou en \fIstderr\fP (si elles ne sont pas le fait d\(aqune manipulation).
|
||
Utilisez les shell de redirection de \fIstdout\fP et \fIstderr\fP pour sauver
|
||
les messages et les erreurs dans les fichiers.
|
||
.TP
|
||
.B \fBEXEMPLES\fP
|
||
Pour ouvrir un arbre familial et y importer un fichier XML, on peut
|
||
saisir:
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-O\fP \fI\(aqMon Arbre Familial\(aq\fP \fB\-i\fP \fI~/db3.gramps\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Ceci ouvre un arbre familial, pour faire la même chose, mais importer
|
||
dans un arbre familial temporaire et démarrer une session interactive,
|
||
on peut saisir:
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-i\fP \fI\(aqMon Arbre Familial\(aq\fP \fB\-i\fP \fI~/db3.gramps\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Lecture de quatre bases de données dont les formats peuvent être
|
||
devinés d\(aqaprès les noms, puis vérification des données:
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-i\fP \fI~/db3.gramps\fP
|
||
\fB\-i\fP \fIfile4.wft\fP \fB\-a\fP \fIcheck\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Si vous voulez préciser les formats de fichiers dans l\(aqexemple ci\-
|
||
dessus, complétez les noms de fichiers par les options \-f appropriées:
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-f\fP \fIgedcom\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-f\fP
|
||
\fIgramps\-pkg\fP \fB\-i\fP \fI~/db3.gramps\fP \fB\-f\fP \fIgramps\-xml\fP \fB\-i\fP \fIfile4.wft\fP
|
||
\fB\-f\fP \fIwft\fP \fB\-a\fP \fIcheck\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Pour enregistrer le résultat des lectures, donnez l\(aqoption \-e
|
||
(utiliser \-f si le nom de fichier ne permet pas à gramps de deviner le
|
||
format):
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-e\fP \fI~/new\-package\fP
|
||
\fB\-f\fP \fIgramps\-pkg\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Pour lire trois ensembles de données puis lancer une session interac‐
|
||
tive de gramps sur le tout :
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-i\fP \fIfile1.ged\fP \fB\-i\fP \fIfile2.tgz\fP \fB\-i\fP \fI~/db3.gramps\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Pour lancer l\(aqoutil de vérification de la base de données depuis la
|
||
ligne de commande et obtenir le résultat :
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps \-O\fP \fI\(aqMy Family Tree\(aq\fP \fB\-a\fP \fItool\fP \fB\-p name=\fP \fIverify\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Enfin, pour lancer une session interactive normale, entrer :
|
||
.INDENT 7.0
|
||
.INDENT 3.5
|
||
\fBgramps\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.TP
|
||
.B \fBVARIABLES D\(aqENVIRONMENT\fP
|
||
Le programme vérifie si ces variables d\(aqenvironnement sont déclarées:
|
||
.sp
|
||
\fBLANG\fP \- décrit, quelle langue est utilisée: Ex.: pour le français on
|
||
peut définir fr_FR.UTF\-8.
|
||
.sp
|
||
\fBGRAMPSHOME\fP \- si défini, force Gramps à utiliser un répertoire
|
||
spécifique pour y conserver ses préférences et bases de données. Par
|
||
défaut, cette variable n\(aqest pas active et Gramps sait que les options
|
||
et bases de données doivent être créées dans le répertoire par défaut
|
||
de l\(aqutilisateur (la variable d\(aqenvironnement HOME pour Linux ou USER‐
|
||
PROFILE pour Windows 2000/XP).
|
||
.TP
|
||
.B \fBCONCEPTS\fP
|
||
Gramps est un système basé sur le support de plugin\-python, permettant
|
||
d\(aqimporter et d\(aqexporter, la saisie, générer des rapports, des outils,
|
||
et afficher des filtres pouvant être ajoutés sans modifier le pro‐
|
||
gramme.
|
||
.sp
|
||
Par ailleurs, gramps permet la génération directe : impression, rap‐
|
||
ports avec sortie vers d\(aqautres formats, comme \fILibreOffice.org\fP ,
|
||
\fIHTML\fP , ou \fILaTeX\fP pour permettre à l\(aqutilisateur de choisir selon ses
|
||
besoins
|
||
.UNINDENT
|
||
.sp
|
||
\fBBUGS CONNUS ET LIMITATIONS\fP
|
||
\fBFICHIERS\fP
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
\fI${PREFIX}/bin/gramps\fP
|
||
.sp
|
||
\fI${PREFIX}/share/gramps\fP
|
||
.sp
|
||
\fI${HOME}/.gramps\fP
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \fBAUTEURS\fP
|
||
Donald Allingham <\fI\%don@gramps-project.org\fP>
|
||
\fI\%http://gramps-project.org/\fP
|
||
.sp
|
||
Cette page man a d\(aqabord été écrite par:
|
||
Brandon L. Griffith <\fI\%brandon@debian.org\fP>
|
||
pour Debian GNU/Linux système.
|
||
.sp
|
||
Cette page man est maintenue par:
|
||
Gramps project <\fI\%xxx@gramps-project.org\fP>
|
||
.sp
|
||
La traduction française:
|
||
Jérôme Rapinat <\fI\%romjerome@yahoo.fr\fP>
|
||
.TP
|
||
.B \fBDOCUMENTATION\fP
|
||
La documentation\-utilisateur est disponible par via un navigateur
|
||
standard sous la forme du manuel Gramps.
|
||
.sp
|
||
La documentation pour développeur est disponible sur le site
|
||
\fI\%http://www.gramps-project.org/wiki/index.php?title=Portal:Developers\fP .
|
||
.UNINDENT
|
||
.sp
|
||
Janvier 2013 4.0.0 gramps(1)
|
||
.SH AUTHOR
|
||
.
|
||
.SH COPYRIGHT
|
||
2012, .
|
||
.\" Generated by docutils manpage writer.
|
||
.\"
|
||
.
|