343 lines
13 KiB
Groff
343 lines
13 KiB
Groff
.TH "GRAMPS" "1" "28 December 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 reStructuredText.
|
||
.
|
||
.sp
|
||
gramps(1) @VERSION@ 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 \fIFICHIER\fP est désigné (sans autres commandes) comme arbre
|
||
familial ou comme répertoire d\(aqarbre familial, alors une session
|
||
interactive est ouverte. Si \fIFICHIER\fP est un format de fichier
|
||
supporté par Gramps, une base vide est créée dont le nom est
|
||
celui du \fIFICHIER\fP 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 \fIFICHIER\fP est précédé par les arguments
|
||
\fB\-i\fP , ou \fB\-e\fP . Si l\(aqoption \fB\-f\fP n\(aqest pas donnée pour le \fIFICHIER\fP ,
|
||
alors le format sera celui de l\(aqextension ou du type\-MIME.
|
||
.sp
|
||
Les formats de sortie disponibles sont \fBgramps\-xml\fP (deviné si
|
||
\fIFICHIER\fP se termine par \fB.gramps\fP ), et \fBgedcom\fP (deviné si \fIFICHIER\fP se
|
||
termine par \fB.ged\fP ), ou tout autre fichier d\(aqexportation
|
||
disponible dans le système de plugin Gramps.
|
||
.sp
|
||
Les formats disponibles pour l\(aqimportation sont \fBgrdb\fP ,
|
||
\fBgramps\-xml\fP , \fBgedcom\fP , \fBgramps\-pkg\fP (deviné si \fIFICHIER\fP se termine par
|
||
\fB.gpkg\fP ), et \fBgeneweb\fP (deviné si \fIFICHIER\fP se termine par \fB.gw\fP ).
|
||
.sp
|
||
Les formats disponibles pour l\(aqexportation sont \fBgramps\-xml\fP , \fBged‐
|
||
com\fP , \fBgramps\-pkg\fP , \fBwft\fP (deviné si \fIFICHIER\fP se termine par \fB.wft\fP ),
|
||
\fBgeneweb\fP .
|
||
.TP
|
||
.B \fB\-l\fP
|
||
Imprime une liste des arbres familiaux disponibles.
|
||
.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 \fIBASE_DE_DONNEES\fP 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 \fIFICHIER\fP . 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 \fB\-i\fP . Ces fichiers sont importés dans le
|
||
même ordre, \fB\-i\fP \fIFICHIER1\fP \fB\-i\fP \fIFICHIER2\fP et \fB\-i\fP \fIFICHIER2\fP \fB\-i\fP
|
||
\fIFICHIER1\fP 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 \fIFICHIER\fP . Pour les fichiers \fBgramps\-xml\fP
|
||
, \fBgedcom\fP , \fBwft\fP , \fBgramps\-pkg\fP , et \fBgeneweb\fP , le
|
||
\fIFICHIER\fP 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 \fB\-e\fP . Ces fichiers sont importés dans le
|
||
même ordre.
|
||
.TP
|
||
.B \fB\-a\fP , \fB\-\-action=\fP \fIACTION\fP
|
||
Accomplir une \fIACTION\fP sur les données importées. C\(aqest effectué à
|
||
la fin de l\(aqimportation. Les actions possibles sont \fBsummary\fP
|
||
(comme le rapport \-> Afficher \-> Statistiques sur la base),
|
||
\fBcheck\fP (comme l\(aqoutil \-> Réparation de la base \-> Vérifier et
|
||
réparer), \fBreport\fP (produit un rapport) et \fBtool\fP (utilise un
|
||
outil), ces derniers ont besoin de \fIOPTION\fP précédé par la commande \-p.
|
||
.sp
|
||
L\(aq \fIOPTION\fP 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
|
||
module 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 fonctionnalité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 \fBOpération\fP
|
||
Si le premie 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 \fB\-O\fP 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 \fB\-O\fP , il peut y avoir plusieurs imports,
|
||
exports, et actions dans la ligne de commande \fB\-i\fP , \fB\-e\fP , et \fB\-a\fP .
|
||
.sp
|
||
L\(aqordre des options \fB\-i\fP , \fB\-e\fP , ou \fB\-a\fP n\(aqa pas de sens. L\(aqordre actuel est
|
||
toujours : imports \-> actions \-> exports. Mais l\(aqouverture doit toujours
|
||
ê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 dans le répertoire \fB~/.gramps/import\fP.
|
||
.sp
|
||
Les erreurs rencontrées lors d\(aqimportation, d\(aqexportation, ou d\(aqaction, seront
|
||
mémorisées en \fIstdout\fP (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 lesformats 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 \fB\-e\fP
|
||
(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
|
||
interactive 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 programme.
|
||
.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
|
||
.sp
|
||
\fBFICHIERS\fP
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
\fI${PREFIX}/bin/gramps\fP
|
||
.sp
|
||
\fI${PREFIX}/lib/python/dist\-packages/gramps/\fP
|
||
.sp
|
||
\fI${PREFIX}/share/\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 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
|
||
gramps(1) @VERSION@ gramps(1)
|
||
.SH AUTHOR
|
||
Jerome Rapinat
|
||
.SH COPYRIGHT
|
||
2012, Gramps project
|
||
.\" Generated by docutils manpage writer.
|
||
.
|