Appunti

Visita il sito per consultare gli appunti: https://appunti.titilda.org

Aggiungere appunti

Puoi aggiungere nuovi appunti in formato Markdown (con $\TeX$) rispettando la filename/directory structure esistente. GitHub Actions è configurato per renderizzarli in HTML automaticamente usando Pandoc, generare una pulitissima pagina di indice con Bootstrap CSS, e caricarli sul sito GitHub Pages assieme al magnifico CSS custom presente su questo repo (cortesia di @etabeta1 🙌).

Per il commit, costruire il messaggio come indicato qui.

NOTA: se vuoi apportare modifiche al repository senza lanciare un CI workflow (i.e. senza ri-renderizzare tutto), è sufficiente includere nel Commit Message il comando [skip ci].

Metadati

All'interno degli appunti è possibile aggiungere dei metadati.

Al momento i metadati supportati sono i seguenti

1. title
2. author
3. date (a partire dal 24 dicembre 2023 non è più necessario aggiungere manualmente la data di ultima modifica in quanto viene presa autimaticamente dalla data dell'ultimo commit per ciascun file)

Per aggiungere tali metadati ad un file markdown, è sufficiente aggiungere le seguenti righe al suo inizio:

---
title: "Titolo"
author:
- "Autore 1"
- "Autore 2"
---

E' possibile inserire riquadri colorati simili ai callout di Obsidian tramite l'utilizzo dei fenced divs:

::: {.callout .callout-<_type_> title="Titolo del callout"}
Contenuto
:::

type può assumere uno dei seguenti valori:

• definition
• example
• note
• property

Nel caso in cui a type venga assegnato un valore non previsto, il callout apparirà bianco con bordo nero e senza icona mentre un messaggio di errore verrà stampato nella console del browser.

Per esempi dell'utilizzo dei callouts, vedere il riassunto di fondamenti di ricerca operativa nel quale ne è stato fatto abbondante uso.