GeneWeb - Il formato GW

Il formato GW è quello di un file testo che è possibile visualizzare con GeneWeb utilizzando il comando gwu. Questo file contiene tutte le informazioni di una base di dati GeneWeb in modo che queste possano essere trattate da altri programmi o modificate manualmente mediante un text editor. Con il comando gwc, potete anche ricostruire una base di dati GeneWeb partendo da un file. Il formato GW permette anche di effettuare agevolmente delle copie di sicurezza delle vostre basi di dati, di scambiare questi dati con altri programmi, ecc.

	1. Guida degli stili
	2. Date
	3. Stringhe di caratteri
	4. Recensimento degli individui
	5. La struttura principale: la Famiglia
	6. Informazioni sulla Persona
	7. Titoli
	8. Note
	9. Relazioni

Questo capitolo è stato scritto in inglese da Yann Corno.

1. Guida degli stili

	Il testo che deve apparire ‘tal quale’ è scritto in grassetto.
	Le parole in corsivo verranno sostituite dal loro valore attuale. La prima lettera di questi nomi è una maiuscola, es. HusbandLastName
	I parametri tra [parentesi quadre] sono opzionali e possono venir omessi.
	Le parole separate da barre verticali ‘\|’ stanno a significare delle scelte: una sola di esse deve essere utilizzata.

Esempio:

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

produce le seguenti linee valide:

fam CORNO Joseph_Marie_Vincent + THOMAS Marie_Julienne

fam CORNO Alain.1 +25/11/1728 #mp Ile-aux-Moines CAUZIC Marie

2. Date

I formati delle date sono i seguenti: dd/mm/yyyy, yyyy, mm/yyyy. In certi casi, se dovete indicare una data ma non la conoscete, digitate semplicemente 0.

I modificatori di date utilizzano dei caratteri speciali come prefissi, per precisare "verso", "prima", "forse", "dopo", ecc.

Tipo di data	Carattere speciale	Esempio
Verso	~	~10/5/1990
Forse	?	?10/5/1990
Prima	<	<10/5/1990
Dopo	>	>10/5/1990
<-O->	\|	10/5/1990\|1991
<-Tra->	..	10/5/1990..1991

Il calendario è di tipo gregoriano come impostazione di base. Per convertirlo in Giuliano, aggiungete "J" alla data, "F" per il tipo Francese Repubblicano e "H" per l'Ebraico. Esempio : 10/9/5750H

Per ottenere una data sotto forma di testo, digitate prima la cifra 0 e mettetela tra parentesi, in questo modo:

0(5_Maggio_1990)

3. Stringhe di caratteri

Gli spazii nelle stringhe di caratteri sono sostituiti dal carattere ‘_’ (trattino basso), salvo che nelle note e in certi commenti: Maria_Antonietta.

Le maiuscole ASCII corrispondono alla norma iso-8859-1.

4. Recensimento degli individui

Una stessa persona puo essere recensita più volte un uno stesso file; in quanto genitore, figlio o ancora in una nota. Cognome, Nome e numero (se esiste) devono corrispondere esattamente; altrimenti, il programma non potrà determinare che si tratta dello stesso individuo e legare insieme questi riferimenti.

5. La struttura principale: la Famiglia

Il formato del file è basato sulle famiglie. Una famiglia comprende il marito, sua moglie e la lista dei loro figli. L'informazione personale (DoB, ecc.) è sita al livello figlio. Se un individuo non ha nessun genitore, le sue informazioni personali vengono allora inserite direttamente dopo il suo nome nella rubrica famiglia.

Di conseguenza, bisogna notare che le persone considerate "isolate" nella base di dati GeneWeb, non saranno esportate nel file GW. E pure in questo modo che gli individui tolti dalla base vengono cancellati con una sequenza gwu/gwc:non vengono del tutto esportati.

Primo caso: Il marito e sua moglie sono entrambi listati da qualche parte in quanto figli di una famiglia genitrice.

