OPF-004 raportoidaan varoituksena oletuksena. EPUB on edelleen voimassa, mutta jokin saattaa aiheuttaa ongelmia joissain lukusovelluksissa. EPUBCheck päättyy 0:aan, ellei käytä --failonwarnings.

EPUBCheck · Pakettiasiakirja (OPF)

EPUBCheck OPF-004: väärin muotoiltu etuliiteattribuutti

Päivitetty: 4. marraskuuta 2026

EPUBCheck OPF-004 on varoitusviesti: “Invalid prefix declaration: leading or trailing whitespace is not allowed.” Paketti-elementin etuliiteattribuutti ei ole kirjoitettu syntaksissa, jota EPUB vaatii. Tämä attribuutti kartoittaa lyhyet etuliitteet (kuten ibooks) sanastouri:hin, ja EPUBCheck raportoi jokaisen syntaksivirheen omalla OPF-004:n variantillaan.

Virallinen viesti

Invalid prefix declaration: leading or trailing whitespace is not allowed.

Oletusarvoinen vakavuus: Varoitus. EPUB on edelleen voimassa, mutta jokin saattaa aiheuttaa ongelmia joissakin lukusovelluksissa. EPUBCheck poistuu tilassa 0, ellei käytät --failonwarnings.
EPUBCheck versio: 5.4.0

Tyypilliset syyt

OPF-004: tyhjät tilat tai rivinvaihdot attribuuttin arvon alussa tai lopussa; OPF-004a: tyhjät etuliitteet, kaksoispiste ilman nimeä ennen sitä.
OPF-004b: etuliitteen nimi, joka ei ole voimassa oleva XML-nimi (NCName), esimerkiksi sellainen, joka alkaa numerolla tai sisältää vinoviivan; OPF-004c: tyhjä tila nimen ja kaksoispisteen välillä, kuten "ibooks : http://…".
OPF-004d: ei ole tyhjää tilaa kaksoispisteen ja URI:n välillä, kuten "ibooks:http://…"; OPF-004e: tabulaattori, rivinvaihto tai muu laiton tyhjä tila etuliitteen ja URI:n välillä.
OPF-004f: kartoitukset, jotka on erotettu muulla kuin tavallisella tyhjällä tilalla tai yhdistetty.

Kuinka korjata se

Etsi prefix-attribuutti paketin elementissä .opf-tiedostossa.
Kirjoita jokainen kartoitus etuliitteen nimellä, kaksoispiste, yksi väli ja sanaston URI, ja erottele kartoitukset valkoisella tilalla, esimerkiksi prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
Poista tyhjät merkit arvon alusta ja lopusta, anna jokaiselle kartalle nimi, joka alkaa kirjaimella (vain kirjaimia, numeroita, viivoja ja alakriippejä), ja laita kaksoispiste heti nimen jälkeen.
Varatut suosikit, kuten dcterms, esitykset ja skeemat eivät tarvitse julistusta, joten voit usein poistaa attribuutin täysin, jos se vain kartuttaa niitä.

Milloin tämä ei ole se

Jos syntaksi on oikein mutta etuliitteellä ei ole URI:a tai se on virheellinen, se on OPF-005 tai OPF-006.

Myös raportoitu nimellä

OPF-004a (virhe): Invalid prefix declaration: found empty prefix.
OPF-004b (virhe): Invalid prefix "%1$s": must be a valid non-colonized name (aka "NCName").
OPF-004c (virhe): Invalid prefix declaration: prefix "%1$s" must be immediately followed by a colon character (":").
OPF-004d (virhe): Invalid prefix declaration: prefix "%1$s" must be separated by its URI with a space.
OPF-004e (varoitus): Invalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004f (varoitus): Invalid prefix declaration: found illegal whitespace between prefix mappings.

Tässä käytetyt termit

Muut OPF viestit

OPF-003 Item "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-002 The OPF file "…" was not found in the EPUB.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-007 Re-declaration of reserved prefix "…".

Lähteet

EPUB 3.3, §D.1.4 The prefix attribute · lue 4. marraskuuta 2026

Viestin teksti ja vakavuus EPUBCheck 5.4.0:stä (W3C, BSD-3-Clause). Selitys EpubCC:ltä.