Come usare graphviz per creare i grafici usati come illustrazioni per alcune parti del libro. Gli attributi e l'uso da linea di comando.
da linea di comando usa questa stringa:
git push origin gh-pages
I files .md
realizzati per le pagine del sito saranno poi riutilizzati per ottenere una versione ePub
e PDF
del sito.
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 attorn
Per ottenere la versione epub
del libro seguire entrare dapprima nella cartella resources/versione_epub
.
I file sorgente sono contenuti nelle cartelle:
- TODO chapters (contenente i files sorgente con il testo della pubblicazione);
- epub (contenente un file per i metadati, l'immagine della copertina e il foglio di stile);
- illustrations (contentente le illustrazioni utilizzate all'interno della pubblicazione);
- fonts (contiene i fonts utilizzati nel libro);
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.
Per verificare la validità del file epub ottenuto dopo la conversione, si può utilizzare il seguente strumento:
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/.