Entradas yéetel salidas · Traductor nu'ukulo'ob

Wil Configuración le esquema YAML yéetel le orden kuuch.

Entradas requeridas

sourceLocale

Entorno u k'aaba' (je'ebix, en) utilizado utia'al u kaxtik archivos nu'ukulo'ob bey **/*.en.resx. Xan reenviado ti' le proveedor bey from=<locale>.

Selección proveedor & credenciales

Elija jump'éel proveedor tumen corrida yéetel provider. Suministre chéen le credenciales ti' le proveedor seleccionado — Wil le náakake' u yaak'il Entradas yéetel salidas utia'al u configuración completa.

provider

Predeterminado: azure

Proveedor traducción: azure (tumen defecto), aws wa google. Chéen jump'éel proveedor ku meyajtiko'ob tumen t'aano' asab.

subscriptionKey

Predeterminado: Mixba'al

Azure AI Translator clave suscripción. K'a'abet utia'al azure. Máanen tumen secrets.

endpoint

Predeterminado: Mixba'al

URL endpoint Azure Translator, je'ebix https://api.cognitive.microsofttranslator.com/. K'a'abet utia'al azure.

awsAccessKeyId

Predeterminado: Mixba'al

Id clave muuk' AWS. Opcional — obet (yéetel awsSecretAccessKey) utia'al u utilizar le tsolokbal credenciales predeterminada AWS / OIDC. Máanen tumen secrets.

awsSecretAccessKey

Predeterminado: Mixba'al

Clave muuk' secreta AWS. K'a'ana'an u suministrado yéetel awsAccessKeyId. Máanen tumen secrets.

awsSessionToken

Predeterminado: Mixba'al

Token xoknáalo'obo' AWS opcional utia'al u credenciales temporales. Máanen secrets.

awsRegion

Predeterminado: Mixba'al

Región AWS utia'al u mayaj Translate (je'ebix, us-east-1). K'a'abet utia'al aws a menos AWS_REGION establezca ti' le jeets'.

awsFormality

Predeterminado: Mixba'al

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Predeterminado: Mixba'al

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

awsTerminologyNames

Predeterminado: Mixba'al

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

awsParallelDataNames

Predeterminado: Mixba'al

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

googleApiKey

Predeterminado: Mixba'al

Google Cloud API clave. Ts'aik le je'ela' googleCredentials google. Máanen secrets.

googleCredentials

Predeterminado: Mixba'al

Google Cloud mayaj - clave yilaje' bey juntúul cadena JSON. Ts'aik le je'ela' googleApiKey google. Máanen secrets.

googleProjectId

Predeterminado: Mixba'al

Id úuchik u Google Cloud opcional. Ba'axten lo general infiero ti' le credencial ti' le mayaj - yilaje'.

googleModel

Predeterminado: Mixba'al

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

googleApiEndpoint

Predeterminado: Mixba'al

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Predeterminado: Mixba'al

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

Entradas opcionales náats'al

region

Predeterminado: Mixba'al

Petenil nu'ukulo'ob traductores (omitir utia'al u nu'ukulo'ob globales).

toLocales

Predeterminado: tuláakal soportados

Kúuchilo'ob utia'al traducir. K'aam jump'éel matriz JSON (["fr","de"]) wa uts' k'ajóolilo'obo' separados tumen coma.

include

Predeterminado: Mixba'al

Patrones globo separado tumen Newline; Chéen le archivos coincidentes ku traducen.

exclude

Predeterminado: Mixba'al

Patrones globo separado tumen Newline; Le archivos coincidentes ku omiten (aplicado ka' incluir).

configPath

Predeterminado: .github/resource-translator.yml

Bejil ti' le archivo configuración YAML (relativo u mootsil le kúuchil meyajo'ob).

changeDetection

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

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

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

Predeterminado: false

Le ken true, ejecutar traducciones yéetel emitir resúmenes Ba'ale' ma' escriba archivos.

failOnError

Predeterminado: true

Le ken true, errores inesperados fallan le asab; Le ken false, errores ku advertencias.

Azure Translator request inputs

Táan a mapas Jun ti' le parámetros consulta Azure AI Translator v3 yéetel aplicar ti' le proveedor Azure. textType yéetel profanityAction xan mapeados ti' AWS leti' Google tu'ux yaan jump'éel equivalente (wil le náakake' u yaak'il ti' le Proveers); u yala'ab chéen Azure. Láaj le opcional; le Traductor tumen defecto ku aplican ken u desestablecidos.

categoryId

Predeterminado: general

Azure Custom Translator category — the industry/domain/tone knob. Ts'a'abal ?category=....

textType

Predeterminado: plain

plain wa html. Meyaj html chéen ken u uts' k'ajóolilo'obo' nu'ukulo'ob ku fragmentos HTML reales.

profanityAction

Predeterminado: NoAction

NoAction, Marked wa Deleted. Controla bix u emiten términos profanos ti' traducciones.

profanityMarker

Predeterminado: Asterisk

Asterisk wa Tag. Chéen ba'ax profanityAction Marked.

allowFallback

Predeterminado: verdadero (Traductor tumen defecto)

Le ken false, Traductor ku jump'éel ba'alo' kúuchil k'a'atik le yaan tuláakal wa u categoryId mina'an despliegue utia'al jump'éel kúuchil destino.

apiVersion

Predeterminado: 3.0

Versión API REST u traductor.

Resiliencia & Protección le marcador kúuchil

Táan a entradas controlan bix u comporta le molayil ken Translator limita u solicitud yéetel bix protege le fichas marcadores bey {{name}} wa {0} utia'al u destrozado ichil le traducción.

maxRetries

Predeterminado: 5

Máximo intentos reintento ti' respuestas HTTP transitorias (408, 425, 429, 500, 502, 503, 504). Le meyaj ku total u llamadas HTTP tumen j-na'akij jach 1 + maxRetries.

retryBackoffMs

Predeterminado: 30000

Tapón (ti' milisegundos) ti' je'el ba'ax chéen backoff weenel. Le molayil honra le Retry-After pool núukik Azure exactamente ka presente; Ti' contrario meyajtiko'ob jump'éel retiro exponencial jittered limitado ti' le je'o'.

protectPlaceholders

Predeterminado: true

Le ken true (predeterminado), le marcadores u posición bey {{name}}, ${var}, {0}, {0:N2}, %s, %1$s yéetel HTML ku reemplazan tumen fichas centinela bey ma' u traducción yéetel restauradas ts'o'okole'. Desactivar chéen ken u fuente intencionadamente ku taasik analte'o' literal bix u marcador lugar ba'ax k'a'ana'an traducir.

customPlaceholderPatterns

Predeterminado: Mixba'al

Regexes separados tumen Newline (xma' delimitadores) añadidos ti' le conjunto marcador posición predeterminado, je'ebix, <<.+?>> utia'al u sintaxis token personalizada.

noTranslatePatterns

Predeterminado: Mixba'al

Patrones globo separado tumen Newline coincidieron xu'ullsa'al teclas nivel analizador (bejil punteado JSON, name RESX, msgid PO, unidad XLIFF id, clave INI leti' restext). Le claves coincidentes ku sueltan ti' le solicitud Traductor yéetel yúuchul yéetel u je'o' fuente preservada.

Salidas

summary-title

Breve resumen u k'o'ojo'ob le PR, je'ebix, Machine-translated 320 files, a total of 5,418 translations.

summary-details

Resumen Markdown adecuado utia'al jump'éel wíinkilal PR wa resumen meyaj.

has-new-translations

'true' ka ku generaron jump'éel wa asab túumben traducciones.