EPUBCheck · XHTML documenti di contenuto

EPUBCheck HTM-048: pagina SVG senza viewBox

Aggiornato: 04 Novembre 2026

EPUBCheck HTM-048 è un messaggio di errore: “SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).” Un documento a layout fisso costruito come SVG non ha viewBox sul suo elemento svg più esterno, quindi la sua dimensione è sconosciuta. Per le pagine a layout fisso in SVG, il viewBox è ciò che definisce le dimensioni della pagina.

Il messaggio ufficiale

SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).

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

Cause tipiche

Pagine SVG esportate con larghezza e altezza ma senza viewBox.
Un viewBox posizionato su un elemento svg o g interno invece di quello più esterno.

Come correggerlo

Apri il file EPUBCheck nominato (il messaggio fornisce il percorso, la linea e la colonna) in un editor di testo o EPUB come Sigil, oppure decomprimi il EPUB e aprilo lì.
Aggiungi un viewBox all'elemento svg esterno, ad esempio viewBox="0 0 1200 1600" (x, y, larghezza, altezza).
Usa la stessa larghezza e altezza con cui è stata disegnata l'opera d'arte, in modo che nulla venga ritagliato o allungato.
Ricostruisci il EPUB e riesegui EPUBCheck di nuovo per confermare che il messaggio sia scomparso.

Quando non è questo

Se la pagina a layout fisso è XHTML, la dimensione proviene da un elemento meta viewport e il messaggio è HTM-046.

Termini usati qui

Che cos'è un EPUB a layout fisso?

Altri messaggi di HTM

HTM-047 Viewport metadata "…" has a syntax error
HTM-046 Fixed layout document has no "viewport" meta element.
HTM-045 Encountered empty href.
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM-044 Namespace uri "…" was included but not used.
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.

Fonti

EPUB 3.3, §8.2.2.6 Content document dimensions · leggi 04 Novembre 2026

Testo e gravità del messaggio da EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Spiegazione di EpubCC.

FAQ

Cosa significa EPUBCheck HTM-048?

È HTM-048 un errore?

HTM-048 viene segnalato come errore di default. Il EPUB viola una regola della specifica ed è non valido. Le librerie e l'invio a Kindle potrebbero rifiutarlo, e EPUBCheck termina con stato 1.