A mensagem de erro que uma loja mostra costuma ser vaga. Às vezes ela não diz mais do que «há um problema com o seu arquivo».
Então a primeira coisa é passá-lo por um validador chamado EPUBCheck. É a ferramenta oficial distribuída pelo W3C e é gratuita. Também há serviços que a rodam online.
A ferramenta diz exatamente qual arquivo, qual linha e o que está errado. Isso leva você à causa muito mais rápido do que a mensagem de erro de uma loja.
Se o EPUBCheck sai limpo e a loja continua recusando o arquivo, provavelmente não é questão da especificação do EPUB e sim de um requisito específico daquela loja. Veja a seção mais abaixo.
Se você faz EPUB por conta própria, os erros com que esbarra são bem previsíveis.
Dentro de um EPUB existe um arquivinho chamado mimetype , e a regra é que ele precisa ser guardado primeiro no ZIP e sem compressão.
Compactar uma pasta com uma ferramenta de compressão comum não atende a essa condição. É o problema mais frequente quando um EPUB foi montado à mão.
Todos os arquivos de um EPUB precisam ser registrados no <manifest> do content.opf .
Você acrescentou uma imagem e esqueceu de registrá-la, ou um arquivo registrado não existe mais: qualquer uma das duas incoerências produz erro.
O EPUB 3 exige o seguinte.
•dc:title (o título)
•dc:language (idioma; pt-BR para português do Brasil)
•dc:identifier (identificador)
•dcterms:modified (última modificação)
Um link do sumário (nav.xhtml) aponta para um arquivo que não está lá. Acontece quando você apaga um capítulo e esquece de atualizar o sumário.
O corpo de um EPUB é escrito em XHTML, que é mais rigoroso do que o HTML comum. Uma tag não fechada, ou escrever <br> (precisa ser <br />), produz erro.
Isso costuma acontecer quando tags HTML foram digitadas direto no manuscrito.
Se o EPUBCheck aponta zero erros e a loja continua recusando o arquivo, é um requisito da loja, e não da especificação.
Os requisitos de envio de cada loja são atualizados de tempos em tempos. Confirme sempre os atuais nas páginas de ajuda daquela loja.
Resumos de terceiros, este artigo incluído, podem estar desatualizados. Buscar na ajuda da loja o texto exato da mensagem de erro é o caminho mais confiável.
A Amazon converte para o formato dela o EPUB que recebe. Podem aparecer problemas nessa etapa de conversão, então conferir no Kindle Previewer antes de enviar estreita a causa mais rápido.
Se o Previewer abre mas o envio é recusado, é mais provável que o problema esteja nos seus dados de cadastro ou na análise do que no arquivo em si.
O EPUBCheck escreve em inglês, mas depois que você conhece o formato não é difícil.
| Rótulo | Significado |
|---|---|
| FATAL | Fatal. O arquivo não se sustenta de jeito nenhum |
| ERROR | Viola a especificação. Precisa ser corrigido |
| WARNING | Aviso. Funciona, mas não é recomendado |
| INFO | Informação. Normalmente não exige nada |
Olhe primeiro FATAL e ERROR. Os WARNING normalmente podem ser publicados como estão.
Quarenta erros seguidos parece desesperador, mas normalmente todos vêm de uma única causa.
Uma linha ruim no manifest, por exemplo, faz falhar todos os arquivos referenciados por ela.Corrija só o primeiro de cima e valide de novo — a contagem costuma desabar de uma vez.
Se você editou à mão um EPUB gerado por uma ferramenta e o quebrou, reconstruir a partir do manuscrito original costuma ser mais rápido. Corrigir o manuscrito e reconverter é mais confiável do que esmagar erros um a um.
O EPUB FACTORY passa cada arquivo que gera por uma validação conforme o padrão e mostra o resultado. Sem cadastro e sem instalar nada.
Testar o EPUB FACTORYO nosso diagnóstico de EPUB aponta os pontos que no papel são válidos mas quebram para leitores reais, no seu próprio idioma. Roda inteiramente no navegador, então o seu arquivo não é enviado a lugar nenhum. Grátis, sem cadastro.