Što je pseudoprevođenje i zašto bih ga trebao upotrebljavati?

Pseudoprevođenje zamjenjuje izvorne tekstove izmijenjenim inačicama koje oponašaju svojstva pravih prijevoda — dulji tekst, drukčije skupove znakova i obrnuti smjer čitanja — bez potrebe za stvarnim prijevodom. Rano tijekom razvoja otkriva pogreške u rasporedu, tekstove ugrađene u kod, poteškoće s kodiranjem i RTL prikazom, prije nego što platite prave prijevode.

Oštećuje li moja ICU rezervirana mjesta i varijable?

Ne. i18n-pseudo raščlanjuje sintaksu ICU poruka i transformira samo prevodive dijelove teksta. Rezervirana mjesta poput {name}, interpolacijske varijable i izrazi množine ({count, plural, one {# item} other {# items}'}) čuvaju se točno u izvornom obliku.

S kojom unaprijed definiranom postavkom trebam započeti?

Započnite zadanom postavkom (nadslovni znakovi + zagrade) kako biste pronašli tekstove ugrađene u kod. Zatim upotrijebite postavku layout kako biste otkrili skraćivanje i prelijevanje teksta. Upotrijebite charset ako podržavate CJK jezike, a rtl ako podržavate arapski ili hebrejski.

Kako mogu integrirati pseudoprevođenje u CI?

Generirajte pseudoprevedene datoteke naredbom 'i18n-pseudo en.json --preset layout -o locales/pseudo/', a zatim pokrenite testove vizualne regresije (Playwright, Chromatic, Percy) s pseudolokalitetom. Svaki raspored koji se naruši zbog proširenog teksta pojavit će se kao vizualna razlika.

Alat za pseudoprevođenje

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

Testirajte svoje i18n korisničko sučelje prije objave. Generirajte lažne prijevode koji temeljito ispituju raspored, kodiranje i dvosmjerni prikaz — bez čekanja pravih prijevoda.

Problem

Vaše korisničko sučelje izgleda savršeno na engleskom. Zatim stigne njemački — 40% dulji tekstovi naruše svaki gumb i skrate svako zaglavlje tablice. Arapski preokrene cijeli raspored, a Vaše ikone pokazuju u pogrešnom smjeru. Japanski zahtijeva drukčije visine redaka pa se Vaše pomno raspoređene kartice uruše. Sve to otkrijete nakon što ste platili prijevode.

Prosječan trošak ispravljanja i18n pogrešaka u rasporedu nakon prevođenja 5-10 puta je veći nego kada se otkriju tijekom razvoja. Pseudoprevođenje besplatno otkriva te probleme prije nego što potrošite ijedan dolar na prave prijevode.

Rješenje

i18n-pseudo generira lažne prijevode koji temeljito ispituju Vaše korisničko sučelje bez čekanja pravih prevoditelja. Primjenjuje 7 strategija transformacije — naglaske, CJK znakove, proširenje teksta, RTL oznake i druge — uz očuvanje ICU rezerviranih mjesta, sintakse množine i interpolacijskih varijabli.

Instalacija

i18n-pseudo dostupan je kao npm paket i Homebrew formula, a možete ga izgraditi i iz izvornog koda pomoću Carga.

Terminal

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

npm paket uključuje globalnu CLI binarnu datoteku. Nisu potrebne ovisnosti izvođenja.

7 strategija transformacije

Svaka strategija cilja određenu vrstu i18n pogreške. Upotrebljavajte ih pojedinačno putem zastavica ili ih kombinirajte pomoću unaprijed definiranih postavki.

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̃

Nadslovni znakovi najpopularnija su strategija za otkrivanje tekstova ugrađenih u kod. Ako se tekst u korisničkom sučelju pojavi bez dijakritičkih znakova, nikada nije proslijeđen funkciji za prevođenje.

Unaprijed definirane postavke

Unaprijed definirane postavke objedinjuju strategije za uobičajene scenarije testiranja. Upotrijebite --preset kako biste primijenili skupinu strategija odjednom.

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

Primjeri upotrebe

Pokrenite i18n-pseudo nad datotekom izvornog lokaliteta. Čita JSON, YAML, PO i druge i18n formate, primjenjuje odabrane strategije i zapisuje transformirani rezultat.

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/

Prije i nakon

Pogledajte kako zadana postavka (nadslovni znakovi + zagrade) mijenja tipičnu datoteku prijevoda. Primijetite da su sintaksa ICU množine i interpolacijska rezervirana mjesta potpuno očuvani.

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

Rezervirana mjesta poput {name}, {count} i izraza ICU množine nikada se ne mijenjaju. Transformiraju se samo prevodivi dijelovi teksta pa Vaša aplikacija ispravno prikazuje pseudoprevedene datoteke.

CI integracija

Dodajte pseudoprevođenje u svoj CI proces kako biste automatski otkrivali i18n regresije. Generirajte pseudoprevedene datoteke, a zatim nad njima pokrenite testove 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

Kombinirajte postavku layout s testiranjem vizualne regresije u Playwrightu ili Chromaticu. Svaka komponenta koja prelijeva sadržaj ili skraćuje tekst proširen 1,4 puta neće proći vizualnu usporedbu.