Sisendid ja väljundid · Ressursitõlkija

Vaata Konfiguratsioon YAML skeemi ja laadimisjärjekorra kohta.

Nõutud sisendid

sourceLocale

Allika asukoht (nt en) kasutati ressursifailide, näiteks **/*.en.resx leidmiseks. Samuti edastati see teenusepakkujale kui from=<locale>.

Teenusepakkujate valik ja kvalifikatsioonid

Vali iga jooksu kohta üks teenusepakkuja provider. Esita ainult valitud teenusepakkuja mandaadid — vaata Sisendid ja väljundid juhendit täieliku seadistamise kohta.

provider

Vaikimisi: azure

Tõlkepakkuja: azure (vaikimisi), aws või google. Iga tegevuskõne kohta kasutatakse ainult ühte teenusepakkujat.

subscriptionKey

Vaikimisi: puudub

Azure AI Translatori tellimusvõti. Vajalik azure. Läbige secrets.

endpoint

Vaikimisi: puudub

Azure Translatori lõpp-punkti URL, nt https://api.cognitive.microsofttranslator.com/. Vajalik azure.

awsAccessKeyId

Vaikimisi: puudub

AWS ligipääsuvõtme ID. Valikuline — jätta (koos awsSecretAccessKey) AWS vaikimisi mandaadiahela / OIDC kasutamata. Läbige secrets.

awsSecretAccessKey

Vaikimisi: puudub

AWS salajase juurdepääsu võti. Tuleb tarnida koos awsAccessKeyId. Läbige secrets.

awsSessionToken

Vaikimisi: puudub

Valikuline AWS sessioonitoken ajutiste mandaate jaoks. Sõida läbi secrets.

awsRegion

Vaikimisi: puudub

AWS piirkond Translate-teenuse jaoks (nt us-east-1). Vajalik aws jaoks, kui AWS_REGION pole keskkonnas seatud.

awsFormality

Vaikimisi: puudub

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Vaikimisi: puudub

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

awsTerminologyNames

Vaikimisi: puudub

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

awsParallelDataNames

Vaikimisi: puudub

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

googleApiKey

Vaikimisi: puudub

Google Cloud API võti. Anna see googleCredentials google jaoks. Mine läbi secrets.

googleCredentials

Vaikimisi: puudub

Google Cloud teenuse konto võti JSON-stringina. Anna see googleApiKey google jaoks. Mine läbi secrets.

googleProjectId

Vaikimisi: puudub

Valikuline Google Cloud projekti ID. Tavaliselt tuletatakse see teenusekonto mandaadi põhjal.

googleModel

Vaikimisi: puudub

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

googleApiEndpoint

Vaikimisi: puudub

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Vaikimisi: puudub

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

Levinumad valikulised sisendid

region

Vaikimisi: puudub

Tõlkija ressursipiirkond (globaalsete ressursside jaoks välja jäetud).

toLocales

Vaikimisi: kõik toetatud

Kohad, kuhu tõlkida. Aktsepteerib JSON-massiivi (["fr","de"]) või komadega eraldatud väärtusi.

include

Vaikimisi: puudub

Newline eraldatud globi mustrid; tõlgitakse ainult sobivad failid.

exclude

Vaikimisi: puudub

Newline eraldatud globi mustrid; Vastavad failid jäetakse vahele (rakendatakse pärast kaasamist).

configPath

Vaikimisi: .github/resource-translator.yml

Tee YAML konfiguratsioonifaili juurde (tööruumi juure suhtes).

changeDetection

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

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

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

Vaikimisi: false

Kui true, käivita tõlked ja edasta kokkuvõtteid, kuid ära kirjuta faile.

failOnError

Vaikimisi: true

Kui true, ebaõnnestuvad ootamatud vead tegevuses; Kui false, on vead hoiatused.

Azure Translator request inputs

Need kaardistuvad otse Azure AI Translator v3 päringuparameetritele ja rakenduvad Azure'i teenusepakkujale. textType ja profanityAction on samuti seotud AWS/Google'iga, kus eksisteerib ekvivalent (vt teenusepakkuja juhendit); ülejäänud on ainult Azure'i jaoks. Igaüks neist on vabatahtlik; Translatori vaikeseaded kehtivad, kui seade on eemaldatud.

categoryId

Vaikimisi: general

Azure Custom Translator kategooria — tööstus/domeen/tooninupp. Saadetud ?category=....

textType

Vaikimisi: plain

plain või html. Kasuta html ainult siis, kui sinu ressursiväärtused on päris HTML-fragmendid.

profanityAction

Vaikimisi: NoAction

NoAction, Marked või Deleted. Kontrollib, kuidas ropud väljendid tõlgetes tekivad.

profanityMarker

Vaikimisi: Asterisk

Asterisk või Tag. Tähenduslik ainult siis, kui profanityAction on Marked.

allowFallback

Vaikimisi: true (tõlkija vaikeseade)

Kui false, tagastab Translator vea, selle asemel et pöörduda üldise süsteemi juurde, kui categoryId pole sihtkoha jaoks juurutatud.

apiVersion

Vaikimisi: 3.0

Tõlkija REST API versioon.

Vastupidavus ja ajutise kaitse

Need sisendid kontrollivad, kuidas tegevus käitub, kui Tõlkija sinu päringut piirab, ja kuidas see kaitseb ajutisi tokeneid nagu {{name}} või {0} tõlkimise ajal kahjustamise eest.

maxRetries

Vaikimisi: 5

Maksimaalne korduskatse ajutiste HTTP vastuste puhul (408, 425, 429, 500, 502, 503, 504). HTTP-kõnede koguarv ühe päringu kohta on 1 + maxRetries.

retryBackoffMs

Vaikimisi: 30000

Piirang (millisekundites) igale ühele tagasilöögi unele. Tegevus austab Azure'i Retry-After vastusepäist täpselt siis, kui see on olemas; vastasel juhul kasutab see värisevat eksponentsiaalset tagasilööki, mis on selle väärtusega piiratud.

protectPlaceholders

Vaikimisi: true

Kui true (vaikimisi), asendatakse kohatäitjad nagu {{name}}, ${var}, {0}, {0:N2}, %s, %1$s ja HTML enne tõlkimist sentinel-tokenitega ja taastatakse hiljem. Keela ainult siis, kui sinu allikas sisaldab tahtlikult sõna-sõnalt ajutise täide-kujulist teksti, mis tuleks tõlkida.

customPlaceholderPatterns

Vaikimisi: puudub

Uue rea eraldatud regexid (ilma eraldajateta) lisati vaikimisi kohatäitjate hulka, nt <<.+?>> kohandatud tokeni süntaksi jaoks.

noTranslatePatterns

Vaikimisi: puudub

Uue rea eraldatud glob-mustrid sobitusid parseri taseme võtmetega (JSON punktrada, RESX name, PO msgid, XLIFF ühik id, INI/restext võti). Sobivad võtmed eemaldatakse tõlkija päringust ja edastatakse nende lähteväärtuse säilitamisega.

Väljundid

summary-title

Lühike PR-sõbralik kokkuvõte, nt Machine-translated 320 files, a total of 5,418 translations.

summary-details

Allahindluse kokkuvõte, mis sobib PR-i või töö kokkuvõtte jaoks.

has-new-translations

'true' siis, kui toodeti üks või mitu uut tõlget.