HCL

Ovunque slides legga YAML, legge anche la sintassi nativa di HCL2 — per le sue espressioni e le sue funzioni.

I commenti-direttiva (<!-- class: invert -->) restano YAML, come in Marp, e il corpo della presentazione resta un template Go.

Un front matter in HCL

---hcl
theme    = "gaia"
paginate = true
title    = "Quarterly review"
data = {
  company = "ACME"
  quarter = 3
}
header = format("%s — Q%d", data.company, data.quarter)
footer = "${upper(data.company)} · ${page()}/${total()}"
date   = formatdate("D MMMM YYYY", now())

kind "chapter" {
  extends = "section"
  class   = ["lead", "invert"]
}
---

# {{ .title }}

• Gli attributi sono le chiavi YAML con gli stessi nomi: le direttive di Marp (theme, paginate, header, footer, class, backgroundColor…), i metadati (title, author…), template, delims, kinds (percorsi di file) e data, un oggetto.
• I blocchi kind "<name>" { … } definiscono i kinds, con le direttive locali e extends.
• I valori arrivano alle direttive nelle forme stringa che dà loro YAML — true diventa "true", un elenco di classi resta un elenco — così una direttiva si comporta allo stesso modo con qualunque sintassi sia stata impostata. null lascia una direttiva non impostata.
• data mantiene i suoi tipi: nei template un numero intero è un int, gli altri numeri un float64, mentre elenchi e oggetti restano liste e mappe, quindi {{ add .quarter 1 }} funziona.
• Un valore HCL è definitivo: i template Go non vengono eseguiti su di esso una seconda volta.

Variabili

data sono i dati del template: il data del front matter, sovrapposto da quello di slides.hcl, dai file --data e da --set. "${data.company}" funziona ovunque funzionerebbe {{ .company }}.

Gli attributi del front matter possono fare riferimento a data.* ma non l’uno all’altro: footer = title è un errore. Le direttive spot (_class…) non sono identificatori HCL; scrivile in un commento.

Funzioni

Tutte tranne le prime quattro righe fanno parte della libreria standard di go-cty. Nessuna accede alla rete.

slides.hcl

kinds  = "kinds.hcl"          # or a list of files
themes = ["themes/acme.css"]
data   = { company = "ACME" } # or file paths
html   = false
lang   = "en"

kind "quote" {
  extends = "blank"
  footer  = "${data.company}"
}

Un attributo sconosciuto è un errore, non un’operazione ignorata in silenzio. Un file di kinds contiene blocchi kind; i suoi altri attributi vengono ignorati, quindi slides.hcl può servire da file di kinds. Gli attributi di un file di dati sono le chiavi dei dati:

# data.hcl
company = "ACME"
year    = 2026
motto   = trimspace(file("motto.txt"))

Errori

Gli errori sono le diagnostiche di HCL, posizionate nel file stesso della presentazione: footer = data.compnay alla quarta riga della presentazione produce

deck.md:4:14: Unsupported attribute: This object does not have an attribute named "compnay".

Marp e slides expand

Anche Marp legge ---hcl come inizio di un front matter — la sua regola sul front matter si apre su qualsiasi prima riga che inizi con tre trattini — e, dato che il blocco non è una mappa YAML, non ne applica nulla: la presentazione viene comunque resa in Marp, ma senza le sue direttive. Un test lo verifica rispetto all’output di Marp Core.

slides expand riscrive il front matter come YAML, quindi la presentazione espansa è Marp semplice e viene resa come slides rende l’originale:

---
theme: "gaia"
paginate: true
title: "Quarterly review"
header: "ACME — Q3"
footer: "ACME · 1/2"
date: "19 October 2026"
---

Licenze

Il supporto HCL collega hashicorp/hcl (MPL-2.0, usato senza modifiche come libreria) e zclconf/go-cty (MIT).