description du format gwplus

[fablhx]

la seule description formelle du format gw se trouve [[http://pauillac.inria.fr/~ddr/GeneWeb/en/gwformat.htm]] et ne concerne que geneweb version 5
une version actualisée du format fwplus permettrait aux logiciels tiers d exporter vers geneanet beaucoup plus facilement et permettrait surtout de ne pas perdre d'informations dans le transfert

[sam-m888]

(Google translate: the only formal description of the gw format you can find is [[http://pauillac.inria.fr/~ddr/GeneWeb/en/gwformat.htm]] and that concerns only geneweb Version 5
an updated version of fwplus size would allow third party software to export to geneanet much easier and especially would not lose information in the transfer )

For example:
The Gramps-project : 8548 Update GeneWeb file format on import (.gw) by supporting gwplus

• https://github.com/gramps-project/gramps/blob/master/gramps/plugins/importer/importgeneweb.py
• https://github.com/gramps-project/gramps/blob/master/gramps/plugins/export/exportgeneweb.py

[fablhx]

here is a first pass.
Will see later to "beautify" it into html and integrate with the previous document.
Cheers,

Henri

1/ The main structure of a .gw file is as follows:
[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
any number of the following :
Family # start token is fam
PersonalNote # start token is notes
Relations # start token id rel
PersonEvents # start token is pevt
DataBaseNotes # start token is notes-db
ExtendedPages # start token is pages-ext
WizardNotes # start token is wizard-note
# What are Wizard note? Only one? Last of sequence?
2/ Family
fam HusbandLastName HusbandFirstName[.Number] +[WeddingDate] ...WifeLastName WifeFirstName[.Number]
[
fevt
FamilyEvent (multiples)
end fevt
]
beg

• [h|f| ] Person (multiples)(see detailed description at next section)
  end
  FamilyEvent structure
  #FamilyEventName [EventDate] [#p EventPlace] [#s EventSource]
  [wit [h|f| ] Person (see detailed description at next section)] # witness optionnal
  [note Free text (no ""!) until next event or "end_pevt"] # note 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)
  "#resi" -> (Efam_Residence)
  2/ Person
  The definition of a Person follows the same structure as in gw 5.00, with the exception of the
  addition of the term #od to signify "Obviously Dead"
  3/ PersonalNotes
  Same as gw 5.00
  notes LastNAme FirstNBame[.Number]
  beg
  Notes go there in a free format
  end notes
  4/ Relations
  Same as with gw 5.00
  5/ PersonEvents
  PersonEvents structure
  pevt PersonLastName PersonFirstName[.Number]
  OnePersonEvent (multiples)
  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)
  "#awar" -> (Epers_Decoration)
  "#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)
  "#demm" -> (Epers_DemobilisationMilitaire)
  "#dist" -> (Epers_Distinction)
  "#dotl" -> (Epers_DotationLDS)
  "#educ" -> (Epers_Education)
  "#elec" -> (Epers_Election)
  "#emig" -> (Epers_Emigration)
  "#endl" -> (Epers_Dotation)
  "#exco" -> (Epers_Excommunication)
  "#fcom" -> (Epers_FirstCommunion)
  "#flkl" -> (Epers_FamilyLinkLDS)
  "#fune" -> (Epers_Funeral)
  "#grad" -> (Epers_Graduate)
  "#hosp" -> (Epers_Hospitalisation)
  "#illn" -> (Epers_Illness)
  "#immi" -> (Epers_Immigration)
  "#lpas" -> (Epers_ListePassenger)
  "#mdis" -> (Epers_MilitaryDistinction)
  "#mobm" -> (Epers_MobilisationMilitaire)
  "#mpro" -> (Epers_MilitaryPromotion)
  "#mser" -> (Epers_MilitaryService)
  "#natu" -> (Epers_Naturalisation)
  "#occu" -> (Epers_Occupation)
  "#ordn" -> (Epers_Ordination)
  "#prop" -> (Epers_Property)
  "#resi" -> (Epers_Residence)
  "#reti" -> (Epers_Retired)
  "#slgc" -> (Epers_ScellentChildLDS)
  "#slgp" -> (Epers_ScellentParentLDS)
  "#slgs" -> (Epers_ScellentSpouseLDS)
  "#vteb" -> (Epers_VenteBien)
  "#will" -> (Epers_Will)
  OnePersonEvent structure
  #PersonEventName [EventDate] [#p EventPlace] [#s EventSource]
  [wit [h|f| ] Person (see detailed description at next section)] # witness optionnal
  [note Free text (no ""!) until next event or "end_pevt"] # note optionnal
  6/ DataBaseNotes
  Same as in gw 5.00
  7/ ExtendedPages

  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 (two spaces at the beginning of each line)
  Continued free text
  end page-ext
  8/ WizardPage
  What is this?? Structure?

[fablhx]

Update Family format (cbp and csrc tags):
2/ Family
fam HusbandLastName HusbandFirstName[.Number] +[WeddingDate] ...WifeLastName WifeFirstName[.Number]
[cbp BirthPlace] # if multiple children have same BirthPlace
[csrc Source] # if multiple children have same Source value
[
fevt
FamilyEvent (multiples)
end fevt
]
beg

• [h|f| ] Person (multiples)(see detailed description at next section)
  end

[fablhx]

The only description of the gw format is here [[http://pauillac.inria.fr/~ddr/GeneWeb/en/gwformat.htm]] and is about geneweb 5
It would be nice to have an updated version for gw-plus. It would permit for other software to tansfert date to geneanet with a minimal loss of information.

[hgouraud]

For clarity (no change from last post on GeneWeb.org)

1/ The main structure of a .gw file is as follows:

[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

any number of the following :

Family # start token is fam
PersonalNote # start token is notes
Relations # start token is rel
PersonEvents # start token is pevt
DataBaseNotes # start token is notes-db
ExtendedPages # start token is pages-ext

WizardNotes # start token is wizard-note
# What are Wizard note? Only one? Last of sequence?

2/ Family

fam HusbandLastName HusbandFirstName[.Number] +[WeddingDate] ...WifeLastName WifeFirstName[.Number]
[cbp BirthPlace] # if multiple children have same BirthPlace
[csrc Source] # if multiple children have same Source value
[
fevt
FamilyEvent (multiples)
end fevt
]
beg

• [h|f| ] Person (multiples)(see detailed description at next section)
  end

FamilyEvent structure
#FamilyEventName [EventDate] [#p EventPlace] [#s EventSource]
[wit [h|f| ] Person (see detailed description at next section)] # witness optionnal
[note Free text (no "_"!) until next event or "end_pevt"] # note 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)
"#resi" -> (Efam_Residence)

2/ Person

The definition of a Person follows the same structure as in gw 5.00, with the exception of the
addition of the term #od to signify "Obviously Dead"

3/ PersonalNotes

Same as gw 5.00

notes LastNAme FirstNBame[.Number]
beg
Notes go there in a free format
end notes

4/ Relations

Same as with gw 5.00

5/ PersonEvents

PersonEvents structure
pevt PersonLastName PersonFirstName[.Number]
OnePersonEvent (multiples)
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)
"#awar" -> (Epers_Decoration)
"#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)
"#demm" -> (Epers_DemobilisationMilitaire)
"#dist" -> (Epers_Distinction)
"#dotl" -> (Epers_DotationLDS)
"#educ" -> (Epers_Education)
"#elec" -> (Epers_Election)
"#emig" -> (Epers_Emigration)
"#endl" -> (Epers_Dotation)
"#exco" -> (Epers_Excommunication)
"#fcom" -> (Epers_FirstCommunion)
"#flkl" -> (Epers_FamilyLinkLDS)
"#fune" -> (Epers_Funeral)
"#grad" -> (Epers_Graduate)
"#hosp" -> (Epers_Hospitalisation)
"#illn" -> (Epers_Illness)
"#immi" -> (Epers_Immigration)
"#lpas" -> (Epers_ListePassenger)
"#mdis" -> (Epers_MilitaryDistinction)
"#mobm" -> (Epers_MobilisationMilitaire)
"#mpro" -> (Epers_MilitaryPromotion)
"#mser" -> (Epers_MilitaryService)
"#natu" -> (Epers_Naturalisation)
"#occu" -> (Epers_Occupation)
"#ordn" -> (Epers_Ordination)
"#prop" -> (Epers_Property)
"#resi" -> (Epers_Residence)
"#reti" -> (Epers_Retired)
"#slgc" -> (Epers_ScellentChildLDS)
"#slgp" -> (Epers_ScellentParentLDS)
"#slgs" -> (Epers_ScellentSpouseLDS)
"#vteb" -> (Epers_VenteBien)
"#will" -> (Epers_Will)

OnePersonEvent structure
#PersonEventName [EventDate] [#p EventPlace] [#s EventSource]
[wit [h|f| ] Person (see detailed description at next section)] # witness optionnal
[note Free text (no "_"!) until next event or "end_pevt"] # note optionnal

6/ DataBaseNotes

Same as in gw 5.00

7/ ExtendedPages

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 (two spaces at the beginning of each line. Is this mandatory???)
Continued free text
end page-ext

8/ WizardPage

What is this?? Structure?

[a2line]

Doc for gw format is now on GeneWeb wiki (french version).