Tulot ja lähtöt · Resurssikääntäjä

Katso Kokoonpano YAML-skeemasta ja latausjärjestyksestä.

Vaaditut syötteet

sourceLocale

Lähdepaikka (esim. en), jota käytetään resurssitiedostojen, kuten **/*.en.resx, löytämiseen. Lähetetään myös palveluntarjoajalle from=<locale>.

Palveluntarjoajan valinta ja pätevyydet

Valitse yksi operaattori per käyttökerta provider:n kanssa. Toimita vain valitun palveluntarjoajan tunnukset — katso Tulot ja lähtöt-opas täydellistä asennusta varten.

provider

Oletus: azure

Käännöspalveluntarjoaja: azure (oletus), aws tai google. Yksi operaattori on käytössä per toimintakutsu.

subscriptionKey

Oletus: ei mikään

Azure AI Translator -tilausavain. Vaaditaan azure. Kulje secrets kautta.

endpoint

Oletus: ei mikään

Azure Translator endpoint URL, esim. https://api.cognitive.microsofttranslator.com/. Vaaditaan azure.

awsAccessKeyId

Oletus: ei mikään

AWS:n pääsyavaimen tunnus. Valinnainen — jätä (awsSecretAccessKey) pois AWS:n oletustunnisteketjun / OIDC:n käytöstä. Kulje secrets kautta.

awsSecretAccessKey

Oletus: ei mikään

AWS:n salainen pääsyavain. Se täytyy toimittaa yhdessä awsAccessKeyId kanssa. Kulje secrets kautta.

awsSessionToken

Oletus: ei mikään

Valinnainen AWS-istuntotunnus väliaikaisille tunnuksille. Kulje secrets kautta.

awsRegion

Oletus: ei mikään

AWS-alue Translate-palvelulle (esim. us-east-1). Vaaditaan aws, ellei AWS_REGION ole asetettu ympäristöön.

awsFormality

Oletus: ei mikään

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Oletus: ei mikään

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

awsTerminologyNames

Oletus: ei mikään

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

awsParallelDataNames

Oletus: ei mikään

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

googleApiKey

Oletus: ei mikään

Google Cloud API -avain. Anna tämä OR googleCredentials google. Kulje secrets kautta.

googleCredentials

Oletus: ei mikään

Google Cloud -palvelun tiliavain JSON-merkkijonona. Anna tämä OR googleApiKey google. Kulje secrets kautta.

googleProjectId

Oletus: ei mikään

Valinnainen Google Cloud Project ID. Yleensä päätellen palvelutilin tunnuksesta.

googleModel

Oletus: ei mikään

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

googleApiEndpoint

Oletus: ei mikään

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Oletus: ei mikään

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

Yleiset valinnaiset syötteet

region

Oletus: ei mikään

Kääntäjäresurssialue (jätä globaalit resurssit pois).

toLocales

Oletus: kaikki tukivat

Paikat, joihin kannattaa kääntää. Hyväksyy JSON-taulukon (["fr","de"]) tai pilkulla eroteltujen arvojen.

include

Oletus: ei mikään

Newline-eroteltuja pallokuvioita; Vain vastaavat tiedostot käännetään.

exclude

Oletus: ei mikään

Newline-eroteltuja pallokuvioita; Vastaavat tiedostot ohitetaan (sovelletaan include-toiminnon jälkeen).

configPath

Oletus: .github/resource-translator.yml

Polku YAML-konfiguraatiotiedostoon (suhteessa työtilan juureen).

changeDetection

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

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

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

Oletus: false

Kun true, suorita käännökset ja lähetä yhteenvetoja, mutta älä kirjoita tiedostoja.

failOnError

Oletus: true

Kun true, odottamattomat virheet epäonnistuvat toiminnassa; Kun false, virheet ovat varoituksia.

Azure Translator request inputs

Nämä liittyvät suoraan Azure AI Translator v3 -kyselyparametreihin ja koskevat Azure-palveluntarjoajaa. textType ja profanityAction on myös yhdistetty AWS/Googleen, missä vastaava on olemassa (katso palveluntarjoajan opas); loput ovat vain Azure-laitteita. Jokainen niistä on vapaaehtoinen; Kääntäjän oletusasetukset pätevät, kun ne ovat pois asetuksista.

categoryId

Oletus: general

Azure Custom Translator category — industry/domain/tone nnob. Lähetetty ?category=....

textType

Oletus: plain

plain tai html. Käytä html vain silloin, kun resurssiarvosi ovat oikeita HTML-fragmentteja.

profanityAction

Oletus: NoAction

NoAction, Marked tai Deleted. Se säätelee, miten kirosanoja esitetään käännöksissä.

profanityMarker

Oletus: Asterisk

Asterisk tai Tag. Merkityksellinen vain silloin, kun profanityAction on Marked.

allowFallback

Oletus: true (Kääntäjän oletus)

Kun false, kääntäjä palauttaa virheen sen sijaan, että palaisi yleiseen järjestelmään, jos categoryId ei ole lainkaan käyttöönottoa kohdealueelle.

apiVersion

Oletus: 3.0

Kääntäjä REST API -versio.

Resilienssi ja paikkamerkkisuojaus

Nämä syötteet ohjaavat, miten toiminto käyttäytyy, kun Kääntäjä rajoittaa pyyntöäsi, ja miten se suojaa väliaikaisia tokeneita, kuten {{name}} tai {0}, kääntymisen aikana.

maxRetries

Oletus: 5

Suurin uusintayritys tilapäisille HTTP-vastauksille (408, 425, 429, 500, 502, 503, 504). HTTP-kutsujen kokonaismäärä per pyyntö on 1 + maxRetries.

retryBackoffMs

Oletus: 30000

Rajoitus (millisekunneissa) mille tahansa yksittäiselle backoff-unelle. Toiminto kunnioittaa Azuren Retry-After vastausotsikkoa täsmälleen silloin, kun se on läsnä; muussa tapauksessa käytetään tärisevää eksponentiaalista peruutusta, joka on rajattu tähän arvoon.

protectPlaceholders

Oletus: true

Kun true (oletus), paikkamerkit kuten {{name}}, ${var}, {0}, {0:N2}, %s, %1$s ja HTML korvataan sentinel-tokeneilla ennen kääntämistä ja palautetaan sen jälkeen. Poista käytöstä vain, jos lähteessäsi on tarkoituksella kirjaimellista paikkamerkkimuotoista tekstiä, joka tulisi kääntää.

customPlaceholderPatterns

Oletus: ei mikään

Newline-erotetut regexit (ilman erottajia) lisättiin oletuspaikkamerkkijoukkoon, esim. <<.+?>> mukautetulle token-syntaksille.

noTranslatePatterns

Oletus: ei mikään

Newline-erotetut glob-kuviot sopivat jäsentämistason avaimiin (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext-avain). Sovittavat avaimet pudotetaan Translator-pyynnöstä ja ne kulkevat läpi lähdearvonsa säilyttäen.

Tulokset

summary-title

Lyhyt, PR-otsikolle sopiva yhteenveto, esim. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown-yhteenveto, joka sopii PR-elimelle tai työn yhteenvetoon.

has-new-translations

'true' kun yksi tai useampi uusi käännös syntyi.