EPUBCheck RSC-005: skeemavirhe tiedostossa
Päivitetty:
EPUBCheck RSC-005 on virheilmoitus: “Error while parsing file: ….” Tiedosto ei noudata skeemaa, jota EPUB vaatii. Elementti, attribuutti tai arvo ei ole sallittu siinä, missä se on, tai jotain vaadittua puuttuu; teksti "Error while parsing file:":n jälkeen kertoo mikä. Tämä on yleisin EPUBCheck-virhe, ja yksi rakenteellinen virhe voi aiheuttaa useita viestejä.
Virallinen viesti
Error while parsing file: %1$s
- Oletusarvoinen vakavuus
- Virhe. EPUB rikkoo spesifikaation sääntöä ja on virheellinen. Kaupat ja Lähetä Kindle voivat hylätä sen, ja EPUBCheck poistuu tilassa 1.
- EPUBCheck versio
- 5.4.0
%1$s, %2$s… täytetään EPUBCheck löytyvällä tiedostolla, arvoilla tai elementeillä.
Tyypilliset syyt
- "element X not allowed here" tai "attribute X not allowed here": elementit, jotka on upotettu, missä skeema kieltää niitä (div osassa p), tai attribuutit, joita HTML tai EPUB ei määrittele, usein kopioitu verkkosivuilta tai tekstinkäsittelyohjelmista.
- "Duplicate ID": sama id-arvo käytetty kaksi kertaa yhdessä asiakirjassa, usein kopioiduista viitteistä tai otsikoista.
- Puuttuvia vaadittuja metatietoja, kuten dcterms:modified päivämäärä EPUB 3 pakettiasiakirjassa, tai puuttuva vaadittu elementti, kuten otsikko XHTML-otsikossa.
- "value of attribute X is invalid": väärän tyyppinen arvo, kuten päivämäärä väärässä muodossa tai id, joka alkaa numerolla.
Kuinka korjata se
- Lue teksti kaksipisteen jälkeen: EPUBCheck raportoi tiedoston, rivin ja sarakkeen, sekä parserin oman kuvauksen ongelmasta.
- Korjaa se elementti tai attribuutti, johon se viittaa: siirrä tai poista elementti, poista tuntematon attribuutti tai tee kaksois-id ainutlaatuiseksi ja päivitä siihen viitanneet linkit.
- Pakettiasiakirjoissa lisää puuttuvat metatiedot, esimerkiksi
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(täsmälleen yksi, siinä muodossa). - Korjaa ensin ensimmäiset virheet ja validoi uudelleen: yksi rakenteellinen virhe voi aiheuttaa useita myöhempiä virheitä.
Milloin tämä ei ole se
Jos tiedosto ei ole edes hyvin muotoiltu XML (pakoittamaton & tai sulkematon tagi), EPUBCheck raportoi vakavan RSC-016 sen sijaan.
Tässä käytetyt termit
Muut RSC viestit
RSC-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required META-INF/container.xml resource could not be found.
Lähteet
Viestin teksti ja vakavuus EPUBCheck 5.4.0:stä (W3C, BSD-3-Clause). Selitys EpubCC:ltä.