Inntøkur og úttøkur · Keldutýðari

Sí Uppseting fyri YAML-skema og lastirøð.

Kravdar inntøkur

sourceLocale

Keldustaður (t.d. en), sum verður brúktur til at finna resursfílur sum **/*.en.resx. Sendi eisini víðari til veitaran sum from=<locale>.

Val av veitara og prógv

Vel ein veitara fyri hvørja ferð við provider. Lat bert inn upplýsingar hjá valda veitaranum — sí Inntøkur og úttøkur vegleiðingina fyri fulla uppseting.

provider

Default: azure

Týðingarveitari: azure (sjálvvirkandi), aws ella google. Bert ein veitari verður brúktur fyri hvørt átakskall.

subscriptionKey

Default: Einki

Azure AI Translator subscription key. Kravt til azure. Far gjøgnum secrets.

endpoint

Default: Einki

Azure Translator endpoint URL, t.d. https://api.cognitive.microsofttranslator.com/. Kravt til azure.

awsAccessKeyId

Default: Einki

AWS access key id. Valfrítt — lat vera (við awsSecretAccessKey) at brúka AWS standard credential chain / OIDC. Far gjøgnum secrets.

awsSecretAccessKey

Default: Einki

AWS loyniligur atgongdarlykil. Mugu veitast saman við awsAccessKeyId. Far gjøgnum secrets.

awsSessionToken

Default: Einki

Valfrítt AWS session token til fyribils loyniorð. Far gjøgnum secrets.

awsRegion

Default: Einki

AWS økið fyri Translate-tænastuna (t.d. us-east-1). Kravt fyri aws, um ikki AWS_REGION er sett í umhvørvið.

awsFormality

Default: Einki

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Default: Einki

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

awsTerminologyNames

Default: Einki

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

awsParallelDataNames

Default: Einki

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

googleApiKey

Default: Einki

Google Cloud API-lykil. Veita hesa ELLA googleCredentials til google. Koyr gjøgnum secrets.

googleCredentials

Default: Einki

Google Cloud tænastukontolykil sum ein JSON-strengur. Veita hesa ELLA googleApiKey til google. Koyr gjøgnum secrets.

googleProjectId

Default: Einki

Valfrítt Google Cloud verkætlanar-id. Vanliga verður tað grundað á tænastukontu-innritan.

googleModel

Default: Einki

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

googleApiEndpoint

Default: Einki

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Default: Einki

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

Vanligar valfríar inntøkur

region

Default: Einki

Umsetara-tilfeingisøkið (ikki fyri globalar keldur).

toLocales

Default: øll stuðlað

Staðir at týða til. Tekur ímóti JSON-array (["fr","de"]) ella komma-separeraðum virðum.

include

Default: Einki

nýlínu-skildar glob-mynstur; bert samsvarandi fílur verða týddar.

exclude

Default: Einki

nýlínu-skildar glob-mynstur; Samsvarandi fílur verða lopnar (lagdar afturat Include).

configPath

Default: .github/resource-translator.yml

Leið til YAML config-fíluna (í mun til workspace-rótina).

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

Tá true, koyr týðingar og send samandráttir, men skriva ikki fílur.

failOnError

Default: true

Tá ið true, miseydnast óvæntaðar villur í virknaðinum; Tá false, eru villur ávaringar.

Azure Translator request inputs

Hesi verða beinleiðis kortløgd til Azure AI Translator v3 fyrispurningsparametrar og verða brúkt til Azure Provider. textType og ProfanityAction verða eisini kortlagdar til AWS/Google, har ein samsvarandi loysn finst (sí veitaravegleiðingina); hinir eru bert Azure-útgávur. Øll eru valfrí; Translator-standardarnir gilda, tá teir ikki eru settir.

categoryId

Default: general

Azure Custom Translator kategori — vinnu-/domain-/tone-knøtturin. Sendur víðari sum ?category=....

textType

Default: plain

plain ella html. Brúka html bara, tá tíni tilfeingisvirði eru verulig HTML-brot.

profanityAction

Default: NoAction

NoAction, Marked ella Deleted. Stýrir, hvussu grov orð verða brúkt í týðingum.

profanityMarker

Default: Asterisk

Asterisk ella Tag. Bert týdningarmikil, tá profanityAction er Marked.

allowFallback

Default: true (Týðari standard)

Tá false, gevur Translator eina villu í staðin fyri at fara aftur til almenna skipanina, um categoryId ikki hevur útbreiðslu til eitt málstað.

apiVersion

Default: 3.0

Translator REST API útgáva.

Seiglu- og plásshaldarvernd

Hesar inntøkur stýra, hvussu átakið uppførir seg, tá Translator minkar tína fyrispurning, og hvussu tað verjir plásshaldar-token sum {{name}} ella {0} frá at verða oyðiløgd undir umsetingini.

maxRetries

Default: 5

Maksimum royndir við stuttvarandi HTTP-svarum (408, 425, 429, 500, 502, 503, 504). Tilsamans eru HTTP-kall pr. áheitan 1 + maxRetries.

retryBackoffMs

Default: 30000

Takmark (í millisekundum) á hvørjum einstøkum backoff sleep. Gerðin virðir Azure's Retry-After svarhøvd júst tá tað er til staðar; Annars brúkar tað jitterað, eksponentiellt backoff, sum er avmarkað til hetta virðið.

protectPlaceholders

Default: true

Tá ið true (sjálvvirkandi), verða plásshaldarar sum {{name}}, ${var}, {0}, {0:N2}, %s, %1$s og HTML-eindir skiftar út við sentinel-token áðrenn umseting og endursettar aftaná. Sløkk bert tá keldan við vilja inniheldur bókstaviliga plásshaldar-líknandi tekst, sum eigur at verða týddur.

customPlaceholderPatterns

Default: Einki

Nýlínu-skildir regexar (uttan avmarkarar), lagdir afturat sjálvvalda plásshaldara-setinum, t.d. <<.+?>> til serstaka token-syntaks.

noTranslatePatterns

Default: Einki

Newline-sundurbýtt glob-mynstur, sum samsvara við parser-stigs lyklar (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). Samsvarandi lyklar verða tiknir burtur úr umsetarafyrispurninginum og sendir víðari við upprunavirðinum varðveittum.

Úrtøkur

summary-title

Stutt PR-heitivinarlig samandráttur, t.d. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown-samandráttur, hóskandi til PR-kropp ella starvssamandrátt.

has-new-translations

'true' tá ein ella fleiri nýggjar týðingar vórðu gjørdar.