YAML схемасы мен жүктеу тәртібі Конфигурация-дан қараңыз.
Қажетті кірістер
| Атауы | Сипаттамасы |
|---|---|
sourceLocale | Source locale (мысалы, en) **/*.en.resx сияқты ресурс файлдарын табу үшін қолданылады. Сондай-ақ аудармашыға from=<locale> ретінде жіберілді. |
subscriptionKey | Azure AI Translator жазылу кілті. Өту secrets. |
endpoint | Аудармашының соңғы нүктесінің URL-ы, мысалы, https://api.cognitive.microsofttranslator.com/. |
Кең таралған қосымша кірістер
| Атауы | Әдепкі | Сипаттамасы |
|---|---|---|
region | Жоқ | Аудармашы ресурс аймағы (жаһандық ресурстар үшін шығарылған). |
toLocales | барлығы қолдау тапты | Аударуға арналған орындар. JSON массивін (["fr","de"]) немесе үтірмен бөлінген мәндерді қабылдайды. |
include | Жоқ | Жаңа сызықпен бөлінген шар үлгілері; тек сәйкес файлдар аударылады. |
exclude | Жоқ | Жаңа сызықпен бөлінген шар үлгілері; сәйкестендіру файлдары өткізіледі (include-ден кейін қолданылады). |
configPath | .github/resource-translator.yml | YAML конфигурация файлына (жұмыс кеңістігінің түбіріне қатысты) жол. |
dryRun | false | true болғанда, аудармаларды іске қосып, қысқаша мазмұнын шығарыңыз, бірақ файл жазбаңыз. |
failOnError | true | true кезде, күтпеген қателіктер әрекетті тоқтатады; false кезде қателер ескерту болып табылады. |
Транслятор сұранысы кірістері
Олар Azure AI Translator v3 сұрау параметрлеріне тікелей сәйкестендіріледі. Әрқайсысы міндетті емес; Аудармашы әдепкі параметрлері орнатылмаған кезде қолданылады.
| Атауы | Әдепкі | Сипаттамасы |
|---|---|---|
categoryId | general | Azure Custom Translator category — industry/domain/tone knob. ?category=... ретінде жіберілді. |
textType | plain | plain немесе html. Тек ресурс мәндеріңіз шынайы HTML фрагменттері болғанда ғана html қолданыңыз. |
profanityAction | NoAction | NoAction, Marked немесе Deleted. Аудармаларда дөрекі сөздердің қалай таратылуын басқарады. |
profanityMarker | Asterisk | Asterisk немесе Tag. Мағынасы тек profanityAction Marked. |
allowFallback | true (Аудармашы әдепкі) | false болғанда, егер categoryId мақсатты орынға орналастырылмаса, Translator жалпы жүйеге қайта оралмайды, қате қайтарады. |
apiVersion | 3.0 | Аудармашы REST API нұсқасы. |
Төзімділік және уақытша қорғау
Бұл енгізулер Translator сұранысыңызды шектегенде әрекеттің қалай әрекет ететінін және {{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 және HTML объектілері аударма алдында сентинел токендерімен ауыстырылып, кейін қалпына келтіріледі. Тек дереккөзіңізде әдейі аудару тиіс мәтін мәтіні бар болса ғана өшіріңіз. |
customPlaceholderPatterns | Жоқ | Жаңа жолға бөлінген регулярлар (шектеушілерсіз) әдепкі уақытша жиынтыққа қосылды, мысалы, <<.+?>> арнайы токен синтаксисі үшін. |
noTranslatePatterns | Жоқ | Жаңа жолмен бөлінген глоб үлгілері парсер деңгейіндегі кілттерге сәйкес келді (JSON нүктелі жол, RESX name, PO msgid, XLIFF блогы id, INI/restext кілті). Сәйкес кілттер аудармашы сұранысынан алынып тасталады және бастапқы мәні сақталады. |
Шығарылымдар
| Атауы | Сипаттамасы |
|---|---|
summary-title | PR атауына сай қысқа қысқаша шолу, мысалы, Machine-translated 320 files, a total of 5,418 translations. |
summary-details | PR ұйымы немесе жұмыс қорытындысы үшін сай markdown қысқаша мазмұны. |
has-new-translations | 'true' бір немесе бірнеше жаңа аудармалар жасалғанда. |