تێکردنەکان و دەرچووەکان · وەرگێڕی سەرچاوە

سەیری شێوەپێدان بکە بۆ هێڵکاری 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=...`.
`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`	Cap (بە میلی چرکە) لە هەر تاکە خەوێکی گەڕانەوە. کردارەکە ڕێز لە سەردێڕی وەڵامدانەوەی `Retry-After` Azure دەگرێت ڕێک کاتێک ئامادەیە. ئەگینا ئەو پاشەکشەی نمایی لەرزۆک بەکاردەهێنێت کە بەم بەهایە داپۆشراوە.
`protectPlaceholders`	`true`	کاتێک `true` (گریمانە)، پلەیسهۆڵدەرەکانی وەک `{{name}}`، `${var}`، `{0}`، `{0:N2}`، `%s`، `%1$s` و HTML پێش وەرگێڕان دەگۆڕدرێن بە نیشانەی پاسەوان و دواتر دەگەڕێننەوە. ناچالاک تەنها کاتێک سەرچاوەکەت بە ئەنقەست دەقی شێوە جێگرەوەی وشەیی تێدایە کە پێویستە وەربگێڕدرێت.
`customPlaceholderPatterns`	هیچ	regexes بە هێڵی نوێی جیاکراو (بەبێ سنووردار) زیادکرا بۆ کۆمەڵەی پلەیس هۆڵدەری گریمانەیی، بۆ نمونە `<<.+?>>` بۆ ڕستەسازی توکنی سازێنراو.
`noTranslatePatterns`	هیچ	نمونەی گلۆب کە بە هێڵی نوێ جیاکرایەوە هاوتایە لەگەڵ کلیلەکانی ئاستی شیکەرەوە (JSON خاڵدار Path, RESX `name`, PO `msgid`, XLIFF unit `id`, INI/restext key). کلیلەکانی هاوشێوە لە داواکاری وەرگێڕ فڕێدەدرێن و بە بەهای سەرچاوەکەیان دەپارێزرێن.

دەرچوەکان

دەرچوەکان
ناو	دەربارە
`summary-title`	پوختەیەکی کورت بۆ ناونیشانی پەیوەندییە گشتیەکان، بۆ نمونە Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	پوختەی Markdown گونجاوە بۆ دەزگای پەیوەندییە گشتییەکان یان پوختەی کار.
`has-new-translations`	`'true'` کاتێک وەرگێڕانێکی نوێ یان زیاتر دروست کرا.