Kurumsal Ölçekte Toplu Çeviri İşlemleri: Kapsamlı Bir Rehber

Kurumsal ölçekte çeviri yönetimi, küçük bir uygulama için birkaç düzine anahtar kelimeyi yönetmekten temelden farklı bir meydan okumadır. Ürününüz 20 dili, 50 ad alanını ve binlerce çeviri anahtarını kapsadığında, manuel iş akışları kendi ağırlıkları altında çöker. Her terminoloji değişikliği yüzlerce dize üzerinde zincirleme etki yaratır. Her yeni dil lansmanı her tek anahtara dokunmayı gerektirir. Her sürüm döngüsü, tüm değişiklik kapsamını kapsayan bir yayımlama işlemi talep eder.

Bu rehber, Better i18n'nin toplu işlemlerinin bu sorunları nasıl çözdüğünü ele alıyor — Translation Editor'ın yerleşik toplu eylemlerinden yapay zeka destekli çeviriye, CMS toplu yönetimine ve MCP araç otomasyonuna kadar.

Üç Temel Toplu İşlem

Translation Editor, verimli yerelleştirme yönetiminin temelini oluşturan üç toplu işlem sunar.

Toplu Çeviri Güncelleme

En yaygın toplu işlem, birden fazla anahtar genelinde aynı anda çevirilerin güncellenmesidir. Gerçek bir senaryoyu düşünün: şirketiniz tüm ürün genelinde "Workspace" adını "Team Space" olarak değiştiriyor. Toplu işlemler olmadan, birinin her dildeki o terimi içeren her anahtarı bulup güncellemesi gerekir.

Toplu güncelleme ile etkilenen anahtarları seçer, değişikliği uygularsınız ve bu değişiklik seçilen tüm dillere yayılır. İşlem atomiktir: ya tüm güncellemeler başarılı olur ya da hiçbiri olmaz; böylece kısmen güncellenmiş bir kullanıcı arayüzüyle karşılaşmazsınız.

Toplu Anahtar Silme

Kullanılmayan çeviri anahtarlarını temizlemek, ekiplerin can sıkıcı olduğu için sıklıkla ihmal ettiği temel bir bakımdır. Özellikler kullanımdan kaldırılır, A/B testleri sonuçlanır ve eski dizeler birikir. Toplu silme, birden fazla anahtarı seçmenize ve bunları tek bir eylemle kaldırmanıza olanak tanır. İşlem ad alanı sınırlarına saygı gösterir; bu sayede uygulamanızın bir bölümünü, başka bir bölümü yanlışlıkla etkileme endişesi olmadan temizleyebilirsiniz.

Toplu Çeviri Yayımlama

Çeviriler bir yaşam döngüsünden geçer: oluşturulma, çevrilme, incelenme, yayımlanma. Yayımlama adımı, çevirileri CDN'inize iter veya GitHub deponuzla senkronize eder. Toplu yayımlama, incelenen çevirilerin tüm bir setini anahtar anahtar yayımlamak yerine aynı anda canlıya almanızı sağlar. Bu, tüm çeviri değişikliklerinin aynı anda yayına girmesini istediğiniz koordineli sürümler için özellikle önemlidir.

translateBatch ile Yapay Zeka Toplu Çevirisi

translateBatch aracı, toplu işlemlerin yapay zeka ile buluştuğu yerdir. Kapsam ve hedef üzerinde hassas kontrolle tek bir istekte 500 adede kadar anahtarı çevirmenizi sağlar.

Parametrelerin birlikte nasıl çalıştığı aşağıda açıklanmıştır:

• targetLanguages[] hangi diller için çeviri oluşturulacağını tanımlar. Yalnızca bir yeni dili veya aynı anda bir düzineyi hedefleyebilirsiniz.
• scope kapsamı belirler — "all" projenizdeki her anahtarı kapsarken "namespace" bunu daraltır.
• namespaces[] scope "namespace" olarak ayarlandığında hangi ad alanlarının dahil edileceğini tam olarak belirtmenizi sağlar.
• maxKeys istek başına 1 ile 500 anahtar arasında toplu işlem boyutunu kontrol eder.

