EPUBCheck HTM-003: δηλωμένη εξωτερική οντότητα
Ενημερωμένο:
EPUBCheck HTM-003 είναι ένα μήνυμα σφάλματος: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Ένα EPUB 3 έγγραφο δηλώνει μια εξωτερική οντότητα, κάτι που EPUB δεν επιτρέπει. Οι εξωτερικές οντότητες αντλούν κείμενο από άλλο αρχείο μέσω του DOCTYPE, και οι εφαρμογές ανάγνωσης δεν τις επιλύουν, οπότε το κείμενο θα λείπει.
Το επίσημο μήνυμα
External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.
- Προεπιλεγμένη σοβαρότητα
- Σφάλμα. Το EPUB παραβιάζει έναν κανόνα της προδιαγραφής και είναι άκυρο. Τα καταστήματα και η αποστολή προς Kindle μπορεί να το απορρίψουν, και EPUBCheck εξέρχεται με κατάσταση 1.
- Έκδοση EPUBCheck
- 5.4.0
%1$s, %2$s… συμπληρώνονται με το αρχείο, την τιμή ή το στοιχείο EPUBCheck που βρέθηκε.
Τυπικές αιτίες
- Ένας DOCTYPE με εσωτερικό υποσύνολο (το μέρος σε τετράγωνα αγκύλες) που δηλώνει οντότητες που φορτώνονται από εξωτερικό αρχείο.
- XML που εξάγεται από ένα σύστημα δημοσίευσης που χρησιμοποιούσε αρχεία οντοτήτων για κοινό κείμενο όπως ο τίτλος του βιβλίου.
Πώς να το διορθώσω
- Ανοίξτε το αρχείο EPUBCheck που ονομάζεται (το μήνυμα δίνει το μονοπάτι, τη γραμμή και τη στήλη) σε έναν επεξεργαστή κειμένου ή EPUB όπως το Sigil, ή αποσυμπιέστε το EPUB και ανοίξτε το εκεί.
- Αφαιρέστε τις δηλώσεις οντοτήτων από το DOCTYPE; στα XHTML κεφάλαια το DOCTYPE θα πρέπει να είναι απλώς
<!DOCTYPE html>. - Αντικαταστήστε κάθε χρήση της οντότητας με το πραγματικό κείμενο, ή με μια αριθμητική αναφορά χαρακτήρα όπως
 όταν αναφερόταν σε έναν μόνο χαρακτήρα. - Επανακατασκευάστε το EPUB και εκτελέστε ξανά το EPUBCheck για να επιβεβαιώσετε ότι το μήνυμα έχει εξαφανιστεί.
Όταν δεν είναι αυτό
Αν μια οντότητα όπως χρησιμοποιείται χωρίς να δηλωθεί καθόλου, αυτό είναι HTM-011, όχι HTM-003.
Όροι που χρησιμοποιούνται εδώ
Άλλα μηνύματα HTM
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.
Πηγές
- EPUB 3.3, §3.9 XML conformance · διαβαστεί
Κείμενο μηνύματος και σοβαρότητα από EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Εξήγηση από EpubCC.