PVFirms, güneş enerjisi endüstrisi şirketlerinin çok dilli dizinidir. Platform, Laravel, Inertia, React, TypeScript ve PostgreSQL kullanmaktadır. İçerik iş akışı, n8n aracılığıyla düzenlenen planlı LLM üretimini, yerel kapsama kontrollerini ve İngilizce yedeklemeyi içermektedir.
Proje, 31 yerel dili kapsamakta ve yaklaşık 1.600 arayüz çeviri anahtarından oluşan bir kaynak setine sahiptir. Bu rakamlar, uygulama kapsamını tanımlar. Her şirket kaydının her dilde eşit derecede tam içeriğe sahip olduğunu veya üretilen metnin gözden geçirilmesine gerek olmadığını ima etmez.
Arayüz dili ve şirket içeriği farklıdır.
Çevirilmiş bir arama butonu bir arayüz sorunudur. Bir şirket tanımı ise bir içerik sorunudur. İkisi aynı sayfada birlikte görünür, ancak farklı kaynaklara, güncelleme döngülerine ve kalite kontrollerine sahiptir.
Tamlık hakkında düşünürken onları ayırırım. Bir yerel, bazı şirket içerikleri o dilde hala mevcut olmasa bile kullanılabilir bir arayüze sahip olabilir. Tersine, çevrilmiş tanımlar, gezinmeyi, doğrulama mesajlarını veya hesap ekranlarını tamamlamaz.
Bu ayrım ilerlemeyi ölçülebilir hale getirir. Bir yerel alanı, bir nesil işi çalıştığı için “tamamlandı” olarak adlandırmak yerine, sistemin her içerik sınıfında neyin mevcut olması gerektiğini, neyin gerçekten mevcut olduğunu karşılaştırması gerekir.
Bir yedekleme, kullanılabilirliği korumalıdır.
PVFirms, yedek dil olarak İngilizce kullanır. Amaç, yerelleştirilmiş bir değer eksik olduğunda uygulamanın kullanılabilirliğini sağlamaktır. Laravel, eksik çeviri dizeleri için bir yedek dil desteği sunar, ancak uygulama içeriği yine de kendi kasıtlı yönetimini gerektirir.
Bir yedekleme, eğer kimse ölçmezse tamamlanmamış çalışmaları da gizleyebilir. Bir sayfa, istenen yerel ayarın çevirisi olmasa bile, bir İngilizce değer bulduğu için başarılı bir şekilde render edilebilir. Bu nedenle, başarılı render etmeyi ve yerel ayar kapsamını ayrı sorular olarak ele alıyorum.
Bir inceleme için hangi anahtarların eksik olduğunu, hangi içeriğin kasıtlı olarak geri düştüğünü ve hangi değerlerin boş veya hatalı olduğunu bilmek istiyorum. Tek başına yeşil bir üretim durumu bu soruları yanıtlamaz.
Otomasyon, stabil bir kaynağa ihtiyaç duyar.
Planlanmış içerik hattı, birçok yerel alanda tekrarlanan işleri yönetilebilir hale getirir. Kullanışlılığı, sabit bir kaynak kimliğine bağlıdır: iş, üzerinde çalıştığı anahtarın veya kaydın ne olduğunu ve hangi kaynak içeriğini dönüştürdüğünü bilmelidir.
Bu tür bir pipeline için tasarım sorularım arasında bir kaynak değişikliğinin eski bir çeviriyi nasıl geçersiz kıldığı, eksik işi tamamlanmış işten nasıl ayırt edeceğim ve bir yeniden denemenin gözden geçirilmiş bir değeri kazara nasıl değiştirmesini engelleyeceğim yer alıyor. Kesin uygulama değişiklik gösterebilir; bu ayrımları koruma ihtiyacı ise değişmez.
Çevirinin ayrıca yapısal gereksinimleri vardır. Yer tutucular, bağlantılar ve ürün veya şirket adlarının değişmeden kalması gerekebilir. Bir cümle doğal bir şekilde duyulabilirken, gerekli bir yer tutucunun kaybolması durumunda bir arayüzü bozabilir.
Dizin bilgileri, düz yazıdan farklı bir standart gerektirir.
Bir şirket dizini, tanımlayıcı yazımı gerçek alanlarla birleştirir. İsimler, konumlar, web siteleri ve hizmet kategorileri, bir profili tamamlamak için icat edilmemelidir. Bir LLM sağlanan materyali dönüştürmeye yardımcı olabilir, ancak üretilen akıcılık, bir iş iddiasının doğru olduğunun kanıtı değildir.
İçerik incelemesi için, bir kaynak destekli gerçeği, o gerçeğin çevirisini ve yeni üretilmiş açıklayıcı metni ayırt ediyorum. Bu, otomatik olarak neyin yayımlanabileceğini ve neyin ek kontrol gerektirdiğini belirlemeyi kolaylaştırıyor. Ayrıca, mevcut olmayan bir alanın sessizce kesin bir cümle haline gelmesini de engelliyor.
Çok dilli keşif için aynı ilke geçerlidir. Yerelleştirilmiş bir sayfa, kelimeleri değiştiği için farklı bir kayıt gibi davranmak yerine, temel şirket kimliğini korumalıdır.
Uygulamanın bir parçası olarak içeriği işletin
PVFirms, yerelleştirme, üretilen içerik ve sıradan uygulama mühendisliğini tek bir üründe bir araya getirdi. Benim odak noktam, ziyaretçilerin gördüğü sayfalarla birlikte kapsama, kurtarılabilirlik ve anlaşılır içerik durumu üzerinedir.
Çok dilli bir dizin, operatörlerin nelerin mevcut olduğunu, nelerin eksik olduğunu, nelerin geri düştüğünü ve nelerin gözden geçirilmesi gerektiğini anlayabildiğinde sürdürülebilir hale gelir. Bu, bir içerik sisteminin faydalı çıktısıdır: hem dizinin hem de dillerinin büyümesiyle bilgiyi tutarlı tutmanın tekrarlanabilir bir yolu.
Teknik referans: Laravel belgelendirmesi yerelleştirme ve yedek diller hakkında.
26 Eylül 2026’da güncellendi.