Step 1: Kōwhiria he kaituku takatau
Ka mahi te hohenga me te Azure AI Translator, te Whakamāori AWS, me te Whakawhitinga Kapua Google i muri i tētahi mata API whakakotahi. Kōwhiria tētahi kaiwhakarato kotahi mō ia whakahaere me te tāuru provider — he ōrite te whanonga o te rerengamahi ahakoa te kaiwhakarato; ko ngā taipitopito tuakiri anake e rerekē ana. Tirohia Ngā kaituku takatau mō tētahi tauritenga katoa.
Step 2: Tāpirihia ngā taipitopito tuakiri me tētahi rerengamahi
Rokiroki i ngā taipitopito tuakiri o tō kaiwhakarato hei muna putunga GitHub, kātahi ka waihanga .github/workflows/translate.yml. Tīpakohia tō kaiwhakarato i raro nei mō tōna tatūnga motuhake - he ōrite te toenga o te rerengamahi.
Azure AI Translator
Ko Azure te kaiwhakarato taunoa, nō reira ka aweretia pea provider. Whakaratohia tētahi rauemi Azure AI Translator ki te tomokanga Azure, kātahi ka penapena i ōna pūkenga:
Penapenatia ēnei hei muna putunga
TRANSLATOR_KEY— te kī ohaurunga mō te rauemi.TRANSLATOR_ENDPOINT— te URL tōpito ā-rohe.TRANSLATOR_REGION— te rohe Azure o te rauemi.
Tāpirihia te rerengamahi
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-translationWhakamāori AWS
Tautuhia provider ki aws. He pai ake ki te OIDC mā te aws-actions/configure-aws-credentials kia kore ai e penapenatia ngā mea ngaro roa - ka AWS_REGION te kaweake hipanga māu. Hei whakamahi kē i ngā kī pateko, penapenatia:
Penapenatia ēnei hei muna putunga
AWS_ACCESS_KEY_ID— tō ID kī uru AWS.AWS_SECRET_ACCESS_KEY— tō kī uru muna AWS.
E hiahiatia ana tētahi rohe i ngā wā katoa — tautuhia ki te awsRegion, ki te taurangi taiao AWS_REGION rānei.
Tāpirihia te rerengamahi
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-translationWhakawhitinga Kapua Google
Tautuhia provider ki google. Whakamotuhēhētia ki tētahi taipitopito tuakiri JSON pūkete ratonga, ki tētahi kī API rānei — homai kia kotahi:
Penapenatia ēnei hei muna putunga
GCP_TRANSLATE_CREDENTIALS— he kī JSON pūkete-ratonga (hei aho JSON).GCP_TRANSLATE_API_KEY— tētahi kī Google Cloud API rānei.
Ina aweretia tētahi googleProjectId kōwhiringa mai i te taipitopito tuakiri.
Tāpirihia te rerengamahi
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: Tukua he kōnae rauemi pūtake
Ka whakamahia e ngā kōnae rauemi te Name.<sourceLocale>.<ext> convention. Hei tauira, ka noho Greetings.en.resx Greetings.fr.resx, Greetings.de.resx, me ērā atu mea i muri i te oma.
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: Tirohia te huaputa
Ka mutu te rerengamahi, ka whakaaturia e te hohenga e toru ngā huaputa ka taea e koe te waea ki tētahi whakaahuatanga PR: summary-title, summary-details, me has-new-translations. Ka tuhi hoki i tētahi whakarāpopototanga Markdown ki te whārangi mahi mā te core.summary.