EPUBCheck · Document de paquet (OPF)

EPUBCheck OPF-098 : lien vers l'élément du package

Mis à jour : 4 novembre 2026

EPUBCheck OPF-098 est un message d'erreur : «The "href" attribute must reference resources, not elements in the package document, but found URL "…". » Le href d'un lien de métadonnées pointe vers un élément à l'intérieur du document de package lui-même (une URL avec #id). Les éléments de lien doivent référencer des ressources, pas des parties du document de package.

Le message officiel

The "href" attribute must reference resources, not elements in the package document, but found URL "%1$s".

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

Un lien écrit comme href="#title" ou content.opf#meta1 pour pointer vers des métadonnées dans le même fichier.
Un lien de voix ou d'enregistrement visant un élément méta au lieu d'un fichier.
Un lien copié à partir de la syntaxe de refinement, qui utilise effectivement #id.

Comment le corriger

Trouvez l'élément de lien EPUBCheck pointé par.
Pointer href vers le vrai fichier (un fichier audio, un enregistrement), et non vers le document du paquet.
Pour décrire un élément du paquet, utilisez l'attribut refines avec #id au lieu de href.

Quand ce n'est pas ça

Si l'attribut href d'un élément du manifeste contient un fragment, c'est OPF-091.

Termes utilisés ici

Autres messages OPF

OPF-097 Resource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-099 The manifest must not list the package document.
OPF-096 Non-linear content must be reachable, but found no hyperlink to "…".
OPF-096b No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-100 The "…" property only applies to pre-paginated content.
OPF-095 The "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".

Sources

EPUB 3.3, §5.5.6 The link element · 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 OPF-098 ?

Est-ce que OPF-098 est une erreur ?

OPF-098 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 vers Kindle peuvent le rejeter, et EPUBCheck se termine avec le statut 1.