Girişler we çykyşlar · Resurs terjimeçisi

YAML şemasy we ýükleme tertibi üçin Konfigurasiýa serediň.

Gerekli girişler

sourceLocale

Resurs faýllary tapmak üçin ulanylýan çeşme ýeri (en) **/*.en.resx. Şeýle-de üpjünçä iberilýär from=<locale>.

Üpjünçiniň saýlanmagy we ygtybarlylygy

Her ylgawda bir üpjünçini provider. Diňe saýlanan üpjünçiniň maglumatlaryny beriň — doly gurnamak üçin Girişler we çykyşlar görkezmä serediň.

provider

Öň bellenilen: azure

Terjimeçi: azure (default), aws ýa-da google. Her hereketli çagyryşda diňe bir üpjünçi ulanylýar.

subscriptionKey

Öň bellenilen: ýok

Azure AI Translator abonentlik açary. Talap azure. Geç secrets.

endpoint

Öň bellenilen: ýok

Azure Translator endpoint URL, mysal https://api.cognitive.microsofttranslator.com/. Talap azure.

awsAccessKeyId

Öň bellenilen: ýok

AWS access key id. Optional — AWS default credential chain / OIDC-ni ulanmak üçin (awsSecretAccessKey bilen) aýyryň. Geç secrets.

awsSecretAccessKey

Öň bellenilen: ýok

AWS gizlin giriş açary. Bilelikde üpjün edilmeli awsAccessKeyId. Geç secrets.

awsSessionToken

Öň bellenilen: ýok

Wagtlaýyn kimlik maglumaty üçin goşmaça AWS seans tokeni. Geçiň secrets.

awsRegion

Öň bellenilen: ýok

Translate hyzmaty üçin AWS regiony (mysal üçin us-east-1). Daş-aws bolmasa, AWS_REGION üçin talap edilýär.

awsFormality

Öň bellenilen: ýok

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Öň bellenilen: ýok

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

awsTerminologyNames

Öň bellenilen: ýok

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

awsParallelDataNames

Öň bellenilen: ýok

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

googleApiKey

Öň bellenilen: ýok

Google Cloud API açary. Bu OR googleCredentials üçin google. Geç secrets.

googleCredentials

Öň bellenilen: ýok

Google Cloud hyzmat-account açary JSON string hökmünde. Bu OR googleApiKey üçin google. Geç secrets.

googleProjectId

Öň bellenilen: ýok

Optional Google Cloud project id. Adatça, hyzmat hasabynyň maglumatyndan çykarylýar.

googleModel

Öň bellenilen: ýok

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

googleApiEndpoint

Öň bellenilen: ýok

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Öň bellenilen: ýok

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

Umumy goşmaça girişler

region

Öň bellenilen: ýok

Terjimeçi resurs regiony (global resurslar üçin aýryldy).

toLocales

Öň bellenilen: Hemmesi goldanylýar

Terjime etmeli ýerler. JSON array (["fr","de"]) ýa-da virgül bilen aýrylan mykdarlary kabul edýär.

include

Öň bellenilen: ýok

Newline-aýrylan glob nusgalary; Diňe gabat gelýän faýllar terjime edilýär.

exclude

Öň bellenilen: ýok

Newline-aýrylan glob nusgalary; gabat gelýän faýllar atylýar (include edilenden soň ulanylýar).

configPath

Öň bellenilen: .github/resource-translator.yml

YAML config faýlyna ýol (iş ýeri köküne görä).

changeDetection

Öň bellenilen: 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

Öň bellenilen: .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

Öň bellenilen: 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

Öň bellenilen: false

true wagty terjimeleri çalıştıryň we gysgaça maglumatlary çykaryň, ýöne faýllary ýazmaň.

failOnError

Öň bellenilen: true

Garaşylmadyk true ýalňyşlyklar şowsuzlyga uçraýar; false ýalňyşlyklar duýduryşdyr.

Azure Translator request inputs

Bular göni Azure AI Translator v3 sorag parametrlerine meňzedilýär we azure üpjünçisine degişlidir. textType we profanityAction hem AWS/Google bilen deňeşdirilýär (üpjünçileriň görkezmesine serediň); galanlary bolsa diňe Azure-da. Olaryň hemmesi hökman däl; Terjimeçi öň bellenilen ýagdaýynda ulanylýar.

categoryId

Öň bellenilen: general

Azure Custom Translator kategoriýasy — senagat/domain/ton düwmesi. Iberilen ?category=....

textType

Öň bellenilen: plain

plain ýa-da html. Diňe html gymmatlyklaryňyz hakyky HTML bölekleri bolanda ulanyň.

profanityAction

Öň bellenilen: NoAction

NoAction, Marked ýa-da Deleted. Terjimelerde hapa sözleriň nähili ulanylýandygyna gözegçilik edýär.

profanityMarker

Öň bellenilen: Asterisk

Asterisk ýa-da Tag. Diňe profanityAction manyly Marked.

allowFallback

Öň bellenilen: true (Translator default)

false bolanda, eger siziň categoryId belli bir ýer üçin ýerleşdirilmedik bolsa, Translator umumy sistema dolanmagyň deregine hata gaýtaryp berýär.

apiVersion

Öň bellenilen: 3.0

Terjimeçi REST API wersiýasy.

Çydamlylyk we ýer tutucu gorag

Bu girişler Translator haýyşyňyzy çäklendirende hereketiň nähili hereket edýändigine we terjime edilende {{name}} ýa-da {0} ýaly placeholder tokenlary zaýalanmakdan nädip goraýandygyna gözegçilik edýär.

maxRetries

Öň bellenilen: 5

Wagtlaýyn HTTP jogaplarynda maksimum gaýtalamak synanyşyklary (408, 425, 429, 500, 502, 503, 504). Her haýyşda HTTP jaňlarynyň umumy sany 1 + maxRetries.

retryBackoffMs

Öň bellenilen: 30000

Islendik backoff ukusynda kapasa (milisekundda). Bu hereket Azure-yň Retry-After jogap başlygyna hormat goýýar; ýogsam bu möçberde çäklendirilen jittered exponential backoff ulanylýar.

protectPlaceholders

Öň bellenilen: true

true (default) bolanda, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s we HTML obýektleri terjimeden öň sentinel tokenlar bilen çalşyrylýar we soň dikeldilýär. Diňe çeşmäňizde terjime edilmeli göni manyda ýer tutucu şekilli tekst bar bolsa söndüriň.

customPlaceholderPatterns

Öň bellenilen: ýok

Newline-aýrylan regexler (delimitersiz) öň bellenilen ýer tutucu setine goşuldy, meselem, custom token sintaksisi üçin <<.+?>> goşuldy.

noTranslatePatterns

Öň bellenilen: ýok

Newline-aýrylan glob nusgalary parser derejeli açarlara (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key) gabat gelýär. Gabat gelýän açarlar terjimeçi haýyşyndan düşürilýär we olaryň çeşme gymmaty saklanyp geçirilýär.

Çykyşlar

summary-title

Gysgaça PR-titul dostlukly gysgaça maglumat, meselem, Machine-translated 320 files, a total of 5,418 translations.

summary-details

PR organy ýa-da iş gysgaça maglumaty üçin markdown gysgaça maglumat.

has-new-translations

'true' bir ýa-da birnäçe täze terjimeler çykarylanda.