15
front matter
Paolo Asperti edited this page 2024-09-30 17:28:44 +00:00

Qui trovi l'ultima versione degli archetipi.

Front matter: evento

Esempio di front matter per evento in italiano

---
title: "2024 07 10 Evento Di Prova"
date: 2024-07-17T21:00:00+02:00
duration: 1h30m
publishDate:  2024-07-10T13:54:43+02:00
draft: true # false se vuoi che venga pubblicato
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')"
summary: Se non presente, usa il testo dell'articolo
location_link: "[fablab bergamo](https://www.fablabbergamo.it/)"
location_ics: FabLab Bergamo - via Mauro Gavazzeni, 3 - Bergamo
add_to_ics: true
locations: fablab
tags:
  - prova
  - hugo
  - altro
---

E' importante che la data di pubblicazione (publishDate) sia indicata e sia antecedente alla data dell'evento (date).

Front matter: post

Esempio di front matter per post in italiano

---
title: Cercasi volontari lettura AdaZ
author: pippo
type: post
date: 2024-07-03T16:04:23+00:00
slug: volontari-lettura-adaz
aliases:
  -  /2024/07/03/aaa-volontari-cercasi-per-leggere-adazangemann/
image: banner-manifestazione.png # se non metti un'immagine, viene presa la prima immagine del post
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')"
summary: BgLUG e FabLab Bergamo stanno cercando volontari per promuovere il progetto formativo proposto dalla FSFE rivolto ai bambini delle scuole primarie.
tags:
  - news
---

Opzioni disponibili

title

  • Tipo: testo
  • Il titolo della pagina/post.
  • Obbligatorio.

author

  • Tipo: testo
  • 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.
  • Facoltativo. Di default è un post.

date

  • Tipo: data
  • La data del post/evento.
  • Obbligatorio.
  • Esempio:
date: 2024-07-10T15:30:00+02:00

duration (solo per pubblicazione ics)

  • Tipo: duration
  • La durata dell'evento. Viene utilizzata nella generazione del calendario ICS. E' una stringa di testo composta da numeri e unità di misura (h, m, s, ms, us oppure µs, ns), come da esempio sotto.
  • Fortemente consigliato per gli eventi/post pubblicati su ics, ignorato altrimenti. Se omesso, si considera 1 ora.
  • Esempio:
duration: 2h27m

expiryDate

  • Tipo: data
  • La data in cui rimuovere il post dal sito.
  • Facoltativo. Probabilmente non lo useremo mai.

publishDate

  • Tipo: data
  • La data in cui pubblicare il post sul sito.
  • Facoltativo per i post, obbligatorio per gli eventi futuri.

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.
  • Facoltativo, ma consigliato. Se non indicato, viene generato dal titolo.
  • Esempio:
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:
aliases:
  - /it/url-precedente
  - /en/previous-url

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.
  • Facoltativo, ma consigliato. Se non indicato, viene generato dal testo del post.
  • Esempio:
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.
  • Facoltativo, ma consigliato. Se non indicato, in visualizzazione "lista" viene utilizzato un placeholder, mentre in visualizzazione singola semplicemente non viene visualizzata.
  • Esempio:
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.
  • Obbligatorio se è presente image.
  • Esempio:
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.
  • Obbligatorio se è presente image.
  • 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/)"
  • Tipo: testo
  • Descrive dove si svolge l'evento. Anche se è possibile usare del testo semplice, è meglio usare il formato markdown per creare un link che indichi la location. Questo è quello che compare sulla pagina web dell'evento.
  • Obbligatorio per gli eventi.
  • Esempio:
location_link: "[fablab bergamo](https://www.fablabbergamo.it/)"

locations (usare solo per eventi)

  • Tipo: array di testo
  • Indicare le tag location usate per raggruppare gli eventi. Normalmente ne serve solo una, ma è possibile indicare tutte quelle necessarie.
  • Obbligatorio per gli eventi.
  • Esempi:
locations: fablab
locations:
  - fablab
  - aeroporto

location_ics (usare solo per eventi)

  • Tipo: testo
  • E' la location indicata nel calendario ICS per l'evento. Se omessa, viene usata il primo elemento di locations.
  • Facoltativo.

add_to_ics

  • Tipo: booleano
  • Impostare a true per pubblicare l'evento o il post sul calendario ics.
  • Facoltativo.

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.