Difference between revisions of "gw/fr"
(création) |
(→Structure générale d'un fichier gw: end token comment) |
||
(49 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:Le format de fichier .gw}} | {{DISPLAYTITLE:Le format de fichier .gw}} | ||
{{languages|GWformat}} | {{languages|GWformat}} | ||
− | Le '''format GW''' est celui d'un fichier | + | Le '''format GW''' est celui d'un fichier source à partir duquel GeneWeb peut construire une base généalogique (en utilisant la commande '''gwc'''). |
+ | GeneWeb peut aussi bien sur produire un fichier au format GW à partir d'une base généalogique existante (en utilisant la commande '''gwu'''). | ||
+ | Le format GW contient toutes les informations d'une base de données GeneWeb sous une forme textuelle compatible avec tous les éditeurs de texte permettant une édition manuelle, et aisément manipulable par d'autres programmes. | ||
+ | Un fichier au format GW est la meilleure sauvegarde de votre base de données, et le meilleur moyen d'échanger de données avec d'autres programmes compatibles. | ||
+ | Pour mémoire, GeneWeb accepte et produit aussi le format GEDCOM, mais une certaine ambiguité de cette norme n'en fait pas le moyen de sauvegarde idéal. | ||
+ | |||
+ | Avec la version 7.00 de GeneWeb, le format GW a été augmenté ('''gwplus''', voir la section ''structure générale d'un fichier gw'' ci-dessous). | ||
+ | À ce jour, un fichier au format GW ne conserve pas la mémoire de la version de GeneWeb avec lequel il a été créé. Ceci pourrait changer.<br> | ||
+ | <span style="color: red">'''Attention'''</span> : les versions antérieures à GeneWeb 7.00 ne savent pas lire le format '''gwplus''' et perdraient les informations qui y | ||
+ | sont stockées (Quel est le comportement exact?). | ||
+ | Il existe cependant pour la compatibilité descendante une option de gwu (-old_gw) qui produit un fichier au format gw ancien et reporte en notes tout ce qui est incompatible. | ||
+ | |||
+ | Note : quelques morceaux de cette page sont encore en anglais!! Elles seront traduites sous peu. | ||
== Guide des styles == | == Guide des styles == | ||
− | * Le texte devant apparaître 'tel quel' est écrit en caractères | + | * Le texte devant apparaître 'tel quel' est écrit en caractères '''gras'''. |
− | * Les mots en | + | * Les mots en ''italique'' seront remplacés par leur valeur actuelle. La première lettre de ces noms est une majuscule, e.g. ''HusbandLastName'' |
* Les paramètres entre [crochets] sont optionnels: ils peuvent être ommis. | * Les paramètres entre [crochets] sont optionnels: ils peuvent être ommis. | ||
* Les mots séparés par des barres verticales '|' signifient des choix : un seul de ceux-ci doit être utilisé. | * Les mots séparés par des barres verticales '|' signifient des choix : un seul de ceux-ci doit être utilisé. | ||
− | Exemple : | + | Exemple de définition : |
− | fam HusbandLastName FirstName[.Number] + [WeddingDate] [#mp WeddingPlace] WifeLastName FirstName[.Number] | + | '''fam''' HusbandLastName FirstName[.Number] + [WeddingDate] ['''#mp''' WeddingPlace] WifeLastName FirstName[.Number] |
+ | Exemples valides: | ||
− | + | fam CORNO Joseph_Marie_Vincent + THOMAS Marie_Julienne | |
− | + | fam CORNO Alain.1 +25/11/1728 #mp Ile-aux-Moines CAUZIC Marie | |
− | |||
− | fam CORNO Joseph_Marie_Vincent + THOMAS Marie_Julienne | ||
− | fam CORNO Alain.1 +25/11/1728 #mp Ile-aux-Moines CAUZIC Marie | ||
− | |||
== Dates == | == Dates == | ||
Line 27: | Line 36: | ||
Les modificateurs de date utilisent des caractères spéciaux pour préfixes, afin de spécifier "vers", "avant", "peut-être" "après" etc. | Les modificateurs de date utilisent des caractères spéciaux pour préfixes, afin de spécifier "vers", "avant", "peut-être" "après" etc. | ||
− | | | + | {|class="wikitable" style="border-width: 10px; text-align:left;" |
− | | | + | !Type de date!!Caractère spécial!!Exemple |
− | | | + | |- |
− | | | + | |Vers||~||~10/5/1990 |
− | | | + | |- |
− | | | + | |Peut-être||?||?10/5/1990 |
− | | | + | |- |
+ | |Avant||<||<10/5/1990 | ||
+ | |- | ||
+ | |Après||>||>10/5/1990 | ||
+ | |- | ||
+ | |Ou||<nowiki>|</nowiki>||10/5/1990<nowiki>|</nowiki>1991 | ||
+ | |- | ||
+ | |Entre||...||10/5/1990...1991 | ||
+ | |} | ||
Le calendrier est de type Grégorien par défaut. Pour le type Julien, ajoutez "J" à la date, "F" pour le type Français Républicain, et "H" pour l'Hébreu. Exemple : 10/9/5750H | Le calendrier est de type Grégorien par défaut. Pour le type Julien, ajoutez "J" à la date, "F" pour le type Français Républicain, et "H" pour l'Hébreu. Exemple : 10/9/5750H | ||
Pour obtenir une date en texte simple, mettez le chiffre 0 et placez des parenthèses de cette façon : | Pour obtenir une date en texte simple, mettez le chiffre 0 et placez des parenthèses de cette façon : | ||
− | + | ||
− | 0(5_Mai_1990) | + | 0(5_Mai_1990) |
− | |||
== Chaînes de caractères == | == Chaînes de caractères == | ||
− | Les espaces dans les chaînes de caractères sont remplacés par des tirets bas | + | Les espaces dans les chaînes de caractères sont remplacés par des tirets bas "_" (sauf dans les notes et dans certains commentaires) : Marie_Julienne |
Les capitales ASCII correspondent à la norme ISO-8859-1. | Les capitales ASCII correspondent à la norme ISO-8859-1. | ||
== Référencement des individus == | == Référencement des individus == | ||
− | Une même personne peut être référencée plusieurs fois dans un fichier; en tant que parent, ou enfant, ou encore dans une note. Nom de famille, Prénom et numéro ( | + | Une même personne peut être référencée plusieurs fois dans un fichier; en tant que parent, ou enfant, ou encore dans une note. Nom de famille, Prénom et numéro (s'il existe) doivent correspondre exactement, sans cela le programme ne pourra pas déterminer un même individu et lier ses références ensemble. |
+ | |||
+ | == Structure générale d'un fichier gw== | ||
+ | |||
+ | ['''encoding: utf-8'''] # (optionnal) redefines text encoding to be utf-8 instead of iso-8859-1 | ||
+ | ['''gwplus'''] # (optionnal) specifies that this file follows the gwplus instead of gw format | ||
+ | |||
+ | suivi par un nombre quelconque de blocks : | ||
+ | |||
+ | ''Family'' # début de block : '''fam''' | ||
+ | ''PersonalNote'' # début de block : '''notes''' | ||
+ | ''Relations'' # début de block : '''rel''' | ||
+ | ''PersonEvents'' # début de block : '''pevt''' (specific to gwplus) | ||
+ | ''DataBaseNotes'' # début de block : '''notes-db''' (only one) | ||
+ | ''ExtendedPages'' # début de block : '''pages-ext''' | ||
+ | |||
+ | ''WizardNotes'' # début de block : '''wizard-note''' (possibly one for each wizard) | ||
+ | |||
+ | On verra dans les sections ci-dessous le token de fin de block pour chacun d'eux. | ||
== Principale structure : la famille == | == Principale structure : la famille == | ||
− | Le format du fichier est basé sur les | + | Le format du fichier est basé sur les ''Familles''. Une famille comprend l'époux et sa femme, et liste les enfants. L'information personnelle (DoB, etc.) est située au niveau enfant. |
+ | Si un individu n'a aucun parent, ses informations personnelles sont alors insérées directement après son nom dans la rubrique famille. | ||
− | En conséquence, il faut bien noter que les personnes considérées "isolées" dans la base de données GeneWeb | + | En conséquence, il faut bien noter que les personnes considérées "isolées" dans la base de données GeneWeb '''ne''' seront '''pas''' exportées dans le fichier GW. C'est aussi de cette façon que les individus supprimés de la base sont effacés lors d'une séquence '''gwu/gwc''' : ils ne sont tout simplement pas exportés. |
− | 1er cas : L'époux et sa femme sont tous les deux listés | + | 1er cas : L'époux et sa femme sont tous les deux listés quelque part en tant qu'enfants d'une famille parente. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | '''fam''' HusbandLastName FirstName[.Number] '''+'''[WeddingDate] | |
− | + | ['''#sep''' | '''-''' DivorceDate] ['''#nm''' | '''#eng'''] | |
− | + | ['''#mp''' WeddingPlace] ['''#ms''' WeddingSource] | |
− | + | WifeLastName FirstName[.Number] | |
− | + | ['''src''' Family source] | |
+ | ['''comm''' Family comments in free format] | ||
+ | ['''wit''' ['''m'''|'''f'''| ]: Witness (use Person format, see Person Information section) ] | ||
+ | ['''cbp''' common children birth place] | ||
+ | ['''csrc''' common children source] | ||
+ | ['''fevt''' | ||
+ | FamilyEvent (multiples) | ||
+ | '''end fevt'''] | ||
+ | ['''beg''' | ||
+ | - ['''h''' | '''f''' | ] Person (see detailed description at the next section) | ||
+ | '''end'''] | ||
− | Si | + | * Si les parents ne sont pas mariés (relation), insérez l'étiquette '''#nm'''. S'ils sont fiancés, utilisez '''#eng'''. |
− | + | * Si les parents sont séparés, utilisez '''#sep'''. Ou bien s'ils sont divorcés, utilisez '''-''' et ajoutez la date du divorce juste après (optionnel). | |
− | fam | + | * Si le ''ChildLastName'' est omis, le patronyme du père est utilisé. |
− | + | * Les étiquettes '''src''', '''comm''' et '''wit''' suivent sur des lignes séparées, après l'étiquette '''fam'''. Ils sont optionnels. | |
+ | * Si le sexe de l'enfant n'est pas connu, ne mettez rien (pas de '''h''' ni de '''f''') après le '''-''' (tiret). | ||
− | 2ème cas : L'époux ou sa femme ne sont listés nulle part en tant qu'enfants d'une autre famille. Entrez simplement leurs informations personnelles, comme vous le feriez pour un enfant. Voir la section Informations sur la personne ci-dessous pour plus de détails sur | + | Si une famille n'a pas d'enfants, vous pouvez sauter toute la séquence des étiquettes '''beg'''/'''end''' : |
+ | |||
+ | fam HEYDENREICH Gaspard +1719 TRESCH Rosine_Catherine | ||
+ | |||
+ | 2ème cas : L'époux ou sa femme ne sont listés nulle part en tant qu'enfants d'une autre famille. Entrez simplement leurs informations personnelles, comme vous le feriez pour un enfant. Voir la section [[#Informations sur la personne]] ci-dessous pour plus de détails sur les informations personnelles de chaque individu. | ||
Exemple : John Corno (o 1935 at Soisy, +1997) L'information est directement mise dans la rubrique famille, car cette personne n'est listée nulle part ailleurs: | Exemple : John Corno (o 1935 at Soisy, +1997) L'information est directement mise dans la rubrique famille, car cette personne n'est listée nulle part ailleurs: | ||
− | + | ||
− | fam Corno John 1935 #bp Soisy 1997 + Rempp Zabeth | + | fam Corno John 1935 #bp Soisy 1997 + Rempp Zabeth |
− | |||
− | Si vous ne possédez réellement aucune autre information que son nom sur une personne, ajoutez alors le chiffre 0 à son nom, ce qui servira comme une DoB nulle et comme l'indicateur que cette personne ne figure nulle part ailleurs : | + | Si vous ne possédez réellement aucune autre information que son nom sur une personne, ajoutez alors le chiffre 0 à son nom, ce qui servira comme une DoB nulle et comme l'indicateur que cette personne ne figure nulle part ailleurs, et éventuellement deux points d'interrogation séparés par un espace ('''? ?''') indiquant que son épouse est inconnue : |
− | + | ||
− | fam Diemer Patrick 0 + Heidenreich Sylvie 0 | + | fam Diemer Patrick 0 + Heidenreich Sylvie 0 |
− | + | fam Doe John 0 + ? ? | |
+ | |||
+ | ===FamilyEvent structure=== | ||
+ | |||
+ | Cette sous-section est spécifique du format '''gwplus'''. | ||
+ | |||
+ | ''FamilyEventName'' [EventDate] ['''#p''' EventPlace] '''[#s''' EventSource | ||
+ | ['''wit''' ['''m'''|'''f'''| ]: ['''#godp''' | '''#offi''' | ] Person ] # l'option offi (pour officiant) est en cours de développement | ||
+ | ['''note''' Free text (no "_"!) until next ''FamilyEventName'' or '''end_fevt'''] # note is optionnal | ||
+ | |||
+ | ''FamilyEventNames'' | ||
+ | '''#marr''' -> (Efam_Marriage) | ||
+ | '''#nmar''' -> (Efam_NoMarriage) | ||
+ | '''#nmen''' -> (Efam_NoMention) | ||
+ | '''#enga''' -> (Efam_Engage) | ||
+ | '''#div''' -> (Efam_Divorce) | ||
+ | '''#sep''' -> (Efam_Separated) | ||
+ | '''#anul''' -> (Efam_Annulation) | ||
+ | '''#marb''' -> (Efam_MarriageBann) | ||
+ | '''#marc''' -> (Efam_MarriageContract) | ||
+ | '''#marl''' -> (Efam_MarriageLicense) | ||
+ | '''#pacs''' -> (Efam_PACS) | ||
+ | '''#resi''' -> (Efam_Residence) | ||
+ | '''#strng''' -> (Efam_Name strng) | ||
+ | |||
+ | On notera que certains évènements (mariage, divorce…) peuvent être décrits directement dans la structure '''fam''', ou dans une sous-structure '''fevt'''. | ||
+ | Les informations principales (date, lieu…) apparaissent aux deux endroits, mais certaines informations de détail n'apparaissent que dans la sous-rubrique évènement. | ||
== Informations sur la personne == | == Informations sur la personne == | ||
− | Les informations sur la personne peuvent figurer aussi bien sur la rubrique enfant dans une famille, ou dans la rubrique famille si la personne n'est pas mentionnée en tant qu'enfant quelquepart ailleurs. | + | Les informations sur la personne peuvent figurer aussi bien sur la rubrique enfant dans une famille, ou dans la rubrique famille si la personne n'est pas mentionnée en tant qu'enfant quelquepart ailleurs. Les informations sur la personne peuvent même être introduites dans la rubrique relations ('''rel''', voir section ci-bas) s'il est impossible de les définir ailleurs (par exemple, pour un enfant adopté). |
Le strict minimum d'informations pour un parent sont ses patronyme et prénom(s), avec le chiffre 0 comme Date de Naissance (DoB) : | Le strict minimum d'informations pour un parent sont ses patronyme et prénom(s), avec le chiffre 0 comme Date de Naissance (DoB) : | ||
− | |||
− | |||
− | |||
− | Pour un enfant, la DoB n'est pas obligatoire (le nom de famille peut aussi être | + | Corno Yann 0 |
+ | |||
+ | Pour un enfant, la DoB n'est pas obligatoire (le nom de famille peut aussi être omis: celui du père sera alors utilisé). | ||
Pour résumer, la DoB (Date de naissance) est seulement obligatoire si la personne est un Parent, ou si la personne a une date de décès (DoD). Dans ce dernier cas, si la DoB est inconnue, attribuez lui simplement le chiffre 0. | Pour résumer, la DoB (Date de naissance) est seulement obligatoire si la personne est un Parent, ou si la personne a une date de décès (DoD). Dans ce dernier cas, si la DoB est inconnue, attribuez lui simplement le chiffre 0. | ||
Exemple : Maurice, DoB inconnue, décédé en 1935 à Caen : | Exemple : Maurice, DoB inconnue, décédé en 1935 à Caen : | ||
− | + | ||
− | Corno Maurice 0 1935 #dp Caen | + | Corno Maurice 0 1935 #dp Caen |
− | |||
Le format complet pour une personne suit ci-dessous : | Le format complet pour une personne suit ci-dessous : | ||
− | + | ||
− | LastName FirstName [ | + | LastName FirstName[.Number] |
− | + | ['''('''PublicName''')'''] ['''#nick''' Qualifier] | |
+ | ['''{'''FirstNameAlias'''}'''] ['''#salias''' SurnameAlias] ['''#alias''' Alias] | ||
+ | ['''['''Title (see Title section)''']'''] ['''#apubl''' | '''#apriv'''] | ||
+ | ['''#image''' ImageFilePath] | ||
+ | ['''#occu''' Occupation] ['''#src''' PersonSource] | ||
+ | DateOfBirth ['''#bs''' BirthSource] ['''#bp''' PlaceOfBirth] | ||
+ | ['''!'''BaptizeDate] ['''#bp''' BaptizePlace] ['''#bs''' BaptizeSource] | ||
+ | ['''#od'''] [DateOfDeath] ['''#dp''' PlaceOfDeath] ['''#ds''' DeathSource] | ||
+ | ['''#buri''' | '''#crem''' [BurialDate]] ['''#rp''' BurialPlace] ['''#rs''' BurialSource] | ||
* Voir les notes ci-dessus à propos de l'obligation d'attribuer une DoB (Date de naissance) ou pas. | * Voir les notes ci-dessus à propos de l'obligation d'attribuer une DoB (Date de naissance) ou pas. | ||
− | * Dans le cas où vous ne savez pas si la personne vit toujours | + | * Dans le cas où vous ne savez pas si la personne vit toujours, mettez un '''?''' pour la DoD (Date de décès). |
− | * Si vous êtes certain que la personne est décédée, mais ne connaissez pas la date, | + | * Si vous êtes certain que la personne est décédée, mais ne connaissez pas la date, |
− | * Si la personne est décédée jeune, utilisez l'étiquette ' | + | * Si la personne est morte de toute évidence (née il y a plus de 150 ans par exemple) utilisez le tag '''#od''' (évolution après le version GeneWeb 5.?). |
− | * | + | * Si la personne est décédée jeune, utilisez l'étiquette '''#mj''' comme DoD. |
+ | * '''#apubl''' and '''#apriv''' contrôlent l'accès : Public ou Privé. Rien n'est marqué par défaut, ce qui signifie "Si Titres". | ||
Pour spécifier différentes catégories de décès, utilisez ces caractères spéciaux comme préfixe devant la DoD : | Pour spécifier différentes catégories de décès, utilisez ces caractères spéciaux comme préfixe devant la DoD : | ||
− | | | + | {|class="wikitable" style="border-width: 10px; text-align:left;" |
− | | | + | !Type de décès!!Caractère spécial!!Exemple |
− | | | + | |- |
− | | | + | |Tué||k||k10/5/1990 |
− | | | + | |- |
+ | |Assassiné||m||m10/5/1990 | ||
+ | |- | ||
+ | |Exécuté||e||e10/5/1990 | ||
+ | |- | ||
+ | |Disparu||s||s10/5/1990 | ||
+ | |} | ||
− | Utilisez l'étiquette | + | Utilisez l'étiquette '''#buri''' pour spécifier l'enterrement d'une personne, ou '''#crem''' pour une crémation. La date correspondante est optionnelle. |
− | == Titres == | + | === Titres === |
− | Bien que les titres apparaissent simplement comme une autre étiquette dans la rubrique Personne, ils sont décrits séparément dans cette section pour une meilleure compréhension. | + | Bien que les titres apparaissent simplement comme une autre étiquette dans la rubrique Personne, ils sont décrits séparément dans cette section pour une meilleure compréhension. Les Titres sont inclus entre crochets '''[ ]''' (Ooops, désolé de se servir de crochets en tant que descripteur de format…). S'il y en a plusieurs, ils sont simplement ajoutés les uns après les autres, en répétant les paires de crochets. |
− | |||
− | |||
− | |||
− | * Chaque item est séparé par un caractère ':'. Si l'information correspondante n'est pas disponible, laisser l'item vide. | + | [ TitleName:Title:TitlePlace:StartDate:EndDate:Nth] |
− | * Le titre principal est entré en utilisant le signe '*' pour le Nom du Titre. | + | |
+ | * Chaque item est séparé par un caractère '''':''''. Si l'information correspondante n'est pas disponible, laisser l'item vide. | ||
+ | * Le titre principal est entré en utilisant le signe ''''*'''' pour le Nom du Titre. | ||
+ | |||
+ | === Évènements personnels === | ||
+ | |||
+ | Cette sous-section est spécifique du format '''gwplus'''. | ||
+ | |||
+ | '''pevt''' PersonLastName PersonFirstName[.Number] | ||
+ | ''OnePersonEvent'' (multiples) | ||
+ | '''end pevt''' | ||
+ | |||
+ | Chaque ''OnePersonEvent'' a la structure suivante : | ||
+ | |||
+ | ''PersonEventName'' [EventDate] ['''#p''' EventPlace] ['''#s''' EventSource] | ||
+ | ['''wit''' ['''m'''|'''f'''| ]: ['''#godp''' | '''#offi''' | ] Person ] # l'option offi (pour officiant) est en cours de développement | ||
+ | ['''note''' Free text (no "_"!) until next ''PersonEventName'' or '''end_pevt'''] | ||
+ | |||
+ | ''PersonEventNames'' | ||
+ | '''#birt''' -> (Epers_Birth) | ||
+ | '''#bapt''' -> (Epers_Baptism) | ||
+ | '''#deat''' -> (Epers_Death) | ||
+ | '''#buri''' -> (Epers_Burial) | ||
+ | '''#crem''' -> (Epers_Cremation) | ||
+ | '''#acco''' -> (Epers_Accomplishment) | ||
+ | '''#acqu''' -> (Epers_Acquisition) | ||
+ | '''#adhe''' -> (Epers_Adhesion) | ||
+ | '''#bapl''' -> (Epers_BaptismLDS) | ||
+ | '''#barm''' -> (Epers_BarMitzvah) | ||
+ | '''#basm''' -> (Epers_BatMitzvah) | ||
+ | '''#bles''' -> (Epers_Benediction) | ||
+ | '''#cens''' -> (Epers_Recensement) | ||
+ | '''#chgn''' -> (Epers_ChangeName) | ||
+ | '''#circ''' -> (Epers_Circumcision) | ||
+ | '''#conf''' -> (Epers_Confirmation) | ||
+ | '''#conl''' -> (Epers_ConfirmationLDS) | ||
+ | '''#degr''' -> (Epers_Diploma) | ||
+ | '''#awar''' -> (Epers_Decoration) | ||
+ | '''#demm''' -> (Epers_DemobilisationMilitaire) | ||
+ | '''#dist''' -> (Epers_Distinction) | ||
+ | '''#endl''' -> (Epers_Dotation) | ||
+ | '''#dotl''' -> (Epers_DotationLDS) | ||
+ | '''#educ''' -> (Epers_Education) | ||
+ | '''#elec''' -> (Epers_Election) | ||
+ | '''#emig''' -> (Epers_Emigration) | ||
+ | '''#exco''' -> (Epers_Excommunication) | ||
+ | '''#flkl''' -> (Epers_FamilyLinkLDS) | ||
+ | '''#fcom''' -> (Epers_FirstCommunion) | ||
+ | '''#fune''' -> (Epers_Funeral) | ||
+ | '''#grad''' -> (Epers_Graduate) | ||
+ | '''#hosp''' -> (Epers_Hospitalisation) | ||
+ | '''#illn''' -> (Epers_Illness) | ||
+ | '''#immi''' -> (Epers_Immigration) | ||
+ | '''#lpas''' -> (Epers_ListePassenger) | ||
+ | '''#mdis''' -> (Epers_MilitaryDistinction) | ||
+ | '''#mpro''' -> (Epers_MilitaryPromotion) | ||
+ | '''#mser''' -> (Epers_MilitaryService) | ||
+ | '''#mobm''' -> (Epers_MobilisationMilitaire) | ||
+ | '''#natu''' -> (Epers_Naturalisation) | ||
+ | '''#occu''' -> (Epers_Occupation) | ||
+ | '''#ordn''' -> (Epers_Ordination) | ||
+ | '''#prop''' -> (Epers_Property) | ||
+ | '''#cens''' -> (Epers_Recensement) | ||
+ | '''#resi''' -> (Epers_Residence) | ||
+ | '''#reti''' -> (Epers_Retired) | ||
+ | '''#slgc''' -> (Epers_ScellentChildLDS) | ||
+ | '''#slgp''' -> (Epers_ScellentParentLDS) | ||
+ | '''#slgs''' -> (Epers_ScellentSpouseLDS) | ||
+ | '''#vteb''' -> (Epers_VenteBien) | ||
+ | '''#will''' -> (Epers_Will) | ||
+ | '''#strng''' -> (Epers_Name strng) | ||
== Notes == | == Notes == | ||
− | Les notes sont stockées | + | Les notes sont stockées séparément dans le fichier, entre les marqueurs '''notes''' et '''end notes''' et sont associées à un individu : |
− | + | ||
− | notes LastName FirstName[.Number] | + | '''notes''' LastName FirstName[.Number] |
− | beg | + | '''beg''' |
− | Notes go here in a free format | + | Notes go here in a totally free format |
− | end notes | + | (HTML tags can be inserted here. See the -tags option for '''gwd''' and [[Tags|tags.txt]] file)) |
− | + | '''end notes''' | |
== Relations == | == Relations == | ||
− | Les relations sont aussi stockées séparément, comme les notes. Elles font référence aux individus de la même façon | + | Les relations sont aussi stockées séparément, comme les notes. Elles font référence aux individus de la même façon. |
+ | Dans la liste qui suit, tous les marqueurs sont mentionnés, ce qui n'arrive en fait jamais bien sûr. | ||
+ | |||
+ | '''rel''' LastName FirstName[.Number] | ||
+ | '''beg''' | ||
+ | '''- adop''': AdoptiveFather '''+''' AdoptiveMother | ||
+ | '''- adop fath''' : AdoptiveFather | ||
+ | '''- adop moth''' : AdoptiveMother | ||
+ | '''- reco''': RecognizingFather '''+''' RecognizingMother | ||
+ | '''- reco fath''' : RecognizingFather | ||
+ | '''- reco moth''' : RecognizingMother | ||
+ | '''- cand''': CandidateFather '''+''' CandidateMother | ||
+ | '''- cand fath''' : CandidateFather | ||
+ | '''- cand moth''' : CandidateMother | ||
+ | '''- godp''': GodFather '''+''' GodMother | ||
+ | '''- godp fath''' : GodFather | ||
+ | '''- godp moth''' : GodMother | ||
+ | '''- fost''': FosterFather '''+''' FosterMother | ||
+ | '''- fost fath''' : FosterFather | ||
+ | '''- fost moth''' : FosterMother | ||
+ | '''end''' | ||
+ | |||
+ | == DataBaseNote == | ||
+ | |||
+ | The DataBase Note is the text that appears when one clicks on the "Note de présentation" tag of the Welcome page. | ||
+ | |||
+ | '''notes-db''' | ||
+ | Free text starting with two spaces (including HTML and WiKi syntax formatting) | ||
+ | '''end notes-db''' | ||
+ | |||
+ | == ExtendedPages == | ||
+ | |||
+ | Extended pages are pages referenced within persons notes using the WiKi syntax [[[ExtendedPageName/Free text]]]. | ||
+ | The same syntax can be used within extended pages themselves. | ||
+ | |||
+ | '''# extended page''' PageName '''used by:''' | ||
+ | '''# - person''' PersonFirstName[.Number] PersonLastName # multiple lines indicating usage by Person | ||
+ | '''# - extended page''' PageName # or by other ExtendedPage | ||
+ | '''page-ext''' PageName | ||
+ | Free text with two spaces at the beginning of each line. | ||
+ | Free text may contain HTML and WiKi formatting commands. | ||
+ | Continued free text | ||
+ | '''end page-ext''' | ||
+ | |||
+ | == WizardPage == | ||
+ | |||
+ | '''Wizard-note''' ''Wizard_name'' | ||
+ | timestamp # timestamp de la date de création de la page, calculé comme le nombre de secondes depuis le 1er janvier 1970 (epoch au sens unix) | ||
+ | Free text following WiKiText format describing the wizard and his activities. | ||
+ | Each line begins with two spaces. | ||
+ | '''end wizard-note''' | ||
+ | |||
+ | Chaque magicien autorisé à faire des modifications dans une base peut disposer d'une page expliquant qui il est, et la nature de ses activités. | ||
+ | Si le paramètre {{c|authorized_wizards_notes}} est positionné à {{c|yes}} dans le fichier {{c|basename.gwf}}, la page d'accueil proposera un lien permettant de consulter ces pages, triées par ordre alphabétique. | ||
+ | |||
+ | Chaque magicien a la possibilité de modifier sa page (a valider!). | ||
− | + | {{manuel}} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
[[Category:Manuel]] | [[Category:Manuel]] |
Revision as of 17:16, 9 November 2018
![]() |
English • français |
---|
Le format GW est celui d'un fichier source à partir duquel GeneWeb peut construire une base généalogique (en utilisant la commande gwc). GeneWeb peut aussi bien sur produire un fichier au format GW à partir d'une base généalogique existante (en utilisant la commande gwu). Le format GW contient toutes les informations d'une base de données GeneWeb sous une forme textuelle compatible avec tous les éditeurs de texte permettant une édition manuelle, et aisément manipulable par d'autres programmes. Un fichier au format GW est la meilleure sauvegarde de votre base de données, et le meilleur moyen d'échanger de données avec d'autres programmes compatibles. Pour mémoire, GeneWeb accepte et produit aussi le format GEDCOM, mais une certaine ambiguité de cette norme n'en fait pas le moyen de sauvegarde idéal.
Avec la version 7.00 de GeneWeb, le format GW a été augmenté (gwplus, voir la section structure générale d'un fichier gw ci-dessous).
À ce jour, un fichier au format GW ne conserve pas la mémoire de la version de GeneWeb avec lequel il a été créé. Ceci pourrait changer.
Attention : les versions antérieures à GeneWeb 7.00 ne savent pas lire le format gwplus et perdraient les informations qui y
sont stockées (Quel est le comportement exact?).
Il existe cependant pour la compatibilité descendante une option de gwu (-old_gw) qui produit un fichier au format gw ancien et reporte en notes tout ce qui est incompatible.
Note : quelques morceaux de cette page sont encore en anglais!! Elles seront traduites sous peu.
Guide des styles
- Le texte devant apparaître 'tel quel' est écrit en caractères gras.
- Les mots en italique seront remplacés par leur valeur actuelle. La première lettre de ces noms est une majuscule, e.g. HusbandLastName
- Les paramètres entre [crochets] sont optionnels: ils peuvent être ommis.
- Les mots séparés par des barres verticales '|' signifient des choix : un seul de ceux-ci doit être utilisé.
Exemple de définition :
fam HusbandLastName FirstName[.Number] + [WeddingDate] [#mp WeddingPlace] WifeLastName FirstName[.Number]
Exemples valides:
fam CORNO Joseph_Marie_Vincent + THOMAS Marie_Julienne fam CORNO Alain.1 +25/11/1728 #mp Ile-aux-Moines CAUZIC Marie
Dates
Les formats de dates sont les suivants: dd/mm/yyyy, yyyy, mm/yyyy. Dans certains cas, si vous devez donner une date mais que vous ne la connaissiez pas, entrez seulement 0.
Les modificateurs de date utilisent des caractères spéciaux pour préfixes, afin de spécifier "vers", "avant", "peut-être" "après" etc.
Type de date | Caractère spécial | Exemple |
---|---|---|
Vers | ~ | ~10/5/1990 |
Peut-être | ? | ?10/5/1990 |
Avant | < | <10/5/1990 |
Après | > | >10/5/1990 |
Ou | | | 10/5/1990|1991 |
Entre | ... | 10/5/1990...1991 |
Le calendrier est de type Grégorien par défaut. Pour le type Julien, ajoutez "J" à la date, "F" pour le type Français Républicain, et "H" pour l'Hébreu. Exemple : 10/9/5750H
Pour obtenir une date en texte simple, mettez le chiffre 0 et placez des parenthèses de cette façon :
0(5_Mai_1990)
Chaînes de caractères
Les espaces dans les chaînes de caractères sont remplacés par des tirets bas "_" (sauf dans les notes et dans certains commentaires) : Marie_Julienne
Les capitales ASCII correspondent à la norme ISO-8859-1.
Référencement des individus
Une même personne peut être référencée plusieurs fois dans un fichier; en tant que parent, ou enfant, ou encore dans une note. Nom de famille, Prénom et numéro (s'il existe) doivent correspondre exactement, sans cela le programme ne pourra pas déterminer un même individu et lier ses références ensemble.
Structure générale d'un fichier gw
[encoding: utf-8] # (optionnal) redefines text encoding to be utf-8 instead of iso-8859-1 [gwplus] # (optionnal) specifies that this file follows the gwplus instead of gw format
suivi par un nombre quelconque de blocks :
Family # début de block : fam PersonalNote # début de block : notes Relations # début de block : rel PersonEvents # début de block : pevt (specific to gwplus) DataBaseNotes # début de block : notes-db (only one) ExtendedPages # début de block : pages-ext WizardNotes # début de block : wizard-note (possibly one for each wizard)
On verra dans les sections ci-dessous le token de fin de block pour chacun d'eux.
Principale structure : la famille
Le format du fichier est basé sur les Familles. Une famille comprend l'époux et sa femme, et liste les enfants. L'information personnelle (DoB, etc.) est située au niveau enfant. Si un individu n'a aucun parent, ses informations personnelles sont alors insérées directement après son nom dans la rubrique famille.
En conséquence, il faut bien noter que les personnes considérées "isolées" dans la base de données GeneWeb ne seront pas exportées dans le fichier GW. C'est aussi de cette façon que les individus supprimés de la base sont effacés lors d'une séquence gwu/gwc : ils ne sont tout simplement pas exportés.
1er cas : L'époux et sa femme sont tous les deux listés quelque part en tant qu'enfants d'une famille parente.
fam HusbandLastName FirstName[.Number] +[WeddingDate] [#sep | - DivorceDate] [#nm | #eng] [#mp WeddingPlace] [#ms WeddingSource] WifeLastName FirstName[.Number] [src Family source] [comm Family comments in free format] [wit [m|f| ]: Witness (use Person format, see Person Information section) ] [cbp common children birth place] [csrc common children source] [fevt FamilyEvent (multiples) end fevt] [beg - [h | f | ] Person (see detailed description at the next section) end]
- Si les parents ne sont pas mariés (relation), insérez l'étiquette #nm. S'ils sont fiancés, utilisez #eng.
- Si les parents sont séparés, utilisez #sep. Ou bien s'ils sont divorcés, utilisez - et ajoutez la date du divorce juste après (optionnel).
- Si le ChildLastName est omis, le patronyme du père est utilisé.
- Les étiquettes src, comm et wit suivent sur des lignes séparées, après l'étiquette fam. Ils sont optionnels.
- Si le sexe de l'enfant n'est pas connu, ne mettez rien (pas de h ni de f) après le - (tiret).
Si une famille n'a pas d'enfants, vous pouvez sauter toute la séquence des étiquettes beg/end :
fam HEYDENREICH Gaspard +1719 TRESCH Rosine_Catherine
2ème cas : L'époux ou sa femme ne sont listés nulle part en tant qu'enfants d'une autre famille. Entrez simplement leurs informations personnelles, comme vous le feriez pour un enfant. Voir la section #Informations sur la personne ci-dessous pour plus de détails sur les informations personnelles de chaque individu.
Exemple : John Corno (o 1935 at Soisy, +1997) L'information est directement mise dans la rubrique famille, car cette personne n'est listée nulle part ailleurs:
fam Corno John 1935 #bp Soisy 1997 + Rempp Zabeth
Si vous ne possédez réellement aucune autre information que son nom sur une personne, ajoutez alors le chiffre 0 à son nom, ce qui servira comme une DoB nulle et comme l'indicateur que cette personne ne figure nulle part ailleurs, et éventuellement deux points d'interrogation séparés par un espace (? ?) indiquant que son épouse est inconnue :
fam Diemer Patrick 0 + Heidenreich Sylvie 0 fam Doe John 0 + ? ?
FamilyEvent structure
Cette sous-section est spécifique du format gwplus.
FamilyEventName [EventDate] [#p EventPlace] [#s EventSource [wit [m|f| ]: [#godp | #offi | ] Person ] # l'option offi (pour officiant) est en cours de développement [note Free text (no "_"!) until next FamilyEventName or end_fevt] # note is optionnal FamilyEventNames #marr -> (Efam_Marriage) #nmar -> (Efam_NoMarriage) #nmen -> (Efam_NoMention) #enga -> (Efam_Engage) #div -> (Efam_Divorce) #sep -> (Efam_Separated) #anul -> (Efam_Annulation) #marb -> (Efam_MarriageBann) #marc -> (Efam_MarriageContract) #marl -> (Efam_MarriageLicense) #pacs -> (Efam_PACS) #resi -> (Efam_Residence) #strng -> (Efam_Name strng)
On notera que certains évènements (mariage, divorce…) peuvent être décrits directement dans la structure fam, ou dans une sous-structure fevt. Les informations principales (date, lieu…) apparaissent aux deux endroits, mais certaines informations de détail n'apparaissent que dans la sous-rubrique évènement.
Informations sur la personne
Les informations sur la personne peuvent figurer aussi bien sur la rubrique enfant dans une famille, ou dans la rubrique famille si la personne n'est pas mentionnée en tant qu'enfant quelquepart ailleurs. Les informations sur la personne peuvent même être introduites dans la rubrique relations (rel, voir section ci-bas) s'il est impossible de les définir ailleurs (par exemple, pour un enfant adopté).
Le strict minimum d'informations pour un parent sont ses patronyme et prénom(s), avec le chiffre 0 comme Date de Naissance (DoB) :
Corno Yann 0
Pour un enfant, la DoB n'est pas obligatoire (le nom de famille peut aussi être omis: celui du père sera alors utilisé).
Pour résumer, la DoB (Date de naissance) est seulement obligatoire si la personne est un Parent, ou si la personne a une date de décès (DoD). Dans ce dernier cas, si la DoB est inconnue, attribuez lui simplement le chiffre 0.
Exemple : Maurice, DoB inconnue, décédé en 1935 à Caen :
Corno Maurice 0 1935 #dp Caen
Le format complet pour une personne suit ci-dessous :
LastName FirstName[.Number] [(PublicName)] [#nick Qualifier] [{FirstNameAlias}] [#salias SurnameAlias] [#alias Alias] [[Title (see Title section)]] [#apubl | #apriv] [#image ImageFilePath] [#occu Occupation] [#src PersonSource] DateOfBirth [#bs BirthSource] [#bp PlaceOfBirth] [!BaptizeDate] [#bp BaptizePlace] [#bs BaptizeSource] [#od] [DateOfDeath] [#dp PlaceOfDeath] [#ds DeathSource] [#buri | #crem [BurialDate]] [#rp BurialPlace] [#rs BurialSource]
- Voir les notes ci-dessus à propos de l'obligation d'attribuer une DoB (Date de naissance) ou pas.
- Dans le cas où vous ne savez pas si la personne vit toujours, mettez un ? pour la DoD (Date de décès).
- Si vous êtes certain que la personne est décédée, mais ne connaissez pas la date,
- Si la personne est morte de toute évidence (née il y a plus de 150 ans par exemple) utilisez le tag #od (évolution après le version GeneWeb 5.?).
- Si la personne est décédée jeune, utilisez l'étiquette #mj comme DoD.
- #apubl and #apriv contrôlent l'accès : Public ou Privé. Rien n'est marqué par défaut, ce qui signifie "Si Titres".
Pour spécifier différentes catégories de décès, utilisez ces caractères spéciaux comme préfixe devant la DoD :
Type de décès | Caractère spécial | Exemple |
---|---|---|
Tué | k | k10/5/1990 |
Assassiné | m | m10/5/1990 |
Exécuté | e | e10/5/1990 |
Disparu | s | s10/5/1990 |
Utilisez l'étiquette #buri pour spécifier l'enterrement d'une personne, ou #crem pour une crémation. La date correspondante est optionnelle.
Titres
Bien que les titres apparaissent simplement comme une autre étiquette dans la rubrique Personne, ils sont décrits séparément dans cette section pour une meilleure compréhension. Les Titres sont inclus entre crochets [ ] (Ooops, désolé de se servir de crochets en tant que descripteur de format…). S'il y en a plusieurs, ils sont simplement ajoutés les uns après les autres, en répétant les paires de crochets.
[ TitleName:Title:TitlePlace:StartDate:EndDate:Nth]
- Chaque item est séparé par un caractère ':'. Si l'information correspondante n'est pas disponible, laisser l'item vide.
- Le titre principal est entré en utilisant le signe '*' pour le Nom du Titre.
Évènements personnels
Cette sous-section est spécifique du format gwplus.
pevt PersonLastName PersonFirstName[.Number] OnePersonEvent (multiples) end pevt
Chaque OnePersonEvent a la structure suivante :
PersonEventName [EventDate] [#p EventPlace] [#s EventSource] [wit [m|f| ]: [#godp | #offi | ] Person ] # l'option offi (pour officiant) est en cours de développement [note Free text (no "_"!) until next PersonEventName or end_pevt] PersonEventNames #birt -> (Epers_Birth) #bapt -> (Epers_Baptism) #deat -> (Epers_Death) #buri -> (Epers_Burial) #crem -> (Epers_Cremation) #acco -> (Epers_Accomplishment) #acqu -> (Epers_Acquisition) #adhe -> (Epers_Adhesion) #bapl -> (Epers_BaptismLDS) #barm -> (Epers_BarMitzvah) #basm -> (Epers_BatMitzvah) #bles -> (Epers_Benediction) #cens -> (Epers_Recensement) #chgn -> (Epers_ChangeName) #circ -> (Epers_Circumcision) #conf -> (Epers_Confirmation) #conl -> (Epers_ConfirmationLDS) #degr -> (Epers_Diploma) #awar -> (Epers_Decoration) #demm -> (Epers_DemobilisationMilitaire) #dist -> (Epers_Distinction) #endl -> (Epers_Dotation) #dotl -> (Epers_DotationLDS) #educ -> (Epers_Education) #elec -> (Epers_Election) #emig -> (Epers_Emigration) #exco -> (Epers_Excommunication) #flkl -> (Epers_FamilyLinkLDS) #fcom -> (Epers_FirstCommunion) #fune -> (Epers_Funeral) #grad -> (Epers_Graduate) #hosp -> (Epers_Hospitalisation) #illn -> (Epers_Illness) #immi -> (Epers_Immigration) #lpas -> (Epers_ListePassenger) #mdis -> (Epers_MilitaryDistinction) #mpro -> (Epers_MilitaryPromotion) #mser -> (Epers_MilitaryService) #mobm -> (Epers_MobilisationMilitaire) #natu -> (Epers_Naturalisation) #occu -> (Epers_Occupation) #ordn -> (Epers_Ordination) #prop -> (Epers_Property) #cens -> (Epers_Recensement) #resi -> (Epers_Residence) #reti -> (Epers_Retired) #slgc -> (Epers_ScellentChildLDS) #slgp -> (Epers_ScellentParentLDS) #slgs -> (Epers_ScellentSpouseLDS) #vteb -> (Epers_VenteBien) #will -> (Epers_Will) #strng -> (Epers_Name strng)
Notes
Les notes sont stockées séparément dans le fichier, entre les marqueurs notes et end notes et sont associées à un individu :
notes LastName FirstName[.Number] beg Notes go here in a totally free format (HTML tags can be inserted here. See the -tags option for gwd and tags.txt file)) end notes
Relations
Les relations sont aussi stockées séparément, comme les notes. Elles font référence aux individus de la même façon. Dans la liste qui suit, tous les marqueurs sont mentionnés, ce qui n'arrive en fait jamais bien sûr.
rel LastName FirstName[.Number] beg - adop: AdoptiveFather + AdoptiveMother - adop fath : AdoptiveFather - adop moth : AdoptiveMother - reco: RecognizingFather + RecognizingMother - reco fath : RecognizingFather - reco moth : RecognizingMother - cand: CandidateFather + CandidateMother - cand fath : CandidateFather - cand moth : CandidateMother - godp: GodFather + GodMother - godp fath : GodFather - godp moth : GodMother - fost: FosterFather + FosterMother - fost fath : FosterFather - fost moth : FosterMother end
DataBaseNote
The DataBase Note is the text that appears when one clicks on the "Note de présentation" tag of the Welcome page.
notes-db Free text starting with two spaces (including HTML and WiKi syntax formatting) end notes-db
ExtendedPages
Extended pages are pages referenced within persons notes using the WiKi syntax [[[ExtendedPageName/Free text]]]. The same syntax can be used within extended pages themselves.
# extended page PageName used by: # - person PersonFirstName[.Number] PersonLastName # multiple lines indicating usage by Person # - extended page PageName # or by other ExtendedPage page-ext PageName Free text with two spaces at the beginning of each line. Free text may contain HTML and WiKi formatting commands. Continued free text end page-ext
WizardPage
Wizard-note Wizard_name timestamp # timestamp de la date de création de la page, calculé comme le nombre de secondes depuis le 1er janvier 1970 (epoch au sens unix) Free text following WiKiText format describing the wizard and his activities. Each line begins with two spaces. end wizard-note
Chaque magicien autorisé à faire des modifications dans une base peut disposer d'une page expliquant qui il est, et la nature de ses activités.
Si le paramètre authorized_wizards_notes
est positionné à yes
dans le fichier basename.gwf
, la page d'accueil proposera un lien permettant de consulter ces pages, triées par ordre alphabétique.
Chaque magicien a la possibilité de modifier sa page (a valider!).
Manuel GeneWeb
- Télécharger et installer GeneWeb sous GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD ou en mode CGI derrière un serveur web.
- Comprendre le principe du serveur GeneWeb, les homonymes, la consanguinité.
Utiliser et gérer une base généalogique
- Importer un fichier Gedcom
.ged
ou GeneWeb.gw
avec gwsetup ou en lignes de commandes. - Mettre à jour les données (ajouter/modifier/supprimer personnes et familles), fusionner les doublons, saisir des dates.
- Utiliser la syntaxe wikitext, les macros, les raccourcis claviers.
- Nettoyer, restaurer, renommer, sauvegarder, archiver une base.
- Fusionner plusieurs bases et diviser une base.
Annexe technique
- Personnaliser avec CSS, entête et pieds de page, templates, lexique et déclinaisons.
- Fichier de configuration
.gwf
(pour templm), mots de passe pour amis et magiciens et restrictions d'accès à une base. - Ajouter une image dans les notes.
- Autres commentaires pour les experts.