EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM-046: stały układ bez viewport

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM-046 to komunikat o błędzie: „Fixed layout document has no "viewport" meta element.” Dokument o stałym układzie XHTML nie ma meta elementu viewport, więc aplikacje czytające nie znają jego rozmiaru strony. W stałym układzie szerokość i wysokość w viewport określają przestrzeń współrzędnych każdej strony; bez nich strona nie może być ułożona zgodnie z projektem.

Oficjalna wiadomość

Fixed layout document has no "viewport" meta element.

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

Typowe przyczyny

Strony o stałym układzie napisane bez deklaracji viewport.
Książka zadeklarowana jako wstępnie paginowana w dokumencie pakietu, której rozdziały zostały napisane jako tekst dostosowujący się.

Jak to naprawić

Dodaj viewport w nagłówku każdej strony o stałym układzie z jej szerokością i wysokością w pikselach, na przykład <meta name="viewport" content="width=1200, height=1600"/>.
Użyj rozmiaru, na jaki strona została zaprojektowana (często rozmiar pikselowy jej tła).
Jeśli książka nie ma być w stałym układzie, usuń rendition:layout "pre-paginated" z dokumentu pakietu.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli strona jest SVG zamiast XHTML, brakujący rozmiar to viewBox, a komunikat brzmi HTM-048.

Terminy używane tutaj

Inne komunikaty HTM

HTM-045 Encountered empty href.
HTM-047 Viewport metadata "…" has a syntax error
HTM-044 Namespace uri "…" was included but not used.
HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.

Ź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-046?

Czy HTM-046 to błąd?

HTM-046 jest zgłaszany jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieprawidłowe. Sklepy i Wyślij do Kindle mogą je odrzucić, a EPUBCheck kończy z kodem stanu 1.