globalize.now'ı Next.js ile kullanma

Next.js uygulamasında i18n kurulumunu beş dakikadan kısa sürede tamamla.

Next.js, next-intl ve next-i18next gibi kütüphanelerle birinci sınıf i18n desteği sunar, ama bu kütüphaneler çeviri anahtarlarının zaten yerinde olduğu bir kod tabanı bekler. globalize.now bunun öncesindeki adımdır: koda gömülü İngilizce dolu bir Next.js uygulamasını alır; next-intl'in (ya da herhangi bir runtime kütüphanesinin) sunabileceği anahtarları, dil dosyalarını ve refactor edilmiş bileşenleri üretir.

Ön koşullar

  • Bir Next.js projesi (App Router ya da Pages Router)
  • Bir Git deposu
  • Node.js 18+
  • Seçtiğin bir i18n runtime kütüphanesi (next-intl önerilir)

globalize.now'ı Next.js ile kurma

  1. Runtime kütüphaneni kur

    Uygulama dil bazlı mesajları runtime'da yükleyebilsin diye next-intl'i ya da tercih ettiğin kütüphaneyi ekle.

    npm install next-intl
  2. Temel next-intl routing'ini yapılandır

    Middleware'i, provider'ları ve route segment'lerini next-intl dokümantasyonunda anlatıldığı gibi bağla; bunu zaten yaptıysan bu adımı atla.

  3. Globalize skill kurulum aracını çalıştır

    Agent routing kurulumunla hizalanabilsin diye Next.js projesinin kökünden skill'leri kur.

    npx skills add globalize-now/globalize-skills --all
  4. next-intl algılamasını onayla

    Agent, provider'ların ve mesaj yollarının globalize.now'ın Next.js için beklediği kurallarla uyuştuğunu doğrulasın.

  5. Önerilen dil dosyası düzenini gözden geçir

    Önerilen messages dizinini ve dosya adlarını, seçtiğin dil başına mesaj dosyası düzenine uyup uymadığı açısından incele.

  6. Koda gömülü metinleri çeviri çağrılarına dönüştür

    Gömülü İngilizce metinleri t() ya da provider'ına bağlı eşdeğer yardımcılarla değiştiren güncellemeleri onayla.

  7. Git'e push'la

    Branch'i merge et ve push'la; globalize.now sonraki Git push'larda çevirileri senkron tutabilsin.

Sık karşılaşılan sorunlar

next-intl belirli bir mesaj yapısı bekliyor

Çözüm: globalize.now next-intl kuralını otomatik algılar ve yapılandırdığın dil klasörlerine uyan JSON yazar; elle yeniden biçimlendirme ihtiyacı azalır.

Birkaç metni zaten çevirdim. globalize.now bunların üzerine yazar mı?

Çözüm: Mevcut anahtarlar mümkün olduğunca korunur, yeni metinler kademeli olarak eklenir; çevirmenler önceki emeklerini kaybetmez.

Sık sorulan sorular

globalize.now, next-intl ve next-i18next ile çalışır mı?

Evet. globalize.now depo yapısına (anahtarlar, JSON katalogları ve bileşen çağrı noktaları) odaklanır; next-intl ya da next-i18next ise mesajları çalışma zamanında yüklemeye devam eder. Yönlendirme modeline uyan çalışma zamanını seç; globalize.now çıktısını bu seçime göre uyarlar. Skill'leri bilerek yenilemediğin sürece, npx skills add globalize-now/globalize-skills komutunu proje kurulumunda bir kez çalıştırman yeterli.

globalize.now hem App Router'ı hem de Pages Router'ı destekliyor mu?

Evet. Agent Skill'leri kullandığın router yapısını algılar ve metin çıkarmayı doğru layout dosyalarına, route handler'lara ve provider'lara göre uyarlar. globalize.now Next.js yönlendirmesinin yerini almaz; bu rotalardan geçen metinlerin anahtarlanmasını sağlar. Kurulumdan sonra App Router'daki server component'ler de client component'ler de runtime'ın beklediği aynı dil dosyalarına başvurur.

globalize.now'ı kısmen i18n uygulanmış bir Next.js uygulamasında kullanabilir miyim?

Evet. Agent'ı depoya yönlendir; mevcut mesaj paketlerini genişletir, koda gömülü metinlerin kaldığı boşlukları doldurur. Önce yalnızca pazarlama sayfalarının çevrildiği projelerde bu sık görülür. globalize.now yeni anahtarları eski çevirileri silmeden birleştirir, böylece ekipler ekran ekran geçiş yapabilir.

globalize.now server component'leri ve client component'leri farklı mı ele alır?

globalize.now, koda gömülü metinleri her sınır için stack'inin kullandığı yardımcıya göre yeniden yazar ve hook'ların ile provider'ların nerede çalışabileceğine dair Next.js kurallarına uyar. JSON çıktısı server ve client bundle'ları arasında ortak kalır, yani katalogları çoğaltmazsın. Etkileşim gerektiğinde client component'leri işaretlemek için yine Next.js dokümantasyonunu izlersin.

globalize.now, Next.js'in statik sayfa üretimiyle nasıl çalışır?

Dil dosyaları Git'te durur, bu yüzden `next build` SSG veya SSR rotalarının next-intl üzerinden zaten içe aktardığı aynı JSON'ları paketlemeye devam eder. globalize.now, metinlerin koda gömülü değil veri dosyalarından gelmesini sağlamanın dışında statik üretim hattını değiştirmez. Yeni metin yayına girdiğinde bir sonraki deploy'dan önce yapılan bir Git push çevirileri günceller.

npx skills add globalize-now/globalize-skills komutunu çalıştırmadan önce next-intl kurmalı mıyım?

Çalışma zamanının next-intl olduğunu zaten biliyorsan önce onu kurmak ideal, çünkü agent provider'ları hemen bağlayabilir. Henüz bir kütüphane seçmediysen yine npx skills add globalize-now/globalize-skills komutunu çalıştırabilirsin (Skill'ler uygun stack'i önermene yardım eder), ama bağımlılıkları kurduktan sonra kurulumu yeniden çalıştırman gerekebilir. İki yol da aynı yerde biter: anahtarlar Git'e commit edilir, push'ta senkronizasyon çalışır.

globalize.now'ı Next.js ile dene

Proje kök dizininde başla:

npx skills add globalize-now/globalize-skills --all

Ürün detayları ve fiyatlandırma için ana sayfaya dön

Diğer entegrasyonlar

Ücretsiz başla