globalize.now'ı Cursor ile kullanma
Cursor ile geliştirilen uygulamalardan metinleri çıkar ve dil dosyalarını tek komutla oluştur.
Cursor çalışan arayüzü hızlıca üretir ama İngilizce metinleri genellikle doğrudan JSX'e gömer. globalize.now bu koda gömülü metinleri çıkarır, çeviri anahtarlarını üretir ve dil dosyalarını oluşturur; Cursor ile yazılmış uygulamayı çeviriye hazır bir kod tabanına dönüştürür. Kurulum tek komuttur, sonrasında her Git push'unda senkronize eder.
Ön koşullar
- Cursor ile geliştirilmiş bir proje
- Bir Git deposu
- Node.js 18+
- Kurulu herhangi bir JavaScript i18n kütüphanesi (i18next, next-intl vb.); sıfırdan başlıyorsan hiçbiri gerekmez
Cursor ile globalize.now nasıl kurulur
Cursor projeni aç ve Git'i doğrula
Depoyu Cursor'da aç ve kod tabanının commit edilip bir Git remote'una push edildiğinden emin ol; böylece sonraki push'lar senkronizasyonu tetikleyebilir.
Proje kök dizininde Skill yükleyicisini çalıştır
Depoyu uygulamada dönüştürmek için globalize.now'a bağla ya da depo kökünde bir terminalde Globalize agent Skill'lerini yükle; böylece asistanın i18n iskeletini kurup dizin ağacını tarayabilir.
npx skills add globalize-now/globalize-skills --allAgent'ın kod tabanını analiz etmesine izin ver
Agent'ın yönlendirmelerini izle; bileşenlerin ve route'ların içindeki koda gömülü, kullanıcıya görünen metinleri bulsun.
Önerilen çeviri anahtarı yapısını incele
Branch'ine herhangi bir refactor girmeden önce önerilen anahtar yapısına ve adlandırmaya göz at.
Çıkarma işlemini ve dil dosyalarını onayla
Değişiklikleri onayla; anahtarlar üretilsin, bileşenler sabit metin yerine çalışma zamanı i18n API'ni çağırsın ve dil dosyaları depoya yazılsın.
Commit et ve push'la
Değişiklikleri commit edip varsayılan branch'ine push'la; böylece globalize.now sonraki Git push'larda yeni metinleri hizalı tutabilir.
MCP ile bağlan (isteğe bağlı)
Globalize'ı Cursor'dan yönetmeyi mi tercih ediyorsun? Kodun i18n'e hazır olduktan sonra MCP'yi bağla.
~/.cursor/mcp.json dosyasına ekle
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}Devamı: MCP'yi bağla
Sık karşılaşılan sorunlar
Cursor sürekli yeni koda gömülü metinler ekliyor
Çözüm: globalize.now her Git push'ta çalışır; yeni sabit metinler sürümler arasında sessizce birikmek yerine otomatik olarak yakalanır.
Çeviri anahtarları mevcut bir i18n kurulumuyla çakışıyor
Çözüm: globalize.now mevcut i18n kütüphanelerini algılar ve onların kurallarına uyar; yeni anahtarlar mevcut kataloğunla çatışmak yerine onu genişletir.
Sık sorulan sorular
globalize.now, Cursor ile üretilen her projede çalışır mı?
Evet, stack globalize.now'ın agent Skill'leri üzerinden desteklediği bir yapıdaysa (Next.js, React ya da Vue gibi modern JavaScript framework'leri). globalize.now koda gömülü arayüz metinlerini çıkarıp anahtar ve dil dosyası üretmeye odaklanır; JSX'i hangi editörün ürettiği önemli değildir. Yine de proje kökünden npx skills add globalize-now/globalize-skills komutunu çalıştırıp yönlendirmeleri izlemen gerekir; böylece agent depoyu tarayıp merge edilebilir diff'ler açabilir.
globalize.now'ı Cursor'a özgü kalıpları algılaması için yapılandırmam gerekir mi?
Cursor için ayrı bir entegrasyon gerekmez. globalize.now, dosyaları elle ya da Cursor yazmış olsun, depoyu aynı şekilde analiz eder. Skill'ler kullanıcıya görünen sabit metinleri ve routing yapısını tarar, ardından benimsediğin i18n kütüphanesine uyan anahtarlar önerir. Planı diğer değişiklikler gibi Git'te gözden geçirirsin.
Kısmi i18n'i olan bir Cursor projesinde globalize.now kullanabilir miyim?
Evet. Araç, anahtarlar ve dil dosyaları zaten varsa mevcut katalogları genişletecek şekilde tasarlandı. globalize.now kullandığın runtime kütüphanesini algılar ve önceki işi çöpe atmak yerine eklemeler önerir. Böylece koda gömülü metinleri kademeli olarak taşıyabilirsin. Yeni arayüz de kapsamda kalsın diye Git push'larını sürdür.
globalize.now çıktısı bir Cursor projesinde hangi i18n kütüphaneleriyle çalışır?
globalize.now kütüphaneden bağımsızdır: i18next, next-intl, react-intl, Lingui ve vue-i18n gibi yaygın runtime'larla eşleşen yapılandırılmış anahtarlar ve dil dosyaları üretir. Cursor projen hangi stack'i seçtiysen onu korur; globalize.now çıkarma ve senkronizasyon katmanını sağlar. Agent skill'leri, framework'ünün beklediği provider'ı ya da middleware'i bağlamana yardım eder.
globalize.now, Cursor'ın ürettiği bileşenleri değiştirir mi?
globalize.now çağrı noktalarını, metinler davranış değişmeden i18n API'nden (örneğin t() ya da mesaj bileşenleri) geçecek şekilde yeniden yazar. Cursor'ın ürettiği her değişiklikte olduğu gibi, merge öncesinde diff'leri Git'te gözden geçirirsin. İlk merge'den sonra yeni push'lar, ayrı bir dışa aktarma adımı olmadan yeni metinleri otomatik senkronize etmeye devam eder.
globalize.now'ı Cursor içinde nerede çalıştırırım?
npx skills add globalize-now/globalize-skills komutunu her zaman Cursor'ın entegre terminalinde (ya da kök dizine bakan herhangi bir shell'de) deponun kök dizininden çalıştır. Skill'ler mevcut projeye göre çalışır, yerelleştirme skill paketini kurar ve sonraki prompt'lar için kontrolü agent'ına bırakır. Kök dizinde kalmak, yol algılamasının CLI'ın dizin ağacını taramasıyla uyumlu kalmasını sağlar.
globalize.now'ı Cursor ile dene
Proje kök dizininde başla:
npx skills add globalize-now/globalize-skills --all