ورودی ها و خروجی ها · مترجم منابع

برای طرح واره 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 (نسبت به ریشه workspace).
`dryRun`	`false`	هنگام `true`، ترجمه ها را اجرا کنید و خلاصه ها را ارسال کنید اما فایل ها را ننویسید.
`failOnError`	`true`	وقتی `true`، خطاهای غیرمنتظره در عمل شکست می خورند؛ وقتی `false`، خطاها هشدار هستند.

ورودی های درخواست مترجم

این ها مستقیما به پارامترهای پرس وجوی Azure AI Translator v3 نگاشت می شوند. هر کدام اختیاری هستند؛ پیش فرض های مترجم زمانی که تنظیم نشده باشند اعمال می شوند.

ورودی های درخواست مترجم
نام	پیش فرض	توضیحات
`categoryId`	general	Azure Custom Translator Category — دکمه صنعت/دامنه/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`	نسخه API مترجم REST.

تاب آوری و حفاظت موقت

این ورودی ها کنترل می کنند که وقتی مترجم درخواست شما را محدود می کند، عمل چگونه رفتار کند و چگونه از توکن های موقتی مانند {{name}} یا {0} در هنگام ترجمه جلوگیری می کند.

تاب آوری و ورودی های حفاظت موقت
نام	پیش فرض	توضیحات
`maxRetries`	`5`	حداکثر تلاش برای تلاش مجدد برای پاسخ های HTTP گذرا (`408, 425, 429, 500, 502, 503, 504`). تعداد کل تماس های HTTP در هر درخواست `1 + maxRetries` است.
`retryBackoffMs`	`30000`	سقف (به میلی ثانیه) برای هر خواب تک مرحله ای از بازگشت. این اقدام دقیقا در زمان حضور به هدر پاسخ `Retry-After` Azure احترام می گذارد؛ در غیر این صورت از بازگشتی نمایی نوسان دار استفاده می کند که در این مقدار محدود شده است.
`protectPlaceholders`	`true`	وقتی `true` (پیش فرض)، موجودیت هایی مانند `{{name}}`، `${var}`، `{0}`، `{0:N2}`، `%s`، `%1$s` و HTML قبل از ترجمه با توکن های سنتینل جایگزین شده و پس از ترجمه بازیابی می شوند. فقط زمانی غیرفعال کنید که منبع شما عمدا شامل متن موقت و تحت اللفظی باشد که باید ترجمه شود.
`customPlaceholderPatterns`	هیچ کدام	regexeهای جداشده با خطوط جدید (بدون جداکننده ها) به مجموعه جایگزین پیش فرض اضافه می شدند، مثلا `<<.+?>>` برای نحو توکن سفارشی.
`noTranslatePatterns`	هیچ کدام	الگوهای گلوب جداشده با خطوط جدید با کلیدهای سطح پارسر مطابقت داشتند (مسیر نقطه دار JSON، `name` مسیر نقطه دار RESX، `msgid` PO، `id` واحد XLIFF، کلید INI/restext). کلیدهای تطبیقی از درخواست مترجم حذف شده و با مقدار منبع حفظ شده عبور داده می شوند.

خروجی ها

خروجی ها
نام	توضیحات
`summary-title`	خلاصه کوتاه مناسب عنوان روابط عمومی، مثلا Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	خلاصه تخفیف مناسب برای یک نهاد روابط عمومی یا خلاصه شغل.
`has-new-translations`	`'true'` زمانی که یک یا چند ترجمه جدید تولید می شد.