YAML sxemasi va yuklash tartibi uchun Konfiguratsiya qarang.
Kerakli kirishlar
| Nomi | Tavsif |
|---|---|
sourceLocale | Manba lokaali (masalan, en) resurs fayllarini topish uchun ishlatiladi, masalan, **/*.en.resx. Shuningdek, Translator'ga from=<locale> sifatida yuborilgan. |
subscriptionKey | Azure AI Translator obuna kaliti. O'tib secrets. |
endpoint | Translator endpoint URL, masalan https://api.cognitive.microsofttranslator.com/. |
Keng tarqalgan ixtiyoriy kirishlar
| Nomi | Standart | Tavsif |
|---|---|---|
region | yo'q | Tarjimon resurs hududi (global resurslar uchun chiqarib tashlangan). |
toLocales | Barchasi qo'llab-quvvatlanadi | Tarjima qilish kerak bo'lgan joylar. JSON massivini (["fr","de"]) yoki vergul bilan ajratilgan qiymatlarni qabul qiladi. |
include | yo'q | Newline ajratilgan glob naqshlari; faqat mos keladigan fayllar tarjima qilinadi. |
exclude | yo'q | Newline ajratilgan glob naqshlari; Moslashtiruvchi fayllar o'tkazib yuboriladi (include so'zidan keyin qo'llaniladi). |
configPath | .github/resource-translator.yml | YAML konfiguratsiya fayliga yo'l (ish joyi ildiziga nisbatan). |
dryRun | false | true qilganda, tarjimalarni ishga tushiring va xulosalar chiqaring, lekin fayl yozmang. |
failOnError | true | true bo'lganda, kutilmagan xatolar harakatda muvaffaqiyatsiz bo'ladi; false bo'lsa, xatolar ogohlantirish hisoblanadi. |
Tarjimon so'rovi kirishlari
Ular to'g'ridan-to'g'ri Azure AI Translator v3 so'rov parametrlariga xaritalanadi. Har biri ixtiyoriy; Translator standart funksiyalari o'rnatilmaganda qo'llaniladi.
| Nomi | Standart | Tavsif |
|---|---|---|
categoryId | general | Azure Custom Translator category — industry/domain/tone knob. ?category=... sifatida yuborilgan. |
textType | plain | plain yoki html. html faqat resurs qiymatlaringiz haqiqiy HTML fragmentlari bo'lsa ishlating. |
profanityAction | NoAction | NoAction, Marked yoki Deleted. Tarjimalarda haqoratli so'zlar qanday chiqarilishini nazorat qiladi. |
profanityMarker | Asterisk | Asterisk yoki Tag. Faqat profanityAction Marked bo'lsa ahamiyatli. |
allowFallback | true (Tarjimon defaulti) | Agar false joylashtirilganda, Translator xato qaytaradi, agar categoryId maqsadli joyda joylashtirish bo'lmasa, umumiy tizimga qaytmaydi. |
apiVersion | 3.0 | Tarjimon REST API versiyasi. |
Barqarorlik va vaqtinchalik himoya
Bu kirishlar Translator so'rovingizni cheklaganda harakatning qanday ishlashini va {{name}} yoki {0} kabi vaqtinchalik tokenlarni tarjima paytida buzilishidan qanday himoya qilishini boshqaradi.
| Nomi | Standart | Tavsif |
|---|---|---|
maxRetries | 5 | Vaqtinchalik HTTP javoblarida maksimal qayta urinishlar (408, 425, 429, 500, 502, 503, 504). Har bir so'rov uchun umumiy HTTP qo'ng'iroqlari soni 1 + maxRetries. |
retryBackoffMs | 30000 | Har qanday orqaga qaytish uyqusini (millisekundlarda) cheklang. Harakat Azure'ning Retry-After javob sarlavhasini aynan mavjud bo'lganda hurmat qiladi; aks holda, bu qiymat bilan cheklangan jittered eksponensial orqaga qaytishdan foydalanadi. |
protectPlaceholders | true | true (standart) bo'lganda, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s va HTML elementlari tarjima qilinishidan oldin sentinel tokenlar bilan almashtiriladi va keyin tiklanadi. Faqat manbangiz ataylab tarjima qilinishi kerak bo'lgan so'zma-so'z almashtirish shaklidagi matn bo'lsa o'chirib qo'ying. |
customPlaceholderPatterns | yo'q | Yangi qator bo'yicha ajratilgan regexlar (ajratgichsiz) standart joy tutuvchi to'plamga qo'shilgan, masalan, maxsus token sintaksisi uchun <<.+?>>. |
noTranslatePatterns | yo'q | Yangi chiziqli ajratilgan glob naqshlari parser darajasidagi kalitlarga (JSON nuqtali yo'l, RESX name, PO msgid, XLIFF unit id, INI/restext kaliti) mos keladi. Mos keluvchi kalitlar Tarjimon so'rovidan olib tashlanadi va ularning manba qiymati saqlanib qoladi. |
Natijalar
| Nomi | Tavsif |
|---|---|
summary-title | Qisqa, PR sarlavhasi uchun qulay qisqacha mazmun, masalan, Machine-translated 320 files, a total of 5,418 translations. |
summary-details | PR organi yoki ish haqida qisqacha ma'lumot uchun mos keladigan markdown qisqacha mazmuni. |
has-new-translations | 'true' bir yoki bir nechta yangi tarjimalar yaratilganda. |