كىرگۈزۈش ۋە چىقىرىش · مەنبە تەرجىمانى

YAML خەرىتىسى ۋە قاچىلاش تەرتىپى ئۈچۈن سەپلىمە قاراڭ.

زۆرۈر كىرگۈزۈش

زۆرۈر كىرگۈزۈش
نامى	چۈشەندۈرۈش
`sourceLocale`	مەنبە ئورنى (مەسىلەن: `en`) مەنبە ھۆججىتىنى تېپىشتا ئىشلىتىلىدۇ `*/.en.resx`. يەنە تەرجىمانغا ئەۋەتىپ `from=<locale>`.
`subscriptionKey`	Azure AI Translator مۇشتەرى ئاچقۇچ. يولدىن ئۆتمەك `secrets`
`endpoint`	تەرجىمە نۇقتىسى ئادرېسى، مەسىلەن: `https://api.cognitive.microsofttranslator.com/`.

كۆپ ئۇچرايدىغان ئىختىيارى كىرگۈزگۈچ

كۆپ ئۇچرايدىغان ئىختىيارى كىرگۈزگۈچ
نامى	كۆڭۈلدىكىدەك	چۈشەندۈرۈش
`region`	ھېچكىم يوق	تەرجىمە مەنبەسى رايونى (يەر شارى مەنبەسى ئۈچۈن چىقىرىۋېتىلگەن).
`toLocales`	ھەممىسى قوللايدۇ	تەرجىمە قىلىدىغان جايلار. JSON سانلىرى (`["fr","de"]`) ياكى پەش بىلەن ئايرىلغان قىممەتنى قوبۇل قىلىدۇ.
`include`	ھېچكىم يوق	يېڭى سىزىق ئايرىلغان شارچە نەقىشلەر؛ پەقەت ماس كېلىدىغان ھۆججەتلەرلا تەرجىمە قىلىنىدۇ
`exclude`	ھېچكىم يوق	يېڭى سىزىق ئايرىلغان شارچە نەقىشلەر؛ ماسلاشتۇرۇلغان ھۆججەتلەر ئاتلاپ ئۆتۈپ كېتىدۇ (ئۆز ئىچىگە ئالغاندىن كېيىن قوللىنىلىدۇ).
`configPath`	`.github/resource-translator.yml`	YAML سەپلىمە ھۆججىتىگە (خىزمەت ئورنى يىلتىزىغا نىسبەتەن).
`dryRun`	`false`	`true` تەرجىمە قىلىپ قىسقىچە مەزمۇن يوللاڭ، ئەمما ھۆججەت يازماڭ.
`failOnError`	`true`	`true` بولغاندا، كۈتۈلمىگەن خاتالىقلار مەشغۇلاتتا مەغلۇپ بولىدۇ. خاتالىق `false` ئاگاھلاندۇرۇش بولىدۇ.

تەرجىماننىڭ ئىلتىماسىنى كىرگۈزۈش

بۇلار بىۋاستە Azure AI Translator v3 سۈرۈشتۈرۈش پارامېتىرلىرىغا ماسلاشتۇرۇلىدۇ. ھەر بىرى ئىختىيارى بولىدۇ. تەرجىماننىڭ كۆڭۈلدىكىسى تەڭشەلمىگەندە تەتبىقلىنىدۇ.

تەرجىماننىڭ ئىلتىماسىنى كىرگۈزۈش
نامى	كۆڭۈلدىكىدەك	چۈشەندۈرۈش
`categoryId`	general	Azure Custom Translator كاتېگورىيىسى — industry/domain/tone كۇنۇپكىسى. يۆتكەپ `?category=...`.
`textType`	`plain`	`plain` ياكى `html`. پەقەت مەنبە قىممىتىڭىز ھەقىقىي HTML پارچىلىرى بولغاندا `html` ئىشلىتىڭ.
`profanityAction`	`NoAction`	`NoAction`، `Marked` ياكى `Deleted`. تەرجىمە جەريانىدا پەسكەش ئاتالغۇلارنىڭ قانداق تارقىتىلىدىغانلىقىنى كونترول قىلىدۇ.
`profanityMarker`	`Asterisk`	`Asterisk` ياكى `Tag`. پەقەت ئەھمىيەتلىك `profanityAction` `Marked`.
`allowFallback`	true (سۈكۈتتىكى تەرجىمان)	`false` قىلغاندا، تەرجىمە نىشان ئورۇنغا ئورۇنلاشتۇرۇلمىغان `categoryId` ئەھۋالدا ئادەتتىكى سىستېمىغا قايتماستىن خاتالىق قايتۇرىدۇ.
`apiVersion`	`3.0`	تەرجىمان REST API نەشرى.