Yapay Zeka Toplu Çevirisini Ne Zaman Kullanmalı

Yapay zeka çevirisi ilk geçiş olarak mükemmeldir. Hızlıdır, tutarlıdır ve yüksek hacimleri kaldırır. İdeal iş akışı şöyledir:

1. Tüm çevrilmemiş anahtarlar için ilk çevirileri oluşturmak üzere translateBatch çalıştırın
2. Yapay zeka tarafından oluşturulan çevirileri incelemek ve iyileştirmek için Translation Editor'ı kullanın
3. İncelenen çevirileri toplu olarak yayımlayın

Bu üç adımlı iş akışı, haftalar süren manuel çeviri çabasını bir günlük inceleme çalışmasına dönüştürür.

CMS Toplu İşlemleri

Better i18n'nin içerik yönetim sistemini kullanıyorsanız, yapılandırılmış içerik için paralel toplu yeteneklere erişiminiz vardır.

bulkUpdateEntryStatus, birden fazla içerik girişini tek bir işlemde durumlar arasında taşır — taslak, yayımlanmış veya arşivlenmiş. Bu, düzinelerce güncel olmayan girişi arşivlemeniz veya incelenen içerik grubunu aynı anda yayımlamanız gerektiğinde içerik denetimleri sırasında son derece değerlidir.

bulkDeleteEntries, birden fazla içerik girişini aynı anda kaldırır. Bir ürün serisini kullanımdan kaldırırken veya test içeriğini temizlerken bu, önemli ölçüde manuel çabadan tasarruf sağlar.

proposeContentEntries, tek bir istekte 20 adede kadar yapılandırılmış içerik girişi oluşturmak için yapay zekayı kullanır. Her giriş çevirilerle birlikte gelir; bu da onu yeni ürün alanları veya pazar lansmanları için içerik kitaplıklarını başlatmak üzere güçlü bir araç haline getirir.

Geliştirici İş Akışları için MCP Toplu Araçları

Model Context Protocol (MCP), her toplu işlemi programlanabilir bir araç olarak sunar ve kullanıcı arayüzünün ötesine geçen otomasyonu mümkün kılar.

createKeys — Toplu Anahtar Oluşturma

Tek bir API çağrısında ilk çevirileriyle birlikte yüzlerce çeviri anahtarı oluşturun. Bu, yeni bir özellik alanı kurarken veya harici bir sistemden çevirileri içe aktarırken tercih edilen araçtır. Her anahtar birden fazla dil için çeviriler içerebilir; böylece tek bir işlemde tamamen çevrilmiş bir ad alanı oluşturabilirsiniz.

updateKeys — Toplu Çeviri Güncelleme

Herhangi sayıda anahtar ve dil genelinde mevcut çevirileri güncelleyin. Araç, hedef anahtarların mevcut olduğunu doğrular ve ad alanı uyumsuzlukları konusunda uyarır — yanlış ad alanlarında yinelenen anahtarların yanlışlıkla oluşturulmasını önleyen kritik bir güvenlik önlemi.

deleteKeys — Toplu Anahtar Kaldırma

Kullanımdan kaldırılan anahtarları programatik olarak kaldırın. Bu, kod tabanınızda artık başvurulmayan anahtarları otomatik olarak temizleyebileceğiniz CI/CD ardışık düzenlerine doğal biçimde entegre olur.

publishTranslations — CDN ve GitHub'a Toplu Yayımlama

Tüm ad alanları için çevirileri aynı anda canlıya taşıyın. Yayımlama işlemi yüksek verim için tasarlanmıştır — PUBLISH_BATCH mesaj türünü kullanarak dahili olarak toplu işlem yapar ve batch_publish iş türü aracılığıyla işler; böylece binlerce anahtar yayımlamak bile iş akışınızı engellemez.

Gerçek Dünya Senaryosu: 5.000 Anahtarı Taşıma

Somut bir kurumsal senaryoyu inceleyelim. Ekibiniz çeviri mimarisini yeniden yapılandırıyor — monolitik bir "common" ad alanını "billing", "settings" ve "onboarding" gibi alana özgü ad alanlarına bölüyor.

