From 09b41ae2b3fd1ec40c786b0b6a6b276b5669ea15 Mon Sep 17 00:00:00 2001 From: Paolo Asperti Date: Fri, 13 Sep 2024 19:45:50 +0000 Subject: [PATCH] Update front matter --- front-matter.md | 74 +++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 68 insertions(+), 6 deletions(-) diff --git a/front-matter.md b/front-matter.md index fd7152f..3cce3c2 100644 --- a/front-matter.md +++ b/front-matter.md @@ -15,7 +15,7 @@ slug: "2024-07-10-evento-di-prova" type: post image: image.png # se non metti un'immagine, viene presa la prima immagine del post image_alt: "Descrizione dell'immagine. Il ratio dell'immagine deve essere 360x250." -image_caption: "Image credits: [BgLUG](https://bglug.it 'Bergamo Linux Users Group website')" +image_caption: "Image credits: [BgLUG](https://bglug.it 'Bergamo Linux Users Group website')" summary: Se non presente, usa il testo dell'articolo tags: - eventi @@ -28,7 +28,6 @@ categories: Esempio di front matter per post in italiano - ```yaml --- title: Cercasi volontari lettura AdaZ @@ -40,7 +39,7 @@ aliases: - /2024/07/03/aaa-volontari-cercasi-per-leggere-adazangemann/ image: banner-manifestazione.png image_alt: "Un'immagine tratta dal libro Ada&Zangemann in cui ritrae delle persone che sono in marcia per manifestare a favore del software libero" -image_caption: "Image credits: [BgLUG](https://bglug.it 'Bergamo Linux Users Group website')" +image_caption: "Image credits: [BgLUG](https://bglug.it 'Bergamo Linux Users Group website')" summary: BgLUG e FabLab Bergamo stanno cercando volontari per promuovere il progetto formativo proposto dalla FSFE rivolto ai bambini delle scuole primarie. categories: - News @@ -48,22 +47,85 @@ categories: --- ``` - ## Elementi comuni ### `title` * Tipo: `testo` * Il titolo della pagina/post. +* Obbligatorio. ### `author` * Tipo: `testo` -* L'autore del post/evento. E' possibile utilizzare markdown, tipicamente per inserire link. +* L'autore del post/evento. E' possibile utilizzare markdown (probabilmente servirà fare escaping con `"`), tipicamente per inserire link. +* Facoltativo. ### `type` * Tipo: `testo` -* Per post ed eventi, usare sempre `post` +* Per post ed eventi, usare sempre `post`. +* Facoltativo. Di default è un `post`. + +### `date` + +* Tipo: `data` +* La data del post/evento. +* Esempio: `date: 2024-07-10T15:30:00+02:00` +* Obbligatorio. + +### `expiryDate` + +* Tipo: `data` +* La data in cui rimuovere il post dal sito. +* Facoltativo. + +### `publishDate` + +* Tipo: `data` +* La data in cui pubblicare il post sul sito. +* Facoltativo. + +### `slug` + +* 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. + +### `draft` + +* Tipo: `booleano` +* Se impostato a `true`, il post non viene pubblicato, ma può essere comunque visibile in locale se si utilizza questo comando: `hugo server -D`. +* Facoltativo. Se non indicato, il post non è una bozza. + +### `summary` + +* 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. + +### `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. + +### `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`. + +### `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`. +