Inputs & Outputs · Resource Translator

Tarisa uone Configuration yeiyo YAML schema uye kurodha kurongeka.

Zvishandiso zvinodikanwa

sourceLocale

Source locale (semuenzaniso en) inoshandiswa kutsvaga mafaira ezviwanikwa senge **/*.en.resx. Uyezve, yakatumirwa kune mutengesi from=<locale>.

Provider selection & credentials

Sarudza mumwe mupi pakumhanya provider. Ipa chete zvitupa zvemupi akasarudzwa — ona iyo Inputs & Outputs gwara rekumisikidza kuzere.

provider

Default: azure

Mupi wekushandura: azure (default), aws, kana google. Mupi mumwe chete anoshandiswa padanho rekuita.

subscriptionKey

Default: hapana

Azure AI Translator subscription key. Inodikanwa azure. Pfuura kuburikidza secrets.

endpoint

Default: hapana

Azure Translator endpoint URL, semuenzaniso https://api.cognitive.microsofttranslator.com/. Inodikanwa azure.

awsAccessKeyId

Default: hapana

AWS Access Key ID. Optional — omit (with awsSecretAccessKey) to use the AWS default credential chain / OIDC. Pfuura kuburikidza secrets.

awsSecretAccessKey

Default: hapana

AWS yakavanzika yekuwana kiyi Inofanira kupihwa pamwe chete awsAccessKeyId. Pfuura kuburikidza secrets.

awsSessionToken

Default: hapana

Optional AWS session token for temporary credentials. Pfuura kuburikidza secrets.

awsRegion

Default: hapana

Shanduro yebasa rekushandura (semuenzaniso us-east-1). Izvo zvinodikanwa aws kunze kwekunge AWS_REGION yakaiswa munharaunda.

awsFormality

Default: hapana

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Default: hapana

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

awsTerminologyNames

Default: hapana

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

awsParallelDataNames

Default: hapana

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

googleApiKey

Default: hapana

Google Cloud API kiyi. Ipa izvi kana googleCredentials google. Pfuura kuburikidza secrets.

googleCredentials

Default: hapana

Google Cloud Service-account kiyi seJSON tambo. Ipa izvi kana googleApiKey google. Pfuura kuburikidza secrets.

googleProjectId

Default: hapana

Optional Google Cloud project id. Kazhinji inotorwa kubva kuaccount yebasa.

googleModel

Default: hapana

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

googleApiEndpoint

Default: hapana

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Default: hapana

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

Common optional inputs

region

Default: hapana

Translator resource region (omit for global resources).

toLocales

Default: Zvese zvinotsigirwa

Nzvimbo dzekushandura. Inogamuchira JSON array (["fr","de"]) kana makoma-akaparadzaniswa kukosha.

include

Default: hapana

Newline-yakaparadzaniswa glob mapatani; Zvinyorwa zvinowirirana chete ndizvo zvinoshandurwa.

exclude

Default: hapana

Newline-yakaparadzaniswa glob mapatani; Zvinyorwa zvinowirirana zvinosvetuka (zvinoshandiswa mushure mekusanganisira).

configPath

Default: .github/resource-translator.yml

Dzvanya bhatani rekumisikidza faira (inoenderana nenzvimbo yebasa rekushandira).

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

Paunenge true, mhanya shanduro uye kuburitsa pfupiso asi usanyora mafaera.

failOnError

Default: true

Kana true, zvikanganiso zvisingatarisirwi zvinokundikana chiito; Kana false, zvikanganiso zvinonyevera.

Azure Translator request inputs

Aya mepu akananga kuAzure AI Muturikiri v3 mubvunzo parameter uye anoshanda kune mupi weazure. textType uye kutuka zvinoitwawo kuAWS / Google uko kwakaenzana kuripo (ona gwara revanopa); Zvimwe zvese ndezveAzure-chete. Imwe neimwe inosarudzika; Zvikanganiso zvemushanduri zvinoshanda kana zvisina kugadziriswa.

categoryId

Default: general

Azure Custom Translator category — the industry/domain/tone knob. Yakatumirwa seyakagadziridzwa ?category=....

textType

Default: plain

plain kana html. Shandisa html chete kana zviwanikwa zvako zviwanikwa zviri zvechokwadi HTML zvidimbu.

profanityAction

Default: NoAction

NoAction, Marked, kana Deleted. Tarisa uone kuti mazwi akashata anoburitswa sei mushanduro.

profanityMarker

Default: Asterisk

Asterisk kana Tag. Izvo zvinongoreva chete kana profanityAction iri Marked.

allowFallback

Default: true (Translator default)

Kana false, Muturikiri anodzorera chikanganiso pane kudzokera kuhurongwa hwese kana categoryId rako risina kutumirwa kwenzvimbo yakanangwa.

apiVersion

Default: 3.0

Translator REST API version.

Resilience & placeholder protection

Izvi zvinopindirana zvinodzora kuti chiito chinozvibata sei kana Muturikiri achidzivirira chikumbiro chako uye kuti chinodzivirira sei zviratidzo zvenzvimbo senge {{name}} kana {0} kubva pakukanganiswa panguva yekushandura.

maxRetries

Default: 5

● Yakanyanya kuedza kuedza pane yenguva pfupi HTTP mhinduro (408, 425, 429, 500, 502, 503, 504). Nhamba yakazara yeHTTP kufona pachikumbiro 1 + maxRetries.

retryBackoffMs

Default: 30000

Cap (mumamirisekondi) pane chero imwechete backoff kurara. Chiito chinokudza Azure's Retry-After mhinduro header chaizvo kana iripo; zvikasadaro, inoshandisa jittered exponential backoff yakavharwa pakukosha uku.

protectPlaceholders

Default: true

Kana true (default), placeholders senge {{name}}, ${var}, {0}, {0:N2}, %s, %1$s uye HTML masangano anotsiviwa nezviratidzo zvesentinel zvisati zvashandurwa uye kudzoreredzwa mushure. Disable only when your source intentionally contains chaiyo placeholder-shaped text that should be translated.

customPlaceholderPatterns

Default: hapana

Newline-yakaparadzaniswa regexes (isina delimiters) yakawedzerwa kune yakasarudzika placeholder seti, semuenzaniso <<.+?>> yetsika chiratidzo syntax.

noTranslatePatterns

Default: hapana

Newline-yakaparadzaniswa glob mapatani anoenderana neparser-level makiyi (JSON dotted nzira, RESX name, PO msgid, XLIFF unit id, INI / restext kiyi). Makiyi anowirirana anodonhedzwa kubva kuchikumbiro cheMushanduri uye anopfuura nekukosha kwavo kunobva kwakachengetedzwa.

Zvibuda

summary-title

Pfupiso yePR-musoro-inoshamwaridzika pfupiso, semuenzaniso Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown pfupiso yakakodzera kune PR muviri kana pfupiso yebasa.

has-new-translations

'true' kana imwe kana dzakawanda shanduro itsva dzakagadzirwa.