EPUBCheck · XHTML içerik belgeleri

EPUBCheck HTM-003: dış varlık bildirildi

Güncellendi: 04 Kasım 2026

EPUBCheck HTM-003 bir hata mesajıdır: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Bir EPUB 3 belgesi bir dış varlık bildiriyor, bu da EPUB tarafından izin verilmez. Dış varlıklar, DOCTYPE üzerinden başka bir dosyadan metin çeker ve okuma uygulamaları bunları çözmez, bu nedenle metin kaybolur.

Resmi mesaj

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

Varsayılan ciddiyet: Hata. EPUB, spesifikasyonun bir kuralını ihlal ediyor ve geçersizdir. Depolar ve Kindle'ye gönder, onu reddedebilir ve EPUBCheck ile durum 1 ile çıkış yapar.
EPUBCheck sürümü: 5.4.0

%1$s, %2$s… dosyadan, değer veya öğeden bulunan EPUBCheck ile doldurulmuştur.

Tipik nedenler

Dış bir dosyadan yüklenen varlıklar bildiren, kare parantezler içindeki iç alt küme ile bir DOCTYPE.
Paylaşılan metinler için varlık dosyaları kullanan bir yayınlama sisteminden dışa aktarılan XML.

Nasıl düzeltilir

EPUBCheck'yi adlandıran dosyayı bir metin veya EPUB editöründe açın (mesaj yol, satır ve sütun verir) veya EPUB'yi çıkarın ve orada açın.
DOCTYPE'ten varlık bildirimlerini kaldırın; XHTML bölümlerinde DOCTYPE sadece <!DOCTYPE html> olmalıdır.
Her varlık kullanımını gerçek metinle değiştirin veya tek bir karakter için duruyorsa   gibi bir sayısal karakter referansı ile değiştirin.
EPUB'yı yeniden inşa edin ve mesajın kaybolduğunu onaylamak için EPUBCheck'yi tekrar çalıştırın.

Ne zaman bu değil

Eğer   gibi bir varlık hiç bildirilmeden kullanılmışsa, bu HTM-011'dır, HTM-003 değildir.

Burada kullanılan terimler

EPUB içindeki XHTML nedir?

Diğer HTM mesajları

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.

Kaynaklar

EPUB 3.3, §3.9 XML conformance · okumak 04 Kasım 2026

Mesaj metni ve ciddiyeti EPUBCheck 5.4.0 (W3C, BSD-3-Clause) tarafından. Açıklama EpubCC tarafından.

FAQ

EPUBCheck HTM-003 ne anlama geliyor?

HTM-003 bir hata mı?

HTM-003 varsayılan olarak hata olarak rapor edilir. EPUB, spesifikasyonun bir kuralını ihlal eder ve geçersizdir. Depolar ve Kindle'ye gönder bunu reddedebilir ve EPUBCheck durum 1 ile çıkabilir.