Pembejeo na matokeo · Mtafsiri wa Rasilimali

Tazama Usanidi kwa schema ya YAML na mpangilio wa kupakia.

Pembejeo zinazohitajika

Pembejeo zinazohitajika
Jina	Maelezo
`sourceLocale`	Eneo la chanzo (k.m. `en`) linalotumika kupata faili za rasilimali kama vile `*/.en.resx`. Pia imetumwa kwa Mtafsiri kama `from=<locale>`.
`subscriptionKey`	Ufunguo wa usajili wa Azure AI Translator. Pita kupitia `secrets`.
`endpoint`	URL ya mwisho ya mtafsiri, kwa mfano `https://api.cognitive.microsofttranslator.com/`.

Pembejeo za hiari za kawaida

Pembejeo za hiari za kawaida
Jina	Chaguo-msingi	Maelezo
`region`	hakuna	Eneo la rasilimali za mtafsiri (acha kwa rasilimali za ulimwengu).
`toLocales`	zote zinaungwa mkono	Maeneo ya kutafsiri. Inakubali safu ya JSON (`["fr","de"]`) au maadili yaliyotenganishwa kwa koma.
`include`	hakuna	Mifumo ya glob iliyotenganishwa na mstari mpya; faili zinazolingana tu ndizo zinazotafsiriwa.
`exclude`	hakuna	Mifumo ya glob iliyotenganishwa na mstari mpya; faili zinazolingana zinarukwa (zinatumika baada ya kujumuisha).
`configPath`	`.github/resource-translator.yml`	Njia ya faili ya usanidi wa YAML (inayohusiana na mzizi wa nafasi ya kazi).
`dryRun`	`false`	Wakati `true`, endesha tafsiri na utoe muhtasari lakini usiandike faili.
`failOnError`	`true`	Wakati `true`, makosa yasiyotarajiwa yanashindwa kitendo; wakati `false`, makosa ni maonyo.

Pembejeo za ombi la mtafsiri

Hizi ramani moja kwa moja kwenye vigezo vya hoja vya Azure AI Translator v3. Kila moja ni hiari; chaguo-msingi za Mtafsiri zinatumika wakati hazijawekwa.

Pembejeo za ombi la mtafsiri
Jina	Chaguo-msingi	Maelezo
`categoryId`	general	Kitengo cha Custom Translator cha Azure - kisu cha tasnia/kikoa/toni. Imesambazwa kama `?category=...`.
`textType`	`plain`	`plain` au `html`. Tumia `html` tu wakati maadili yako ya rasilimali ni vipande halisi vya HTML.
`profanityAction`	`NoAction`	`NoAction`, `Marked`, au `Deleted`. Inadhibiti jinsi maneno machafu yanavyotolewa katika tafsiri.
`profanityMarker`	`Asterisk`	`Asterisk` au `Tag`. Maana tu wakati `profanityAction` ni `Marked`.
`allowFallback`	kweli (Mtafsiri chaguo-msingi)	Wakati `false`, Mtafsiri hurudisha hitilafu badala ya kurudi kwenye mfumo wa jumla ikiwa `categoryId` yako haina kupelekwa kwa eneo lengwa.
`apiVersion`	`3.0`	Toleo la API la REST la Mtafsiri.

Ustahimilivu na ulinzi wa kishikilia nafasi

Pembejeo hizi hudhibiti jinsi kitendo kinavyofanya wakati Mtafsiri anapunguza ombi lako na jinsi inavyolinda tokeni za kishika nafasi kama vile {{name}} au {0} dhidi ya kuharibika wakati wa tafsiri.

Ustahimilivu na pembejeo za ulinzi wa kishika nafasi
Jina	Chaguo-msingi	Maelezo
`maxRetries`	`5`	Upeo wa majaribio ya kujaribu tena majibu ya muda mfupi ya HTTP (`408, 425, 429, 500, 502, 503, 504`). Jumla ya simu za HTTP kwa kila ombi ni `1 + maxRetries`.
`retryBackoffMs`	`30000`	Kofia (kwa milliseconds) kwenye usingizi wowote wa kurudi nyuma. Kitendo hicho kinaheshimu kichwa cha majibu ya `Retry-After` cha Azure haswa wakati kipo; vinginevyo hutumia backoff ya kielelezo iliyowekwa kwa thamani hii.
`protectPlaceholders`	`true`	Wakati `true` (chaguo-msingi), vishika nafasi kama vile `{{name}}`, `${var}`, `{0}`, `{0:N2}`, `%s`, `%1$s` na HTML hubadilishwa na tokeni za sentinel kabla ya kutafsiriwa na kurejeshwa baadaye. Zima tu wakati chanzo chako kimakusudi kina maandishi halisi yenye umbo la kishika nafasi ambayo yanapaswa kutafsiriwa.
`customPlaceholderPatterns`	hakuna	Regexes zilizotenganishwa na mstari mpya (bila mipaka) zimeongezwa kwenye seti chaguomsingi ya kishika nafasi, kwa mfano `<<.+?>>` kwa sintaksia maalum ya tokeni.
`noTranslatePatterns`	hakuna	Mifumo ya glob iliyotenganishwa na mstari mpya inayolingana na funguo za kiwango cha kichanganuzi (njia ya nukta ya JSON, RESX `name`, PO `msgid`, kitengo cha XLIFF `id`, kitufe cha INI/restext). Vifunguo vinavyolingana huondolewa kutoka kwa ombi la Mtafsiri na kupita na thamani yao ya chanzo imehifadhiwa.

Matokeo

Matokeo
Jina	Maelezo
`summary-title`	Muhtasari mfupi wa kichwa cha PR, kwa mfano Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	Muhtasari wa Markdown unafaa kwa mwili wa PR au muhtasari wa kazi.
`has-new-translations`	`'true'` wakati tafsiri moja au zaidi mpya ilitolewa.