Skip to main content

Eina de pseudotraducció

Provi la seva interfície d’i18n abans del llançament. Generi traduccions simulades que posin a prova al límit la disposició, la codificació i la representació bidireccional, sense esperar les traduccions reals.

El problema

La seva interfície té un aspecte perfecte en anglès. Aleshores arriba l’alemany: unes cadenes un 40% més llargues desquadren tots els botons i trunquen totes les capçaleres de taula. L’àrab inverteix tota la disposició i les icones apunten en la direcció equivocada. El japonès necessita interlineats diferents i les targetes espaiades amb cura es desmunten. I tot això es descobreix després d’haver pagat les traduccions.

El cost mitjà de corregir errors de disposició d’i18n després de la traducció és entre 5 i 10 vegades superior al de detectar-los durant el desenvolupament. La pseudotraducció detecta aquests problemes de franc, abans que gasti ni un euro en traduccions reals.

La solució

i18n-pseudo genera traduccions simulades que posen a prova al límit la seva interfície sense haver d’esperar els traductors. Aplica 7 estratègies de transformació —accents, caràcters CJK, expansió de text, marcadors RTL i més— i conserva els marcadors de posició d’ICU, la sintaxi dels plurals i les variables d’interpolació.

Instal·lació

i18n-pseudo està disponible com a paquet npm o com a fórmula de Homebrew i també es pot compilar des del codi font amb Cargo.

Terminal
npm install -g @i18n-agent/i18n-pseudo
El paquet npm inclou un binari CLI global. No cal cap dependència d’execució.

7 estratègies de transformació

Cada estratègia se centra en una classe concreta d’error d’i18n. Utilitzi-les individualment amb opcions o combini-les mitjançant valors predefinits.

StrategyFlagInputOutput
Accents--accentsHelloĤéľľó
CJK--cjkHello你好世界你好
Special Chars--specialHelloHel­lo
Expansion--expansion NSaveSave~~~~
Brackets--bracketsHello[Hello]
RTL--rtlHello‮Hello‬
Unicode Stress--unicode-stressHelloH́ȩl̈l̀õ
Els accents són l’estratègia més popular per detectar cadenes escrites directament al codi. Si una cadena apareix sense diacrítics a la interfície, vol dir que no s’ha processat mai amb la funció de traducció.

Valors predefinits

Els valors predefinits agrupen estratègies per a situacions de prova habituals. Utilitzi --preset per aplicar un grup d’estratègies alhora.

PresetStrategiesUse Case
defaultaccents + bracketsQuick visual check that all strings are externalized
layoutexpansion (1.4x) + bracketsCatch truncation and overflow before real translations
charsetCJK + special + bracketsTest font rendering and character encoding
rtlRTL markers + bracketsVerify bidirectional layout without switching locale
fullAll strategies combinedMaximum stress test — everything at once

Exemples d’ús

Executi i18n-pseudo amb el fitxer de configuració regional d’origen. Llegeix JSON, YAML, PO i altres formats d’i18n, aplica les estratègies seleccionades i escriu la sortida transformada.

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/

Abans i després

Aquest és el resultat d’aplicar el valor predefinit per defecte (accents + claudàtors) a un fitxer de traducció habitual. Observi que la sintaxi de plurals d’ICU i els marcadors de posició d’interpolació es conserven exactament.

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 {# íťéɱš}}]"
}
Els marcadors de posició com ara {name} i {count}, així com les expressions plurals d’ICU, no es modifiquen mai. Només es transformen els segments de text traduïbles, de manera que l’aplicació mostri correctament els fitxers pseudotraduïts.

Integració amb la CI

Afegeixi la pseudotraducció al pipeline de CI per detectar automàticament regressions d’i18n. Generi fitxers pseudotraduïts i, després, executi-hi les proves de regressió visual.

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 el valor predefinit de disposició amb proves de regressió visual de Playwright o Chromatic. Qualsevol component que es desbordi o es trunqui amb el text ampliat 1.4x farà fallar la comparació visual.

Provar i18n Agent ara

Arrossegar aquí el fitxer de traducció

JSON, YAML, PO, XML, CSV, Markdown, Properties

o fer clic per explorar

Idiomes de destinació

No cal registrePressupost instantani

Preguntes freqüents