EpubCCEPUBCheck HTM-011: entidade nomeada não declarada
Atualizado:
EPUBCheck HTM-011 é uma mensagem de erro: “Entity is undeclared.” Uma entidade nomeada é usada que o documento não declara. XML só conhece &, <, >, " e ', então nomes HTML como quebram o XHTML e o capítulo pode não abrir de forma alguma.
A mensagem oficial
Entity is undeclared.
sugestão de EPUBCheck: Define the entity or use the numbered entity instead.
- 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
- Entidades HTML como , —, … ou © coladas em XHTML.
- Texto exportado de um processador de texto ou de uma página da web, onde os nomes das entidades HTML são normais.
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á.
- Substitua cada entidade nomeada por uma referência numérica (  para um espaço não separável, — para um travessão, … para uma reticência) ou digite o caractere em UTF-8.
- Pesquise o livro inteiro por
&seguido de letras para capturar as outras ocorrências de uma só vez. - Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.
Quando não é isso
Se a entidade estiver declarada no DOCTYPE através de um arquivo externo, a mensagem é HTM-003.
Termos usados aqui
Outras mensagens de HTM
HTM-010Namespace "…" is unusual for the prefix "epub".HTM-009The DOCTYPE provided is obsolete or irregular and can be removed.HTM-007Empty or whitespace-only value of attribute ssml:ph.HTM-004Irregular DOCTYPE: found "…", expected "…".HTM-003External entities are not allowed in EPUB v3 documents. External entity declaration found: ….HTM-001Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
Fontes
Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.