Sommario

• Allineamento dell'intestazione e giustificazione
• Impostazioni di default del corpo del testo
• Formattazione dei paragrafi
• Valori fissi
• Formattazione di margini e riempimenti
• Capilettera
• Interruzioni di pagina con CSS
• Tipo di caratteri incorporati
• Personalizzazione della selezione del carattere
• Linee guida per i numeri di pagina
• Abilitazione di numeri di pagina effettivi
• Linee guida per le note a piè di pagina
• Supporto di MathML

---

Allineamento dell'intestazione e giustificazione

Poiché il testo negli eBook a impaginazione dinamica è completamente giustificato per default (ovvero text-align: justify;), Amazon consiglia vivamente di specificare l'allineamento CSS appropriato per tutte le intestazioni al fine di evitare spazi eccessivi tra le parole (ovvero text-align: left; text-align: right; text-align: center;).

---

Impostazioni di default del corpo del testo

Il corpo del testo in un libro Kindle (di narrativa e saggistica) a impaginazione dinamica deve avere tutti i valori di default. Amazon suggerisce ai creatori di contenuti di usare stili creativi per intestazioni, paragrafi speciali, note a piè di pagina, sommari, ecc., ma non per il corpo del testo. Consulta i dettagli sull'uso dei caratteri incorporati. Questo suggerimento è motivato dal fatto che qualsiasi modifica stilistica sul corpo del testo in HTML sostituisce le impostazioni di lettura di default scelte dall'utente, rischiando di compromettere l'esperienza di lettura. Ecco i punti fondamentali:

• Il carattere del corpo del testo deve essere impostato in CSS utilizzando l'attributo font-family. Il corpo del testo deve usare la dimensione carattere (1 em) e l'altezza di riga di default. Il tag <font size="…"> o gli attributi font-size e line-height in CSS non devono essere utilizzati nel corpo del testo.
• Il corpo del testo non deve essere principalmente in grassetto o corsivo. Naturalmente, è possibile formattare alcune parti in grassetto o in corsivo per metterle in evidenza. Questa linea guida ha lo scopo di evitare che un libro sia scritto, ad esempio, interamente in grassetto.
• Il corpo del testo non deve avere un colore di carattere prestabilito per tutto il libro. Se preferisci usare un colore prestabilito in alcune sezioni del libro, non utilizzarne uno troppo chiaro o troppo scuro. I colori chiari non saranno visualizzati con contrasto sufficiente sui dispositivi su cui è impostato uno sfondo bianco o sui lettori di eBook. I colori scuri non saranno visualizzati in modo ottimale sui dispositivi su cui è impostato uno sfondo nero. Consulta i suggerimenti del W3C (World Wide Web Consortium) per mantenere un rapporto di contrasto leggibile tra testo e colori di sfondo. Per i grigi, usa i colori compresi nell'intervallo di valori esadecimali da 666 a 999.
  • Per determinare se un colore rientra in questo intervallo, usa uno strumento per convertire il colore in valori RGB. Inserisci i tre numeri risultanti nella seguente formula: Y = (0,2126 * R) + (0,7152 * G) + (0,0722 * B). Se il valore di Y rientra in un intervallo compreso tra 102 e 153, il colore consentirà una piacevole lettura sulle applicazioni e sui dispositivi Kindle.
  In un libro con la funzione di composizione migliorata attiva, qualsiasi testo di qualunque colore posto su qualsiasi colore di sfondo sarà leggibile sui lettori Kindle. I colori dei caratteri si adattano automaticamente per offrire un contrasto sufficiente sia con il motivo cromatico del dispositivo scelto dal lettore, sia con il colore di sfondo degli elementi. Nell'esempio di seguito, gli stessi colori ("giallo", "nero" e "arancione") sono stati applicati al carattere e allo sfondo. Il colore del carattere cambia per assicurare un contrasto leggibile a seconda dello sfondo. Ulteriori informazioni sulla composizione migliorata.
  
  
  
  
