Co je pseudo-překlad a proč ho používat?

Pseudo-překlad nahrazuje zdrojové řetězce upravenými verzemi, které simulují vlastnosti skutečných překladů — delší text, jiné znakové sady, obrácený směr čtení — bez potřeby skutečného překladu. Včas během vývoje odhalí chyby rozložení, hardcodované řetězce, problémy s kódováním a potíže s RTL, ještě než zaplatíte za skutečné překlady.

Poškodí to moje zástupné symboly ICU a proměnné?

Ne. i18n-pseudo parsuje syntaxi zpráv ICU a transformuje pouze přeložitelné textové segmenty. Zástupné symboly jako {name}, proměnné pro interpolaci a pluralové výrazy ({count, plural, one {# item} other {# items}'}) zůstávají zachovány přesně tak, jak jsou.

S kterým presetem mám začít?

Začněte s výchozím presetem (diakritika + závorky), abyste našli hardcodované řetězce. Poté použijte preset layout, abyste odhalili ořezávání a přetékání textu. Pokud podporujete jazyky CJK, použijte charset, a pokud podporujete arabštinu nebo hebrejštinu, použijte rtl.

Jak integrovat pseudo-překlad do CI?

Vygenerujte pseudo-přeložené soubory příkazem 'i18n-pseudo en.json --preset layout -o locales/pseudo/' a poté spusťte vizuální regresní testy (Playwright, Chromatic, Percy) s pseudo lokálem. Jakékoli rozložení, které se při rozšířeném textu rozbije, se projeví jako vizuální diff.

Nástroj pro pseudo-překlad

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

Otestujte i18n UI před spuštěním. Generujte falešné překlady, které otestují rozložení, kódování a obousměrné vykreslování — bez čekání na skutečné překlady.

Problém

Vaše UI v angličtině vypadá perfektně. Pak přijde němčina — o 40 % delší řetězce rozbijí každé tlačítko a oříznou každý nadpis sloupce v tabulce. Arabština převrátí celé rozložení a Vaše ikony ukazují špatným směrem. Japonština potřebuje jiné výšky řádků a Vaše pečlivě rozestavěné karty se zbortí. To všechno zjistíte až po zaplacení překladů.

Průměrné náklady na opravu i18n chyb rozložení po překladu jsou 5-10× vyšší než jejich zachycení během vývoje. Pseudo-překlad tyto problémy odhalí zdarma, dřív než utratíte jediný dolar za skutečné překlady.

Řešení

i18n-pseudo generuje falešné překlady, které otestují Vaše UI, aniž byste museli čekat na skutečné překladatele. Aplikuje 7 transformačních strategií — diakritiku, znaky CJK, rozšíření textu, značky RTL a další — a přitom přesně zachovává zástupné symboly ICU, syntaxi plurálů i proměnné pro interpolaci.

Instalace

i18n-pseudo je dostupný jako balíček npm, jako formule pro Homebrew, nebo si ho můžete sestavit ze zdrojů pomocí Cargo.

Terminal

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

Balíček npm obsahuje globální CLI binární soubor. Nejsou potřeba žádné runtime závislosti.

7 transformačních strategií

Každá strategie cílí na konkrétní třídu i18n chyb. Používejte je jednotlivě pomocí příznaků nebo je kombinujte pomocí presetů.

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 nejoblíbenější strategie pro detekci hardcodovaných řetězců. Pokud se řetězec v UI zobrazí bez diakritiky, nikdy neprošel překladovou funkcí.

Presety

Presety sdružují strategie pro běžné testovací scénáře. Použijte --preset a aplikujte skupinu strategií najednou.

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

Příklady použití

Spusťte i18n-pseudo nad zdrojovým souborem lokálu. Načte JSON, YAML, PO a další i18n formáty, aplikuje vybrané strategie 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/

Před a po

Zde je, co výchozí preset (diakritika + závorky) udělá s typickým souborem překladů. Všimněte si, že syntaxe plurálů ICU a zástupné symboly pro interpolaci jsou zachované přesně.

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 jako {name}, {count} a pluralové výrazy ICU se nikdy neupravují. Transformují se pouze přeložitelné textové segmenty, takže se Vaše aplikace s pseudo-přeloženými soubory vykreslí správně.

Integrace CI

Přidejte pseudo-překlad do CI pipeline a automaticky zachycujte i18n regrese. Vygenerujte pseudo-přeložené soubory a poté nad nimi spusťte vizuální regresní testy.

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

Zkombinujte preset layout s vizuálním regresním testováním v Playwright nebo Chromatic. Jakákoli komponenta, která při 1.4× rozšířeném textu přeteče nebo se ořízne, neprojde vizuálním diffem.