EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-032: Anleitung verlinkt auf Nicht-Dokument

Aktualisiert: 4. November 2026

EPUBCheck OPF-032 ist eine Fehlermeldung: „Guide references "…" which is not a valid "OPS Content Document".“ Ein Verweis im Element guide verweist auf eine Datei, die kein Inhaltsdokument ist. Der EPUB 2 Leitfaden darf nur auf Dokumente verweisen, die eine Leseanwendung als Seiten öffnen kann, wie z. B. XHTML Kapitel.

Die offizielle Nachricht

Guide references "%1$s" which is not a valid "OPS Content Document".

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 Leitfaden-Eintrag vom Typ Cover, der auf das Coverbild anstelle der XHTML-Seite verweist, die es anzeigt.
Ein Leitfaden-Eintrag, der auf ein Stylesheet, eine Schriftart oder eine andere Datei, die kein Dokument ist, verweist.
Ein Leitfaden, der aus einem anderen Buch kopiert wurde, dessen Dateien unterschiedliche Typen hatten.

Wie man es behebt

Finde die Referenz EPUBCheck Namen im Leitfaden.
Verweisen Sie href auf das XHTML-Dokument, das den Inhalt anzeigt (für ein Cover, die Titelseite).
Oder löschen Sie den Eintrag; im EPUB 3 ersetzt die landmarks-nav den Führer.

Wann es nicht das ist

Wenn das Ziel des Leitfadens überhaupt nicht im Manifest vorhanden ist, ist das OPF-031.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-031 File listed in reference element in guide was not declared in OPF manifest: ….
OPF-033 The spine contains no linear resources.
OPF-030 The unique-identifier "…" was not found.
OPF-034 The spine contains multiple references to the manifest item with id "…".
OPF-029 The file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-035 Media type "text/html" is not appropriate for XHTML/OPS.

Quellen

EPUB 3.3, §5.9.4 The guide element · 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-032?

Ist OPF-032 ein Fehler?

OPF-032 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.