• Il colore di sfondo del corpo del testo non deve essere nero o bianco. I clienti affermano che ciò può compromettere la lettura quando lo sfondo del dispositivo è impostato su un colore differente e in quanto il testo può diventare invisibile se l'utente cambia le impostazioni del colore dello sfondo sul proprio dispositivo e il colore del carattere si inverte automaticamente.
• Il carattere del corpo del testo non deve essere forzato. Assicurati di aver seguito le linee guida per i caratteri incorporati. In caso contrario, infatti, i clienti potrebbero non essere in grado di modificare il proprio carattere di lettura preferito.
• Le parole nei paragrafi del corpo del testo non devono essere separate da spazi unificatori, ma da spazi normali.
• Il corpo del testo non deve presentare un margine destro/sinistro forzato, né riempimenti all'interno del libro. Se alcuni paragrafi richiedono un margine destro/sinistro per essere distinti visivamente dal corpo del testo, ad esempio l'elenco di ingredienti in una ricetta o una citazione, i margini applicati a tali sezioni devono essere specificati come percentuali, anziché come em o valori punto.
• Durante il processo di caricamento vengono applicate le seguenti correzioni dei caratteri:
  • Le dimensioni del carattere utilizzato nella maggior parte dei contenuti saranno normalizzate a 1 em.
  • L'attributo font-family utilizzato nella maggior parte dei contenuti sarà spostato nel tag radice (corpo del testo).
  • Il colore dei caratteri forzato utilizzato nel corpo del testo verrà rimosso per consentire all'utente di modificare il colore del testo.

---

Formattazione dei paragrafi

Per il corpo del testo è necessario utilizzare i rientri o un'interlinea aggiuntiva per consentire ai clienti di distinguere i paragrafi. Amazon consiglia di utilizzare l'attributo text-indent in CSS per impostare il rientro su un valore non superiore a 4 em per i paragrafi di testo. Per modificare lo spazio prima o dopo ciascun paragrafo, usa rispettivamente gli stili margin-top o margin-bottom in CSS. Consigliamo l'uso di valori em per questi attributi. Non usare mai la proprietà height per controllare la dimensione di elementi contenenti testo, altrimenti potrebbero verificarsi sovrapposizioni nel libro. La proprietà height deve essere applicata solo alle immagini dei libri a impaginazione dinamica.

---

Valori fissi

Evita di usare valori fissi come punti e pixel per le proprietà CSS quali font-size, width, height, margin, padding e text-indent. Per garantire la resa su schermi di varie dimensioni e con risoluzioni diverse, specifica questi valori in em o in percentuali.

---

Formattazione di margini e riempimenti

Quando utilizzi le proprietà CSS relative al riempimento e ai margini destro o sinistro, specifica i valori in percentuale (%), anziché in unità em per evitare di creare margini troppo ampi in presenza di caratteri grandi e non rischiare di compromettere la lettura. Ai margini dovrebbero essere assegnati valori pari o superiori a 0 per evitare che il contenuto esca dal bordo dello schermo o si sovrapponga ad altri contenuti. Imposta sempre il margine sinistro e il margine destro su 0 per il corpo del testo normale per consentire agli utenti di scegliere l'intera gamma di selezione dei margini usando i valori di default del dispositivo. I margini superiore/inferiore devono essere specificati in em, in modo che la spaziatura tra i paragrafi sia facilmente distinguibile con qualsiasi carattere e dimensione del dispositivo.

---

Capilettera

Elementi come i capilettera dovrebbero essere espressi in percentuali o unità relative (positive o negative) anziché con valori fissi quali punti e pixel. La parte superiore del capolettera dovrebbe essere allineata con il corpo del testo. Per creare i capilettera, Amazon consiglia di usare il campione CSS di seguito:

Esempio:

p.para { font-size: 1em; margin-bottom: 0; margin-top: 0; text-align: justify; text-indent: 0; } @media amzn-kf8 { span.dropcaps { font-weight:normal; font-size:320%; float:left; margin-top:-0.3225em; margin-bottom:-0.3245em; } } @media amzn-mobi { span.dropcaps { font-size:3em; font-weight: bold; } } <p class="para"><span class="dropcaps">T</span>his is a sample.

Per verificare che i capilettera vengano visualizzati come desiderato, testa il libro. Di seguito è riportato un esempio di capolettera formattato usando questo metodo in un libro con la composizione migliorata:

Impostazione con carattere piccolo

Impostazione con carattere grande

---