famHusbandLastNameFirstName[.Number] +[WeddingDate] [#sep | -DivorceDate] [#nm | #eng] [#mpWeddingPlace] [#ms WeddingSource] WifeLastNameFirstName[.Number]
[srcFamily source]
[commFamily 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

viene omesso, il cognome del padre è utilizzato.

	Se i genitori non sono sposati (relazione), inserite l'etichetta #nm. Se sono fidanzati, utilizzate #eng.
	Se i genitori sono separati, utilizzate #sep. Oppure se sono divorziati, utilizzate '-' e aggiungete subito dopo la data del divorzio (opzionale).
	Se il ChildLastName
	Le etichette src, comm e wit seguono su linee distinte, dopo l'etichetta fam. Sono opzionali.
	Se il sesso di un figlio è sconosciuto, non indicate nulla (non mettete ne ‘m’ ne ‘f’) dopo il ‘-’ (trattino).

Se una famiglia non ha figli, potete saltare tutta la sequenza delle etichette beg/end:

fam HEYDENREICH Gaspard +1719 TRESCH Rosine_Catherine

Secondo caso : Il marito o sua moglie non sono listati da nessuna parte in quanto figli di un'altra famiglia. Digitate semplicemente le loro informazioni personali, come fareste per un figlio. Vedi più avanti il paragrafo Informazioni sulla persona per avere più dettagli sulle informazioni personali.

Esempio: John Corno (o 1935 at Soisy, +1997). L'informazione è messa nella rubrica famiglia dato che questa persona non è mai listata altrove:

fam Corno John 1935 #bp Soisy 1997 + Rempp Zabeth

Se non possedete realmente nessuna informazione su una persona in più del suo nome, aggiungete allora la cifra 0 al suo nome; questa indicazione servirà da DoB nulla e come indicatore che questa persona non figura altrove:

fam Diemer Patrick 0 + Heidenreich Sylvie 0

6. Informazioni sulla persona

Le informazioni sulla persona possono figurare sia nella rubrica figlio in una famiglia, sia nella rubrica famiglia se la persona non è menzionata come figlio da qualche altra parte.

Le informazioni strettamente necessarie per un genitore sono il suo cognome e nome(i), colla cifra 0 come Data di Nascita (DoB):

Corno Yann 0

Nel caso di un figlio, la DoB non è obbligatoria (anche il cognome puo essere omesso; verrà allora utilizzato quello del padre).

Riassumendo, la DoB (Data di Nascita) è obbligatoria solo se la persona è un genitore, o se la persona ha una data di morte (DoD). In quest'ultimo caso, se la DoB è sconosciuta, attribuitegli semplicemente la cifra 0.

Esempio: Maurice, DoB sconosciuta, morto nel 1935 a Caen:

Corno Maurice 0 1935 #dp Caen

Il formato completo per una persona è quello presentato qui di seguito:

LastNameFirstName [{FirstNameAlias}] [#saliasSurnameAlias] [(PublicName)] [#imageImageFilePath] [#nickQualifier] [#alias Alias] [Titles (see Title section)] [#apubl | #apriv] [#occuOccupation] [#srcPersonSource] DateOfBirth [#bsBirthSource] [#bpPlaceOfBirth] [!BaptizeDate] [#ppBaptizePlace] [#psBaptizeSource] [DateOfDeath] [#dpPlaceOfDeath] [#dsDeathSource] [#buri | #crem [BurialDate]] [#rpBurialPlace] [#rsBurialSource]

	Vedi le note più sopra a proposito dell'obbligo di attribuire una DoB (Data di Nascita) oppure no.
	Nel caso in cui ignoriate se la persona è ancora in vita, (item "Non so" nella sezione Morte), mettete un ‘?’ per la DoD (Data di Morte).
	Se siete sicuri che la persona è deceduta, ma non conoscete la data della morte, mettete la cifra ‘0’ per la DoD.
	Se la persona è morta giovane, usate l'etichetta ‘mj’ come DoD.
	#apubl e #apriv controllano l'accesso : Pubblico o Privato. Nessun parametro è indicato, il che significa "Se Titoli".

Per precisare i diversi tipi di morte, utilizzate questi caratteri speciali come prefissi davanti alla DoD:

Tipo di morte	Carattere speciale	Esempio
Ucciso	k	k10/5/1990
Assassinato	m	m10/5/1990
Giustiziato	e	e10/5/1990
Disperso	s	s10/5/1990

Utilizzate l'etichetta #buri per precisare la sepoltura o #crem per una cremazione. La data corrispondente è facoltativa.

7. Titoli

Sebbene i titoli appaiano semplicemente come un'altra etichetta nella rubrica Persona, sono descritti separatamente in questa sezione per una migliore comprensione. I Titoli sono messi tra parentesi quadre [ ] (scusate se mi servo di parentesi quadre come descrizione di formato). Se i titoli sono molteplici, sono aggiunti semplicemente gli uni dopo gli altri, ripetendo le coppie di parentesi.

[ TitleName:Title:TitlePlace:StartDate:EndDate:Nth]

	Ogni item è separato da un carattere ‘:’. Se l'informazione corrispondente non è disponibile, lasciate l'item vuoto.
	Il titolo principale è inserito utilizzando il segno ‘*’ per il Nome del Titolo.

8. Note

Le note sono conservate a parte nel file, tra i marcatori notes e end notes:

notes LastName FirstName[.Number]
beg
Notes go here in a free format
end notes

9. Relazioni

Anche le relazioni, come le note, sono conservate separatamente. Infatti possono far riferimento agli individui allo stesso modo che un figlio fa riferimento a una famiglia. Nella lista che segue tutti i marcatori sono menzionati, cosa che nella pratica non succede mai.

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

Ritorna a Istruzioni per l'uso