🌐 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

For all inputs, repo config, glossary, tone/industry control, and recipes, see the full docs.

🔗 Project links

• 🔄 Changelog
• 🔐 Security policy
• 🤝 Contributing
• 📜 Code of conduct

✨ Contributors

Thanks goes to these wonderful people (emoji key):

vs-savelich 💻 ⚠️

Yevgen Nykytenko 🐛

Peter Rekdal Khan-Sunde 🐛

Tim Heuer 🐛 🤔 👀

Tibor Tompa 🤔

Matteo 💻 ⚠️

Jeffrey T. Fritz 📖

This project follows the all-contributors specification. Contributions of any kind welcome!