Kaj je psevdoprevajanje in zakaj naj ga uporabljam?

Psevdoprevajanje izvorne nize zamenja s spremenjenimi različicami, ki posnemajo lastnosti pravih prevodov — daljše besedilo, drugačne nabore znakov in obrnjeno smer branja — brez dejanskega prevajanja. Že zgodaj med razvojem odkrije napake postavitve, nize, zapisane na stalno, težave s kodiranjem in RTL, preden plačate prave prevode.

Ali pokvari označbe mest in spremenljivke ICU?

Ne. i18n-pseudo razčleni skladnjo sporočil ICU in preoblikuje samo prevedljive dele besedila. Označbe mest, kot je {name}, interpolacijske spremenljivke in množinski izrazi ({count, plural, one {# item} other {# items}'}) se ohranijo povsem nespremenjeni.

S katero prednastavitvijo naj začnem?

Začnite s privzeto prednastavitvijo z naglasi in oklepaji, da najdete nize, zapisane na stalno. Nato s prednastavitvijo layout odkrijte krajšanje in prelivanje besedila. Uporabite charset, če podpirate jezike CJK, ter rtl, če podpirate arabščino ali hebrejščino.

Kako vključim psevdoprevajanje v CI?

Z ukazom 'i18n-pseudo en.json --preset layout -o locales/pseudo/' ustvarite datoteke s psevdoprevodi, nato z navideznim jezikom zaženite preizkuse vizualne regresije (Playwright, Chromatic, Percy). Vsaka postavitev, ki jo razširjeno besedilo pokvari, se prikaže kot vizualna razlika.

Orodje za psevdoprevajanje

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

Uporabniški vmesnik i18n preizkusite pred objavo. Ustvarite umetne prevode, ki obremenitveno preizkusijo postavitev, kodiranje in dvosmerno izrisovanje, ne da bi čakali na prave prevode.

Težava

Vaš uporabniški vmesnik je v angleščini videti popolno. Nato prispe nemščina — 40 % daljši nizi pokvarijo vse gumbe in skrajšajo vse glave tabel. Arabščina obrne celotno postavitev, ikone pa kažejo v napačno smer. Japonščina potrebuje drugačne višine vrstic in skrbno razporejene kartice se sesujejo. Vse to odkrijete šele po plačilu prevodov.

Povprečni stroški popravljanja napak postavitve i18n po prevodu so 5-10-krat višji kot med razvojem. Psevdoprevajanje te težave odkrije brezplačno, preden za pravi prevod porabite en sam evro.

Rešitev

i18n-pseudo ustvari umetne prevode, ki obremenitveno preizkusijo Vaš uporabniški vmesnik brez čakanja na prave prevajalce. Uporabi 7 strategij preoblikovanja — naglase, znake CJK, razširitev besedila, oznake RTL in druge — pri tem pa ohrani označbe mest ICU, množinsko skladnjo in interpolacijske spremenljivke.

Namestitev

i18n-pseudo je na voljo kot paket npm in formula Homebrew, lahko pa ga zgradite iz izvorne kode s Cargo.

Terminal

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

Paket npm vključuje globalno binarno datoteko CLI. Izvajalne odvisnosti niso potrebne.

7 strategij preoblikovanja

Vsaka strategija cilja na določeno vrsto napak i18n. Uporabite jih posamično z zastavicami ali jih združite s prednastavitvami.

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̃

Naglasi so najbolj priljubljena strategija za odkrivanje nizov, zapisanih na stalno. Če se niz v uporabniškem vmesniku prikaže brez diakritičnih znakov, ni bil nikoli obdelan s prevajalsko funkcijo.

Prednastavitve

Prednastavitve združujejo strategije za pogoste preizkusne scenarije. S --preset uporabite skupino strategij naenkrat.

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

Primeri uporabe

Zaženite i18n-pseudo na izvorni jezikovni datoteki. Prebere JSON, YAML, PO in druge oblike i18n, uporabi izbrane strategije ter zapiše preoblikovani izhod.

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/

Prej in potem

Tako privzeta prednastavitev z naglasi in oklepaji spremeni običajno prevajalsko datoteko. Množinska skladnja ICU in interpolacijske označbe mest se ohranijo natančno.

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

Označbe mest, kot sta {name} in {count}, ter množinski izrazi ICU se nikoli ne spremenijo. Preoblikujejo se samo prevedljivi deli besedila, zato aplikacija pravilno izriše datoteke s psevdoprevodi.

Integracija CI

Psevdoprevajanje dodajte v pipeline CI in samodejno odkrijte regresije i18n. Ustvarite datoteke s psevdoprevodi in na njih zaženite preizkuse vizualne regresije.

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

Prednastavitev layout združite s preizkušanjem vizualne regresije Playwright ali Chromatic. Vsaka komponenta, ki se pri 1,4-krat razširjenem besedilu prelije ali skrajša, bo povzročila neuspeh vizualne primerjave.