Teks produk siap dilokalisasi ketika sudah dijadikan satu sumber lebih dulu: teks yang tersebar di komponen sebagai literal tidak bisa disiapkan untuk lokalisasi dengan menulis ulang, karena tidak ada sumber yang disepakati untuk diterjemahkan. Memperjelas kalimat, menyusun glosarium, dan menulis panduan gaya semuanya penting, tetapi baru berguna setelah teks berada di satu katalog. Halaman ini memuat urutan langkahnya, dari yang pertama sampai terakhir.

Kebanyakan saran tentang topik ini dimulai dari langkah kedua. Isinya: tulis dengan bahasa lugas, hindari idiom, dan beri konteks untuk penerjemah. Semua saran itu benar, tetapi tidak ada yang bisa dijalankan selama pesan yang sama ada dalam lima bentuk yang sedikit berbeda di berbagai komponen. Latar belakang definisi dan argumen mengapa codebase harus menjadi single source of truth untuk teks produk ada di teks produk yang native di kode. Halaman ini membahas urutan kerja praktisnya.

Apa arti siap dilokalisasi?

Artinya penerjemah, atau alat terjemahan, bisa menerima teksmu dan menghasilkan versi yang setia tanpa menebak-nebak. Syaratnya ada tiga: setiap teks ada di tepat satu tempat yang disepakati, setiap teks menyampaikan satu hal yang jelas, dan siapa pun yang menerjemahkannya tahu di mana serta bagaimana teks itu dipakai.

Ketiganya tidak sama mudahnya untuk diperbaiki belakangan. Redaksi yang jelas bisa diperbaiki satu teks per satu teks. Konteks bisa ditambahkan sebagai catatan. Namun “tepat satu tempat yang disepakati” bersifat struktural. Tanpa itu, dua syarat lainnya tidak punya pijakan yang stabil: kamu tidak bisa memperbaiki teks yang kembarannya ada di file lain, dan tidak bisa memberi catatan pada pesan yang tidak punya satu alamat.

Mengapa sumber membatasi kualitas terjemahan?

Karena terjemahan adalah karya turunan, dan karya turunan mewarisi setiap cacat dari sumbernya. Terjemahan membawa ambiguitas sumber ke setiap bahasa target, begitu juga inkonsistensinya. Jika sumber memakai “Sign in” di satu layar, “Log in” di layar lain, dan “Login” di layar ketiga, kamu kini punya tiga istilah di setiap bahasa, diterjemahkan sendiri-sendiri, tanpa cara untuk menentukan mana yang dimaksud.

Inilah sebabnya perbaikan yang biasa dilakukan, yaitu memoles terjemahan, salah sasaran. Setiap bahasa yang kamu tambahkan melipatgandakan biaya akibat sumber yang belum diperbaiki. Memperbaiki sumber sekali berarti memperbaikinya di mana-mana, termasuk di bahasa yang belum kamu tambahkan.

Kegagalan mendasar ini punya nama. Copy drift adalah teks yang terlihat pengguna menyimpang dari sumber yang disetujui di berbagai tampilan dan seiring waktu, tanpa single source of truth. Apa itu copy drift membahas penyebabnya. Di tahap lokalisasi, masalah ini menjadi mahal karena drift ikut disalin ke setiap bahasa.

Mengapa teks yang tersebar tidak bisa disiapkan untuk lokalisasi?

Karena tidak ada yang bisa diserahkan. Literal di dalam komponen bukan unit yang bisa langsung diambil oleh langkah terjemahan. Teks itu bercampur dengan markup dan logika, mungkin dirakit dari potongan-potongan, dan kalimat yang sama bisa ada di beberapa file dengan perbedaan kecil yang tidak pernah sengaja dibuat.

Menulis ulang literal itu di tempat tidak mengubah keadaan ini. Kamu bisa membuat tiap teks lebih jelas, tetapi tetap tidak punya katalog, tidak punya daftar yang disepakati tentang apa saja yang disampaikan produk, dan tidak tahu apakah semuanya sudah ditemukan. Hasilnya teks yang lebih rapi, tetapi tetap tersebar di tempat yang sama.

