EPUBCheck · Documento do pacote (OPF)

EPUBCheck OPF-003: arquivo ausente no manifesto

Atualizado: 4 de Novembro de 2026

EPUBCheck OPF-003 é uma mensagem de uso: “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” Um arquivo está no arquivo, mas não declarado no manifesto. Aplicativos de leitura trabalham a partir do manifesto, então um arquivo não declarado pode ser ignorado; esta é uma nota de uso, exibida apenas quando EPUBCheck é executado com -u.

A mensagem oficial

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

Severidade padrão: Uso. Apenas informativo e oculto por padrão: aparece quando EPUBCheck é executado com -u (--usage). Não torna o EPUB inválido.
versão EPUBCheck: 5.4.0

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

Causas típicas

Arquivos de sistema restantes, como .DS_Store ou Thumbs.db compactados junto com o livro.
Imagens antigas, backups ou rascunhos que permaneceram na pasta do livro após a edição.
Um novo arquivo adicionado à pasta sem atualizar o manifesto.

Como consertar isso

Olhe os nomes dos arquivos EPUBCheck e decida se o livro o utiliza.
Se o livro não o utiliza, exclua-o da pasta e reconstrua o arquivo.
Se o livro realmente o utilizar, adicione um item de manifesto com um id exclusivo, seu caminho e seu tipo de mídia, por exemplo <item id="img2" href="images/map.png" media-type="image/png"/>.

Quando não é isso

Se o arquivo não declarado também estiver referenciado no conteúdo, EPUBCheck relata RSC-008 também, que é o que deve ser corrigido primeiro.

Termos usados aqui

Outras mensagens de OPF

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Fontes

EPUB 3.3, §5.6.2 The item element · 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 OPF-003?

É OPF-003 um erro?

OPF-003 é relatado como uso por padrão. Informativo apenas e oculto por padrão: aparece quando EPUBCheck é executado com -u (--usage). Isso não torna o EPUB inválido.