İçeriğe atla

EPUBCheck mesajları açıklandı

EPUBCheck, EPUB içinde her sorunu RSC-005 veya OPF-014 gibi bir kod ile bildirir ve ciddiyet derecesi vardır. Bu referans, EPUBCheck 5.4.0'in tüm 246 mesajlarını resmi metinleriyle listeler ve 188'lerinin nedenlerini ve çözümlerini açıklar.

Güncellendi:

Şiddetler

Kritik hata
EPUBCheck, EPUB'nin bu kısmını kontrol etmeye devam edemedi. Dosya geçersiz.
Hata
EPUB, spesifikasyonun bir kuralını ihlal ediyor ve geçersizdir. Depolar ve Kindle'ye gönder, onu reddedebilir ve EPUBCheck ile durum 1 ile çıkış yapar.
Uyarı
EPUB hala geçerli, ancak bazı okuma uygulamalarında sorun çıkaracak bir şey muhtemelen var. EPUBCheck, --failonwarnings geçmezseniz 0 ile çıkış yapar.
Kullanım
Sadece bilgilendirici ve varsayılan olarak gizlidir: EPUBCheck -u (--usage) ile çalışırken görünür. Bu, EPUB'yi geçersiz kılmaz.
Bilgi
Sadece bilgilendiricidir. Bu, EPUB'yi geçersiz kılmaz.
Baskıdan kaldırıldı
EPUBCheck, bu mesajı varsayılan olarak bildirmez. Yalnızca bir özel mesaj dosyası (-c) şiddetini değiştirdiğinde görünür.

PKG: Paket ve ZIP kapsayıcı

EPUB dosyası kendisi: ZIP arşivi, mimetype dosyası, dosya adları ve uzantıları.

KodVarsayılan ciddiyetMesaj
PKG-001UyarıValidating the EPUB against version … but detected version ….
PKG-003HataUnable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004Kritik hataCorrupted EPUB ZIP header.
PKG-005HataThe 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-006HataMimetype file entry is missing or is not the first file in the archive.
PKG-007HataThe content of the mimetype file must be the string "application/epub+zip"…
PKG-008Kritik hataUnable to read file "…".
PKG-009HataThe file name "…" contains characters that are not allowed in OCF file names: ….
PKG-010UyarıThe file name "…" contains spaces, which may create interoperability issues with older reading systems.
PKG-011HataThe file name "…" is not allowed to end with ".".
PKG-012KullanımThe file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-013HataThe EPUB file includes multiple OPS renditions.
PKG-014UyarıThe EPUB contains empty directory "…".
PKG-015Kritik hataUnable to read EPUB contents: …
PKG-016UyarıUse only lowercase characters for the EPUB file extension for maximum compatibility.
PKG-017UyarıUncommon EPUB file extension.
PKG-018Kritik hataThe EPUB file could not be found.
PKG-020HataOPF file "…" could not be found.
PKG-021HataCorrupted image file encountered.
PKG-022UyarıWrong file extension for image. The image is a "…" file but has the file extension "…".
PKG-023KullanımValidating the EPUB against version 2.0, default validation profile will be used.
PKG-024KullanımUncommon EPUB file extension.
PKG-025HataPublication resource must not be located in the META-INF directory
PKG-026HataObfuscated resource must be a Font Core Media Type (was declared as "…" in "…").
PKG-027Kritik hataCould not extract EPUB ZIP content, probably due to file names not encoded in UTF-8.

RSC: Kaynaklar ve referanslar

Dosyalar ve aralarındaki bağlantılar: eksik dosyalar, bozuk referanslar, URL'ler, kodlamalar ve XML ayrıştırılması.

