Киргизүүлөр жана чыгыштар · Ресурс которгуч

YAML схемасы жана жүктөө тартиби үчүн Конфигурация-караңыз.

Талап кылынган киргизүүлөр

sourceLocale

Булак локализациясы (мисалы, en) **/*.en.resx сыяктуу ресурс файлдарын табуу үчүн колдонулат. Ошондой эле провайдерге from=<locale> катары жөнөтүлгөн.

Провайдерди тандоо жана квалификациялар

Ар бир жолу бир провайдерди тандаңыз provider. Тандалган провайдердин гана маалыматтарын бериңиз — толук орнотуу үчүн Киргизүүлөр жана чыгыштар колдонмосун караңыз.

provider

Демейки: azure

Котормо провайдери: azure (демейки), aws же google. Ар бир аракет чакыруу үчүн бир гана провайдер колдонулат.

subscriptionKey

Демейки: жок

Azure AI Translator subscription key. Талап 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

Демейки: жок

Translate кызматы үчүн 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 долбоорунун идентификатору. Адатта бул кызматтык аккаунттун идентификациясынан аныкталат.

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

Демейки: жок

Жаңы сызыктан бөлүнгөн глоб үлгүлөрү; дал келген файлдар өткөрүлүп салынат (include кийин колдонулат).

configPath

Демейки: .github/resource-translator.yml

YAML конфигурация файлына жол (workspace тамырына салыштырмалуу).

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 максаттуу локализация үчүн жайгаштыруу жок болсо, Translator жалпы системага кайтып барбай, ката кайтарат.

apiVersion

Демейки: 3.0

Translator REST API версиясы.

Туруктуулук жана убактылуу коргоо

Бул киргизүүлөр Translator сиздин сурооңузду чектегенде аракеттин жүрүм-турумун жана {{name}} же {0} сыяктуу орун бошотуу токендерин которуу учурунда бузулуп калуудан кантип коргойт.

maxRetries

Демейки: 5

Transient 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 ачкычы) дал келген. Дал келген ачкычтар Translator сурамынан чыгарылып, булак мааниси сакталып өтөт.

Чыгыштар

summary-title

PR аталышына ылайыктуу кыскача кыскача мазмун, мисалы, Machine-translated 320 files, a total of 5,418 translations.

summary-details

PR же жумуш кыскача мазмуну үчүн ылайыктуу markdown кыскача мазмуну.

has-new-translations

'true' бир же бир нече жаңы котормолор түзүлгөндө.