GitLab Bütünleştirmesi

GitLab ile bütünleştirme, Crowdin’deki çeviri projeniz ile GitLab deponuz arasında kaynak ve çeviri dosyalarını eşitler. Çevrilen ve onaylanan tüm dosyalar, GitLab deposundaki l10n dalına birleştirme isteği şeklinde otomatik olarak yollanacaktır.

GitLab’ı Crowdin ile Bağlama

Aralarından seçim yapabileceğiniz iki olası seçenek vardır. Ya GitLab Hesabınızı ya da GitLab Enterprise Hesabınızı kullanabilirsiniz.

GitLab Hesabını Bağlama

  1. Crowdin’de Proje Ayarları, Bütünleştirmeler sekmesini açın ve GitLab Hesabınız aracılığıyla bütünleştirmek için Bütünleştirmeyi Ayarla’ya tıklayın.

  2. Ardından GitLab tarafında Crowdin ile bağlantıyı yetkilendirin:

GitLab Enterprise Hesabını Bağlama

  1. GitLab Enterprise Hesabı ile bütünleştirmek için erişim belirteci oluşturmalısınız. Gerekli kapsamı seçtiğinizden emin olun:

    • api – Tüm gruplar ve projeler, kapsayıcı kayıt defteri ve paket kayıt defteri de dahil olmak üzere API’ye tam okuma/yazma erişimi verir
Not: Bir erişim belirteci ile bir bütünleştirme ayarlarken, gerekli depo için bakımcı seviyesinde izne sahip olduğunuzdan emin olun.
  1. Ardından erişim belirtecinizi ve Temel URL’nizi ilgili alanlara yerleştirin. Devam etmek için Bütünleştirmeyi Ayarla’ya tıklayın.

  2. Açılır ileti öğesinde, deponuzu ve çevrilmesi gereken dalları seçin. Kopya Dizgileri Göster (Sürümler için önerilir) olarak değiştirilmesi önerilir, böylece dallar arasında aynı dizgiler gizlenecektir. Kopya Dizgiler hakkında daha fazlasını okuyun.

Hizmet Dalları

Çeviriler tamamlandığında ve dilleriniz yayınlanmaya hazır olduğunda, Crowdin sürüm denetim sisteminize çevirilerle birleştirme isteği gönderir. Yerelleştirme altındaki her dal için Crowdin, çevirilerle ek hizmet dalı oluşturur. Doğrudan master dalına işlemeyiz böylece önce çevirileri doğrulayabilirsiniz.

Varsayılan olarak, oluşturulan hizmet dalı adına l10n \ _ eklenir. Eğer gerekirse kolayca değiştirilebilir.

Eşitleme Ayarları

Varsayılan olarak, kaynaklar çevirilerle depoya yollanmaz. Eğer Crowdin projenizde kaynak metin incelemesi yaparsanız ve Crowdin’deki kaynak dosyalarınızda yaptığınız değişiklikleri deponuza geri yollamak isterseniz, Düzenle’ye tıklayın, bütünleştirmenin ayarlarında Kaynakları Yolla’yı seçin ve Kaydet’e tıklayın.

Çevirilerin geçici olarak depoya yollanmasını etkisizleştirmenin gerekli olduğu durumlar vardır. Bu durumda, bütünleştirmenin ayarlarında Düzenle’ye tıklayın, Çevirileri Yolla işaretini kaldırın ve Kaydet’e tıklayın. Çevirileri depo ile eşitlemeye hazır olduğunuzda, Çevirileri Yolla seçeneğini işaretleyin ve Kaydet’e tıklayın.

Eşitleme her saat otomatik olarak işlenir. Eğer gerekirse, bütünleştirmenin ayarlarından güncelleme aralığını değiştirebilirsiniz. Eşitleme zamanlamasını yapılandırmak için – Düzenle’ye tıklayın, Eşitleme Zamanlaması ayarına doğru kaydırın, tercih edilen aralığı ayarlayın ve Kaydet’e tıklayın.

Eşitleme ayarlarına bağlı kalmadan, depodaki kaynak dosyalarda yapılan değişiklikler her 10 dakikada bir Crowdin ile yine de eşitlenecektir.

