EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-047 : erreur de syntaxe du viewport

Mis à jour : 4 novembre 2026

EPUBCheck HTM-047 est un message d'erreur : “Viewport metadata "…" has a syntax error.” L'élément meta de viewport d'un document à mise en page fixe a une erreur de syntaxe. L'attribut content doit être une liste de propriétés name=value séparées par des virgules, des points-virgules ou des espaces, et EPUBCheck cite la valeur qu'il n'a pas pu analyser.

Le message officiel

Viewport metadata "%1$s" has a syntax error

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

%1$s, %2$s… sont remplis avec le fichier, la valeur ou l'élément EPUBCheck trouvé.

Causes typiques

Séparateurs incorrects ou un signe égal manquant dans l'attribut de contenu.
Clés mal orthographiées ou caractères errants, par exemple une virgule traînante ou des guillemets à l'intérieur de la valeur.

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à.
Écrivez-le comme content="width=1200, height=1600" : largeur et hauteur, chacune avec une valeur, séparées par une virgule.
Conservez les autres propriétés de fenêtre de visualisation en dehors des pages à mise en page fixe, à moins que vous en ayez besoin ; les applications de lecture les ignorent.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la syntaxe est correcte mais que la largeur ou la hauteur est manquante, c'est HTM_056; une valeur incorrecte est HTM_057.

Termes utilisés ici

Autres messages HTM

HTM-046 Fixed layout document has no "viewport" meta element.
HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-045 Encountered empty href.
HTM-044 Namespace uri "…" was included but not used.
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, §F.2 The viewport meta tag, syntax · 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-047 ?

Est-ce que HTM-047 une erreur ?

HTM-047 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.