Siirry sisältöön

EPUBCheck viestit selitetty

EPUBCheck raportoi jokaisen ongelman EPUB:ssa koodina, kuten RSC-005 tai OPF-014 vakavuuden kanssa. Tämä viittaus luettelee kaikki 246 viestit EPUBCheck 5.4.0 kanssa virallisen tekstinsä kera ja selittää syyt ja korjaukset 188 niille.

Päivitetty:

Vakavuudet

Kriittinen virhe
EPUBCheck ei voinut jatkaa tämän EPUB osan tarkistamista. Tiedosto on virheellinen.
Virhe
EPUB rikkoo spesifikaation sääntöä ja on virheellinen. Kaupat ja Lähetä Kindle voivat hylätä sen, ja EPUBCheck poistuu tilassa 1.
Varoitus
EPUB on edelleen voimassa, mutta jokin saattaa aiheuttaa ongelmia joissakin lukusovelluksissa. EPUBCheck poistuu tilassa 0, ellei käytät --failonwarnings.
Käyttö
Vain informatiivista ja oletusarvoisesti piilotettua: se näkyy, kun EPUBCheck toimii -u (--usage) -asetuksella. Se ei tee EPUB:stä virheellistä.
Tietoa
Vain informatiivista. Se ei tee EPUB:stä virheellistä.
Laskettu
EPUBCheck ei lähtökohtaisesti raportoi tätä viestiä. Se näkyy vain, jos mukautettu viestitiedosto (-c) muuttaa sen vakavuutta.

PKG: Pakettia ja ZIP-säiliö

EPUB tiedosto itsessään: ZIP-arkisto, mimetype-tiedosto, tiedostonimet ja tiedostopäätteet.

KoodiOletusarvoinen vakavuusViesti
PKG-001VaroitusValidating the EPUB against version … but detected version ….
PKG-003VirheUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Kriittinen virheCorrupted EPUB ZIP header.
PKG-005VirheThe 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-006VirheMimetype file entry is missing or is not the first file in the archive.
PKG-007VirheThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Kriittinen virheUnable to read file "…".
PKG-009VirheThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010VaroitusThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011VirheThe file name "…" is not allowed to end with ".".
PKG-012KäyttöThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013VirheThe EPUB file includes multiple OPS renditions.
PKG-014VaroitusThe EPUB contains empty directory "…".
PKG-015Kriittinen virheUnable to read EPUB contents: …
PKG-016VaroitusUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017VaroitusUncommon EPUB file extension.
PKG-018Kriittinen virheThe EPUB file could not be found.
PKG-020VirheOPF file "…" could not be found.
PKG-021VirheCorrupted image file encountered.
PKG-022VaroitusWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023KäyttöValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024KäyttöUncommon EPUB file extension.
PKG-025VirhePublication resource must not be located in the META-INF directory
PKG-026VirheObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Kriittinen virheCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Resurssit ja viittaukset

Tiedostot ja linkit niiden välillä: puuttuvat tiedostot, rikkoutuneet viittaukset, URL-osoitteet, koodaukset ja XML-parsing.

KoodiOletusarvoinen vakavuusViesti
RSC-001VirheFile "…" could not be found.
RSC-002Kriittinen virheRequired META-INF/container.xml resource could not be found.
RSC-003VirheNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004TietoaFile "…" is encrypted, its content will not be checked.
RSC-005VirheError while parsing file: …
RSC-006VirheRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bKäyttöResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007VirheReferenced resource "…" could not be found in the EPUB.
RSC-007wVaroitusReferenced resource "…" could not be found in the EPUB.
RSC-008VirheReferenced resource "…" is not declared in the OPF manifest.
RSC-009VaroitusA non-SVG image resource should not be defined with a fragment identifier.
RSC-010VirheReference to non-standard resource type found.
RSC-011VirheFound a reference to a resource that is not a spine item.
RSC-012VirheFragment identifier is not defined.
RSC-013KäyttöFragment identifier is used in a reference to a stylesheet resource.
RSC-014KäyttöFragment identifier defines an incompatible resource type.
RSC-015KäyttöA fragment identifier is required for svg use tag references.
RSC-016Kriittinen virheFatal Error while parsing file: …
RSC-017VaroitusWarning while parsing file: …
RSC-019VaroitusEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Virhe"…" is not a valid URL (…)
RSC-021VirheA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022TietoaCannot check image details (requires Java version 7 or higher).
RSC-024KäyttöInformative parsing warning: …
RSC-025KäyttöInformative parsing error: …
RSC-026VirheURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027VaroitusXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028VirheXML documents must be encoded in UTF-8, but … was detected.
RSC-029VirheData URL is not allowed in this context.
RSC-030VirheFile URLs are not allowed in EPUB, but found "…".
RSC-031VaroitusRemote resource references should use HTTPS, but found "…".
RSC-032VirheFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033VirheRelative URL strings must not have a query component, but found one in "…".
RSC-034VirheScripts must have a JavaScript media type.
RSC-035Käyttö"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Käyttö…

OPF: Pakettiasiakirja (OPF)

