diff --git a/front-matter.md b/front-matter.md index 6928d12..8986f69 100644 --- a/front-matter.md +++ b/front-matter.md @@ -47,7 +47,7 @@ categories: --- ``` -## Elementi comuni +## Opzioni disponibili ### `title` @@ -71,8 +71,8 @@ categories: * Tipo: `data` * La data del post/evento. -* Esempio: `date: 2024-07-10T15:30:00+02:00` * Obbligatorio. +* Esempio: `date: 2024-07-10T15:30:00+02:00` ### `expiryDate` @@ -90,13 +90,18 @@ categories: * Tipo: `testo` * E' la parte dell'URL che viene dopo `https://bglug.it/it/posts/[anno]/[mese]/` oppure dopo `https://bglug.it/it/eventi/[anno]/[mese]/` nel caso degli eventi. -* Esempio: `2024-resoconto-linuxday` * Facoltativo, ma consigliato. Se non indicato, viene generato dal titolo. +* Esempio: + +```yaml +slug: 2024-resoconto-linuxday +``` ### `aliases` * Tipo: `array di testo` * E' un elenco di URL alternative (interne al sito) che reindirizzeranno allo `slug`. Si usa per non perdere url già ben indicizzate e tendenzialmente non serve sulle nuove pagine. +* Facoltativo * Esempio: ```yaml @@ -105,9 +110,6 @@ aliases: - /en/previous-url ``` -* Facoltativo - - ### `draft` * Tipo: `booleano` @@ -118,29 +120,54 @@ aliases: * Tipo: `testo` * E' l'introduzione che viene visualizzata in modalità "lista", o in homepage. -* Esempio: `summary: Come ogni aprile di ogni anno pari, è uscita una nuova ubuntu, e l'abbiamo provata.` * Facoltativo, ma consigliato. Se non indicato, viene generato dal testo del post. +* Esempio: + +```yaml +summary: Come ogni aprile di ogni anno pari, è uscita una nuova ubuntu, e l'abbiamo provata. +``` ### `image` * Tipo: `testo` * Indicare il nome del file da usare come immagine principale del post/evento. Il file deve trovarsi nella directory del post/evento. Usare un formato raster, come `.jpg` o `.png`. -* Esempio: `image: pinguino.png` * Facoltativo, ma consigliato. Se non indicato, in visualizzazione "lista" viene utilizzato un placeholder, mentre in visualizzazione singola semplicemente non viene visualizzata. +* Esempio: + +```yaml +image: pinguino.png +``` ### `image_alt` * Tipo: `testo` * Indicare il testo alternativo per l'immagine. Il testo alternativo è utilizzato soprattutto per l'accessibilità, quindi inserire una descrizione succinta e specifica. -* Esempio: `image_alt: Un pinguino reale usa una vulnerabilità di Windows per ottenere una reverse shell` * Obbligatorio se è presente `image`. +* Esempio: + +```yaml +image_alt: Un pinguino reale usa una vulnerabilità di Windows per ottenere una reverse shell +``` ### `image_caption` * Tipo: `testo` * Indicare la didascalia da visualizzare sotto l'immagine. Qui è dove si inseriscono i credits (attribution) e la licenza. E' possibile utilizzare markdown (probabilmente servirà fare escaping con `"`), tipicamente per inserire link. -* Esempio: `image_caption: "Image by [BgLUG](https://bglug.it 'Bergamo Linux Users Group website') licensed via [CC BY-NC-SA 2.0](https://creativecommons.org/licenses/by-nc-sa/2.0/)"` * Obbligatorio se è presente `image`. +* Esempio: +```yaml +image_caption: "Image by [BgLUG](https://bglug.it 'Bergamo Linux Users Group website') licensed via [CC BY-NC-SA 2.0](https://creativecommons.org/licenses/by-nc-sa/2.0/)" +``` +### `tags` +* Tipo: `array di testo` +* Indicare le tags che fanno riferimento a questo post/evento. Solo per i post della sezione `linuxday` è possibile usare la tag `linuxday-featured` per inserire il post nella sidebar. +* Facoltativo. + +### `categories` + +* Tipo: `array di testo` +* Indicare le categorie che fanno riferimento a questo post/evento. +* Facoltativo.