WordPressEscape

Home / Guida

Workbench

Migrare 528.854 pagine WordPress a Hugo: note di ingegneria

Queste sono le note operative del trasferimento di Unlimited Charters, il nostro sito gemello interno, da WordPress a Hugo nel maggio 2026. Il riepilogo dal punto di vista aziendale è disponibile nel case study; qui ci concentriamo sugli aspetti pratici per chi deve eseguire il lavoro: cosa si è rotto a mezzo milione di pagine, quali comandi ci hanno creato problemi e quali controlli eseguiamo ora su ogni sito, grande o piccolo.

6 min di lettura 9 sezioni Pensato per il posizionamento SEO
In questa pagina
  1. Contesto
  2. Inventario dei template prima dei contenuti
  3. Build suddivise e insidie del file system
  4. Correzioni delle performance, applicate come modifica al template più passaggio sull’intero corpus
  5. Impostazioni di Cloudflare che hanno fatto la differenza
  6. Dettagli su schema e SEO
  7. L’acquisizione dei contatti è la parte che non si può perdere
  8. Cosa faremmo diversamente
  9. Fonti e approfondimenti
  10. Domande frequenti
Risposta rapida

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.

01

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.

02

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.

03

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:

  1. 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.
  2. rsync --exclude=index.html esclude ogni index.html a qualsiasi profondità, non solo quello di primo livello. È necessario ancorare il pattern (--exclude=/index.html).
  3. 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.
  4. mv dir/* target/ non funziona a questa scala (elenco degli argomenti troppo lungo). Usare find ... -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/ {} +
'
04

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 con fetchpriority="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.
05

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.
06

Dettagli su schema e SEO

  • Search Console segnalava errori nei dati strutturati perché un’entità Service conteneva aggregateRating e review. 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 con sed ha 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'
07

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.

08

Cosa faremmo diversamente

  1. Disattivare Email Obfuscation prima della prima misurazione del CLS.
  2. Suddividere la build fin dal primo giorno.
  3. Bloccare la directory dei contenuti fin dal primo giorno.
  4. Documentare il modello “modifica al template più passaggio sull’intero corpus” prima della prima correzione, non dopo la quinta.
  5. 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.

09

Fonti e approfondimenti

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.

Scansiona gratis il mio sito

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
Continua a leggere
Tutte le guide33
Ricerche correlatemigrazione da wordpress a hugo528.854 pagine (test interno)build di hugo suddivisacorrezione cls di cloudflarepulizia dello schemacorrispondenza degli url