La gestione delle immagini con ox-hugo

Immagine con shortcode manuale (sconsigliato)

Invece di usare la sintassi di Emacs/Org, si può usare lo shortcode diretto, ma così facendo devo inserire manualmente l’immagine nella directory static. È possibile usare codice markdown nella didascalia (caption).

{{< figure src="/images/inline/demo-immagini-hugo-shortcode-manuale.jpg"
    link="/images/inline/demo-immagini-hugo-shortcode-manuale.jpg"
    alt="Alt"
    title="titolo"
    caption="Didascalia che può contenere **markdown**"
>}}

Gestione immagini inline e immagini featured

Le immagini inline e le featured image le metto nella stessa directory del file con estensione org o in una sotto-directory specifica. Quelle inline le scrivo così:

#+ATTR_HTML: :title Titolo immagine :alt Testo alternativo
#+CAPTION: Didascalia della immagine
[[file:images/oxhugo-orgmode-esempio.jpg]]

Ecco qui un esempio:

Attenzione, prima della riga della caption e non dopo va messo il campo #+ATTR_HTML: con gli attributi :title ed :alt. Inserendo le varie caption, queste sono numerate automaticamente.

Qui di seguito lo stesso esempio di prima ma senza gli attributi title e alt:

Mentre le immagini “featured”, ovvero quelle usate come immagine principale dell’articolo, le inserisco nei meta dati all’inizio del file e poi le devo copiare a mano su /static/featured/ fintanto che non si chiude il seguente bug:

• Copy image to static when referenced in custom front matter

In definitiva la gestione delle immagini con oxhugo è semplice e molto flessibile. Grazie ad una sintassi estremamente semplice si riescono ad inserire le immagini senza sforzo.