Paketin asiakirja: metadata, manifesti, spine, ominaisuudet ja varajärjestelmät.

KoodiOletusarvoinen vakavuusViesti
OPF-001VirheThere was an error when parsing the EPUB version: ….
OPF-002Kriittinen virheThe OPF file "…" was not found in the EPUB.
OPF-003KäyttöItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004VaroitusInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aVirheInvalid prefix declaration: found empty prefix.
OPF-004bVirheInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cVirheInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dVirheInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eVaroitusInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fVaroitusInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005VirheInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006VirheInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007VaroitusRe-declaration of reserved prefix "…".
OPF-007aVirheInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bVirheInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cVirheInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010VirheError resolving reference: "…".
OPF-011Virheitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012VirheItem property "…" is not defined for media type "…".
OPF-013VaroitusResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014VirheThe property "…" should be declared in the OPF file.
OPF-015VirheThe property "…" should not be declared in the OPF file.
OPF-016VirheThe element "rootfile" is missing its required attribute "full-path".
OPF-017VirheThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018VaroitusThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bKäyttöThe "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-021VaroitusUse of non-registered URI scheme type in href: "…".
OPF-025VirheProperty value list "…" is not allowed, only one value must be specified.
OPF-026VirheFound malformed property value: "…".
OPF-027VirheUndefined property: "…".
OPF-028VirheUndeclared prefix: "…".
OPF-029VirheThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030VirheThe unique-identifier "…" was not found.
OPF-031VirheFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032VirheGuide references "…" which is not a valid "OPS Content Document".
OPF-033VirheThe spine contains no linear resources.
OPF-034VirheThe spine contains multiple references to the manifest item with id "…".
OPF-035VaroitusMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036KäyttöVideo type "…" might not be supported by reading systems
OPF-037VaroitusFound deprecated media-type "…".
OPF-038VaroitusMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039VaroitusMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040VirheFallback item with id "…" could not be found.
OPF-041VirheFallback-style item with id "…" could not be found.
OPF-042Virhe"…" is not a permissible spine media-type.
OPF-043VirheSpine item with non-standard media-type "…" has no fallback.
OPF-044VirheSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045VirheEncountered circular reference in fallback chain.
OPF-047KäyttöOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048VirhePackage tag is missing its required unique-identifier attribute and value.
OPF-049VirheItem id "…" was not found in the manifest.
OPF-050VirheTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051LaskettuImage dimensions exceed recommended size.
OPF-052VirheRole value "…" is not valid.
OPF-053VaroitusDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054VirheDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Varoitus… tag is empty.
OPF-057LaskettuImage file length exceeds recommended size.
OPF-060VirheDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062KäyttöFound Adobe page-map attribute on spine element in opf file.
OPF-063VaroitusReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064TietoaOPF declares type "…", validating using profile "…".
OPF-065VirheInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066VirheMissing "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-067VirheThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070VaroitusCustom collection role "…" is an invalid URL.
OPF-071VirheIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072KäyttöMetadata element "…" is empty.
OPF-073VirheExternal identifiers must not appear in the document type declaration.
OPF-074VirhePackage resource "…" is declared in several manifest items.
OPF-075VirhePreview collections must only point to EPUB Content Documents.
OPF-076VirheThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077VaroitusA Data Navigation Document should not be included in the spine.
OPF-078VirheAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079VaroitusDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080VaroitusA Search Key Map document file name should have the extension ".xml".
OPF-081VirheResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082VirheFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083VirheFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084VirheFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Varoitus"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086VaroitusProperty "…" is deprecated. Consider using … instead.
OPF-086bKäyttöepub:type value "…" is deprecated. Consider using … instead.
OPF-086cVaroitusthe "…" reserved prefix is deprecated.
OPF-087Käyttöepub:type value "…" is not allowed on documents of type "…".
OPF-088KäyttöUnrecognized epub:type value "…".
OPF-089VirheThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090KäyttöIt is encouraged to use MIME media type "…" instead of "…".
OPF-091VirheThe item href URL must not have a fragment identifier.
OPF-092VirheLanguage tag "…" is not well-formed: …
OPF-093VirheThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094VirheThe "media-type" attribute is required for "…" links.
OPF-095VirheThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096VirheNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bKäyttöNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097KäyttöResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098VirheThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099VirheThe manifest must not list the package document.
OPF-100KäyttöThe "…" property only applies to pre-paginated content.

HTM: XHTML sisältöasiakirjat

XHTML luvut: DOCTYPE, entiteetit, nimevälit ja kiinteät näkymäportit.