Jadi langkah pertama bukan pekerjaan menyunting. Ini pekerjaan mengumpulkan: masukkan setiap teks yang terlihat pengguna ke satu katalog, satu bahasa sumber, di repositori, dan rujuk dengan kunci dari komponen. Lakukan tanpa mengubah redaksi. Tujuan tahap ini adalah mengetahui apa yang saat ini dikatakan produk, termasuk bagian-bagian yang saling bertentangan.

Bagaimana cara mengumpulkan teksnya?

Pindahkan ke katalog dulu, perbaiki kemudian. Ada dua alasan untuk urutan ini. Tahap campuran, saat kamu menulis ulang sambil memindahkan, menyembunyikan apa yang berubah dari reviewer dan dari dirimu sendiri. Begitu semuanya ada di satu file, duplikat dan teks yang nyaris sama langsung terlihat: semuanya berdampingan, dan pembersihan cukup dengan membaca satu file.

Secara praktis:

  • Pilih satu katalog per bahasa sumber, di repo. Salinan acuan yang bisa dibaca manusia maupun alat. Cara menata dan menamai kunci dibahas di cara menjaga konsistensi teks UI di seluruh codebase; katalognya sama, jadi halaman itu menjadi acuan tata letak dan halaman ini tidak mengulanginya.
  • Ganti literal dengan referensi kunci. Setiap teks yang bisa dibaca pengguna, termasuk label tombol, pesan error, tampilan kosong, tooltip, dan teks aksesibilitas, yang biasanya paling sering terlewat.
  • Jaga kalimat tetap utuh. Jika pesan dibangun dengan menyambung potongan, jadikan satu entri dengan variabel, sehingga unit yang dilihat penerjemah sama dengan unit yang dibaca pengguna. Urutan kata berbeda antarbahasa, dan kalimat yang dirakit di kode tidak bisa mengikutinya.
  • Jangan ubah redaksi dulu. Tahan dirimu. Kamu pasti menemukan yang janggal; catat saja dan lanjutkan.

Jika daftar itu terdengar seperti sebulan kerja teliti di codebase besar, itulah biaya jujur dari langkah ini, dan alasan mengapa di sinilah kebanyakan tim berhenti.

Apa yang perlu kamu lakukan setelah semua teks berada di satu katalog?

Sekarang saran-saran yang sudah umum itu akhirnya punya sesuatu untuk dikerjakan. Dengan satu katalog, masing-masing menjadi satu kali pengerjaan, bukan perburuan:

  1. Hapus duplikat dan teks yang nyaris sama. Pilih redaksi yang disetujui untuk setiap pesan, lalu arahkan semua pemakaian ke sana.
  2. Tetapkan istilah yang tidak boleh bervariasi. Nama fitur, kata kerja untuk aksi inti, dan kata yang sudah kamu putuskan untuk tidak dipakai. Tulis sekali saja. Itulah glosariummu, dan isinya singkat.
  3. Tulis dengan lugas. Kalimat aktif, tanpa idiom, tanpa lelucon yang bergantung pada permainan kata satu bahasa, akronim dijabarkan jika bisa disalahartikan. Setiap teks menyampaikan satu hal.
  4. Beri konteks untuk penerjemah. Catatan tentang di mana teks muncul dan apa yang diwakili variabel. Teks pendek seperti “Post” atau “Order” adalah jebakan klasik: kata benda atau kata kerja, dan bahasa tujuan mungkin butuh kata berbeda untuk masing-masing.
  5. Sediakan ruang untuk panjang teks. Teks terjemahan sering lebih panjang daripada sumbernya, jadi rancang layout yang tidak rusak saat label memanjang. Anggap ini sebagai batasan desain, bukan angka untuk diperkirakan.

Setiap langkah cepat karena semuanya dikerjakan di satu tempat: katalog. Tanpa katalog, kelima langkah itu menjadi lima perburuan di seluruh codebase, dan kamu tidak pernah tahu kapan selesai.

Apa yang perlu kamu putuskan sebelum memilih vendor atau alat terjemahan?

