VCS Bütünleştirmeleri: Çevrimiçi Yapılandırma

Sürüm Denetim Sistemi bütünleştirmesinin çalışması için hangi kaynak dosyaların çevrilmesi gerektiğini ve Crowdin’in deponuzdaki çevrilmiş dosyaları nasıl yapılandırması gerektiğini belirtmek zorundasınız.

Dal Yapılandırması

Seçilen dalı, kaynak ve çevrilmiş dosyaların yolunu belirtecek şekilde yapılandırın. Dal Yapılandırması ileti öğesini açmak için Yapılandırmayı Düzenle’ye tıklayın.

Ardından, bir yapılandırma oluşturabilecek veya deponuzdan bir yapılandırma dosyasını yükleyebileceksiniz.

Bir Yapılandırma Yükleme

Eğer deponuza zaten kaydedilmiş bir yapılandırma dosyanız varsa, şu adımları izleyerek bu dosyayı seçebilirsiniz:

1. Daha Fazla’ya tıklayın.
2. Açılır listeden Yapılandırmayı yükle’ye tıklayın.
3. Deponuzdan yapılandırma dosyasının adını girin.
4. Devam’a tıklayın.

Ardından bu yapılandırmayı olduğu gibi kullanabilir veya bu yapılandırma dosyasına kaydedilecek bazı değişiklikler yapabilirsiniz.

Bir Yapılandırma Oluşturma

Dal Yapılandırması ileti öğesinde, bütünleştirme için kullanılacak bir yapılandırma oluşturabilirsiniz.

Bunun için yapılandırma dosyasını adlandırın ve Devam’a tıklayın.

Ardından, aşağıda listelenen ve açıklanan şekilleri ve yer tutucuları kullanarak kaynak dosya yolunu ve çevrilmiş dosya yolunu seçin.

Seçilen dal için yapılandırmayı ayarlamanızdan ve kaydetmenizden sonra, yapılandırma dosyası deponuzdaki çeviri dalının kök dizinine kaydedilecektir.

Şekiller

* (yıldız işareti)

Dosya veya dizin adındaki herhangi bir karakteri temsil eder. Eğer bir “*.json” belirtirseniz, “iletiler.json”, “hakkimizda.json” ve “.json” ile biten her şey gibi tüm dosyaları içerecektir.

** (çiftli yıldız işareti)

Herhangi bir dizgiyle art arda (alt dizinler dahil) eşleşir. Hem kaynak hem de çeviri şekillerinde ** kullanabileceğinizi unutmayın. Çeviri şeklinde ** kullanırken, belirli bir dosya için her zaman kaynaktan gelen alt yolu içerecek. Örneğin, tüm .po dosyalarını art arda Crowdin’e yüklemek için ‘/en/**/.po’ kaynağını kullanabilirsiniz. Çeviri şekli ‘/%two_letters_code%/**/%original_file_name%’ olacaktır.

? (soru işareti)

Herhangi bir tek karakterle eşleşir.

[set]

Küme içindeki herhangi bir tek karakterle eşleşir. Düzenli İfadedeki, küme değili ([^ a-z]) dahil olmak üzere karakter kümeleri gibi davranır.

\ (ters eğik çizgi)

Sonraki üst karakteri atlatır.

Yer Tutucular

Çevrilen dosyaların nereye yerleştirileceğini ve nasıl adlandırılacağını tanımlamak için yer tutucuları kullanın:

Ad	Açıklama
%language%	Dil adı (yani Ukraynaca)
%two_letters_code%	Dil kodu ISO 639-1 (yani uk)
%three_letters_code%	Dil kodu ISO 639-2/T (yani ukr)
%locale%	Yerel ayar (uk-UA gibi)
%locale_with_underscore%	Yerel ayar (yani uk_UA)
%original_file_name%	Orijinal dosya adı
%android_code%	"values-" dizinlerini adlandırmak için kullanılan Android Locale tanımlayıcısı
%osx_code%	".lproj" dizinlerini adlandırmak için kullanılan OS X Locale tanımlayıcısı
%original_path%	Sonuçta oluşan pakette dosya yolunu oluşturmak için Crowdin projesindeki ana klasörlerin adlarını alır
%file_extension%	Orijinal dosya uzantısı
%file_name%	Uzantısız dosya adı

Gelişmiş Ayarlar

Dosyaları Yoksayma

Çevrilmemesi gereken dosyaların olması durumunda, Yoksayılan Şekil seçeneğini kullanın ve Crowdin, çeviri için belirli dosyaları yüklemeyecek.

Dil Eşleme

