Кертү һәм чыгу · Ресурслар тәрҗемәчесе

YAML схемасы һәм йөкләү тәртибе Конфигурация карагыз.

Кирәкле кертемнәр

sourceLocale

Чыганак локалы (мәсәлән, en) **/*.en.resx кебек ресурс файлларын табу өчен кулланыла. Шулай ук хезмәт күрсәтүчегә from=<locale>.

Провайдер сайлау һәм таныклыклар

Һәр йөгерү өчен бер провайдер сайлагыз provider. Сайланган провайдерның таныклыкларын гына күрсәтегез — Кертү һәм чыгу кулланмасын карагыз.

provider

Дефолт: azure

Тәрҗемә провайдеры: azure (default), aws яки google. Бер чакыру өчен бер провайдер гына кулланыла.

subscriptionKey

Дефолт: юк

Azure AI Тәрҗемәче подписка ачкычы. Мәҗбүри azure. Узыгыз secrets.

endpoint

Дефолт: юк

Azure Translator endpoint URL, мәсәлән, https://api.cognitive.microsofttranslator.com/. Мәҗбүри azure.

awsAccessKeyId

Дефолт: юк

AWS керү ачкычы идентификаторы. Мәҗбүри — AWS стандарт учет чылбырын / OIDC куллану өчен төшереп калдырыгыз (awsSecretAccessKey белән). Узыгыз secrets.

awsSecretAccessKey

Дефолт: юк

AWS яшерен керү ачкычы. Алар белән бергә тәэмин ителергә awsAccessKeyId. Узыгыз secrets.

awsSessionToken

Дефолт: юк

Вакытлы учет мәгълүматлары өчен факультатив AWS сессия токене. Үтеп secrets.

awsRegion

Дефолт: юк

Тәрҗемә хезмәте өчен AWS төбәге (мәсәлән, us-east-1). Әйләнә-тирә мохиттә aws AWS_REGION өчен таләп ителә.

awsFormality

Дефолт: юк

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Дефолт: юк

When true, enables AWS Translate brevity mode for supported language pairs.

awsTerminologyNames

Дефолт: юк

AWS Translate custom terminology resource names. Accepts a JSON array or comma-separated values.

awsParallelDataNames

Дефолт: юк

AWS Translate parallel data resource names. Accepts a JSON array or comma-separated values.

googleApiKey

Дефолт: юк

Google Cloud API ачкычы. Бу ЯКИ googleCredentials google. Үтеп secrets.

googleCredentials

Дефолт: юк

Google Cloud сервис-аккаунт ачкычы JSON строкасы буларак. Бу ЯКИ googleApiKey google. Үтеп secrets.

googleProjectId

Дефолт: юк

Факультатив Google Cloud проекты id. Гадәттә хезмәт аккаунты мәгълүматыннан чыгарыла.

googleModel

Дефолт: юк

Google Cloud Translation model, e.g. nmt or base.

googleApiEndpoint

Дефолт: юк

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Дефолт: юк

Optional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.

Киң таралган факультатив кертемнәр

region

Дефолт: юк

Тәрҗемәче ресурс төбәге (глобаль ресурслар өчен төшереп калдырырга).

toLocales

Дефолт: барысы да хупланды

Тәрҗемә итәр өчен урыннар. JSON массивы (["fr","de"]) яки запятая белән бүленгән кыйммәтләрне кабул итә.

include

Дефолт: юк

Яңа сызыктан аерылган шар рәсемнәре; Туры килгән файллар гына тәрҗемә ителә.

exclude

Дефолт: юк

Яңа сызыктан аерылган шар рәсемнәре; Туры килгән файллар төшерелә (кертелгәннән соң кулланыла).

configPath

Дефолт: .github/resource-translator.yml

YAML конфигурация файлына юл.

changeDetection

Дефолт: smart

Smart 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.

statePath

Дефолт: .github/resource-translator-state.json

Path 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.

snapshotOnly

Дефолт: false

When 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.

dryRun

Дефолт: false

Тәрҗемәләр true һәм резюмелар чыгарыгыз, ләкин файллар язмагыз.

failOnError

Дефолт: true

Көтелмәгән хаталар true вакытта гамәлне юкка чыгара; false чакта хаталар – кисәтү.

Azure Translator request inputs

Алар турыдан-туры Azure AI Translator v3 запрос параметрларына туры килә һәм Azure провайдерына кулланыла. textType һәм profanityAction шулай ук AWS/Google белән чагыштырыла; калганнары бары тик Azure форматында. Һәрберсе мәҗбүри; Тәрҗемәче стандартлары көйләнмәгән чакта кулланыла.

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' яки берничә яңа тәрҗемә барлыкка килгәч.