Machine Translator

🌐 Resource Translator

A GitHub Action that opens machine-translated pull requests for resource files in your repository, powered by Azure AI Translator via Microsoft's official @azure-rest/ai-translation-text SDK — built-in retry/throttling, no hand-rolled HTTP clients.

Supported formats: .resx, .xliff, .po, .json, .ini, .restext.

📚 Documentation

Everything lives on the docs site: ievangelist.github.io/resource-translator

📘 Getting started
⚙️ Configuration — repo config, glossary, tone & industry
🧾 Inputs & outputs
📑 File formats
🍳 Recipes
❓ FAQ

🚀 Quick start

name: translate

on:
  push:
    branches: [main]
    paths:
      - "**/*.en.resx"
      - "**/*.en.json"

permissions:
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          sourceLocale: en
          subscriptionKey: ${{ secrets.AZURE_TRANSLATOR_SUBSCRIPTION_KEY }}
          endpoint: ${{ secrets.AZURE_TRANSLATOR_ENDPOINT }}
          region: ${{ secrets.AZURE_TRANSLATOR_REGION }}
          toLocales: '["es","fr","de"]'

      - if: steps.translator.outputs.has-new-translations == 'true'
        uses: peter-evans/create-pull-request@v7
        with:
          branch: machine-translation
          title: ${{ steps.translator.outputs.summary-title }}
          body: ${{ steps.translator.outputs.summary-details }}
          labels: localization