EPUBCheck · documentos XHTML

EPUBCheck HTM-047: erro de sintaxe de viewport

Atualizado: 4 de Novembro de 2026

EPUBCheck HTM-047 é uma mensagem de erro: “Viewport metadata "…" has a syntax error.” O elemento meta viewport de um documento de layout fixo tem um erro de sintaxe. O atributo content deve ser uma lista de propriedades nome=valor separadas por vírgulas, ponto e vírgula ou espaços, e EPUBCheck coloca entre aspas o valor que não pôde ser analisado.

A mensagem oficial

Viewport metadata "%1$s" has a syntax error

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

%1$s, %2$s… são preenchidos com o arquivo, valor ou elemento EPUBCheck encontrado.

Causas típicas

Separadores incorretos ou um sinal de igual faltando no atributo de conteúdo.
Chaves mal soletradas ou caracteres soltos, por exemplo, uma vírgula no final ou aspas dentro do valor.

Como consertar isso

Abra o arquivo EPUBCheck names (a mensagem dá o caminho, linha e coluna) em um editor de texto ou EPUB como Sigil, ou descompacte o EPUB e abra-o lá.
Escreva-o como content="width=1200, height=1600": largura e altura, cada uma com um valor, separadas por uma vírgula.
Mantenha outras propriedades de viewport fora das páginas de layout fixo, a menos que você precise delas; aplicativos de leitura as ignoram.
Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.

Quando não é isso

Se a sintaxe está correta, mas largura ou altura estão faltando, isso é HTM_056; um valor ruim é HTM_057.

Termos usados aqui

Outras mensagens de HTM

HTM-046 Fixed layout document has no "viewport" meta element.
HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM-045 Encountered empty href.
HTM-044 Namespace uri "…" was included but not used.
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.

Fontes

EPUB 3.3, §F.2 The viewport meta tag, syntax · ler 4 de Novembro de 2026

Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.

FAQ

O que significa EPUBCheck HTM-047?

É HTM-047 um erro?

HTM-047 é relatado como erro por padrão. O EPUB quebra uma regra da especificação e é inválido. Armazenamentos e Enviar para Kindle podem rejeitá-lo, e EPUBCheck sai com status 1.