EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-098: link do elementu pakietu

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-098 jest komunikatem o błędzie: “The "href" attribute must reference resources, not elements in the package document, but found URL "…".” href linku metadanych wskazuje na element wewnątrz samego dokumentu pakietu (URL z #id). Elementy linku muszą odnosić się do zasobów, a nie części dokumentu pakietu.

Oficjalna wiadomość

The "href" attribute must reference resources, not elements in the package document, but found URL "%1$s".

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

%1$s, %2$s… wypełnione są plikiem, wartością lub elementem EPUBCheck znalezionym.

Typowe przyczyny

Link zapisany jako href="#title" lub content.opf#meta1, aby wskazać na metadane w tym samym pliku.
Link głosowy lub nagraniowy skierowany do elementu meta zamiast do pliku.
Link skopiowany z składni refines, która używa #id.

Jak to naprawić

Znajdź element link EPUBCheck, do którego się odnosi.
Wskaźnik href na rzeczywisty plik (plik audio, dokument), a nie na dokument pakietu.
Aby opisać element pakietu, użyj atrybutu refines z #id zamiast href.

Kiedy to nie to

Jeśli href elementu manifestu zawiera fragment, to jest OPF-091.

Terminy używane tutaj

Inne komunikaty OPF

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 "…".

Źródła

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

Czy OPF-098 to błąd?

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