Step 1: Тәржемә провайдерын һайлағыҙ
Эш Azure AI Translator, AWS Translate һәм Google Cloud тәржемәһе берҙәм API өҫтөндә эшләй. Һәр йүгереү өсөн бер провайдерҙы provider индереү менән һайлағыҙ — эш ағымы провайдерға ҡарамаҫтан бер төрлө эшләй; Тик квалификациялар ғына айырыла. Тулы сағыштырыу өсөн Тәржемә тәьмин итеүсе провайдерҙар ҡарағыҙ.
Step 2: Мәғлүмәттәр һәм эш ағымы өҫтәгеҙ
Провайдерҙың мәғлүмәттәрен GitHub репозиторий серҙәре итеп һаҡлағыҙ, һуңынан .github/workflows/translate.yml булдырығыҙ. Түбәндәге провайдерҙы һайлағыҙ — уның махсус көйләүе өсөн — эш ағымының ҡалған өлөшө бер үк.
Azure AI Translator
Azure төп провайдер булып тора, шуға күрә provider күрһәтелмәҫкә мөмкин. Azure порталында Azure AI тәржемәсе ресурсын тәьмин итегеҙ, һуңынан уның мәғлүмәттәрен һаҡлағыҙ:
Быларҙы репозиторий серҙәре итеп һаҡлағыҙ
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 Cloud тәржемәһе
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 аша яҙа.