Interruzioni di pagina con CSS

Kindle ora supporta gli attributi CSS per page-break-inside:avoid e break-inside:avoid. Ciò consente agli editori di raggruppare gli elementi in modo che non si suddividano su più pagine. I casi d'uso includono immagini con didascalie e titoli con paragrafi che desideri mantenere insieme nel proprio design.

Inoltre, Kindle supporta CSS per page-break-after, break-after, page-break-before e break-before, che possono essere utilizzati per evitare interruzioni di pagina prima e dopo i contenitori o blocchi specificati. Kindle esamina queste proprietà per stabilire se è necessario evitare interruzioni di pagina tra o all'interno degli elementi. I valori per questi attributi sono :avoid, :auto e :always.

---

Uso di caratteri incorporati

Kindle supporta i caratteri incorporati all'interno dell'eBook. Questi possono essere caratteri Open Type (OTF) o True Type (TTF). Kindle non consiglia l'uso di caratteri Type 1 (Postscript). Per offrire ai clienti Kindle la migliore esperienza di lettura possibile, per default i libri a impaginazione dinamica che usano i caratteri Type 1 sono resi utilizzando i caratteri Kindle. Sui dispositivi e sulle applicazioni compatibili con il formato KF8, i clienti hanno la possibilità di attivare o disattivare i caratteri forniti dall'editore.

È responsabilità dell'editore verificare i diritti di licenza appropriati per l'utilizzo dei caratteri. A meno che i caratteri incorporati non siano necessari per trasmettere un intento specifico, Amazon consiglia l'uso del set di caratteri di default installato sui dispositivi e sulle applicazioni Kindle, in quanto tali caratteri sono stati regolati per garantire una maggiore qualità nella resa.

Nella scelta di un carattere, considerane l'idoneità per i lettori con deficit visivi moderati. Scegli un carattere chiaro e semplice che offra un buon contrasto su tutti gli sfondi di tablet e lettori di eBook.

Suggerimento per l'accessibilità: i caratteri sottili sono più difficili da leggere e possono influire sul contrasto percepito del testo con lo sfondo. Amazon consiglia di evitare l'uso di caratteri sottili per il corpo del testo.

Kindle supporta anche il carattere monospazio. Il contenuto dei seguenti sarà reso con un carattere monospazio: <pre>, <code>, <samp>, <kbd>, <tt>, <font face="courier">, <font face="monospace">.

A eccezione di <pre>, i tag sopra elencati non modificano l'allineamento del testo.

---

Personalizzazione della selezione del carattere

Il carattere principale o primario in un libro dovrebbe essere configurato al livello <body>. Se preferisci utilizzare uno stile di testo aggiuntivo come il corsivo o il grassetto, assicurarsi che gli stili siano applicati al testo piuttosto che al carattere, in modo che i caratteri selezionati dal cliente mostrino correttamente questi elementi di stile. Di seguito sono riportati alcuni esempi di implementazioni corrette ed errate della personalizzazione dei caratteri in un libro Kindle.

Codice HTML errato	Codice HTML corretto
<html> <body> <p style="font-family:PrimaryFont"> Contenuto con carattere primario</p> <p style="font-family:SecondaryFont"> Contenuto con carattere secondario</p> <p style="font-family:PrimaryFont"> Contenuto con carattere primario</p> <p style="font-family:PrimaryFont"> Contenuto con carattere primario</p> </body> </html>	<html> <body style="font-family:PrimaryFont"> <p>Contenuto con carattere primario</p> <p style="font-family:SecondaryFont"> Contenuto con carattere secondario</p> <p>Contenuto con carattere primario</p> <p>Contenuto con carattere primario</p> </body> </html>

Lo stesso risultato può essere ottenuto usando classi CSS come indicato di seguito.

Codice CSS errato	Codice CSS corretto
body{ font-size: asize; } .indent { font-size: asize; font-family: PrimaryFont; } .sidebar-text { font-family: SecondaryFont; font-weight: bold; }	body { font-family: PrimaryFont; font-size: asize; } .indent { font-size: asize; } .sidebar-text { font-family: SecondaryFont; weight: bold; }

