Cov tswv yim & tso zis · Tus Neeg Txhais Lus Resource

Saib Kev teeb tsa rau YAML schema thiab kev txiav txim thau khoom.

Yuav tsum tau tawm tswv yim

sourceLocale

Qhov chaw hauv zos (piv txwv li en) siv los nrhiav cov ntaub ntawv peev txheej xws li **/*.en.resx. Kuj xa mus rau tus neeg zov me nyuam raws li from=<locale>.

Kev xaiv tus neeg zov me nyuam & cov ntawv pov thawj

Xaiv ib tus neeg muab kev pab rau ib qho kev khiav nrog provider. Muab cov ntawv pov thawj ntawm tus neeg zov me nyuam xaiv nkaus xwb — saib daim ntawv qhia Cov tswv yim & tso zis rau kev teeb tsa tag nrho.

provider

Lub neej ntawd: azure

Tus neeg muab kev txhais lus: azure (default), aws, los yog google. Tsuas siv ib tus neeg zov me nyuam rau ib qho kev hu xov tooj xwb.

subscriptionKey

Lub neej ntawd: tsis muaj

Azure AI Translator subscription yuam sij. Yuav tsum tau azure. Dhau los ntawm secrets.

endpoint

Lub neej ntawd: tsis muaj

Azure Translator endpoint URL, piv txwv li https://api.cognitive.microsofttranslator.com/. Yuav tsum tau azure.

awsAccessKeyId

Lub neej ntawd: tsis muaj

AWS nkag mus rau tus ID tseem ceeb Yeem — tshem tawm (nrog awsSecretAccessKey) los siv AWS lub neej ntawd daim ntawv pov thawj saw / OIDC. Dhau los ntawm secrets.

awsSecretAccessKey

Lub neej ntawd: tsis muaj

AWS zais cia nkag yuam sij. Yuav tsum tau muab ua ke nrog awsAccessKeyId. Dhau los ntawm secrets.

awsSessionToken

Lub neej ntawd: tsis muaj

Yeem AWS kev sib kho token rau cov ntawv pov thawj ib ntus. Dhau los ntawm secrets.

awsRegion

Lub neej ntawd: tsis muaj

AWS cheeb tsam rau Kev Txhais Lus (piv txwv li us-east-1). Yuav tsum tau aws tshwj tsis yog AWS_REGION teeb tsa hauv ib puag ncig.

awsFormality

Lub neej ntawd: tsis muaj

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Lub neej ntawd: tsis muaj

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

awsTerminologyNames

Lub neej ntawd: tsis muaj

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

awsParallelDataNames

Lub neej ntawd: tsis muaj

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

googleApiKey

Lub neej ntawd: tsis muaj

Google Cloud API tus yuam sij. Muab qhov no LOS YOG googleCredentials rau google. Dhau los ntawm secrets.

googleCredentials

Lub neej ntawd: tsis muaj

Google Huab kev pabcuam-account tus yuam sij raws li JSON hlua. Muab qhov no LOS YOG googleApiKey rau google. Dhau los ntawm secrets.

googleProjectId

Lub neej ntawd: tsis muaj

Yeem Google Cloud project id. Feem ntau inferred los ntawm cov kev pabcuam-account daim ntawv pov thawj.

googleModel

Lub neej ntawd: tsis muaj

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

googleApiEndpoint

Lub neej ntawd: tsis muaj

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Lub neej ntawd: tsis muaj

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

Cov tswv yim xaiv feem ntau

region

Lub neej ntawd: tsis muaj

Txhais lus resource cheeb tsam (omit rau cov peev txheej thoob ntiaj teb).

toLocales

Lub neej ntawd: tag nrho cov kev txhawb nqa

Locales los txhais rau. Txais JSON array (["fr","de"]) los yog comma-cais qhov tseem ceeb.

include

Lub neej ntawd: tsis muaj

Newline-cais glob qauv; Tsuas yog cov ntaub ntawv sib txuam yog txhais.

exclude

Lub neej ntawd: tsis muaj

Newline-cais glob qauv; Cov ntaub ntawv sib txuam yog hla (thov tom qab suav nrog).

configPath

Lub neej ntawd: .github/resource-translator.yml

Txoj kev mus rau YAML config cov ntaub ntawv (txheeb ze rau lub hauv paus chaw ua haujlwm).

changeDetection

Lub neej ntawd: 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

Lub neej ntawd: .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

Lub neej ntawd: 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

Lub neej ntawd: false

Thaum true, khiav translations thiab emit summaries tab sis tsis txhob sau cov ntaub ntawv.

failOnError

Lub neej ntawd: true

Thaum true, qhov yuam kev tsis tau npaj siab ua tsis tiav qhov kev ua; Thaum false, yuam kev yog ceeb toom.

Azure Translator thov inputs

Cov ntawv qhia no ncaj qha rau Azure AI Translator v3 query parameter thiab thov rau azure tus muab kev pab. textType thiab profanityAction kuj tau mapped rau AWS / Google qhov twg muaj qhov sib npaug (saib cov lus qhia ntawm cov chaw muab kev pab); tus so yog Azure nkaus xwb. Txhua tus yog xaiv tau; lub Txhais lus defaults siv thaum unset.

categoryId

Lub neej ntawd: general

Azure Custom Translator qeb — kev lag luam / domain / tone pob khawm Forwarded raws li ?category=....

textType

Lub neej ntawd: plain

plain los yog html. Siv html tsuas yog thaum koj cov peev txheej muaj nuj nqis yog HTML tawg tiag tiag.

profanityAction

Lub neej ntawd: NoAction

NoAction, Marked, lossis Deleted. Tswj yuav ua li cas cov lus tsis zoo yog tso tawm hauv kev txhais lus.

profanityMarker

Lub neej ntawd: Asterisk

Asterisk los yog Tag. Tsuas yog muaj txiaj ntsig thaum profanityAction yog Marked.

allowFallback

Lub neej ntawd: muaj tseeb (Tus neeg txhais lus lub neej ntawd)

Thaum false, Tus Neeg Txhais Lus rov qab ib qho yuam kev es tsis txhob poob rov qab mus rau qhov system dav dav yog tias koj lub categoryId tsis muaj kev xa tawm rau lub hom phiaj hauv zos.

apiVersion

Lub neej ntawd: 3.0

Tus neeg txhais lus REST API version.

Resilience & placeholder tiv thaiv

Cov tswv yim no tswj hwm yuav ua li cas qhov kev txiav txim thaum Lub Tshuab Txhais Lus throttles koj qhov kev thov thiab yuav ua li cas nws shields placeholder tokens xws li {{name}} los yog {0} los ntawm raug mangled thaum lub sij hawm txhais lus.

maxRetries

Lub neej ntawd: 5

Qhov siab tshaj plaws rov sim ntawm cov lus teb HTTP ib ntus (408, 425, 429, 500, 502, 503, 504). Tag nrho cov naj npawb ntawm HTTP hu rau ib qho kev thov yog 1 + maxRetries.

retryBackoffMs

Lub neej ntawd: 30000

Cap (hauv milliseconds) ntawm ib qho kev pw tsaug zog rov qab. Qhov kev nqis tes ua hwm Azure lub Retry-After teb header raws nraim thaum muaj; txwv tsis pub nws siv jittered exponential backoff capped ntawm tus nqi no.

protectPlaceholders

Lub neej ntawd: true

Thaum true (lub neej ntawd), qhov chaw xws li {{name}}, ${var}, {0}, {0:N2}, %s, %1$s thiab HTML cov chaw raug hloov nrog sentinel tokens ua ntej txhais lus thiab rov qab kho tom qab. Lov tes taw tsuas yog thaum koj qhov chaw txhob txwm muaj cov ntawv nyeem literal placeholder uas yuav tsum tau txhais.

customPlaceholderPatterns

Lub neej ntawd: tsis muaj

Newline-cais regexes (tsis muaj delimiters) ntxiv rau lub neej ntawd placeholder teeb, piv txwv li <<.+?>> rau kev cai token syntax.

noTranslatePatterns

Lub neej ntawd: tsis muaj

Newline-cais glob qauv sib phim tiv thaiv parser-theem yuam sij (JSON dotted path, RESX name, PO msgid, XLIFF chav tsev id, INI/restext yuam sij). Cov yuam sij sib txuam yog poob los ntawm tus neeg txhais lus thov thiab dhau los ntawm lawv qhov chaw tus nqi khaws cia.

Cov zis

summary-title

Luv luv PR-title-phooj ywg ntsiab lus, piv txwv li Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown ntsiab lus haum rau PR lub cev lossis cov ntsiab lus ntawm txoj haujlwm.

has-new-translations

'true' thaum ib lossis ntau dua cov lus txhais tshiab tau tsim.