GitHub Crowdin Action, Crowdin Enterprise projenizin yerelleştirilmesini GitHub Actions yardımıyla deponuzda ayarladığınız iş akışına kolayca bütünleştirmenizi sağlar. GitHub Crowdin Action kullanarak, yerelleştirme kaynaklarının Crowdin Enterprise projenizle eşitlenmesini otomatikleştirebilirsiniz.
With this action you can do the following things:
.github/workflows/crowdin.yml içinde bir iş akışı ayarlayın (veya varolan iş akışlarınıza bir iş ekleyin).
Özel iş akışlarının nasıl oluşturulduğu ve ayarlandığı hakkında daha fazla ayrıntı için Bir iş akışını yapılandırma makalesini okuyun.
name: Crowdin Action
on:
push:
branches: [ master ]
jobs:
synchronize-with-crowdin:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v2
- name: crowdin action
uses: crowdin/github-action@1.0.4
with:
upload_translations: true
download_translations: true
env:
GITHUB_TOKEN: $
CROWDIN_PROJECT_ID: $
CROWDIN_PERSONAL_TOKEN: $
Varsayılan eylem kaynakları yüklemektir. Yine de, with seçenekleri aracılığıyla farklı eylemler ayarlayabilirsiniz. Eğer kaynaklarınızı Crowdin Enterprise’a yüklemek istemiyorsanız, upload_sources seçeneğini false olarak ayarlayın.
Varsayılan olarak kaynaklar ve çeviriler Crowdin Enterprise projenizin kök dizinine yüklenmektedir. Yine de, eğer dalları kullanıyorsanız, tercih edilen kaynak dalını ayarlayabilirsiniz.
Çevirilerinizi indirmek istediğiniz GitHub dalını da belirleyebilirsiniz (varsayılan çeviri dalı l10n_crowdin_action).
Crowdin’den çevirileri indirmek istemediğiniz durumda (download_translations: false), localization_branch_name ve create_pull_request seçenekleri de gerekmez.
- name: crowdin action
with:
# upload options
upload_sources: true
upload_translations: true
# download options
download_translations: true
language: 'uk'
push_translations: true
# This is the name of the git branch that Crowdin Enterprise will create when opening a pull request.
# Bu dalın el ile oluşturulması GEREKMEZ. Eylem tarafından otomatik olarak oluşturulacaktır.
localization_branch_name: l10n_crowdin_action
create_pull_request: true
# genel seçenekler
# Bu, Crowdin’in dosyalar için kullanacağı en üst seviye dizinin adıdır.
# Bunun git anlamında bir "dal" olmadığını, daha çok Crowdin Enterprise projenizdeki bir üst seviye dizin gibi olduğunu unutmayın.
# Bu dalın el ile oluşturulması GEREKMEZ. Eylem tarafından otomatik olarak oluşturulacaktır.
crowdin_branch_name: l10n_branch
identity: '/path/to/your/credentials/file'
config: '/path/to/your/crowdin.yml'
dryrun_action: true
# config options
# This is a project numeric id
# Open a project and see "Crowdin API" at Resources > Integrations & API
project_id: $
# This is a personal access token
# Open a project and see "Crowdin API" at Resources > Integrations & API > Create Token
token: $
source: '/path/to/your/file'
translation: 'file/export/pattern'
base_url: 'https://crowdin.com'
base_path: '/project-base-path'
Bu seçeneklerin daha ayrıntılı açıklamaları için bakınız action.yml.
Eğer iş akışı dosyanız yapılandırma özelliğini içeriyorsa, Crowdin Enterprise yapılandırma dosyanıza (örn. crowdin.yml) aşağıdakileri eklemeniz gerekecek:
project_id_env: CROWDIN_PROJE_KİMLİĞİ
api_token_env: CROWDIN_KİŞİSEL_BELİRTECİ
İş akışı çalıştığında, belirteç ve proje kimliğinizin gerçek değerleri, ortamdaki gizli anahtarlar kullanılarak yapılandırmaya yerleştirilecektir.