qaangirlugu aqquti configPath iliuqqaqtaujumut pijariaqaruvit inigijaunngittumik.
aaqqiksuqsimaninga
# .github/resource-translator.ymlsourceLocale: entoLocales: - fr - de - esinclude: - "src/**/*.en.json" - "apps/**/*.en.resx"exclude: - "**/__tests__/**"glossary: Acme: Contoso Octocat: Octocat # keep brand names verbatim
# Domain / industry — uses an Azure Custom Translator category trained on# your tone and vocabulary. Leave unset for the general model.categoryId: my-custom-translator-category
# Translator request shape — most users can ignore these.textType: plain # plain | htmlprofanityAction: NoAction # NoAction | Marked | DeletedprofanityMarker: Asterisk # Asterisk | Tag (only when profanityAction == Marked)allowFallback: true # false fails when the categoryId has no deployment
apiVersion: "3.0"
# Resilience — Translator returns 429 under load. Defaults are usually# fine; tune only if your runs are large enough to hit them.maxRetries: 5retryBackoffMs: 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: truecustomPlaceholderPatterns: - "<<.+?>>" # 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
| silami | qanuittuuninga | ujjirijarialit |
|---|---|---|
sourceLocale | string | utirvigilugu sourceLocale iliuqqaqtaujuq aaqqiktausimanngippat. tunijaungmijuq tukiliurijimut from=<locale> naittukuluit qilalugait qaujijaukautigiqattajjaanngimmata. |
toLocales | string[] | naliangnituinnaq katiqsuqsimajumik uvvaluunniit virgukkut-aviksimajumik string-mik. |
include / exclude | string[] | Glob aaqqiksimaningit qaujisaqtaujut pillattaanut amma iqqanaijarvingnut−aktuanilingnut aqqutinut. |
glossary | map<string,string> | tukiliuqtauraaniksimaliqtillugu taigusiq qaangiqsijuq. uqausirnik−kigligijaujunik ujjirusungniq (C++, .NET). |
categoryId | string | Azure Custom Translator qanuittuuninga — pilirivvigijait/inigijait naqittarvinga (maligaqtigut, aanniaqtulirinirmut, niurrutiqarnirmut nipinga, asingillu). naksiujjaujuq ?category=.... |
textType | "plain" | "html" | aaqqiksimavagiiqtuq plain. aturlugit html kisiani pitaqauqtut pimmariuningit iluliqaqpata HTML fragments-nik. |
profanityAction | "NoAction" | "Marked" | "Deleted" | qanuq kamagijaqarunnarmangaat piunngittunik uqausirnik tukiliuqtausimajuni. |
profanityMarker | "Asterisk" | "Tag" | tukiqattiaqtuq kisiani profanityAction "Marked". |
allowFallback | boolean | aaqqiglugu false kajusijunnailliluni tukiliuqtaujuq categoryId atuliqtittijunnanngitillugu turaarijaujumut inimut utinngingaarluni atuqtaugajuktumut. |
apiVersion | string | tukiliuriji REST API version. aaqqiksimavagiiqtuq 3.0. |
maxRetries | integer | unulaakkut uuktukkannirasuktillugit HTTP−mut kiujjutaujut (408, 425, 429, 500, 502, 503, 504). aaqqiksimavagiiqtuq 5. katiłługit HTTP uqaluktut atuni tuksirautaujumut 1 + maxRetries. |
retryBackoffMs | integer | matulugu (ms) naliangnutuinnaq atausiarluni siningnirnut. aaqqiksimavagiiqtuq 30000. Azure's Retry-After niaqunga upigijauttiaqtuq taikaniitillugu; asiagulli jittered exponential backoff atuqtauvuq, isulittarviqaqtitaulluni taassumunga naasautimut. |
protectPlaceholders | 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 | string[] | qaakkanniagut regex-mut atuqtauvaktut (kigliqaqtittinngiłłutik) ilajaullutik inigijauvagiiqtunut aaqqiksimajunut, suurlu <<.+?>> atuqtauvaktunut nalunaikkutarnut atuqtauvaktunut. atunngittut regexes suqutigijaunngittut. |
noTranslatePatterns | 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. |
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
categoryIdtikkuaqsinirmut 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
profanityActionpiijarlugit piunngittut uqausiqtat turaarijaqaliraangata nunalingni makkuktunut naalaktinut.