Step 1: Khetha umnikezeli womguquleli
Isenzo sisebenza nge-Umguquleli we-Azure AI, i-Ukuguqulela kwe-AWS, kunye ne-Inguqulelo yelifu likaGoogle ngasemva kwendawo enye ye-API edibeneyo. Khetha umboneleli omnye ngokubaleka ngegalelo le-provider - ukuhamba komsebenzi kuziphatha ngokufanayo kungakhathaliseki ukuba ngumboneleli; Kuphela iziqinisekiso ziyahluka. Jonga Ababoneleli bokuguqulela ukuze uthelekise ngokupheleleyo.
Step 2: Yongeza iziqinisekiso kunye nokuhamba komsebenzi
Gcina iziqinisekiso zomboneleli wakho njengeemfihlo zeGitHub, emva koko wenze .github/workflows/translate.yml. Khetha umboneleli wakho apha ngezantsi ukuseta kwakhe okuthile-yonke indlela yokuhamba komsebenzi iyafana.
Umguquleli we-Azure AI
I-Azure ngumboneleli ongagqibekanga, ngoko ke provider inokushiywa. Ukubonelela ngesibonelelo se-Azure AI Translator kwi-portal ye-Azure, emva koko ugcine iziqinisekiso zayo:
Zigcine ezi njengendawo yokugcina izinto ezifihlakeleyo
TRANSLATOR_KEY— Isitshixo sobhaliso sezixhobo.TRANSLATOR_ENDPOINT— I-URL yesiphelo sommandla.TRANSLATOR_REGION— Ummandla we-Azure we-Azure.
Yongeza umkhondo womsebenzi
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-translationUkuguqulela kwe-AWS
Misela provider kwi-aws. Khetha i-OIDC nge-aws-actions/configure-aws-credentials ukuze kungabikho zimfihlo ezihlala ixesha elide zigcinwayo - ukuthunyelwa kwenyathelo AWS_REGION kuwe. Ukusebenzisa izitshixo ezifikeleleka ngqo endaweni yoko, gcina:
Zigcine ezi njengendawo yokugcina izinto ezifihlakeleyo
AWS_ACCESS_KEY_ID— I-ID yakho yesitshixo sokufikelela kwi-AWSAWS_SECRET_ACCESS_KEY— Isitshixo sakho sokufikelela esifihlakeleyo se-AWS
Ummandla uhlala uyimfuneko — uyibeke nge-awsRegion okanye i-AWS_REGION yokuguquguquka kwemeko-bume.
Yongeza umkhondo womsebenzi
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-translationInguqulelo yelifu likaGoogle
Misela provider kwi-google. Qinisekisa ngesiqinisekiso se-JSON se-akhawunti yenkonzo okanye isitshixo se-API - unikezele ngokuchanekileyo:
Zigcine ezi njengendawo yokugcina izinto ezifihlakeleyo
GCP_TRANSLATE_CREDENTIALS— Isitshixo se-JSON se-akhawunti yenkonzo (njengomtya we-JSON).GCP_TRANSLATE_API_KEY— okanye isitshixo seGoogle Cloud API.
I-googleProjectId yokuzikhethela ithathwa kwisiqinisekiso xa ishiyiwe.
Yongeza umkhondo womsebenzi
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: Yenza ifayili yovimba womthombo
Iifayile zemithombo zisebenzisa ingqungquthela ye-Name.<sourceLocale>.<ext>. Umzekelo, Greetings.en.resx iba Greetings.fr.resx, Greetings.de.resx, njalo njalo emva kokubaleka.
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: Hlola isiphumo
Nje ukuba ukuhamba komsebenzi kugqityiwe, isenzo siveza iziphumo ezintathu onokuzifaka kwinkcazo ye-PR: summary-title, summary-details, kunye ne-has-new-translations. Ikwabhala isishwankathelo seMarkdown kwiphepha lomsebenzi nge-core.summary.