Tüm web sitemize 31 € karşılığında Japonca ve Brezilya Portekizcesi ekledik

29 Eylül'de globalize.now'ı Japonca ve Brezilya Portekizcesi olarak yayına aldık. Her sayfa, her fiyat tablosu ve 61 blog yazısının hepsi. Çevirinin kendisi sekiz dakika sürdü, uygulama yaklaşık 31 € faturalandırdı. globalize.now yapay zekâ destekli yerelleştirme altyapısıdır; kendi sitemizde çalıştırmak böyle göründü. Her rakam hafızadan değil, iş sayfasından ve Git geçmişinden alındı.

2017'de yerelleştirme büyüme planının maliyeti yazımız, kendi rakamlarımızı henüz yayımlamadığımızı söyleyerek bitiyor. Bu ilk rakam. Büyüme değil, maliyet rakamı: /ja/ adresini ziyaret etmeye henüz kimsenin vakti olmadı.

Tam olarak neyi çevirdik?

Tüm siteyi, iki kez. Depodan sayılmış envanter şöyle:

  • Arayüz: beş mesaj kataloğuna yayılmış 1.782 İngilizce metin (çekirdek site, fiyatlandırma, karşılaştırma sayfaları, entegrasyonlar ve çeviri örnekleri), yaklaşık 21.000 kelime.
  • Blog: 61 yazı, yaklaşık 110.000 kelime.
  • Hedef diller: Japonca (ja) ve Brezilya Portekizcesi (pt-BR).

Yani iki dile giden yaklaşık 130.000 kaynak kelime. PR 170 dosyaya dokundu ve 34.681 satır ekledi. Merge'den sonra sitemap 11 locale'e yayılan 811 URL listeliyor ve site 962 statik sayfa build ediyor.

Ne kadar sürdü?

Sekiz dakika çeviri, ardından daha uzun bir kalite geçişi. CTO'muz Arturs iki dili projeye ekledi ve iş main üzerinde 08:56 UTC'de başladı. İş sayfası dökümü şöyle:

AşamaSüre
Çeviri (11.264 yeni metin, dil başına 5.632)8 dk 1 sn
Otomatik QA incelemesi27 dk 11 sn
PR'a teslim5 dk 29 sn

İki dili içeren commit 09:29 UTC'de düştü. İşteki diğer 45.106 metin çeviri belleğinden geldi, çünkü mevcut sekiz dilde bir değişiklik olmamıştı.

Arturs, ekip sohbetinde bahsederken on dakika tahmin etmişti. Çeviri için haklıydı, işin tamamı için iyimserdi; aradaki fark QA geçişi. Kontrol etmeye 27 dakikalık makine zamanı harcamayı, bunu atlamaya tercih ederiz.

Otomatik QA ne buldu?

11.264 yeni metinde 72 uyarı, hepsi küçük seviyede. 11.192'si temiz geçti, QA bu sırada 182 otomatik düzeltme uyguladı.

İncelediğimiz uyarıların çoğu, uzunluk kontrolünün Japoncaya karşı fazla temkinli davranmasıydı. “Pricing” 料金 oluyor, yani iki karakter; 0,29'luk uzunluk oranı 0,3 alt sınırının hemen altında kalıyor. Bu hata değil, doğru bir çevirinin alfabetik diller için yazılmış bir sezgiselde takılması. Yine de uyarıları görünür bırakıyoruz: hiç tetiklenmeyen bir kontrol, kontrol sayılmaz.

Maliyeti ne oldu?

Yaklaşık 31 €: projenin dile göre maliyet görünümü Japonca için 15,72 €, Brezilya Portekizcesi için 16,15 € gösteriyor. Uygulamanın ücretlendirdiği tutar bu; aynı hacmi çeviren bir müşteri de aynısını görür. Dahili model maliyetimiz değil, indirim de değil.

Çevrilen yaklaşık 260.000 kelimeye yayıldığında 1.000 kelime başına yaklaşık 12 sent eder. Üstüne başka bir şey faturalandırılmadı. Dil başı ücret yok, kullanıcı başı ücret yok; yani on ikinci dili eklemek üçüncüyü eklemekle aynı maliyette. Güncel planlar fiyatlandırma sayfasında.

Mühendislik tarafı tam olarak neyi içeriyordu?

Aynı öğleden sonra merge edilen tek bir PR ve içinde çeviri yoktu. PR açıldığında çeviri işi bunun üzerinde yeniden çalıştı ve 56.390 metnin 56.370'ini doğrudan çeviri belleğinden aldı; böylece çevrilmiş kataloglar yeni dosyalara yedi dakikada geldi. Otomatikleşen kısım çeviri. Next.js sitesine yeni bir locale kaydetmek hâlâ senin kodun ve planlamadan önce “senin kodun” ile neyin kastedildiğini bilmek işe yarar.

next-intl'e locale eklemek, routing yapılandırmasında tek satır. Bir URL oluşturan, bir locale okuyan ya da locale'lerini listeleyen her şey diff'in geri kalanı:

  • Yönlendirme: locale listesi ve pt-BR için URL önek geçersiz kılması (sonraki bölüm).
  • SEO meta verisi: hreflang kümeleri, canonical'lar, og:locale (ja_JP, pt_BR) ve metadata yardımcılarının döngüyle gezdiği locale listesi.
  • Biçimlendirme: Intl etiketleri ja-JP ve pt-BR, böylece tarihler ve sayılar doğru görünür.
  • Dil değiştirici: tarayıcı botlarının izleyebilmesi için her locale'e gerçek bir <a href hreflang> ile bağlanır.
  • Sitemap ve kontroller: sitemap üreticisinin, lastmod kontrolünün, iç bağlantı kontrolünün ve çeviri doğrulayıcısının hepsinin iki yeni kodu öğrenmesi gerekti.
  • Kataloglar: iki locale için yalnızca başlık içeren boş .po dosyaları, aynı PR'da çeviri belleğinden dolduruldu.

