Hva er pseudo-oversettelse, og hvorfor bør jeg bruke det?

Pseudo-oversettelse erstatter kildestrengene dine med modifiserte versjoner som simulerer egenskapene til ekte oversettelser — lengre tekst, andre tegnsett, omvendt leseretning — uten å kreve faktisk oversettelse. Den fanger opp layoutfeil, hardkodede strenger, kodingsproblemer og RTL-problemer tidlig i utviklingen, før du betaler for ekte oversettelser.

Ødelegger det ICU-plassholderne og variablene mine?

Nei. i18n-pseudo tolker ICU-meldingssyntaks og transformerer kun oversettbare tekstsegmenter. Plassholdere som {name}, interpoleringsvariabler og flertallsuttrykk ({count, plural, one {# item} other {# items}'}) bevares nøyaktig som de er.

Hvilken forhåndsinnstilling bør jeg starte med?

Start med standardinnstillingen (aksenter + hakeparenteser) for å finne hardkodede strenger. Bruk deretter layout-innstillingen for å fange opp tekstavkutting og overflyt. Bruk charset hvis du støtter CJK-språk, og rtl hvis du støtter arabisk eller hebraisk.

Hvordan integrerer jeg pseudo-oversettelse i CI?

Generer pseudo-oversatte filer med 'i18n-pseudo en.json --preset layout -o locales/pseudo/', og kjør deretter de visuelle regresjonstestene dine (Playwright, Chromatic, Percy) med pseudospråket. Alle layouter som brytes av utvidet tekst, vil vises som en visuell forskjell.

Pseudo-oversettelsesverktøy

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

Test i18n-brukergrensesnittet ditt før lansering. Generer falske oversettelser som stresstester layout, koding og toveis tekstgjengivelse — uten å vente på ekte oversettelser.

Problemet

Brukergrensesnittet ditt ser perfekt ut på engelsk. Så kommer tysk — strenger som er 40 % lengre, ødelegger hver knapp og avkorter hver tabelloverskrift. Arabisk snur hele layouten på hodet, og ikonene dine peker feil vei. Japansk trenger andre linjehøyder, og kortene med nøye tilpasset avstand kollapser. Alt dette oppdager du etter at du har betalt for oversettelser.

Den gjennomsnittlige kostnaden for å fikse i18n-layoutfeil etter oversettelse er 5-10x høyere enn å oppdage dem under utvikling. Pseudo-oversettelse fanger opp disse problemene gratis, før du bruker en eneste krone på ekte oversettelser.

Løsningen

i18n-pseudo genererer falske oversettelser som stresstester brukergrensesnittet ditt uten å vente på ekte oversettere. Verktøyet bruker 7 transformasjonsstrategier — aksenter, CJK-tegn, tekstutvidelse, RTL-markører og mer — samtidig som ICU-plassholdere, flertallssyntaks og interpoleringsvariabler bevares.

Installasjon

i18n-pseudo er tilgjengelig som en npm-pakke, en Homebrew-formel, eller du kan bygge fra kildekode med Cargo.

Terminal

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

npm-pakken inkluderer en global CLI-binærfil. Ingen kjøretidsavhengigheter kreves.

7 transformasjonsstrategier

Hver strategi retter seg mot en bestemt type i18n-feil. Bruk dem enkeltvis med flagg, eller kombiner dem med forhåndsinnstillinger.

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̃

Aksenter er den mest populære strategien for å oppdage hardkodede strenger. Hvis en streng vises uten diakritiske tegn i brukergrensesnittet, ble den aldri sendt gjennom oversettelsesfunksjonen.

Forhåndsinnstillinger

Forhåndsinnstillinger samler strategier for vanlige testscenarier. Bruk --preset for å bruke en gruppe strategier samtidig.

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

Brukseksempler

Kjør i18n-pseudo mot kildespråkfilen din. Verktøyet leser JSON, YAML, PO og andre i18n-formater, bruker de valgte strategiene og skriver det transformerte resultatet.

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 etter

Her er hva standardinnstillingen (aksenter + hakeparenteser) gjør med en typisk oversettelsesfil. Legg merke til at ICU-flertallssyntaks og interpoleringsplassholdere bevares nøyaktig.

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

Plassholdere som {name}, {count}, og ICU-flertallsuttrykk endres aldri. Kun oversettbare tekstsegmenter transformeres, slik at appen din gjengis korrekt med pseudo-oversatte filer.

CI-integrasjon

Legg til pseudo-oversettelse i CI-pipelinen din for å fange opp i18n-regresjoner automatisk. Generer pseudo-oversatte filer, og kjør deretter de visuelle regresjonstestene dine mot 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 layout-forhåndsinnstillingen med visuell regresjonstesting i Playwright eller Chromatic. Alle komponenter der innholdet går utenfor rammen eller teksten avkortes med 1.4x utvidet tekst, vil gi utslag i den visuelle sammenligningen.