ariutti / diario-in-codice

Repository per il libro

Home Page:https://ariutti.github.io/diario-in-codice/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Graphviz

Come usare graphviz per creare i grafici usati come illustrazioni per alcune parti del libro. Gli attributi e l'uso da linea di comando.

push sul repository

da linea di comando usa questa stringa:

git push origin gh-pages

Note per PANDOC

I files .md realizzati per le pagine del sito saranno poi riutilizzati per ottenere una versione ePub e PDF del sito.

Immagini

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

Ottenere la versione ePub del libro

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.

Epub validarion

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

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/.

About

Repository per il libro

https://ariutti.github.io/diario-in-codice/

License:Other


Languages

Language:CSS 75.1%Language:HTML 20.9%Language:Shell 4.0%