EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-003: Datei fehlt im Manifest

Aktualisiert: 4. November 2026

EPUBCheck OPF-003 ist eine Verwendungsmeldung: „Item "…" exists in the EPUB, but is not declared in the OPF manifest.“ Eine Datei befindet sich im Archiv, ist jedoch im Manifest nicht deklariert. Lese-Anwendungen arbeiten mit dem Manifest, sodass eine nicht deklarierte Datei ignoriert werden kann; dies ist eine Hinweismeldung, die nur angezeigt wird, wenn EPUBCheck mit -u ausgeführt wird.

Die offizielle Nachricht

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

Standard-Schweregrad: Nutzung. Nur informativ und standardmäßig ausgeblendet: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht EPUB nicht ungültig.
EPUBCheck Version: 5.4.0

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

Typische Ursachen

Überbleibsel-Dateien des Systems wie .DS_Store oder Thumbs.db werden zusammen mit dem Buch komprimiert.
Alte Bilder, Sicherungskopien oder Entwürfe, die nach der Bearbeitung im Buchordner geblieben sind.
Eine neue Datei, die dem Ordner hinzugefügt wurde, ohne das Manifest zu aktualisieren.

Wie man es behebt

Sehen Sie sich die Dateinamen EPUBCheck an und entscheiden Sie, ob das Buch sie verwendet.
Wenn das Buch es nicht verwendet, löschen Sie es aus dem Ordner und stellen Sie das Archiv neu zusammen.
Wenn das Buch es verwendet, fügen Sie einen Manifesteintrag mit einer eindeutigen ID, seinem Pfad und seinem Medientyp hinzu, zum Beispiel <item id="img2" href="images/map.png" media-type="image/png"/>.

Wann es nicht das ist

Wenn die nicht deklarierte Datei auch im Inhalt referenziert wird, meldet EPUBCheck ebenfalls RSC-008, das ist das erste, das behoben werden sollte.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Quellen

EPUB 3.3, §5.6.2 The item 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-003?

Ist OPF-003 ein Fehler?

OPF-003 wird standardmäßig als Nutzung gemeldet. Nur informativ und standardmäßig verborgen: es erscheint, wenn EPUBCheck mit -u (--usage) ausgeführt wird. Es macht die EPUB nicht ungültig.