Update front matter

Paolo Asperti 2024-09-13 19:57:32 +00:00
parent 6cdb84d006
commit e84c7f44a9

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