EPUBCheck · NCX (EPUB 2 spis treści)

EPUBCheck NCX-001: uid NCX nie pasuje do OPF

Zaktualizowane: 4 listopada 2026

EPUBCheck NCX-001 to komunikat o błędzie: „NCX identifier ("…") does not match OPF identifier ("…").” dtb:uid NCX nie zgadza się z unikalnym identyfikatorem pakietu. NCX to EPUB 2 spis treści, a jego dtb:uid musi powtarzać identyfikator, który dokument pakietu wymienia w unikal-identifier, w przeciwnym razie niektóre starsze systemy czytelnicze mogą odrzucić plik.

Oficjalna wiadomość

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

Domyślna powaga: Błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Wersja EPUBCheck: 5.4.0

%1$s, %2$s… wypełnione są plikiem, wartością lub elementem EPUBCheck znalezionym.

Typowe przyczyny

Identyfikator książki został zmieniony w dokumencie paczki, ale nie w NCX.
NCX skopiowany z innej książki lub z szablonu.

Jak to naprawić

Znajdź dc:identifier, którego id jest nazwane przez atrybut unique-identifier elementu pakietu.
Dokładnie skopiuj jego wartość do NCX: <meta name="dtb:uid" content="..."/>.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli wartość pasuje, ale ma spacje lub znaki nowej linii wokół, notatka to NCX-004.

Terminy używane tutaj

Inne komunikaty NCX

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

Źródła

EPUB 3.3, §5.9.5 NCX · czytaj 4 listopada 2026
EPUB 3.3, §5.5.3.1.1 The dc:identifier element · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck NCX-001?

Czy NCX-001 to błąd?

NCX-001 domyślnie jest zgłaszane jako błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowe. Sklepy i Wysyłka do Kindle mogą je odrzucić, a EPUBCheck kończy działanie z kodem 1.