Hvad er pseudooversættelse og hvorfor bør jeg bruge det?

Pseudooversættelse erstatter dine kildetekster med ændrede versioner, som simulerer egenskaber ved rigtige oversættelser — længere tekst, andre tegnsæt og omvendt læseretning — uden at kræve en egentlig oversættelse. Det finder layoutfejl, hårdkodede tekster, kodningsproblemer og RTL-problemer tidligt i udviklingen, før du betaler for rigtige oversættelser.

Ødelægger det mine ICU-pladsholdere og variabler?

Nej. i18n-pseudo fortolker ICU-meddelelsessyntaks og transformerer kun oversættelige tekstsegmenter. Pladsholdere som {name}, interpolationsvariabler og flertalsudtryk ({count, plural, one {# item} other {# items}'}) bevares nøjagtigt, som de er.

Hvilken forudindstilling bør jeg begynde med?

Begynd med standardforudindstillingen (accenter + parenteser) for at finde hårdkodede tekster. Brug derefter layoutforudindstillingen til at finde tekstafkortning og overløb. Brug charset, hvis du understøtter CJK-sprog og rtl, hvis du understøtter arabisk eller hebraisk.

Hvordan integrerer jeg pseudooversættelse i CI?

Generer pseudooversatte filer med 'i18n-pseudo en.json --preset layout -o locales/pseudo/' og kør derefter dine visuelle regressionstest (Playwright, Chromatic, Percy) med pseudolandestandarden. Ethvert layout, der bryder sammen med udvidet tekst, vises som en visuel forskel.

Værktøj til pseudooversættelse

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

Test din i18n-brugerflade før lancering. Generer falske oversættelser, som stresstester layout, kodning og tovejsvisning — uden at vente på rigtige oversættelser.

Problemet

Din brugerflade ser perfekt ud på engelsk. Så kommer tysk — 40 % længere tekster ødelægger alle knapper og afkorter alle tabeloverskrifter. Arabisk vender hele layoutet og dine ikoner peger den forkerte vej. Japansk kræver andre linjehøjder og dine omhyggeligt placerede kort bryder sammen. Du finder først alt dette, efter at du har betalt for oversættelser.

Det koster i gennemsnit 5-10x mere at rette i18n-layoutfejl efter oversættelsen end at finde dem under udviklingen. Pseudooversættelse finder disse problemer gratis, før du bruger penge på rigtige oversættelser.

Løsningen

i18n-pseudo genererer falske oversættelser, som stresstester din brugerflade, uden at du skal vente på rigtige oversættere. Værktøjet anvender 7 transformationsstrategier — accenter, CJK-tegn, tekstudvidelse, RTL-markører med mere — og bevarer samtidig ICU-pladsholdere, flertalssyntaks og interpolationsvariabler.

Installation

i18n-pseudo fås som en npm-pakke og en Homebrew-formel eller du kan bygge værktøjet fra kildekoden med Cargo.

Terminal

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

npm-pakken indeholder en global binær CLI-fil. Der kræves ingen kørselstidsafhængigheder.

7 transformationsstrategier

Hver strategi er rettet mod en bestemt type i18n-fejl. Brug dem enkeltvis med flag eller kombiner dem med forudindstillinger.

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̃

Accenter er den mest populære strategi til at finde hårdkodede tekster. Hvis en tekst vises uden diakritiske tegn i din brugerflade, er den aldrig blevet sendt gennem oversættelsesfunktionen.

Forudindstillinger

Forudindstillinger samler strategier til almindelige testscenarier. Brug --preset til at anvende en gruppe strategier på én gang.

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

Eksempler på brug

Kør i18n-pseudo på din fil med kildelandestandarden. Værktøjet læser JSON, YAML, PO og andre i18n-formater, anvender de valgte strategier og skriver det transformerede output.

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/

Før og efter

Her kan du se, hvad standardforudindstillingen (accenter + parenteser) gør ved en typisk oversættelsesfil. Bemærk, at ICU-flertalssyntaks og interpolationspladsholdere bevares nøjagtigt.

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

Pladsholdere som {name}, {count} og ICU-flertalsudtryk ændres aldrig. Kun oversættelige tekstsegmenter transformeres, så din app gengives korrekt med pseudooversatte filer.

CI-integration

Føj pseudooversættelse til din CI-pipeline for automatisk at finde i18n-regressioner. Generer pseudooversatte filer og kør derefter dine visuelle regressionstest på dem.

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

Kombiner layoutforudindstillingen med visuel regressionstest i Playwright eller Chromatic. Alle komponenter, som løber over eller afkortes med tekst udvidet 1.4x, vil få den visuelle sammenligning til at fejle.