Sumber dan alur review. Vendor atau alat menerjemahkan apa yang kamu berikan. Beri katalog yang bersih dan glosarium singkat, maka hasilnya bisa bagus. Beri literal yang tersebar, dan kamu membayar untuk menerjemahkan inkonsistensi, lalu membayar lagi untuk memperbaikinya di setiap bahasa.

Putuskan tiga hal lebih dulu. File mana yang menjadi sumber acuan utama. Siapa yang menyetujui perubahan redaksi. Dan bagaimana teks baru atau yang berubah sampai ke penerjemahan: manual, lewat skrip, atau lewat pull request yang datang bersama terjemahannya. Opsi terakhir yang menjaga terjemahan tidak tertinggal dari sumbernya, masalah yang dibahas di mengapa file terjemahan tidak sinkron.

Apa yang berubah ketika teks produk sudah ada di repositori?

Lokalisasi tidak lagi menjadi proyek terpisah. Ketika katalog ada di repo, teks baru atau yang berubah muncul sebagai satu baris di diff. Terjemahannya bisa dihasilkan dan di-review lewat alur pull request yang sama dengan kode. Tidak ada lagi yang perlu mengekspor spreadsheet lalu berharap hasilnya kembali dengan urutan yang benar.

Itulah sebabnya di codebase, menjaga konsistensi teks dan menyiapkannya untuk lokalisasi merupakan satu pekerjaan yang sama. Keduanya bergantung pada satu sumber yang disepakati. Kerjakan sekali, dapatkan keduanya. Tim yang membangun dengan alat coding AI merasakannya lebih dulu, karena agen akan diam-diam menulis ulang teks atau memunculkan kembali literal kecuali ada katalog dan aturan lint yang menghalanginya; cara menghentikan agen coding AI menulis ulang teks UI-mu membahas kasus itu.

Posisi globalize.now

globalize.now adalah sistem manajemen teks berbasis kode dengan lokalisasi bawaan, dan langkah menjadikan satu sumber di atas adalah bagian yang dikerjakannya untukmu. Kamu menghubungkan repositori GitHub atau GitLab di aplikasi. Pemindaian memetakan isinya. Jika teksnya berupa literal di dalam komponen, konversi satu kali memindahkannya ke katalog dan menggantinya dengan kunci, lalu menambahkan setup i18n jika belum ada. Jika kamu sudah memakai library seperti next-intl, react-i18next, i18next, atau Lingui, globalize.now bekerja dengan yang sudah ada. Hasilnya datang sebagai pull request di branch tersendiri, sehingga katalog pertama melewati review persis seperti yang dijelaskan di atas. Setelah itu, teks sumber baru yang kamu tambahkan diterjemahkan oleh push job yang membuka pull request berisi hasilnya. Repositori tetap menjadi satu-satunya sumber acuan, dan panduan untuk setup i18n yang sudah ada menjelaskan apa yang ditemukan pemindaian saat setup sudah ada.

Kami sedang membangun agar disiplin yang sama berlaku di situs pemasaran, landing page, dan produk dari satu sumber. Itu arah yang kami tuju, bukan sesuatu yang bisa dibeli hari ini. Harga ada di halaman harga.

Ringkasan urutannya

  1. Kumpulkan setiap teks yang terlihat pengguna ke satu katalog di repositori. Jangan ubah redaksi.
  2. Jaga kalimat tetap utuh dan rujuk setiap teks dengan kunci.
  3. Hapus duplikat dan pilih redaksi yang disetujui sekali saja.
  4. Tulis glosarium singkat berisi istilah yang tidak boleh bervariasi.
  5. Sunting agar bahasanya lugas dan tambahkan catatan konteks untuk penerjemah.
  6. Putuskan siapa yang menyetujui redaksi dan bagaimana teks yang berubah sampai ke penerjemahan.
  7. Baru setelah itu pilih, atau ganti, vendor atau alat terjemahan.

Jika langkah pertama terlihat seperti sebulan kerja, hubungkan repositori, baca rencana yang diusulkan globalize.now, dan review pull request yang dibukanya.

globalize.now mengubah teks hardcode di aplikasimu menjadi file locale yang siap diterjemahkan, lalu menjaganya tetap diperbarui setiap kali kamu rilis.

Coba globalize.now gratis