EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-046 : mise en page fixe sans viewport

Mis à jour : 4 novembre 2026

EPUBCheck HTM-046 est un message d'erreur : “Fixed layout document has no "viewport" meta element.” Un document XHTML à mise en page fixe n'a pas d'élément meta de viewport, donc les applications de lecture ne connaissent pas sa taille de page. Dans une mise en page fixe, la largeur et la hauteur dans le viewport définissent l'espace de coordonnées de chaque page ; sans elles, la page ne peut pas être disposée comme prévu.

Le message officiel

Fixed layout document has no "viewport" meta element.

Gravité par défaut: Erreur. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck sort avec le statut 1.
version EPUBCheck: 5.4.0

Causes typiques

Pages à mise en page fixe écrites sans la déclaration de viewport.
Un livre déclaré comme pré-paginé dans le document de paquet dont les chapitres ont été écrits comme du texte réflowable.

Comment le corriger

Ajoutez un viewport dans l'en-tête de chaque page à mise en page fixe avec sa largeur et sa hauteur en pixels, par exemple <meta name="viewport" content="width=1200, height=1600"/>.
Utilisez la taille pour laquelle la page a été conçue (souvent la taille en pixels de son image de fond).
Si le livre n'est pas censé avoir une mise en page fixe, supprimez rendition:layout "pre-paginated" du document de package à la place.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la page est SVG plutôt que XHTML, la taille manquante est un viewBox et le message est HTM-048.

Termes utilisés ici

Autres messages HTM

HTM-045 Encountered empty href.
HTM-047 Viewport metadata "…" has a syntax error
HTM-044 Namespace uri "…" was included but not used.
HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.

Sources

EPUB 3.3, §8.2.2.6 Content document dimensions · lire 4 novembre 2026

Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.

FAQ

Que signifie EPUBCheck HTM-046 ?

Est-ce que HTM-046 une erreur ?

HTM-046 est signalé comme une erreur par défaut. Le EPUB enfreint une règle de la spécification et est invalide. Les boutiques et l'envoi à Kindle peuvent le rejeter, et EPUBCheck se termine avec le statut 1.