EPUBCheck · Dokument pakietu (OPF)

EPUBCheck OPF-021: niezarejestrowany schemat URI

Zaktualizowane: 4 listopada 2026

EPUBCheck OPF-021 to komunikat ostrzegawczy: „Use of non-registered URI scheme type in href: "…".” Href używa schematu URI, który nie jest zarejestrowany, w przeciwieństwie do http, https lub mailto. Aplikacje do czytania mogą nie wiedzieć, co zrobić z niezarejestrowanym schematem, więc link może nie działać cicho.

Oficjalna wiadomość

Use of non-registered URI scheme type in href: "%1$s".

Domyślna powaga: Ostrzeżenie. EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy działanie z wynikiem 0, chyba że przekażesz --failonwarnings.
Wersja EPUBCheck: 5.4.0

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

Typowe przyczyny

Błąd w schemacie, taki jak htp:// lub http//.
Schemat specyficzny dla aplikacji, który działa tylko w jednym programie, na przykład link przeznaczony dla konkretnego czytnika.
Lokalna ścieżka pliku (C:\…) napisana tam, gdzie oczekiwano adresu URL.

Jak to naprawić

Znajdź href EPUBCheck nazwane.
Skoryguj schemat do standardowego (https, http, mailto…), jeśli to błąd typograficzny.
Jeśli link działa tylko w jednej aplikacji lub na jednym komputerze, usuń go lub zamień na adres internetowy.

Kiedy to nie to

Jeśli link prowadzi do pliku wewnątrz EPUB, który nie istnieje, to RSC-007.

Terminy używane tutaj

Inne komunikaty OPF

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-017 The attribute "full-path" on element "rootfile" must not be empty.
OPF-025 Property value list "…" is not allowed, only one value must be specified.
OPF-016 The element "rootfile" is missing its required attribute "full-path".
OPF-026 Found malformed property value: "…".

Źródła

EPUB 3.3, §5.3.2 The href attribute · 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-021?

Czy OPF-021 jest błędem?

OPF-021 jest zgłaszane jako ostrzeżenie domyślnie. EPUB jest wciąż ważne, ale coś może spowodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy z 0, chyba że przekażesz --failonwarnings.