KodVarsayılan ciddiyetMesaj
RSC-001HataFile "…" could not be found.
RSC-002Kritik hataRequired META-INF/container.xml resource could not be found.
RSC-003HataNo rootfile tag with media type "application/oebps-package+xml" was found in the container.
RSC-004BilgiFile "…" is encrypted, its content will not be checked.
RSC-005HataError while parsing file: …
RSC-006HataRemote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
RSC-006bKullanımResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
RSC-007HataReferenced resource "…" could not be found in the EPUB.
RSC-007wUyarıReferenced resource "…" could not be found in the EPUB.
RSC-008HataReferenced resource "…" is not declared in the OPF manifest.
RSC-009UyarıA non-SVG image resource should not be defined with a fragment identifier.
RSC-010HataReference to non-standard resource type found.
RSC-011HataFound a reference to a resource that is not a spine item.
RSC-012HataFragment identifier is not defined.
RSC-013KullanımFragment identifier is used in a reference to a stylesheet resource.
RSC-014KullanımFragment identifier defines an incompatible resource type.
RSC-015KullanımA fragment identifier is required for svg use tag references.
RSC-016Kritik hataFatal Error while parsing file: …
RSC-017UyarıWarning while parsing file: …
RSC-019UyarıEPUBs with Multiple Renditions should contain a META-INF/metadata.xml file.
RSC-020Hata"…" is not a valid URL (…)
RSC-021HataA Search Key Map Document must point to Content Documents ("…" was not found in the spine).
RSC-022BilgiCannot check image details (requires Java version 7 or higher).
RSC-024KullanımInformative parsing warning: …
RSC-025KullanımInformative parsing error: …
RSC-026HataURL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-027UyarıXML document is encoded in UTF-16. It should be encoded in UTF-8 instead.
RSC-028HataXML documents must be encoded in UTF-8, but … was detected.
RSC-029HataData URL is not allowed in this context.
RSC-030HataFile URLs are not allowed in EPUB, but found "…".
RSC-031UyarıRemote resource references should use HTTPS, but found "…".
RSC-032HataFallback must be provided for foreign resources, but found none for resource "…" of type "…".
RSC-033HataRelative URL strings must not have a query component, but found one in "…".
RSC-034HataScripts must have a JavaScript media type.
RSC-035Kullanım"…" is a legacy media type for JavaScript. Consider using 'text/javascript' instead.
RSC-036Kullanım…

OPF: Paket belgesi (OPF)

Paket belgesi: meta veriler, manifest, spine, özellikler ve geri dönüşler.

