Mitä pseudokäännös on ja miksi sitä kannattaa käyttää?

Pseudokäännös korvaa lähdemerkkijonot muunnetuilla versioilla, jotka jäljittelevät oikeiden käännösten ominaisuuksia — pidempää tekstiä, eri merkistöjä ja käänteistä lukusuuntaa — ilman todellista kääntämistä. Se löytää asetteluvirheet, kovakoodatut merkkijonot, koodausongelmat ja RTL-ongelmat kehityksen alussa ennen oikeiden käännösten ostamista.

Rikkooko se ICU-paikkamerkkini ja muuttujani?

Ei. i18n-pseudo jäsentää ICU-sanomasyntaksin ja muuntaa vain käännettävät tekstisegmentit. Paikkamerkit, kuten {name}, interpolointimuuttujat ja monikkolausekkeet ({count, plural, one {# item} other {# items}'}), säilytetään täsmälleen muuttumattomina.

Mistä esiasetuksesta kannattaa aloittaa?

Aloita oletusesiasetuksella (tarkemerkit ja hakasulkeet) löytääksesi kovakoodatut merkkijonot. Löydä sitten tekstin katkeaminen ja ylivuoto layout-esiasetuksella. Käytä charset-asetusta, jos tuet CJK-kieliä, ja rtl-asetusta, jos tuet arabiaa tai hepreaa.

Miten integroin pseudokäännöksen CI:hin?

Luo pseudokäännetyt tiedostot komennolla 'i18n-pseudo en.json --preset layout -o locales/pseudo/' ja suorita sitten visuaaliset regressiotestisi (Playwright, Chromatic, Percy) pseudokieliversiolla. Kaikki laajennetun tekstin rikkovat asettelut näkyvät visuaalisessa diffissä.

Pseudokäännöstyökalu

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

Testaa i18n-käyttöliittymäsi ennen julkaisua. Luo tekaistut käännökset, jotka rasitustestaavat asettelun, koodauksen ja kaksisuuntaisen hahmontamisen ilman oikeiden käännösten odottamista.

Ongelma

Käyttöliittymäsi näyttää täydelliseltä englanniksi. Sitten tulee saksa — 40 % pidemmät merkkijonot rikkovat kaikki painikkeet ja katkaisevat jokaisen taulukko-otsikon. Arabia kääntää koko asettelun ja kuvakkeesi osoittavat väärään suuntaan. Japani tarvitsee eri rivikorkeudet, ja huolellisesti asetellut korttisi romahtavat. Löydät tämän kaiken vasta maksettuasi käännöksistä.

i18n-asetteluvirheiden korjaaminen kääntämisen jälkeen maksaa keskimäärin 5-10 kertaa enemmän kuin niiden löytäminen kehityksen aikana. Pseudokäännös löytää ongelmat maksutta ennen kuin käytät rahaa oikeisiin käännöksiin.

Ratkaisu

i18n-pseudo luo tekaistut käännökset, jotka rasitustestaavat käyttöliittymääsi ilman oikeiden kääntäjien odottamista. Se käyttää seitsemää muunnosstrategiaa — tarkemerkkejä, CJK-merkkejä, tekstin laajennusta, RTL-merkkejä ja muita — mutta säilyttää ICU-paikkamerkit, monikkosyntaksin ja interpolointimuuttujat.

Asennus

i18n-pseudo on saatavilla npm-pakettina ja Homebrew-kaavana, tai voit koostaa sen lähdekoodista Cargolla.

Terminal

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

npm-paketti sisältää yleisen CLI-binääritiedoston. Suorituksenaikaisia riippuvuuksia ei tarvita.

7 muunnosstrategiaa

Kukin strategia kohdistuu tiettyyn i18n-virheluokkaan. Käytä niitä erikseen valitsimilla tai yhdistele esiasetuksilla.

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̃

Tarkemerkit ovat suosituin strategia kovakoodattujen merkkijonojen löytämiseen. Jos merkkijono näkyy käyttöliittymässä ilman tarkemerkkejä, sitä ei koskaan välitetty käännösfunktiolle.

Esiasetukset

Esiasetukset kokoavat strategioita tavallisiin testaustilanteisiin. Käytä --preset-valitsinta ottaaksesi strategiaryhmän käyttöön kerralla.

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

Käyttöesimerkit

Suorita i18n-pseudo lähdekielen tiedostolle. Se lukee JSON-, YAML- ja PO-tiedostoja sekä muita i18n-muotoja, käyttää valittuja strategioita ja kirjoittaa muunnetun tulosteen.

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/

Ennen ja jälkeen

Tältä oletusesiasetus (tarkemerkit ja hakasulkeet) näyttää tavallisessa käännöstiedostossa. Huomaa, että ICU-monikkosyntaksi ja interpoloinnin paikkamerkit säilyvät täsmälleen.

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

Paikkamerkkejä, kuten {name} ja {count}, tai ICU-monikkolausekkeita ei koskaan muuteta. Vain käännettävät tekstisegmentit muunnetaan, joten sovelluksesi hahmontaa pseudokäännetyt tiedostot oikein.

CI-integraatio

Lisää pseudokäännös CI-putkeesi löytämään i18n-regressiot automaattisesti. Luo pseudokäännetyt tiedostot ja suorita sitten niillä visuaaliset regressiotestit.

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

Yhdistä layout-esiasetus Playwright:in tai Chromatic:in visuaaliseen regressiotestaukseen. Kaikki komponentit, jotka vuotavat yli tai katkaisevat tekstin sen laajentuessa 1,4-kertaiseksi, epäonnistuvat visuaalisessa diffissä.