YAML схемаһы һәм йөкләү тәртибе тураһында Конфигурация ҡарағыҙ.
Талап ителгән инпуттар
| Исеме | Тасуирлама |
|---|---|
sourceLocale | Сығанаҡ локаль (мәҫәлән, 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 һорау параметрҙарына тура тура килә. Һәр береһе ихтыярһыҙ; Translator default-тары ҡуйылмағанда ҡулланыла.
| Исеме | Төп вариант | Тасуирлама |
|---|---|---|
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 эшләгәндә, Translator хата ҡайтара, әгәр categoryId маҡсатлы урын өсөн деплойт булмаһа, дөйөм системаға кире ҡайта. |
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 | юҡ | Яңы юлдан айырылған regex-тар (сикләүселәрһеҙ) стандарт placeholder йыйылмаһына өҫтәлә, мәҫәлән, <<.+?>> махсус токен синтаксисы өсөн. |
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 | Markdown йыйынтығы PR ойошмаһы йәки эш йыйынтығы өсөн яраҡлы. |
has-new-translations | 'true' бер йәки бер нисә яңы тәржемә барлыҡҡа килгәндә. |