Step 1: Scegli un fornitore di traduzioni
L'azione funziona con Azure AI Translator, AWS Translate e Traduzione Google Cloud dietro un'unica superficie API unificata. Scegli un singolo provider per ogni esecuzione con l'input provider — il flusso di lavoro si comporta allo stesso modo indipendentemente dal provider; Solo le credenziali differiscono. Vedi Fornitori di traduzione per un confronto completo.
Step 2: Aggiungi credenziali e un flusso di lavoro
Memorizza le credenziali del tuo provider come segreti del repository GitHub, poi crea .github/workflows/translate.yml. Seleziona il tuo fornitore qui sotto per la sua configurazione specifica — il resto del flusso di lavoro è identico.
Azure AI Translator
Azure è il provider predefinito, quindi provider potrebbero essere omessi. Fornisci una risorsa Azure AI Translator nel portale Azure, poi memorizza le sue credenziali:
Memorizza questi come segreti di repository
TRANSLATOR_KEY— La chiave di abbonamento per la risorsa.TRANSLATOR_ENDPOINT— l'URL regionale dell'endpoint.TRANSLATOR_REGION— la regione Azure della risorsa.
Aggiungi il flusso di lavoro
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
Imposta provider su aws. Preferisci l'OIDC tramite aws-actions/configure-aws-credentials così non vengono memorizzati segreti duraturi — le esportazioni a passo AWS_REGION per te. Per usare invece tasti statiche, memorizza:
Memorizza questi come segreti di repository
AWS_ACCESS_KEY_ID— il tuo ID chiave di accesso AWS.AWS_SECRET_ACCESS_KEY— la tua chiave di accesso segreta AWS.
Una regione è sempre necessaria — impostala con awsRegion o con la variabile di ambiente AWS_REGION.
Aggiungi il flusso di lavoro
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-translationTraduzione Google Cloud
Imposta provider su google. Autentica con una credenziale JSON dell'account di servizio o con una chiave API — forniscine esattamente una:
Memorizza questi come segreti di repository
GCP_TRANSLATE_CREDENTIALS— una chiave JSON di account di servizio (come stringa JSON).GCP_TRANSLATE_API_KEY— oppure una chiave API di Google Cloud.
Dal titolo viene dedotto un googleProjectId opzionale quando viene omesso.
Aggiungi il flusso di lavoro
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: Commit di un file di risorsa sorgente
I file di risorse utilizzano la convenzione Name.<sourceLocale>.<ext>. Ad esempio, Greetings.en.resx diventa Greetings.fr.resx, Greetings.de.resx e così via dopo una partita.
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: Ispezionare l'output
Una volta terminato il flusso di lavoro, l'azione espone tre output che puoi collegare in una descrizione PR: summary-title, summary-details e has-new-translations. Scrive anche un riassunto Markdown nella pagina delle offerte tramite core.summary.