ان پٽ ۽ آئوٽ پٽ · وسيلا مترجم

YAML اسڪيما ۽ لوڊشيڊنگ آرڊر لاءِ ترتيب[سنواريو] ڏسو.

گهربل ان پٽ

گهربل ان پٽ
نالو	وضاحت
`sourceLocale`	ماخذ لوڪل (مثال طور `en`) وسيلن جي فائلن کي ڳولڻ لاءِ استعمال ڪيو ويندو آهي جهڙوڪ `*/.en.resx`. مترجم کي پڻ `from=<locale>` طور تي موڪليو ويو آهي.
`subscriptionKey`	Azure AI Translator subscription key. `secrets` ذريعي پاس ڪريو
`endpoint`	مترجم آخري پوائنٽ يو آر ايل ، مثال طور `https://api.cognitive.microsofttranslator.com/`.

عام اختياري ان پٽ

عام اختياري ان پٽ
نالو	ڊفالٽ	وضاحت
`region`	ڪو به نه	مترجم وسيلن جو علائقو (عالمي وسيلن لاءِ ڇڏي ڏيو)
`toLocales`	سڀ سهڪار ٿيل	ترجمو ڪرڻ لاءِ لوڪلز JSON صف (`["fr","de"]`) يا ڪاما ڌار ٿيل قدرن کي قبول ڪري ٿو.
`include`	ڪو به نه	نيو لائين ڌار ٿيل گلوب نمونن ؛ صرف ملندڙ فائلون ترجمو ٿيل آهن.
`exclude`	ڪو به نه	نيو لائين ڌار ٿيل گلوب نمونن ؛ ملندڙ فائلون ڇڏي ويون آهن (شامل ٿيڻ کان پوءِ لاڳو ٿيل).
`configPath`	`.github/resource-translator.yml`	YAML config فائل جو رستو (ڪم جي جڳهه جي روٽ سان لاڳاپيل)
`dryRun`	`false`	جڏهن `true` ڪريو ، ترجما هلايو ۽ خلاصا خارج ڪريو پر فائلون نه لکو.
`failOnError`	`true`	جڏهن `true` ، غير متوقع غلطيون عمل کي ناڪام ڪن ٿيون ؛ جڏهن `false` ، غلطيون ڊيڄاريندڙ آهن.

مترجم جي درخواست ان پٽ

اهي سڌو سنئون Azure AI Translator v3 سوال جي پيرا ميٽرز تي نقشو ٺاهيندا آهن. هر هڪ اختياري آهي ؛ مترجم ڊفالٽ لاڳو ٿئي ٿو جڏهن اڻ سيٽ ڪيو ويو آهي.

مترجم جي درخواست ان پٽ
نالو	ڊفالٽ	وضاحت
`categoryId`	general	Azure Custom Translator ڪيٽيگري — انڊسٽري / ڊومين / ٽون نوب. `?category=...` طور تي اڳتي وڌايو ويو.
`textType`	`plain`	`plain` يا `html`. صرف `html` استعمال ڪريو جڏهن توهان جا وسيلا قدر حقيقي HTML ٽڪرا آهن.
`profanityAction`	`NoAction`	`NoAction` ، `Marked` يا `Deleted`. ڪنٽرول ڪري ٿو ته ترجمن ۾ گستاخ اصطلاح ڪيئن خارج ڪيا ويا آهن.
`profanityMarker`	`Asterisk`	`Asterisk` يا `Tag`. صرف تڏهن معنيٰ رکي ٿي جڏهن `profanityAction` `Marked`.
`allowFallback`	صحيح (مترجم ڊفالٽ)	جڏهن `false` ، مترجم عام نظام ڏانهن واپس اچڻ بدران غلطي واپس ڪري ٿو جيڪڏهن توهان جي `categoryId` کي ٽارگيٽ لوڪل لاءِ ڪا تعیناتي نه آهي.
`apiVersion`	`3.0`	مترجم REST API ورزن

لچڪ & جڳھ هولڊر تحفظ

اهي ان پٽ ڪنٽرول ڪن ٿا ته عمل ڪيئن برتاءُ ڪندو آهي جڏهن مترجم توهان جي درخواست کي گهٽائي ٿو ۽ اهو ڪيئن جڳھ هولڊر ٽوڪن کي بچائيندو آهي جهڙوڪ {{name}} يا {0} ترجمي دوران خراب ٿيڻ کان.

لچڪ ۽ جڳھ هولڊر تحفظ جا ان پٽ
نالو	ڊفالٽ	وضاحت
`maxRetries`	`5`	عارضي HTTP جوابن تي وڌ کان وڌ ٻيهر ڪوشش ڪرڻ جي ڪوشش (`408, 425, 429, 500, 502, 503, 504`) هر درخواست ۾ HTTP ڪالن جو ڪل تعداد `1 + maxRetries` آهي.
`retryBackoffMs`	`30000`	ڪيپ (ملي سيڪنڊن ۾) ڪنهن به واحد پٺتي پيل ننڊ تي. ايڪشن ايزور جي `Retry-After` جواب واري هيڊر کي عزت ڏئي ٿو بلڪل جڏهن موجود هجي ؛ ٻي صورت ۾ ، اهو استعمال ڪري ٿو jittered exponential backoff هن قيمت تي بند ڪيو ويو آهي.
`protectPlaceholders`	`true`	جڏهن `true` (ڊفالٽ) ، جڳھ هولڊر جهڙوڪ `{{name}}` ، `${var}` ، `{0}` ، `{0:N2}` ، `%s` ، `%1$s` ۽ HTML ادارن کي ترجمي کان اڳ سينٽينل ٽوڪن سان تبديل ڪيو ويندو آهي ۽ بعد ۾ بحال ڪيو ويندو آهي. صرف ان صورت ۾ غير فعال ڪريو جڏهن توهان جو ماخذ ارادي طور تي لفظي جڳهه هولڊر جي شڪل وارو متن هجي جنهن کي ترجمو ڪرڻ گهرجي.
`customPlaceholderPatterns`	ڪو به نه	نئين لائن کان ڌار ٿيل ريگڪس (بغير ڊيلميٽرز جي) ڊفالٽ پليس هولڊر سيٽ ۾ شامل ڪيو ويو ، مثال طور `<<.+?>>` ڪسٽم ٽوڪن نحو لاءِ.
`noTranslatePatterns`	ڪو به نه	نيو لائن ڌار ٿيل گلوب پيٽرن کي پارسر سطح جي ڪنجيون (JSON dotted path، RESX `name`، PO `msgid`، XLIFF يونٽ `id`، INI / restext ڪيچ) سان ملايو ويو آهي. ملندڙ چابيون مترجم جي درخواست مان ڪ dropي وينديون آهن ۽ انهن جي ماخذ قيمت محفوظ سان گذري وينديون آهن.

آئوٽ پٽ

آئوٽ پٽ
نالو	وضاحت
`summary-title`	مختصر پي آر عنوان دوستانه خلاصو ، مثال طور Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	مارڪ ڊائون خلاصو پي آر باڊي يا نوڪري خلاصو لاءِ موزون آهي.
`has-new-translations`	`'true'` جڏهن هڪ يا وڌيڪ نوان ترجما پيدا ڪيا ويا.