Gelinta iyo wax soo saarka · Turjubaan Kheyraad

Eeg Qaabeynta si aad u aragto schema-ga YAML iyo amarka loading-ka.

Gelinta loo baahnaa

sourceLocale

Goobta isha (tusaale ahaan en) ayaa loo isticmaalaa in lagu helo faylasha kheyraadka sida **/*.en.resx. Sidoo kale waxaa loo diray bixiyaha sida from=<locale>.

Xulashada bixiyeyaasha iyo aqoonsiga

Xulo hal bixiye mar kasta oo provider. Kaliya bixi aqoonsiga bixiyaha la doortay — eeg hagaha Gelinta iyo wax soo saarka si aad u hesho dejin buuxda.

provider

Default: azure

Bixiyaha turjumaadda: azure (default), aws, ama google. Hal bixiye ayaa la isticmaalaa wicitaan kasta oo action ah.

subscriptionKey

Default: Midna

Azure AI Translator subscription key. Waxaa loo baahan yahay azure. Ka gudub secrets.

endpoint

Default: Midna

Azure Translator endpoint URL, tusaale https://api.cognitive.microsofttranslator.com/. Waxaa loo baahan yahay azure.

awsAccessKeyId

Default: Midna

AWS access key id. Ikhtiyaari — ka saar (iyadoo awsSecretAccessKey) si loo isticmaalo silsiladda aqoonsiga AWS / OIDC. Ka gudub secrets.

awsSecretAccessKey

Default: Midna

Furaha gelitaanka qarsoon ee AWS. Waa in la siiyaa awsAccessKeyId. Ka gudub secrets.

awsSessionToken

Default: Midna

Ikhtiyaar ahaan AWS session token oo loogu talagalay aqoonsiga ku meel gaarka ah. Ka gudub secrets.

awsRegion

Default: Midna

Gobolka AWS ee adeegga Translate (tusaale us-east-1). Waxaa loo baahan yahay aws ilaa AWS_REGION lagu dejin deegaanka.

awsFormality

Default: Midna

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Default: Midna

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

awsTerminologyNames

Default: Midna

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

awsParallelDataNames

Default: Midna

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

googleApiKey

Default: Midna

Furaha API Google Cloud. Sii googleCredentials qalliinkan google. Ka gudub secrets.

googleCredentials

Default: Midna

Google Cloud service-account key sida silsilad JSON ah. Sii googleApiKey qalliinkan google. Ka gudub secrets.

googleProjectId

Default: Midna

Ikhtiyaari aqoonsiga mashruuca Google Cloud. Badanaa waxaa laga soo saaraa aqoonsiga akoonka adeegga.

googleModel

Default: Midna

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

googleApiEndpoint

Default: Midna

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Default: Midna

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

Gelinta ikhtiyaariga ah ee caadiga ah

region

Default: Midna

Gobolka kheyraadka turjumaadda (ka saar kheyraadka guud).

toLocales

Default: dhamaantood waa la taageeray

Goobaha lagu turjumo. Waxay aqbashaa JSON array (["fr","de"]) ama qiimo kala soocan comma.

include

Default: Midna

qaababka goolasha ee Newline; Kaliya faylasha is waafaqa ayaa la turjumaa.

exclude

Default: Midna

qaababka goolasha ee Newline; faylasha la waafajiyay waa la dhaafay (lagu dabaqaa ka dib include).

configPath

Default: .github/resource-translator.yml

Jidka faylka qaabeynta YAML (marka la barbar dhigo xididka workspace-ka).

changeDetection

Default: 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

Default: .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

Default: 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

Default: false

Markaad true, orodka turjumaadaha oo soo saar soo koobid, laakiin ha qorin faylal.

failOnError

Default: true

Marka true, khaladaad lama filaan ah ayaa ku guuldareysta falka; Marka false, khaladaadku waa digniin.

Azure Translator request inputs

Kuwani waxay si toos ah ugu xirmaan Azure AI Translator v3 parameters-ka su'aalaha waxayna khuseeyaan bixiyaha azure. textType iyo profanityAction sidoo kale waxaa lagu khariideeyaa AWS/Google halkaas oo ay jirto mid la mid ah (eeg hagaha bixiyeyaasha); inta kale waa Azure-ka oo kaliya. Mid kasta waa ikhtiyaari; Translator-ka default ayaa khuseeya marka la joojiyo.

categoryId

Default: general

Azure Custom Translator category — the industry/domain/tone knob. Waxaa loo diray ?category=....

textType

Default: plain

plain ama html. Isticmaal html kaliya marka qiimaha kheyraadkaaga ay yihiin qaybo HTML dhab ah.

profanityAction

Default: NoAction

NoAction, Marked, ama Deleted. Waxay xakameysaa sida erayada xun loo soo saaro turjumaadaha.

profanityMarker

Default: Asterisk

Asterisk ama Tag. Kaliya macno leh marka profanityAction ay Marked tahay.

allowFallback

Default: true (Turjubaan default)

Marka la false, Turjumaadku wuxuu soo celinayaa qalad halkii uu ku laaban lahaa nidaamka guud haddii categoryId-gaagu uusan lahayn hawlgelin goob bartilmaameed ah.

apiVersion

Default: 3.0

Nooca turjumaadda REST API.

Adkeysiga iyo ilaalinta meelaha kala duwan

Inputs-kan waxay xakameeyaan sida falku u dhaqmo marka Translator uu xaddido codsigaaga iyo sida uu u ilaaliyo placeholder tokens sida {{name}} ama {0} si aan loo dhaawacin inta lagu jiro turjumaadda.

maxRetries

Default: 5

Isku dayga ugu badan ee dib-u-eegista jawaabaha HTTP ee ku meel gaarka ah (408, 425, 429, 500, 502, 503, 504). Tirada guud ee wicitaannada HTTP ee codsi kasta waa 1 + maxRetries.

retryBackoffMs

Default: 30000

Koobo (milliseconds) hurdo kasta oo backoff ah. Ficilku wuxuu xushmayaa madaxa jawaabta Retry-After ee Azure marka uu jiro; haddii kale waxay isticmaashaa jittered exponential backoff oo lagu xakameeyo qiimahan.

protectPlaceholders

Default: true

Marka la true (default), placeholders sida {{name}}, ${var}, {0}, {0:N2}, %s, %1$s iyo HTML waxaa lagu beddelaa sentinel tokens ka hor turjumaadda kadibna dib ayaa loo soo celiyaa. Dami kaliya marka ishaagu si ula kac ah u jiro qoraal si toos ah u qaab placeholder ah oo la turjumo.

customPlaceholderPatterns

Default: Midna

Regexes-ka kala soocay xariiqda cusub (aan lahayn kala soocid) ayaa lagu daray set-ka placeholder-ka caadiga ah, tusaale ahaan <<.+?>> loogu talagalay naxwaha token-ka gaarka ah.

noTranslatePatterns

Default: Midna

Qaababka newline-separated glob ayaa la waafajiyay furayaasha heerka parser-ka (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). Furayaasha iswaafajinta ayaa laga saaraa codsiga Turjubaanka waxaana la gudbiyaa iyadoo qiimaha asalka ah la ilaaliyo.

Wax soo saarka

summary-title

Kooban kooban oo u wanaagsan cinwaanka PR-ka, tusaale ahaan Machine-translated 320 files, a total of 5,418 translations.

summary-details

Soo koobid qiimeyn ku habboon hay'adda PR ama warbixinta shaqada.

has-new-translations

'true' marka hal ama in ka badan turjumaado cusub la sameeyay.