EPUBCheck · Documento do pacote (OPF)

EPUBCheck OPF-098: link para elemento de pacote

Atualizado: 4 de Novembro de 2026

EPUBCheck OPF-098 é uma mensagem de erro: “The "href" attribute must reference resources, not elements in the package document, but found URL "…".” O href de um link de metadados aponta para um elemento dentro do documento do pacote em si (uma URL com #id). Elementos de link devem referenciar recursos, não partes do documento do pacote.

A mensagem oficial

The "href" attribute must reference resources, not elements in the package document, but found URL "%1$s".

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

Um link escrito como href="#title" ou content.opf#meta1 para apontar para metadados no mesmo arquivo.
Um link de voicing ou gravação destinado a um elemento meta em vez de um arquivo.
Um link copiado da sintaxe refinada, que utiliza #id.

Como consertar isso

Encontre o elemento de link EPUBCheck para o qual aponta.
Direcione o href para o arquivo real (um arquivo de áudio, um registro), não para o documento do pacote.
Para descrever um elemento do pacote, use o atributo refines com #id em vez de href.

Quando não é isso

Se o href de um item do manifesto contém um fragmento, isso é OPF-091.

Termos usados aqui

Outras mensagens de OPF

OPF-097 Resource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-099 The manifest must not list the package document.
OPF-096 Non-linear content must be reachable, but found no hyperlink to "…".
OPF-096b No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-100 The "…" property only applies to pre-paginated content.
OPF-095 The "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".

Fontes

EPUB 3.3, §5.5.6 The link 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-098?

É um erro OPF-098?

OPF-098 é reportado como erro por padrão. O EPUB viola uma regra da especificação e é inválido. Lojas e o envio para Kindle podem rejeitá-lo, e EPUBCheck sai com status 1.