Web Uygulamaları için Bağlam-İçi Yerelleştirme

Crowdin Bağlam-İçi Aracı, uygulamanız için bir üstyüzey sağlar. Çevirmenler ve düzeltmenler, uygulamanızda nasıl görüntüleneceklerini görmek için tamamlanmış çevirileri bağlam içinde çevirebilir ve anında önizleyebilir. En iyi çeviri kalitesini korumaya yardımcı olmak için web uygulamalarınız için Bağlam-içi’ni kullanabilirsiniz.

Bağlam-İçi yerelleştirme, çevrilebilir dosyaların depolandığı Crowdin projenizle bağlantılıdır. Bağlam-içi kullanılarak yapılan çeviriler, doğrudan Düzenleyicide yapılan çevirilerle aynı şekilde projenize eklenecektir.

Bu araç, uygulamanızın düzenlenebilir metinlerle bir görünümünü sağlar, böylece çeviri işlemi gerçek zamanlı olarak görülebilir. Hatta uygulamanın değişken kısmı ve yer tutucuları içeren dizgiler bile bu şekilde çevrilebilir.

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.

Ç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.

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ılavuzu gözden geçirmek için projenizi açın ve Araçlar > Bağlam-İçi’ne gidin.

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.

İ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.

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.

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.