diff --git a/README.md b/README.md index 101d564..52f4395 100644 --- a/README.md +++ b/README.md @@ -15,16 +15,16 @@ procedi con l'usuale login per i servizi di Ateneo. ### Editare file Per potere modificare i file, è necessario chiedere ai Macchinisti di aggiornare -i permessi del proprio account, passando in PHC o mandando una mail. +i permessi del proprio account, passando in PHC o per 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 (se non esiste puoi utilizzare uno degli altri come template o -chiedi ai macchinisti), ad esempio quello relativo al corso di aritmetica è -`aritmetica.md`. +tuo tutorato (se non esiste puoi crearlo usando uno degli altri come template), +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). +in alto a destra (se non risulta cliccabile, contatta i macchinisti per farti +dare l'accesso). #### Scrivere in LaTeX @@ -34,28 +34,28 @@ ed è possibile scrivere in LaTeX tramite KaTeX, il quale supporta molti degli usuali environments di LaTeX come, ad esempio `$...$` o `\(...\)` per l'ambiente _inline_ oppure `$$...$$` o `\[...\]` per _display_. -Per famigliarizzarti con scrivere LaTeX in Markdown, vedi +Per familiarizzarti 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). +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 +questo punto puoi aggiungere un link alla pagina come ad esempio ``` Tutorato del [13 ottobre 2023](/materiale/TutoratoAnalisi13102023.pdf). ``` -> **Nota**: Il nome del file non deve contenere spazi o caratteri speciali, usa -> `_` o `-` al posto degli spazi. +**Nota**: Il nome del file non deve contenere spazi o caratteri speciali, usa +`_` 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 +È anche possibile editare i file in locale sulla propria macchina, 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).