Update front matter

Paolo Asperti 2024-09-13 19:45:50 +00:00
parent e6b8700c3c
commit 09b41ae2b3

@ -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`.