EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-098: Link zu Paket-Element

Aktualisiert: 4. November 2026

EPUBCheck OPF-098 ist eine Fehlermeldung: „The "href" attribute must reference resources, not elements in the package document, but found URL "…".“ Der href eines Metadatenlinks verweist auf ein Element im Paketdokument selbst (eine URL mit #id). Link-Elemente müssen Ressourcen referenzieren, nicht Teile des Paketdokuments.

Die offizielle Nachricht

The "href" attribute must reference resources, not elements in the package document, but found URL "%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 Link, der als href="#title" oder content.opf#meta1 geschrieben ist, um auf Metadaten in derselben Datei zu verweisen.
Ein Voicing- oder Record-Link, der sich an ein Meta-Element anstelle einer Datei richtet.
Ein Link, der aus einer verfeinerten Syntax kopiert wurde, die #id verwendet.

Wie man es behebt

Finde das Linkelement, auf das EPUBCheck verweist.
Verweisen Sie href auf die tatsächliche Datei (eine Audiodatei, eine Datei), nicht auf das Paketdokument.
Um ein Element des Pakets zu beschreiben, verwenden Sie das refines-Attribut mit #id anstelle von href.

Wann es nicht das ist

Wenn der href eines Manifest-Elements einen Fragment enthält, ist das OPF-091.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-097 Resource "…" is listed in the manifest, but no reference to it was found in content documents.
OPF-099 The manifest must not list the package document.
OPF-096 Non-linear content must be reachable, but found no hyperlink to "…".
OPF-096b No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.
OPF-100 The "…" property only applies to pre-paginated content.
OPF-095 The "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".

Quellen

EPUB 3.3, §5.5.6 The link 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-098?

Ist OPF-098 ein Fehler?

OPF-098 wird standardmäßig als Fehler gemeldet. Die EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Geschäfte und Send to Kindle könnten es ablehnen, und EPUBCheck endet mit Status 1.