EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM_057: nieprawidłowa wartość widoku

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM_057 to komunikat o błędzie: „Viewport "…" value must be a positive number or the keyword "device-…".” Szerokość lub wysokość widoku nie jest dodatnią liczbą ani odpowiadającym słowem kluczowym urządzenia. EPUB zezwala na prostą dodatnią liczbę lub device-width dla szerokości oraz device-height dla wysokości.

Oficjalna wiadomość

Viewport "%1$s" value must be a positive number or the keyword "device-%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

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

Wartości z jednostkami, takimi jak 1200px lub 100%.
Zero, liczby ujemne lub literówki, takie jak widht.
Zły słowo kluczowe dla wymiaru, taki jak height=device-width.

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.
Użyj zwykłej dodatniej liczby, na przykład width=1200, height=1600.
Lub, jeśli właściwość nie jest potrzebna, usuń ją.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli całkowicie brakuje jakiegoś wymiaru, wiadomość to HTM_056.

Terminy używane tutaj

Inne komunikaty HTM

HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_055 The "…" element should not be used (discouraged construct)
HTM_059 Viewport "…" property must not be defined more than once, but found values […].
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.
HTM_060b EPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.

Źródła

EPUB 3.3, §8.2.2.6 Content document dimensions · 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_057?

Czy HTM_057 to błąd?

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