Page:
front matter
Pages
Home
ToDo
branch
chiavi SSH
come aggiungere un warning
creazione tag live nellupstream
diff
fare il rebase
front matter
hugo lazyboy
hugo new manualmente
hugo new
image credits
link guide
merge
operazioni fondamentali
prova con immagine
pull request
regole d oro
relref
spostare commit
struttura content
Clone
15
front matter
Paolo Asperti edited this page 2024-09-30 17:28:44 +00:00
Table of Contents
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 dopohttps://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/)"
location_link
(usare solo per eventi)
- 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 taglinuxday-featured
per inserire il post nella sidebar. - Facoltativo.
Come contribuire usando Gitea
Comandi hugo e struttura del sito
- Contribuire dal BROWSER
- Contribuire da LOCALE
- I'm a lazy boy
- Cartella content e permalink
- Front matter
- Note sull'utilizzo di media
- Inviare una PR
- Aggiungere warning in homepage
Comandi GIT
Guide online