Adım 1: Dışa Aktar ve Eşle. "common" ad alanındaki tüm anahtarları almak için listKeys kullanın. Her anahtarı yeni mimarinize göre hedef ad alanına eşleyin.

Adım 2: Toplu Oluştur. Taşınan tüm mevcut çeviriyle birlikte yeni ad alanlarında anahtarlar oluşturmak için createKeys kullanın. En iyi verim için 200-300 anahtarlık gruplar halinde işleyin.

Adım 3: Doğrula. Tüm anahtarların çevirileriyle birlikte doğru şekilde yerleştiğini doğrulamak için her yeni ad alanında listKeys kullanın.

Adım 4: Toplu Yayımla. Yeniden düzenlenmiş çevirileri CDN'e göndermek için her yeni ad alanı için publishTranslations kullanın.

Adım 5: Temizle. Kod tabanınız yeni ad alanlarına başvuracak şekilde güncellendikten sonra, "common" alanından eski anahtarları kaldırmak için deleteKeys kullanın.

Tüm taşıma işlemi — 15 dilde 5.000 anahtar — bir sprint tüketmek yerine bir öğleden sonrada tamamlanır.

Gerçek Dünya Senaryosu: Toplu Dil Lansmanı

Ürününüz 5'ten 12 desteklenen dile genişliyor. Bu, her ad alanına 7 yeni dil eklenmesi anlamına gelir.

Adım 1: Yapay Zeka İlk Geçişi. 7 yeni hedef dilinizle, scope "all" ve maxKeys 500 olarak ayarlanmış şekilde translateBatch çalıştırın. 2.000 anahtarlık bir proje için bu 4 grup gerektirir.

Adım 2: Öncelikli İnceleme. Müşteriye yönelik ad alanlarında insan incelemesine önce odaklanın. İnceleyici düzeltmelerini verimli biçimde uygulamak için Translation Editor'ın toplu güncelleme özelliğini kullanın.

Adım 3: Aşamalı Yayımlama. En yüksek trafikli alanlardan başlayarak bir seferde bir ad alanını toplu olarak yayımlayın. Sonraki grubu yayımlamadan önce sorunları izleyin.

Adım 4: Sürekli Kapsam. Geliştirme sırasında eklenen yeni anahtarlar için otomatik translateBatch çalıştırmaları ayarlayın; böylece yeni dilleriniz hiçbir zaman geride kalmaz.

Ölçekte Performans ve Güvenlik

Kurumsal ölçekte toplu işlemler güvenlik önlemleri gerektirir. Better i18n'nin toplu araçları birkaç güvenlik mekanizması içerir:

• Ad alanı doğrulaması, anahtarların yanlış ad alanında oluşturulmasını önler — hayalet yinelenen anahtarlara yol açan yaygın bir otomasyon hatasıdır.
• Çapraz varlık çakışma uyarıları, oluşturduğunuz bir anahtarın başka bir ad alanında zaten mevcut olduğunu size bildirir.
• Atomik işlemler, toplu güncellemelerin ya tam olarak başarılı olmasını ya da tamamen geri alınmasını sağlar — kısmi durum yoktur.
• Büyük yayımlama grupları için eşzamansız işleme, ekibinizin bir dağıtımın tamamlanmasını beklerken hiçbir zaman engellenmaması anlamına gelir.

Toplu İşlemlerle Başlarken

Şu anda çevirileri manuel olarak yönetiyorsanız, Translation Editor'ın toplu işlemleriyle başlayın — bunlar herhangi bir kurulum gerektirmez ve anında üretkenlik kazanımları sağlar. Ölçeğiniz büyüdükçe, programatik kontrol için MCP toplu araçlarını geliştirme iş akışınıza entegre edin. Ve yeni diller eklerken soğuk başlangıç sorununu ortadan kaldırmak için yapay zeka toplu çevirisini kullanın.

Kurumsal çeviri yönetiminin yavaş olması gerekmez. Doğru toplu araçlarla yerelleştirme iş akışınız, ürününüz kadar hızlı ölçeklenir.