GitHub Bütünleştirmesi

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

GitHub’ı Crowdin Enterprise ile Bağlama

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

GitHub Hesabını Bağlama

  1. Crowdin Enterprise projenizi açın ve Uygulamalar > Sistem’e gidin.
  2. Bütünleştirmeler listesinde GitHub’a tıklayın.
  3. GitHub hesabınız aracılığıyla bütünleştirmek için Bütünleştirmeyi Ayarla’ya tıklayın.
  4. Then authorize the connection with Crowdin Enterprise on the GitHub side.

İhtiyacınız olan deponun özel olması durumunda ve buna erişiminiz kısıtlıysa veya hiç erişiminiz yoksa lütfen depo sahibinden size Erişim Belirteci sağlamasını isteyin. Daha sonra, Kişisel erişim belirteci kullan’a tıklayın ve belirteci Belirteç alanına yerleştirin ve Bütünleştirmeyi Ayarla’ya tıklayın.

GitHub Enterprise Hesabını Bağlama

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

    • repo – Özel depoların tam denetimi
    • admin:repo_hook – Depo kancalarının tam denetimi
  2. Click on GitHub Enterprise in the Integrations list.
  3. 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.

Depoyu Seçme

Ortaya çıkan ileti öğesinde, deponuzu ve çevrilmesi gereken dalları seçin. Kopya Dizgileri Bir sürüm dalı içinde göster olarak değiştirilmesi önerilir, böylece dallar arasında aynı dizgiler gizlenecektir. Eğer kaynak dosyalarınız görünen tanımlayıcılara (anahtarlar) sahip dizgiler içeriyorsa, bu seçeneğin tam sürümünü kullanmak daha iyidir. Diğer durumlarda, düzenli olanı kullanmaktan çekinmeyin.

Çoğaltılmış Dizgiler hakkında daha fazlasını okuyun.

Özel bütünleştirmelerle (örn. kendi kendine barındırılan VCS ile bütünleştirmeler) çalıştığınızda, güvenli kalırken düzgün olarak çalışmasını sağlamak için beyaz listeye adanmış Crowdin Enterprise IP adresleri eklemeniz gerekir.

IP Adresleri hakkında daha fazlasını okuyun.

Hizmet Dalları

Çeviriler tamamlandığında ve dilleriniz yayınlanmaya hazır olduğunda, Crowdin Enterprise sürüm denetim sisteminize çevirilerle çekme isteği gönderir. Yerelleştirme altındaki her dal için Crowdin Enterprise, çevirilerle ek bir 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ştirebilirsiniz.

Eşitleme Ayarları

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ştirme 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ştirme 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ştirme 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ı için aşağı kaydırın, tercih edilen aralığı ayarlayın ve Kaydet’e tıklayın.

Eşitleme ayarlarına bağlı kalmadan, kaynak dosyaların depodaki değişiklikleri her on dakikada bir Crowdin Enterprise ile yine de eşitlenecektir.

Otomatik Olarak Eşitlenecek Dallar

Bütünleştirmeyi ayarladığınızda, Crowdin Enterprise projesine eklenen mevcut depo dallarını seçersiniz. To add future branches from GitHub to Crowdin Enterprise automatically, create a pattern for the branch names in the integration settings.

Örneğin, GitHub 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. GitHub bütünleştirmesi bölümünde Düzenle’ye tıklayın.
  2. Ortaya çıkan ileti öğesinde, Otomatik Olarak Eşitlenecek Dallar için aşağı 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.

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ştirme ayarlarındaki Varsayılan yapılandırma dosyası adı alanında tercih edilen adı belirtin ve Kaydet’e tıklayın.

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

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. Eğer hizmet dalı adının yanında ünlem işareti bulunan kırmızı bir simge görürseniz 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

Configuration file crowdin.yml should be stored in the GitHub 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.

Tek Bir Proje içinde Birden Çok Depo ile Çalışma

Farklı işletim sistemleri için sürümleri olan çok platformlu bir ürünle çalışırken, her işletim sistemi için kaynak dosyaları içeren birden çok depoyu bağlamak isteyebilirsiniz. Bu durumda, yerelleştirme kaynakları (örn. ÇB’ler, Sözlükler) ve çeviriler, proje yerelleştirmesi için gereken süreyi azaltarak daha verimli bir şekilde kullanılabilir.

Başka bir depo eklemek için şu adımları izleyin:

  1. Crowdin Enterprise projenizi açın ve Uygulamalar > Sistem’e gidin.
  2. Bütünleştirmeler listesinde GitHub’a tıklayın.
  3. Depo Ekle’ye tıklayın.
  4. Yeni depo ile bütünleştirmeyi ihtiyaçlarınıza ve tercihlerinize göre yapılandırın.

Eşitleme Durumunu Denetleme

Once the integration is set up, all the related information is stored in the same place – Applications > System > GitHub 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.

GitHub Şimdi Eşitleme

Depodan Çevirileri Yükleme

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 projenize yükleyecek.

Soru ve Yanıt

Q: What should I do if my repository becomes a part of the GitHub organization?
A: To continue using GitHub integration in Crowdin Enterprise, follow these steps:

  1. GitHub hesabınızda Yetkili OAuth Uygulamaları’na gidin.
  2. Listede Crowdin OAuth Uygulamasını bulun ve erişimini iptal edin.
  3. Set up the GitHub integration in your Crowdin Enterprise project again using the instructions above.

Ayrıca Bakınız

Bu makale yararlı oldu mu?