Le format de fichier .gw

Language:	English • français

Le format GW est celui d'un fichier texte qui peut être affiché par GeneWeb en utilisant la commande gwu. Il contient toutes les informations d'une base de données GeneWeb de façon que celles-ci puissent aisément être traitées par d'autres programmes, ou modifiées manuellement dans son éditeur de texte favori. Vous pouvez alors reconstruire une base de données en utilisant la commande *gwc*. Le format GW permet aussi de faire facilement des sauvegardes de votre base de données, d'échanger ces données avec d'autres programmes, etc.

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 :

 fam HusbandLastName FirstName[.Number] + [WeddingDate] [#mp WeddingPlace] WifeLastName FirstName[.Number]

produit les lignes suivantes 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->|=. l|=. 10/5/1990l1991 | |=. <-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 (si 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.

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éees 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 quelquepart 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: Witness (use Person format, see Person Information section) ]
beg
- [h | f | ] Person (see detailed description at the next section)
end

• Si les parents ne sont pas marriés (relation), insérez l'étiquette *#nm*. Si ils sont fiancés, utilisez *#eng*.
• Si les parents sont séparés, utilisez *#sep*. Ou bien si ils sont divorcés, utilisez '-' et ajoutez la date du divorce juste après (optionnel).
• Si le *_ChildLastName_* est ommis, 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.

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 :

fam Diemer Patrick 0 + Heidenreich Sylvie 0

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.

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 ommis: 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 [{FirstNameAlias}] [#salias SurnameAlias] [(PublicName)] [#image ImageFilePath] [#nick Qualifier] [#alias Alias] [Titles (see Title section)] [#apubl | #apriv] [#occu Occupation] [#src PersonSource] DateOfBirth [#bs BirthSource] [#bp PlaceOfBirth] [!BaptizeDate] [#pp BaptizePlace] [#ps BaptizeSource] [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 ("Ne sais pas" item dans la section Décès), 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, mettez le chiffre '0' pour la DoD.
• Si la personne est décédée jeune, utilisez l'étiquette '*mj*' comme DoD.
• *#apubl* and *#apriv* controllent 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…). Si 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.

Notes

Les notes sont stockées séparémment dans le fichier, entre les marqueurs *notes* et *end notes* :

notes LastName FirstName[.Number]
beg
Notes go here in a free format
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 qu'un enfant à une famille. 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