Hwaro è un generatore di siti statici progettato per essere rapido, leggero e altamente estensibile. Scritto in Crystal, punta a offrire un’esperienza di build estremamente veloce grazie all’elaborazione parallela e alla cache incrementale.
Il cuore del sistema è la combinazione tra contenuti Markdown con front matter TOML o YAML e template compatibili con Jinja2 tramite Crinja. Questo approccio permette di creare layout complessi con ereditarietà, inclusioni e macro, mantenendo una sintassi familiare a chi proviene da strumenti come Hugo o Jekyll.
Il supporto alle estensioni Markdown è particolarmente ricco: task list, note a piè di pagina, definizioni, formule matematiche tramite KaTeX o MathJax, diagrammi Mermaid ed emoji. Sono presenti anche shortcode integrati per contenuti multimediali come YouTube, Vimeo, Gist, Figure, Tweet e CodePen, oltre alla possibilità di definire shortcode personalizzati.
La generazione automatica dell’indice dei contenuti, il conteggio delle parole e il tempo di lettura completano un set di strumenti pensato per blog, documentazione tecnica e siti editoriali.
Hwaro gestisce anche contenuti non Markdown, permettendo di pubblicare file statici aggiuntivi senza passaggi manuali. Le funzionalità di gestione includono bozze, post programmati o con scadenza, alias URL, redirect, archetipi per la creazione guidata dei contenuti e file dati accessibili nei template. È possibile ordinare le pagine per peso, data o titolo, oltre a gestire autori e metadati aggregati.
Prestazioni elevate, SEO integrata e strumenti per sviluppatori
Sul fronte delle prestazioni, Hwaro offre build parallele, caching incrementale e una modalità di streaming con limiti di memoria configurabili. Sono disponibili hook pre e post build, bundling e minificazione di CSS e JavaScript, fingerprinting dei contenuti e caricamento lazy delle immagini. Le configurazioni specifiche per ambiente permettono di gestire facilmente produzione, staging e sviluppo.
Per quanto riguarda la SEO, Hwaro genera automaticamente sitemap, robots.txt, feed RSS/Atom, meta tag OpenGraph, immagini OG in PNG, Twitter Cards e JSON‑LD per articoli, FAQ, HowTo, organizzazioni e persone.
Supporta anche canonical URL, hreflang e la creazione di file llms.txt e AGENTS.md. È incluso un motore di ricerca lato client basato su Fuse.js o ElasticLunr, con tokenizzazione CJK.
Tra le funzionalità del sito troviamo tassonomie personalizzabili, paginazione, serie di contenuti, breadcrumb, pagine AMP, supporto multilingua con feed dedicati e strumenti avanzati per l’elaborazione delle immagini, come resize, immagini responsive, placeholder LQIP e estrazione del colore dominante. È presente anche il supporto PWA tramite manifest e service worker.
Lo sviluppo è facilitato da un server integrato con live reload, temi predefiniti per blog e documentazione, strumenti di deploy verso più piattaforme, importazione da WordPress, Jekyll e Hugo, oltre a un link checker e un convertitore di front matter. Hwaro si presenta così come una soluzione completa e moderna per chi cerca un generatore di siti statici veloce, potente e altamente personalizzabile su Linux.
Installare Hwaro
Hwaro è disponibile per Linux, oltre al codice sorgente, con binari precompilati che ci consentono di avviare il tool direttamente senza installazione, inoltre viene rilasciato con pacchetti deb per Ubuntu, Debian e derivate.
Abbiamo testato Hwaro su Debian 13.4 (immagini articolo).