ماسلىشىشچانلىق ۋە ئورۇن بەلگىلىگۈچىنى قوغداش

بۇ كىرگۈزگۈچ تەرجىماننىڭ ئىلتىماسىڭىزنى كونترول قىلغاندا مەشغۇلاتنىڭ قانداق بولىدىغانلىقىنى، تەرجىمە جەريانىدا {{name}} ياكى {0} قاتارلىق ئورۇن بەلگىلىرىنىڭ بۇزۇلۇپ قېلىشىنىڭ ئالدىنى ئالىدىغانلىقىنى كونترول قىلىدۇ.

ماسلىشىشچانلىق ۋە ئورۇن بەلگىلىگۈچىنى قوغداش سېلىنمىسى
نامى	كۆڭۈلدىكىدەك	چۈشەندۈرۈش
`maxRetries`	`5`	ئۆتكۈنچى HTTP ئىنكاسلىرىدا ئەڭ كۆپ قېتىم قايتا سىناپ بېقىش (`408, 425, 429, 500, 502, 503, 504`). ھەر بىر ئىلتىماسنىڭ HTTP چاقىرىش ئومۇمىي سانى `1 + maxRetries`.
`retryBackoffMs`	`30000`	ھەر قانداق بىر چېكىنىش ئۇيقۇسىدا (مىللىي سېكۇنت بىلەن) چەكلىنىدۇ. بۇ ھەرىكەت Azure نىڭ `Retry-After` ئىنكاس بېشىغا ھۆرمەت قىلىدۇ. بولمىسا ئۇ بۇ قىممەتكە چەكلەنگەن تەۋرىنىش كۆرسەتكۈچى چېكىنى ئىشلىتىدۇ.
`protectPlaceholders`	`true`	`true` (كۆڭۈلدىكى) بولغاندا، `{{name}}`، `${var}`، `{0}`، `{0:N2}`، `%s`، `%1$s` ۋە HTML گەۋدىسى تەرجىمە قىلىشتىن بۇرۇن Sentinel بەلگىسى بىلەن ئالماشتۇرۇلىدۇ ۋە كېيىن ئەسلىگە كەلتۈرۈلىدۇ. پەقەت مەنبەڭىز قەستەن تەرجىمە قىلىشقا تېگىشلىك ئورۇن بەلگىلەش شەكلىدىكى تېكىستنى ئۆز ئىچىگە ئالغاندا ئىناۋەتسىز بولىدۇ.
`customPlaceholderPatterns`	ھېچكىم يوق	يېڭى قۇر ئايرىلغان regex (چەكلىگۈچى يوق) سۈكۈتتىكى ئورۇن بەلگىلىگۈچى توپلىمىغا قوشۇلدى، مەسىلەن، `<<.+?>>` بەلگىلىگەن توكن گىرامماتىكىسى ئۈچۈن ئىشلىتىلىدۇ.
`noTranslatePatterns`	ھېچكىم يوق	يېڭى سىزىق ئايرىلغان glob نۇسخىسى تەھلىل قىلغۇچى قاتلاملىق ئاچقۇچلار بىلەن ماسلاشتۇرۇلغان (JSON چېكىتلىك يول، RESX `name`، PO `msgid`، XLIFF بىرلىك `id`، INI/restext ئاچقۇچى). ماسلاشتۇرۇلغان ئاچقۇچلار تەرجىمە ئىلتىماسىدىن چىقىرىۋېتىلگەندىن كېيىن مەنبە قىممىتى ساقلىنىپ ئۆتىدۇ.

چىقىرىش

چىقىرىش
نامى	چۈشەندۈرۈش
`summary-title`	قىسقا ئاممىۋى مۇناسىۋەت ماۋزۇسىغا ماس كېلىدىغان قىسقىچە خۇلاسە ، مەسىلەن Machine-translated 320 files, a total of 5,418 translations .
`summary-details`	PR ئورگىنى ياكى خىزمەت خۇلاسىسىگە ماس كېلىدىغان Markdown خۇلاسىسى.
`has-new-translations`	`'true'` بىر ياكى بىر نەچچە يېڭى تەرجىمە ھاسىل بولغاندا.