Passer au contenu

Messages EPUBCheck expliqués

EPUBCheck rapporte chaque problème dans un EPUB sous la forme d'un code tel que RSC-005 ou OPF-014 avec une gravité. Cette référence liste tous les messages 246 de EPUBCheck 5.4.0 avec leur texte officiel, et explique les causes et solutions pour 188 d'entre eux.

Mis à jour :

Gravités

Erreur fatale
EPUBCheck n'a pas pu continuer à vérifier cette partie du EPUB. Le fichier est invalide.
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.
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.
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.
Info
Informative uniquement. Cela ne rend pas le EPUB invalide.
Supprimé
EPUBCheck ne signale pas ce message par défaut. Il n'apparaît que si un fichier de message personnalisé (-c) change sa gravité.

PKG: Paquet et conteneur ZIP

Le fichier EPUB lui-même : l'archive ZIP, le fichier mimetype, les noms de fichiers et les extensions.

CodeGravité par défautMessage
PKG-001AvertissementValidating the EPUB against version … but detected version ….
PKG-003ErreurUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Erreur fataleCorrupted EPUB ZIP header.
PKG-005ErreurThe mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006ErreurMimetype file entry is missing or is not the first file in the archive.
PKG-007ErreurThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Erreur fataleUnable to read file "…".
PKG-009ErreurThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010AvertissementThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011ErreurThe file name "…" is not allowed to end with ".".
PKG-012UtilisationThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013ErreurThe EPUB file includes multiple OPS renditions.
PKG-014AvertissementThe EPUB contains empty directory "…".
PKG-015Erreur fataleUnable to read EPUB contents: …
PKG-016AvertissementUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017AvertissementUncommon EPUB file extension.
PKG-018Erreur fataleThe EPUB file could not be found.
PKG-020ErreurOPF file "…" could not be found.
PKG-021ErreurCorrupted image file encountered.
PKG-022AvertissementWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023UtilisationValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024UtilisationUncommon EPUB file extension.
PKG-025ErreurPublication resource must not be located in the META-INF directory
PKG-026ErreurObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Erreur fataleCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Ressources et références

Fichiers et liens entre eux : fichiers manquants, références cassées, URL, encodages et analyse XML.

CodeGravité par défautMessage
RSC-001ErreurFile "…" could not be found.
RSC-002Erreur fataleRequired META-INF/container.xml resource could not be found.
RSC-003ErreurNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004InfoFile "…" is encrypted, its content will not be checked.
RSC-005ErreurError while parsing file: …
RSC-006ErreurRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bUtilisationResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007ErreurReferenced resource "…" could not be found in the EPUB.
RSC-007wAvertissementReferenced resource "…" could not be found in the EPUB.
RSC-008ErreurReferenced resource "…" is not declared in the OPF manifest.
RSC-009AvertissementA non-SVG image resource should not be defined with a fragment identifier.
RSC-010ErreurReference to non-standard resource type found.
RSC-011ErreurFound a reference to a resource that is not a spine item.
RSC-012ErreurFragment identifier is not defined.
RSC-013UtilisationFragment identifier is used in a reference to a stylesheet resource.
RSC-014UtilisationFragment identifier defines an incompatible resource type.
RSC-015UtilisationA fragment identifier is required for svg use tag references.
RSC-016Erreur fataleFatal Error while parsing file: …
RSC-017AvertissementWarning while parsing file: …
RSC-019AvertissementEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Erreur"…" is not a valid URL (…)
RSC-021ErreurA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022InfoCannot check image details (requires Java version 7 or higher).
RSC-024UtilisationInformative parsing warning: …
RSC-025UtilisationInformative parsing error: …
RSC-026ErreurURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027AvertissementXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028ErreurXML documents must be encoded in UTF-8, but … was detected.
RSC-029ErreurData URL is not allowed in this context.
RSC-030ErreurFile URLs are not allowed in EPUB, but found "…".
RSC-031AvertissementRemote resource references should use HTTPS, but found "…".
RSC-032ErreurFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033ErreurRelative URL strings must not have a query component, but found one in "…".
RSC-034ErreurScripts must have a JavaScript media type.
RSC-035Utilisation"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Utilisation…

