DocSteer è un tema Jekyll per documentazione tecnica, portali di supporto e knowledge base: ricerca live, sei skin con tema chiaro e scuro, indice automatico, lightbox e SEO. Senza framework, MIT, pubblicato come gem.
Jekyll 4, bilingue IT/EN, via Bootstrap e jQuery: come ho rifatto da zero un piccolo tool di conversione IPUI→IPEI usando lo stesso schema appena rodato sul sito principale.
La ricerca del blog cercava solo in titolo e descrizione, ignorava le pagine statiche e non capiva le query a più parole. Come l'ho resa migliore senza librerie esterne.
Un breadcrumb con dati strutturati per Google, la riga data/lettura riposizionata e un post in evidenza in cima al blog — con una lezione su come non ritagliare una cover.
Un menu che non portava dove prometteva, bottoni di condivisione rotti, un box commenti che si rompeva al primo caricamento e altre rifiniture necessarie prima di andare online.
Come una richiesta semplice — una cover con lo screenshot del vecchio e nuovo sito — diventa un rabbit hole tra browser headless e un trucco CSS per adattarsi al tema.
Cinque bug scoperti dopo il lancio del nuovo sito: non debito tecnico ereditato, ma difetti nati lo stesso pomeriggio. Cascata CSS, rate limit di GitHub e un bug di Jekyll.
Dalla manutenzione di un sito Jekyll del 2019 alla decisione di ricostruirlo da zero in poche ore, insieme a Claude Code: come è nata la versione 2.0 del sito.
Cosa succede aggiornando sul serio, per la prima volta dal 2019, le dipendenze di un sito Jekyll: tre bug dormienti e un tema con la libreria sbagliata da anni.