EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-048 : page SVG sans viewBox

Mis à jour : 4 novembre 2026

EPUBCheck HTM-048 est un message d'erreur : “SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).” Un document à mise en page fixe construit en SVG n'a pas de viewBox sur son élément svg le plus extérieur, donc sa taille est inconnue. Pour les pages fixes en SVG, le viewBox définit les dimensions de la page.

Le message officiel

SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" 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 SVG exportées avec largeur et hauteur mais sans viewBox.
Une viewBox placée sur un élément svg ou g intérieur au lieu du plus extérieur.

Comment le corriger

Ouvrez le fichier EPUBCheck (le message indique le chemin, la ligne et la colonne) dans un éditeur de texte ou EPUB tel que Sigil, ou décompressez le EPUB et ouvrez-le là.
Ajoutez un viewBox à l'élément svg externe, par exemple viewBox="0 0 1200 1600" (x, y, largeur, hauteur).
Utilisez la même largeur et hauteur à laquelle l'œuvre a été dessinée, afin que rien ne soit coupé ou étiré.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la page de mise en page fixe est XHTML, la taille provient d'un élément meta viewport et le message est HTM-046.

Termes utilisés ici

Autres messages HTM

HTM-047 Viewport metadata "…" has a syntax error
HTM-046 Fixed layout document has no "viewport" meta element.
HTM-045 Encountered empty href.
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-044 Namespace uri "…" was included but not used.
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-048 ?

Est-ce que HTM-048 une erreur ?

HTM-048 est signalé comme 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.