Bir çalışma zamanı i18n kütüphanesi ekle, Copilot'un zaten yazdığı metinleri dönüştür, ardından yenilerinin girmesini engelle. Çoğu ekibin yanlış yaptığı adım sonuncusudur, çünkü depo talimat dosyası Copilot'un kod yazdığı her yüzeye ulaşmaz. Chat ve coding agent onu okur, satır içi otomatik tamamlama okumaz. globalize.now, kod tabanını bir kez dönüştüren ve i18n kütüphanenin okuduğu anahtarları ve dil dosyalarını üreten, yapay zekâ destekli yerelleştirme altyapısıdır.

Talimat dosyası ekledikten sonra Copilot neden hâlâ metinleri koda gömüyor?

Çünkü talimat dosyası en hızlı yola bağlı değil. VS Code belgeleri, özel talimatların yazarken aldığın satır içi önerilerde dikkate alınmadığını açıkça söylüyor. Çoğu insan günün büyük kısmını bu modda geçiriyor.

Yani yazdığın kural gerçektir; chat'te Copilot'a bir soru sorduğunda ya da coding agent'a bir görev verdiğinde uygulanır. Ama bir JSX etiketi yazıp gri tamamlamada Tab'a bastığında uygulanmaz. İkisi de commit edilen kod üretir, ama yalnızca biri kuralını okumuştur.

Hangi Copilot yüzeyleri talimatlarını okur?

Deponuza üç yüzey kod yazar ve üçü aynı davranmaz.

YüzeyTalimatları okur mu?Çıktının düştüğü yer
Satır içi tamamlamalarHayırDoğrudan düzenlediğin dosyaya
Chat ve agent modeEvetEditörde gözden geçirdiğin değişikliklere düşer
Coding agentEvetGözden geçirdiğin taslak bir PR'a

Bu sorun için üçünün en elverişlisi coding agent'tır. Ona bir issue atarsın, arka planda çalışır ve taslak bir PR açar. Çıktısı, gözden geçirenin zaten baktığı bir yere düşer. Satır içi tamamlamalar ise hiçbir kapıdan geçmeden gelir.

Bir Copilot projesinde i18n nasıl kurulur?

Önce framework'ünün istediği runtime kütüphanesini seç. Next.js App Router için next-intl, diğer tüm React uygulamaları için react-i18next, derleme zamanında metin çıkarma ve PO kataloğu istiyorsan Lingui işini görür. Üçünü next-intl, react-i18next ve Lingui karşılaştırmasında ele aldık.

Copilot, Lovable ya da Bolt gibi belirli bir framework'e bağlı değil. Yani stack seçimi gerçekten açık, kütüphaneyi sen seçiyorsun. Tartışmaya açık olmayan şey ise sıra: Önce kütüphaneyi kur, mevcut metinleri dönüştür, önleme kurallarını en son düşün. Hâlâ %90'ı koda gömülü İngilizce olan bir kod tabanına yazılan önleme kuralı, ölçecek hiçbir şey vermez.

.github/copilot-instructions.md dosyasına ne yazılmalı?

Bu yola konan bir depo talimat dosyası otomatik algılanır ve çalışma alanındaki sohbet isteklerine uygulanır. GitHub'ın kendi önerisi şöyle: Her talimatı kısa ve kendi başına anlaşılır tut, gerekçeyi açıkla, linter'ın zaten denetlediği şeyleri yazma. Bu önerilere uyan bir i18n bölümü küçük olur:

## User-facing text

- User-facing text belongs in the message catalog, never in a component literal.
- Use the translation function from our i18n library for every visible string.
- Reason: a literal cannot be translated and does not show up as a missing key,
  so it ships silently in one language.
- Add new English values to the source catalog only. Never hand-edit other locales.
- Not user-facing: test names, log lines, error codes, internal constants.

Son satır göründüğünden daha önemli. Gereğinden fazla uygulanan kurallar yok sayılır. Agent'a log mesajlarını sarmalamasını söyleyen bir kural, tüm bölümün gürültü olduğunu öğretir. Henüz hiç talimat dosyan yoksa VS Code, chat'teki init komutuyla kod tabanından bir taslak çıkarabilir. Bu, boş dosyayla başlamaktan daha iyi bir çıkış noktası.