In fase di codifica dei caratteri, assicurati che i tag HTML siano chiusi correttamente per evitare conflitti di priorità. In caso di conflitto di priorità, i file dei caratteri all'interno del libro verranno rimossi intenzionalmente per offrire ai clienti Kindle la migliore esperienza di lettura possibile durante la selezione delle impostazioni del carattere.

Ad esempio:

Codice HTML errato	Codice HTML corretto
<html> <body style="fontfamily:PrimaryFont"> <p>Contenuto con carattere primario</p> <div style="fontfamily:SecondaryFont"> Contenuto con carattere secondario. <div style="font-family:ThirdFont"> Contenuto con carattere terziario </div> </div> <p>Contenuto con carattere primario</p> </body> </html>	<html> <body style="font-family:PrimaryFont"> <p>Contenuto con carattere primario</p> <div style="fontfamily:SecondaryFont"> Contenuto con carattere secondario. </div> <div style="font-family:ThirdFont"> Contenuto con carattere terziario </div> <p>Contenuto con carattere primario</p> </body> </html>

Codice CSS errato	Codice CSS corretto
h2.title, h3.title { text-indent:0; text-align:center; font-family:'PrimaryFont'; } h3.title { font-family:'SecondaryFont'; font-size:2em; font-weight:bold; }	h2.title { text-indent:0; text-align:center; font-family:'PrimaryFont'; } h3.title { text-indent:0; text-align:center; font-size:2em; font-weight:bold; font-family:'SecondaryFont'; }

---

Linee guida per i numeri di pagina

Non sempre i numeri di pagina dei libri Kindle corrispondono a quelli delle edizioni cartacee del libro. Sebbene la funzionalità Numeri di pagina effettivi Kindle sia attivata nel menu Vai a, i riferimenti ai numeri di pagina interni all'eBook devono essere gestiti come segue:

