EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM-047: błąd składni viewport

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM-047 to komunikat o błędzie: „Viewport metadata "…" has a syntax error.” Meta element viewport dokumentu o stałym układzie ma błąd składniowy. Atrybut content musi być listą właściwości name=value oddzielonych przecinkami, średnikami lub spacjami, a EPUBCheck cytuje wartość, której nie można było sparsować.

Oficjalna wiadomość

Viewport metadata "%1$s" has a syntax error

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

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

Typowe przyczyny

Nieprawidłowe separatory lub brak znaku równości w atrybucie treści.
Błędnie napisane klucze lub zbędne znaki, na przykład przecinek na końcu lub cudzysłowy wewnątrz wartoś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.
Zapisz to jako content="width=1200, height=1600": szerokość i wysokość, każda z wartością, oddzieloną przecinkiem.
Zachowaj inne właściwości widoku poza stronami o stałym układzie, chyba że ich potrzebujesz; aplikacje do czytania je ignorują.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli składnia jest poprawna, ale brakuje szerokości lub wysokości, to HTM_056; zła wartość to HTM_057.

Terminy używane tutaj

Inne komunikaty HTM

HTM-046 Fixed layout document has no "viewport" meta element.
HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-045 Encountered empty href.
HTM-044 Namespace uri "…" was included but not used.
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, §F.2 The viewport meta tag, syntax · 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-047?

Czy HTM-047 to błąd?

HTM-047 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.