In questa pagina
- Contesto
- Inventario dei template prima dei contenuti
- Build suddivise e insidie del file system
- Correzioni delle performance, applicate come modifica al template più passaggio sull’intero corpus
- Impostazioni di Cloudflare che hanno fatto la differenza
- Dettagli su schema e SEO
- L’acquisizione dei contatti è la parte che non si può perdere
- Cosa faremmo diversamente
- Fonti e approfondimenti
- Domande frequenti
A questa scala, i problemi riguardano più il file system e i processi che Hugo: suddividere le build, mantenere i contenuti archiviati fuori dal punto di mount dei contenuti di Hugo, non eseguire mai due processi di spostamento sulla stessa directory e trattare ogni correzione come una modifica al template più un passaggio automatizzato sull’intero corpus. I miglioramenti di performance più significativi sono stati l’impostazione delle dimensioni delle immagini, il CSS critico sincrono, un’immagine LCP non caricata in lazy loading, un widget per i preventivi caricato in differita con spazio riservato e la disattivazione di Cloudflare Email Obfuscation.
Contesto
Unlimited Charters appartiene allo stesso gruppo di WordPressEscape; questa è stata una nostra migrazione di prova, eseguita con accesso completo al server. Il sito aveva poco più di mezzo milione di URL, soprattutto pagine di località generate da template, oltre a pagine hub, pagine della flotta e un blog. L’obiettivo era una build Hugo servita come file statici dietro Cloudflare, mantenendo invariato ogni percorso esistente.
Inventario dei template prima dei contenuti
Abbiamo iniziato raggruppando gli URL in base al template WordPress che li generava, non in base allo schema degli URL. Per ogni famiglia abbiamo preso una decisione: ricostruirla come layout Hugo oppure, per il momento, servirne uno snapshot statico dell’output WordPress. Ricostruire prima le famiglie con più traffico e usare snapshot per le pagine anomale ci ha permesso di procedere senza rimanere bloccati sulla lunga coda di pagine personalizzate.
Un dettaglio importante: in WordPress il percorso dell’URL non corrisponde sempre allo slug post_name. Le pagine gerarchiche, le regole di rewrite personalizzate e le vecchie importazioni producevano percorsi diversi dallo slug; per questo il percorso doveva essere ricavato dal crawl, non dal database.
Build suddivise e insidie del file system
Generare tutte le pagine in un’unica esecuzione era lento e rendeva costosa ogni piccola modifica. Abbiamo suddiviso il processo: spostare in un archivio i file sorgente che non stavamo compilando, generare un sottoinsieme, pubblicarlo e ripristinare i file. Quattro insidie ci hanno fatto perdere tempo:
- L’archivio deve trovarsi fuori dal punto di mount dei contenuti di Hugo. Se si trova in una posizione qualsiasi all’interno della directory dei contenuti montata, Hugo continua a eseguire la scansione di ogni file e la suddivisione non porta alcun vantaggio.
rsync --exclude=index.htmlesclude ogni index.html a qualsiasi profondità, non solo quello di primo livello. È necessario ancorare il pattern (--exclude=/index.html).- Due processi di spostamento simultanei sulla stessa directory la annidano. Due processi di ripristino in competizione hanno prodotto circa 367.000 directory a un livello di profondità eccessivo. La produzione funzionava perché serviva l’output già generato; un singolo spostamento automatizzato ha riportato tutto alla struttura corretta. La directory deve essere gestita da un solo processo, imposto tramite un lock.
mv dir/* target/non funziona a questa scala (elenco degli argomenti troppo lungo). Usarefind ... -exec mv -t target {} +.
# genera alcune pagine senza ricostruire tutto
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # archivio FUORI dal punto di mount dei contenuti
for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
hugo --minify -d ../staged
find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'Correzioni delle performance, applicate come modifica al template più passaggio sull’intero corpus
Ogni correzione aveva due componenti: correggere il template Hugo affinché le build future fossero corrette e modificare l’HTML già generato per poterla distribuire senza una ricostruzione completa. Le modifiche più importanti sono state:
- Dimensioni delle immagini. Un template impostava in modo fisso
width="1600" height="700", mentre il CSS utilizzava un rapporto d’aspetto diverso. Abbiamo corretto il problema su 527.815 pagine. Larghezza e altezza devono corrispondere al rapporto d’aspetto visualizzato, altrimenti il browser riserva uno spazio errato (ottimizzazione del CLS). - Regole aspect-ratio in conflitto sullo stesso selettore in due fogli di stile; le abbiamo accorpate in una sola.
- CSS critico nel file asincrono. Le regole mobile necessarie per il primo rendering si trovavano in un foglio di stile caricato in differita, causando un ricalcolo tardivo del layout. Le abbiamo spostate nel foglio di stile sincrono.
- Hero caricata in lazy loading. L’attributo
loading="lazy"sull’immagine above-the-fold ritardava l’LCP; lo abbiamo sostituito confetchpriority="high"(ottimizzazione dell’LCP). - Immagini LCP sovradimensionate sostituite con varianti più piccole, con un risparmio compreso tra 50 e 440 KB per pagina.
- Widget per i preventivi caricato alla prima interazione, con un fallback temporizzato; il contenitore riserva 480 px (560 px su mobile). Prima, il suo inserimento spostava la pagina causando un CLS di circa 0,54.
Impostazioni di Cloudflare che hanno fatto la differenza
- Email Obfuscation disattivato. Il suo decoder analizza il DOM dopo il caricamento e riscrive i link email, causando uno spostamento del layout. È stata la fonte di CLS più persistente che abbiamo trovato.
- Rocket Loader disattivato. Riordinava gli script e interferiva con il caricamento in differita.
- Svuotamento della cache dopo la pubblicazione. Le cache edge conservavano il vecchio HTML; svuotare la cache per percorso dopo ogni pubblicazione ha evitato di servire pagine obsolete (documentazione di Cloudflare sullo svuotamento della cache).
- Misurare la produzione, non lo staging. Uno staging senza le stesse impostazioni Cloudflare produceva punteggi di laboratorio diversi da quelli della produzione.
Dettagli su schema e SEO
- Search Console segnalava errori nei dati strutturati perché un’entità Service conteneva
aggregateRatingereview. Li abbiamo rimossi invece di cercare di renderli validi: il markup deve riflettere i contenuti visibili agli utenti (linee guida sui dati strutturati). - Inizialmente i post del blog venivano generati con il template delle località e ereditavano il tipo di schema sbagliato. Ora ogni template dichiara la propria entità.
- 35 percorsi incoerenti della flotta e dei servizi hanno ricevuto reindirizzamenti permanenti verso le pagine nidificate corrette (reindirizzamenti).
- I contenuti multimediali sono stati spostati da
/wp-content/uploads/a/uploads/con un’unica regola 301; un passaggio parallelo consedha riscritto 528.852 file su 528.854 in pochi minuti. - Yoast è stato rimosso una volta che Hugo ha iniziato a generare sitemap, schema, meta tag e robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'L’acquisizione dei contatti è la parte che non si può perdere
Il modulo per i preventivi è il modo in cui il sito genera ricavi, quindi ha richiesto controlli dedicati: il punto di mount del widget deve essere presente nell’HTML generato di ogni pagina che lo utilizza, i nomi dei campi devono corrispondere a quelli previsti dall’endpoint di raccolta e una pubblicazione che sostituisce una directory non deve eliminare la pagina autonoma dei preventivi. Un passaggio online che elimina silenziosamente l’acquisizione dei contatti può sembrare riuscito sotto ogni metrica SEO, mentre l’azienda perde richieste.
Cosa faremmo diversamente
- Disattivare Email Obfuscation prima della prima misurazione del CLS.
- Suddividere la build fin dal primo giorno.
- Bloccare la directory dei contenuti fin dal primo giorno.
- Documentare il modello “modifica al template più passaggio sull’intero corpus” prima della prima correzione, non dopo la quinta.
- Inserire il controllo dei dati sul campo (CrUX) nella checklist di lancio, perché i punteggi di laboratorio sullo staging non rappresentano la produzione.
La prospettiva aziendale dello stesso progetto, incluso ciò che abbiamo lasciato su WordPress, è disponibile nel case study.
Fonti e approfondimenti
Documentazione primaria utilizzata per questa guida. I link sono stati verificati l’11 novembre 2026.
- Documentazione Hugo: guida rapida
- Documentazione Hugo: gestione degli URL (permalink e alias)
- web.dev: ottimizzare il Cumulative Layout Shift
- web.dev: ottimizzare il Largest Contentful Paint
- web.dev: Cumulative Layout Shift (CLS)
- Documentazione Cloudflare: svuotare la cache
- Documentazione Cloudflare: cache
- Google Search Central: introduzione ai dati strutturati
- Google Search Central: reindirizzamenti e Google Search
- Google Search Central: trasferimenti di sito con modifiche agli URL
- Documentazione Chrome UX Report (CrUX)
Domande frequenti
Si tratta della migrazione di un cliente?
No. Unlimited Charters è un sito gemello interno appartenente allo stesso gruppo di WordPressEscape. È il nostro caso di prova.
Hugo gestisce mezzo milione di pagine?
Sì, ma le ricostruzioni complete sono abbastanza lente da rendere importanti le build suddivise e una gestione attenta dei file. La maggior parte dei problemi riguardava il file system e i processi, non bug di Hugo.
Che cosa ha causato il peggior spostamento del layout?
Il widget per i preventivi, inserito senza spazio riservato (circa 0,54 di CLS sulle pagine hub), e Cloudflare Email Obfuscation, che riscriveva la pagina dopo il caricamento.
Queste lezioni valgono anche per i siti piccoli?
Sì. Gli stessi controlli - corrispondenza degli URL, dimensioni delle immagini, CSS critico, immagine hero non caricata in lazy loading e widget caricati in differita - valgono per un sito di 40 pagine; vengono semplicemente eseguiti in pochi minuti anziché in ore.
Scopri se il tuo sito è idoneo allo stesso trattamento
L’audit gratuito di 60 secondi mostra il tuo punteggio PageSpeed reale, il numero esatto di pagine, le lacune SEO e le funzionalità WordPress che devi sostituire. Poi WordPressEscape ricostruisce il sito con Hugo, conserva tutti gli URL e ti consegna il codice sorgente fin dal primo giorno - proprio come abbiamo fatto con UC.
Scansiona gratis il mio sito

