Čo je pseudopreklad a prečo by som ho mal používať?

Pseudopreklad nahrádza Vaše zdrojové reťazce upravenými verziami, ktoré simulujú vlastnosti skutočných prekladov – dlhší text, rôzne znakové sady či opačný smer čítania – bez potreby skutočného prekladu. Odhaľuje chyby rozloženia, pevne zapísané reťazce, problémy s kódovaním a RTL už v ranom štádiu vývoja, skôr než zaplatíte za skutočné preklady.

Poškodí moje zástupné symboly a premenné ICU?

Nie. i18n-pseudo analyzuje syntax správ ICU a transformuje iba preložiteľné textové segmenty. Zástupné symboly ako {name}, interpolačné premenné a výrazy množného čísla ({count, plural, one {# item} other {# items}'}) zostanú zachované presne v pôvodnej podobe.

S ktorou predvoľbou mám začať?

Začnite predvolenou predvoľbou (diakritika + zátvorky), aby ste našli pevne zapísané reťazce. Potom použite predvoľbu layout na odhalenie skracovania a pretekania textu. Ak podporujete jazyky CJK, použite charset; pri podpore arabčiny alebo hebrejčiny použite rtl.

Ako integrujem pseudopreklad do CI?

Vygenerujte pseudopreložené súbory pomocou 'i18n-pseudo en.json --preset layout -o locales/pseudo/' a potom spustite testy vizuálnych regresií (Playwright, Chromatic, Percy) s pseudolokalizáciou. Každé rozloženie, ktoré rozšírený text naruší, sa prejaví vo vizuálnom porovnaní.

Nástroj na pseudopreklad

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

Otestujte svoje rozhranie i18n pred vydaním. Generujte falošné preklady, ktoré podrobia rozloženie, kódovanie a obojsmerné vykresľovanie záťažovej skúške – bez čakania na skutočné preklady.

Problém

Vaše používateľské rozhranie vyzerá v angličtine dokonale. Potom príde nemčina – o 40 % dlhšie reťazce narušia každé tlačidlo a skrátia každú hlavičku tabuľky. Arabčina obráti celé rozloženie a Vaše ikony ukazujú nesprávnym smerom. Japončina potrebuje inú výšku riadkov a Vaše starostlivo rozmiestnené karty sa rozpadnú. To všetko zistíte až po zaplatení prekladov.

Priemerné náklady na opravu chýb rozloženia i18n po preklade sú 5- až 10-násobne vyššie než pri ich odhalení počas vývoja. Pseudopreklad ich odhalí bezplatne ešte skôr, než miniete čo i len euro na skutočné preklady.

Riešenie

i18n-pseudo generuje falošné preklady, ktoré podrobia Vaše rozhranie záťažovej skúške bez čakania na skutočných prekladateľov. Používa 7 transformačných stratégií – diakritiku, znaky CJK, rozšírenie textu, značky RTL a ďalšie – pričom zachováva zástupné symboly ICU, syntax množného čísla a interpolačné premenné.

Inštalácia

i18n-pseudo je dostupný ako balík npm alebo vzorec Homebrew, prípadne ho môžete zostaviť zo zdrojového kódu pomocou Cargo.

Terminal

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

Balík npm obsahuje globálny binárny súbor CLI. Nie sú potrebné žiadne závislosti za behu.

7 transformačných stratégií

Každá stratégia sa zameriava na konkrétnu triedu chýb i18n. Použite ich samostatne pomocou príznakov alebo ich skombinujte v predvoľbách.

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̃

Diakritika je najobľúbenejšia stratégia na odhaľovanie pevne zapísaných reťazcov. Ak sa reťazec vo Vašom rozhraní zobrazí bez diakritických znamienok, nikdy neprešiel prekladovou funkciou.

Predvoľby

Predvoľby združujú stratégie pre bežné scenáre testovania. Pomocou --preset použijete skupinu stratégií naraz.

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

Príklady použitia

Spustite i18n-pseudo nad svojím zdrojovým lokalizačným súborom. Načíta JSON, YAML, PO a ďalšie formáty i18n, použije vybrané stratégie a zapíše transformovaný výstup.

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/

Pred a po

Takto predvolená predvoľba (diakritika + zátvorky) upraví bežný prekladový súbor. Všimnite si, že syntax množného čísla ICU a interpolačné zástupné symboly zostanú zachované bez zmeny.

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

Zástupné symboly ako {name}, {count} a výrazy množného čísla ICU sa nikdy neupravujú. Transformujú sa iba preložiteľné textové segmenty, takže Vaša aplikácia správne vykreslí aj pseudopreložené súbory.

Integrácia CI

Pridajte pseudopreklad do svojej pipeline CI a automaticky odhaľujte regresie i18n. Vygenerujte pseudopreložené súbory a potom na nich spustite testy vizuálnych regresií.

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

Skombinujte predvoľbu rozloženia s testovaním vizuálnych regresií v Playwright alebo Chromatic. Každý komponent, ktorý pri 1,4-násobne rozšírenom texte pretečie alebo sa skráti, neprejde vizuálnym porovnaním.