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 (prefisso 0o) o esadecimali (prefisso 0x);
    • 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