EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-014: brakująca właściwość manifestu

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-014 to komunikat o błędzie: „The property "…" should be declared in the OPF file.” Dokument zawartości używa funkcji, która musi być zadeklarowana w elemencie manifestu, a deklaracja jest brakująca. EPUB wymaga tych właściwości, aby aplikacje do czytania wiedziały z wyprzedzeniem, które dokumenty potrzebują SVG, MathML, skryptów lub dostępu do sieci.

Oficjalna wiadomość

The property "%1$s" should be declared in the OPF file.

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

Inline SVG w dokumencie XHTML, którego element manifestu brakuje properties="svg".
MathML bez "mathml", lub skryptów (w tym atrybutów formularzy lub zdarzeń) bez "scripted".
Audio, wideo lub czcionki ładowane z sieci bez "remote-resources" na elemencie manifestu.

Jak to naprawić

Przeczytaj nazwę właściwości i plik w wiadomości.
Dodaj tę właściwość do elementu manifestu pliku, na przykład <item id="c1" href="ch1.xhtml" media-type="application/xhtml+xml" properties="svg"/>.
Oddziel kilka właściwości spacjami, takich jak properties="svg mathml".
Uruchom EPUBCheck ponownie; jeśli funkcja nie była zamierzona, zamiast tego usuń ją z dokumentu.

Kiedy to nie to

Jeśli atrybut jest zadeklarowany, ale dokument nie używa tej funkcji, to OPF-015, przeciwny przypadek.

Terminy używane tutaj

Inne komunikaty OPF

OPF-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.
OPF-015 The property "…" should not be declared in the OPF file.
OPF-012 Item property "…" is not defined for media type "…".
OPF-016 The element "rootfile" is missing its required attribute "full-path".
OPF-011 itemref can’t have both page-spread-right and page-spread-left properties.
OPF-017 The attribute "full-path" on element "rootfile" must not be empty.

Źródła

EPUB 3.3, §5.6.2.1 Resource properties · 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-014?

Czy OPF-014 to błąd?

OPF-014 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.