Sí Uppseting fyri YAML-skema og lastirøð.
Kravdar inntøkur
| Navn | Lýsing |
|---|---|
sourceLocale | Keldustaður (t.d. en), sum verður brúktur til at finna resursfílur sum **/*.en.resx. Eisini send víðari til Translator sum from=<locale>. |
subscriptionKey | Azure AI Translator subscription key. Far gjøgnum secrets. |
endpoint | Umsetaraendapunktur, t.d. https://api.cognitive.microsofttranslator.com/. |
Vanligar valfríar inntøkur
| Navn | Default | Lýsing |
|---|---|---|
region | Einki | Umsetara-tilfeingisøkið (ikki fyri globalar keldur). |
toLocales | øll stuðlað | Staðir at týða til. Tekur ímóti JSON-array (["fr","de"]) ella komma-separeraðum virðum. |
include | Einki | nýlínu-skildar glob-mynstur; bert samsvarandi fílur verða týddar. |
exclude | Einki | nýlínu-skildar glob-mynstur; Samsvarandi fílur verða lopnar (lagdar afturat Include). |
configPath | .github/resource-translator.yml | Leið til YAML config-fíluna (í mun til workspace-rótina). |
dryRun | false | Tá true, koyr umsetingar og send samandráttir, men skriva ikki fílur. |
failOnError | true | Tá ið true, miseydnast óvæntaðar villur í virkseminum; Tá false, eru villur ávaringar. |
Innleggingar til umsetarafyrispurningar
Hesar verða beinleiðis lagdar til Azure AI Translator v3 fyrispurningarparametrar. Øll eru valfrí; Translator-standardarnir gilda, tá teir ikki eru settir.
| Navn | Default | Lýsing |
|---|---|---|
categoryId | general | Azure Custom Translator kategori — vinnu-/domain-/tone-knøtturin. Sendur víðari sum ?category=.... |
textType | plain | plain ella html. Brúka html bara, tá tíni tilfeingisvirði eru verulig HTML-brot. |
profanityAction | NoAction | NoAction, Marked ella Deleted. Stýrir, hvussu grov orð verða brúkt í týðingum. |
profanityMarker | Asterisk | Asterisk ella Tag. Bert týdningarmikil, tá profanityAction er Marked. |
allowFallback | true (Týðari standard) | Tá false, gevur Translator eina villu í staðin fyri at fara aftur til almenna skipanina, um categoryId ikki hevur útbreiðslu til eitt málstað. |
apiVersion | 3.0 | Translator REST API útgáva. |
Seiglu- og plásshaldarvernd
Hesar inntøkur stýra, hvussu átakið uppførir seg, tá Translator minkar tína fyrispurning, og hvussu tað verjir plásshaldar-token sum {{name}} ella {0} frá at verða oyðiløgd undir umsetingini.
| Navn | Default | Lýsing |
|---|---|---|
maxRetries | 5 | Maksimum royndir við stuttvarandi HTTP-svarum (408, 425, 429, 500, 502, 503, 504). Tilsamans eru HTTP-kall pr. áheitan 1 + maxRetries. |
retryBackoffMs | 30000 | Takmark (í millisekundum) á hvørjum einstøkum backoff sleep. Gerðin virðir Azure's Retry-After svarhøvd júst tá tað er til staðar; Annars brúkar tað jitterað, eksponentiellt backoff, sum er avmarkað til hetta virðið. |
protectPlaceholders | true | Tá ið true (sjálvvirkandi), verða plásshaldarar sum {{name}}, ${var}, {0}, {0:N2}, %s, %1$s og HTML-eindir skiftar út við sentinel-token áðrenn umseting og endursettar aftaná. Sløkk bert tá keldan við vilja inniheldur bókstaviliga plásshaldar-líknandi tekst, sum eigur at verða týddur. |
customPlaceholderPatterns | Einki | Nýlínu-skildir regexar (uttan avmarkarar), lagdir afturat sjálvvalda plásshaldara-setinum, t.d. <<.+?>> til serstaka token-syntaks. |
noTranslatePatterns | Einki | Newline-sundurbýtt glob-mynstur, sum samsvara við parser-stigs lyklar (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). Samsvarandi lyklar verða tiknir burtur úr umsetarafyrispurninginum og sendir víðari við upprunavirðinum varðveittum. |
Úrtøkur
| Navn | Lýsing |
|---|---|
summary-title | Stutt PR-heitivinarlig samandráttur, t.d. Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Markdown-samandráttur, hóskandi til PR-kropp ella starvssamandrátt. |
has-new-translations | 'true' tá ein ella fleiri nýggjar týðingar vórðu gjørdar. |