Quale verifica preliminare di un EPUB individua quale errore?
Chi prepara un e-book ha bisogno di qualcosa di più di un risultato verde rassicurante. La domanda pratica è quale verifica fermerà un certo errore, dove indirizzare la correzione e quali decisioni richiedono ancora che qualcuno controlli il libro. Abbiamo messo alla prova questa domanda con diciannove piccoli archivi EPUB originali: un archivio di riferimento invariato e diciotto modifiche scelte di proposito. EPUBCheck 5.4.0 e DAISY Ace 1.4.6 hanno elaborato tutti gli archivi fino in fondo.
Gli strumenti hanno dato informazioni diverse. Cinque archivi modificati hanno prodotto segnalazioni solo in Ace, uno solo in EPUBCheck e quattro in entrambi. Otto non hanno prodotto alcuna segnalazione in nessuno dei due strumenti. Sono conteggi di casi sperimentali scelti: non sono tassi di errore dei libri, né una stima della sensibilità degli strumenti, né la prova che otto modifiche sarebbero innocue per chi legge. Il risultato utile è una mappa delle correzioni: file mancanti, attributi assenti, collegamenti contraddittori, descrizioni deboli e semantica mancante non arrivano tutti allo stesso punto di controllo.
Che cosa abbiamo costruito e fissato
L’opera di base è una miniatura originale in due capitoli, The Lantern at the Quay. Mara arriva prima dell’alba con una lanterna blu; Ivo arriva più tardi con una cassa vuota; escono dal cancello occidentale. Il pacchetto contiene una mappa originale, una didascalia descrittiva, una tabella di tre righe e due colonne compresa la riga di intestazione, una breve equazione in MathML, un indice e un foglio di stile locale. Nessun libro commerciale, manoscritto inedito o pubblicazione di prova di terzi ha fornito il testo o le immagini.
Prima di eseguire gli archivi modificati abbiamo fissato l’elenco dei casi, le ipotesi, la regola di ammissione e gli esiti osservabili dalle macchine. Tutti gli archivi usano lo stesso identificativo di pubblicazione, urn:uuid:08c94180-0adb-5f8b-b3ae-d1a455a9bbca. I nomi dei file distinguono le versioni sperimentali, perciò l’identificativo non è una differenza in più tra gli archivi. L’elenco scaricabile degli archivi di prova riporta le impronte degli archivi e i componenti modificati, così un altro analista può verificare quale file del pacchetto differisce dall’archivio di riferimento.
La maggior parte delle modifiche cambia un solo attributo, elemento, riferimento o risorsa. Due sono sostituzioni semantiche con le modifiche di accompagnamento necessarie: togliere le intestazioni della tabella toglie anche gli attributi che sarebbero non validi sulle celle ordinarie; sostituire il MathML con un’immagine toglie anche la dichiarazione nel manifest (l’elenco dei file del pacchetto) secondo cui il capitolo contiene MathML. Sono operazioni dichiarate, non l’affermazione che ogni confronto differisca di un solo byte. Nel piano, l’etichetta “solo didascalia” è un alias del caso senza testo alternativo, perché la didascalia originale resta in entrambi. È esclusa dal denominatore dei diciannove archivi.
L’archivio di riferimento doveva produrre zero segnalazioni in entrambi gli strumenti prima che si potessero interpretare i confronti con le versioni modificate. Sono stati conservati due tentativi di preparazione fatti solo sull’archivio di riferimento: in uno è stato tolto un attributo di navigazione ridondante, che EPUBCheck rifiutava; nell’altro è stata aggiunta la lingua del pacchetto OPF richiesta da Ace. Nessuno dei due ha cambiato i casi selezionati dopo averne visto gli esiti.
Un file mancante si individua con la verifica del pacchetto
Eliminare map.png, lasciando la sua voce nel manifest e il riferimento all’immagine, ha prodotto un errore RSC-001 di EPUBCheck. Ace ha completato un rapporto per lo stesso archivio senza segnalare violazioni. Il risultato è utile per una lista di controllo di produzione: un rapporto di accessibilità completato non ha sostituito una verifica dell’integrità delle risorse, nemmeno per una pubblicazione molto piccola.
La prima correzione adeguata è concreta. Si ripristina il file, si corregge il riferimento oppure si tolgono le voci inutilizzate dal manifest e dal contenuto, secondo il caso; poi si eseguono di nuovo entrambi gli strumenti sulla nuova esportazione. Chi cura la grafica non dovrebbe cominciare riscrivendo la descrizione dell’immagine, quando il difetto immediato è che la risorsa indicata manca. Allo stesso modo, un sistema di produzione non dovrebbe considerare un rapporto di Ace scritto correttamente come prova che tutte le risorse richieste esistano.
Questo esperimento non dimostra che Ace trascuri sempre le risorse mancanti. Mostra che cosa hanno segnalato queste versioni fissate per questo preciso archivio con il PNG eliminato. Altri contenuti, altre revisioni del motore e altre combinazioni di difetti possono dare risultati diversi. Tenere a disposizione l’archivio e le segnalazioni rende questa affermazione limitata utile e verificabile, senza trasformarla in un’affermazione generale sullo strumento.
La sintassi della lingua e la verità della lingua richiedono attenzioni diverse
Togliere entrambi gli attributi di lingua dal primo capitolo ha prodotto una segnalazione html-has-lang di Ace e nessuna segnalazione di EPUBCheck. Cambiare quegli attributi nel valore non valido en_US ha prodotto segnalazioni in entrambi: RSC-005 di EPUBCheck e html-lang-valid di Ace. Questi casi indirizzano chi scrive verso la dichiarazione del documento, non verso il testo.
Il terzo caso sulla lingua era diverso. Abbiamo cambiato la dichiarazione del primo capitolo dall’inglese al codice francese fr, sintatticamente valido, lasciando invariato il testo inglese. Nessuno dei due strumenti ha prodotto segnalazioni. Un codice può superare un controllo di formato senza descrivere con esattezza le parole a cui è associato. È una verifica di esportazione particolarmente rilevante per chi cura più edizioni linguistiche a partire da modelli collegati.
La verifica pratica consiste nell’aprire file rappresentativi di ogni edizione linguistica finale e confrontare le dichiarazioni con il testo effettivo, compresi i passaggi in un’altra lingua. L’esperimento non ha misurato la pronuncia, il comportamento dei lettori di schermo o la comprensione. Mostra che controllare se una dichiarazione esiste ed è ben formata risponde a una domanda diversa dal controllare se la sua lingua è vera, in questo esempio controllato.
I controlli sull’indice individuano le contraddizioni, ma non scelgono la scena voluta
Cambiare il primo collegamento dell’indice verso un frammento inesistente ha prodotto RSC-012 di EPUBCheck e epub-toc-order di Ace. Invertire nello spine, cioè nell’ordine di lettura dei file, le due voci dei capitoli lasciando invariato l’indice ha prodotto NAV-011 di EPUBCheck, un avviso, e epub-toc-order di Ace. Sono segnalazioni utili sulla coerenza: indicano una relazione che merita un controllo prima della distribuzione.
Il caso dello spine, con solo un avviso, spiega anche perché un flusso di lavoro debba conservare la gravità delle segnalazioni. Il comando di EPUBCheck ha restituito zero per quel caso, mentre il suo rapporto conteneva NAV-011. Contare solo i codici di uscita diversi da zero farebbe perdere un avviso dichiarato. Un editore può decidere come esaminare gli avvisi, ma deve leggerli o conservarli prima di decidere. Un avviso non è un errore e non è un rapporto vuoto.
Abbiamo anche cambiato la voce Arrival dell’indice verso la destinazione esistente Departure, mantenendo l’etichetta visibile Arrival. Questo caso non ha prodotto segnalazioni in nessuno dei due strumenti. La destinazione esisteva, ma era quella sbagliata rispetto all’intenzione dichiarata da chi cura il testo. È un motivo diretto per cliccare le voci finali dell’indice e verificare dove portano, invece di controllare soltanto che un collegamento funzioni.
Il risultato dello spine invertito non va ingigantito fino a dire che gli strumenti capiscano la cronologia del racconto. Questo test ha lasciato indice e spine in contraddizione, ed entrambi gli strumenti hanno notato quella contraddizione. Non abbiamo provato una riscrittura pienamente coerente di entrambe le strutture, che metta la storia nell’ordine sbagliato. Una persona deve comunque sapere se l’arrivo preceda la partenza; un confronto strutturale non può stabilire da solo la trama voluta.
Una didascalia non ha sostituito un testo alternativo mancante
La mappa dell’archivio di riferimento ha un valore alt significativo e una didascalia vicina. Togliere soltanto l’alt, lasciando la didascalia, ha prodotto image-alt di Ace e nessuna segnalazione di EPUBCheck. L’esempio appaiato è utile perché chi scrive può vedere una frase descrittiva sotto un’illustrazione e credere che l’immagine sia già a posto. In questo archivio di prova, la didascalia visibile non ha fatto accettare ad Ace l’attributo assente.
Altre due modifiche sono state silenziose. Sostituire il testo alternativo significativo con map.png non ha prodotto segnalazioni; cambiarlo in un valore vuoto nemmeno. L’immagine e il suo ruolo informativo non erano cambiati. Questi esiti separano tre domande di revisione: se un testo alternativo c’è, se le sue parole trasmettono lo scopo dell’immagine e se la scelta di segnare un’immagine come decorativa è appropriata.
Un testo alternativo vuoto può essere una scelta voluta per un’immagine decorativa, quindi il risultato non va descritto come la prova che un alt vuoto sia sempre sbagliato. Qui la mappa originale era informativa di proposito e la modifica ne ha tolto la descrizione senza cambiarne il ruolo. Chi scrive o cura il testo deve fare questa valutazione di contenuto. Né un nome di file né una stringa vuota dovrebbero diventare un sostituto automatico della revisione di ciò che un’immagine apporta.
Ace ha inserito anche il testo alternativo e la didascalia nell’inventario delle immagini del suo rapporto. Quell’inventario può aiutare una revisione deliberata del rapporto tra illustrazione, didascalia e testo alternativo. Il nostro esito misurato resta la segnalazione emessa, non se una particolare configurazione di lettura assistiva presenti l’immagine in modo soddisfacente. Servirebbe un altro test, con un lettore e un dispositivo dichiarati.
Avere un titolo non significa che appaia come titolo
Cambiare il sottotitolo h2 del primo capitolo in h4 ha prodotto heading-order di Ace e nessuna segnalazione di EPUBCheck. Chi indaga su questo risultato dovrebbe controllare la struttura del documento e il modello di esportazione che ha assegnato i livelli dei titoli. Correggere il modello può evitare che lo stesso livello saltato ricompaia nelle esportazioni successive.
Sostituire lo stesso h2 con un paragrafo con stile, mantenendone le parole, non ha prodotto segnalazioni in nessuno dei due strumenti. Il paragrafo aveva l’aspetto di un sottotitolo grazie alla classe e allo stile, ma non contribuiva più alla struttura del documento con quel titolo. Non abbiamo fatto un test di equivalenza visiva né con un sistema di lettura: la differenza controllata che conta era il ruolo dell’elemento nel documento.
L’azione per chi scrive è confrontare l’elenco delle sezioni previste con la struttura esportata. Un libro può avere un insieme ordinato dei titoli rimasti e tuttavia omettere una sezione che avrebbe dovuto essere un titolo. L’esperimento sostiene di controllare sia i livelli saltati sia le voci previste che mancano. Non stima con quale frequenza i programmi di videoscrittura o i convertitori per e-book introducano l’uno o l’altro problema.
Le tabelle mostrano perché le piccole prove richiedano limiti precisi
Cambiare in assente il riferimento headers di una cella di dati ha prodotto RSC-005 di EPUBCheck e td-headers-attr di Ace. Questo confronto ha fornito una relazione rotta specifica, che entrambi gli strumenti hanno saputo individuare. La correzione dovrebbe riguardare l’associazione reale tra celle di dati e celle di intestazione, seguita da una nuova esportazione e da una nuova verifica.
Togliere la semantica di intestazione a tutte e quattro le celle di intestazione, trasformandole in celle di dati ordinarie e togliendo gli attributi collegati alle intestazioni, non ha prodotto segnalazioni in nessuno dei due strumenti. L’archivio di prova restava una piccola tabella di tre righe e due colonne. Le sue etichette originali di righe e colonne esistevano ancora come testo, ma avevano perso il ruolo di intestazione.
Questo risultato è volutamente limitato. Non dimostra che Ace non possa individuare problemi di intestazioni in altre tabelle, né che ogni tabella richieda lo stesso markup. Tabelle usate per l’impaginazione, tabelle di dati più grandi e relazioni più complesse richiedono ciascuna una propria interpretazione. Chi ha tabelle dovrebbe controllare il significato voluto di ogni riga e colonna, invece di dedurre una semantica completa dall’esito senza segnalazioni di questa piccola tabella.
La combinazione è l’osservazione utile: un riferimento di intestazione senza destinazione è stato individuato, mentre l’assenza completa di quelle relazioni dichiarate, in questa particolare piccola tabella, è rimasta silenziosa. Per una lista di controllo, rivedere solo i riferimenti rotti segnalati lascia senza risposta un’altra domanda: se le relazioni che dovrebbero esserci siano state create fin dall’inizio.
Le equazioni richiedono un controllo di corrispondenza
L’archivio di riferimento contiene l’equazione due più tre uguale cinque in MathML semantico, con un’etichetta parlata corrispondente. Cambiare soltanto quell’etichetta in modo che dicesse sei invece di cinque non ha prodotto segnalazioni in nessuno dei due strumenti. L’equazione e l’etichetta erano entrambe presenti, ma i loro significati non corrispondevano più.
Una sostituzione di rappresentazione dichiarata a parte ha sostituito il MathML con un’immagine originale dotata del debole testo alternativo equation.png. Togliere la proprietà MathML del manifest, ormai inutilizzata, faceva parte della sostituzione. Anche qui nessuno dei due strumenti ha prodotto una segnalazione. Un testo alternativo non vuoto non dimostrava che l’informazione matematica fosse stata conservata per chi usa il testo alternativo.
Questi due casi dicono a chi scrive testi matematici o tecnici di confrontare direttamente l’espressione, la sua etichetta e il testo alternativo di un’eventuale immagine. Non dimostrano il successo o il fallimento di un lettore particolare con MathML e non classificano le equazioni in forma di immagine rispetto al MathML nei diversi sistemi di lettura. Il risultato misurato è più stretto: queste rappresentazioni e descrizioni modificate non hanno attivato le segnalazioni degli strumenti fissati, negli archivi di prova scelti.
Il basso contrasto e un collegamento vuoto sono arrivati ad Ace
Cambiare il colore del testo del corpo da #111111 a #eeeeee su sfondo bianco ha prodotto segnalazioni color-contrast di Ace, mentre EPUBCheck non ne ha riportata nessuna. Togliere le parole visibili dal collegamento finale di ritorno ha prodotto link-name di Ace e nessuna segnalazione di EPUBCheck. Sono altri esempi di problemi che hanno raggiunto la verifica orientata all’accessibilità dopo che la verifica sul formato della pubblicazione era rimasta silenziosa.
L’esportazione con basso contrasto ha generato diverse istanze di asserzione, perché il foglio di stile modificato riguardava più elementi visualizzati. Quelle istanze non sono libri indipendenti né interventi sperimentali indipendenti. La matrice conta quell’archivio una sola volta. Presentare il numero di istanze come numero di difetti di produzione distinti esagererebbe le prove e nasconderebbe l’unica modifica di colore all’origine.
Nessuno dei due casi stabilisce come ogni app di lettura applichi i temi dell’utente, le impostazioni dei caratteri o le regolazioni del contrasto. Registrano la risposta del motore allo stile predefinito del pacchetto e al contenuto del collegamento. Chi scrive dovrebbe mantenere queste distinzioni quando decide se correggere il foglio di stile sorgente, l’etichetta del collegamento o entrambi prima di produrre un altro file di distribuzione.
Un comando riuscito può contenere comunque delle segnalazioni
Ogni esecuzione predefinita di Ace nell’esperimento ha restituito il codice di uscita zero, comprese le nove varianti modificate con violazioni. Poi abbiamo rieseguito l’archivio esatto senza testo alternativo con l’opzione documentata --exiterror2. L’esecuzione rigorosa ha restituito due e ha mantenuto la segnalazione image-alt. Il file non era stato riparato tra le due esecuzioni; è cambiata soltanto la modalità con cui il comando segnala un errore.
È una distinzione pratica per il flusso di lavoro, non un difetto non documentato appena scoperto. La documentazione ufficiale della riga di comando di Ace spiega che i codici di uscita predefiniti segnalano la riuscita dell’esecuzione e non le violazioni della pubblicazione, e descrive l’opzione rigorosa. Il nostro confronto appaiato ne mostra la conseguenza in un caso riproducibile di e-book. Un passaggio automatico che legge solo il codice di ritorno predefinito può concludersi con successo mentre inoltra un libro con violazioni segnalate.
Un buon processo di rilascio conserva i rapporti, verifica che l’elaborazione sia terminata, distingue le violazioni dai fallimenti di esecuzione e usa una regola di arresto scelta di proposito. Anche gli avvisi di EPUBCheck richiedono un esame esplicito. Chi usa un’app grafica dovrebbe leggere il suo rapporto; chi automatizza una compilazione dovrebbe verificare che cosa segnala davvero il comando. In nessun caso un codice di ritorno zero dovrebbe diventare un’affermazione di accessibilità senza riserve.
Un ordine pratico di controlli e il limite di questo esperimento
I risultati misurati sostengono una breve sequenza. Prima si esegue EPUBCheck e si risolvono i file mancanti, le dichiarazioni non valide, i frammenti rotti e gli altri problemi di formato segnalati. Si esaminano i suoi avvisi. Poi si esegue Ace, si leggono le violazioni segnalate e si verifica che un’eventuale regola di arresto automatica usi la modalità di errore voluta. Dopo le correzioni, si rigenera l’archivio finale e si rieseguono entrambi gli strumenti, perché un’esportazione può reintrodurre un difetto.
Poi si rivede di proposito la corrispondenza del contenuto: dichiarazioni e lingua, etichette dell’indice e destinazioni, storia e ordine di lettura voluto, sezioni volute e struttura, immagini informative e testi alternativi, significato della tabella e relazioni di intestazione, equazioni e descrizioni. Sono raccomandazioni ricavate dalle lacune osservate, non esiti misurati di test con persone. Le verifiche con lettori di schermo, i test sui sistemi di lettura e la valutazione formale di conformità restano fuori da questo esperimento.
Gli strumenti erano fissati alle versioni ufficiali correnti verificate il 31 ottobre 2026. Il blocco delle dipendenze e il registro delle versioni del motore identificano l’ambiente effettivamente usato. Tutti gli elementi degli archivi erano incorporati in locale; una protezione a livello di applicazione bloccava le normali richieste HTTP e WebSocket esterne e disattivava le funzioni di rete in background. Durante l’esperimento non è stato registrato alcun tentativo di richiesta esterna. È stato un test locale protetto, non un isolamento di rete del sistema operativo verificato in modo indipendente.
I test di Ace di DAISY, i test di EPUBCheck del W3C e le linee guida pubblicate sull’accessibilità sono un lavoro precedente importante. Non abbiamo copiato le loro pubblicazioni né pretendiamo di aver inventato la distinzione tra valutazione automatica e valutazione umana. Il contributo originale è l’insieme di archivi appaiati, riproducibile apertamente, la matrice esatta delle segnalazioni e gli esempi su dove indirizzare le correzioni, per un piccolo flusso di lavoro di chi scrive. I casi scelti di proposito non certificano un libro, non stabiliscono la conformità alle WCAG, non garantiscono l’accettazione da parte di un distributore e non stimano l’accessibilità del mercato degli e-book.
Fonti e riproducibilità
Versioni ufficiali: EPUBCheck 5.4.0 e Ace 1.4.6. Comportamento operativo: riga di comando e configurazione di Ace. Limiti di valutazione: la guida DAISY su Ace e EPUB Accessibility 1.1. Test precedenti: i test di Ace e i test di EPUBCheck.
Con questo studio si possono scaricare il piano fissato e le correzioni, il pacchetto originale degli archivi di prova, l’elenco delle impronte dei componenti, la tabella degli esiti, le segnalazioni dettagliate, le versioni dei motori, il blocco delle dipendenze e gli script di riproduzione. La tabella dei risultati si può ricalcolare dai rapporti salvati, senza scaricare gli strumenti. Rieseguire l’esperimento richiede gli strumenti ufficiali dichiarati e il mantenimento delle loro note di licenza. Gli archivi di prova originali e l’analisi vanno attribuiti ad Alisson Bento, i programmi di verifica ai rispettivi manutentori.
Quale verifica ha prodotto una segnalazione?
Quale verifica ha prodotto una segnalazione? 18 modifiche scelte di proposito; archivio di riferimento originale omesso. EPUBCheck: 5; Ace: 9; nessuno dei due strumenti: 8.
Grafico completo e fonte
Scorri il grafico in orizzontale per esaminarlo. ↔
Grafico e valori
Scorri la tabella in orizzontale per vedere tutte le colonne.
| Caso originale controllato | Messaggi di EPUBCheck | Segnalazioni delle regole di Ace |
|---|---|---|
| Archivio di riferimento invariato | — | — |
| Lingua del documento assente | — | html-has-lang |
| Codice valido, lingua sbagliata | — | — |
| Codice di lingua non valido | RSC-005 | html-lang-valid |
| Frammento dell’indice mancante | RSC-012 | epub-toc-order |
| Destinazione dell’indice valida ma sbagliata | — | — |
| Spine invertito, indice invariato | NAV-011 (AVVISO) | epub-toc-order |
| Testo alternativo dell’immagine assente; didascalia mantenuta | — | image-alt |
| Testo alternativo dell’immagine = nome del file | — | — |
| Testo alternativo vuoto per un’immagine informativa | — | — |
| Livello di titolo saltato | — | heading-order |
| Titolo sostituito da un paragrafo | — | — |
| Ruoli di intestazione della tabella tolti | — | — |
| Riferimento headers della tabella non valido | RSC-005 | td-headers-attr |
| Contrasto predefinito basso | — | color-contrast |
| Etichetta del collegamento vuota | — | link-name |
| Risorsa PNG mancante | RSC-001 | — |
| MathML sostituito da un’immagine con testo alternativo debole | — | — |
| Etichetta matematica sbagliata | — | — |
Il trattino significa nessuna segnalazione. NAV-011 è soltanto un avviso. I conteggi riguardano archivi scelti, non tassi di libri pubblicati.
Punti di controllo diversi, segnalazioni diverse
Solo Ace: 5; entrambi gli strumenti: 4; solo EPUBCheck: 1; nessuno dei due strumenti: 8. 18 modifiche scelte di proposito; archivio di riferimento originale omesso
Grafico completo e fonte
Scorri il grafico in orizzontale per esaminarlo. ↔
Grafico e valori
Scorri la tabella in orizzontale per vedere tutte le colonne.
| Segnalato da | Archivi modificati |
|---|---|
| Solo Ace | 5 |
| Entrambi gli strumenti | 4 |
| Solo EPUBCheck | 1 |
| Nessuno dei due strumenti | 8 |
Il trattino significa nessuna segnalazione. NAV-011 è soltanto un avviso. I conteggi riguardano archivi scelti, non tassi di libri pubblicati.
Dati e download
Scorri la tabella in orizzontale per vedere tutte le colonne.
| Caso originale controllato | Messaggi di EPUBCheck | Segnalazioni delle regole di Ace |
|---|---|---|
| Archivio di riferimento invariato | — | — |
| Lingua del documento assente | — | html-has-lang |
| Codice valido, lingua sbagliata | — | — |
| Codice di lingua non valido | RSC-005 | html-lang-valid |
| Frammento dell’indice mancante | RSC-012 | epub-toc-order |
| Destinazione dell’indice valida ma sbagliata | — | — |
| Spine invertito, indice invariato | NAV-011 (AVVISO) | epub-toc-order |
| Testo alternativo dell’immagine assente; didascalia mantenuta | — | image-alt |
| Testo alternativo dell’immagine = nome del file | — | — |
| Testo alternativo vuoto per un’immagine informativa | — | — |
| Livello di titolo saltato | — | heading-order |
| Titolo sostituito da un paragrafo | — | — |
| Ruoli di intestazione della tabella tolti | — | — |
| Riferimento headers della tabella non valido | RSC-005 | td-headers-attr |
| Contrasto predefinito basso | — | color-contrast |
| Etichetta del collegamento vuota | — | link-name |
| Risorsa PNG mancante | RSC-001 | — |
| MathML sostituito da un’immagine con testo alternativo debole | — | — |
| Etichetta matematica sbagliata | — | — |
Il trattino significa nessuna segnalazione. NAV-011 è soltanto un avviso. I conteggi riguardano archivi scelti, non tassi di libri pubblicati.
Scorri la tabella in orizzontale per vedere tutte le colonne.
| Segnalato da | Archivi modificati |
|---|---|
| Solo Ace | 5 |
| Entrambi gli strumenti | 4 |
| Solo EPUBCheck | 1 |
| Nessuno dei due strumenti | 8 |
Il trattino significa nessuna segnalazione. NAV-011 è soltanto un avviso. I conteggi riguardano archivi scelti, non tassi di libri pubblicati.
Dati e metodo
Come abbiamo calcolato
- Prima di eseguire gli archivi modificati abbiamo fissato l’elenco dei casi, le ipotesi, la regola di ammissione e gli esiti osservabili dalle macchine. Tutti gli archivi usano lo stesso identificativo di pubblicazione, urn:uuid:08c94180-0adb-5f8b-b3ae-d1a455a9bbca. I nomi dei file distinguono le versioni sperimentali, perciò l’identificativo non è una differenza in più tra gli archivi. L’elenco scaricabile degli archivi di prova riporta le impronte degli archivi e i componenti modificati, così un altro analista può verificare quale file del pacchetto differisce dall’archivio di riferimento.
- La maggior parte delle modifiche cambia un solo attributo, elemento, riferimento o risorsa. Due sono sostituzioni semantiche con le modifiche di accompagnamento necessarie: togliere le intestazioni della tabella toglie anche gli attributi che sarebbero non validi sulle celle ordinarie; sostituire il MathML con un’immagine toglie anche la dichiarazione nel manifest (l’elenco dei file del pacchetto) secondo cui il capitolo contiene MathML. Sono operazioni dichiarate, non l’affermazione che ogni confronto differisca di un solo byte. Nel piano, l’etichetta “solo didascalia” è un alias del caso senza testo alternativo, perché la didascalia originale resta in entrambi. È esclusa dal denominatore dei diciannove archivi.
Cosa non possiamo dedurre dai dati
- Gli strumenti hanno dato informazioni diverse. Cinque archivi modificati hanno prodotto segnalazioni solo in Ace, uno solo in EPUBCheck e quattro in entrambi. Otto non hanno prodotto alcuna segnalazione in nessuno dei due strumenti. Sono conteggi di casi sperimentali scelti: non sono tassi di errore dei libri, né una stima della sensibilità degli strumenti, né la prova che otto modifiche sarebbero innocue per chi legge. Il risultato utile è una mappa delle correzioni: file mancanti, attributi assenti, collegamenti contraddittori, descrizioni deboli e semantica mancante non arrivano tutti allo stesso punto di controllo.
- I test di Ace di DAISY, i test di EPUBCheck del W3C e le linee guida pubblicate sull’accessibilità sono un lavoro precedente importante. Non abbiamo copiato le loro pubblicazioni né pretendiamo di aver inventato la distinzione tra valutazione automatica e valutazione umana. Il contributo originale è l’insieme di archivi appaiati, riproducibile apertamente, la matrice esatta delle segnalazioni e gli esempi su dove indirizzare le correzioni, per un piccolo flusso di lavoro di chi scrive. I casi scelti di proposito non certificano un libro, non stabiliscono la conformità alle WCAG, non garantiscono l’accettazione da parte di un distributore e non stimano l’accessibilità del mercato degli e-book.
- I risultati valgono solo per le versioni fissate EPUBCheck 5.4.0 e Ace 1.4.6, per un solo archivio di prova originale in due capitoli e per un’esecuzione di ciascun archivio. Non si generalizzano ad altri strumenti, versioni, contenuti o sistemi di lettura, e non è stato fatto alcun test con persone, lettori di schermo o distributori.
Fonti originali
- EPUBCheck 5.4.0 release
Versione ufficiale fissata di EPUBCheck e suo ambito.
Consultato il 31 ottobre 2026
- DAISY Ace 1.4.6 release
Versione ufficiale fissata di Ace; ambiente di esecuzione registrato a parte.
Consultato il 31 ottobre 2026
- Ace command-line documentation
Comportamento documentato dei codici di uscita, ordinario e rigoroso, mostrato con un confronto appaiato.
Consultato il 31 ottobre 2026
- Ace configuration documentation
Il valore predefinito di return-2-on-validation-error è false.
Consultato il 31 ottobre 2026
- DAISY Ace evaluation guidance
Limiti della valutazione automatica e verifiche separate.
Consultato il 31 ottobre 2026
- EPUB Accessibility 1.1
Contesto di conformità all’accessibilità; nessuna certificazione dichiarata.
Consultato il 31 ottobre 2026
- Prior work: Ace test suite
Test esistenti di Ace riconosciuti; nessuna pubblicazione di prova copiata.
Consultato il 31 ottobre 2026
- Prior work: EPUBCheck test suite
Test esistenti di EPUBCheck riconosciuti; i casi di flusso di lavoro originali sono distinti.
Consultato il 31 ottobre 2026
Citare e riutilizzare lo studio
Alisson Bento. Quale verifica preliminare di un EPUB individua quale errore? Esperimento originale di confronto su archivi appaiati, 2026. https://alissonbento.com/it/research/epub-preflight-paired-workflow-benchmark-2026/
Riusare gli archivi di prova originali e l’analisi con il credito ad Alisson Bento; riconoscere DAISY e il W3C per i rispettivi strumenti e test precedenti. Conservare le versioni, l’ambito dei casi scelti e i limiti di non certificazione. Conservare le note di licenza del software.
Correzioni o domande editoriali