EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM_061: nieprawidłowy atrybut data-*

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM_061 to komunikat o błędzie: „"…" is not a valid custom data attribute (it must have at least one character after the hyphen, be XML-compatible, and not contain ASCII uppercase letters).” Nazwa atrybutu data-* jest nieprawidłowa. Niestandardowy atrybut danych potrzebuje co najmniej jednego znaku po myślniku, żadnych wielkich liter ASCII oraz tylko znaków dozwolonych w nazwach XML.

Oficjalna wiadomość

"%1$s" is not a valid custom data attribute (it must have at least one character after the hyphen, be XML-compatible, and not contain ASCII uppercase letters).

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

Nazwy takie jak data-, data-Page lub data-x:y.
Atrybuty generowane przez skrypt lub narzędzie graficzne, które zachowuje nazwy w camelCase.

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.
Zmień nazwę atrybutu na małe litery, na przykład data-page zamiast data-Page.
Jeśli skrypt lub arkusz stylów odczytuje atrybut, zaktualizuj go do nowej nazwy również.
Usuń atrybut, jeśli nic w książce go nie używa.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli atrybut jest poprzedzony nazwą przestrzeni (np. ibooks:something), zasady są takie same jak dla atrybutów niestandardowych, zgłoszonych jako HTM_054.

Terminy używane tutaj

Co to jest XHTML w EPUB?

Inne komunikaty HTM

HTM_060b EPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.
HTM_062 SVG "xlink:href" attribute is deprecated; an "href" attribute should be used instead.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)

Źródła

EPUB 3.3, §6.1.2 XHTML requirements · 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_061?

Czy HTM_061 to błąd?

HTM_061 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.