Inputs & outputs · Maʻuʻanga Tokoni Liliu lea

Vakai ki he Fokotuʻutuʻu ki he schema ʻo e YAML mo e loading order.

Ngaahi meʻa ʻoku fie maʻu

sourceLocale

ʻOku fakaʻaongaʻi ʻa e feituʻu maʻuʻanga tokoni (e.g. en) ke kumi ʻa e ngaahi faile ʻo e maʻuʻanga tokoni hange ko e **/*.en.resx. Naʻe toe ʻave foki ki he kautaha ko e from=<locale>.

Fili ʻo e kautaha mo e ngaahi tohi fakamoʻoni

Fili ha kautaha ʻe taha ʻi he lele ʻa e provider. ʻOatu pe ʻa e ngaahi tohi fakamoʻoni ʻa e kautaha kuo fili — vakai ki he fakahinohino ki he Inputs & outputs ki hono fokotuʻutuʻu kakato.

provider

Default: azure

Tokotaha ʻoku nau maʻu ʻa e liliu: azure (default), aws, pe google. Ko e kautaha pe ʻe taha ʻoku fakaʻaongaʻi ʻi he uiuiʻi ngaue.

subscriptionKey

Default: ʻikai ha taha

Azure AI Translator subscription key. Fie maʻu ki he azure. Fou atu ʻi he secrets.

endpoint

Default: ʻikai ha taha

Azure Translator endpoint URL, e.g. https://api.cognitive.microsofttranslator.com/. Fiemaʻu ki he azure.

awsAccessKeyId

Default: ʻikai ha taha

AWS access key id. Fili — toʻo (mo e awsSecretAccessKey) ke fakaʻaongaʻi ʻa e AWS default credential chain / OIDC. Fou atu ʻi he secrets.

awsSecretAccessKey

Default: ʻikai ha taha

AWS secret access key. Kuo pau ke ʻomai fakataha mo e awsAccessKeyId. Fou atu ʻi he secrets.

awsSessionToken

Default: ʻikai ha taha

Fili ʻa e AWS session token ki he ngaahi tohi fakamoʻoni fakataimi. Paasi ʻi he secrets.

awsRegion

Default: ʻikai ha taha

Vahefonua AWS ki he ngaue Liliu (e.g. us-east-1). Fie maʻu ki he aws tukukehe kapau ʻoku fokotuʻu AWS_REGION ʻi he ʻatakai.

awsFormality

Default: ʻikai ha taha

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Default: ʻikai ha taha

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

awsTerminologyNames

Default: ʻikai ha taha

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

awsParallelDataNames

Default: ʻikai ha taha

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

googleApiKey

Default: ʻikai ha taha

Google Cloud API key. ʻOange ʻa e googleCredentials PE ko ʻeni ki he google. Fou atu ʻi he secrets.

googleCredentials

Default: ʻikai ha taha

Google Cloud service-account key as a JSON string. ʻOange ʻa e googleApiKey PE ko ʻeni ki he google. Fou atu ʻi he secrets.

googleProjectId

Default: ʻikai ha taha

Fili pe ʻa e Google Cloud project id. ʻOku faʻa fakaʻaongaʻi ia mei he tohi fakamoʻoni ʻo e ʻakauni ngaue.

googleModel

Default: ʻikai ha taha

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

googleApiEndpoint

Default: ʻikai ha taha

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Default: ʻikai ha taha

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

Ngaahi meʻa angamaheni ʻoku fili ke fakahu

region

Default: ʻikai ha taha

Vahefonua maʻuʻanga tokoni ʻa e tokotaha liliu lea (toʻo ki he ngaahi maʻuʻanga tokoni fakaemamani lahi).

toLocales

Default: poupouʻi kotoa

Ngaahi feituʻu ke liliu ki ai. Tali ha fokotuʻutuʻu JSON (["fr","de"]) pe ngaahi tuʻunga ʻulungaanga mahuʻinga ʻoku fakamavahevaheʻi ʻe he koma.

include

Default: ʻikai ha taha

Ngaahi sipinga ʻo e glob ʻoku fakamavahevaheʻi ʻe he laine foʻou; ko e ngaahi faile tatau pe ʻoku liliu.

exclude

Default: ʻikai ha taha

Ngaahi sipinga ʻo e glob ʻoku fakamavahevaheʻi ʻe he laine foʻou; ʻOku hiki fakalaka ʻa e ngaahi faile ʻoku fakatauhoa (fakaʻaongaʻi hili hono fakakau mai).

configPath

Default: .github/resource-translator.yml

Hala ki he faile config ʻo e YAML (fekauʻaki mo e root ʻo e workspace).

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

ʻI he taimi ʻoku true ai, fakalele ʻa e ngaahi liliu lea pea ʻoatu ha ngaahi fakamatala fakanounou kae ʻoua naʻa ke hiki ha ngaahi faile.

failOnError

Default: true

ʻI he taimi ʻoku true ai, ʻoku ʻikai lava ke fai ha ngaahi fehalaaki taʻeʻamanekina; ʻI he taimi ʻoku false ai, ko e ngaahi fehalaaki ko ha ngaahi fakatokanga.

Azure Translator request inputs

ʻOku mape fakahangatonu ʻeni ki he Azure AI Translator v3 query parameters pea fakaʻaongaʻi ki he azure provider. ʻOku toe mape foki ʻa e textType mo e kapekapeʻi ki he AWS/Google ʻi he feituʻu ʻoku ʻi ai ha tatau (vakai ki he fakahinohino ʻa e ngaahi kautaha tokoni); ko e toenga ko e Azure pe. ʻOku fili pe ʻa e meʻa kotoa pe; ʻoku fakaʻaongaʻi ʻa e default ʻa e Translator ʻi he taimi ʻoku ʻikai seti ai.

categoryId

Default: general

Azure Custom Translator kulupu — ko e ngaueʻanga/domain/tone knob. ʻAve ko e ?category=....

textType

Default: plain

plain pe html. Fakaʻaongaʻi pe ʻhtml ʻi he taimi ʻoku hoko ai hoʻo ngaahi maʻuʻanga tokoni ko ha ngaahi kongokonga HTML moʻoni.

profanityAction

Default: NoAction

NoAction, Marked, pe Deleted. Puleʻi ʻa e founga ʻoku tuku atu ai ʻa e ngaahi lea kapekape ʻi he ngaahi liliu.

profanityMarker

Default: Asterisk

Asterisk pe Tag. ʻOku toki mahuʻingamalie pe ʻi he taimi ʻoku Marked ai profanityAction.

allowFallback

Default: true (Translator default)

ʻI he taimi ʻoku false ai, ʻoku fakafoki mai ʻe he Translator ha fehalaaki kae ʻikai foki ki he polokalama fakalukufua kapau ʻoku ʻikai ke ʻi ai ha deployment ʻi hoʻo categoryId ki ha feituʻu ʻoku fakataumuʻa ki ai.

apiVersion

Default: 3.0

Liliu lea REST API version.

Resilience & placeholder maluʻi

ʻOku puleʻi ʻe he ngaahi input ko ʻeni ʻa e anga ʻo e ngaue ʻi he taimi ʻoku taʻofi ai ʻe he Translator hoʻo kole mo e founga ʻoku ne maluʻi ai ʻa e ngaahi fakaʻilonga placeholder hange ko e {{name}} pe {0} mei hono fakaʻauha lolotonga ʻa e liliu.

maxRetries

Default: 5

Lahi taha ʻo e ngaahi feinga ke toe feinga ʻi he ngaahi tali HTTP fakataimi (408, 425, 429, 500, 502, 503, 504). Ko e lahi fakakatoa ʻo e ngaahi telefoni HTTP ʻi he kole ʻoku 1 + maxRetries.

retryBackoffMs

Default: 30000

Tataʻo (ʻi he milliseconds) ʻi ha faʻahinga mohe pe ʻe taha. ʻOku fakaʻapaʻapaʻi ʻe he ngaue ʻa e ʻuluʻi fakamatala ʻo e tali ʻa e Retry-After ʻo e Azure ʻi he taimi ʻoku ʻi ai ai; ka ʻikai, ʻoku ne fakaʻaongaʻi ʻa e jittered exponential backoff ʻoku fakangatangata ʻi he tuʻunga mahuʻinga ko ʻeni.

protectPlaceholders

Default: true

ʻI he taimi ʻoku true ai (default), ʻoku fetongi ʻa e placeholders hange ko e {{name}}, ${var}, {0}, {0:N2}, %s, %1$s mo e HTML ʻaki ʻa e ngaahi fakaʻilonga sentinel kimuʻa pea toki liliu pea toe fakafoki mai ʻamui. Tamateʻi pe ʻi he taimi ʻoku ʻi ai ha fakamatala ʻoku totonu ke liliu ʻi hoʻo maʻuʻanga tokoni.

customPlaceholderPatterns

Default: ʻikai ha taha

Newline-separated regexes (without delimiters) added to the default placeholder set, e.g. <<.+?>> for custom token syntax.

noTranslatePatterns

Default: ʻikai ha taha

ʻOku fakafehoanaki ʻa e ngaahi sipinga ʻo e glob ʻi he laine foʻou mo e ngaahi ki ʻi he tuʻunga ʻo e parser (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). ʻOku toʻo ʻa e ngaahi ki ʻoku hoa mei he kole ʻa e Tokotaha Liliu Lea pea ʻoku fakatolonga pe ʻa e mahuʻinga ʻo e maʻuʻanga tokoni.

Ngaahi meʻa ʻoku maʻu

summary-title

Nounou ʻo e PR-title-friendly summary, e.g. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Fakamatala fakanounou ʻo e Markdown ʻoku feʻunga mo ha sino PR pe fakamatala fakanounou ʻo e ngaue.

has-new-translations

'true' taimi naʻe faʻu ai ha liliu foʻou ʻe taha pe lahi ange.