EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM_054: zarezerwowana niestandardowa przestrzeń nazw

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM_054 to komunikat o błędzie: „Custom attribute namespace ("…") must not include the string "…" in its domain.” Atrybut niestandardowy używa przestrzeni nazw, której domena zawiera w3.org lub idpf.org. EPUB zezwala na atrybuty niestandardowe z prefiksem tylko w przestrzeniach nazw poza tymi dwiema domenami, które są zarezerwowane dla samego standardu.

Oficjalna wiadomość

Custom attribute namespace ("%1$s") must not include the string "%2$s" in its domain.

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

EPUBCheck drukuje ten identyfikator z podkreśleniem zamiast myślnika; ta strona używa identyfikatora dokładnie tak, jak EPUBCheck go raportuje.

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

Typowe przyczyny

Atrybut w wymyślonym przestrzeni nazw pod w3.org lub idpf.org, często błąd w pisowni prawdziwej przestrzeni nazw.
Rzeczywisty EPUB lub atrybut HTML napisany z niewłaściwym URI przestrzeni nazw, więc jest traktowany jako niestandardowy.

Jak to naprawić

Otwórz plik EPUBCheck (komunikat podaje ścieżkę, linię i kolumnę) w edytorze tekstu lub EPUB, takim jak Sigil, lub wypakuj EPUB i otwórz go tam.
Jeśli atrybut jest standardowy (np. epub:type), zadeklaruj jego poprawną przestrzeń nazw, na przykład xmlns:epub="http://www.idpf.org/2007/ops".
Jeśli to jest Twój własny atrybut lub atrybut dostawcy, przenieś go do URI przestrzeni nazw na kontrolowanej przez Ciebie domenie lub usuń.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli problem dotyczy nazwy atrybutu data-*, to HTM_061.

Terminy używane tutaj

Co to jest XHTML w EPUB?

Inne komunikaty HTM

HTM_055 The "…" element should not be used (discouraged construct)
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].

Źródła

EPUB 3.3, §6.1.3.5 Custom attributes · 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 HTM_054?

Czy HTM_054 to błąd?

HTM_054 jest zgłaszany jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieważny. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy pracę ze statusem 1.