EPUBCheck · Resurssit ja viittaukset

EPUBCheck RSC-027: XML-tiedosto koodattu UTF-16:lla

Päivitetty: 4. marraskuuta 2026

EPUBCheck RSC-027 on varoitusviesti: “XML document is encoded in UTF-16. It should be encoded in UTF-8 instead.” XML-tiedosto on koodattu UTF-16:lla; EPUB suosittelee UTF-8 jokaiseen XML-dokumenttiin. Tämä on varoitus: tiedosto luetaan edelleen, mutta jotkut lukusovellukset käsittelevät UTF-16:ta huonosti.

Virallinen viesti

XML document is encoded in UTF-16. It should be encoded in UTF-8 instead.

Oletusarvoinen vakavuus: Varoitus. EPUB on edelleen voimassa, mutta jokin saattaa aiheuttaa ongelmia joissakin lukusovelluksissa. EPUBCheck poistuu tilassa 0, ellei käytät --failonwarnings.
EPUBCheck versio: 5.4.0

Tyypilliset syyt

Tiedosto, joka on tallennettu UTF-16-muodossa editorilla, joka on yleinen joissakin Windows-työkaluissa, jotka kutsuvat sitä "Unicode".
Tiedostot, jotka on viety vanhemmasta tekstinkäsittelyohjelmasta tai skriptistä, jossa UTF-16 on oletuksena.

Kuinka korjata se

Avaa viestissä mainittu tiedosto editorissa, joka voi muuttaa koodauksia.
Tallenna se uudelleen muodossa UTF-8 ja varmista, että sen XML-määritys sanoo encoding="UTF-8".
Validoi uudelleen.

Milloin tämä ei ole se

Mikä tahansa muu kuin UTF-8 koodaus (ISO-8859-1, Windows-1252) on virhe RSC-028.

Tässä käytetyt termit

Muut RSC viestit

RSC-026 URL "…" leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)
RSC-028 XML documents must be encoded in UTF-8, but … was detected.
RSC-025 Informative parsing error: …
RSC-029 Data URL is not allowed in this context.
RSC-024 Informative parsing warning: …
RSC-030 File URLs are not allowed in EPUB, but found "…".

Lähteet

EPUB 3.3, §3.9 XML conformance · lue 4. marraskuuta 2026

Viestin teksti ja vakavuus EPUBCheck 5.4.0:stä (W3C, BSD-3-Clause). Selitys EpubCC:ltä.

FAQ

Mitä tarkoittaa EPUBCheck RSC-027?

Onko RSC-027 virhe?

RSC-027 ilmoitetaan varoituksena oletuksena. EPUB on edelleen voimassa, mutta jokin todennäköisesti aiheuttaa ongelmia joissakin lukusovelluksissa. EPUBCheck poistuu koodilla 0, ellei käytä --failonwarnings.