EPUBCheck · XHTML innholds dokumenter

EPUBCheck HTM-003: ekstern enhet erklært

Oppdatert: 4. november 2026

EPUBCheck HTM-003 er en feilmelding: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Et EPUB 3 dokument erklærer en ekstern enhet, som EPUB ikke tillater. Eksterne enheter henter tekst fra en annen fil gjennom DOCTYPE, og leseapper løser dem ikke, så teksten vil være manglende.

Den offisielle meldingen

External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.

Standard alvorlighetsgrad: Feil. EPUB bryter en regel i spesifikasjonen og er ugyldig. Butikker og Send til Kindle kan avvise det, og EPUBCheck avslutter med status 1.
EPUBCheck versjon: 5.4.0

%1$s, %2$s… er fylt ut med filen, verdien eller elementet EPUBCheck funnet.

Typiske årsaker

En DOCTYPE med et internt subset (delen i firkantede parenteser) som erklærer enheter lastet fra en ekstern fil.
XML eksportert fra et publiseringssystem som brukte enhetsfiler for delt tekst som boktittelen.

Hvordan fikse det

Åpne filen EPUBCheck navnene (meldingen gir banen, linje og kolonne) i en tekst- eller EPUB editor som Sigil, eller pakk ut EPUB og åpne det der.
Fjern enhetserklæringene fra DOCTYPE; i XHTML kapitler skal DOCTYPE bare være <!DOCTYPE html>.
Erstatt hver bruk av enheten med den virkelige teksten, eller med en numerisk tegnreferanse som   når det sto for et enkelt tegn.
Bygg EPUB på nytt og kjør EPUBCheck igjen for å bekrefte at meldingen er borte.

Når det ikke er dette

Hvis en enhet som   brukes uten å være erklært i det hele tatt, er det HTM-011, ikke HTM-003.

Begreper brukt her

Hva er XHTML i EPUB?

Andre HTM meldinger

HTM-004 Irregular DOCTYPE: found "…", expected "…".
HTM-001 Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Kilder

EPUB 3.3, §3.9 XML conformance · les 4. november 2026

Meldingstekst og alvorlighetsgrad fra EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Forklaring av EpubCC.

FAQ

Hva betyr EPUBCheck HTM-003?

Er HTM-003 en feil?

HTM-003 rapporteres som feil som standard. EPUB bryter en regel i spesifikasjonen og er ugyldig. Lagringer og Send til Kindle kan avvise det, og EPUBCheck avslutter med status 1.