Рецептлар

Һәр йөгерүдән соң pull request ачыгыз

- 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: пакет буенча күләм тәрҗемәсе

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

Бренд исемнәре һәм продукт терминнары сүзлеге

Репозиториягә .github/resource-translator.yml төшерегез:

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

Глоссарий терминнары тәрҗемә аннан соң кулланыла, шуңа күрә машина тәрҗемәсе синоним белән алыштырган чакта да сезнең өстенлекле брендыгызны саклый.

Custom Translator категориясе (тармак/домен)

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

Azure Custom Translator категориясен тармак сүзлеге һәм тонын (юридик, медицина, маркетинг, эчке инженерия һ.б.) үз эченә алган корпуста өйрәтегез һәм аның идентификаторын categoryId аша тапшырыгыз. Бу Azure тәкъдим иткән иң көчле тон рычагы.

Тон контроле + катгый резерв

# .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

Махсус тәрҗемәче categoryId profanityAction һәм allowFallback: false белән берләштерегез.

Эш процессын кабындырыр алдыннан коры эшләтеп җибәрү

with:
  dryRun: true
  failOnError: false

Гамәл һаман да җыелма нәтиҗәләр һәм адымнар җыелмасын чыгара, әмма файллар язылмый. Һәр мәсьәләне кисәтү буларак failOnError: false белән берләштерегез.