EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-048: SVG-Seite ohne viewBox

Aktualisiert: 4. November 2026

EPUBCheck HTM-048 ist eine Fehlermeldung: “SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).” Ein Fixed-Layout-Dokument, das als SVG erstellt wurde, hat kein viewBox-Attribut auf seinem äußersten svg-Element, sodass seine Größe unbekannt ist. Für SVG-Fixed-Layout-Seiten definiert der viewBox die Abmessungen der Seite.

Die offizielle Nachricht

SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" 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

SVG-Seiten, die mit Breite und Höhe, aber ohne viewBox exportiert wurden.
Ein viewBox, der auf einem inneren svg- oder g-Element platziert ist, anstelle des äußersten.

Wie man es behebt

Öffnen Sie die Datei EPUBCheck Namen (die Nachricht gibt den Pfad, die Zeile und die Spalte an) in einem Text- oder EPUB Editor wie Sigil, oder entpacken Sie die EPUB und öffnen Sie sie dort.
Fügen Sie ein viewBox zum äußeren svg-Element hinzu, zum Beispiel viewBox="0 0 1200 1600" (x, y, Breite, Höhe).
Verwenden Sie dieselbe Breite und Höhe, in der das Artwork erstellt wurde, damit nichts beschnitten oder gestreckt wird.
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 festgelegte Layoutseite XHTML ist, kommt die Größe von einem Viewport-Meta-Element und die Nachricht ist HTM-046.

Hier verwendete Begriffe

Was ist ein Fixed-Layout EPUB?

Andere HTM Nachrichten

HTM-047 Viewport metadata "…" has a syntax error
HTM-046 Fixed layout document has no "viewport" meta element.
HTM-045 Encountered empty href.
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-044 Namespace uri "…" was included but not used.
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-048?

Ist HTM-048 ein Fehler?

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