EpubCCEPUBCheck RSC-005: errore di schema in un file
Aggiornato:
EPUBCheck RSC-005 è un messaggio di errore: “Error while parsing file: ….” Un file non segue lo schema che EPUB richiede per esso. Un elemento, attributo o valore non è consentito dove si trova, oppure manca qualcosa di necessario; il testo dopo "Error while parsing file:" indica quale. È l'errore EPUBCheck più comune, e un errore strutturale può causare diversi messaggi.
Il messaggio ufficiale
Error while parsing file: %1$s
- Gravità predefinita
- Errore. Il EPUB viola una regola della specifica ed è non valido. I negozi e Invia a Kindle potrebbero rifiutarlo, e EPUBCheck esce con stato 1.
- versione EPUBCheck
- 5.4.0
%1$s, %2$s… sono completati con il file, valore o elemento EPUBCheck trovato.
Cause tipiche
- "element X not allowed here" o "attribute X not allowed here": elementi annidati dove lo schema li vieta (un div all'interno di un p), o attributi che HTML o EPUB non definiscono, spesso copiati da pagine web o da elaboratori di testi.
- "Duplicate ID": lo stesso valore di id usato due volte in un documento, spesso da note a piè di pagina o intestazioni copiate.
- Metadati richiesti mancanti, come la data dcterms:modified di un documento di pacchetto EPUB 3, o un elemento richiesto mancante come il titolo nell'intestazione XHTML.
- "value of attribute X is invalid": un valore del tipo sbagliato, come una data nel formato sbagliato o un id che inizia con una cifra.
Come correggerlo
- Leggi il testo dopo i due punti: EPUBCheck riporta il file, la riga e la colonna, e la descrizione del problema da parte del parser.
- Correggi l'elemento o l'attributo che nomina: sposta o rimuovi l'elemento, elimina l'attributo sconosciuto o rendi unico l'id duplicato e aggiorna i link che vi puntavano.
- Nei documenti del pacchetto, aggiungi i metadati mancanti, ad esempio
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(esattamente uno, in quel formato). - Correggi prima gli errori iniziali e valida di nuovo: un errore strutturale può causare diversi altri errori successivi.
Quando non è questo
Se il file non è nemmeno XML ben formato (un & non sfuggito o un tag non chiuso), EPUBCheck riporta il fatale RSC-016 invece.
Termini usati qui
Altri messaggi di RSC
RSC-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required META-INF/container.xml resource could not be found.
Fonti
Testo e gravità del messaggio da EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Spiegazione di EpubCC.