EPUBCheck · Document de paquet (OPF)

EPUBCheck OPF-007 : mappage de préfixe interdit

Mis à jour : 4 novembre 2026

EPUBCheck OPF-007 est un message d'avertissement : “Re-declaration of reserved prefix "…".” L'attribut préfixe déclare un mappage que EPUB ne permet pas là, le plus souvent une nouvelle déclaration d'un préfixe réservé. EPUBCheck rapporte quatre cas liés : OPF-007 (un avertissement) et OPF-007a, OPF-007b et OPF-007c (erreurs).

Le message officiel

Re-declaration of reserved prefix "%1$s".

Gravité par défaut: Avertissement. Le EPUB est toujours valide, mais quelque chose risque de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0 sauf si vous passez --failonwarnings.
version EPUBCheck: 5.4.0

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

Causes typiques

OPF-007 : un préfixe réservé comme dcterms, rendition, schema ou a11y est mappé à une URI autre que sa réservée, généralement parce qu'un attribut de préfixe a été copié d'un autre livre.
OPF-007a : le préfixe "_" est déclaré, ce que EPUB interdit.
OPF-007b : un préfixe est mappé à l'URI d'un vocabulaire par défaut, dont les termes doivent être utilisés sans préfixe.
OPF-007c : un préfixe est mappé à l'espace de noms Dublin Core /elements/1.1/, qui doit figurer dans une déclaration xmlns:dc, et non dans l'attribut préfixe.

Comment le corriger

Trouvez l'attribut prefix sur l'élément de paquet du fichier .opf.
Supprimez les noms de mappage EPUBCheck : les préfixes réservés fonctionnent sans être déclarés, les vocabulaire par défaut ne prennent pas de préfixe, et "_" ne peut pas être déclaré.
Conservez Dublin Core comme xmlns:dc="http://purl.org/dc/elements/1.1/" dans l'élément de package ou de métadonnées.
Si l'attribut est maintenant vide, retirez-le.

Quand ce n'est pas ça

Si un préfixe est utilisé dans une propriété mais jamais déclaré, c'est OPF-028 ; si la syntaxe de l'attribut est incorrecte, c'est une variante de OPF-004.

Aussi signalé comme

OPF-007a (erreur): Invalid prefix mapping: prefix "_" must not be declared.
OPF-007b (erreur): Invalid prefix mapping: default vocabulary "%1$s" must not be re-declared.
OPF-007c (erreur): Invalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared

Termes utilisés ici

Autres messages OPF

OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.

Sources

EPUB 3.3, §D.1.5 Reserved prefixes · lire 4 novembre 2026
EPUB 3.3, §D.1.3 Default vocabularies · 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-007 ?

Est-ce que OPF-007 est une erreur ?

OPF-007 est signalé comme avertissement par défaut. Le EPUB est toujours valide, mais quelque chose est susceptible de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0, sauf si vous passez --failonwarnings.