GitLab ile bütünleştirme, Crowdin Enterprise’daki ç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.
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 Enterprise Hesabı ile bütünleştirmek için erişim belirteci oluşturmalısınız. Gerekli kapsamı seçtiğinizden emin olun:
When you work with private integrations (e.g., integrations with self-hosted VCS), you need to add dedicated Crowdin Enterprise IP addresses to the whitelist to ensure that it operates properly while staying secure.
IP Adresleri hakkında daha fazlasını okuyun.
When translations are finished and your languages are ready to go live, Crowdin Enterprise sends merge request with translations to your version control system. Yerelleştirme altındaki her dal için Crowdin Enterprise, ç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.
Varsayılan olarak, kaynaklar çevirilerle depoya yollanmaz. Eğer Crowdin Enterprise projenizde kaynak metin değişiklikleri yaparsanız ve Crowdin Enterprise’daki 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 Enterprise ile yine de eşitlenecektir.
Bütünleştirmeyi ayarladığınızda, Crowdin Enterprise projesine eklenmesi gereken mevcut depo dallarını seçersiniz. To add future branches from GitLab to Crowdin Enterprise automatically, create a pattern for the branch names in the integration’s settings.
Ö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:
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.
Bütünleştirmenin çalışması için hangi kaynak dosyaların çevrilmesi gerektiğini ve Crowdin Enterprise’ın 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.
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.
Configuration file crowdin.yaml should be stored in the GitLab repository along with each separate branch that you want to translate, so Crowdin Enterprise knows what files exactly should be sent for translations.
CLI 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ı okuyun.
Once the integration is set up, all the related information is stored in the same place – Resources > Integrations & API, GitLab section. 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.
Varsayılan olarak, depoda saklanan çeviriler sadece ilk eşitleme sırasında Crowdin Enterprise’a yüklenir. Çevirileri Crowdin Enterprise’a el ile yüklemek içinŞimdi Eşitle düğmesinin yanındaki simgesine tıklayın ve ardından Çevirileri Yükle’ye tıklayın. Bütünleştirme, varolan çevirileri Crowdin Enterprise projesine yükleyecek.