EPUBCheck · Έγγραφο πακέτου (OPF)

EPUBCheck OPF-004: αποτυχημένη ιδιότητα prefix

Ενημερωμένο: 04/11/2026

EPUBCheck OPF-004 είναι μήνυμα προειδοποίησης: “Invalid prefix declaration: leading or trailing whitespace is not allowed.” Η ιδιότητα prefix στο στοιχείο του πακέτου δεν έχει γραφτεί στη σύνταξη που απαιτεί EPUB. Αυτή η ιδιότητα αντιστοιχεί σε σύντομα προθέματα (όπως ibooks) σε URI λεξιλογίου, και η EPUBCheck αναφέρει κάθε τύπο συντακτικού λάθους με τη δική της παραλλαγή του OPF-004.

Το επίσημο μήνυμα

Invalid prefix declaration: leading or trailing whitespace is not allowed.

Προεπιλεγμένη σοβαρότητα: Προειδοποίηση. Το EPUB είναι ακόμα έγκυρο, αλλά κάτι είναι πιθανό να προκαλέσει προβλήματα σε ορισμένες εφαρμογές ανάγνωσης. EPUBCheck εξέρχεται με 0, εκτός αν περάσετε --failonwarnings.
Έκδοση EPUBCheck: 5.4.0

Τυπικές αιτίες

OPF-004: κενά ή αλλαγές γραμμής στην αρχή ή το τέλος της τιμής του χαρακτηριστικού; OPF-004a: ένα κενό πρόθεμα, μια άνω παύλα χωρίς όνομα μπροστά της.
OPF-004b: ένα όνομα προθέματος που δεν είναι έγκυρο όνομα XML (NCName), όπως για παράδειγμα ένα που ξεκινά με ψηφίο ή περιέχει κάθετο; OPF-004c: ένα κενό μεταξύ του ονόματος και της άνω παύλας του, όπως στο "ibooks : http://…".
OPF-004d: καμία κενό διάστημα μεταξύ της άνω παύλας και της URI, όπως στο "ibooks:http://…"; OPF-004e: μια ταμπ, αλλαγή γραμμής ή άλλο παράνομο κενό διάστημα μεταξύ του προθέματος και της URI.
OPF-004f: αντιστοιχίες που χωρίζονται από κάτι άλλο από απλό κενό διάστημα ή είναι κολλητές.

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

Βρείτε την ιδιότητα prefix στο στοιχείο package του αρχείου .opf.
Γράψτε κάθε αντιστοίχιση ως το όνομα προθέματος, δύο κολλώνες, μία κενή και το URI λεξιλογίου, και χωρίστε τις αντιστοιχίσεις με whitespace, για παράδειγμα prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
Αφαιρέστε τα κενά στην αρχή και το τέλος της τιμής, δώστε σε κάθε αντιστοίχηση ένα όνομα που αρχίζει με γράμμα (μόνο γράμματα, ψηφία, παύλες και κάτω παύλες), και τοποθετήστε την άνω τελεία αμέσως μετά το όνομα.
Οι δεσμευμένοι πρόθεμα όπως το dcterms, το rendition και το schema δεν χρειάζονται δήλωση, οπότε μπορείτε συχνά να διαγράψετε εντελώς την παράμετρο αν χαρτογραφεί μόνο αυτές.

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

Αν η σύνταξη είναι σωστή αλλά ένα πρόθεμα δεν έχει URI ή έχει μη έγκυρο, αυτό είναι OPF-005 ή OPF-006.

Αναφέρθηκε επίσης ως

OPF-004a (σφάλμα): Invalid prefix declaration: found empty prefix.
OPF-004b (σφάλμα): Invalid prefix "%1$s": must be a valid non-colonized name (aka "NCName").
OPF-004c (σφάλμα): Invalid prefix declaration: prefix "%1$s" must be immediately followed by a colon character (":").
OPF-004d (σφάλμα): Invalid prefix declaration: prefix "%1$s" must be separated by its URI with a space.
OPF-004e (προειδοποίηση): Invalid prefix declaration: found illegal whitespace between prefix and URI.
OPF-004f (προειδοποίηση): Invalid prefix declaration: found illegal whitespace between prefix mappings.

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

Άλλα μηνύματα OPF

OPF-003 Item "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-002 The OPF file "…" was not found in the EPUB.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-007 Re-declaration of reserved prefix "…".

Πηγές

EPUB 3.3, §D.1.4 The prefix attribute · διαβαστεί 04/11/2026

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

FAQ

Τι σημαίνει EPUBCheck OPF-004;

Είναι OPF-004 σφάλμα;

OPF-004 αναφέρεται ως προειδοποίηση από προεπιλογή. Το EPUB είναι ακόμα έγκυρο, αλλά κάτι πιθανόν να προκαλέσει προβλήματα σε ορισμένες εφαρμογές ανάγνωσης. Το EPUBCheck τερματίζει με 0 εκτός αν δώσετε --failonwarnings.