diff --git a/README.md b/README.md index 67721b5..0bee362 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,16 @@ # Sito Tutorato Matematica -Questo sito è realizzato in Astro e serve come supporto per il tutorato di matematica del corso di laurea in Matematica dell'Università di Pisa. +Questo sito è realizzato in Astro e serve come supporto per il tutorato di +matematica del corso di laurea in Matematica dell'Università di Pisa. ## Per i Tutor ### Accedere a Gitea -Collegati a [Gitea](https://git.phc.dm.unipi.it/) e clicca sul tasto Sign in. Nella finestra clicca su -Sign in With Google, e successivamente scrivi il tuo indirizzo email di ateneo -(ad esempio, `nome.cognome@studenti.unipi.it`), poi procedi con l'usuale login per i servizi di Ateneo. +Collegati a [Gitea](https://git.phc.dm.unipi.it/) e clicca sul tasto Sign in. +Nella finestra clicca su Sign in With Google, e successivamente scrivi il tuo +indirizzo email di ateneo (ad esempio, `nome.cognome@studenti.unipi.it`), poi +procedi con l'usuale login per i servizi di Ateneo. ### Editare file @@ -16,40 +18,45 @@ Per potere modificare i file, è necessario chiedere ai Macchinisti di aggiornar i permessi del proprio account, passando in PHC o mandando una mail. Entra nel [repository](https://git.phc.dm.unipi.it/phc/tutorato) e raggiungi la -cartella `src/pages/archivio/[Anno corrente]`. Qui troverai il file -relativo al tuo tutorato (o se non esiste, chiedi ai macchinisti), ad esempio -quello relativo al corso di aritmetica è "aritmetica.md". +cartella `src/pages/archivio/[Anno corrente]`. Qui troverai il file relativo al +tuo tutorato (o se non esiste, chiedi ai macchinisti), ad esempio quello +relativo al corso di aritmetica è "aritmetica.md". Cliccando sul file è possibile aprire l'editor di testo cliccando sulla matita in alto a destra (se tale icona non risulta cliccabile, contatta i macchinisti). #### Scrivere in LaTeX -Il file del tutorato è in formato Markdown ([Guida alla sintassi Markdown](https://www.markdownguide.org/basic-syntax/)), +Il file del tutorato è in formato Markdown +([Guida alla sintassi Markdown](https://www.markdownguide.org/basic-syntax/)), ed è possibile scrivere in LaTeX tramite KaTeX, il quale supporta molti degli -usuali environments di LaTeX come, ad esempio `$...$` o `\(...\)` per ambiente _inline_ oppure `$$...$$` o `\[...\]` per _display_. +usuali environments di LaTeX come, ad esempio `$...$` o `\(...\)` per ambiente +_inline_ oppure `$$...$$` o `\[...\]` per _display_. -Per famigliarizzarti con scrivere LaTeX in Markdown, vedi [la pagina di esempio](https://git.phc.dm.unipi.it/phc/tutorato/src/commit/b04d9eafda86b21375e1f9a0e672f47d0e222eca/src/pages/archivio/2024-2025/esempio.md) -e [la lista dei simboli supportati da KaTeX](https://katex.org/docs/support_table). +Per famigliarizzarti con scrivere LaTeX in Markdown, vedi +[la pagina di esempio](https://git.phc.dm.unipi.it/phc/tutorato/src/commit/b04d9ea/src/pages/archivio/2024-2025/esempio.md) +e +[la lista dei simboli supportati da KaTeX](https://katex.org/docs/support_table). #### Caricare files -È anche possibile includere link di files nella pagina, spostandosi nella cartella -`public/materiale/` e poi cliccando sul menu a tendina "_Add File_". -A questo punto puoi aggiungere un link alla pagina come +È anche possibile includere link di files nella pagina, spostandosi nella +cartella `public/materiale/` e poi cliccando sul menu a tendina "_Add File_". A +questo punto puoi aggiungere un link alla pagina come ``` Tutorato del [13 ottobre 2023](/materiale/TutoratoAnalisi13102023.pdf). ``` -> **Nota**: Il nome del file non deve contenere spazi o caratteri speciali, usare `_` o `-` al posto degli spazi. +> **Nota**: Il nome del file non deve contenere spazi o caratteri speciali, +> usare `_` o `-` al posto degli spazi. ### Editing da locale -È anche possibile editare i file da locale con il proprio editor clonando il repository -tramite git e facendo push/pull degli aggiornamenti. Per interagire con Gitea in -questo modo, la configurazione è analoga a quella di altri servizi come Github -o Gitlab (in caso di problemi, contattare i macchinisti). +È anche possibile editare i file da locale con il proprio editor clonando il +repository tramite git e facendo push/pull degli aggiornamenti. Per interagire +con Gitea in questo modo, la configurazione è analoga a quella di altri servizi +come Github o Gitlab (in caso di problemi, contattare i macchinisti). ## Preview in locale / Development