EPUBCheck · NCX (EPUB 2 sisällysluettelo)

EPUBCheck NCX-001: NCX uid ei vastaa OPF:ää

Päivitetty: 4. marraskuuta 2026

EPUBCheck NCX-001 on virheilmoitus: “NCX identifier ("…") does not match OPF identifier ("…").” NCX:n dtb:uid ei vastaa paketin ainutkertaista tunnistetta. NCX on EPUB 2 sisällysluettelo, ja sen dtb:uid:n on toistettava pakettidokumentin nimeämä ainutkertainen tunniste, tai jotkin vanhemmat lukulaitteet saattavat hylätä tiedoston.

Virallinen viesti

NCX identifier ("%1$s") does not match OPF identifier ("%2$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

Kirjan tunniste muutettiin pakettidokumentissa, mutta ei NCX:ssä.
NCX, joka on kopioitu toisesta kirjasta tai mallista.

Kuinka korjata se

Löydä dc:identifier, jonka id on nimetty paketin elementin unique-identifier-attribuuttilla.
Kopioi sen arvo tarkasti NCX:ään: <meta name="dtb:uid" content="..."/>.
Rakenna EPUB uudelleen ja suorita EPUBCheck uudelleen varmistaaksesi, että viesti on poistunut.

Milloin tämä ei ole se

Jos arvo vastaa mutta ympärillä on välilyöntejä tai rivinvaihtoja, huomautus on NCX-004.

Tässä käytetyt termit

Muut NCX viestit

NCX-004 NCX identifier ("dtb:uid" metadata) should not contain leading or trailing whitespace.
NCX-006 Empty "text" label in the NCX document

Lähteet

EPUB 3.3, §5.9.5 NCX · lue 4. marraskuuta 2026
EPUB 3.3, §5.5.3.1.1 The dc:identifier element · lue 4. marraskuuta 2026

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

FAQ

Mitä EPUBCheck NCX-001 tarkoittaa?

Onko NCX-001 virhe?

NCX-001 raportoidaan virheenä oletuksena. EPUB rikkoo määräyksen sääntöä ja on virheellinen. Kaupat ja lähetys Kindle voivat hylätä sen, ja EPUBCheck päättyy tilaan 1.