EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM_062 : xlink:href SVG obsolète

Mis à jour : 4 novembre 2026

EPUBCheck HTM_062 est un message d'usage : “SVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.” Un élément SVG utilise xlink:href, qui est obsolète au profit de href normal. EPUBCheck rapporte deux notes d'usage à ce sujet. HTM_062 signifie que xlink:href est utilisé. HTM_063 signifie qu'un élément a à la fois xlink:href et href avec des valeurs différentes, donc différentes applications peuvent charger différentes cibles.

Le message officiel

SVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.

Gravité par défaut: Utilisation. Informative uniquement et cachée par défaut : elle apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.
version EPUBCheck: 5.4.0

EPUBCheck imprime cet ID avec un soulignement au lieu d'un tiret ; cette page utilise l'ID tel que EPUBCheck le rapporte.

Causes typiques

SVG produit par d'anciens éditeurs, qui écrivent xlink:href sur les images, et utilisent des éléments a (HTM_062).
L'un des deux attributs mis à jour et l'autre oublié, par exemple après avoir remplacé une image (HTM_063).

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à.
Remplacez xlink:href par href sur les éléments que EPUBCheck liste.
Si vous conservez les deux pour les anciennes applications de lecture, donnez-leur exactement la même valeur.
Supprimer la déclaration xmlns:xlink une fois qu'aucun attribut xlink ne reste.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si l'objectif du lien lui-même est manquant dans le EPUB, le message est RSC-007, peu importe l'attribut qui y fait référence.

Aussi signalé comme

HTM_063 (utilisation): SVG "xlink:href" attribute value ("%1$s") should be equal to the "href" attribute value ("%2$s").

Termes utilisés ici

Autres messages HTM

HTM_061 "…" is not a valid custom data attribute (it must have at least one character after the hyphen, be XML-compatible, and not contain ASCII uppercase letters).
HTM_060b EPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)

Sources

EPUBCheck 5.4.0 message texts (MessageBundle.properties, w3c/epubcheck on GitHub) · 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_062 ?

Est-ce que HTM_062 une erreur ?

HTM_062 est signalé comme utilisation par défaut. Informative seulement et cachée par défaut : elle apparaît lorsque EPUBCheck est exécuté avec -u (--usage). Cela ne rend pas le EPUB invalide.