Apa itu terjemahan semu dan mengapa saya harus menggunakannya?

Terjemahan semu mengganti string sumber dengan versi yang dimodifikasi untuk menyimulasikan sifat terjemahan asli—teks lebih panjang, kumpulan karakter berbeda, arah baca terbalik—tanpa memerlukan penerjemahan sebenarnya. Teknik ini menemukan bug tata letak, string hardcode, masalah pengodean, dan masalah RTL sejak awal pengembangan sebelum Anda membayar terjemahan asli.

Apakah alat ini merusak placeholder dan variabel ICU saya?

Tidak. i18n-pseudo mengurai sintaks pesan ICU dan hanya mentransformasi segmen teks yang dapat diterjemahkan. Placeholder seperti {name}, variabel interpolasi, dan ekspresi bentuk jamak ({count, plural, one {# item} other {# items}'}) dipertahankan tepat apa adanya.

Preset mana yang sebaiknya saya gunakan terlebih dahulu?

Mulailah dengan preset default (aksen + kurung) untuk menemukan string hardcode. Lalu gunakan preset tata letak untuk menemukan teks terpotong dan meluap. Gunakan charset jika mendukung bahasa CJK dan rtl jika mendukung bahasa Arab atau Ibrani.

Bagaimana cara mengintegrasikan terjemahan semu ke CI?

Buat file terjemahan semu dengan 'i18n-pseudo en.json --preset layout -o locales/pseudo/', lalu jalankan pengujian regresi visual (Playwright, Chromatic, Percy) menggunakan bahasa semu. Tata letak yang rusak karena teks memanjang akan terlihat sebagai diff visual.

Alat Terjemahan Semu

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

Uji UI i18n sebelum peluncuran. Buat terjemahan palsu yang menguji tata letak, pengodean, dan rendering dua arah secara ekstrem—tanpa menunggu terjemahan asli.

Masalahnya

UI terlihat sempurna dalam bahasa Inggris. Lalu bahasa Jerman hadir—string 40% lebih panjang merusak setiap tombol dan memotong setiap header tabel. Bahasa Arab membalik seluruh tata letak dan ikon menunjuk ke arah salah. Bahasa Jepang memerlukan tinggi baris berbeda dan kartu yang telah diatur cermat menjadi berantakan. Anda menemukan semuanya setelah membayar terjemahan.

Biaya rata-rata memperbaiki bug tata letak i18n setelah penerjemahan adalah 5-10 kali lebih tinggi dibandingkan menemukannya selama pengembangan. Terjemahan semu menemukan masalah ini secara gratis sebelum Anda mengeluarkan satu dolar untuk terjemahan asli.

Solusinya

i18n-pseudo membuat terjemahan palsu yang menguji UI secara ekstrem tanpa menunggu penerjemah asli. Alat menerapkan 7 strategi transformasi—aksen, karakter CJK, pemanjangan teks, penanda RTL, dan lainnya—sekaligus mempertahankan placeholder ICU, sintaks bentuk jamak, dan variabel interpolasi.

Instalasi

i18n-pseudo tersedia sebagai paket npm, formula Homebrew, atau dapat di-build dari sumber dengan Cargo.

Terminal

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

Paket npm menyertakan binary CLI global. Tidak diperlukan dependensi runtime.

7 Strategi Transformasi

Setiap strategi menargetkan jenis bug i18n tertentu. Gunakan secara terpisah dengan flag atau gabungkan menggunakan 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̃

Aksen adalah strategi paling populer untuk mendeteksi string yang di-hardcode. Jika string tampil tanpa diakritik dalam UI, string tersebut tidak pernah diteruskan melalui fungsi terjemahan.

Preset

Preset menggabungkan strategi untuk skenario pengujian umum. Gunakan --preset untuk menerapkan sekelompok strategi sekaligus.

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

Contoh Penggunaan

Jalankan i18n-pseudo pada file bahasa sumber. Alat membaca JSON, YAML, PO, dan format i18n lainnya, menerapkan strategi yang dipilih, lalu menulis keluaran hasil transformasi.

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/

Sebelum & Sesudah

Berikut hasil preset default (aksen + kurung) pada file terjemahan biasa. Perhatikan bahwa sintaks bentuk jamak ICU dan placeholder interpolasi dipertahankan dengan tepat.

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

Placeholder seperti {name}, {count}, dan ekspresi bentuk jamak ICU tidak pernah diubah. Hanya segmen teks yang dapat diterjemahkan yang ditransformasi sehingga aplikasi dirender dengan benar menggunakan file terjemahan semu.

Integrasi CI

Tambahkan terjemahan semu ke pipeline CI untuk menemukan regresi i18n secara otomatis. Buat file terjemahan semu, lalu jalankan pengujian regresi visual terhadapnya.

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

Gabungkan preset tata letak dengan pengujian regresi visual Playwright atau Chromatic. Komponen yang meluap atau terpotong dengan teks yang diperpanjang 1,4 kali akan gagal dalam diff visual.