EpubCCEPUBCheck HTM-003: ekstern enhed erklæret
Opdateret:
EPUBCheck HTM-003 er en fejlmeddelelse: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Et EPUB 3 dokument erklærer en ekstern enhed, som EPUB ikke tillader. Eksterne enheder trækker tekst fra en anden fil gennem DOCTYPE, og læseapps løser dem ikke, så teksten vil mangle.
Den officielle meddelelse
External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.
- Standard alvorlighed
- Fejl. EPUB bryder en regel i specifikationen og er ugyldig. Lagring og Send til Kindle kan afvise det, og EPUBCheck afsluttes med status 1.
- EPUBCheck version
- 5.4.0
%1$s, %2$s… bliver udfyldt med filen, værdien eller elementet EPUBCheck fundet.
Typiske årsager
- En DOCTYPE med et internt underafsnit (den del i firkantede parenteser), der erklærer enheder indlæst fra en ekstern fil.
- XML eksporteret fra et udgivelsessystem, der brugte enhedsfiler til delt tekst som bogtitel.
Sådan retter du det
- Åbn filen EPUBCheck navne (beskeden giver stien, linjen og kolonnen) i en tekst- eller EPUB editor som Sigil, eller udpak EPUB og åbn den der.
- Fjern enhedserklæringerne fra DOCTYPE; i XHTML kapitler skal DOCTYPE kun være
<!DOCTYPE html>. - Erstat hver brug af entiteten med den rigtige tekst eller med en numerisk tegnreference såsom
 , når den stod for et enkelt tegn. - Gendan EPUB og kør EPUBCheck igen for at bekræfte, at beskeden er væk.
Hvornår det ikke er dette
Hvis en enhed som bruges uden at blive erklæret overhovedet, er det HTM-011, ikke HTM-003.
Termer der bruges her
Andre HTM beskeder
HTM-004Irregular DOCTYPE: found "…", expected "…".HTM-001Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….HTM-007Empty or whitespace-only value of attribute ssml:ph.HTM-009The DOCTYPE provided is obsolete or irregular and can be removed.HTM-010Namespace "…" is unusual for the prefix "epub".HTM-011Entity is undeclared.
Kilder
Beskedtekst og sværhedsgrad fra EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Forklaring af EpubCC.