Yola özel bir talimat dosyası daha iyi sonuç verir mi?

Evet, üstelik bu, diğer editörlerin kural dosyalarında olmayan, yalnızca Copilot'un sunduğu bir kaldıraç. .github/instructions altında saklanan ve .instructions.md ile biten dosyalar frontmatter'larında bir applyTo glob'u taşır ve yalnızca agent eşleşen bir dosyaya dokunduğunda yüklenir.

---
name: 'UI strings'
description: 'String handling rules for components'
applyTo: '**/*.{jsx,tsx}'
---
Every visible string in this file must come from the catalog.
Key format is feature.element.state, lowerCamelCase.
If you add a key here, add its English value to the source catalog in the same change.

Kuralı bileşen dosyalarıyla sınırlamak, onu inandırıcı kılar. Kullanıcıya görünen metinlerin bulunduğu yerde devreye girer, API route'larında ve migration script'lerinde susar. Depo kökünde zaten bir AGENTS.md ya da CLAUDE.md tutuyorsan Copilot bunları da her zaman açık talimat olarak okur. Yani birden fazla agent kullanan bir ekibin araç başına ayrı dosya tutmasına gerek yok.

Talimatların kaçırdığı metinleri ne yakalar?

CI'daki bir lint kuralı, çünkü bu stack'te build'i başarısız kılan tek katman o. Talimatlar ihtimali değiştirir, başarısız bir kontrol sonucu değiştirir. Bu denetim katmanını AI agent'ların neden sürekli koda gömülü metin eklediğini anlattığımız yazıda ayrıntılı işledik. Aynı kurulum Copilot kullanan bir depoda da olduğu gibi geçerlidir.

Copilot'a özgü ek ise PR. Depo talimatları chat'in yanı sıra Copilot code review'a da uygulanır. Yani kod üretimini şekillendiren dosya, coding agent'ın taslak PR'ına gelen review yorumlarını da şekillendirir. Böylece satır içi otomatik tamamlamanın aşamayacağı tek bir kapı elde edersin. Bu yazının başındaki boşluğa en yakın çözüm bu.

Bunların hiçbiri depodaki mevcut borcu silmez, hiçbiri bir dil dosyasını da doldurmaz. Review'da bir sabit metin yakalamak, bir metnin eksik olduğunu söyler. Metne anahtar vermek, çevirmek ve diğer dillerin senkronizasyondan çıkmasını önlemek yine birinin işi.

globalize.now bu resmin neresinde?

Kataloğu üreten katmanda. i18n kütüphanen de talimat dosyan da bunu yapmaz. Depoyu uygulamadan bağlarsın, globalize.now kod tabanını bir kez dönüştürür: Koda gömülü metinleri anahtarlarla değiştirir ve dil dosyalarını üretir. Bu tek seferlik dönüşümden sonra push job'ları, commit'lerinle gelen yeni katalog birimlerini çevirir.

Çıktı JSON ya da PO olduğu için kataloglar, runtime kütüphanenin zaten okuduğu biçimde gelir. Aynı yaklaşım diğer agentic editörler için de geçerli: Claude Code ve Cursor aynı duvara başka bir yönden çarpıyor. Next.js kod tabanı için adım adım bir rehber de AI ile yazılmış bir Next.js uygulamasına i18n ekleme yazısında var. Geliştirici dokümanları dönüşümü daha ayrıntılı anlatıyor, planlar ise fiyatlandırma sayfasında.

Kısaca

Talimat dosyasını yaz, yola özel bir kuralı bileşen dosyalarına bağla ve CI'a bir lint kuralı ekle. Böylece Copilot'a söylediğin ile Copilot'un yazdığı arasındaki fark, yayına çıkan bir İngilizce metin yerine kırmızı bir build olur. Sonra birikmiş işi bir kez dönüştür ki kuralın koruyacağı tutarlı bir zemin olsun.

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