2019-02-23 14:42:21 +00:00
# LaTeKiSS
2019-04-01 18:53:27 +00:00
**LaTeKiSS** è un template *[pandoc][]* per tesi di laurea. Il suo obbiettivo è sollevare gli studenti dall'impaginazione, in modo da concentrarsi esclusivamente sul contenuto della tesi.
2019-02-23 14:42:21 +00:00
2019-04-01 18:53:27 +00:00
*LaTeKiSS* è realizzato in modo da essere quanto più possibile *LaTex-free* per l'utente finale.
Lo studente, così, potrà scrivere la sua tesi in *markdown* e inserire le informazioni extra tramite un file `.yaml` .
2019-02-23 14:42:21 +00:00
Nella seguente guida è specificato come adattare il template alle proprie necessità e come ottenere il documento finale.
2019-02-23 14:47:03 +00:00
Questo template usa il pacchetto LaTeX [ClassicThesis][classicthesis] realizzato da André Miede.
2019-02-23 14:42:21 +00:00
---
## Guida
### Installazione
- Installare pandoc e una distribuzione LaTeX.
- Scaricare l'ultima versione di questo tema dalla pagina delle release.
- Copiare il file `latekiss.tex` nella cartella dei template e rinominarlo in `latekiss.latex` . La cartella dei template varia a seconda del sistema operativo.
- Unix, Linux, macOS: `~/.pandoc/templates/`
- Windows XP: `C:\Documents And Settings\USERNAME\Application Data\pandoc\templates`
- Windows Vista o superiore: `C:\Users\USERNAME\AppData\Roaming\pandoc\templates`
2019-04-01 18:53:27 +00:00
### Utilizzo
Una volta installato tutto il materiale necessario sarà specificare l'utilizzo del tema *LaTeKiSS* durante la compilazione tramite pandoc.
2020-09-26 10:57:44 +00:00
Per esempio nel caso in cui l'intera tesi sia stata scritta all'interno del file `thesis.md` è possibile ottenere il documento formattato in pdf attraverso il seguente comando.
2019-04-01 18:53:27 +00:00
```bash
2020-09-26 10:57:44 +00:00
pandoc thesis.md -o thesis.pdf --template latekiss
2019-04-01 18:53:27 +00:00
```
2020-09-26 10:57:44 +00:00
Nella cartella `samples` sono disponibili alcuni esempi di utilizzo.
2020-09-26 13:24:55 +00:00
#### Configurazioni consigliate
Al fine di ottenere un risultato migliore è consigliabile utilizzare il flag `--top-level-division chapter` e la variabile `numbersections` settata a `true` .
Con queste nuove configurazioni il comando per la compilazione è il seguente.
```bash
pandoc arsclassica.md -o arsclassica.pdf --top-level-division chapter -V numbersections --template latekiss
```
#### Link
I link e i riferimenti sono in nero di default, e possibile abilitare il colore andando a settare la variabile `colorlinks` a `true` .
È possibile cambiare i colori di default andando a settare le variabili `linkcolor` , `filecolor` , `citecolor` , `urlcolor` .
#### Riferimenti
È possibile gestire i vari riferimenti attraverso il filtro [pandoc-crossref][].
#### Bibliografia
2021-05-28 11:30:02 +00:00
È possibile gestire la bibliografia attraverso il flag `--citeproc` .
2020-09-26 13:24:55 +00:00
#### Compilazione degli esempi
Di seguito è riportato il comando utilizzato per compilare gli esempi forniti nella cartella samples.
Rispetto al comando precedente in questo caso sono si è utilizzato `pandoc-crossref` , `pandoc-citeproc` e le configurazioni consigliate.
```bash
pandoc --template latekiss < input-file > -o < output-file > --top-level-division chapter -V numbersections -F pandoc-crossref --bibliography bibliography.yaml
```
2019-02-23 14:42:21 +00:00
### Variabili
2019-03-25 20:44:15 +00:00
- `abstract` (string)
2019-02-23 14:42:21 +00:00
abstract del documento
2019-03-25 20:44:15 +00:00
- `abstract-title` (string)
2019-02-23 14:42:21 +00:00
titolo della pagina dell'abstract
2019-03-25 20:44:15 +00:00
- `academic-year` (string)
2019-02-23 14:42:21 +00:00
anno accademico
2019-03-25 20:44:15 +00:00
- `acronym` (lista)
2020-09-26 10:57:44 +00:00
- `short` (string)
nome breve dell'acronimo
- `long` (string)
nome lungo dell'acronimo
- `ac-title` (string)
2019-02-23 14:42:21 +00:00
titolo della pagina degli acronimi
2020-09-26 10:57:44 +00:00
- `ac-onlyused` (boolean)
stampa solo gli acronimi utilizzati nel testo. Falso come valore di default
- `ac-smaller` (boolean)
stampa gli acronimi con un font più piccolo
- `ac-footnote` (boolean)
stampa il nome lungo dell'acronimo come nota a piè di pagina
- `ac-nohyperlinks` (boolean)
gli acronimi non presentano gli hyperlink
- `ac-withpage` (boolean)
nella lista degli acronimi viene aggiunta la pagine di primo utilizzo.
Per un corretto funzionamento utilizzare anche `ac-onlyused`
2019-03-25 20:44:15 +00:00
- `acknowledgments ` (string)
2019-02-23 14:42:21 +00:00
ringraziamenti
2019-03-25 20:44:15 +00:00
- `acknowledgments-title ` (string)
2019-02-23 14:42:21 +00:00
titolo della pagina dei ringraziamenti
2019-03-25 20:44:15 +00:00
- `author` (string)
2019-02-23 14:42:21 +00:00
nome e cognome dell'autore
2019-03-25 20:44:15 +00:00
- `babel` (string)
2019-02-23 14:42:21 +00:00
lingua del pacchetto babel
2019-03-25 20:44:15 +00:00
- `bibliography ` (string)
2019-02-23 14:42:21 +00:00
path del file .bib
2019-03-25 20:44:15 +00:00
- `copyright` (string)
2019-02-23 14:42:21 +00:00
messaggio di copyright
2019-03-25 20:44:15 +00:00
- `course` (string)
2019-02-23 14:42:21 +00:00
il corso di laurea che si sta frequentando
2019-03-25 20:44:15 +00:00
- `dedication ` (string)
2019-02-23 14:42:21 +00:00
dedica
2019-03-25 20:44:15 +00:00
- `dedication-title` (string)
2019-02-23 14:42:21 +00:00
titolo della pagina di dedica
2019-03-25 20:44:15 +00:00
- `department` (string)
2019-02-23 14:42:21 +00:00
il dipartimento a quale afferisce il corso di laurea
2019-03-25 20:44:15 +00:00
- `draf` (string)
2019-02-23 14:42:21 +00:00
versione della bozza. Da non specificare nel documento finale
2019-03-25 20:44:15 +00:00
- `eulerchapternumber` (boolean)
usa il font AMS Euler per il numero del capitolo. Palatino come font di default
- `floatnumbering` (boolean)
usa la numerazione float per le figure e le altre risorse. False come valore di default
- `fontsize ` (string)
2019-02-23 14:42:21 +00:00
grandezza del carattere. 11pt come valore di default
2020-09-26 13:24:55 +00:00
- `colorlink` (boolean)
se impostato i link appaiono colorati. Falso come valore di default
2019-03-25 20:44:15 +00:00
- `institute ` (string)
2019-02-23 14:42:21 +00:00
l'istituto al quale si è iscritti
2019-03-25 20:44:15 +00:00
- `keywords` (lista di string)
2019-02-23 14:42:21 +00:00
lista con le parole chiave del documento
2019-03-25 20:44:15 +00:00
- `lineheaders` (boolean)
aggiunge una linea di separazione tra il numero del capitolo e il nome del capitolo. Falso come valore di default
- `logo` (string)
2019-02-23 14:42:21 +00:00
path del logo dell'università
2019-03-25 20:44:15 +00:00
- `matr` (int)
2019-02-23 14:42:21 +00:00
matricola dell'autore
2019-03-25 20:44:15 +00:00
- `openright` (boolean)
2019-02-23 14:42:21 +00:00
il capitolo inizia sempre alla pagina destra. Falso come valore di default
2020-09-26 10:57:44 +00:00
- `papersize` (string)
2019-02-23 14:42:21 +00:00
grandezza del foglio. A4 come valore di default
2019-03-25 20:44:15 +00:00
- `quote` (string)
2019-02-23 14:42:21 +00:00
citazione
2019-03-25 20:44:15 +00:00
- `quote-author` (string)
2019-02-23 14:42:21 +00:00
autore della citazione
2019-03-25 20:44:15 +00:00
- `subject` (string)
2019-02-23 14:42:21 +00:00
oggetto della tesi
2019-03-25 20:44:15 +00:00
- `subtitle ` (string)
2019-02-23 14:42:21 +00:00
sottotitolo della tesi
- `supervisor`
2019-03-25 20:44:15 +00:00
- `name` (string)
2019-02-23 14:42:21 +00:00
nome del relatore
2019-03-25 20:44:15 +00:00
- `title` (string)
2019-02-23 14:42:21 +00:00
titolo del relatore
2019-03-25 20:44:15 +00:00
- `style` (string)
consente di impostare lo liste della tesi tra classicthesis e arsclassica. classicthesis come valore di default
- `title` (string)
2019-02-23 14:42:21 +00:00
titolo della tesi
2019-03-25 20:44:15 +00:00
- `toc` (boolean)
2019-02-23 14:42:21 +00:00
include l'indice
2019-03-31 19:01:35 +00:00
- `toc-aligned` (boolean)
allinea l'indice. False come valore di default
2019-03-25 20:44:15 +00:00
- `toc-depth` (int)
2019-02-23 14:42:21 +00:00
configura la profondità dell'indice. Due come valore di default
2019-03-25 20:44:15 +00:00
- `toc-dotted` (boolean)
allinea i numeri di pagina a destra aggiungendo i puntini. False come valore di default
- `toc-title` (string)
2019-02-23 14:42:21 +00:00
configura il titolo dell'indice
2019-03-25 20:44:15 +00:00
- `lof` (boolean)
2019-02-23 14:42:21 +00:00
include l'indice delle figure
2019-03-25 20:44:15 +00:00
- `lof-title` (string)
2019-02-23 14:42:21 +00:00
configura il titolo dell'indice delle figure
2019-03-25 20:44:15 +00:00
- `lot` (boolean)
2019-02-23 14:42:21 +00:00
include l'indice delle tabelle
2019-03-25 20:44:15 +00:00
- `lot-title` (string)
2019-02-23 14:42:21 +00:00
configura il titolo dell'indice delle figure
2019-03-25 20:44:15 +00:00
- `twoside` (boolean)
2019-02-23 14:42:21 +00:00
se si desidera ottenere pagina destra e pagina sinistra. Falso come valore di default
[pandoc]: https://pandoc.org/
2019-02-23 14:47:03 +00:00
[classicthesis]: https://bitbucket.org/amiede/classicthesis/wiki/Home
2020-09-26 13:24:55 +00:00
[pandoc-crossref]: https://lierdakil.github.io/pandoc-crossref/
