Tag GEDCOM standard
HEAD
En-tête
Header
Pseudo-structure placée au début du fichier. Elle décrit le document GEDCOM lui-même : version de la norme, logiciel d’origine, langue par défaut ou schéma d’extensions.
Exemple concret
Exemple minimal
0 HEAD
1 GEDC
2 VERS 7.0
0 TRLR
Exemple réaliste
0 HEAD
1 GEDC
2 VERS 7.0
1 SCHMA
2 TAG _EXEMPLE https://example.org/terms/example
1 SOUR https://example.org/software
2 VERS 4.2.1
2 NAME Exemple Généalogie
1 DEST https://example.org/importer
1 DATE 23 AUG 2026
2 TIME 14:30:00Z
1 SUBM @U1@
1 LANG fr
1 COPR © 2026 Association Exemple
0 @U1@ SUBM
1 NAME Association Exemple
0 TRLR
Traduction en langage humain
HEAD ouvre le dataset et décrit le document entier. Il ne décrit ni une personne ni une famille ; les records généalogiques viennent après lui et avant TRLR.
HEAD ouvre le dataset et décrit le document entier. Il ne décrit ni une personne ni une famille ; les records généalogiques viennent après lui et avant TRLR.
Explication pas à pas
L’objectif n’est pas seulement de reconnaître le tag, mais de comprendre ce qu’il fait à cet endroit précis de la hiérarchie.
1
Exemple minimal — « 0 HEAD » : le niveau 0 place HEAD sous le dataset.
2
Exemple minimal — « 1 GEDC » : le niveau 1 place GEDC sous HEAD.
3
Exemple minimal — « 2 VERS 7.0 » : le niveau 2 place VERS sous GEDC avec la valeur « 7.0 ».
4
Exemple minimal — « 0 TRLR » : le niveau 0 place TRLR sous le dataset.
5
Exemple réaliste — « 0 HEAD » : le niveau 0 place HEAD sous le dataset.
6
Exemple réaliste — « 1 GEDC » : le niveau 1 place GEDC sous HEAD.
7
Exemple réaliste — « 2 VERS 7.0 » : le niveau 2 place VERS sous GEDC avec la valeur « 7.0 ».
8
Exemple réaliste — « 1 SCHMA » : le niveau 1 place SCHMA sous HEAD.
9
Exemple réaliste — « 2 TAG _EXEMPLE https://example.org/terms/example » : le niveau 2 place TAG sous SCHMA avec la valeur « _EXEMPLE https://example.org/terms/example ».
10
Exemple réaliste — « 1 SOUR https://example.org/software » : le niveau 1 place SOUR sous HEAD avec la valeur « https://example.org/software ».
11
Exemple réaliste — « 2 VERS 4.2.1 » : le niveau 2 place VERS sous SOUR avec la valeur « 4.2.1 ».
12
Exemple réaliste — « 2 NAME Exemple Généalogie » : le niveau 2 place NAME sous SOUR avec la valeur « Exemple Généalogie ».
13
Exemple réaliste — « 1 DEST https://example.org/importer » : le niveau 1 place DEST sous HEAD avec la valeur « https://example.org/importer ».
14
Exemple réaliste — « 1 DATE 23 AUG 2026 » : le niveau 1 place DATE sous HEAD avec la valeur « 23 AUG 2026 ».
15
Exemple réaliste — « 2 TIME 14:30:00Z » : le niveau 2 place TIME sous DATE avec la valeur « 14:30:00Z ».
16
Exemple réaliste — « 1 SUBM @U1@ » : le niveau 1 place SUBM sous HEAD et pointe vers @U1@.
17
Exemple réaliste — « 1 LANG fr » : le niveau 1 place LANG sous HEAD avec la valeur « fr ».
18
Exemple réaliste — « 1 COPR © 2026 Association Exemple » : le niveau 1 place COPR sous HEAD avec la valeur « © 2026 Association Exemple ».
19
Exemple réaliste — « 0 @U1@ SUBM » : le niveau 0 crée le record identifié par @U1@.
20
Exemple réaliste — « 1 NAME Association Exemple » : le niveau 1 place NAME sous SUBM avec la valeur « Association Exemple ».
21
Exemple réaliste — « 0 TRLR » : le niveau 0 place TRLR sous le dataset.
22
HEAD est une pseudo-structure de niveau 0, sans XREF ni payload, obligatoirement première.
23
GEDC {1:1} est son seul enfant obligatoire et GEDC.VERS {1:1} déclare la version conforme.
24
SCHMA, SOUR, DEST, DATE, SUBM, COPR, LANG, PLAC et NOTE_STRUCTURE sont les seules structures standard directement autorisées.
25
Le pointeur HEAD.SUBM est facultatif et sa cible SUBM se trouve parmi les records du dataset.
26
Évolution attestée — FamilySearch GEDCOM 7 impose UTF-8, simplifie fortement le header 5.5.1 et ne doit pas recevoir les anciennes lignes CHAR ou FILE.
27
Toujours au niveau 0.
28
Doit être la première structure du document.
29
Ne représente ni une personne ni une famille.
Piège fréquent
À ne pas faire / à ne pas déduire :
Croire que HEAD décrit le premier individu, ou recopier un en-tête FamilySearch GEDCOM 5.5.1 hybride.
Croire que HEAD décrit le premier individu, ou recopier un en-tête FamilySearch GEDCOM 5.5.1 hybride.
Types de structure identifiés par HEAD
Un même tag peut représenter plusieurs types de structures. La combinaison du tag et du type de sa structure parente détermine le type exact.
| Nom officiel | URI de type | Page |
|---|---|---|
| Header | g7:HEAD | 77 |
Urig7:HEAD
ParentDataset, obligatoirement en première position
PayloadAucun ; pseudo-structure
CardinalityHEAD {1:1} ; GEDC {1:1} ; autres enfants standard {0:1}