Step 1: Котормо провайдерин тандаңыз
Бул аракет Azure AI Translator, AWS Translate жана Google Булут Котормо бирдиктүү API бетинин артында иштейт. Ар бир иштетүү үчүн бир провайдерди provider киргизүү менен тандаңыз — иш агымы провайдерге карабастан бирдей жүрөт; Тек гана квалификациялар айырмаланат. Толук салыштыруу үчүн Котормо провайдерлери караңыз.
Step 2: Каттоо маалыматтарын жана иш агымын кошуу
Провайдериңиздин маалыматтарын GitHub репозиторийинин сырлары катары сактаңыз, андан кийин .github/workflows/translate.yml түзүңүз. Төмөндөгү провайдериңизди тандаңыз, анын так орнотуусуна жараша — калган иш агымы бирдей.
Azure AI Translator
Azure демейки провайдер болуп саналат, ошондуктан provider колдонулбай калышы мүмкүн. Azure порталында Azure AI Translator ресурсун камсыз кылып, андан кийин анын маалыматтарын сактаңыз:
Буларды сактоочу сырлар катары сакта
TRANSLATOR_KEY— Бул ресурстун жазылуу ачкычы.TRANSLATOR_ENDPOINT— аймактык акыркы чекит URL.TRANSLATOR_REGION— ресурстун Azure аймагы.
Иш агымын кош
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate uses: IEvangelist/resource-translator@v3 with: provider: | azure: subscriptionKey: ${{ secrets.TRANSLATOR_KEY }} endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }} region: ${{ secrets.TRANSLATOR_REGION }} sourceLocale: en toLocales: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationAWS Translate
Аны provider aws. OIDCни aws-actions/configure-aws-credentials аркылуу артык көрөм, анткени узак мөөнөттүү сырлар сакталбайт — экспорттоо AWS_REGION кадам сиз үчүн. Статикалык ачкычтарды колдонуу үчүн, сактаңыз:
Буларды сактоочу сырлар катары сакта
AWS_ACCESS_KEY_ID— сенин AWS кирүү ачкыч ID.AWS_SECRET_ACCESS_KEY— сиздин AWS жашыруун кирүү ачкычыңыз.
Ар дайым аймак талап кылынат — аны awsRegion же AWS_REGION чөйрө өзгөрмөсү менен коюңуз.
Иш агымын кош
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: id-token: write # for aws-actions/configure-aws-credentials (OIDC) contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - uses: aws-actions/configure-aws-credentials@v4 with: role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate aws-region: us-east-1 - id: translate uses: IEvangelist/resource-translator@v3 with: provider: | aws: region: us-east-1 # or rely on AWS_REGION from the step above formality: FORMAL brevity: true sourceLocale: en toLocales: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationGoogle Булут Котормо
Аны provider google. Кызмат-аккаунттун JSON идентификациясы же API ачкычы менен аутентификация жүргүзүңүз — так бирөөнү бериңиз:
Буларды сактоочу сырлар катары сакта
GCP_TRANSLATE_CREDENTIALS— кызматтык аккаунттагы JSON ачкычы (JSON сап катары).GCP_TRANSLATE_API_KEY— же Google Cloud API ачкычы.
Эгерде квалификация жок болсо googleProjectId кошумча аныкталат.
Иш агымын кош
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate uses: IEvangelist/resource-translator@v3 with: provider: | google: # Provide EITHER a service-account JSON credential... credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }} # ...OR an API key: # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }} model: nmt sourceLocale: en toLocales: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationStep 3: Булак ресурс файлын бекитүү
Ресурс файлдары Name.<sourceLocale>.<ext> конвенциясын колдонушат. Мисалы, Greetings.en.resx чуркоодон кийин Greetings.fr.resx, Greetings.de.resx жана башка болуп калат.
Step 4: Let smart change detection protect your bill
changeDetection defaults to smart and stores a compact .github/resource-translator-state.json manifest in the repo. Commit that file so future runs can reuse stable translations, preserve manual target edits, and send only new, missing, changed, or settings-invalidated keys to the provider. If localized files already exist, run once with snapshotOnly: true to create the manifest without provider calls.
Step 5: Натыйжаны текшер
Иш агымы аяктагандан кийин, бул аракетте PR сүрөттөмөсүнө туташтыра турган үч чыгуу ачылат: summary-title, summary-details жана has-new-translations. Ошондой эле жумуш барагына Markdown кыскача мазмуну core.summary аркылуу жазат.