Skip to content

Commit

Permalink
docs: added respective infos about working with Typst
Browse files Browse the repository at this point in the history
  • Loading branch information
eduardz1 committed Oct 7, 2024
1 parent b2085f3 commit 78b5d85
Showing 1 changed file with 46 additions and 4 deletions.
50 changes: 46 additions & 4 deletions Tesi/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Guida all'utilizzo di LaTeX
# Guida alla scrittura della tesi

## Primo passo: imparare LaTeX
## Primo passo: imparare LaTeX o Typst

### LaTeX

Quando ci si approccia alla scrittura della tesi è essenziale avere gli strumenti corretti per scriverla.
Molti professori richiedono esplicitamente di leggere la tesi in LaTeX, per diversi motivi:
Expand All @@ -12,29 +14,69 @@ Molti professori richiedono esplicitamente di leggere la tesi in LaTeX, per dive

Prima di iniziare, se vuoi spendere ancora due minuti, dai un'occhiata alla storia di [come è nato](https://en.wikipedia.org/wiki/LaTeX#History) LaTeX!

### Typst

[Typst](https://github.com/typst/typst) è un nuovo sistema di typesetting che mira a mantenere la flessibilità di LaTeX, ma con una sintassi più moderna ed un linguaggio di scripting più potente.

## Templates

### LaTeX

Fondamentale per iniziare a lavorare su LaTeX è cercare qualche template decente per la tua tesi. In questa cartella troverai delle baseline per i frontespizi,
anche se personalmente consiglio di iniziare con i [templates di OverLeaf](https://www.overleaf.com/latex/templates/)!
Da qui, la strada è in discesa: modifica, ritaglia ed incolla le parti che ti piacciono o meno.

### Typst

Per iniziare a scrivere la propria tesi su Typst, è possibile scrivere da se il proprio template o utilizzare il template linkato in [template-tesi-typst](template-tesi-typst) ([pagina universe](https://typst.app/universe/package/modern-unito-thesis)).

Per inizializzare un progetto con il template menzionato è possibile clonare [la repo](https://github.com/eduardz1/unito-typst-template) o eseguire da CLI il comando:

```bash
typst init @preview/modern-unito-thesis:0.1.0
```

## Editor

### LaTeX

Qua è una scelta personale: moltissimi professori utilizzano [OverLeaf](https://www.overleaf.com/project), un editor LaTeX online semplice ed efficace.
Niente toglie che possiate utilizzare il vostro editor preferito: VSC, (n)vim e quant'altro, se correttamente configurati, possono essere utilissimi.

### Typst

Così come per LaTeX, Typst offre un [editor collaborativo online](https://typst.app/).

In alternativa è possibile utilizzare un editor locale, l'LSP integrato [Tinymist](https://github.com/Myriad-Dreamin/tinymist) offre integrazioni per VSCode, Neovim, Helix e altri editor.

## Simboli frequentemente utilizzati

### LaTeX

Potete trovare delle shortcut utilissime in [questo PDF](https://www.evilscript.eu/files/symbols.pdf) riguardante i simboli frequentemente utilizzati in LaTeX.

## Spazi e spazietti
### Typst

In VSCode, con l'estensione di Tinymist, è possibile cercare direttamente simboli dall'editor, sia per nome che disenando il simbolo stesso.

In ogni caso consiglio sempre di fare riferimento alla [documentazione ufficiale di Typst](https://typst.app/docs) dove ogni simbolo può essere cercato anche con il suo nome in LaTeX.

## Spazi e spazietti in LaTeX

[Qua](https://www.sascha-frank.com/spacing.html), invece, troverete una guida su come utilizzare spazi e tab in LaTeX.

## Tabelle LaTeX
## Tabelle

### LaTeX

Su [questo sito](https://www.tablesgenerator.com/latex_tables), troverete un editor di tabelle LaTeX per non impazzire durante la scrittura della vostra tesi.

### Typst

Le tabelle in Typst, al contrario di LaTeX, sono già molto feature complete di base e non richiedono l'uso di [pacchetti esterni](https://typst.app/universe) (che comunque sono disponibili).

Fare riferimento a [questa sezione](https://typst.app/docs/reference/model/table/) della documentazione.

## Bibliografia incasinata?

Utilizzate [questo tool](https://flamingtempura.github.io/bibtex-tidy/) per pulire il vostro BibTeX e formattarlo adeguatamente!

0 comments on commit 78b5d85

Please sign in to comment.