YAML схемаһы һәм йөкләү тәртибе тураһында Конфигурация ҡарағыҙ.
Талап ителгән инпуттар
sourceLocaleСығанаҡ локаль (мәҫәлән, en) **/*.en.resx кеүек ресурс файлдарын табыу өсөн ҡулланыла. Шулай уҡ провайдерға from=<locale> тип ебәрелде.
Провайдер һайлау һәм квалификация
Һәр рейсҡа бер провайдер һайлағыҙ provider. Тик һайланған провайдерҙың таныҡлыҡтарын ғына күрһәтегеҙ — тулы көйләү өсөн Инпуттар һәм сығыуҙар ҡулланмаһын ҡарағыҙ.
providerТәржемә күрһәтеүсе: azure (стандарт), aws йәки google. Һәр эш шылтыратыу өсөн бер генә провайдер ҡулланыла.
subscriptionKeyAzure AI Translator яҙылыу асҡысы. Мотлаҡ azure. Үтеп secrets.
endpointAzure Translator endpoint URL, мәҫәлән, https://api.cognitive.microsofttranslator.com/. Мотлаҡ azure.
awsAccessKeyIdAWS кереш асҡысы идентификаторы. Мотлаҡ — AWS-тың стандарт credential chain / OIDC-һын ҡулланыуҙы (awsSecretAccessKey менән) төшөрөп ҡалдырырға. Үтеп secrets.
awsSecretAccessKeyAWS-тың серле инеү асҡысы. Мотлаҡ awsAccessKeyId. Үтеп secrets.
awsSessionTokenВаҡытлы иҫәп яҙмалары өсөн өҫтәмә AWS сессия токены бар. Үтеп secrets.
awsRegionТәржемә итеү хеҙмәте өсөн AWS төбәге (мәҫәлән, us-east-1). Мотлаҡ aws, әгәр AWS_REGION мөхиттә ҡуйылмаған булһа.
awsFormalityAWS Translate formality setting: FORMAL or INFORMAL.
awsBrevityWhen true, enables AWS Translate brevity mode for supported language pairs.
awsTerminologyNamesAWS Translate custom terminology resource names. Accepts a JSON array or comma-separated values.
awsParallelDataNamesAWS Translate parallel data resource names. Accepts a JSON array or comma-separated values.
googleApiKeyGoogle Cloud API асҡысы. Был операция бүлмәһен googleCredentials google. Үтеп secrets.
googleCredentialsGoogle Cloud сервис-аккаунт асҡысы JSON юлдары рәүешендә. Был операция бүлмәһен googleApiKey google. Үтеп secrets.
googleProjectIdGoogle Cloud проект идентификаторы мотлаҡ кәрәк. Ғәҙәттә хеҙмәт иҫәбенән сығарыла.
googleModelGoogle Cloud Translation model, e.g. nmt or base.
googleApiEndpointOptional Google Cloud Translation API endpoint override.
googleAutoRetryOptional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.
Киң таралған өҫтәмә инпуттар
regionТранслятор ресурс төбәге (глобаль ресурстар өсөн төшөрөлә).
toLocalesТәржемә итеү өсөн урындар. JSON массивы (["fr","de"]) йәки үҫмер менән айырылған ҡиммәттәрҙе ҡабул итә.
includeЯңы һыҙыҡтан айырылған шар үрнәктәре; Тик тап килгән файлдар ғына тәржемә ителә.
excludeЯңы һыҙыҡтан айырылған шар үрнәктәре; Тап килгән файлдар үткәрелмәй (include-ҙан һуң ҡулланыла).
configPathYAML конфигурация файлына юл (эш урынының тамырына ҡарата).
changeDetectionSmart change detection mode. smart translates only keys whose source value, target presence, state entry, or translation-affecting settings require it. Use disabled or false to send every eligible key on every run.
statePathPath to the compact deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json; commit it so future runs can audit and reuse unchanged translations.
snapshotOnlyWhen true, create/update the smart change-detection manifest from existing source and target files without calling a translation provider or writing target resource files. Useful when bootstrapping statePath while a provider is unavailable.
dryRuntrue ваҡытта тәржемәләрҙе эшләтегеҙ һәм ҡыҫҡаса мәғлүмәттәр сығарығыҙ, әммә файлдар яҙмағыҙ.
failOnErrortrue ваҡытта көтөлмәгән хаталар эште боҙа; false хаталар — иҫкәртеүҙәр.
Azure Translator request inputs
Былар Azure AI Translator v3 һорау параметрҙарына тура тура килә һәм Azure провайдерына ҡулланыла. textType һәм profanityAction шулай уҡ AWS/Google-ға тап килә, унда аналог бар (провайдерҙар ҡулланмаһын ҡарағыҙ); ҡалғандары тик Azure форматында. Һәр береһе ихтыярһыҙ; Translator default-тары ҡуйылмағанда ҡулланыла.
categoryIdAzure Custom Translator category — industry/domain/tone knob. Ебәрелде ?category=....
textTypeplain йәки html. Ресурс ҡиммәттәре ысын HTML фрагменттары булғанда ғына html ҡулланығыҙ.
profanityActionNoAction, Marked, йәки Deleted. Тәржемәләрҙә оятһыҙ һүҙҙәрҙең нисек таралыуын контролләй.
profanityMarkerAsterisk йәки Tag. Мәғәнәле profanityAction ғына Marked.
allowFallbackfalse эшләгәндә, Translator хата ҡайтара, әгәр categoryId маҡсатлы урын өсөн деплойт булмаһа, дөйөм системаға кире ҡайта.
apiVersionТәржемәсе REST API версияһы.
Сыҙамлылыҡ һәм ваҡытлыса һаҡлау
Был инпуттар Translator һорауҙы сикләгәндә хәрәкәттең нисек эшләүен һәм {{name}} йәки {0} кеүек ваҡытлы токендарҙы тәржемә ваҡытында боҙолоуҙан һаҡлай.
maxRetriesТранзиент HTTP яуаптары өсөн максималь ҡабаттан тырышыуҙар (408, 425, 429, 500, 502, 503, 504). Бер һорауға HTTP шылтыратыуҙарының дөйөм һаны 1 + maxRetries.
retryBackoffMsҺәр бер артҡа киткән йоҡоға (миллисекундтарҙа) сик ҡуйығыҙ. Хәрәкәт Azure-ҙың Retry-After яуап башлығын тап ошо ваҡытта хөрмәт итә; башҡа осраҡта, ул был ҡиммәткә сикләнгән экспоненциаль кире ҡайтарыу ҡуллана.
protectPlaceholderstrue (стандарт) булғанда, {{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-detailsMarkdown йыйынтығы PR ойошмаһы йәки эш йыйынтығы өсөн яраҡлы.
has-new-translations'true' бер йәки бер нисә яңы тәржемә барлыҡҡа килгәндә.