EPUBCheck · Documente de conținut XHTML

EPUBCheck HTM-003: entitate externă declarată

Actualizat: 4 Noiembrie 2026

EPUBCheck HTM-003 este un mesaj de eroare: „External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Un document EPUB 3 declară o entitate externă, ceea ce EPUB nu permite. Entitățile externe extrag text dintr-un alt fișier prin DOCTYPE, iar aplicațiile de citire nu le rezolvă, așa că textul ar lipsi.

Mesajul oficial

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

Severitate implicită: Eroare. EPUB încalcă o regulă a specificației și este invalid. Magazinele și Trimite către Kindle pot să o respingă, iar EPUBCheck iese cu statut 1.
versiunea EPUBCheck: 5.4.0

%1$s, %2$s… sunt completate cu fișierul, valoarea sau elementul EPUBCheck găsit.

Cauze tipice

Un DOCTYPE cu un subset intern (partea în paranteze pătrate) care declară entități încărcate dintr-un fișier extern.
XML exportat dintr-un sistem de publicare care a folosit fișiere de entitate pentru textul comun, cum ar fi titlul cărții.

Cum să o repari

Deschide fișierul EPUBCheck numit (mesajul dă calea, linia și coloana) într-un editor de text sau EPUB precum Sigil, sau dezarhivează EPUB și deschide-l acolo.
Eliminați declarațiile entităților din DOCTYPE; în capitolele XHTML, DOCTYPE ar trebui să fie doar <!DOCTYPE html>.
Înlocuiește fiecare utilizare a entității cu textul real, sau cu o referință numerică a caracterului, cum ar fi   când a reprezentat un singur caracter.
Reconstruiește EPUB și rulează EPUBCheck din nou pentru a confirma că mesajul a dispărut.

Când nu este acest lucru

Dacă o entitate precum   este folosită fără a fi declarată deloc, aceasta este HTM-011, nu HTM-003.

Termeni folosiți aici

Ce este XHTML în EPUB?

Alte mesaje HTM

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.

Surse

EPUB 3.3, §3.9 XML conformance · citește 4 Noiembrie 2026

Textul mesajului și severitatea din EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicație de EpubCC.

FAQ

Ce înseamnă EPUBCheck HTM-003?

Este HTM-003 o eroare?

HTM-003 este raportat ca eroare în mod implicit. EPUB încalcă o regulă a specificației și este invalid. Magazinele și Trimite la Kindle pot să o respingă, iar EPUBCheck iese cu starea 1.