OPF: Document de paquet (OPF)

Le document package : métadonnées, manifeste, spine, propriétés et options de secours.

CodeGravité par défautMessage
OPF-001ErreurThere was an error when parsing the EPUB version: ….
OPF-002Erreur fataleThe OPF file "…" was not found in the EPUB.
OPF-003UtilisationItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004AvertissementInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aErreurInvalid prefix declaration: found empty prefix.
OPF-004bErreurInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cErreurInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dErreurInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eAvertissementInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fAvertissementInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005ErreurInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006ErreurInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007AvertissementRe-declaration of reserved prefix "…".
OPF-007aErreurInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bErreurInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cErreurInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010ErreurError resolving reference: "…".
OPF-011Erreuritemref can’t have both page-spread-right and page-spread-left properties.
OPF-012ErreurItem property "…" is not defined for media type "…".
OPF-013AvertissementResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014ErreurThe property "…" should be declared in the OPF file.
OPF-015ErreurThe property "…" should not be declared in the OPF file.
OPF-016ErreurThe element "rootfile" is missing its required attribute "full-path".
OPF-017ErreurThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018AvertissementThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bUtilisationThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found; please check scripted content to make sure the property is legit.
OPF-021AvertissementUse of non-registered URI scheme type in href: "…".
OPF-025ErreurProperty value list "…" is not allowed, only one value must be specified.
OPF-026ErreurFound malformed property value: "…".
OPF-027ErreurUndefined property: "…".
OPF-028ErreurUndeclared prefix: "…".
OPF-029ErreurThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030ErreurThe unique-identifier "…" was not found.
OPF-031ErreurFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032ErreurGuide references "…" which is not a valid "OPS Content Document".
OPF-033ErreurThe spine contains no linear resources.
OPF-034ErreurThe spine contains multiple references to the manifest item with id "…".
OPF-035AvertissementMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036UtilisationVideo type "…" might not be supported by reading systems
OPF-037AvertissementFound deprecated media-type "…".
OPF-038AvertissementMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039AvertissementMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040ErreurFallback item with id "…" could not be found.
OPF-041ErreurFallback-style item with id "…" could not be found.
OPF-042Erreur"…" is not a permissible spine media-type.
OPF-043ErreurSpine item with non-standard media-type "…" has no fallback.
OPF-044ErreurSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045ErreurEncountered circular reference in fallback chain.
OPF-047UtilisationOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048ErreurPackage tag is missing its required unique-identifier attribute and value.
OPF-049ErreurItem id "…" was not found in the manifest.
OPF-050ErreurTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051SuppriméImage dimensions exceed recommended size.
OPF-052ErreurRole value "…" is not valid.
OPF-053AvertissementDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054ErreurDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Avertissement… tag is empty.
OPF-057SuppriméImage file length exceeds recommended size.
OPF-060ErreurDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062UtilisationFound Adobe page-map attribute on spine element in opf file.
OPF-063AvertissementReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064InfoOPF declares type "…", validating using profile "…".
OPF-065ErreurInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066ErreurMissing "dc:source" or "source-of" pagination metadata. The pagination source must be identified using the "dc:source" and "source-of" properties when the content includes page break markers.
OPF-067ErreurThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070AvertissementCustom collection role "…" is an invalid URL.
OPF-071ErreurIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072UtilisationMetadata element "…" is empty.
OPF-073ErreurExternal identifiers must not appear in the document type declaration.
OPF-074ErreurPackage resource "…" is declared in several manifest items.
OPF-075ErreurPreview collections must only point to EPUB Content Documents.
OPF-076ErreurThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077AvertissementA Data Navigation Document should not be included in the spine.
OPF-078ErreurAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079AvertissementDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080AvertissementA Search Key Map document file name should have the extension ".xml".
OPF-081ErreurResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082ErreurFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083ErreurFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084ErreurFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Avertissement"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086AvertissementProperty "…" is deprecated. Consider using … instead.
OPF-086bUtilisationepub:type value "…" is deprecated. Consider using … instead.
OPF-086cAvertissementthe "…" reserved prefix is deprecated.
OPF-087Utilisationepub:type value "…" is not allowed on documents of type "…".
OPF-088UtilisationUnrecognized epub:type value "…".
OPF-089ErreurThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090UtilisationIt is encouraged to use MIME media type "…" instead of "…".
OPF-091ErreurThe item href URL must not have a fragment identifier.
OPF-092ErreurLanguage tag "…" is not well-formed: …
OPF-093ErreurThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094ErreurThe "media-type" attribute is required for "…" links.
OPF-095ErreurThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096ErreurNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bUtilisationNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097UtilisationResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098ErreurThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099ErreurThe manifest must not list the package document.
OPF-100UtilisationThe "…" property only applies to pre-paginated content.

