Source
One source key changes
Smart detection isolates the delta before any provider call.
ꯅꯍꯥꯛꯀꯤ ꯔꯦꯄꯣ ꯑꯗꯨ ꯂꯣꯀꯦꯂꯥꯏꯖ ꯇꯧ ꯀꯃꯤꯠ ꯈꯨꯗꯤꯡꯃꯛ꯫
ꯑꯔꯣꯟꯕ ꯑꯍꯨꯝ, ꯄꯔꯦꯡ ꯃꯔꯤ, ꯑꯃꯁꯨꯡ ꯅꯍꯥꯛꯀꯤ ꯔꯦꯄꯣ ꯑꯁꯤ ꯃꯊꯪꯒꯤ ꯄꯨꯁꯇ ꯂꯣꯟ ꯀꯌꯥ ꯌꯥꯎꯋꯤ꯫
ꯁꯄꯣꯔꯠꯁꯤꯡ
꯰ ꯑꯦꯟ.ꯄꯤ.ꯑꯦꯝ.-ꯑꯣꯗꯤꯠꯀꯤ ꯋꯥꯐꯝꯁꯤꯡ
꯲꯴꯰+ ꯆꯥꯡꯌꯦꯡ
Azure, AWS, ꯒꯨꯒꯜꯅꯣꯗ ꯲꯰ / ꯲꯲ / ꯲꯴
ꯊꯥꯗꯣꯛ-ꯊꯥꯖꯤꯟꯒꯤꯗꯃꯛ ꯁꯥꯈꯤꯕꯅꯤ
ꯍꯟꯗꯣꯛꯄ ꯑꯁꯤ ꯊꯕꯛ ꯑꯃ ꯑꯣꯏꯅ ꯅꯠꯇꯦ ꯫
ꯑꯦꯛꯁꯟ ꯑꯗꯨ ꯅꯍꯥꯛꯀꯤ ꯍꯧꯖꯤꯛ ꯂꯩꯔꯤꯕ ꯁꯤꯑꯥꯏ ꯑꯗꯨꯗ ꯊꯥꯗꯣꯛꯄꯤꯌꯨ, ꯃꯗꯨ ꯑꯦꯓꯨꯔ, ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ ꯅꯠꯇ꯭ꯔꯒ ꯒꯨꯒꯜꯗ ꯇꯥꯛꯄꯤꯌꯨ ꯑꯃꯁꯨꯡ ꯅꯍꯥꯛꯀꯤ ꯔꯦꯄꯣ ꯑꯗꯨꯅ ꯅꯍꯥꯛꯅ ꯄꯥꯟꯗꯝ ꯊꯝꯂꯤꯕ ꯂꯣꯜ ꯈꯨꯗꯤꯡꯃꯛ ꯉꯥꯡꯍꯜꯂꯨ꯫
Default in v3.2
Smart change detection
A compact .github/resource-translator-state.json tracks parser keys, source hashes, and translation-affecting settings. The action skips stable keys, preserves manual target edits, and logs every decision with rule codes. Use snapshotOnly to bootstrap existing translations without a provider call.
Most runs translate only the changed keys
ꯐꯥꯏꯜ ꯐꯣꯔꯃꯦꯠ ꯇꯔꯨꯛ
ꯔꯥꯎꯟꯗ-ꯇ꯭ꯔꯤꯞꯁꯤꯡ .resx, .xliff, .po, .json, .ini, ꯑꯃꯁꯨꯡ .restext ꯕꯥꯏꯠ-ꯁ꯭ꯇꯦꯕꯜ ꯐꯣꯔꯃꯦꯇꯤꯡꯒ ꯂꯣꯏꯅꯅ ꯫
Repo-level config
ꯒ꯭ꯂꯣꯕꯁꯤꯡ, ꯒ꯭ꯂꯣꯁꯔꯤꯁꯤꯡ, ꯑꯃꯁꯨꯡ ꯀꯁꯇꯝ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔ ꯀꯦꯇꯦꯒꯔꯤꯁꯤꯡ ꯌꯥꯎꯍꯟꯅꯕꯒꯤꯗꯃꯛ .github/resource-translator.yml ꯐꯥꯏꯜ ꯑꯃ ꯊꯥꯗꯣꯛꯄꯤꯌꯨ꯫
Glossary-aware
ꯕ꯭ꯔꯥꯟꯗ ꯃꯃꯤꯡꯁꯤꯡ ꯑꯃꯁꯨꯡ ꯄꯣꯠꯊꯣꯛꯀꯤ ꯋꯥꯍꯩꯁꯤꯡ ꯑꯗꯨ C++, .NET ꯑꯃꯁꯨꯡ ꯃꯔꯨꯞꯁꯤꯡ ꯁꯦꯟꯅꯕ ꯁ꯭ꯃꯥꯔꯠ ꯋꯥꯔꯗ-ꯕꯥꯎꯟꯗꯔꯤ ꯔꯦꯖꯦꯛꯁꯀ ꯂꯣꯛ ꯇꯧ꯫
ꯗ꯭ꯔꯥꯏ-ꯔꯟ + ꯁꯣꯐ꯭ꯠ-ꯐꯦꯜ
ꯐꯥꯏꯜꯁꯤꯡ ꯏꯗꯅ ꯍꯟꯗꯣꯛꯄꯁꯤꯡ ꯄ꯭ꯔꯤꯚꯤꯌꯨ ꯇꯧ, ꯅꯠꯇ꯭ꯔꯒ ꯅꯍꯥꯛꯅ ꯍꯟꯖꯤꯟꯕ ꯃꯇꯝꯗ ꯆꯦꯛꯁꯤꯟꯋꯥ ꯑꯃ ꯑꯣꯏꯅ ꯑꯁꯣꯏꯕ ꯈꯨꯗꯤꯡꯃꯛ ꯎꯠꯊꯣꯛꯎ꯫
ꯄꯤ.ꯑꯥꯔ.-ꯅꯨꯉꯥꯏꯕ ꯑꯥꯎꯠꯄꯨꯠꯁꯤꯡ
summary-title, summary-details, ꯑꯃꯁꯨꯡ has-new-translations ꯍꯛꯊꯦꯡꯅꯅ ꯀ꯭ꯔꯤꯌꯦꯠ-ꯄꯨꯜ-ꯔꯤꯀ꯭ꯋꯦꯁꯠꯇ ꯁ꯭ꯂꯣꯠ ꯇꯧꯋꯤ꯫
ꯑꯦꯓꯨꯔ, ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ ꯑꯃꯁꯨꯡ ꯒꯨꯒꯜ
ꯆꯦꯟꯕ ꯑꯃꯗ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃ ꯈꯜꯂꯨ꯫ ꯈꯨꯗꯤꯡꯃꯛ ꯑꯁꯤ ꯃꯁꯤꯒꯤ ꯑꯣꯐꯤꯁꯤꯑꯦꯜ ꯑꯦꯁ.ꯗꯤ.ꯀꯦ. (@azure-rest/ai-translation-text, @aws-sdk/client-translate, @google-cloud/translate) ꯅ 408/429/5xx ꯃꯇꯣꯝꯇ ꯑꯃꯨꯛ ꯍꯟꯅ ꯍꯣꯠꯅꯕꯒ ꯂꯣꯏꯅꯅ ꯊꯧꯏ - ꯈꯨꯠꯅ ꯔꯣꯜ ꯇꯧꯕ HTTP ꯂꯩꯇꯦ꯫ esbuild-ꯄꯨꯟꯁꯤꯟꯕ, ꯍꯤꯁꯥꯕ ꯌꯦꯡꯁꯤꯟꯕ-ꯁꯦꯡꯕ꯫
ꯀꯣꯄꯤ. ꯄꯦꯁ꯭ꯠ. ꯋꯥꯍꯟꯊꯣꯛ ꯍꯟꯕ.
ꯔꯤꯁꯣꯔꯁ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔꯅ ꯑꯦꯓꯨꯔ, ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ ꯅꯠꯇ꯭ꯔꯒ ꯒꯨꯒꯜ ꯁꯤꯖꯤꯟꯅꯗꯨꯅ ꯅꯍꯥꯛꯀꯤ ꯔꯤꯁꯣꯔꯁ ꯐꯥꯏꯜꯁꯤꯡꯒꯤꯗꯃꯛ ꯃꯦꯁꯤꯟꯅ ꯍꯟꯗꯣꯛꯄ ꯄꯨꯜ ꯔꯤꯀ꯭ꯋꯦꯁꯠꯁꯤꯡ ꯍꯥꯡꯗꯣꯛꯏ - ꯌꯨꯅꯤꯐꯥꯏꯗ ꯑꯦꯛꯁꯟ ꯑꯃ, ꯆꯦꯟ ꯑꯃꯗ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃ, ꯍꯨꯗ ꯃꯈꯥꯗ ꯑꯣꯐꯤꯁꯤꯌꯦꯜ ꯑꯦꯁ.ꯗꯤ.ꯀꯦ.
ꯍꯧꯔꯛꯎname: translateon: push: 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 provider: | azure: subscriptionKey: ${{ secrets.KEY }} endpoint: ${{ secrets.ENDPOINT }} region: ${{ secrets.REGION }} toLocales: '["fr","de","es","ja"]'
- uses: peter-evans/create-pull-request@v7 with: title: Update translationsꯑꯣꯇꯣꯄꯥꯏꯂꯣꯠꯇ ꯂꯣꯀꯦꯂꯥꯏꯖ ꯇꯧꯅꯕ ꯁꯦꯝ ꯁꯥꯔꯕꯔꯥ?
ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯀꯤ ꯑꯃ - ꯑꯦꯓꯨꯔ, ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ, ꯅꯠꯇ꯭ꯔꯒ ꯒꯨꯒꯜ - ꯑꯃꯁꯨꯡ ꯋꯥꯔ꯭ꯛꯐ꯭ꯂꯣ ꯐꯥꯏꯜ ꯑꯃꯥ꯫ ꯔꯤꯁꯣꯔꯁ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔꯅ ꯂꯦꯝꯍꯧꯕꯁꯤꯡ ꯌꯦꯡꯁꯤꯜꯂꯤ꯫