KodVarsayılan ciddiyetMesaj
OPF-001HataThere was an error when parsing the EPUB version: ….
OPF-002Kritik hataThe OPF file "…" was not found in the EPUB.
OPF-003KullanımItem "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004UyarıInvalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-004aHataInvalid prefix declaration: found empty prefix.
OPF-004bHataInvalid prefix "…": must be a valid non-colonized name (aka "NCName").
OPF-004cHataInvalid prefix declaration: prefix "…" must be immediately followed by a colon character (":").
OPF-004dHataInvalid prefix declaration: prefix "…" must be separated by its URI with a space.
OPF-004eUyarıInvalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004fUyarıInvalid prefix declaration: found illegal whitespace between prefix mappings.
OPF-005HataInvalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006HataInvalid prefix declaration: URI "…" is not a valid URI.
OPF-007UyarıRe-declaration of reserved prefix "…".
OPF-007aHataInvalid prefix mapping: prefix "_" must not be declared.
OPF-007bHataInvalid prefix mapping: default vocabulary "…" must not be re-declared.
OPF-007cHataInvalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared
OPF-010HataError resolving reference: "…".
OPF-011Hataitemref can’t have both page-spread-right and page-spread-left properties.
OPF-012HataItem property "…" is not defined for media type "…".
OPF-013UyarıResource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-014HataThe property "…" should be declared in the OPF file.
OPF-015HataThe property "…" should not be declared in the OPF file.
OPF-016HataThe element "rootfile" is missing its required attribute "full-path".
OPF-017HataThe attribute "full-path" on element "rootfile" must not be empty.
OPF-018UyarıThe "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018bKullanımThe "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-021UyarıUse of non-registered URI scheme type in href: "…".
OPF-025HataProperty value list "…" is not allowed, only one value must be specified.
OPF-026HataFound malformed property value: "…".
OPF-027HataUndefined property: "…".
OPF-028HataUndeclared prefix: "…".
OPF-029HataThe file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-030HataThe unique-identifier "…" was not found.
OPF-031HataFile listed in reference element in guide was not declared in OPF manifest: ….
OPF-032HataGuide references "…" which is not a valid "OPS Content Document".
OPF-033HataThe spine contains no linear resources.
OPF-034HataThe spine contains multiple references to the manifest item with id "…".
OPF-035UyarıMedia type "text/html" is not appropriate for XHTML/OPS.
OPF-036KullanımVideo type "…" might not be supported by reading systems
OPF-037UyarıFound deprecated media-type "…".
OPF-038UyarıMedia type "…" is not appropriate for an OEBPS 1.2 context; Use "text/x-oeb1-document" instead.
OPF-039UyarıMedia-type "…" is not appropriate in an OEBPS 1.2 context. Use "text/x-oeb1-css" instead.
OPF-040HataFallback item with id "…" could not be found.
OPF-041HataFallback-style item with id "…" could not be found.
OPF-042Hata"…" is not a permissible spine media-type.
OPF-043HataSpine item with non-standard media-type "…" has no fallback.
OPF-044HataSpine item with non-standard media-type "…" has no EPUB content document fallback.
OPF-045HataEncountered circular reference in fallback chain.
OPF-047KullanımOPF file is using OEBPS 1.2 syntax allowing backwards compatibility.
OPF-048HataPackage tag is missing its required unique-identifier attribute and value.
OPF-049HataItem id "…" was not found in the manifest.
OPF-050HataTOC attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected.
OPF-051Baskıdan kaldırıldıImage dimensions exceed recommended size.
OPF-052HataRole value "…" is not valid.
OPF-053UyarıDate value "…" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:….
OPF-054HataDate value "…" is not valid as per http://www.w3.org/TR/NOTE-datetime:….
OPF-055Uyarı… tag is empty.
OPF-057Baskıdan kaldırıldıImage file length exceeds recommended size.
OPF-060HataDuplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
OPF-062KullanımFound Adobe page-map attribute on spine element in opf file.
OPF-063UyarıReferenced Adobe page-map item "…" was not found in the manifest.
OPF-064BilgiOPF declares type "…", validating using profile "…".
OPF-065HataInvalid metadata declaration, probably due to a cycle in "refines" metadata.
OPF-066HataMissing "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-067HataThe resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
OPF-070UyarıCustom collection role "…" is an invalid URL.
OPF-071HataIndex collections must only contain resources pointing to XHTML Content Documents.
OPF-072KullanımMetadata element "…" is empty.
OPF-073HataExternal identifiers must not appear in the document type declaration.
OPF-074HataPackage resource "…" is declared in several manifest items.
OPF-075HataPreview collections must only point to EPUB Content Documents.
OPF-076HataThe URI of preview collections link elements must not include EPUB canonical fragment identifiers.
OPF-077UyarıA Data Navigation Document should not be included in the spine.
OPF-078HataAn EPUB Dictionary must contain at least one Content Document with dictionary content (epub:type "dictionary").
OPF-079UyarıDictionary content was found (epub:type "dictionary"), the Package Document should declare the dc:type "dictionary".
OPF-080UyarıA Search Key Map document file name should have the extension ".xml".
OPF-081HataResource "…" (referenced from an EPUB Dictionary collection) was not found.
OPF-082HataFound an EPUB Dictionary collection containing more than one Search Key Map Document.
OPF-083HataFound an EPUB Dictionary collection containing no Search Key Map Document.
OPF-084HataFound an EPUB Dictionary collection containing resource "…" which is neither a Search Key Map Document nor an XHTML Content Document.
OPF-085Uyarı"dc:identifier" value "…" is marked as a UUID, but is an invalid UUID.
OPF-086UyarıProperty "…" is deprecated. Consider using … instead.
OPF-086bKullanımepub:type value "…" is deprecated. Consider using … instead.
OPF-086cUyarıthe "…" reserved prefix is deprecated.
OPF-087Kullanımepub:type value "…" is not allowed on documents of type "…".
OPF-088KullanımUnrecognized epub:type value "…".
OPF-089HataThe "alternate" link rel keyword cannot be paired with other keywords.
OPF-090KullanımIt is encouraged to use MIME media type "…" instead of "…".
OPF-091HataThe item href URL must not have a fragment identifier.
OPF-092HataLanguage tag "…" is not well-formed: …
OPF-093HataThe "media-type" attribute is required for linked resources located in the EPUB container
OPF-094HataThe "media-type" attribute is required for "…" links.
OPF-095HataThe "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
OPF-096HataNon-linear content must be reachable, but found no hyperlink to "…".
OPF-096bKullanımNo hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-097KullanımResource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-098HataThe "href" attribute must reference resources, not elements in the package document, but found URL "…".
OPF-099HataThe manifest must not list the package document.
OPF-100KullanımThe "…" property only applies to pre-paginated content.

