Codex, Claude Code veya Cursor'ın tek bir prompt'la çevirdiği bir uygulamayı yayına almadan önce yedi şeyi kontrol et: uzun metinler sığıyor mu, çoğul biçimleri her dilde doğru mu, değişkenler yerinde mi, terimler tutarlı mı, ton ana dili konuşan birine doğal geliyor mu, her anahtar her locale'de var mı ve bir sonraki özellik çevrilecek mi? globalize.now, yapay zekâ destekli yerelleştirme altyapısıdır. Tek seferlik bir çeviriden sonra gördüğümüz sorunların çoğu mekaniktir ve bu iyi bir haber: mekanik sorunlar kontrol edilebilir.
Sorun nadiren ilk geçişte çıkar. Güncel agent'lar okunaklı çevirileri hızla üretiyor. Tek bir prompt'ın içermediği şey, çıktıyı doğrulayan herhangi bir adımdır; aşağıdaki kontroller de tam olarak o adımdır.
Çeviriden sonra metin sığıyor mu?
Çoğu zaman sığmıyor ve ilk bozulan yer butonlar oluyor. W3C'nin çeviride metin boyutuna dair rehberi, kaynak mesaj ne kadar kısaysa olası genişlemenin o kadar büyük olduğunu belirtiyor. Yani iki kelimelik bir buton etiketi, bir paragraftan oransal olarak daha fazla uzar. Rehber ayrıca Almanca gibi dillerdeki birleşik adların satır sonunda bölünmeyebileceğine ve bazı yazı sistemlerinin Latin harflerinden daha fazla yatay ya da dikey alan istediğine dikkat çekiyor.
Bir JSON dosyasındaki metinleri çeviren agent ekranı hiç görmez; dolayısıyla “Save changes” karşılığının butonu kenardan kenara doldurduğunu bilemez. Uygulamayı yayınladığın en uzun locale'de çalıştır, ana akışları gez ve kesilmiş metinlere, birden fazla satıra taşan butonlara ve kırpılmış tablo başlıklarına bak. Sağdan sola yazılan dilleri destekliyorsan aynı turu bunlardan birinde de yap; Lovable uygulamaları için Arapça ve RTL rehberi yön konusunu ele alıyor, taşma kontrolleri ise bunu yakalamaz.
Kalıcı çözüm daha kısa çeviriler değil, düzendir: container'ların büyümesine izin ver, metinlerde sabit genişlikten kaçın ve sığsın diye kısaltma yapma. Bu kısmı agent'a yaptır, çünkü bu bir kod işi.
Çoğul biçimleri hedef dille uyumlu mu?
Bunu erken kontrol et, çünkü sessizce bozulur. Unicode CLDR altı çoğul kategorisi tanımlar: zero, one, two, few, many ve other. İngilizce yalnızca one ve other kullanır. Rusça one, few, many ve other kullanır. Galce altısını da kullanır; i18next dokümantasyonu da Arapça için altı çoğul anahtarının tamamını gösterir.
İngilizce çifti bir Rusça veya Arapça dosyasına kopyalayan bir agent, ayrıştırılan ve render edilen bir katalog üretir; ancak dosyada bulunmayan bir kategori gerektiren her sayı için yanlış biçim gösterilir. Hata vermez. i18next'te değişkenin adının tam olarak count olması gerekir; dokümantasyona göre eksikse düz anahtara fallback yapılmaz. Aynı agent bir component'te count === 1 ? 'item' : 'items' yazdığında, çeviri başlamadan aynı hata zaten oluşmuştur; sözdizimi tarafını ICU MessageFormat nedir ve neden yapay zekâ üretimi uygulamaları zorlar yazısında bulabilirsin.
Kontrol mekaniktir: her locale için çoğul anahtarlarını, o dilin gerektirdiği kategorilerle karşılaştır.
Interpolation değişkenleri korunmuş mu?
Her zaman değil, ama bir script bunu netleştirir. {{name}} veya {count} gibi interpolation değişkenleri her çeviride aynen yazıldığı gibi bulunmalı. Uzun bir dosyayı çeviren agent'lar bazen bir değişkeni yeniden ifade eder, cümle onsuz daha iyi okunuyorsa siler ya da bir tag'in içeriğini çevirir. Sonuç boş bir alan, ekrana basılan bir süslü parantez ya da bir çökme olarak görünür.
Çevrilen her metindeki değişken kümesini kaynak metinle karşılaştır. Aşağıdaki kısa Node script'i bunu yapar, ayrıca İngilizce'de olup başka bir locale'de bulunmayan anahtarları da raporlar:
import fs from "node:fs";
const [src, ...targets] = process.argv.slice(2);
const read = (f) => JSON.parse(fs.readFileSync(f, "utf8"));
const vars = (s) =>
[...String(s).matchAll(/\{\{?\s*[\w.]+\s*\}?\}/g)].map((m) => m[0]).sort().join(",");
const base = read(src);
let problems = 0;
for (const file of targets) {
const loc = read(file);
for (const [key, text] of Object.entries(base)) {
if (!(key in loc)) { console.log(file, "missing", key); problems++; continue; }
if (typeof text === "string" && vars(text) !== vars(loc[key])) {
console.log(file, "variable mismatch", key); problems++;
}
}
}
process.exit(problems ? 1 : 0);
CI'da node check-locales.mjs locales/en.json locales/de.json locales/ru.json olarak çalıştır. Script tek seviyeli anahtar dosyalarını varsayar; kataloğun iç içeyse döngüyü uyarla.
Terminoloji tutarlı mı?
Tek bir yanıtın içinde tutarlıdır, birkaç yanıt boyunca kayar. Büyük bir uygulamanın çevirisi dosyalara, oturumlara ya da batch'lere bölünürse “workspace”, “project” ve ürün adının her seferinde aynı şekilde çıkmasını hiçbir şey garanti etmez. Sonunda bir butonda bir şey yazar, yardım sayfasında başka bir şey.
Terimleri bir kez yaz: ürün adları, özellik adları ve çevrilmemesi gereken kelimelerden oluşan bir terim sözlüğü hazırla ve çeviri adımının bunu okumasını sağla. globalize.now kod tabanı dönüştürülürken ortak bir terim sözlüğü oluşturur; böylece terimler, herhangi bir çeviri yapılmadan önce veri olarak hazır olur. Araç kullanmıyorsan asgari çözüm, agent talimatlarından referans verilen kısa bir sözlük dosyasıdır; bu talimatların nerede durduğunu AGENTS.md kuralları yazısı gösteriyor.
Ana dili konuşan birine doğal geliyor mu?
Script'in yapamayacağı tek kontrol bu. Tek seferlik çevirilerin makine işi gibi okunduğu yerler hitap düzeyi, resmiyet ve harf büyüklüğüdür: yanlış resmiyet seviyesi, komut gibi duyulan emir kipli butonlar, tamamen büyük harfle yazılmış başlığın bağırmak gibi okunduğu bir dilde büyük harfli başlık.
Her metni gözden geçirme. Yayınladığın her dil ailesinden bir dil seç ve ana dili konuşan birine ilk çalıştırma ekranlarını, ödeme ya da kayıt akışını ve hata mesajlarını okut. Tonun kullanıcı kaybettirdiği ekranlar bunlar. Düzeltmeleri terim sözlüğüne işle ki bir sonraki çalıştırma onlardan başlasın.
Her anahtar var mı, her metin kataloğa girmiş mi?
İki farklı boşluk ekranda aynı görünür. Bir anahtar İngilizce'de var, bir locale'de eksik olabilir; yukarıdaki script bunu yakalar. Ya da bir metin doğrudan component'in içine gömülmüş olabilir ve hiç kataloğa ulaşmadığı için hiçbir çeviri onu kapsayamaz. Agent'lar ikinci türü görünür metinden çok attribute'larda, toast'larda ve hata mesajlarında bırakıyor; bu örüntüyü ve onu yakalayan lint kuralını agent'ların neden sürekli koda gömülü metin eklediği yazısında bulabilirsin.
Uygulamayı İngilizce olmayan bir locale'e geçir ve içinde gez. Kalan her İngilizce metin ya eksik bir anahtardır ya da sisteme hiç girmemiş bir metin; çözümleri de farklıdır.
Bir sonraki özellik çevrilecek mi?
Ancak çeviri, kodun yayına çıkış yolunun bir parçasıysa. Tek prompt'luk bir çalıştırmanın geçemeyeceği kontrol de bu. Prompt, uygulamayı o öğleden sonraki haliyle çevirdi. Agent'ın yazdığı bir sonraki özellik aynı dosyalarda İngilizce olarak gelir ve locale'ler özellik özellik geride kalır. Bunun nasıl biriktiğini Çeviri dosyaları neden senkronizasyondan çıkar yazısında anlattık.
Tek seferlik yaklaşımla bir pipeline'ı ayıran nokta burası. Yerelleştirmenin geliştirme döngüsüne taşınması yazısı bu konumlanma savını anlatır; pratikteki hali şu: dönüştürme bir kez yapılır, sonraki değişiklikler yapıldıkları yerde çevrilir. globalize.now ile depoyu uygulamada bağlarsın, kod tabanı bir kez dönüştürülür; bundan sonra push job'ları yeni katalog birimlerini çevirir ve sonuçlar, gözden geçirip merge edeceğin değişiklikler olarak gelir. Runtime kütüphanesi ve katalog formatı sende kalır. Zaten bir çevirmeni olan ekipler o gözden geçirme adımını korur; bu adım yalnızca, İngilizce kod ile yayın arasındaki tek engel olmaktan çıkar.
İşi kendi script'lerinde tutmak istersen asgari çözüm, yukarıdaki script'in CI'da çalışması ve yeni metinlerin katalogdan geçmesini zorunlu kılan bir kural. Yapay zekânın ürettiği bir uygulamayı yerelleştirme yazısı tüm yolu adım adım anlatıyor, Claude Code rehberi ise bu agent'ı özel olarak ele alıyor.
Nereden başlamalı?
Script'i bugün mevcut dil dosyalarında çalıştır; bir dakika sürer ve yapının sağlam olup olmadığını söyler. Sonra uygulamayı en uzun locale'inde aç ve ilk çalıştırma akışını gez. Yapay zekâyla geliştirilmiş bir uygulaman varsa ve dönüştürme, çeviri ve sonraki güncellemelerin elle yürütülmesi yerine halledilmesini istiyorsan, genel bakış için vibe coder'lar sayfası, agent kurulumları için geliştirici referansı var; fiyatlandırma ise ayrı bir sayfada.
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