aaqqiksimaninga · ikajuutinut tukiliuriji

qaangirlugu aqquti configPath iliuqqaqtaujumut pijariaqaruvit inigijaunngittumik.

aaqqiksuqsimaninga

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

silami qaujigiarviksaq

provider

qanuittuuninga: "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

qanuittuuninga: string

utirvigilugu sourceLocale iliuqqaqtaujuq aaqqiktausimanngippat. tunijaungmijuq tukiliurijimut from=<locale> naittukuluit qilalugait qaujijaukautigiqattajjaanngimmata.

toLocales

qanuittuuninga: string[]

naliangnituinnaq katiqsuqsimajumik uvvaluunniit virgukkut-aviksimajumik string-mik.

include / exclude

qanuittuuninga: string[]

Glob aaqqiksimaningit qaujisaqtaujut pillattaanut amma iqqanaijarvingnut−aktuanilingnut aqqutinut.

glossary

qanuittuuninga: map<string,string>

tukiliuqtauraaniksimaliqtillugu taigusiq qaangiqsijuq. uqausirnik−kigligijaujunik ujjirusungniq (C++, .NET).

categoryId

qanuittuuninga: string

Azure Custom Translator qanuittuuninga — pilirivvigijait/inigijait naqittarvinga (maligaqtigut, aanniaqtulirinirmut, niurrutiqarnirmut nipinga, asingillu). naksiujjaujuq ?category=....

textType

qanuittuuninga: "plain" | "html"

aaqqiksimavagiiqtuq plain. aturlugit html kisiani pitaqauqtut pimmariuningit iluliqaqpata HTML fragments-nik.

profanityAction

qanuittuuninga: "NoAction" | "Marked" | "Deleted"

qanuq kamagijaqarunnarmangaat piunngittunik uqausirnik tukiliuqtausimajuni.

profanityMarker

qanuittuuninga: "Asterisk" | "Tag"

tukiqattiaqtuq kisiani profanityAction "Marked".

allowFallback

qanuittuuninga: boolean

aaqqiglugu false kajusijunnailliluni tukiliuqtaujuq categoryId atuliqtittijunnanngitillugu turaarijaujumut inimut utinngingaarluni atuqtaugajuktumut.

apiVersion

qanuittuuninga: string

tukiliuriji REST API version. aaqqiksimavagiiqtuq 3.0.

awsFormality

qanuittuuninga: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

qanuittuuninga: boolean

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

awsTerminologyNames / awsParallelDataNames

qanuittuuninga: string[]

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

googleModel

qanuittuuninga: string

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

googleApiEndpoint

qanuittuuninga: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

qanuittuuninga: boolean

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

maxRetries

qanuittuuninga: integer

unulaakkut uuktukkannirasuktillugit HTTP−mut kiujjutaujut (408, 425, 429, 500, 502, 503, 504). aaqqiksimavagiiqtuq 5. katiłługit HTTP uqaluktut atuni tuksirautaujumut 1 + maxRetries.

retryBackoffMs

qanuittuuninga: integer

matulugu (ms) naliangnutuinnaq atausiarluni siningnirnut. aaqqiksimavagiiqtuq 30000. Azure's Retry-After niaqunga upigijauttiaqtuq taikaniitillugu; asiagulli jittered exponential backoff atuqtauvuq, isulittarviqaqtitaulluni taassumunga naasautimut.

protectPlaceholders

qanuittuuninga: boolean

aaqqiksimavagiiqtuq true. ikumagaangata, nalunaikkutait suurlu {{name}}, ${var}, {0}, {0:N2}, %s, %1$s amma HTML entities inangiqtausuunguvut sentinel tokens−nut tukiliuqtaulaunnginninginnik utiqtitauvakłutiglu kinguniagut. ajuliqtitauluni kisiani nakinngaarninga pijaariluni iluliqaqpat inangiijjutimik aaqqiksimanilingmik.

customPlaceholderPatterns

qanuittuuninga: string[]

qaakkanniagut regex-mut atuqtauvaktut (kigliqaqtittinngiłłutik) ilajaullutik inigijauvagiiqtunut aaqqiksimajunut, suurlu <<.+?>> atuqtauvaktunut nalunaikkutarnut atuqtauvaktunut. atunngittut regexes suqutigijaunngittut.

noTranslatePatterns

qanuittuuninga: string[]

Glob patterns ajjiqaqtitaujut parser-level keys-nut (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). ajjigiiktut kiingit piiqtausuut tuksirautaujumit aqqusaaqtaullutiglu nakinngaarningit papataullutik.

changeDetection

qanuittuuninga: "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

qanuittuuninga: string

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

usiliqsuinirmut tilisijjuti

taanna piliriangujuq uqalimaaqpakpuq tukisinattiaqtunik iliuqqaqtausimajunik piliriangujumit.
iliuqqaijuq YAML config configPath.
tamainnut amiqqaarutaujunut ininut, iliuqqaqtaujut saalaqaqput; taimainngippat YAML naasautinga atuqtauvuq.
katitausimajut qassiuningit nalunaiqtauvut. atuutiqanngittut enums (suurlu profanityAction: Mask) sukkalijumik ajuqtittisuut tukisinattiaqtumik tusaqtittijjutimik.

nipinga amma sanavvik, tukisinattiaqtukkut

Azure AI Translator v3 API atausirmit nipimut naqittautiqanngilaq. marruuk aaqqiksimajuuk katiłłutik ajjigiimik aulattijunnaqłutit:

sanavvik / kisulirijiuninga: aturlugit categoryId tikkuaqsinirmut Azure Custom Translator qanuittuuninga pilimmaksaqtaujuq nangminiq katiqsuqsimajarnut − maligaqtigut, pilirijjutinut, aanniaqtulirinirmut, niurrutiqarnirmut, qanutuinnarluunniit. taanna sanngilaanguvuq nipinganut, nipinganut, amma uqausirnut.
qaangagut titiraqsimajut: aturlugu uqausiit tukingit kiigutilugit niuviaksat atingit amma niuviaksat taigusingit titiraqsimattiarlugit, amma profanityAction piijarlugit piunngittut uqausiqtat turaarijaqaliraangata nunalingni makkuktunut naalaktinut.

uqausiq niruarlugu

iliuqqaiviup aaqqiksimaninga

aaqqiksuqsimaninga

silami qaujigiarviksaq

usiliqsuinirmut tilisijjuti

nipinga amma sanavvik, tukisinattiaqtukkut