EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-031: Anleitung verlinkt auf fehlende Datei

Aktualisiert: 4. November 2026

EPUBCheck OPF-031 ist eine Fehlermeldung: “File listed in reference element in guide was not declared in OPF manifest: ….” Ein Verweis im EPUB 2 guide-Element verweist auf eine Datei, die nicht im Manifest enthalten ist. Der Leitfaden ist eine veraltete Liste von wichtigen Orten (Cover, Inhaltsverzeichnis, Start) und seine Ziele müssen erklärte Dateien sein.

Die offizielle Nachricht

File listed in reference element in guide was not declared in OPF manifest: %1$s.

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, der geblieben ist, nachdem eine Datei entfernt oder umbenannt wurde.
Ein falscher Pfad oder falscher Fall im href eines Referenzelements.
Ein Leitfaden, der aus einem anderen Buch kopiert wurde.

Wie man es behebt

Finde das Referenzelement, auf das EPUBCheck im Leitfaden verweist.
Korrigieren Sie href zu einer Datei, die im Manifest deklariert ist, oder löschen Sie den Eintrag.
In EPUB 3 ersetzt die Landmarken-Navigation im Navigationsdokument den Leitfaden, sodass Sie den Leitfaden entfernen können, wenn Sie nicht auf die Lesesysteme EPUB 2 abzielen.

Wann es nicht das ist

Wenn die Datei im Manifest vorhanden ist, aber kein Inhaltsdokument ist, meldet EPUBCheck OPF-032.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-030 The unique-identifier "…" was not found.
OPF-032 Guide references "…" which is not a valid "OPS Content Document".
OPF-029 The file "…" does not appear to match the media type …, as specified in the OPF file.
OPF-033 The spine contains no linear resources.
OPF-028 Undeclared prefix: "…".
OPF-034 The spine contains multiple references to the manifest item with id "…".

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-031?

Ist OPF-031 ein Fehler?

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