Mis on pseudotõlge ja miks seda kasutada?

Pseudotõlge asendab lähtestringid muudetud versioonidega, mis jäljendavad päris tõlgete omadusi — pikemat teksti, teisi märgistikke ja vastupidist lugemissuunda — tegelikku tõlget nõudmata. See leiab paigutusvead, jäigalt kodeeritud stringid, kodeeringuprobleemid ja RTL-i probleemid arenduse alguses enne päris tõlgete eest maksmist.

Kas see rikub minu ICU kohatäitjad ja muutujad?

Ei. i18n-pseudo parsib ICU sõnumisüntaksit ja teisendab ainult tõlgitavaid tekstisegmente. Kohatäitjad, nagu {name}, interpoleerimismuutujad ja mitmuseavaldised ({count, plural, one {# item} other {# items}'}), säilitatakse täpselt muutmata kujul.

Millisest eelseadistusest alustada?

Jäigalt kodeeritud stringide leidmiseks alusta vaike-eelseadistusega (rõhumärgid ja nurksulud). Seejärel kasuta teksti kärpimise ja ülevoolu leidmiseks layout-eelseadistust. Kasuta charset'i, kui toetad CJK-keeli, ja rtl-i, kui toetad araabia või heebrea keelt.

Kuidas lõimida pseudotõlge CI-sse?

Loo pseudotõlgitud failid käsuga 'i18n-pseudo en.json --preset layout -o locales/pseudo/' ja käita seejärel visuaalsed regressioonitestid (Playwright, Chromatic, Percy) pseudolokaadiga. Kõik laiendatud tekstiga katki minevad paigutused ilmuvad visuaalses diffis.

Pseudotõlke tööriist

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

Testi i18n-i kasutajaliidest enne avaldamist. Loo näidistõlked, mis koormustestivad paigutust, kodeeringut ja kahesuunalist renderdamist ilma päris tõlkeid ootamata.

Probleem

Sinu kasutajaliides näeb inglise keeles täiuslik välja. Siis saabub saksa keel — 40% pikemad stringid rikuvad iga nupu ja kärbivad iga tabelipäise. Araabia keel pöörab kogu paigutuse ümber ja ikoonid osutavad vales suunas. Jaapani keel vajab teistsugust reakõrgust ning hoolikalt paigutatud kaardid varisevad kokku. Avastad selle kõik pärast tõlgete eest maksmist.

i18n-i paigutusvigade parandamine pärast tõlkimist maksab keskmiselt 5-10 korda rohkem kui nende leidmine arenduse ajal. Pseudotõlge leiab probleemid tasuta enne, kui kulutad raha päris tõlgetele.

Lahendus

i18n-pseudo loob näidistõlked, mis koormustestivad kasutajaliidest ilma päris tõlkijaid ootamata. See rakendab seitset teisendusstrateegiat — rõhumärke, CJK-märke, tekstilaiendust, RTL-märke ja muud — säilitades ICU kohatäitjad, mitmusesüntaksi ja interpoleerimismuutujad.

Paigaldamine

i18n-pseudo on saadaval npm-paketi ja Homebrew' valemina või saad selle Cargo abil lähtekoodist ehitada.

Terminal

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

npm-pakett sisaldab globaalset CLI-binaari. Käitusaegseid sõltuvusi pole vaja.

7 teisendusstrateegiat

Iga strateegia sihib kindlat i18n-vea liiki. Kasuta neid lippudega eraldi või ühenda eelseadistustega.

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̃

Rõhumärgid on kõige populaarsem strateegia jäigalt kodeeritud stringide tuvastamiseks. Kui string kuvatakse kasutajaliideses ilma diakriitikuteta, ei läbinud see kunagi tõlkefunktsiooni.

Eelseadistused

Eelseadistused koondavad strateegiad levinud testimisolukordadeks. Kasuta valikut --preset, et rakendada strateegiarühm korraga.

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

Kasutusnäited

Käivita i18n-pseudo lähtekeele failil. See loeb JSON-, YAML- ja PO-faile ning muid i18n-vorminguid, rakendab valitud strateegiaid ja kirjutab teisendatud väljundi.

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/

Enne ja pärast

Sellise tulemuse annab vaike-eelseadistus (rõhumärgid ja nurksulud) tavapärases tõlkefailis. Pane tähele, et ICU mitmusesüntaks ja interpoleerimise kohatäitjad säilivad täpselt.

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 {# íťéɱš}}]"
}

Kohatäitjaid, nagu {name} ja {count}, ega ICU mitmuseavaldisi ei muudeta kunagi. Teisendatakse ainult tõlgitavad tekstisegmendid, seega renderdab rakendus pseudotõlgitud failid õigesti.

CI lõiming

Lisa pseudotõlge CI-konveierisse, et leida i18n-i regressioonid automaatselt. Loo pseudotõlgitud failid ja käita seejärel nendega visuaalsed regressioonitestid.

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

Ühenda layout-eelseadistus Playwright'i või Chromatic'u visuaalse regressiooni testimisega. Kõik komponendid, mis 1,4 korda laiendatud teksti puhul üle voolavad või teksti kärbivad, nurjuvad visuaalses diffis.