اِنپُٹ تہٕ آؤٹ پُٹ · ریسورس ٹرانسلیٹر

وُچھِو کنفیگریشن YAML سکیما تہٕ لوڈِنگ آرڈر۔

ضروری ان پٹ

ضروری ان پٹ
ناو	تفصیل
`sourceLocale`	سورس لوکل (مثلاً `en`) چُھ ریسورس فایلہٕ ژھانڈنہٕ خٲطرٕ استعمال گژھان یتھ کٔنۍ `*/.en.resx`۔ ترجمہ کارس تہِ سوزنہٕ `from=<locale>`۔
`subscriptionKey`	Azure AI ٹرانسلیٹر سبسکرپشن کی. پاس کٔرِو `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 query parameters پیٹھ۔ پرٮ۪تھ کانٛہہ چھُ اختیاری۔ ٹرانسلیٹر ڈیفالٹ چھ لاگو گژھان ییلہ ان سیٹ چھُ۔

ترجمہ کار درخواست ان پٹ
ناو	ڈیفالٹ	تفصیل
`categoryId`	general	Azure Custom Translator زمرٕ — صنعت/ڈومین/ٹون نوب۔ بطور `?category=...` فارورڈ۔
`textType`	`plain`	`plain` یا `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`	کُنہِ تہِ بیک آف نیندِ پیٹھ کیپ (ملی سیکنڈن منز)۔ یہ عمل چھُ Azure سٕنٛدِس `Retry-After` رسپانس ہیڈرس بالکل احترام کران ییٚلہ موجود چھُ۔ نتہٕ چُھ یہٕ اتھ قدرس پیٹھ بند کرنہٕ آمُت جِٹرڈ ایکسپونینشل بیک آف استعمال کران۔
`protectPlaceholders`	`true`	ییلہ `true` (ڈیفالٹ)، پلیس ہولڈر یتھ کٔنۍ `{{name}}`، `${var}`، `{0}`، `{0:N2}`، `%s`، `%1$s` تہٕ ایچ ٹی ایم ایل اینٹیٹیز چھ ترجمہ برونٛہہ سینٹینل ٹوکنن سۭتۍ تبدیل یوان کرنہٕ تہٕ پتہٕ چھ بحال یوان کرنہٕ۔ صرف کٔرِو تَمہِ وِزِ ییٚلہِ تُہٕنٛدِس ماخذَس مٲنِتھ مٲنِتھ لَفِقی جاے ہولڈرُک متن آسہِ یُس ترجمہٕ گژھہِ کرنہٕ یُن۔
`customPlaceholderPatterns`	کانٛہہ تہِ نہٕ	نیو لائن الگ الگ ریجیکس (ڈیلیمیٹر بغیر) ڈیفالٹ پلیس ہولڈر سیٹس منز شٲمل کرنْہ آمُت، مثلن `<<.+?>>` کسٹم ٹوکن نحو باپت۔
`noTranslatePatterns`	کانٛہہ تہِ نہٕ	نیو لائن الگ گلوب پیٹرن چُھ پارسر لیول کیزن (JSON ڈاٹڈ پاتھ، RESX `name`، PO `msgid`، XLIFF یونٹ `id`، INI/restext key) سۭتۍ مماثل گژان۔ میچنگ کی چھ ٹرانسلیٹر درخواستہٕ پیٹھٕ تراونہٕ یوان تْہ تِہند سورس ویلیو محفوظ۔

آؤٹ پُٹ

آؤٹ پُٹ
ناو	تفصیل
`summary-title`	مختصر پی آر-ٹائٹل-دوستانہ خُلاصہٕ، مثلاً Machine-translated 320 files, a total of 5,418 translations۔
`summary-details`	مارک ڈاون خُلاصہٕ یُس پی آر باڈی یا نوکری ہُند خُلاصہٕ خٲطرٕ موزوں چھُ۔
`has-new-translations`	`'true'` ییلہ اکھ یا زیادٕ نٔوۍ ترجمہٕ پٲدٕ گٔیہِ۔