EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM_056: brak wymiaru widoku

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM_056 to komunikat o błędzie: „Viewport metadata has no "…" dimension (both "width" and "height" properties are required).” Wskaźnik stałego układu deklaruje tylko jeden wymiar, a zarówno szerokość, jak i wysokość są wymagane. EPUBCheck nazywa wymiar, który jest brakujący.

Oficjalna wiadomość

Viewport metadata has no "%1$s" dimension (both "width" and "height" properties are required)

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

viewport z szerokością, ale bez wysokości, lub odwrotnie.
viewport skopiowany ze strony internetowej, taki jak width=device-width, initial-scale=1, który nie ma wysokości.

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.
Zadeklaruj oba w pierwszym elemencie meta viewport w nagłówku, na przykład content="width=1200, height=1600".
Użyj dodatnich liczb w pikselach, lub device-width i device-height, jeśli strona powinna wypełniać ekran.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli obie wartości są obecne, ale jedna z nich nie jest liczbą, to jest HTM_057; błąd parsowania to HTM-047.

Terminy używane tutaj

Inne komunikaty HTM

HTM_055 The "…" element should not be used (discouraged construct)
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.
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 […].
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_056?

Czy HTM_056 to błąd?

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