Warum werden Bilder in der EPUB-Datei nicht angezeigt?
- Unterschiedliche Bildpfade und fehlerhafte Referenzen
- Fehler im EPUB-Manifest (content.opf) oder fehlende Deklaration
- MIME-Typen und Dateiformate werden nicht unterstützt
- Inline-Styles, CSS-Konflikte oder unsichtbare Darstellung
- Probleme durch falsche EPUB-Version oder Validierungsfehler
- DRM, Zugriffsbeschränkungen oder Leser-Einstellungen
- Prüfung und Lösungsschritte
Unterschiedliche Bildpfade und fehlerhafte Referenzen
Ein häufiger Grund ist, dass die Bilddateien im EPUB-Container vorhanden sind, die HTML- oder XHTML-Seiten aber falsche oder relative Pfade verwenden, die nicht auf die tatsächliche Speicherstruktur verweisen. In EPUBs müssen die Pfade in href- oder src-Attributen genau mit den im Package-Manifest (content.opf) angegebenen Pfaden übereinstimmen. Groß-/Kleinschreibung, Verzeichnistrenner und fehlende Datei-Endungen führen oft dazu, dass der Reader die Datei nicht findet und das Bild nicht lädt.
Fehler im EPUB-Manifest (content.opf) oder fehlende Deklaration
Im EPUB-Manifest müssen alle Ressourcen, also auch Bilder, mit einer id, href und einem korrekten Media-Type (z. B. image/jpeg, image/png, image/svg+xml) gelistet sein. Fehlt ein Eintrag oder ist der Media-Type falsch, ignorieren viele Reader die Datei. Ebenso kann eine fehlerhafte spine- oder manifest-Struktur dazu führen, dass Verknüpfungen zwischen Inhalt und Ressourcen verloren gehen.
MIME-Typen und Dateiformate werden nicht unterstützt
Nicht alle Reader unterstützen jedes Bildformat. Exotische oder fehlerhafte Formate, beschädigte Bilddateien oder falsch codierte SVGs können Probleme verursachen. Zusätzlich kann ein falsch gesetzter MIME-Type in Webserver-Kontexten (bei online gehosteten EPUBs) oder in metadata-Konfigurationen das Laden verhindern.
Inline-Styles, CSS-Konflikte oder unsichtbare Darstellung
CSS-Regeln können Bilder ausblenden (display:none, visibility:hidden), ihre Größe auf 0 setzen oder durch falsche z-Index-/Overflow-Einstellungen verdeckt werden. Relative Pfade in CSS (z. B. background-image) müssen relativ zur CSS-Datei angegeben werden. Außerdem können Reader eigene Styles anwenden, die das Layout verändern und Bilder unsichtbar machen.
Probleme durch falsche EPUB-Version oder Validierungsfehler
Wenn die EPUB-Datei nicht korrekt validiert wurde (z. B. gegen EPUB 2/3 Standards), können Reader unterschiedlich reagieren und Ressourcen nicht anzeigen. Ein fehlerhafter container.xml, falsche ZIP-Struktur oder beschädigte META-INF-Einträge verhindern den Zugriff auf Inhalte im ZIP-Archiv.
DRM, Zugriffsbeschränkungen oder Leser-Einstellungen
Bei DRM-geschützten EPUBs kann der Reader den Zugriff auf eingebettete Ressourcen blockieren. Auch Reader-Einstellungen (z. B. nur Textmodus, Deaktivierung von Images zur Datensparung) führen dazu, dass Bilder absichtlich nicht angezeigt werden.
Prüfung und Lösungsschritte
Überprüfen Sie die tatsächliche Dateistruktur des EPUB (als ZIP öffnen), kontrollieren Sie die Pfade in HTML/CSS und die Manifest-Einträge in content.opf, validieren Sie das EPUB mit einem Validator (z. B. epubcheck), testen Sie in mehreren Readern, schauen Sie nach CSS-Regeln, die Bilder verbergen, und prüfen Sie die Bilddateien auf Beschädigung und korrekte Formate/MIME-Typen. Falls DRM im Spiel ist, vergewissern Sie sich, dass die Datei korrekt autorisiert ist.