Ibifungurwa

Fungura urupapuro rw'umutsindo inyuma ya buri rukino

- id: translate
  uses: IEvangelist/resource-translator@v3
  with:
    sourceLocale: en
    subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
    endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
    region: ${{ secrets.TRANSLATOR_REGION }}

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

Monorepos: scope translation per package

with:
  sourceLocale: en
  include: |
    apps/web/**/*.en.resx
    packages/shared/**/*.en.json
  exclude: |
    **/dist/**
    **/__tests__/**

Glossary for brand names and product terms

Shira .github/resource-translator.yml muri repo:

glossary:
  Acme: Contoso
  Octocat: Octocat
  ".NET": ".NET"
  "C++": "C++"

Amajambo y'imvugo akoreshwa Inyuma guhindura, gutyo imashini ihindurwa n'imashini iguma igumana ikirango ukunda n'igihe igishushanyo cahinduwe n'insiguro y'insigarirazina.

Custom Translator category (industry / domain)

with:
  sourceLocale: en
  subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
  endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
  categoryId: 1234abcd-5678-90ef-...

Menyereza umugwi wa Azure Custom Translator kuri corpus ifata imvugo n'imvugo y'uruganda rwawe (amategeko, ubuvuzi, kwamamaza, ubuhinga bw'imbere mu gihugu, n'ibindi) hanyuma uce utanga ID yayo ukoresheje categoryId. This is the strongest tone lever Azure offers.

Tone control + strict fallback

# .github/resource-translator.yml
# Industry / domain — choose your tone via a Custom Translator category
categoryId: legal-en

# Treat profanity strictly for content aimed at younger audiences
profanityAction: Marked
profanityMarker: Tag

# Fail the run rather than silently fall back to the general model
allowFallback: false

Combine a Custom Translator categoryId with profanityAction and allowFallback: false to enforce a consistent voice and fail the workflow if the selected category does not have a deployment for one of your target locales.

Suzumiya Haruka

with:
  dryRun: true
  failOnError: false

The action still emits summary outputs and a step summary, but no files are written. Huza na failOnError: false kugira ngo ugaragaze ikibazo cose nk'ingabisho mu gihe uriko urasubiramwo.