Anatomie du format EPUB 3

Référence factuelle de la structure d'un paquet EPUB 3, telle que définie par les spécifications EPUB 3.3 et EPUB Accessibility 1.1 du W3C. Cette fiche décrit les fichiers, media-types et vocabulaires ; elle n'enseigne pas la fabrication. Pour construire un EPUB pas à pas, voir le tutoriel « Produire un EPUB accessible, pas à pas ».

Un EPUB est une archive ZIP de documents XHTML décrits par un manifeste (le fichier .opf). L'EPUB 3 s'appuie sur HTML5 sérialisé en XML (XHTML5).

Structure du paquet

Arborescence type

paquet.epub (archive ZIP)
├── mimetype                    (1er fichier, non compressé)
├── META-INF/
│   └── container.xml           (point d'entrée)
└── EPUB/                       (dossier de contenu ; nom conventionnel)
    ├── content.opf             (manifeste + métadonnées + ordre de lecture)
    ├── nav.xhtml               (table des matières EPUB 3)
    ├── *.xhtml                 (documents de contenu)
    ├── *.css                   (styles)
    └── img/*                   (ressources)

Contraintes d'archive

Fichiers système obligatoires

mimetype

Contenu littéral unique, sans espace ni saut de ligne superflu :

application/epub+zip

META-INF/container.xml

Namespace : urn:oasis:names:tc:opendocument:xmlns:container. L'attribut full-path doit pointer exactement le chemin du .opf.

<?xml version="1.0" encoding="UTF-8"?>
<container version="1.0"
           xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
  <rootfiles>
    <rootfile full-path="EPUB/content.opf"
              media-type="application/oebps-package+xml"/>
  </rootfiles>
</container>

Le fichier .opf (Open Packaging Format)

Élément racine <package>, namespace http://www.idpf.org/2007/opf, version="3.0". Il contient trois sections.

<metadata> — Dublin Core requis

Namespace http://purl.org/dc/elements/1.1/ (préfixe dc:).

L'attribut unique-identifier de <package> référence l'id du dc:identifier. xml:lang est déclaré sur <package>.

<manifest> — attributs d'<item>

Règle : toute ressource du paquet (y compris images et CSS) doit figurer dans le <manifest> ; un fichier omis fait échouer la validation.

<spine> — ordre de lecture

Suite d'<itemref idref="…"> référençant les id du manifeste, dans l'ordre de lecture linéaire.

Media-types (types MIME)

Types MIME normalisés pour l'attribut media-type du manifeste.

Métadonnées d'accessibilité (schema.org)

Déclarées dans <metadata> via <meta property="schema:…">, définies par EPUB Accessibility 1.1 sur le vocabulaire schema.org. Une même propriété peut être répétée pour porter plusieurs valeurs.

Vue d'ensemble

accessMode — valeurs courantes

accessModeSufficient liste des combinaisons autonomes (ex. textual seul suffit pour une publication entièrement textuelle).

accessibilityFeature — valeurs courantes

accessibilityHazard — valeurs

Règle de sincérité : ces métadonnées doivent refléter le contenu réel. Déclarer alternativeText sans alt sur les images est une non-conformité.

Valeurs d'epub:type courantes

Attribut epub:type (namespace http://www.idpf.org/2007/ops), porté par les éléments XHTML pour enrichir la sémantique structurelle. Souvent couplé à un attribut ARIA role (doc-*) pour les technologies d'assistance.

Document de navigation (nav.xhtml)

Fichier XHTML marqué properties="nav" dans le manifeste, contenant au moins un <nav epub:type="toc">.

Outils de conformité

Références normatives