Blog

Controllo di ogni traduzione prima che venga scritta

Segnaposto, tag di markup, ogni forma plurale CLDR e sintassi ICU: cosa controlla localize.dev in ogni traduzione automatica e cosa succede a una che fallisce.

Stephen Ufort · 3 novembre 2026 · 3 min di lettura

La schermata di accesso del Pages CMS in inglese, spagnolo, arabo da destra a sinistra e cinese

La traduzione automatica fallisce in modi che un revisore spesso non nota. Un segnaposto viene tradotto, quindi {name} diventa {nombre} e l'app mostra le parentesi graffe. Una forma plurale ritorna con due forme per una lingua che ne necessita quattro. Una parentesi graffa vagante scivola in una frase persiana e la libreria i18n genera un errore quando tenta di renderizzarla.

localize.dev controlla ogni traduzione rispetto alla sua origine prima di scriverla in un file di localizzazione. Questo post esamina ogni controllo, utilizzando casi dalla suite di test.

Segnaposto: nessuno aggiunto, nessuno perso

Ogni {placeholder} nella sorgente deve essere nella traduzione, invariato, e la traduzione non può aggiungerne uno che la sorgente non ha. Il controllore segnala esattamente cosa è andato storto:

test/validate.test.ts
translationProblem('Hi {name}', 'Hola', 'es', opts);
// → 'it lost {name}'

translationProblem('Hi {name}', 'Hola {nombre}', 'es', opts);
// → "it has {nombre}, which the source doesn't"

C'è un'eccezione. In un messaggio plurale, la forma one può omettere {count}, perché molte lingue dicono "un file" come parola invece di "1 file".

Ogni forma plurale di cui la lingua ha bisogno

L'inglese ha due forme plurali, one e other. Il polacco ne ha quattro, l'arabo sei e il giapponese una. Le forme di cui una lingua ha bisogno provengono da Intl.PluralRules, i dati CLDR integrati in JavaScript, quindi non è mai un elenco gestito manualmente.

test/validate.test.ts
const source = { one: '{count} file', other: '{count} files' };

translationProblem(source, { one: '{count} plik', other: '{count} pliku' }, 'pl', opts);
// → 'no "few", "many" form'

translationProblem(source, { other: '{count}個のファイル' }, 'ja', opts);
// → null (Japanese needs only "other")

Quando la sorgente ha una forma =0 esatta ("Nessun file"), anche ogni traduzione ne ha bisogno. Un plurale che ritorna come testo normale, o un testo normale che ritorna come plurale, viene rifiutato perché ha la forma sbagliata.

Tag di markup e parentesi graffe vaganti

Le frasi con collegamenti o testo in grassetto vengono inviate con tag come <a>help center</a>. La traduzione può spostare i tag per adattarli al proprio ordine di parole, ma deve mantenere lo stesso set. Una traduzione con più parentesi graffe non corrispondenti rispetto alla sua origine viene rifiutata, il che cattura il caso persiano dalla suite di test prima che qualsiasi libreria debba renderizzarla.

I messaggi ICU devono essere analizzati

Le app Svelte e i file ARB di Flutter utilizzano la sintassi dei messaggi ICU. Lì una traduzione deve anche essere analizzata come ICU. ICU ha una sua insidia: un apostrofo racchiude il testo che lo segue, quindi in francese d'{name} mostrerebbe il testo letterale {name} invece del valore. localize.dev raddoppia gli apostrofi prima delle parentesi prima di controllare, quindi verifica che ogni segnaposto che la traduzione dovrebbe avere sia ancora un argomento reale.

Cosa succede quando una traduzione fallisce

  • La lingua non riuscita viene rimossa per quella stringa e la traduzione memorizzata nella cache viene dimenticata.
  • La stringa viene inviata nuovamente con il motivo aggiunto al suo contesto, ad esempio "Una traduzione precedente è stata rifiutata: ha perso {name}".
  • Se anche la seconda risposta fallisce, la traduzione viene omessa. L'esecuzione lo segnala e la pull request la elenca sotto "Traduzioni omesse".

Non viene scritto nulla di rotto. Una traduzione mancante è visibile: l'app torna alla lingua di origine per quella stringa e localize-dev check segnala la lacuna finché non viene colmata. Una rotta può raggiungere la produzione inosservata.

Cosa non possono dirti i controlli

Questi controlli rilevano le traduzioni che potrebbero interrompere la tua app. Non possono dire se una traduzione è buona. Per questo, localize.dev ti permette di assegnare un revisore per lingua. Le loro correzioni vanno nella pull request aperta e in ogni esecuzione successiva, e un glossario mantiene i termini del prodotto uguali ovunque.

Provalo sul tuo codice nell'area di gioco, non è necessario un account