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.
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.
npm install -g @i18n-agent/i18n-pseudo7 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.
| 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́ȩl̈l̀õ |
Valors predefinits
Els valors predefinits agrupen estratègies per a situacions de prova habituals. Utilitzi --preset per aplicar un grup d’estratègies alhora.
| 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 |
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.
# 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.
// 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 {# íťéɱš}}]"
}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.
# 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=visualEines i guies relacionades
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ó