EPUBCheck · NCX (EPUB 2 tabulka obsahu)

EPUBCheck NCX-001: NCX uid se neshoduje s OPF

Aktualizováno: 4. listopadu 2026

EPUBCheck NCX-001 je chybová zpráva: „NCX identifier ("…") does not match OPF identifier ("…").“ dtb:uid NCX se neshoduje s unikátním identifikátorem balíčku. NCX je EPUB 2 obsah, a jeho dtb:uid musí opakovat identifikátor, který balíčkový dokument uvádí v unique-identifier, jinak některé starší čtecí systémy mohou soubor odmítnout.

Oficiální zpráva

NCX identifier ("%1$s") does not match OPF identifier ("%2$s").

Výchozí závažnost: Chyba. EPUB porušuje pravidlo specifikace a je neplatný. Obchody a Odeslat do Kindle ho mohou odmítnout, a EPUBCheck ukončuje s chybovým stavem 1.
verze EPUBCheck: 5.4.0

%1$s, %2$s… jsou vyplněny souborem, hodnotou nebo prvkem EPUBCheck, který byl nalezen.

Typické příčiny

Identifikátor knihy byl změněn v dokumentu balíčku, ale ne v NCX.
NCX zkopírovaný z jiné knihy nebo z šablony.

Jak to opravit

Najděte dc:identifier, jehož id je pojmenováno atributem unique-identifier elementu package.
Zkopírujte přesně jeho hodnotu do NCX: <meta name="dtb:uid" content="..."/>.
Znovu sestavte EPUB a znovu spusťte EPUBCheck, abyste potvrdili, že zpráva zmizela.

Kdy to není to

Pokud hodnota odpovídá, ale má kolem sebe mezery nebo řádkové zlomky, poznámka je NCX-004.

Podmínky používané zde

Další NCX zprávy

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

Zdroje

EPUB 3.3, §5.9.5 NCX · číst 4. listopadu 2026
EPUB 3.3, §5.5.3.1.1 The dc:identifier element · číst 4. listopadu 2026

Text zprávy a závažnost od EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Vysvětlení od EpubCC.

FAQ

Co znamená EPUBCheck NCX-001?

Je NCX-001 chyba?

NCX-001 je ve výchozím nastavení hlášena jako chyba. EPUB porušuje pravidlo specifikace a je neplatné. Obchody a Odeslat do Kindle to mohou odmítnout a EPUBCheck se ukončuje s kódem 1.