Un punto di partenza per la scrittura di una tesi in AsciiDoc aderente alle specifiche del DISI.
Puoi usare questo progetto come modello per una nuova repository sul tuo profilo: basta cliccare su "Use this template" in alto a destra.
Warning
|
Il progetto è al momento in fase di sviluppo. |
-
ruby versione
v2.7
o superiore.
Si consiglia l’installazione di un’estensione per il vostro code editor che supporti asciidoc.
Per compilare il file di esempio tesi.adoc
utilizzare il comando:
asciidoctor-pdf --theme unibo.yml -a pdf-fontsdir=fonts tesi.adoc
Cliccando su "Actions" in alto, potrai abilitare l’automatizzazione del tuo progetto:
-
ogni volta che farai push su una PR diretta verso
main
, verrà controllato che la tua tesi compili correttamente; -
se avrai impostato "Github Actions" come "Settings"/"Pages"/"Build and depolyment"/"Source", a ogni modifica su
main
la tua tesi verrà pubblicata suhttps://<nome-utente>.github.io/<nome-repository/tesi.pdf
.
Ricorda che se modifichi nome e percorso di tesi.adoc
o unibo.yml
, dovrai
modificare le tue Actions di conseguenza.
Asciidoc è il linguaggio che dovrai utilizzare, e puoi trovare qui la
documentazione.\
Asciidoctor PDF è il software che produrrà il .pdf
, e puoi trovare qui la
documentazione per l’impaginazione.
Warning
|
Fai attenzione a modificare il file unibo.yml ; l’indentazione è importantissima (2 spazi).
|
La sezione footer
nel file unibo.yml
controlla i
numeri di pagina
che sono pre-impostati al centro. Per impostarli sul lato esterno
alla rilegatura, sostituisci tutta la sezione footer
con questa:
footer:
height: 100
recto:
right:
content: "{page-number}"
verso:
left:
content: "{page-number}"