EPUBCheck · XHTML inhoudsdocumenten

EPUBCheck HTM-046: vaste lay-out zonder viewport

Bijgewerkt: 4 november 2026

EPUBCheck HTM-046 is een foutmelding: “Fixed layout document has no "viewport" meta element.” Een vast-indeling XHTML document heeft geen viewport meta-element, zodat lees-apps niet weten wat de paginagrootte is. In een vaste lay-out definiëren de breedte en hoogte in de viewport de coördinatenruimte van elke pagina; zonder deze kan de pagina niet zo worden weergegeven als bedoeld.

Het officiële bericht

Fixed layout document has no "viewport" meta element.

Standaard ernst: Fout. De EPUB overtreedt een regel van de specificatie en is ongeldig. Opslaan en Verzenden naar Kindle kunnen het afwijzen, en EPUBCheck verlaat met status 1.
EPUBCheck versie: 5.4.0

Typische oorzaken

Vaste-layout pagina's geschreven zonder de viewport verklaring.
Een boek dat in het pakketdocument als voorgeprijsd is verklaard, waarvan de hoofdstukken zijn geschreven als herflowbare tekst.

Hoe het te repareren

Voeg een viewport toe in de head van elke vastliggende pagina met zijn breedte en hoogte in pixels, bijvoorbeeld <meta name="viewport" content="width=1200, height=1600"/>.
Gebruik de grootte waarvoor de pagina is ontworpen (vaak de pixelgrootte van de achtergrondafbeelding).
Als het boek niet bedoeld is om een fixed layout te zijn, verwijder dan rendition:layout "pre-paginated" uit het pakketdocument.
Herbouw de EPUB en voer EPUBCheck opnieuw uit om te bevestigen dat het bericht is verdwenen.

Wanneer het niet dit is

Als de pagina SVG is in plaats van XHTML, is de ontbrekende grootte een viewBox en is het bericht HTM-048.

Termen die hier worden gebruikt

Wat is een vastgelegde lay-out EPUB?

Andere HTM berichten

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.

Bronnen

EPUB 3.3, §8.2.2.6 Content document dimensions · lezen 4 november 2026

Berichttekst en ernst van EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Uitleg door EpubCC.

FAQ

Wat betekent EPUBCheck HTM-046?

Is HTM-046 een fout?

HTM-046 wordt standaard gerapporteerd als fout. De EPUB overtreedt een regel van de specificatie en is ongeldig. Winkels en verzend naar Kindle kunnen het afwijzen, en EPUBCheck sluit af met status 1.