Recipes

Funa ekiragiro eky'okuggya ekkomo ku buli luvannyuma lw'okudduka

- 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

Drop a .github/resource-translator.yml into the repo:

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

Ebigambo ebivvuunulwa bikozesebwa Oluvannyuma lw' kuvvuunula, n'olwekyo ekivaamu ekivvuunulwa mu mashine kikuuma akabonero k'oyagala ne bw'oba ng'ekifaananyi kikyusiddwa.

Custom Translator category (industry / domain)

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

Tendeka ekitongole kya Azure Custom Translator ku corpus ekwata ebigambo by'ekitongole kyo (amateeka, eby'obujjanjabi, eby'obusuubuzi, n'ebirala) era oyise ID yakyo okuyita mu 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 chosen category does not have a deployment for one of your target locales.

Okuwummula nga tonnaba kukyusa mirimu gya Ssekabaka Muteesa II

with:
  dryRun: true
  failOnError: false

Ekikolwa kino kikyafulumya ebivaamu mu bufunze n'ekifaananyi eky'omutendera, naye tewali fayiro ewandiikiddwa. Combine with failOnError: false to surface every issue as a warning while you iterate.