EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-028: użyto prefiksu, ale niezadeklarowanego

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-028 to komunikat o błędzie: „Undeclared prefix: "…".” Właściwość używa prefiksu, który nie jest zadeklarowany w atrybucie prefiksu dokumentu pakietu. Poza zarezerwowanymi prefiksami, każdy prefiks musi być przypisany do URI słownictwa, zanim będzie mógł być użyty.

Oficjalna wiadomość

Undeclared prefix: "%1$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

Właściwości dostawcy, takie jak ibooks:version użyte bez zadeklarowania prefiksu ibooks.
Atrybut prefix został usunięty lub oczyszczony, podczas gdy właściwości nadal go używają.
Błąd w prefiksie właściwości, więc już nie pasuje do zadeklarowanego.

Jak to naprawić

Przeczytaj nazwy prefiksu EPUBCheck.
Dodaj mapowanie do atrybutu prefix elementu pakietu. Napisz każde mapowanie jako nazwę prefiksu, dwukropek, jedną spację i URI słownika, a mapowania oddziel białymi znakami, na przykład prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
Lub, jeśli właściwość nie jest potrzebna, usuń ją.

Kiedy to nie to

Jeśli prefiks został zadeklarowany, ale deklaracja jest źle napisana, to jest to wariant OPF-004.

Terminy używane tutaj

Inne komunikaty OPF

OPF-027 Undefined property: "…".
OPF-029 The file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-026 Found malformed property value: "…".
OPF-030 The unique-identifier "…" was not found.
OPF-025 Property value list "…" is not allowed, only one value must be specified.
OPF-031 File listed in reference element in guide was not declared in OPF manifest: ….

Źródła

EPUB 3.3, §D.1.4 The prefix attribute · czytaj 4 listopada 2026
EPUB 3.3, §D.1.5 Reserved prefixes · 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 OPF-028?

Czy OPF-028 jest błędem?

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