HTM: Documents de contenu XHTML

Les chapitres du XHTML : DOCTYPE, entités, espaces de noms et points de vue à mise en page fixe.

CodeGravité par défautMessage
HTM-001ErreurAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002AvertissementThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003ErreurExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004ErreurIrregular DOCTYPE: found "…", expected "…".
HTM-005UtilisationAn external reference was found.
HTM-007AvertissementEmpty or whitespace-only value of attribute ssml:ph.
HTM-009ErreurThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010UtilisationNamespace "…" is unusual for the prefix "epub".
HTM-011ErreurEntity is undeclared.
HTM-025AvertissementNon-registered URI scheme type found in href.
HTM-044UtilisationNamespace uri "…" was included but not used.
HTM-045UtilisationEncountered empty href.
HTM-046ErreurFixed layout document has no "viewport" meta element.
HTM-047ErreurViewport metadata "…" has a syntax error
HTM-048ErreurSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051AvertissementFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052ErreurThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054ErreurCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055UtilisationThe "…" element should not be used (discouraged construct)
HTM_056ErreurViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057ErreurViewport "…" value must be a positive number or the keyword "device-…"
HTM_058ErreurHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059ErreurViewport "…" property must not be defined more than once, but found values […].
HTM_060aUtilisationEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bUtilisationEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Erreur"…" 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_062UtilisationSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063UtilisationSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Feuilles de style

Fichiers CSS et éléments de style : propriétés interdites, encodages, polices et syntaxe.

CodeGravité par défautMessage
CSS-001ErreurThe "…" property must not be included in an EPUB Style Sheet.
CSS-002ErreurEmpty or NULL reference found.
CSS-003AvertissementCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004ErreurCSS documents must be encoded in UTF-8, detected …;
CSS-005UtilisationConflicting alternate style tags found: ….
CSS-006UtilisationCSS selector specifies fixed position.
CSS-007InfoFont-face reference "…" refers to non-standard font type "…".
CSS-008ErreurAn error occurred while parsing the CSS: ….
CSS-015ErreurAlternative style sheets must have a title.
CSS-019AvertissementCSS font-face declaration has no attributes.
CSS-028UtilisationUse of Font-face declaration.
CSS-029UtilisationFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030ErreurThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 table des matières)

La table des matières NCX héritée.

CodeGravité par défautMessage
NCX-001ErreurNCX identifier ("…") does not match OPF identifier ("…").
NCX-004UtilisationNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006UtilisationEmpty "text" label in the NCX document

MED: Images, audio et superpositions multimédias

Formats d'image et en-têtes, et audio synchronisé (superpositions multimédias).

