EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-016: rootfile bez full-path

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-016 to komunikat o błędzie: „The element "rootfile" is missing its required attribute "full-path".” Element rootfile w META-INF/container.xml nie ma atrybutu full-path. Ten atrybut to jedyna rzecz, która informuje aplikacje do czytania, gdzie znajduje się dokument pakietu, więc książka nie może być otwarta bez niego.

Oficjalna wiadomość

The element "rootfile" is missing its required attribute "full-path".

Domyślna powaga: Błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Wersja EPUBCheck: 5.4.0

Typowe przyczyny

Ręcznie napisany container.xml brakuje atrybutu.
Nazwa atrybutu źle napisana, taka jak fullpath lub full_path.
Szablon container.xml, który nigdy nie został ukończony.

Jak to naprawić

Otwórz META-INF/container.xml.
Dodaj pełną ścieżkę z ścieżką dokumentu pakietu od korzenia archiwum, na przykład <rootfile full-path="OEBPS/content.opf" media-type="application/oebps-package+xml"/>.
Sprawdź, czy ścieżka odpowiada rzeczywistej nazwie pliku i wielkości liter, a następnie odbuduj EPUB.

Kiedy to nie to

Jeśli full-path jest obecny, ale pusty, EPUBCheck zgłasza OPF-017; jeśli wskazuje na brakujący plik, OPF-002.

Terminy używane tutaj

Inne komunikaty OPF

OPF-015 The property "…" should not be declared in the OPF file.
OPF-017 The attribute "full-path" on element "rootfile" must not be empty.
OPF-014 The property "…" should be declared in the OPF file.
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-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.

Źródła

EPUB 3.3, §4.2.6.3.1.3 The rootfile element · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck OPF-016?

Czy OPF-016 jest błędem?

OPF-016 jest zgłaszane jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieważne. Sklepy i Wysyłanie do Kindle mogą to odrzucić, a EPUBCheck kończy z kodem 1.