ariutti / book-test

a repository where I will try usign pandoc to produce an epub from a markdown file!
0 stars 1 forks source link

book test

Questo è un repository nel quale raccolgo il codice sorgente per una breve pubblicazione epub di prova. I file sorgente sono contenuti nelle cartelle:

Il file epub ottenuto dalla conversione viene posizionato nella cartella export.

Il libro sarà creato utilizzando il programma pandoc. Il comando usato per operare la conversione è quello mostrato all'interno dello script convert.sh.

Epub validator

Per verificare la validità del file epub ottenuto dopo la conversione, si può utilizzare il seguente strumento:

Constatazioni

Ecco come inserire una immagine senza che pandoc ne ricavi una didascalia ma, al contempo, fornendo un attributo alt affinchè la validazione dell'elemento vada a buon fine:

![img](./illustrations/license-by-sa.png)<!-- no caption -->

In tale caso l'attributo alt è settato a 'img'.

Un elemento di tipo figure è una immagine che viene inclusa all'interno del proprio elemento div e in genere possiede sia un alt che una didascalia. Invece una illustrazione (immagine) è qualcosa che viene inclusa in un elemento p ed è pensata per essere mostrata con il testo che le scorre attorno.

Licenza

This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/.