CodeGravité par défautMessage
MED-003ErreurPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004ErreurImage file header may be corrupted.
MED-005ErreurMedia Overlay audio reference … to non-standard audio type … found.
MED-008ErreurThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009ErreurThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007ErreurPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010ErreurEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011ErreurEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012ErreurThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013ErreurMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014ErreurMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015UtilisationMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016AvertissementMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017AvertissementURL fragment should indicate an element ID, but found '#…'.
MED_018AvertissementURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Accessibilité

Contrôles d'accessibilité sur les documents conteneurs (la plupart sont supprimés par défaut).

CodeGravité par défautMessage
ACC-004SuppriméHtml "a" element must have text.
ACC-005SuppriméTable heading cells should be identified by "th" elements for accessibility.
ACC-006SuppriméTables should include a "thead" element for accessibility.
ACC-007SuppriméContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009UtilisationMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011UtilisationSVG hyperlink has no accessible name
ACC-012SuppriméTable elements should include a caption element.

OBS: Fonctionnalités obsolètes

Fonctionnalités qui fonctionnent encore mais qui sont obsolètes.

CodeGravité par défautMessage
OBS-001UtilisationUsage of … is outdated.

INF: Informations

Notes à propos de EPUBCheck lui-même.

CodeGravité par défautMessage
INF-001InfoRule … is under review and its severity may change in a future release. See the discussion at …

CHK: configuration de EPUBCheck

Problèmes avec le fichier de message personnalisé de EPUBCheck, pas avec le EPUB.

CodeGravité par défautMessage
CHK-001ErreurThe custom message overrides file was not found.
CHK-002ErreurUnrecognized custom message id … encountered in message overrides file "…".
CHK-003ErreurUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004ErreurThe custom message contains too many parameters in message overrides file "…".
CHK-005ErreurThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006ErreurUnable to parse the custom format parameter in message overrides file "…".
CHK-007ErreurError encountered while processing custom message file "…": "…".
CHK-008ErreurError encountered while processing an item "…"; skip other checks for the item.

IDs de messages retirés

Ces identifiants existent encore dans la liste des messages de EPUBCheck mais n'ont pas de texte et sont supprimés par défaut, donc EPUBCheck ne les signale jamais à moins qu'un fichier de message personnalisé ne les active.

ACC-001, ACC-002, ACC-003, ACC-008, ACC-010, ACC-013, ACC-014, ACC-015, ACC-016, ACC-017, CSS-009, CSS-010, CSS-011, CSS-012, CSS-013, CSS-016, CSS-017, CSS-020, CSS-021, CSS-022, CSS-023, CSS-024, CSS-025, HTM-006, HTM-008, HTM-012, HTM-013, HTM-014, HTM-014a, HTM-015, HTM-016, HTM-017, HTM-018, HTM-019, HTM-020, HTM-021, HTM-022, HTM-023, HTM-024, HTM-027, HTM-028, HTM-029, HTM-033, HTM-036, HTM-038, HTM-049, HTM-050, HTM_053, MED-001, MED-002, MED_006, NAV-002, NCX-002, NCX-003, NCX-005, OPF-008, OPF-009, OPF-019, OPF-020, OPF-046, OPF-056, OPF-058, OPF-059, OPF-068, OPF-069, RSC-018, RSC-023, SCP-001, SCP-002, SCP-003, SCP-004, SCP-005, SCP-006, SCP-007, SCP-008, SCP-009, SCP-010

Source et licence

Les textes de messages et les gravités par défaut proviennent de EPUBCheck 5.4.0, le validateur EPUB du W3C, publié sous la licence BSD-3-Clause. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Les causes et solutions sont écrites par EpubCC. Les codes sans explication affichent uniquement le message officiel et ne sont pas offerts aux moteurs de recherche jusqu'à ce que nous en écrivions un. EpubCC n'est pas affilié au W3C.

PDF vers EPUB outils

Chaque outil utilise le même moteur. Jusqu'à 3 livres par jour sont gratuits.

Voir tous les outils