Crowdin tarafından tanımlananlar dışındaki özel dil kodlarını kullanmak için dil eşlemesini ayarlayabilirsiniz. Bu, dışa aktarılan çeviri dosyalarının yapısının tutarlı kalmasına yardımcı olacak. İhtiyacınız olduğu kadar dil eşleyebilirsiniz.

Dil eşlemesi eklemek için şu adımları izleyin:

1. Dil Eşleme bölümünü açın.
2. Gerekli dili ve yer tutucuyu seçin.
3. Özel kod ekleyin.
4. Başka bir özel kod eklemek için Eşleme Ekle’ye tıklayın.
5. Kaydet’e tıklayın.

Elektronik Tabloları Yapılandırma

Dosyanızın yapısını Şema alanında tanımlayın. Virgül kullanarak değerleri gerekli sırada listeleyin:

• identifier — sütun, kaynak dizginin benzersiz bir tanımlayıcısını içerir
• source_phrase — bu sütun, çevrilmesi gereken gerçek metni içerir
• source_or_translation — Crowdin, bu sütundaki metinleri çeviri için kaynak dizgiler olarak düşünür ve ortaya çıkan dosyayı indirirken bunları çevrilmiş metinlerle değiştirir
• translation — sonuçta ortaya çıkan çeviri dosyaları bu sütuna yerleştirilir
• context — kaynak dizgilerin anlamını daha iyi anlamanıza yardımcı olan herhangi bir bağlamsal bilgi
• max_length — çevrilen metinlerin en fazla uzunluğunu tanımlar

Eğer bir elektronik tablo tüm hedef diller için çevirileri içeriyorsa, Çok dilli elektronik tablo seçeneğini kullanabilirsiniz. Ayrıca, Şema alanında çevirilerin bulunduğu sütunların sırasını belirtin, örneğin: identifier,source_phrase,context,uk,ru,tr (Dil Kodları).

İlk satırda yer alan metnin çevrilmesini istemediğiniz durumda, * İlk satırı başlık olarak içe aktar* seçeneğini işaretleyin.

XML Dosyalarını Yapılandırma

İçeriği Çevirme	Etiketlerin içine yerleştirilen metinlerin çevirip çevrilmeyeceğini tanımlar
Öznitelikleri Çevirme	Etiket özniteliklerinin çevrilip çevrilmeyeceğini tanımlar
İçerik Bölümlemesi	Uzun metinlerin daha küçük metin parçalarına bölünüp bölünmeyeceğini tanımlar. Önemli! Bu seçenek, etkinleştirildiğinde XML dosyaları için varolan çevirileri yükleme olasılığını etkisizleştirir.
Çevrilebilir Öğeler	Bu, XPaths olan yerdeki her öğenin DOM öğesine aktarılması gereken dizgilerin bir dizilimidir. Örnek yol: /düğüme/giden/yol veya /özniteliğe/giden/yol[@attr]

Ek Parametreler

Aşağıdaki parametreler çevrimiçi olarak yapılandırılamaz:

• preserve_hierarchy - Crowdin’e dizin yapısını kaydeder
• dest - Crowdin’de bir dosya adı belirtmenizi sağlar
• type - Crowdin’de bir dosya türü belirtmenizi sağlar
• update_option - dosya güncellemesi sırasında çevirileri korur ve değiştirilen dizgilerde onayları korur/kaldırır
• commit_message - Git etiketlerini içerebilen ek işleme iletisi
• export_languages - belirtilen diller için çevirileri dışa aktarır

Çevrimiçi yapılandırmayı kaydetmenizden sonra, yapılandırılan dalda bir crowdin.yaml dosyası oluşturulacaktır. Gerekli parametreleri eklemek için bu dosyayı el ile düzenleyebilirsiniz. Yapılandırma dosyası hakkında daha fazlasını okuyun.

Yapılandırmayı Kaydetme

Oluşturulan yapılandırmayı önizlemek için Kaydet’e tıklayın.

Farklı yapılandırmalara sahip çeşitli dosya gruplarınız varsa Dosya Süzgeci Ekle’ye tıklayın.

Eğer projede aynı yapılandırmayı paylaşan birkaç dal varsa ve bunlara farklı süzgeçler uygulanmalıysa, Tüm çevrilebilir dallara süzgeçleri uygula’yı işaretleyin.

Oluşturulan yapılandırmayı kaydetmek için Kaydet’e tıklayın.

Kaydettikten sonra, yerelleştirilebilir dosyaların Crowdin’e yüklenmesi başlayacaktır.

Ayrıca Bakınız

• GitHub Bütünleştirmesi
• Bitbucket Bütünleştirmesi
• Yapılandırma Dosyası