KoodiOletusarvoinen vakavuusViesti
HTM-001VirheAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002VaroitusThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003VirheExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004VirheIrregular DOCTYPE: found "…", expected "…".
HTM-005KäyttöAn external reference was found.
HTM-007VaroitusEmpty or whitespace-only value of attribute ssml:ph.
HTM-009VirheThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010KäyttöNamespace "…" is unusual for the prefix "epub".
HTM-011VirheEntity is undeclared.
HTM-025VaroitusNon-registered URI scheme type found in href.
HTM-044KäyttöNamespace uri "…" was included but not used.
HTM-045KäyttöEncountered empty href.
HTM-046VirheFixed layout document has no "viewport" meta element.
HTM-047VirheViewport metadata "…" has a syntax error
HTM-048VirheSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051VaroitusFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052VirheThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054VirheCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055KäyttöThe "…" element should not be used (discouraged construct)
HTM_056VirheViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057VirheViewport "…" value must be a positive number or the keyword "device-…"
HTM_058VirheHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059VirheViewport "…" property must not be defined more than once, but found values […].
HTM_060aKäyttöEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bKäyttöEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Virhe"…" 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_062KäyttöSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063KäyttöSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Tyylitiedostot

CSS-tiedostot ja tyylielementit: kielletyt ominaisuudet, koodaukset, fontit ja syntaksi.

KoodiOletusarvoinen vakavuusViesti
CSS-001VirheThe "…" property must not be included in an EPUB Style Sheet.
CSS-002VirheEmpty or NULL reference found.
CSS-003VaroitusCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004VirheCSS documents must be encoded in UTF-8, detected …;
CSS-005KäyttöConflicting alternate style tags found: ….
CSS-006KäyttöCSS selector specifies fixed position.
CSS-007TietoaFont-face reference "…" refers to non-standard font type "…".
CSS-008VirheAn error occurred while parsing the CSS: ….
CSS-015VirheAlternative style sheets must have a title.
CSS-019VaroitusCSS font-face declaration has no attributes.
CSS-028KäyttöUse of Font-face declaration.
CSS-029KäyttöFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030VirheThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 sisällysluettelo)

Legacy NCX sisällysluettelo.

KoodiOletusarvoinen vakavuusViesti
NCX-001VirheNCX identifier ("…") does not match OPF identifier ("…").
NCX-004KäyttöNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006KäyttöEmpty "text" label in the NCX document

MED: Kuvat, ääni ja mediasovitteet.

Kuvamuodot ja otsikot, sekä synkronoitu ääni (media overlayt).

KoodiOletusarvoinen vakavuusViesti
MED-003VirhePicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004VirheImage file header may be corrupted.
MED-005VirheMedia Overlay audio reference … to non-standard audio type … found.
MED-008VirheThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009VirheThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007VirhePicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010VirheEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011VirheEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012VirheThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013VirheMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014VirheMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015KäyttöMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016VaroitusMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017VaroitusURL fragment should indicate an element ID, but found '#…'.
MED_018VaroitusURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Saavutettavuus

Saavutettavuustarkistukset sisältöasiakirjoissa (useimmat on oletuksena ohitettu).

KoodiOletusarvoinen vakavuusViesti
ACC-004LaskettuHtml "a" element must have text.
ACC-005LaskettuTable heading cells should be identified by "th" elements for accessibility.
ACC-006LaskettuTables should include a "thead" element for accessibility.
ACC-007LaskettuContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009KäyttöMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011KäyttöSVG hyperlink has no accessible name
ACC-012LaskettuTable elements should include a caption element.

OBS: Vanhentuneet ominaisuudet

Ominaisuudet, jotka toimivat edelleen mutta ovat vanhentuneita.

KoodiOletusarvoinen vakavuusViesti
OBS-001KäyttöUsage of … is outdated.

INF: Tietoa

Muistiinpanot liittyen EPUBCheck:een.

KoodiOletusarvoinen vakavuusViesti
INF-001TietoaRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck kokoonpano

Ongelmat EPUBCheck:n oman mukautetun viestitiedoston kanssa, eivät EPUB:n kanssa.

KoodiOletusarvoinen vakavuusViesti
CHK-001VirheThe custom message overrides file was not found.
CHK-002VirheUnrecognized custom message id … encountered in message overrides file "…".
CHK-003VirheUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004VirheThe custom message contains too many parameters in message overrides file "…".
CHK-005VirheThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006VirheUnable to parse the custom format parameter in message overrides file "…".
CHK-007VirheError encountered while processing custom message file "…": "…".
CHK-008VirheError encountered while processing an item "…"; skip other checks for the item.

Poistetut viesti-ID:t

Nämä tunnukset ovat vielä olemassa EPUBCheck:n viestiluettelossa, mutta niiltä puuttuu teksti ja ne on oletuksena piilotettu, joten EPUBCheck ei koskaan ilmoita niistä, ellei mukautettu viestitiedosto aktivoi niitä.

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

Lähde ja lisenssi

Viestitekstit ja oletusvakavuudet tulevat EPUBCheck 5.4.0:stä, W3C:n EPUB validoijasta, joka on julkaistu BSD-3-Clause -lisenssin alla. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Syyt ja korjaukset kirjoittaa EpubCC. Selityksettömät koodit näyttävät vain virallisen viestin, eikä niitä tarjota hakukoneille ennen kuin kirjoitamme yhden. EpubCC ei ole W3C:n kumppani.

PDF - EPUB työkalua

Jokainen työkalu käyttää samaa moottoria. Enintään 3 kirjaa päivässä on ilmaisia.

Näe kaikki työkalut