EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-017: leeres rootfile full-path

Aktualisiert: 4. November 2026

EPUBCheck OPF-017 ist eine Fehlermeldung: „The attribute "full-path" on element "rootfile" must not be empty.“ Ein rootfile-Element in META-INF/container.xml hat ein leeres full-path-Attribut. Das Attribut muss den Pfad zum Paketdokument enthalten; ein leerer Wert lässt den Lese-Anwendungen nichts zum Öffnen.

Die offizielle Nachricht

The attribute "full-path" on element "rootfile" must not be empty.

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

Typische Ursachen

Ein Vorlagen container.xml, dessen Pfad nie ausgefüllt wurde.
Ein Build-Skript, das den Pfad von einer Variablen schreibt, die leer war.
Ein Pfad, der beim Bearbeiten der Datei versehentlich gelöscht wurde.

Wie man es behebt

Öffnen Sie META-INF/container.xml.
Geben Sie den Pfad des Paketdokuments vom Stamm des Archivs an, zum Beispiel full-path="OEBPS/content.opf".
Überprüfen Sie den Pfad Buchstabe für Buchstabe mit der tatsächlichen Datei, dann bauen Sie die EPUB neu auf.

Wann es nicht das ist

Wenn das Attribut vollständig fehlt, ist das OPF-016.

Hier verwendete Begriffe

Andere OPF Nachrichten

OPF-016 The element "rootfile" is missing its required attribute "full-path".
OPF-018 The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018b The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found; please check scripted content to make sure the property is legit.
OPF-015 The property "…" should not be declared in the OPF file.
OPF-014 The property "…" should be declared in the OPF file.
OPF-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.

Quellen

EPUB 3.3, §4.2.6.3.1.3 The rootfile 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-017?

Ist OPF-017 ein Fehler?

OPF-017 wird standardmäßig als Fehler gemeldet. Das EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Läden und Senden zu Kindle könnten es ablehnen, und EPUBCheck endet mit Status 1.