GitLab eşitleme ayarları

Otomatik Olarak Eşitlenecek Dallar

Bütünleştirmeyi ayarladığınızda, Crowdin projesine eklenmesi gereken mevcut depo dallarını seçersiniz. GitLab’dan Crowdin’e ileride dalları otomatik olarak eklemek amacıyla bütünleştirme ayarlarında dal adları için bir model oluşturun.

Örneğin, GitLab bütünleştirmesi ayarlarına *özellik şeklinde bir model ekleyin. Bu durumda, başlığın sonunda bu kelimeyi içeren gelecekteki dallar projeye eklenecektir.

Dal adlarına bir şekil eklemek için şu adımları izleyin:

  1. GitLab bütünleştirmesi bölümünde Düzenle’ye tıklayın.
  2. Açılır ileti öğesinde Otomatik Olarak Eşitlenecek Dallar ayarına doğru kaydırın.
  3. Otomatik Olarak Eşitlenecek Dallar alanında, gerekli dalları tanımlamak için ‘*’, ‘?’, ‘[set]’, ‘' ve diğerleri gibi joker karakter seçicileri kullanın.
  4. Kaydet’e tıklayın. Otomatik Olarak Eşitlenecek Dallar

Varsayılan yapılandırma dosyası adı

crowdin.yml otomatik olarak eşitlenen dallar için kullanılan varsayılan dosya adıdır. Varsayılan ayarları değiştirmek için Düzenle’ye tıklayın, bütünleştirmenin ayarlarındaki Varsayılan yapılandırma dosyası adı alanında tercih edilen adı belirtin ve Kaydet’e tıklayın.

Varsayılan yapılandırma dosyası adı

Eşitleme için İçerik Seçme

Bütünleştirmenin ç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. Hizmet dalı adının yanında ünlem işareti bulunan kırmızı bir simge görmeniz durumunda bu, eşitleme için içerik seçmediniz anlamına gelir.

Bunu yapmanın iki yolu vardır: bir yapılandırma dosyası oluşturarak çevrimiçi veya el ile yapılandırma.

Çevrimiçi Yapılandırma

Bu yöntem, sürüm denetim sistemleri (VCS) ile tüm bütünleştirmeler için aynıdır. Çevrimiçi eşitleme amacıyla nasıl içerik seçileceğini öğrenmek için VCS Bütünleştirmeleri: Çevrimiçi Yapılandırma’yı gözden geçirin.

Yapılandırma Dosyası Oluşturma

Çevirmek istediğiniz her ayrı dal ile birlikte crowdin.yaml yapılandırma dosyası GitLab deposunda saklanmalıdır, böylece Crowdin çeviriler için tam olarak hangi dosyaların gönderilmesi gerektiğini bilir.

Eşitleme Aracı için gereken aynı yapıya sahip olmalıdır, ancak projenizin kimlik bilgileri güvenlik nedeniyle dosyanın üstbilgisinde saklanmamalıdır. Bir yapılandırma dosyası oluşturma hakkında daha fazlasını okluyun.

Eşitleme Durumunu Denetleme

Bütünleştirme ayarlandıktan sonra, ilgili tüm bilgiler aynı yerde saklanır – Proje Ayarları, Bütünleştirmeler sekmesi, GitLab bölümü. Varsayılan olarak, eşitleme her saat otomatik olarak işlenir. Eğer eşitlemeyi hemen başlatmanız gerekiyorsa – Şimdi Eşitle’ye tıklayın.

GitLab Şimdi Eşitleme

Depodan Çevirileri Yükleme

Varsayılan olarak, depoda depolanan çeviriler sadece ilk eşitleme sırasında Crowdin’e yüklenir. Çevirileri Crowdin’e el ile yüklemek için Şimdi Eşitle düğmesindeki açılır menü okuna tıklayın ve ardından Çevirileri Yükle’ye tıklayın. Bütünleştirme, varolan çevirileri Crowdin projesine yükleyecek.

GitLab Çevirileri Yükleme

Ayrıca Bakınız

Bu makale yararlı oldu mu?