Įėjimai ir išėjimai · Išteklių vertėjas

Žr. Konfigūracija YAML schemą ir įkėlimo tvarką.

Reikalingi įvesties duomenys

sourceLocale

Šaltinio lokalė (pvz., en), naudojama išteklių failams, pvz., **/*.en.resx, rasti. Taip pat perduodama paslaugų teikėjui kaip from=<locale>.

Teikėjo pasirinkimas ir kredencialai

Pasirinkite vieną teikėją vienam paleidimui su provider. Pateikite tik pasirinkto teikėjo kredencialus – visą sąranką rasite Įėjimai ir išėjimai vadove.

provider

Numatytasis: azure

Vertimo teikėjas: azure (numatytasis), aws arba google. Vienam veiksmo iškvietimui naudojamas tik vienas teikėjas.

subscriptionKey

Numatytasis: nė vienas

"Azure AI Translator" prenumeratos raktas. Reikalingas azure. Pravažiuokite per secrets.

endpoint

Numatytasis: nė vienas

Azure Translator galinio punkto URL, pvz., https://api.cognitive.microsofttranslator.com/. Reikalingas azure.

awsAccessKeyId

Numatytasis: nė vienas

AWS prieigos rakto ID. Neprivaloma – praleiskite (su awsSecretAccessKey), kad naudotumėte numatytąją AWS kredencialų grandinę / OIDC. Pravažiuokite per secrets.

awsSecretAccessKey

Numatytasis: nė vienas

AWS slaptas prieigos raktas. Turi būti tiekiamas kartu su awsAccessKeyId. Pravažiuokite per secrets.

awsSessionToken

Numatytasis: nė vienas

Pasirenkamas AWS seanso raktas laikiniems kredencialams. Praeikite per secrets.

awsRegion

Numatytasis: nė vienas

AWS regionas vertimo paslaugai (pvz., us-east-1). Reikalinga aws, nebent AWS_REGION nustatyta aplinkoje.

awsFormality

Numatytasis: nė vienas

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Numatytasis: nė vienas

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

awsTerminologyNames

Numatytasis: nė vienas

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

awsParallelDataNames

Numatytasis: nė vienas

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

googleApiKey

Numatytasis: nė vienas

"Google Cloud API" raktas. Pateikite šį OR googleCredentials google. Pravažiuokite per secrets.

googleCredentials

Numatytasis: nė vienas

"Google Cloud" paslaugos paskyros raktas kaip JSON eilutė. Pateikite šį OR googleApiKey google. Pravažiuokite per secrets.

googleProjectId

Numatytasis: nė vienas

Pasirenkamas "Google Cloud" projekto ID. Paprastai daroma išvada iš aptarnavimo sąskaitos kredencialų.

googleModel

Numatytasis: nė vienas

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

googleApiEndpoint

Numatytasis: nė vienas

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Numatytasis: nė vienas

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

Bendrieji neprivalomi įvesties duomenys

region

Numatytasis: nė vienas

Vertėjo išteklių regionas (praleiskite visuotinius išteklius).

toLocales

Numatytasis: Visi palaikomi

Lokalės, į kurias reikia versti. Priima JSON masyvą (["fr","de"]) arba kableliais atskirtas reikšmes.

include

Numatytasis: nė vienas

Naujos linijos atskirti rutulio raštai; Verčiami tik atitinkantys failai.

exclude

Numatytasis: nė vienas

Naujos linijos atskirti rutulio raštai; Atitinkantys failai praleidžiami (taikomi po įtraukimo).

configPath

Numatytasis: .github/resource-translator.yml

Kelias į YAML konfigūracijos failą (atsižvelgiant į darbo srities šaknį).

changeDetection

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

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

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

Numatytasis: false

Kai true, paleiskite vertimus ir išleiskite santraukas, bet nerašykite failų.

failOnError

Numatytasis: true

Kai true, netikėtos klaidos nepavyksta atlikti veiksmo; Kai false, klaidos yra įspėjimai.

"Azure Translator" užklausos įvestis

Jie susiejami tiesiogiai su "Azure AI Translator v3" užklausos parametrais ir taikomi "Azure" teikėjui. textType ir nešvankybėsAction taip pat susiejami su AWS/Google, kur yra atitikmuo (žr. paslaugų teikėjų vadovą); likusieji yra tik "Azure". Kiekvienas iš jų yra neprivalomas; Numatytieji vertėjo nustatymai taikomi, kai nenustatyta.

categoryId

Numatytasis: general

"Azure Custom Translator" kategorija – pramonės/domeno/tono rankenėlė. Persiųsta kaip ?category=....

textType

Numatytasis: plain

plain ar html. Naudokite html tik tada, kai jūsų išteklių reikšmės yra tikri HTML fragmentai.

profanityAction

Numatytasis: NoAction

NoAction, Marked arba Deleted. Kontroliuoja, kaip nešvankūs terminai skleidžiami vertimuose.

profanityMarker

Numatytasis: Asterisk

Asterisk ar Tag. Prasminga tik tada, kai profanityAction yra Marked.

allowFallback

Numatytasis: true (numatytasis vertėjas)

Kai false, vertėjas pateikia klaidą, o ne grįžta į bendrąją sistemą, jei jūsų categoryId nėra paskirties lokalės diegimo.

apiVersion

Numatytasis: 3.0

Vertėjo REST API versija.

Atsparumas ir vietos rezervavimo ženklų apsauga

Šios įvestys kontroliuoja, kaip veiksmas veikia, kai vertėjas riboja jūsų užklausą, ir kaip jis apsaugo vietos rezervavimo ženklo žetonus, pvz., {{name}} ar {0}, nuo sugadinimo vertimo metu.

maxRetries

Numatytasis: 5

Maksimalus bandymų pakartoti skaičių su trumpalaikiais HTTP atsakymais (408, 425, 429, 500, 502, 503, 504). Bendras HTTP skambučių skaičius vienoje užklausoje yra 1 + maxRetries.

retryBackoffMs

Numatytasis: 30000

Viršutinė riba (milisekundėmis) dėl bet kokio atgalinio miego režimo. Veiksmas gerbia "Azure" Retry-After atsakymo antraštę tiksliai tada, kai yra; priešingu atveju jis naudoja drebantį eksponentinį atgalinį atsitraukimą, apribotą šia reikšme.

protectPlaceholders

Numatytasis: true

Kai true (numatytasis), vietos rezervavimo ženklai, pvz., {{name}}, ${var}, {0}, {0:N2}, %s, %1$s ir HTML objektai, prieš verčiant pakeičiami kontroliniais atpažinimo ženklais, o vėliau atkuriami. Išjungti tik tada, kai šaltinyje sąmoningai yra pažodinio vietos rezervavimo ženklo formos teksto, kurį reikia išversti.

customPlaceholderPatterns

Numatytasis: nė vienas

Naujomis eilutėmis atskirti reguliarieji reiškiniai (be skyriklių), įtraukti į numatytąjį vietos rezervavimo ženklų rinkinį, pvz., <<.+?>> pasirinktinės atpažinimo ženklų sintaksės.

noTranslatePatterns

Numatytasis: nė vienas

Naujos eilutės atskirti rutulio modeliai, suderinti su analizatoriaus lygio raktais (JSON punktyrinis kelias, RESX name, PO msgid, XLIFF vienetas id, INI/restext raktas). Atitinkantys raktai pašalinami iš vertėjo užklausos ir perduodami išsaugojus jų šaltinio reikšmę.

Rezultatai

summary-title

Trumpa PR pavadinimo santrauka, pvz., Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown santrauka tinka ryšių su visuomene įstaigai arba darbo santraukai.

has-new-translations

'true', kai buvo sukurtas vienas ar keli nauji vertimai.