Inputs u outputs · Traduttur tar-Riżorsi

Ara Konfigurazzjoni għall-iskema YAML u l-ordni tat-tagħbija.

Inputs meħtieġa

Inputs meħtieġa
Isem	Deskrizzjoni
`sourceLocale`	Il-lokalità tas-sors (eż. `en`) użata biex issib fajls ta' riżorsi bħal `*/.en.resx`. Intbagħat ukoll lit-Traduttur bħala `from=<locale>`.
`subscriptionKey`	Ċavetta ta' abbonament Azure AI Translator. Għaddi minn `secrets`.
`endpoint`	URL tal-endpoint tat-traduttur, eż. `https://api.cognitive.microsofttranslator.com/`.

Inputs fakultattivi komuni

Inputs fakultattivi komuni
Isem	Default	Deskrizzjoni
`region`	xejn	Reġjun tar-riżorsi tat-traduttur (mhux meħtieġ għal riżorsi globali).
`toLocales`	kollha appoġġjati	Postijiet fejn tista' tittraduċi. Jaċċetta array JSON (`["fr","de"]`) jew valuri separati minn koma.
`include`	xejn	mudelli ta' globi separati minn newline; huma tradotti biss fajls li jaqblu.
`exclude`	xejn	mudelli ta' globi separati minn newline; fajls li jaqblu jiġu mħassra (applikati wara l-inklużjoni).
`configPath`	`.github/resource-translator.yml`	Triq għall-fajl ta' konfigurazzjoni YAML (relattivament għar-root tax-xogħol).
`dryRun`	`false`	Meta `true`, agħmel traduzzjonijiet u ħareġ sommarji iżda ma tiktibx fajls.
`failOnError`	`true`	Meta `true`, żbalji mhux mistennija jfallu mill-azzjoni; Meta `false`, l-iżbalji huma twissijiet.

Inputs tat-talba tat-traduttur

Dawn jimparaw direttament mal-parametri ta' mistoqsija ta' Azure AI Translator v3. Kull waħda minnhom hija fakultattiva; it-Traduttur default japplika meta jkun mhux issettjat.

Inputs tat-talba tat-traduttur
Isem	Default	Deskrizzjoni
`categoryId`	general	Azure Custom Translator category — il-knob industry/domain/ton. Mibgħuta bħala `?category=...`.
`textType`	`plain`	`plain` jew `html`. Uża `html` biss meta l-valuri tar-riżorsi tiegħek ikunu frammenti HTML veri.
`profanityAction`	`NoAction`	`NoAction`, `Marked`, jew `Deleted`. Jikkontrolla kif it-termini profani jiġu emessi fit-traduzzjonijiet.
`profanityMarker`	`Asterisk`	`Asterisk` jew `Tag`. Sens biss meta `profanityAction` tkun `Marked`.
`allowFallback`	true (Traduttur default)	Meta `false`, it-Traduttur jirritorna żball minflok jerġa' jidħol fis-sistema ġenerali jekk il-`categoryId` tiegħek m'għandux implimentazzjoni għal post fil-mira.
`apiVersion`	`3.0`	Verżjoni tal-API REST tat-traduttur.

Reżiljenza u protezzjoni temporanja

Dawn l-inputs jikkontrollaw kif l-azzjoni taġixxi meta Translator jnaqqas it-talba tiegħek u kif jipproteġi tokens temporanji bħal {{name}} jew {0} milli jiġu mħassra waqt it-traduzzjoni.

Reżiljenza u inputs ta' protezzjoni temporanja
Isem	Default	Deskrizzjoni
`maxRetries`	`5`	Tentattivi massimi ta' retry fuq risposti HTTP transitorji (`408, 425, 429, 500, 502, 503, 504`). In-numru totali ta' sejħiet HTTP għal kull talba huwa `1 + maxRetries`.
`retryBackoffMs`	`30000`	Il-limitu (fi millisekondi) fuq kwalunkwe rqad wieħed li jħalli l-backoff. L-azzjoni tirrispetta l-intestatura ta' rispons `Retry-After` ta' Azure eżatt meta tkun preżenti; inkella juża jittered exponential backoff limitat għal dan il-valur.
`protectPlaceholders`	`true`	Meta `true` (default), placeholders bħal `{{name}}`, `${var}`, `{0}`, `{0:N2}`, `%s`, `%1$s` u entitajiet HTML jiġu sostitwiti b'tokens sentinel qabel it-traduzzjoni u restawrati wara. Iddiżattivaw biss meta s-sors tiegħek intenzjonalment fih test letterali f'forma ta' placeholder li għandu jittraduċi.
`customPlaceholderPatterns`	xejn	Regexes separati mill-linji ġodda (mingħajr delimitaturi) miżjuda mas-sett default, eż. `<<.+?>>` għal sintassi personalizzata tat-token.
`noTranslatePatterns`	xejn	Mudelli glob separati minn newline kienu jikkorrispondu ma' ċwievet ta' livell ta' parser (JSON doted path, RESX `name`, PO `msgid`, unità XLIFF `id`, ċavetta INI/restext). Ċwievet li jaqblu jitneħħew mit-talba tat-Traduttur u jgħaddu permezz tal-valur sors tagħhom ippreservat.

Outputs

Outputs
Isem	Deskrizzjoni
`summary-title`	Sommarju qasir adattat għall-PR, eż. Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	Sommarju tal-markdown adattat għal korp ta' PR jew sommarju ta' xogħol.
`has-new-translations`	`'true'` meta ġew ġġenerati traduzzjonijiet ġodda jew aktar.