EPUBCheck · Bilder, Audio und Medienüberlagerungen

EPUBCheck MED_017: Overlay-Fragment ist keine ID

Aktualisiert: 4. November 2026

EPUBCheck MED_017 ist eine Warnmeldung: „URL fragment should indicate an element ID, but found '#…'.“ Ein Medienoverlay-Textverweis verwendet ein Fragment, das keine Element-ID ist. Für XHTML Kapitel, EPUB wird empfohlen, auf ein Element nach seiner ID zu verweisen; andere Fragment-Schemata werden von Lese-Apps möglicherweise nicht unterstützt. EPUBCheck warnt und zeigt das Fragment an.

Die offizielle Nachricht

URL fragment should indicate an element ID, but found '#%1$s'.

Standard-Schweregrad: Warnung. Die EPUB ist weiterhin gültig, aber irgendetwas wird wahrscheinlich Probleme in einigen Leseanwendungen verursachen. EPUBCheck beendet die Ausführung mit 0, es sei denn, Sie übergeben --failonwarnings.
EPUBCheck Version: 5.4.0

EPUBCheck druckt diese ID mit einem Unterstrich anstelle eines Bindestrichs; diese Seite verwendet die ID genau so, wie EPUBCheck sie berichtet.

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Textfragment- oder Zeichenoffset-Schemata, die von einem Ausrichtungswerkzeug geschrieben wurden.
Ein Fragment mit einem Tippfehler oder einem führenden Zeichen, das nicht Teil der ID ist.

Wie man es behebt

Geben Sie der Phrase ein Element mit einer ID im Kapitel, zum Beispiel <span id="s12">.
Ziel den Text-src darauf, wie chapter1.xhtml#s12.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn das Ziel ein SVG-Dokument ist, sollte der Fragment ein SVG-Fragmentbezeichner (MED_018) sein.

Hier verwendete Begriffe

Andere MED Nachrichten

MED_016 Media Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_018 URL fragment should be an SVG fragment identifier, but found '#…'.
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.

Quellen

EPUB 3.3, §9.3.2.2 Referencing document fragments · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck MED_017?

Ist MED_017 ein Fehler?

MED_017 wird standardmäßig als Warnung gemeldet. Das EPUB ist weiterhin gültig, aber etwas könnte in einigen Lese-Apps Probleme verursachen. EPUBCheck beendet sich mit 0, es sei denn, Sie übergeben --failonwarnings.