EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-046: Fixed Layout ohne viewport

Aktualisiert: 4. November 2026

EPUBCheck HTM-046 ist eine Fehlermeldung: “Fixed layout document has no "viewport" meta element.” Ein Fixed-Layout XHTML Dokument hat kein Viewport-Meta-Element, sodass Leseanwendungen die Seitengröße nicht kennen. Im Fixed Layout definieren die Breite und Höhe im Viewport den Koordinatenraum jeder Seite; ohne sie kann die Seite nicht wie vorgesehen angeordnet werden.

Die offizielle Nachricht

Fixed layout document has no "viewport" meta element.

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

Typische Ursachen

Fixed-Layout-Seiten wurden ohne die Viewport-Deklaration geschrieben.
Ein Buch, das im Paketdokument als vorab paginiert deklariert ist und dessen Kapitel als fließender Text geschrieben wurden.

Wie man es behebt

Fügen Sie einen Viewport im Kopf jeder fixen Layoutseite mit ihrer Breite und Höhe in Pixeln hinzu, zum Beispiel <meta name="viewport" content="width=1200, height=1600"/>.
Verwenden Sie die Größe, für die die Seite entworfen wurde (oft die Pixelgröße ihres Hintergrundbildes).
Wenn das Buch nicht für ein festes Layout gedacht ist, entfernen Sie rendition:layout "pre-paginated" aus dem Paketdokument.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn die Seite SVG anstelle von XHTML ist, ist die fehlende Größe ein viewBox und die Meldung ist HTM-048.

Hier verwendete Begriffe

Was ist ein Fixed-Layout EPUB?

Andere HTM Nachrichten

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.

Quellen

EPUB 3.3, §8.2.2.6 Content document dimensions · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck HTM-046?

Ist HTM-046 ein Fehler?

HTM-046 wird standardmäßig als Fehler gemeldet. Der EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Shops und Senden an Kindle können es ablehnen, und EPUBCheck beendet mit Status 1.