YAML схемасы һәм йөкләү тәртибе Конфигурация карагыз.
Кирәкле кертемнәр
| Исем | Тасвирлама |
|---|---|
sourceLocale | Чыганак локалы (мәсәлән, en) **/*.en.resx кебек ресурс файлларын табу өчен кулланыла. Шулай ук тәрҗемәчегә from=<locale>. |
subscriptionKey | Azure AI Тәрҗемәче подписка ачкычы. Үтеп secrets. |
endpoint | Тәрҗемәче ахыры URL, мәсәлән, 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 сорау параметрларына туры килә. Һәрберсе мәҗбүри; Тәрҗемәче стандартлары көйләнмәгән чакта кулланыла.
| Исем | Дефолт | Тасвирлама |
|---|---|---|
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. |
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 һәм HTML объектлары тәрҗемә алдыннан сакчы токеннары белән алмаштырыла һәм соңрак торгызыла. Чыганагыгызда тәрҗемә ителергә тиешле текст булган очракта гына гамәлдән чыгарыгыз. |
customPlaceholderPatterns | юк | Стандарт плейсхолдерлар җыелмасына яңа юллар белән аерылган регуляр регистрлар өстәлгән, мәсәлән, <<.+?>> махсус токен синтаксисы өчен. |
noTranslatePatterns | юк | Яңа юллардан аерылган глоб шаблоннары парсер дәрәҗәсендәге ачкычлар белән туры килә (JSON пунктирлы юл, RESX name, PO msgid, XLIFF берәмлеге id, INI/restext ачкычы). Туры килгән ачкычлар Тәрҗемәче запросыннан төшерелә һәм чыганак кыйммәте саклана килеш үтә. |
Нәтиҗәләр
| Исем | Тасвирлама |
|---|---|
summary-title | Кыска резюме, мәсәлән, Machine-translated 320 files, a total of 5,418 translations. |
summary-details | PR органы яки вакансия резюме өчен туры килә. |
has-new-translations | 'true' бер яки берничә яңа тәрҗемә барлыкка килгәч. |