← Notions GEDCOMGEDZIPAccès public
Référence GEDCOM

§

GEDZIP (.gdz)

GEDZIP

Un fichier GEDCOM .ged transporte les données généalogiques. Un GEDZIP .gdz est une archive ZIP qui transporte le dataset GEDCOM 7 avec chaque fichier local qu’il référence.

Exemple pédagogiqueGEDCOM 7.0.18

Exemple concret

famille.gdz │ ├── gedcom.ged └── media/ ├── portrait-jean.jpg ├── acte-naissance.pdf └── mariage.png 0 @M1@ OBJE 1 FILE media/portrait-jean.jpg 2 FORM image/jpeg Le FilePath media/portrait-jean.jpg correspond à l’entrée media/portrait-jean.jpg de l’archive.
Ce que cela signifie
L’entrée gedcom.ged contient le dataset. Le FILE local du record OBJE désigne, par le même chemin logique, l’image rangée dans le paquet.

Comment le comprendre

1

Essentiel — GEDZIP évite de transmettre séparément le .ged et ses médias locaux : le dataset et les fichiers associés voyagent dans une même archive.

2

GEDZIP 7 actuel — l’archive ZIP contient une entrée nommée exactement gedcom.ged, qui contient le dataset FamilySearch GEDCOM.

3

GEDZIP 7 actuel — chaque payload FilePath local du dataset doit avoir une entrée ZIP correspondante portant le même nom logique.

4

Noms — les entrées sont en UTF-8, sensibles à la casse et utilisent / comme séparateur interne.

5

Encodage — un FilePath est une référence URI et peut percent-encoder certains caractères ; le nom de l’entrée ZIP correspondante n’est pas percent-encodé.

6

Extension — .gdz est recommandée. Une archive .zip quelconque contenant un fichier .ged nommé autrement n’est pas, pour cette seule raison, un GEDZIP 7 valide.

7

Noms réservés par prudence — MANIFEST.MF, META-INF/ et META-INF/MANIFEST.MF n’ont actuellement aucun sens spécial dans GEDZIP, mais la spécification recommande de les éviter pour prévenir les confusions et préserver une évolution future.

8

FilePath local — il ne commence pas par /, ne contient aucun segment .., aucune barre oblique inversée, aucune requête ni fragment. Une URL file locale ne doit pas être utilisée dans GEDZIP.

9

Sécurité pédagogique — un importateur doit maintenir chaque entrée dans le répertoire d’extraction prévu. Les chemins relatifs sûrs et l’interdiction de .. empêchent qu’un fichier du paquet désigne un emplacement extérieur.

10

Chemin contre entrée ZIP — media/portrait-jean.jpg est encodé comme FilePath dans gedcom.ged ; l’archive possède une entrée du même nom non percent-encodé.

11

Chiffrement — le chiffrement ZIP peut protéger le contenu des fichiers. Le chiffrement ZIP standard ne masque toutefois ni leurs noms ni leurs tailles.

12

Avant GEDZIP actuel — les versions GEDCOM antérieures pouvaient référencer des médias externes, mais déplacer ensemble le dataset et ces fichiers vers une autre machine restait fragile.

13

Draft GEDZIP 0.1, 21 février 2021 — ancien projet proposant une archive ZIP avec exactement un fichier GEDCOM, tous les médias référencés, aucun média non référencé, des chemins relatifs et l’extension .ZIP. Ces règles ne décrivent pas GEDZIP 7 actuel.

14

Draft GEDZIP 0.2, 22 février 2021 — révision très proche du projet 0.1, ajoutant notamment une section de références et un historique de version ; elle ne constitue pas la règle FamilySearch GEDCOM actuelle.

15

FamilySearch GEDCOM 7 — GEDZIP devient une partie intégrée de la spécification : l’entrée est fixée à gedcom.ged, les fichiers sont associés aux FilePath locaux, les règles de noms sont explicites et l’extension recommandée devient .gdz.

16

Technique — GEDZIP 7 est fondé sur le format ZIP défini par la spécification .ZIP et normalisé par ISO/IEC 21320-1:2015. Les fichiers déjà compressés, notamment de nombreux médias, ne gagnent pas nécessairement à être recompressés.

Piège fréquent

À éviter :
Mélanger les anciens drafts .ZIP avec GEDZIP 7 .gdz, omettre gedcom.ged, ou accepter qu’une entrée soit extraite hors du répertoire prévu.