• Sommario: se sono presenti numeri di pagina nel sommario del documento originale stampato, devono essere rimossi nella conversione digitale. Il nome della sezione deve essere conservato e associato tramite collegamento ipertestuale alla posizione pertinente nell'eBook. Per esempio, se nel sommario di un documento stampato è indicata la voce "Capitolo 1... P. 36", l'eBook deve mostrare esclusivamente il collegamento ipertestuale "Capitolo 1" associato alla posizione digitale corretta.
• Collegamenti interni: se è presente testo con riferimento a un'altra pagina nell'eBook, ad esempio "vedi pagina XX", questo testo va collegato al paragrafo pertinente all'interno dell'eBook.
• Indice: ogni numero di pagina nell'indice deve essere collegato al paragrafo pertinente nell'eBook (oppure all'illustrazione, alla tabella o al grafico pertinente).
• Collegamenti interni all'indice: se è presente una voce che fa riferimento a un'altra sezione dell'indice, ad esempio "vedi anche XX", questo testo va collegato alla sezione pertinente all'interno dell'indice.

---

Abilitazione di numeri di pagina effettivi

I lettori apprezzano i numeri di pagina perché rappresentano un metodo di navigazione familiare e consentono di coordinare la lettura con gli interlocutori che utilizzano le versioni cartacee, ad esempio in un'aula o in un circolo di lettura. Autori ed editori possono includere la funzionalità Numeri di pagina effettivi di Amazon nei libri Kindle aggiungendo nel file EPUB i numeri di pagina, che vengono visualizzati sui dispositivi e sulle applicazioni Kindle.

Gli editori devono associare i numeri di pagina effettivi dell'eBook a quelli della versione cartacea (copertina rigida, libro cartaceo, ecc.) più simile all'eBook e fornire l'ISBN nei metadati come descritto in http://kb.daisy.org/publishing/docs/navigation/pagelist.html#desc. Al momento i numeri di pagina effettivi non possono essere visualizzati in anteprima in Kindle Previewer o tramite trasferimento, ma sono visibili quando l'eBook viene pubblicato e vengono indicati nella pagina dei dettagli.

Per supportare la funzionalità Numeri di pagina effettivi:

• EPUB 3: Segui le linee guida per l'accessibilità a EPUB 3 per i numeri di pagina.
• EPUB 2: Segui i requisiti per NCX in OPF 2.0, sezione 2.4.1.2.

Note aggiuntive:

• Usa solo numeri romani o arabi per aggiungere i numeri di pagina (esempio: i, ii, iii, ecc. e/o 1, 2, 3, 4, e così via).
• Non aggiungere altro testo, come "Pagina", nell'attributo del nome dei tag delle pagine (esempio: "Pagina 1", "Pagina 2"). Per default, Kindle aggiunge la parola "Pagina" davanti all'attributo del numero di pagina.
• Verifica che non vi siano duplicati di posizioni HTML utilizzati come riferimento a pagine diverse.
• Verifica che non vi siano duplicati di etichette della pagina utilizzati come riferimento a posizioni HTML diverse.
• Verifica che non vi siano etichette di pagina vuote (anche per le pagine bianche).
• Verifica che non vi siano ancoraggi senza target adeguati.
• Verifica che tutti i percorsi alle pagine HTML siano relativi.

---

Linee guida per le note a piè di pagina

Amazon consiglia vivamente di contrassegnare le note a piè di pagina con l'elemento HTML5 aside e l'attributo epub:type. Ciò consente ai sistemi di lettura accessibili di ignorare le note a piè di pagina tranne quando sono seguite dai rispettivi elementi di riferimento e permette a qualsiasi sistema di lettura di gestirle in modo più intelligente (ad es. come pop-up). Questo uso assicura che, anche se la semantica EPUB non è riconosciuta, le note saranno comunque trattate come contenuto secondario a causa della natura dell'elemento HTML5 aside.

Indipendentemente dall'uso dell'elemento aside, Amazon richiede di formattare le note a piè di pagina con collegamenti ipertestuali bidirezionali (il testo è collegato alla nota a piè di pagina e questa è a sua volta ricollegata al testo). In questo modo i clienti possono tornare facilmente al testo dopo aver letto la nota a piè di pagina. In alcuni dispositivi Kindle, come Kindle Paperwhite, le note a piè di pagina con collegamenti ipertestuali bidirezionali vengono visualizzate in un pop-up.

Per una migliore esperienza di lettura, Amazon consiglia vivamente di posizionare il testo della nota a piè di pagina alla fine del capitolo o del libro.

Definisci le note a piè di pagina utilizzando uno dei seguenti metodi:

Metodo 1 (preferito):

<p>Questo esempio di nota a piè di pagina utilizza l'elemento aside con l'attributo epub:type e collegamenti ipertestuali bidirezionali. <sup><a id="source" href="#ft-1-1" epub:type="noteref">1</a></sup></p> ... <aside id="ft-1-1" epub:type="footnote"> <p><a epub:type="noteref" href="#source">1.</a> Testo della nota a piè di pagina da collocare alla fine del capitolo o del libro.</p> </aside >

Metodo 2:

<p>Questo esempio di nota a piè di pagina utilizza solo collegamenti ipertestuali bidirezionali. <sup><a href=>footnotes.html#fn1" id="r1">[2]</a></sup></p> ... <p id="fn1"><a href="chapter01.html#r1">2.</a> Testo della nota a piè di pagina da collocare alla fine del capitolo o del libro.</p>

Se il tuo libro contiene note a piè di pagina o note di chiusura senza numeri o simboli, Amazon consiglia di creare un unico collegamento dalla nota al testo pertinente all'interno del libro.

Esempio:

<p>Questo esempio descrive un <a id="fn1"/> evento che si è verificato.</p> ... <p><a href="chapter01.html#fn1">event that happened</a> Testo della nota di chiusura che fornisce un riferimento per i dettagli dell'evento.</p>

---

Supporto di MathML

La funzionalità di composizione migliorata supporta il linguaggio MathML.

Tag supportati:

maligngroup	mrow
malignmark	ms
math	mspace
menclose	msqrt
mfenced	mstyle
mfrac	msub
mi	msubsup
mlabeledtr	msup
mmultiscripts	mtable
mn	mtd
mo	mtext
mover	mtr
mpadded	munder
mphantom	munderover
mroot

Tag non supportati:

annotation

maction

mglyph

mlongdiv

msgroup

mstack

semantics

Risoluzione dei problemi:

Aprire la pagina HTML con MathJax. Se il linguaggio MathML è visualizzato senza problemi, sarà supportato nella composizione migliorata.