Siteniz bizimkinden daha az özelleştirilmişse bu listenin çoğu yapılandırmadır. URL'leri herhangi bir yerde elle oluşturuyorsanız, ki çoğu site bir yerde yapıyor, bu yerlerin her birini bir bağlantı ilk kez yanlış çıktığında fark edersiniz. Geliştirici rehberi kurulumu, bir yapay zekâ yerelleştirme ajanının gerçekte ne yaptığı ise neyin otomatik, neyin elle yapıldığını anlatır.

Brezilya Portekizcesi neden /pt-BR/ yerine /pt-br/ adresinde?

Çünkü dil etiketi ile URL segment'i farklı işleri olan farklı şeylerdir.

BCP 47'ye göre doğru etiket pt-BR. Bir makinenin dili okuduğu her yerde onu kullanıyoruz: dosya adları, <html lang>, hreflang, og:locale ve Intl. Yalnızca URL küçük harfe çevrilir:

// i18n/routing.ts (trimmed)
const prefixes = {
  "pt-BR": "/pt-br",
} as const;

export const routing = defineRouting({
  locales: ["en", "it", "de", "fr", "es", "lv", "hi", "lt", "et", "ja", "pt-BR"],
  defaultLocale: "en",
  localePrefix: { mode: "always", prefixes },
});

/** The URL path segment for a locale: `pt-BR` → `pt-br`, `de` → `de`. */
export function localeUrlSegment(locale: string): string {
  const prefix = (prefixes as Record<string, string | undefined>)[locale];
  return prefix ? prefix.slice(1) : locale;
}

Büyük küçük harf karışık yollar yanlış yazılır ve hem /pt-BR/ hem /pt-br/ adresine yanıt veren bir sitede her sayfanın birbiriyle yarışan iki kopyası olur. Bu yüzden /pt-BR/ adresi /pt-br/ adresine yönlendirilir ve localeUrlSegment() elle yapılan her URL'yi önek haritasından oluşturur. Tek doğruluk kaynağı, dil değiştirici, canonical'lar ve sitemap'in birbirinden ayrışmamasını sağlar.

Neden Japonca ve Brezilya Portekizcesi?

Bunlar, henüz kapsamadığımız büyük web dilleri. W3Techs'in yayına aldığımız günkü sayımına göre Japonca web sitelerinin %4,9'unun, Portekizce ise %4,1'inin içerik dilidir.

Bunu yapmanın gerekçesi bizden eski. CSA Research 2020'de 29 ülkede 8.709 tüketiciye anket yaptı ve katılımcıların %76'sı, bilgilerin kendi dillerinde sunulduğu ürünleri satın almayı tercih ettiğini söyledi. Bu talep tarafı. Değişen şey arz tarafı: iki dil eskiden bir tedarikçi ilişkisiydi, şimdi ise 31 €'ya mal oluyor.

Dil seçerken kendi kuralımız büyüme rehberi yazısındaki kural. Trafiğinin zaten nereden geldiğine bak, iki dil ekle, başka hiçbir şeyi değiştirme ve bir çeyrek boyunca ölç. Bu iki dille tam olarak bunu yapacağız.

Henüz neleri kontrol etmedik?

Anadil incelemesi. Japoncayı ya da Brezilya Portekizcesini ana dili olarak okuyan hiç kimse çıktıyı henüz gözden geçirmedi.

Kontrol ettiklerimiz: her metin için otomatik QA, tüm prebuild kontrollerinden geçen build ve staging'de örnekleme yaparak baktığımız sayfaların doğru lang, canonical ve hreflang ile 200 döndürüp eksiksiz render edilmesi. Bir build'in kontrol edemediği şey ise bir cümlenin sanki bir insan yazmış gibi okunup okunmadığı. Bunu kendi Almanca ve Fransızca çevirilerimizi denetlediğimizde zor yoldan öğrendik: sayfalar boyunca yanlış hitap biçimi vardı.

Yani sırada inceleme var. Bulduklarını, yanlış çıkan her şey dahil, bu yazıya ekleyeceğiz.

Aynısını kendi sitende yapabilir misin?

Metinlerin zaten katalogdaysa evet, çeviri kısmı dakikalar sürer. Hâlâ bileşenlere gömülüyse önce dönüştürme gerekir. Bu adım uygulama içindeki bağlanma akışında bir kez çalışır, ardından push işleri yeni metinleri çevirir. Vibe coder rehberi, koda gömülü metnin olağan olduğu Lovable, Bolt veya Cursor ile yapılmış uygulamaları anlatıyor.

Maliyet; dil sayısıyla ya da ekipteki kişi sayısıyla değil, çevirdiğin kelime sayısıyla ölçeklenir. "Yeni dil eklemeye değer mi?" sorusunun cevabı bu yüzden değişti. Ölçmek artık bu konuda toplantı yapmaktan daha ucuz.

Kendi deponda dene

İki dil bize sekiz dakikalık çeviriye ve yaklaşık 31 €'ya mal oldu. Deponu bağla, analitiğinin zaten işaret ettiği iki dili seç ve kendi faturanın nasıl göründüğünü gör.

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