Bağlam-içi Kurulumu

Genel Bakış

Crowdin Bağlam-İçi, tek satırlık bir Javascript kod parçacığı ve sözde dil paketi yardımıyla çalışır. Bu, ek bir yerelleştirme dili olarak daha sonra uygulamanıza bütünleştirilecek olan projenize yüklenen yerelleştirme dosyalarına dayanan bir sözde dil paketini oluşturur.

Bütünleşik sözde dil, orijinal metinlerin yerine özel tanımlayıcılar içerir. Böylece uygulamanızı bu dile geçirirken, tüm etiketler özel tanımlayıcılara dönüştürülür. Javascript bu tanımlayıcıları arar ve bunları düzenlenebilir etiketlerle değiştirir. Bu nedenle, web uygulamanızın Bağlam-içi sayfası, çevrilebilir dizgilerin düzenlenebilir olacağı tek farkla uygulamanızla aynı görünecektir.

Bağlam-İçi Görünüm

Çeviriler, Düzenleyiciyi açmaya gerek kalmadan doğrudan uygulamada yapılır. Crowdin Düzenleyicinin basitleştirilmiş bir sürümü, tüm işlevselliği (ÇB, makine çevirisi, onay/oy seçeneği, yorumlar, terimler) ile birlikte görüntülenecektir. Böylece, çevirmenler gerçek bir bağlamda önizleyebildiklerinden çeviri yapmak ve gözden geçirmek daha kolaydır.

Bağlam-İçi Düzenleyici

Bütünleştirme

Crowdin Bağlam-İçi’yi uygulamanızla bütünleştirmek için iki genel yaklaşım vardır:

  • Aşamalandırma veya çeviri ortamı
    Eğer son kullanıcılarınızı çevirilere yardımcı olmaya davet etmeyi planlamıyorsanız veya üretim uygulamanızda bir “çeviri kipi” kullanmayı düşünmüyorsanız, Crowdin Bağlam-İçi’yi aşamalandırmanıza veya adanmış çeviri uygulaması ortamınıza bütünleştirmek iyi bir çözüm olacaktır.

  • Üretim ortamı
    Crowdin Bağlam-İçi, uygulamanızda herhangi bir kod değişikliği gerektirmez, böylece üretimde bile kullanabilirsiniz. Nasıl açacağınıza ve kullanıcıların hangi bölümünün bunu kullanacağına siz karar verirsiniz. En yaygın kullanım durumları şunlardır:

    • Uygulamanızın tam bir kopyası olan ancak farklı bir URL altında (örneğin, crowdin.com yerine translate.crowdin.com olabilir) çevirmenlerin gerçek uygulamanızmış gibi çeviriler yapacağı bir yansıtma web sitesi oluşturabilirsiniz.
    • Bağlam-içi’ni ek bir dil olarak da ekleyebilirsiniz. Bu nedenle, çevirmenler uygulamanızı açtıklarında, kendileri için Bağlam-içi’ni açacak olan listeden bu ek dili seçecekler.

Bağlam-içi’ni ayarlamak için Crowdin projenizdeki bütünleştirme kurulum kılavuzunu takip edin. Kılavuz, projenizdeki sol panelde Araçlar > Bağlam-İçi altında bulunabilir.

Bağlam-İçi Sekmesi

Not: Eğer CSP kullanıyorsanız, ilkeye şu kuralları eklediğinizden emin olun: Bağlam-İçi kaynak dosyalarını yüklemek için, <organization_domain>.crowdin.com tarafından istenen CORS istekleri için

Bütünleştirme başarılı olarak ayarlandıktan ve uygulamanızı yenilemenizden sonra, davet ileti kutusu ve Crowdin oturum açma kutusunu görmeniz gerekir.

Oturum Açma Penceresi

İsteğe Bağlı Parametreler

Yapılandırma kod parçacığındaki bu parametreleri _jipt dizilimine ekleyebilirsiniz.

Metin Önyükleme

_jipt.push(['preload_texts', true]);

Tüm kaynak dizgileri önyükleyerek Bağlam-İçi araç içinde görüntülenen değişken içeriği hızlandırır. Büyük projeler (5000+ dizgi) için otomatik olarak etkisizleştirilir. Kabul edilebilir değerler: true, false.

Çeviri Düğmesi Her Zaman Görünür

_jipt.push(['touch_optimized', true]);

Bu seçenek, dokunmatik ekranlarda varsayılan olarak etkindir ve fareyle üzerine gelince göstermek yerine, çevrilebilir her dizginin yanındaki çeviri düğmesini kalıcı olarak görünür hale getirir. Kabul edilebilir değerler: true, false.

Before Commit Geri Çağırma

_jipt.push(['before_commit', function(source, translation, context, language_code) { return status_obj; }]);

İşlemeden önce öneriyi doğrulama işlevi.

Parametreler
sourceKaynak metin
çeviriÇeviri metni
contextKaynak dizgi bağlamı
language_codeHedef dil kodu (dil kodları)
Dönüş Değerleri
status_obj Nesne. status_obj.status, "ok", "error" veya "corrected" olabilir. Hata olması durumunda, status_obj.message hata açıklaması içerir. Durum "corrected" olduğunda, status_obj.correction düzeltilmiş çeviriyi içerir

Before DOM Insert Geri Çağırma

_jipt.push(['before_dom_insert', function(text, node, attribute) { return 'text'; }]);

Dizgi DOM içine eklenmeden önce dönüştürme işlevi.

Parametreler
textEkleme için dizgi
node
isteğe bağlı
Metnin eklenmek zorunda olduğu DOM öğesi. Metnin hedef öğesi (tarayıcının açılır pencerelerindeki metin) yoksa atlanabilir
attribute
isteğe bağlı
Metin, öznitelliğin bir parçasıysa DOM öğesinin öznitelliğidir
Dönüş Değerleri
textEkleme için dizgi
falseEğer işlev false döndürürse, DOM güncellenmeyecektir

Bağlam-İçi Üstyüzeyi Geri Çağırmayı Kapatın

_jipt.push(['escape', function() { window.location.href = "http://app_domain.com"; }]);

Eğer tanımlandıysa, kullanıcılar çevirmek istemezlerse Bağlam-İçi üstyüzeyi kapatabilir. Bu özelliği kendi tarafınıza uygulayın. Bağlam-İçi bütünleştirmesi yaklaşımına bağlı olarak, uygulamanın dilini değiştirmek veya çeviri ortamından üretim uygulamasına yönlendirmek zorundadır.

Oturum Açma Penceresini Kapatın

Bu makale yararlı oldu mu?