EPUBCheck · Imagens, áudio e sobreposições de mídia

EPUBCheck MED_018: identificador de fragmento SVG inválido na sobreposição

Atualizado: 4 de Novembro de 2026

EPUBCheck MED_018 é uma mensagem de aviso: “URL fragment should be an SVG fragment identifier, but found '#…'.” Uma referência de texto de sobreposição de mídia em um documento SVG usa um fragmento que não é um identificador de fragmento SVG. EPUB recomenda identificadores de fragmento SVG lá, pois aplicativos de leitura podem não suportar outros esquemas; EPUBCheck avisa e mostra o fragmento.

A mensagem oficial

URL fragment should be an SVG fragment identifier, but found '#%1$s'.

Severidade padrão: Aviso. O EPUB ainda é válido, mas algo provavelmente causará problemas em alguns aplicativos de leitura. EPUBCheck sai com 0, a menos que você passe --failonwarnings.
versão EPUBCheck: 5.4.0

EPUBCheck imprime este ID com um sublinhado em vez de um hífen; esta página usa o ID exatamente como EPUBCheck o relata.

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

Causas típicas

Fragmentos escritos para XHTML usados em uma página SVG, como em quadrinhos de layout fixo com narração.
Um erro de digitação no fragmento.

Como consertar isso

Aponte o src do texto para um id de elemento no SVG, ou use um identificador de fragmento SVG, como um fragmento de view ou viewBox.
Verifique se o id realmente existe no arquivo SVG.
Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.

Quando não é isso

Para capítulos XHTML, o aviso equivalente é MED_017.

Termos usados aqui

O que são sobreposições de mídia EPUB?

Outras mensagens de MED

MED_017 URL fragment should indicate an element ID, but found '#…'.
MED_016 Media Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_015 Media overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_014 Media overlay audio file URLs must not have a fragment, but found '#…'.
MED_013 Media Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_012 The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.

Fontes

EPUB 3.3, §9.3.2.2 Referencing document fragments · 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 MED_018?

É MED_018 um erro?

MED_018 é relatado como aviso por padrão. O EPUB ainda é válido, mas algo pode causar problemas em alguns aplicativos de leitura. EPUBCheck sai com 0, a menos que você passe --failonwarnings.