EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-007: zabronione mapowanie prefiksu

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-007 to komunikat ostrzegawczy: „Re-declaration of reserved prefix "…".” Atrybut prefiksu deklaruje mapowanie, którego EPUB nie pozwala, najczęściej jest to ponowne zadeklarowanie zastrzeżonego prefiksu. EPUBCheck zgłasza cztery powiązane przypadki: OPF-007 (ostrzeżenie) oraz OPF-007a, OPF-007b i OPF-007c (błędy).

Oficjalna wiadomość

Re-declaration of reserved prefix "%1$s".

Domyślna powaga: Ostrzeżenie. EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy działanie z wynikiem 0, chyba że przekażesz --failonwarnings.
Wersja EPUBCheck: 5.4.0

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

Typowe przyczyny

OPF-007: zarezerwowany prefiks, taki jak dcterms, rendition, schema lub a11y jest mapowany do URI innego niż jego zarezerwowane, najczęściej dlatego, że atrybut prefiksu został skopiowany z innej książki.
OPF-007a: prefiks "_" został zadeklarowany, co EPUB zabrania.
OPF-007b: prefiks jest mapowany do URI domyślnego słownika, którego terminy muszą być używane bez prefiksu.
OPF-007c: prefiks jest mapowany do przestrzeni nazw Dublin Core /elements/1.1/, która należy do deklaracji xmlns:dc, a nie do atrybutu prefiksu.

Jak to naprawić

Znajdź atrybut prefix w elemencie package pliku .opf.
Usuń mapowanie EPUBCheck nazw: zarezerwowane prefiksy działają bez deklaracji, domyślne słownictwa nie potrzebują prefiksu, a "_" nie może być zadeklarowane.
Zachowaj Dublin Core jako xmlns:dc="http://purl.org/dc/elements/1.1/" w elemencie pakietu lub metadanych.
Jeśli atrybut jest teraz pusty, usuń go.

Kiedy to nie to

Jeśli prefiks jest użyty w właściwości, ale nigdy nie zadeklarowany, to jest OPF-028; jeśli składnia atrybutu jest błędna, to jest odmiana OPF-004.

Również zgłoszone jako

OPF-007a (błąd): Invalid prefix mapping: prefix "_" must not be declared.
OPF-007b (błąd): Invalid prefix mapping: default vocabulary "%1$s" must not be re-declared.
OPF-007c (błąd): Invalid prefix mapping: a prefix to the Dublin Core /elements/1.1/ namespace must not be declared

Terminy używane tutaj

Inne komunikaty OPF

OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.

Źródła

EPUB 3.3, §D.1.5 Reserved prefixes · czytaj 4 listopada 2026
EPUB 3.3, §D.1.3 Default vocabularies · 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-007?

Czy OPF-007 to błąd?

OPF-007 jest zgłaszane jako ostrzeżenie domyślnie. EPUB jest wciąż ważne, ale coś może spowodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy z 0, chyba że przekażesz --failonwarnings.