Insette en uitsette · Hulpbronvertaler

Sien Konfigurasie vir die YAML-skema en laaivolgorde.

Vereiste insette

sourceLocale

Bronligging (bv. en) wat gebruik word om hulpbronlêers soos **/*.en.resx te vind. Dit is ook as from=<locale> aan die verskaffer deurgestuur.

Verskafferkeuse en geloofsbriewe

Kies een verskaffer per lopie met provider. Verskaf slegs die gekose verskaffer se geloofsbriewe — sien die Insette en uitsette gids vir volledige opstelling.

provider

Verstek: azure

Vertaalverskaffer: azure (standaard), aws, of google. Slegs een verskaffer word per aksieoproep gebruik.

subscriptionKey

Verstek: Geen

Azure AI Translator subscription key. Vereis vir azure. Gaan via secrets.

endpoint

Verstek: Geen

Azure Translator endpoint URL, bv. https://api.cognitive.microsofttranslator.com/. Vereis vir azure.

awsAccessKeyId

Verstek: Geen

AWS toegangssleutel-ID. Opsioneel — laat (met awsSecretAccessKey) die gebruik van die AWS standaard geloofsbewysketting / OIDC uit. Gaan via secrets.

awsSecretAccessKey

Verstek: Geen

AWS geheime toegangssleutel. Dit moet saam met awsAccessKeyId voorsien word. Gaan via secrets.

awsSessionToken

Verstek: Geen

Opsionele AWS-sessietoken vir tydelike geloofsbriewe. Gaan via secrets.

awsRegion

Verstek: Geen

AWS-streek vir die Translate-diens (bv. us-east-1). Vereis vir aws tensy AWS_REGION in die omgewing afspeel.

awsFormality

Verstek: Geen

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Verstek: Geen

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

awsTerminologyNames

Verstek: Geen

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

awsParallelDataNames

Verstek: Geen

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

googleApiKey

Verstek: Geen

Google Cloud API-sleutel. Verskaf hierdie OF googleCredentials vir google. Gaan deur secrets.

googleCredentials

Verstek: Geen

Google Cloud diens-rekening sleutel as 'n JSON-string. Verskaf hierdie OF googleApiKey vir google. Gaan deur secrets.

googleProjectId

Verstek: Geen

Opsionele Google Cloud projek-ID. Gewoonlik afgelei uit die diensrekening-geloofsbriewe.

googleModel

Verstek: Geen

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

googleApiEndpoint

Verstek: Geen

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Verstek: Geen

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

Algemene opsionele insette

region

Verstek: Geen

Vertalerhulpbronstreek (uitlaat vir globale hulpbronne).

toLocales

Verstek: almal ondersteun

Plekke om na te vertaal. Aanvaar 'n JSON-skikking (["fr","de"]) of komma-geskeide waardes.

include

Verstek: Geen

Newline-geskeide glob-patrone; slegs ooreenstemmende lêers word vertaal.

exclude

Verstek: Geen

Newline-geskeide glob-patrone; Ooreenstemmende lêers word oorgeslaan (toegepas ná insluiting).

configPath

Verstek: .github/resource-translator.yml

Pad na die YAML-konfigurasielêer (relatief tot die werkswinkelwortel).

changeDetection

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

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

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

Verstek: false

Wanneer true, voer vertalings uit en stuur opsommings uit, maar skryf nie lêers nie.

failOnError

Verstek: true

Wanneer true, misluk onverwagte foute die aksie; Wanneer false, is foute waarskuwings.

Azure Translator request inputs

Hierdie koppel direk aan Azure AI Translator v3 navraagparameters en pas toe op die Azure-verskaffer. textType en vloekaksie word ook aan AWS/Google gekoppel waar 'n ekwivalent bestaan (sien die verskaffersgids); die res is slegs Azure. Elkeen is opsioneel; die verstekinstellings van Vertaler geld wanneer dit ontstel word.

categoryId

Verstek: general

Azure Custom Translator kategorie — die bedryf/domein/toonknoppie. Gestuur soos ?category=....

textType

Verstek: plain

plain of html. Gebruik html net wanneer jou hulpbronwaardes regte HTML-fragmente is.

profanityAction

Verstek: NoAction

NoAction, Marked, of Deleted. Beheer hoe profane terme in vertalings uitgespreek word.

profanityMarker

Verstek: Asterisk

Asterisk of Tag. Net betekenisvol wanneer profanityAction Marked is.

allowFallback

Verstek: waar (Vertaler standaard)

Wanneer false, gee Vertaler 'n fout terug in plaas daarvan om terug te val na die algemene stelsel as jou categoryId geen ontplooiing vir 'n teikenlokasie het nie.

apiVersion

Verstek: 3.0

Vertaler REST API-weergawe.

Veerkragtigheid en plaasvervangerbeskerming

Hierdie insette beheer hoe die aksie optree wanneer Vertaler jou versoek beperk en hoe dit plekhouer-tokens soos {{name}} of {0} beskerm teen verminking tydens vertaling.

maxRetries

Verstek: 5

Maksimum herpogingspogings op tydelike HTTP-antwoorde (408, 425, 429, 500, 502, 503, 504). Die totale aantal HTTP-oproepe per versoek is 1 + maxRetries.

retryBackoffMs

Verstek: 30000

Beperk (in millisekondes) op enige enkele backoff-slaap. Die aksie eer Azure se Retry-After response-kop presies wanneer dit teenwoordig is; Andersins gebruik dit 'n gejitterde eksponensiële terugslag wat by hierdie waarde gekap is.

protectPlaceholders

Verstek: true

Wanneer true (standaard), word plekhouers soos {{name}}, ${var}, {0}, {0:N2}, %s, %1$s en HTML-entiteite vervang met sentinel-tokens voor vertaling en daarna herstel. Deaktiveer slegs wanneer jou bron doelbewus letterlike plekhouer-vormige teks bevat wat vertaal moet word.

customPlaceholderPatterns

Verstek: Geen

Newline-geskeide regexe (sonder afbakeners) wat by die standaard plekhouerstel gevoeg is, bv. <<.+?>> vir pasgemaakte token-sintaksis.

noTranslatePatterns

Verstek: Geen

Newline-geskeide glob-patrone is ooreenstem met parservlak-sleutels (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext sleutel). Ooreenstemmende sleutels word uit die Vertalerversoek verwyder en deurgegee met hul bronwaarde behou.

Uitsette

summary-title

Kort PR-titel-vriendelike opsomming, bv. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown-opsomming geskik vir 'n PR-liggaam of posopsomming.

has-new-translations

'true' wanneer een of meer nuwe vertalings gegenereer is.