Παράκαμψη προς το περιεχόμενο
EPUBCheck · XHTML περιεχόμενο εγγράφων

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 που εξάγεται από ένα σύστημα δημοσίευσης που χρησιμοποιούσε αρχεία οντοτήτων για κοινό κείμενο όπως ο τίτλος του βιβλίου.

Πώς να το διορθώσω

  1. Ανοίξτε το αρχείο EPUBCheck που ονομάζεται (το μήνυμα δίνει το μονοπάτι, τη γραμμή και τη στήλη) σε έναν επεξεργαστή κειμένου ή EPUB όπως το Sigil, ή αποσυμπιέστε το EPUB και ανοίξτε το εκεί.
  2. Αφαιρέστε τις δηλώσεις οντοτήτων από το DOCTYPE; στα XHTML κεφάλαια το DOCTYPE θα πρέπει να είναι απλώς <!DOCTYPE html>.
  3. Αντικαταστήστε κάθε χρήση της οντότητας με το πραγματικό κείμενο, ή με μια αριθμητική αναφορά χαρακτήρα όπως &#160; όταν αναφερόταν σε έναν μόνο χαρακτήρα.
  4. Επανακατασκευάστε το EPUB και εκτελέστε ξανά το EPUBCheck για να επιβεβαιώσετε ότι το μήνυμα έχει εξαφανιστεί.

Όταν δεν είναι αυτό

Αν μια οντότητα όπως &nbsp; χρησιμοποιείται χωρίς να δηλωθεί καθόλου, αυτό είναι HTM-011, όχι HTM-003.

Όροι που χρησιμοποιούνται εδώ

Άλλα μηνύματα 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.

Πηγές

Κείμενο μηνύματος και σοβαρότητα από EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Εξήγηση από EpubCC.

FAQ

Τι σημαίνει EPUBCheck HTM-003;

EPUBCheck HTM-003 είναι ένα μήνυμα σφάλματος: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Ένα EPUB 3 έγγραφο δηλώνει μια εξωτερική οντότητα, κάτι που EPUB δεν επιτρέπει. Οι εξωτερικές οντότητες αντλούν κείμενο από άλλο αρχείο μέσω του DOCTYPE, και οι εφαρμογές ανάγνωσης δεν τις επιλύουν, οπότε το κείμενο θα λείπει.

Είναι HTM-003 σφάλμα;

HTM-003 αναφέρεται ως σφάλμα από προεπιλογή. Το EPUB παραβιάζει έναν κανόνα της προδιαγραφής και είναι άκυρο. Οι Καταστήματα και Αποστολή στο Kindle μπορεί να το απορρίψουν, και το EPUBCheck εξέρχεται με κατάσταση 1.

PDF σε EPUB εργαλεία

Κάθε εργαλείο χρησιμοποιεί την ίδια μηχανή. Έως 3 βιβλία την ημέρα είναι δωρεάν.

Δες όλα τα εργαλεία