EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-029: Datei ist nicht ihr Medientyp

Aktualisiert: 4. November 2026

EPUBCheck OPF-029 ist eine Fehlermeldung: „The file "…" does not appear to match the media type …, as specified in the OPF file.“ Der Inhalt einer Datei entspricht nicht dem im Manifest angegebenen Medientyp. EPUBCheck betrachtet die Datei selbst, sodass eine falsche Deklaration Leseanwendungen dazu veranlassen kann, zu versuchen, sie im falschen Format zu decodieren.

Die offizielle Nachricht

The file "%1$s" does not appear to match the media type %2$s, as specified in the OPF file.

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

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

Typische Ursachen

Ein PNG, das als image/jpeg deklariert ist, oder umgekehrt.
Eine Datei wurde in ein anderes Format konvertiert, ohne das Manifest zu aktualisieren.
Eine Datei mit einer neuen Erweiterung umbenannt, ohne konvertiert zu werden.

Wie man es behebt

Überprüfen Sie das tatsächliche Format der Datei EPUBCheck-Namen (ein Bildbearbeitungsprogramm oder der file-Befehl sagt Ihnen das).
Ändern Sie den Medientyp des Manifests in dieses echte Format.
Oder konvertieren Sie die Datei in das Format, das das Manifest angibt, wobei der Name und die Referenzen konsistent bleiben.

Wann es nicht das ist

Wenn nur die Erweiterung nicht mit dem Format übereinstimmt, meldet EPUBCheck PKG-022.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-028 Undeclared prefix: "…".
OPF-030 The unique-identifier "…" was not found.
OPF-027 Undefined property: "…".
OPF-031 File listed in reference element in guide was not declared in OPF manifest: ….
OPF-026 Found malformed property value: "…".
OPF-032 Guide references "…" which is not a valid "OPS Content Document".

Quellen

EPUB 3.3, §5.6.2 The item element · lesen 4. November 2026
EPUB 3.3, §3.2 Core media types · lesen 4. November 2026

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

FAQ

Was bedeutet EPUBCheck OPF-029?

Ist OPF-029 ein Fehler?

OPF-029 wird standardmäßig als Fehler gemeldet. Die EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Geschäfte und Senden an Kindle können es ablehnen, und EPUBCheck beendet sich mit Status 1.