EPUBCheck · NCX (EPUB 2 table des matières)

EPUBCheck NCX-004 : espaces dans le uid NCX

Mis à jour : 4 novembre 2026

EPUBCheck NCX-004 est un message d'utilisation : “NCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.” La valeur du dtb:uid de l'NCX a des espaces ou des sauts de ligne avant ou après. L'identifiant doit correspondre exactement à l'identifiant unique du package, et des espaces supplémentaires peuvent entraîner un échec de comparaison stricte.

Le message officiel

NCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.

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

Causes typiques

XML bien formaté qui place la valeur sur sa propre ligne.
Une valeur copiée avec un espace de fin.

Comment le corriger

Ouvrez le NCX (généralement toc.ncx) et trouvez <meta name="dtb:uid" content="..."/>.
Supprimer les espaces autour de la valeur de l'attribut content afin qu'elle soit identique à dc:identifier du package.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la valeur est différente de l'identifiant du paquet, pas seulement complétée, l'erreur est NCX-001.

Termes utilisés ici

Qu'est-ce que la table des matières NCX ?

Autres messages NCX

NCX-006 Empty "text" label in the NCX document
NCX-001 NCX identifier ("…") does not match OPF identifier ("…").

Sources

EPUB 3.3, §5.9.5 NCX · 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 NCX-004 ?

Est-ce que NCX-004 est une erreur ?

NCX-004 est signalé par défaut comme une utilisation. Informatif uniquement et caché par défaut : il apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.