OPF-004 wordt standaard als waarschuwing gerapporteerd. De EPUB is nog steeds geldig, maar er is iets dat waarschijnlijk problemen veroorzaakt in sommige lees-apps. EPUBCheck verlaat met 0, tenzij je --failonwarnings doorgeeft.

EPUBCheck · Pakketdocument (OPF)

EPUBCheck OPF-004: verkeerd gedefinieerd prefix-attribuut

Bijgewerkt: 4 november 2026

EPUBCheck OPF-004 is een waarschuwing: “Invalid prefix declaration: leading or trailing whitespace is not allowed.” Het prefix-attribuut op het pakketelement is niet geschreven in de syntaxis die EPUB vereist. Dat attribuut koppelt korte prefixes (zoals ibooks) aan vocabulaire URI's, en EPUBCheck rapporteert elke soort syntaxisfout met zijn eigen variant van OPF-004.

Het officiële bericht

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

Standaard ernst: Waarschuwing. De EPUB is nog steeds geldig, maar iets veroorzaakt waarschijnlijk problemen in sommige lees-apps. EPUBCheck verlaat met 0, tenzij je --failonwarnings doorgeeft.
EPUBCheck versie: 5.4.0

Typische oorzaken

OPF-004: spaties of regeleinden aan het begin of einde van de attribuutwaarde; OPF-004a: een lege prefix, een dubbele punt zonder naam ervoor.
OPF-004b: een prefixnaam die geen geldige XML-naam is (NCName), bijvoorbeeld een begin met een cijfer of een schuine streep bevat; OPF-004c: een spatie tussen de naam en de dubbele punt, zoals in "ibooks : http://…".
OPF-004d: geen spatie tussen de dubbele punt en de URI, zoals in "ibooks:http://…"; OPF-004e: een tab, regelovergang of andere onwettige spaties tussen de prefix en de URI.
OPF-004f: mappings gescheiden door iets anders dan gewone spaties, of aan elkaar geschreven.

Hoe het te repareren

Zoek de prefix attribuut op het package element van het .opf bestand.
Schrijf elke mapping als de prefixnaam, een dubbele punt, één spatie en de vocabulaire-URI, en scheid mappings met witruimte, bijvoorbeeld prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
Verwijder spaties aan het begin en einde van de waarde, geef elke mapping een naam die begint met een letter (alleen letters, cijfers, koppeltekens en onderstreepte), en zet de dubbele punt direct achter de naam.
Gereseveerde voorvoegsels zoals dcterms, rendition en schema hebben geen verklaring nodig, zodat je de eigenschap vaak geheel kunt verwijderen als deze alleen die in kaart brengt.

Wanneer het niet dit is

Als de syntaxis goed is maar een prefix geen URI heeft of ongeldig is, is dat OPF-005 of OPF-006.

Ook gerapporteerd als

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

Termen die hier worden gebruikt

Andere OPF berichten

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

Bronnen

EPUB 3.3, §D.1.4 The prefix attribute · lezen 4 november 2026

Berichttekst en ernst van EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Uitleg door EpubCC.