Che cos'è la pseudotraduzione e perché dovrei usarla?

La pseudotraduzione sostituisce le stringhe di origine con versioni modificate che simulano le caratteristiche delle traduzioni reali, come testo più lungo, set di caratteri diversi e direzione di lettura invertita, senza richiedere una traduzione effettiva. Rileva tempestivamente errori di layout, stringhe codificate direttamente, problemi di codifica e difetti RTL durante lo sviluppo, prima di pagare le traduzioni reali.

Danneggia i segnaposto e le variabili ICU?

No. i18n-pseudo analizza la sintassi dei messaggi ICU e trasforma soltanto i segmenti di testo traducibili. I segnaposto come {name}, le variabili di interpolazione e le espressioni plurali ({count, plural, one {# item} other {# items}'}) vengono preservati esattamente.

Con quale preimpostazione dovrei iniziare?

Inizi con la preimpostazione predefinita (accenti + parentesi) per trovare le stringhe codificate direttamente. Poi usi la preimpostazione layout per rilevare testo troncato e fuoriuscite. Usi charset se supporta lingue CJK e rtl se supporta arabo o ebraico.

Come si integra la pseudotraduzione nella CI?

Generi i file pseudotradotti con 'i18n-pseudo en.json --preset layout -o locales/pseudo/', quindi esegua i test di regressione visiva (Playwright, Chromatic, Percy) con la pseudolingua. Ogni layout che non funziona con il testo espanso apparirà nel confronto visivo.

Strumento di pseudotraduzione

Name: i18n Agent
Price: 0.01 EUR
Author: i18n Agent

Testi l'interfaccia i18n prima del lancio. Generi traduzioni fittizie che mettono alla prova layout, codifica e rendering bidirezionale, senza attendere le traduzioni reali.

Il problema

L'interfaccia sembra perfetta in inglese. Poi arriva il tedesco: stringhe più lunghe del 40% rompono ogni pulsante e troncano tutte le intestazioni delle tabelle. L'arabo inverte l'intero layout e le icone puntano nella direzione sbagliata. Il giapponese richiede interlinee diverse e le schede disposte con cura si deformano. E tutto questo emerge dopo aver pagato le traduzioni.

Correggere gli errori di layout i18n dopo la traduzione costa in media da 5 a 10 volte di più rispetto a rilevarli durante lo sviluppo. La pseudotraduzione individua gratuitamente questi problemi, prima di spendere un solo dollaro per le traduzioni reali.

La soluzione

i18n-pseudo genera traduzioni fittizie che mettono alla prova l'interfaccia senza attendere i traduttori. Applica 7 strategie di trasformazione, tra cui accenti, caratteri CJK, espansione del testo e marcatori RTL, preservando segnaposto ICU, sintassi dei plurali e variabili di interpolazione.

Installazione

i18n-pseudo è disponibile come pacchetto npm o formula Homebrew; in alternativa, può compilarlo dal codice sorgente con Cargo.

Terminal

npm install -g @i18n-agent/i18n-pseudo

Il pacchetto npm include un binario CLI globale. Non sono necessarie dipendenze di runtime.

7 strategie di trasformazione

Ogni strategia è mirata a una specifica categoria di errori i18n. Le usi singolarmente con i flag oppure le combini tramite le preimpostazioni.

Strategy	Flag	Input	Output
Accents	`--accents`	Hello	Ĥéľľó
CJK	`--cjk`	Hello	你好世界你好
Special Chars	`--special`	Hello	Hello
Expansion	`--expansion N`	Save	Save~~~~
Brackets	`--brackets`	Hello	[Hello]
RTL	`--rtl`	Hello	‮Hello‬
Unicode Stress	`--unicode-stress`	Hello	H́ȩl̈l̀õ

Gli accenti sono la strategia più diffusa per rilevare le stringhe codificate direttamente. Se una stringa appare senza segni diacritici nell'interfaccia, non è mai passata attraverso la funzione di traduzione.

Preimpostazioni

Le preimpostazioni raggruppano strategie per scenari di test comuni. Usi --preset per applicare contemporaneamente un gruppo di strategie.

Preset	Strategies	Use Case
`default`	accents + brackets	Quick visual check that all strings are externalized
`layout`	expansion (1.4x) + brackets	Catch truncation and overflow before real translations
`charset`	CJK + special + brackets	Test font rendering and character encoding
`rtl`	RTL markers + brackets	Verify bidirectional layout without switching locale
`full`	All strategies combined	Maximum stress test — everything at once

Esempi di utilizzo

Esegua i18n-pseudo sul file della lingua di origine. Legge JSON, YAML, PO e altri formati i18n, applica le strategie selezionate e scrive l'output trasformato.

Terminal

# Default (accents + brackets)
i18n-pseudo en.json -o output/

# Layout testing (text expansion + brackets)
i18n-pseudo en.json --preset layout -o output/

# Specific strategies
i18n-pseudo en.json --accents --expansion 1.5 -o output/

# Kitchen sink
i18n-pseudo en.json --preset full -o output/

Prima e dopo

Ecco come la preimpostazione predefinita (accenti + parentesi) trasforma un tipico file di traduzione. La sintassi dei plurali ICU e i segnaposto di interpolazione vengono preservati esattamente.

Before & After

// Input (en.json):
{
  "greeting": "Hello, {name}!",
  "save": "Save",
  "items": "{count, plural, one {# item} other {# items}}"
}

// Output (default preset — accents + brackets):
{
  "greeting": "[Ĥéľľó, {name}!]",
  "save": "[Šáṽé]",
  "items": "[{count, plural, one {# íťéɱ} other {# íťéɱš}}]"
}

I segnaposto come {name}, {count} e le espressioni plurali ICU non vengono mai modificati. Vengono trasformati soltanto i segmenti di testo traducibili, affinché l'app visualizzi correttamente i file pseudotradotti.

Integrazione con la CI

Aggiunga la pseudotraduzione alla pipeline CI per rilevare automaticamente le regressioni i18n. Generi i file pseudotradotti, quindi esegua su di essi i test di regressione visiva.

CI Pipeline

# Generate pseudo-translations and run visual regression
i18n-pseudo locales/en.json --preset layout -o locales/pseudo/
NEXT_PUBLIC_LOCALE=pseudo npx playwright test --project=visual

Combini la preimpostazione layout con i test di regressione visiva Playwright o Chromatic. Qualsiasi componente che esca dai limiti o venga troncato con un testo espanso di 1,4 volte non supererà il confronto visivo.