Skip to main content

Pszeudofordító eszköz

Tesztelje az i18n-felületet kiadás előtt. Készítsen álfordításokat, amelyek valódi fordítások nélkül teszik próbára az elrendezést, a kódolást és a kétirányú megjelenítést.

A probléma

A felület tökéletesen néz ki angolul. Aztán megérkezik a német — a 40%-kal hosszabb szövegek minden gombot szétszakítanak, és minden táblázatfejlécet levágnak. Az arab megfordítja a teljes elrendezést, az ikonok pedig rossz irányba mutatnak. A japán más sormagasságot igényel, és a gondosan elrendezett kártyák összeomlanak. Mindezt csak a fordítások kifizetése után fedezi fel.

Az i18n-elrendezési hibák fordítás utáni javítása átlagosan 5-10-szer többe kerül, mint a fejlesztés közbeni észlelésük. A pszeudofordítás ingyen, még a valódi fordításokra költött első forint előtt megtalálja ezeket a problémákat.

A megoldás

Az i18n-pseudo valódi fordítók bevárása nélkül készít álfordításokat a felület terheléses teszteléséhez. 7 átalakítási stratégiát alkalmaz — ékezeteket, CJK-karaktereket, szövegbővítést, RTL-jelölőket és más módszereket —, miközben megőrzi az ICU-helyőrzőket, a többesszám-szintaxist és az interpolációs változókat.

Telepítés

Az i18n-pseudo npm-csomagként és Homebrew-formulaként érhető el, illetve forrásból is lefordítható a Cargo segítségével.

Terminal
npm install -g @i18n-agent/i18n-pseudo
Az npm-csomag globális parancssori binárist tartalmaz. Nincs szükség futásidejű függőségekre.

7 átalakítási stratégia

Minden stratégia az i18n-hibák egy adott osztályát célozza. Kapcsolókkal külön-külön, előbeállításokkal együtt használhatja őket.

StrategyFlagInputOutput
Accents--accentsHelloĤéľľó
CJK--cjkHello你好世界你好
Special Chars--specialHelloHel­lo
Expansion--expansion NSaveSave~~~~
Brackets--bracketsHello[Hello]
RTL--rtlHello‮Hello‬
Unicode Stress--unicode-stressHelloH́ȩl̈l̀õ
A beégetett karakterláncok észlelésére az ékezetek a legnépszerűbbek. Ha egy karakterlánc ékezetek nélkül jelenik meg a felületen, akkor sosem haladt át a fordítási függvényen.

Előbeállítások

Az előbeállítások gyakori tesztelési helyzetekhez csoportosítják a stratégiákat. A --preset kapcsolóval egyszerre alkalmazhat egy stratégiacsoportot.

PresetStrategiesUse Case
defaultaccents + bracketsQuick visual check that all strings are externalized
layoutexpansion (1.4x) + bracketsCatch truncation and overflow before real translations
charsetCJK + special + bracketsTest font rendering and character encoding
rtlRTL markers + bracketsVerify bidirectional layout without switching locale
fullAll strategies combinedMaximum stress test — everything at once

Használati példák

Futtassa az i18n-pseudo eszközt a forrás területifájlon. Beolvassa a JSON, YAML, PO és más i18n-formátumokat, alkalmazza a kiválasztott stratégiákat, majd kiírja az átalakított eredményt.

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/

Előtte és utána

Így alakítja át az alapértelmezett előbeállítás (ékezetek + zárójelek) egy tipikus fordításfájlt. Figyelje meg, hogy az ICU többesszám-szintaxisa és az interpolációs helyőrzők pontosan megmaradnak.

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 {# íťéɱš}}]"
}
Az olyan helyőrzők, mint a {name} és a {count}, valamint az ICU többesszám-kifejezései sosem módosulnak. Csak a fordítható szövegrészek alakulnak át, így az alkalmazás helyesen rendereli a pszeudofordított fájlokat.

CI-integráció

Adjon pszeudofordítást a CI-folyamathoz az i18n-regressziók automatikus észlelésére. Hozza létre a pszeudofordított fájlokat, majd futtassa rajtuk a vizuális regresszióteszteket.

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
Kombinálja a layout előbeállítást Playwright- vagy Chromatic-vizuális regresszióteszteléssel. Minden komponens, amely 1,4-szeresére bővített szöveggel túlcsordul vagy csonkolódik, megbukik a vizuális összehasonlításon.

Try i18n Agent Now

Drop your translation file here

JSON, YAML, PO, XML, CSV, Markdown, Properties

or click to browse

Target languages

No signup requiredInstant estimate

Gyakran Ismételt Kérdések