Конфигурация · Ресурс тәржемәсеһе

Әгәр стандарт булмаған урын кәрәк булһа, configPath инпуты менән юлды алмаштырығыҙ.

Схема

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# Translator request shape — most users can ignore these.
textType: plain                  # plain | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: Asterisk        # Asterisk | Tag (only when profanityAction == Marked)

# Resilience — Translator returns 429 under load. Defaults are usually
# fine; tune only if your runs are large enough to hit them.
maxRetries: 5
retryBackoffMs: 30000             # cap on any single backoff sleep (ms)

# Placeholder protection. ON by default — wraps tokens like {{name}},
# {0}, %s, ${var} into sentinels before translation and restores them
# on the way back. Set false only when source intentionally contains
# placeholder-shaped literals.
protectPlaceholders: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # any extra token syntax you use

# Per-key opt-out. Keys matching any glob are dropped from the request
# and pass through with the source value preserved.
noTranslatePatterns:
  - "errors.code.*"
  - "brands.*"

Майҙансыҡ буйынса мәғлүмәт

provider

Төрө: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

sourceLocale

Төрө: string

Әгәр ҡуйылмаған булһа, sourceLocale инпутына кире ҡайта. Шулай уҡ Translator-ға from=<locale> итеп ебәрелде, ҡыҫҡа юлдар автоматик рәүештә танылмай.

toLocales

Төрө: string[]

Массив, йә үҫмер менән айырылған юл.

include / exclude

Төрө: string[]

Глоб үрнәктәре абсолют һәм эш урындарына ҡарата сағыштырмалы юлдар буйынса баһаланған.

glossary

Төрө: map<string,string>

Тәржемәнән һуң термин өҫтөнлөк биреү. Һүҙ сиктәрен аңлай (C++, .NET эшкәртеү).

categoryId

Төрө: string

Azure Custom Translator категорияһы — һеҙҙең тармаҡ/домен регуляторы (юридик, медицина, маркетинг тоны һ.б.). Ебәрелде ?category=....

textType

Төрө: "plain" | "html"

Стандарт рәүештә plain. Ресурс ҡиммәттәрендә ысын HTML фрагменттары булған осраҡта ғына html ҡулланығыҙ.

profanityAction

Төрө: "NoAction" | "Marked" | "Deleted"

Тәржемә ителгән сығарылышта әҙәпһеҙ һүҙҙәрҙе нисек эшкәртергә.

profanityMarker

Төрө: "Asterisk" | "Tag"

Мәғәнәле булғанда ғына profanityAction "Marked".

allowFallback

Төрө: boolean

false итеп ҡуйығыҙ, categoryId маҡсатлы урын өсөн деплоймент булмаһа, тәржемә уңышһыҙ булһын өсөн, дөйөм модельгә кире ҡайтырға кәрәк.

apiVersion

Төрө: string

Тәржемәсе REST API версияһы. Стандарт рәүештә 3.0.

awsFormality

Төрө: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

Төрө: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

Төрө: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

Төрө: string

Google Cloud Translation model, e.g. nmt or base.

googleApiEndpoint

Төрө: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Төрө: boolean

Optional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.

maxRetries

Төрө: integer

Транзиент HTTP яуаптары өсөн максималь ҡабаттан тырышыуҙар (408, 425, 429, 500, 502, 503, 504). Стандарт рәүештә 5. Бер һорауға дөйөм HTTP саҡырыуҙары 1 + maxRetries.

retryBackoffMs

Төрө: integer

Һәр бер артҡа йоҡо режимында сик (ms). Стандарт рәүештә 30000. Azure-ҙың Retry-After башы тап ошо ваҡытта хөрмәтләнә; башҡа осраҡта, был ҡиммәт менән сикләнгән джиттерлы экспоненциаль артҡа тартылыу ҡулланыла.

protectPlaceholders

Төрө: boolean

Стандарт рәүештә true. {{name}}, ${var}, {0}, {0:N2}, %s, %1$s һәм HTML объекттары кеүек токендар тәржемә алдынан сентинел токендары менән алмаштырыла һәм һуңынан тергеҙелә. Сығанаҡта махсус рәүештә ваҡытлы литералдар булғанда ғына һүндерегеҙ.

customPlaceholderPatterns

Төрө: string[]

Өҫтәмә regex паттерндары (делимитерһыҙ) стандарт placeholder set-ҡа өҫтәлде, мәҫәлән, <<.+?>> махсус токен синтаксисы өсөн. Дөрөҫ булмаған регекстар иҫәпкә алынмай.

noTranslatePatterns

Төрө: string[]

Глоб үрнәктәре парсер кимәлендәге асҡыстарға (JSON нөктәле юл, RESX name, PO msgid, XLIFF берәмеге id, INI/restext асҡысы) тап килде. Тап килгән асҡыстар һорауҙан төшөрөлә һәм сығанаҡ ҡиммәте һаҡланып үтә.

changeDetection

Төрө: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

Төрө: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

Йөкләү тәртибе

Хәрәкәт эш ағымынан асыҡ мәғлүмәттәрҙе уҡый.
Ул YAML конфигурацияһын configPath йөкләй.
Һәр уртаҡ ҡыр өсөн инпут еңә; башҡа осраҡта YAML ҡиммәте ҡулланыла.
Берләштерелгән ҡиммәттәр раҫлана. Дөрөҫ булмаған enum-дар (мәҫәлән, profanityAction: Mask) асыҡ хәбәр менән эште тиҙ тамамлауға килтерә.

Тон һәм индустрия, ябай итеп әйткәндә

Azure AI Translator v3 API-һында бер генә тон төймәһе юҡ. Ике көйләү бергәләп күпселек бер үк контролде бирә:

Сәнәғәт / өлкә: categoryId ҡулланып, үҙегеҙҙең корпуста өйрәнелгән Azure Custom Translator категорияһына — юридика, техник, медицина, маркетинг йәки башҡа нәмәләргә — күрһәтегеҙ. Был тон, бренд тауышы һәм һүҙлек байлығы өсөн иң көслө рычаг.
Өҫкө текст: Глоссарий ҡулланығыҙ — бренд исемдәрен һәм продукт терминдарын һүҙмә-һүҙ бикләгеҙ, ә profanityAction ҡулланығыҙ, йәш аудиторияға локализацияны маҡсат итеп алғанда ялған һүҙҙәрҙе бөтөрөү өсөн.

Телеңде һайла

Репозиторий конфигурацияһы

Схема

Майҙансыҡ буйынса мәғлүмәт

Йөкләү тәртибе

Тон һәм индустрия, ябай итеп әйткәндә