EPUBCheck HTM-046: layout fixo sem viewport
Atualizado:
EPUBCheck HTM-046 é uma mensagem de erro: “Fixed layout document has no "viewport" meta element.” Um documento XHTML de layout fixo não possui um elemento meta viewport, então os aplicativos de leitura não conhecem seu tamanho de página. Em layout fixo, a largura e altura no viewport definem o espaço de coordenadas de cada página; sem eles, a página não pode ser formatada como projetado.
A mensagem oficial
Fixed layout document has no "viewport" meta element.
- Severidade padrão
- Erro. O EPUB quebra uma regra da especificação e é inválido. Lojas e Enviar para Kindle podem rejeitá-lo, e EPUBCheck sai com status 1.
- versão EPUBCheck
- 5.4.0
Causas típicas
- Páginas de layout fixo escritas sem a declaração de viewport.
- Um livro declarado como pré-paginado no documento do pacote cujos capítulos foram escritos como texto refluído.
Como consertar isso
- Adicione uma viewport no cabeçalho de cada página de layout fixo com sua largura e altura em pixels, por exemplo
<meta name="viewport" content="width=1200, height=1600"/>. - Use o tamanho para o qual a página foi projetada (geralmente o tamanho em pixels da imagem de fundo).
- Se o livro não for destinado a um layout fixo, remova rendition:layout "pre-paginated" do documento de pacote.
- Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.
Quando não é isso
Se a página é SVG em vez de XHTML, o tamanho faltante é um viewBox e a mensagem é HTM-048.
Termos usados aqui
Outras mensagens de HTM
HTM-045Encountered empty href.HTM-047Viewport metadata "…" has a syntax errorHTM-044Namespace uri "…" was included but not used.HTM-048SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).HTM-051Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.HTM_054Custom attribute namespace ("…") must not include the string "…" in its domain.
Fontes
Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.