HTM: XHTML içerik belgeleri

XHTML bölümleri: DOCTYPE, varlıklar, ad alanları ve sabit düzen görünüm alanları.

KodVarsayılan ciddiyetMesaj
HTM-001HataAny publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-002UyarıThe installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.
HTM-003HataExternal entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004HataIrregular DOCTYPE: found "…", expected "…".
HTM-005KullanımAn external reference was found.
HTM-007UyarıEmpty or whitespace-only value of attribute ssml:ph.
HTM-009HataThe DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010KullanımNamespace "…" is unusual for the prefix "epub".
HTM-011HataEntity is undeclared.
HTM-025UyarıNon-registered URI scheme type found in href.
HTM-044KullanımNamespace uri "…" was included but not used.
HTM-045KullanımEncountered empty href.
HTM-046HataFixed layout document has no "viewport" meta element.
HTM-047HataViewport metadata "…" has a syntax error
HTM-048HataSVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051UyarıFound Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-052HataThe property "region-based" is only allowed on nav elements in Data Navigation Documents.
HTM_054HataCustom attribute namespace ("…") must not include the string "…" in its domain.
HTM_055KullanımThe "…" element should not be used (discouraged construct)
HTM_056HataViewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_057HataViewport "…" value must be a positive number or the keyword "device-…"
HTM_058HataHTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059HataViewport "…" property must not be defined more than once, but found values […].
HTM_060aKullanımEPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "…" will be ignored.
HTM_060bKullanımEPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_061Hata"…" 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_062KullanımSVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_063KullanımSVG "xlink:href" attribute value ("…") should be equal to the "href" attribute value ("…").

CSS: Stil sayfaları

CSS dosyaları ve stil öğeleri: yasaklı özellikler, kodlamalar, yazı tipleri ve sözdizimi.

KodVarsayılan ciddiyetMesaj
CSS-001HataThe "…" property must not be included in an EPUB Style Sheet.
CSS-002HataEmpty or NULL reference found.
CSS-003UyarıCSS document is encoded in UTF-16. It should be encoded in UTF-8 instead.
CSS-004HataCSS documents must be encoded in UTF-8, detected …;
CSS-005KullanımConflicting alternate style tags found: ….
CSS-006KullanımCSS selector specifies fixed position.
CSS-007BilgiFont-face reference "…" refers to non-standard font type "…".
CSS-008HataAn error occurred while parsing the CSS: ….
CSS-015HataAlternative style sheets must have a title.
CSS-019UyarıCSS font-face declaration has no attributes.
CSS-028KullanımUse of Font-face declaration.
CSS-029KullanımFound CSS class name "…" but no "…" property was declared in the package document.
CSS-030HataThe package document declares media overlays styling class names but no CSS was found in the content document.

NCX: NCX (EPUB 2 içindekiler tablosu)

Miras NCX içindekiler tablosu.

KodVarsayılan ciddiyetMesaj
NCX-001HataNCX identifier ("…") does not match OPF identifier ("…").
NCX-004KullanımNCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006KullanımEmpty "text" label in the NCX document

MED: Resimler, ses ve medya örtüleri

Görüntü formatları ve başlıkları, senkronize ses (medya örtüşmeleri).

