EPUBCheck · Paketdokument (OPF)

EPUBCheck OPF-021: icke registrerat URI-schema

Uppdaterad: 4 november 2026

EPUBCheck OPF-021 är ett varningsmeddelande: “Use of non-registered URI scheme type in href: "…".” En href använder ett URI-schema som inte är registrerat, till skillnad från http, https eller mailto. Läsa appar kanske inte vet vad de ska göra med ett icke registrerat schema, så länken kan misslyckas tyst.

Det officiella meddelandet

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

Standardsvårighetsgrad: Varning. EPUB är fortfarande giltig, men något kan troligen orsaka problem i vissa läsappar. EPUBCheck avslutas med 0 om du inte passerar --failonwarnings.
EPUBCheck version: 5.4.0

%1$s, %2$s… fylls med filen, värdet eller elementet EPUBCheck som hittades.

Typiska orsaker

Ett skrivfel i schemat, som htp:// eller http//.
Ett app-specifikt schema som endast fungerar i ett program, såsom en länk avsedd för en särskild läsare.
En lokal filväg (C:\…) skriven där en URL förväntades.

Hur man åtgärdar det

Hitta href som EPUBCheck namnger.
Korrigera schemat till ett standardformat (https, http, mailto…) om det är ett typfel.
Om länken endast fungerar i en app eller på en dator, ta bort den eller ersätt den med en webbadress.

När det inte är detta

Om länken pekar på en fil inuti EPUB som inte finns, är det RSC-007.

Villkor som används här

Andra OPF meddelanden

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

Källor

EPUB 3.3, §5.3.2 The href attribute · läs 4 november 2026

Meddelandetext och allvarlighetsgrad från EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Förklaring av EpubCC.

FAQ

Vad betyder EPUBCheck OPF-021?

Är OPF-021 ett fel?

OPF-021 rapporteras som varning som standard. EPUB är fortfarande giltigt, men något kan sannolikt orsaka problem i vissa läsappar. EPUBCheck avslutas med 0 om du inte använder --failonwarnings.