Step 1: Misafidiana mpamatsy fandikan-teny
Ny hetsika dia miasa miaraka amin'ny Azure AI Translator, Fandikan-teny AWS ary Fandikan-teny Google Cloud ao ambadiky ny API iray mitambatra. Misafidiana mpamatsy tokana isaky ny mihazakazaka miaraka amin'ny fampidirana provider - ny fizotran'ny asa dia mitondra tena mitovy na inona na inona mpamatsy; ny fahazoan-dàlana ihany no tsy mitovy. Jereo Mpanome fandikan-teny ho an'ny fampitahana feno.
Step 2: Ampio ny fahazoan-dàlana sy ny fizotran'ny asa
Tehirizo ny fahazoan-dàlan'ny mpamatsy anao ho tsiambaratelon'ny tahiry GitHub, avy eo mamorona .github/workflows/translate.yml. Safidio ny mpamatsy anao etsy ambany ho an'ny fametrahana azy manokana - ny sisa amin'ny fizotran'ny asa dia mitovy.
Azure AI Translator
Azure no mpamatsy default, noho izany provider azo esorina izany. Omeo loharanon-karena Azure AI Translator ao amin'ny vavahadin-tserasera Azure, avy eo tehirizo ny fahazoan-dàlana:
Tehirizo ho toy ny tsiambaratelon'ny tahiry
TRANSLATOR_KEY— Ny famandrihana fanalahidy ho an'ny loharano.TRANSLATOR_ENDPOINT— ny URL farany isam-paritra.TRANSLATOR_REGION— ny faritra Azure an'ny loharanon-karena.
Ampidiro ny fizotran'ny asa
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-translationFandikan-teny AWS
Apetraho provider amin'ny aws. Aleo ny OIDC amin'ny alàlan'ny aws-actions/configure-aws-credentials mba tsy hisian'ny tsiambaratelo maharitra voatahiry - ny fanondranana dingana AWS_REGION ho anao. Mba hampiasana ny fanalahidy static, mitahiry ny:
Tehirizo ho toy ny tsiambaratelon'ny tahiry
AWS_ACCESS_KEY_ID— ny ID fidirana amin'ny AWS.AWS_SECRET_ACCESS_KEY— Ny fanalahidin'ny fidirana miafina AWS.
Ilaina foana ny faritra iray - apetraho amin'ny awsRegion na ny AWS_REGION tontolo iainana miovaova.
Ampidiro ny fizotran'ny asa
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-translationFandikan-teny Google Cloud
Apetraho provider amin'ny google. Manamarina amin'ny alàlan'ny fahazoan-dàlana JSON amin'ny kaonty serivisy na fanalahidy API - manome iray marina:
Tehirizo ho toy ny tsiambaratelon'ny tahiry
GCP_TRANSLATE_CREDENTIALS— fanalahidy JSON amin'ny kaonty serivisy (toy ny laha-daza JSON).GCP_TRANSLATE_API_KEY— na ny fanalahidy Google Cloud API.
Ny googleProjectId tsy azo atao dia tsoahina avy amin'ny fahazoan-dàlana rehefa tsy voafehy.
Ampidiro ny fizotran'ny asa
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: Manaova rakitra loharano loharano
Ny rakitra loharano dia mampiasa ny fivoriambe Name.<sourceLocale>.<ext>. Ohatra, Greetings.en.resx lasa Greetings.fr.resx, Greetings.de.resx, sy ny sisa aorian'ny hazakazaka.
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: Jereo ny vokatra
Raha vantany vao vita ny fizotran'ny asa, ny hetsika dia mampiseho vokatra telo azonao atao amin'ny famaritana PR: summary-title, summary-details, ary has-new-translations. Izy io koa dia manoratra famintinana Markdown ao amin'ny pejin'ny asa amin'ny alàlan'ny core.summary.