Ürün metinleri yerelleştirmeye ancak önce tek kaynakta toplandığında hazır olur: bileşenlere literal olarak dağılmış metinler yeniden yazılarak yerelleştirmeye hazır hale getirilemez, çünkü çevrilecek ortak bir kaynak yoktur. Sade yazım, terim sözlükleri ve stil kılavuzları önemlidir, ama hepsi metinler tek katalogda durduktan sonra işe yarar. Bu sayfa, işe yarayan sırayı anlatır.
Bu konudaki tavsiyelerin çoğu ikinci adımdan başlar: sade yaz, deyimlerden kaçın, çevirmenlere bağlam ver. Hepsi iyi tavsiye, ama aynı mesaj bileşenlerinde birbirinden azıcık farklı beş biçimde duruyorsa hiçbirini uygulayamazsın. Tanımla ilgili arka planı ve ürün metinleri için doğru kaynağın neden kod tabanı olması gerektiğini koda gömülü ürün metinleri sayfasında bulabilirsin. Bu sayfa ise adımların pratik sırasını anlatır.
Yerelleştirmeye hazır ne demek?
Bir çevirmen ya da çeviri aracı, senin metnini alıp tahmin yürütmeden sadık bir çeviri üretebiliyorsa metin yerelleştirmeye hazırdır. Bunun için üç koşul gerekir: her metin tam olarak tek bir ortak yerde durur, her metin tek bir şeyi net biçimde söyler ve çeviren kişi metnin nerede, nasıl kullanıldığını anlayabilir.
Bu üç koşulu sonradan sağlamak eşit kolaylıkta değildir. Net ifadeyi her metinde tek tek iyileştirebilirsin. Bağlamı notlarla ekleyebilirsin. Ama “tam olarak tek ortak yer” yapısal bir koşuldur. Eksikse diğer ikisi için sağlam bir dayanak kalmaz: ikizi başka dosyada duran bir metni iyileştiremezsin, tek adresi olmayan bir mesaja da not ekleyemezsin.
Kaynak, çevirinin kalitesini neden sınırlar?
Çünkü çeviri türev bir iştir ve türev iş, türediği şeyin her kusurunu devralır. Çeviri, kaynaktaki belirsizliği her hedef dile taşır, tutarsızlığı da. Kaynakta bir ekranda “Sign in”, bir başkasında “Log in”, üçüncüsünde “Login” yazıyorsa, her dilde bağımsız çevrilmiş üç terim elde edersin ve hangisinin amaçlanan olduğunu söylemenin yolu kalmaz.
Çevirileri parlatmak gibi olağan çözümün yanlış uçtan başlamasının nedeni de bu. Eklediğin her dil, düzeltilmemiş kaynağın maliyetini çarpar. Kaynağı bir kez düzeltmek, henüz eklemediğin diller dahil her yerde düzeltmek demektir.
Bu sorunun bir adı var. Metin kayması (copy drift), kullanıcıya görünen metnin farklı arayüz noktalarında ve zaman içinde onaylı kaynağından ayrışmasıdır; yani tek doğru kaynak yoktur. Nedenlerini metin kayması nedir sayfasında bulabilirsin. Yerelleştirme bunu pahalı hale getirir, çünkü kayma her dile kopyalanır.
Dağınık metinler neden yerelleştirmeye hazır hale getirilemez?
Çünkü teslim edilecek bir şey yok. Bileşenin içindeki bir literal, çeviri adımının alabileceği bir birim değildir. Markup ve mantıkla iç içedir, parçalardan birleştirilmiş olabilir ve aynı cümle birkaç dosyada, kimsenin bilerek seçmediği küçük farklarla durabilir.
Bu literalleri yerinde yeniden yazmak bunu değiştirmez. Her birini daha net yazabilirsin, ama yine katalog, ürünün ne söylediğine dair ortak bir liste ve hepsini bulup bulmadığını anlamanın bir yolu olmaz. Sonuçta aynı dağınık yerlerde duran daha derli toplu metinler elde edersin.
Bu yüzden ilk adım bir düzenleme işi değil, bir toplama işidir: kullanıcıya görünen her metni depoda, tek kaynak dilde, tek bir katalogda topla ve bileşenlerden anahtarla çağır. Bunu ifadeleri değiştirmeden yap. Bu turun amacı, ürünün şu an ne söylediğini, birbiriyle çelişen kısımlar dahil, ortaya çıkarmaktır.
Metinleri nasıl toplarsın?
Önce kataloga taşı, sonra iyileştir. Bu sıranın iki nedeni var. Taşırken aynı anda yeniden yazarsan ne değiştiği hem gözden geçirenlerden hem senden gizlenir. Her şey tek dosyada olunca da tekrarlar ve neredeyse aynı olan metinler görünmez olmaktan çıkar: yan yana durur ve temizlik tek bir dosyayı okumaya iner.
Pratikte:
- Depoda, kaynak dil başına bir katalog seç. Hem insanların hem araçların okuyabildiği tek geçerli kayıt. Anahtarları nasıl düzenleyip adlandıracağın bir kod tabanında arayüz metinlerini tutarlı tutma sayfasında anlatılıyor. Aynı katalogdan söz ettiğimiz için düzen konusunda o sayfaya bak, burada tekrar etmiyoruz.
- Literalleri anahtar referanslarıyla değiştir. Kullanıcının okuyabildiği her metin için: buton etiketleri, hata mesajları, boş durumlar, tooltip'ler ve genelde unutulan erişilebilirlik metinleri.
- Cümleleri bütün tut. Bir mesaj parçalar birleştirilerek kuruluyorsa, onu değişkenli tek bir girdiye dönüştür. Böylece çevirmenin gördüğü birim, kullanıcının okuduğu birim olur. Kelime sırası dillere göre değişir ve kodda birleştirilen bir cümle buna uyum sağlayamaz.
- Şimdilik yeniden yazma. İçinden gelse de yapma. Özensiz duran metinler çıkacak, onları not al ve devam et.
Bu liste büyük bir kod tabanında bir aylık titiz iş gibi görünüyorsa, adımın gerçek maliyeti budur ve çoğu ekibin burada takılmasının nedeni de bu.
Metinler tek katalogda olunca ne yaparsın?
Artık bilindik tavsiyeler uygulanabilir hale geliyor. Tek katalogla bunların her biri, kod tabanında arama yapmak yerine tek bir geçişe dönüşür:
- Tekrarları ve neredeyse aynı olanları kaldır. Her mesaj için onaylı ifadeyi seç ve tüm kullanımları ona yönlendir.
- Asla değişmemesi gereken terimleri sabitle. Özellik adları, temel eylemlerin fiilleri, kullanmamaya karar verdiğin sözcükler. Bunları bir kez yaz. Bu senin terim sözlüğün ve kısa bir liste.
- Sade yaz. Etken cümle kur, deyim kullanma, tek bir dilin kelime oyununa dayanan şakalardan kaçın, yanlış okunabilecek kısaltmaları açarak yaz. Her metin tek bir şey söylesin.
- Çevirmenlere bağlam ver. Metnin nerede göründüğünü ve bir değişkenin neyi temsil ettiğini anlatan bir not. “Post” ya da “Order” gibi kısa metinler klasik tuzaktır: isim mi fiil mi, hedef dil ikisi için ayrı sözcük isteyebilir.
- Uzunluğa pay bırak. Çevrilmiş metin çoğu zaman kaynaktan uzundur, bu yüzden bir etiket uzadığında bozulmayan arayüzler tasarla. Bunu sabit bir oran değil, bir tasarım kısıtı olarak düşün.
Her adım hızlı ilerler, çünkü hepsi tek yerde, katalogda yapılır. Katalog yoksa aynı beş adım kod tabanında beş ayrı arama maratonuna döner ve işin ne zaman bittiğini asla bilemezsin.
Çeviri sağlayıcısı ya da aracı seçmeden önce neyi netleştirmelisin?
Kaynak ve gözden geçirme süreci. Bir sağlayıcı ya da araç, ona verdiğini çevirir. Temiz bir katalog ve kısa bir terim sözlüğü verirsen iyi iş çıkarır. Dağınık literaller verirsen tutarsızlıkları çevirtmek için para ödersin, sonra her dilde düzeltmek için bir kez daha ödersin.
Önce üç şeye karar ver: Hangi dosya tek doğru kaynak olacak? İfade değişikliğini kim onaylayacak? Değişen ya da yeni bir metin çeviriye nasıl ulaşacak: elle mi, bir script'le mi, yoksa çevirileriyle birlikte gelen bir pull request'le mi? Sonuncusu, çevirilerin kaynağın gerisinde kalmasını önleyen yöntem. Bu sorun çeviri dosyaları neden uyumsuzlaşır sayfasında anlatılıyor.
Metinler zaten depodaysa ne değişir?
Yerelleştirme ayrı bir proje olmaktan çıkar. Katalog depodayken yeni ya da değişen bir metin diff'te bir satır olarak görünür, çevirileri de kodla aynı pull request akışında üretilip gözden geçirilebilir. Kimsenin elektronik tabloyu dışa aktarıp doğru sırayla geri geleceğini ummasına gerek kalmaz.
Bir kod tabanında metinleri tutarlı tutmak ile yerelleştirmeye hazır tutmak bu yüzden aynı işlemdir. İkisi de ortak tek bir kaynağa dayanır. İşi bir kez yaparsan ikisini birden elde edersin. AI kodlama araçlarıyla geliştiren ekipler bunu daha erken hisseder, çünkü katalog ve bir lint kuralı engel olmazsa bir agent sessizce metni yeniden yazar ya da bir literali geri getirir. AI kodlama agent'larının arayüz metinlerini yeniden yazmasını durdurma sayfası bu durumu ele alıyor.
globalize.now'ın yeri
globalize.now, yerelleştirmesi yerleşik, kod odaklı bir metin yönetim sistemidir. Yukarıdaki tek kaynakta toplama adımı, senin yerine yaptığı iştir. Uygulamada bir GitHub ya da GitLab deposu bağlarsın. Bir tarama ortada ne olduğunu çıkarır. Metinler bileşenlerin içinde koda gömülü duruyorsa tek seferlik bir dönüşüm bunları anahtarların arkasına, bir kataloğa taşır ve i18n kurulumu yoksa onu da ekler. next-intl, react-i18next, i18next ya da Lingui gibi bir kütüphane kullanıyorsan elindekiyle çalışır. Sonuç kendi branch'inde bir pull request olarak gelir, yani ilk katalog yukarıda anlatılan gözden geçirmeden aynen geçer. Sonrasında eklediğin yeni kaynak metinler, sonucu pull request olarak açan push job'larıyla çevrilir. Depo tek doğru kaynak olarak kalır. Mevcut i18n rehberi, bir kurulum zaten varken taramanın neleri bulduğunu adım adım anlatıyor.
Aynı düzenin pazarlama sitesinde, açılış sayfasında ve üründe tek kaynaktan sağlanması için çalışıyoruz. Bu gitmek istediğimiz yön, bugün satın alabileceğin bir şey değil. Fiyatlar fiyatlandırma sayfasında.
Kısaca sıra
- Kullanıcıya görünen her metni depoda tek katalogda topla. İfadeleri değiştirme.
- Cümleleri bütün tut ve her metne anahtarla eriş.
- Tekrarları kaldır ve onaylı ifadeyi bir kez seç.
- Asla değişmeyen terimlerin kısa sözlüğünü yaz.
- Sade dil için düzenle ve çevirmenlere bağlam notları ekle.
- İfadeyi kimin onaylayacağına ve değişen metinlerin çeviriye nasıl ulaşacağına karar ver.
- Ancak bundan sonra çeviri sağlayıcısını ya da aracını seç veya değiştir.
İlk adım ay süren bir iş gibi görünüyorsa bir depo bağla, önerdiği planı oku ve açtığı pull request'i gözden geçir.
globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.
globalize.now'ı ücretsiz dene