In- och utgångar · Resursöversättare

Se Konfiguration för YAML-schemat och laddningsordningen.

Nödvändiga indata

sourceLocale

Källplats (t.ex. en) som används för att hitta resursfiler som **/*.en.resx. Vidarebefordrade även till vårdgivaren som from=<locale>.

Val av leverantör och meriter

Välj en leverantör per runda med provider. Lämna endast den valda leverantörens inloggningsuppgifter – se In- och utgångar-guiden för fullständig installation.

provider

Standard: azure

Översättningsleverantör: azure (standard), aws eller google. Endast en leverantör används per åtgärdssamtal.

subscriptionKey

Standard: Inga

Azure AI Translator subscription key. Obligatoriskt för azure. Passera via secrets.

endpoint

Standard: Inga

Azure Translator endpoint URL, t.ex. https://api.cognitive.microsofttranslator.com/. Obligatoriskt för azure.

awsAccessKeyId

Standard: Inga

AWS access key-id. Valfritt — utelämna (med awsSecretAccessKey) för att använda AWS standardbehörighetskedja / OIDC. Passera via secrets.

awsSecretAccessKey

Standard: Inga

AWS hemlig åtkomstnyckel. Måste tillhandahållas tillsammans med awsAccessKeyId. Passera via secrets.

awsSessionToken

Standard: Inga

Valfri AWS-sessionstoken för tillfälliga inloggningsuppgifter. Passera via secrets.

awsRegion

Standard: Inga

AWS-region för Translate-tjänsten (t.ex. us-east-1). Obligatoriskt för aws om inte AWS_REGION utspelar sig i miljön.

awsFormality

Standard: Inga

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Standard: Inga

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

awsTerminologyNames

Standard: Inga

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

awsParallelDataNames

Standard: Inga

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

googleApiKey

Standard: Inga

Google Cloud API-nyckel. Tillhandahåll detta ELLER googleCredentials för google. Passera via secrets.

googleCredentials

Standard: Inga

Google Cloud-tjänstekontonyckel som en JSON-sträng. Tillhandahåll detta ELLER googleApiKey för google. Passera via secrets.

googleProjectId

Standard: Inga

Valfritt Google Cloud-projekt-id. Vanligtvis härleds det från tjänstekontots legitimation.

googleModel

Standard: Inga

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

googleApiEndpoint

Standard: Inga

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Standard: Inga

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

Vanliga valfria ingångar

region

Standard: Inga

Översättarresursregion (utelämnas för globala resurser).

toLocales

Standard: Alla stöds

Platser att översätta till. Accepterar en JSON-array (["fr","de"]) eller kommaseparerade värden.

include

Standard: Inga

nylinjeseparerade globmönster; endast matchande filer översätts.

exclude

Standard: Inga

nylinjeseparerade globmönster; Matchningsfiler hoppas över (tillämpas efter include).

configPath

Standard: .github/resource-translator.yml

Väg till YAML-konfigurationsfilen (relativt arbetsytans rot).

changeDetection

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

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

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

Standard: false

När true, kör översättningar och generera sammanfattningar men skriv inte filer.

failOnError

Standard: true

När true oväntade fel misslyckas med åtgärden; När false är fel varningar.

Azure Translator request inputs

Dessa mappas direkt till Azure AI Translator v3-frågeparametrar och tillämpas på Azure-leverantören. textType och ProfanityAction mappas också till AWS/Google där en motsvarighet finns (se leverantörsguiden); resten är endast Azure. Varje är valfri; översättarens standardinställningar gäller när de inte är inställda.

categoryId

Standard: general

Azure Custom Translator kategori — bransch-/domän-/tonratten. Vidarebefordrat som ?category=....

textType

Standard: plain

plain eller html. Använd html endast när dina resursvärden är riktiga HTML-fragment.

profanityAction

Standard: NoAction

NoAction, Marked eller Deleted. Styr hur grova termer används i översättningar.

profanityMarker

Standard: Asterisk

Asterisk eller Tag. Endast meningsfullt när profanityAction är Marked.

allowFallback

Standard: true (Översättarens standard)

När false returnerar Translator ett fel istället för att falla tillbaka på det allmänna systemet om din categoryId inte har någon distribution för en målplats.

apiVersion

Standard: 3.0

Translator REST API-version.

Motståndskraft och ersättningsskydd

Dessa inmatningar styr hur handlingen beter sig när Translator stryper din begäran och hur den skyddar platshållartokens som {{name}} eller {0} från att bli förstörda under översättningen.

maxRetries

Standard: 5

Maximala försök på tillfälliga HTTP-svar (408, 425, 429, 500, 502, 503, 504). Det totala antalet HTTP-anrop per förfrågan är 1 + maxRetries.

retryBackoffMs

Standard: 30000

Kondensator (i millisekunder) på vilken enskild backoff-viloläge som helst. Åtgärden hedrar Azures Retry-After svarshuvud exakt när det finns; annars använder den jitterad exponentiell backoff med ett tak på detta värde.

protectPlaceholders

Standard: true

När true (standard) ersätts platshållare som {{name}}, ${var}, {0}, {0:N2}, %s, %1$s och HTML-entiteter med sentinel-tokens före översättning och återställs efteråt. Inaktivera endast när din källa medvetet innehåller bokstavlig platshållarformad text som bör översättas.

customPlaceholderPatterns

Standard: Inga

Linjeavseparerade regexar (utan avgränsare) lades till i standardplatshållaruppsättningen, t.ex. <<.+?>> för anpassad tokensyntax.

noTranslatePatterns

Standard: Inga

Newline-separerade globmönster matchade mot parser-nivånycklar (JSON punktad väg, RESX name, PO msgid, XLIFF enhet id, INI/restext-nyckel). Matchande nycklar tas bort från översättarens begäran och skickas vidare med sitt källvärde bevarat.

Utgångar

summary-title

Kort PR-titelvänlig sammanfattning, t.ex. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Sammanfattning av markdown lämplig för en PR-organisation eller jobbsammanfattning.

has-new-translations

'true' när en eller flera nya översättningar genererades.