KodVarsayılan ciddiyetMesaj
MED-003HataPicture "img" elements must reference core media type resources, but found resource "…" of type "…".
MED-004HataImage file header may be corrupted.
MED-005HataMedia Overlay audio reference … to non-standard audio type … found.
MED-008HataThe time specified in the clipBegin attribute must not be after clipEnd.
MED-009HataThe time specified in the clipBegin attribute must not be the same as clipEnd.
MED_007HataPicture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_010HataEPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_011HataEPUB Content Document referenced from multiple Media Overlay Documents.
MED_012HataThe "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_013HataMedia Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_014HataMedia overlay audio file URLs must not have a fragment, but found '#…'.
MED_015KullanımMedia overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_016UyarıMedia Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_017UyarıURL fragment should indicate an element ID, but found '#…'.
MED_018UyarıURL fragment should be an SVG fragment identifier, but found '#…'.

ACC: Erişilebilirlik

İçerik belgelerinde erişilebilirlik kontrolleri (çoğu varsayılan olarak bastırılmıştır).

KodVarsayılan ciddiyetMesaj
ACC-004Baskıdan kaldırıldıHtml "a" element must have text.
ACC-005Baskıdan kaldırıldıTable heading cells should be identified by "th" elements for accessibility.
ACC-006Baskıdan kaldırıldıTables should include a "thead" element for accessibility.
ACC-007Baskıdan kaldırıldıContent Documents do not use "epub:type" attributes for semantic inflection.
ACC-009KullanımMathML should either have an "alttext" attribute or "annotation-xml" child element.
ACC-011KullanımSVG hyperlink has no accessible name
ACC-012Baskıdan kaldırıldıTable elements should include a caption element.

OBS: Geçersiz özellikler

Hala çalışan ancak güncel olmayan özellikler.

KodVarsayılan ciddiyetMesaj
OBS-001KullanımUsage of … is outdated.

INF: Bilgiler

EPUBCheck hakkında notlar.

KodVarsayılan ciddiyetMesaj
INF-001BilgiRule … is under review and its severity may change in a future release. See the discussion at …

CHK: EPUBCheck yapılandırması

EPUBCheck'nın kendi özel mesaj dosyası ile ilgili sorunlar, EPUB ile değil.

KodVarsayılan ciddiyetMesaj
CHK-001HataThe custom message overrides file was not found.
CHK-002HataUnrecognized custom message id … encountered in message overrides file "…".
CHK-003HataUnrecognized custom message severity "…" encountered in message overrides file "…".
CHK-004HataThe custom message contains too many parameters in message overrides file "…".
CHK-005HataThe custom suggestion contains too many parameters in message overrides file "…".
CHK-006HataUnable to parse the custom format parameter in message overrides file "…".
CHK-007HataError encountered while processing custom message file "…": "…".
CHK-008HataError encountered while processing an item "…"; skip other checks for the item.

Emekli mesaj kimlikleri

Bu ID'ler EPUBCheck'nin mesaj listesinde hâlâ var ancak metinleri yok ve varsayılan olarak bastırılıyor, bu yüzden EPUBCheck bunları özel bir mesaj dosyası açmadıkça rapor etmiyor.

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

Kaynak ve lisans

Mesaj metinleri ve varsayılan ciddiyetler, W3C'nin EPUB doğrulayıcısı olan EPUBCheck 5.4.0'dan gelmektedir ve BSD-3-Clause lisansı altında yayımlanmıştır. Copyright © 2007 Adobe Systems Incorporated. Copyright © 2008 IDPF. Copyright © 2017 W3C (MIT, ERCIM, Keio, Beihang). github.com/w3c/epubcheck

Nedenler ve çözümler EpubCC tarafından yazılır. Açıklaması olmayan kodlar yalnızca resmi mesajı gösterir ve biz biri yazana kadar arama motorlarına sunulmaz. EpubCC W3C ile ilişkilendirilmemiştir.

PDF ile EPUB araçları

Her araç aynı motoru kullanır. Günde 3 kitap ücretsizdir.

Tüm araçları gör