EPUBCheck · documentos de XHTML

EPUBCheck HTM-046: diseño fijo sin viewport

Actualizado: 4 de noviembre de 2026

EPUBCheck HTM-046 es un mensaje de error: “Fixed layout document has no "viewport" meta element.” Un documento XHTML de diseño fijo no tiene elemento meta de viewport, por lo que las aplicaciones de lectura no conocen su tamaño de página. En el diseño fijo, el ancho y la altura en el viewport definen el espacio de coordenadas de cada página; sin ellos, la página no puede ser dispuesta como se diseñó.

El mensaje oficial

Fixed layout document has no "viewport" meta element.

Severidad por defecto: Error. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y el envío a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.
versión de EPUBCheck: 5.4.0

Causas típicas

Páginas de formato fijo escritas sin la declaración de viewport.
Un libro declarado como pre-paginado en el documento del paquete cuyos capítulos fueron escritos como texto refluido.

Cómo arreglarlo

Añadir un viewport en el head de cada página de diseño fijo con su ancho y alto en píxeles, por ejemplo <meta name="viewport" content="width=1200, height=1600"/>.
Usa el tamaño para el cual se diseñó la página (a menudo el tamaño en píxeles de su imagen de fondo).
Si el libro no está destinado a tener un diseño fijo, elimina rendition:layout "pre-paginated" del documento del paquete en su lugar.
Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.

Cuándo no es esto

Si la página es SVG en lugar de XHTML, el tamaño que falta es un viewBox y el mensaje es HTM-048.

Términos usados aquí

Otros mensajes de 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.

Fuentes

EPUB 3.3, §8.2.2.6 Content document dimensions · leer 4 de noviembre de 2026

Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.

FAQ

¿Qué significa EPUBCheck HTM-046?

¿Es HTM-046 un error?

HTM-046 se informa como error por defecto. El EPUB rompe una regla de la especificación y es inválido. Almacenes y Enviar a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.