Capitolo 4: Scrivere il tuo primo articolo
I formati TOML, YAML e JSON
Hugo ti consente di utilizzare 3 diverse notazioni di dati nel file di configurazione e nella parte anteriore di ogni pagina di contenuto. TOML, YAML e JSON sono tutti linguaggi popolari che raggiungono lo stesso obiettivo di specificare coppie chiave -> valore. La lingua predefinita per Hugo è TOML, dato che si tratta di uno dei formati file di configurazione più semplice da comprendere e scrivere.
Sintassi TOML
TOML condivide tratti con altri formati di file utilizzati per la configurazione delle applicazioni e la serializzazione dei dati, come YAML e JSON. TOML e JSON sono entrambi semplici e usano tipi di dati onnipresenti, rendendoli facili da codificare o analizzare con le macchine. TOML e YAML enfatizzano entrambi le caratteristiche di leggibilità umana, come i commenti che rendono più facile capire lo scopo di una data linea. TOML differisce nel combinare queste caratteristiche, permettendo commenti (a differenza di JSON) ma preservando la semplicità (a differenza di YAML).
Un qualsiasi parametro in TOML è definito come
nomeParametro = valore
dove nomeParametro è il nome del parametro che vogliamo dare mentre valore rappresenta il dato che si vuole memorizzare. TOML è case-sensitive (nomeVariabile
è diverso da Nomevariabile
). Per semplicità, considerate il linguaggio TOML come una tabella a doppia colonna, la prima rappresenta il nome del parametro mentre la seconda è il valore contenuto.
Alcune avvertenze:
- I valori possono essere
- stringhe – tra apici singoli oppure tra apici doppi, es: “ciao”;
- stringhe composte da più linee – in questo caso si utilizza
"""
all’inizio e alla fine; - numeri – interi, razionali, es: +4, -2, 10e8, ma anche binari (prefisso
0b
), esadecimali (prefisso0o
) o esadecimali (prefisso0x
); - booleani (true/false)
- date (compatibili con RFC 3339 o ISO 8601)
- array (racchiudendo i valori con
[
e]
separati da una virgola, es:[1, 2, "banana"]
); - tabelle
- Non può essere messa più di una variabile su una riga
- Si può commentare, utilizzando
#
- Il nome del parametro può contenere solo lettere ASCII, underscores e trattini (
A-Za-z0-9_-
);
Il formato Markdown
Puoi inserire qualsiasi tipo di file nelle tue cartelle /content
, ma Hugo usa principalmente due tipi di formati: HTML e Markdown. Di seguito una semplice guida su come utilizzare il Markdown.
Titoli
Per