Vhodi in izhodi · Prevajalnik virov

Oglejte si Konfiguracija za shemo YAML in vrstni red nalaganja.

Potrebni vhodi

sourceLocale

Izvorna lokacija (npr. en), ki se uporablja za iskanje datotek z viri, kot je **/*.en.resx. Prav tako preusmerjeno ponudniku kot from=<locale>.

Izbira ponudnikov in kvalifikacije

Izberite enega ponudnika na vsak tek z provider. Vnesite le podatke izbranega ponudnika — za celotno nastavitev glejte Vhodi in izhodi vodič.

provider

Privzeto: azure

Ponudnik prevajanja: azure (privzeto), aws ali google. Na klic dejanja se uporablja le en ponudnik.

subscriptionKey

Privzeto: Nič

Azure AI Translator subscription key. Obvezno za azure. Prehajajte preko secrets.

endpoint

Privzeto: Nič

Azure Translator endpoint URL, npr. https://api.cognitive.microsofttranslator.com/. Obvezno za azure.

awsAccessKeyId

Privzeto: Nič

ID dostopnega ključa za AWS. Neobvezno — izpustiti (z awsSecretAccessKey) uporabo privzete verige poverilnic / OIDC v AWS. Prehajajte preko secrets.

awsSecretAccessKey

Privzeto: Nič

AWS tajni dostopni ključ. Potrebno je zagotoviti awsAccessKeyId. Prehajajte preko secrets.

awsSessionToken

Privzeto: Nič

Opcijski AWS sejni žeton za začasne poverilnice. Pass preko secrets.

awsRegion

Privzeto: Nič

AWS regijo za storitev Translate (npr. us-east-1). Obvezno za aws, razen če AWS_REGION nastavljeno v okolju.

awsFormality

Privzeto: Nič

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Privzeto: Nič

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

awsTerminologyNames

Privzeto: Nič

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

awsParallelDataNames

Privzeto: Nič

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

googleApiKey

Privzeto: Nič

Google Cloud API ključ. Predložite ta operacijski googleCredentials za google. Prehodi preko secrets.

googleCredentials

Privzeto: Nič

Google Cloud storitveni računski ključ kot JSON niz. Predložite ta operacijski googleApiKey za google. Prehodi preko secrets.

googleProjectId

Privzeto: Nič

Opcijski ID projekta Google Cloud. Običajno sklepamo iz poverilnice storitvenega računa.

googleModel

Privzeto: Nič

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

googleApiEndpoint

Privzeto: Nič

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Privzeto: Nič

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

Pogosti izbirni vhodi

region

Privzeto: Nič

Prevajalska regija virov (izpuščeno za globalne vire).

toLocales

Privzeto: vse podprte

Kraji za prevajanje. Sprejema JSON polje (["fr","de"]) ali vrednosti, ločene z vejico.

include

Privzeto: Nič

Vzorci kroglov z ločenimi novimi vrsticami; prevedene so le ujemajoče se datoteke.

exclude

Privzeto: Nič

Vzorci kroglov z ločenimi novimi vrsticami; ujemajoče se datoteke preskočijo (uporabljene po Include).

configPath

Privzeto: .github/resource-translator.yml

Pot do YAML konfiguracijske datoteke (glede na koren delovnega prostora).

changeDetection

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

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

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

Privzeto: false

Ko true, izvajajte prevode in pošiljajte povzetke, vendar ne pišite datotek.

failOnError

Privzeto: true

Ko true, nepričakovane napake preprečijo dejanje; Ko false, so napake opozorila.

Azure Translator request inputs

Ti se neposredno preslikajo na parametre poizvedb Azure AI Translator v3 in se nanašajo na ponudnika Azure. textType in propsovanjeAction sta prav tako preslikana na AWS/Google, kjer obstaja ekvivalent (glej vodič za ponudnike); ostali so samo Azure. Vsak je opcijski; privzete nastavitve prevajalnika veljajo, ko niso nastavljene.

categoryId

Privzeto: general

Azure Custom Translator kategorija — gumb za industrijo/domeno/ton. Posredovano kot ?category=....

textType

Privzeto: plain

plain ali html. Uporabljajte html le, kadar so vaše vrednosti virov resnični HTML fragmenti.

profanityAction

Privzeto: NoAction

NoAction, Marked ali Deleted. Nadzoruje, kako se vulgarni izrazi uporabljajo v prevodih.

profanityMarker

Privzeto: Asterisk

Asterisk ali Tag. Pomembno je le, ko je profanityAction Marked.

allowFallback

Privzeto: true (privzeto prevajalca)

Ko false, prevajalnik vrne napako, namesto da bi se vrnil k splošnemu sistemu, če vaš categoryId nima namestitve za ciljno lokacijo.

apiVersion

Privzeto: 3.0

Translator REST API različica.

Odpornost in zaščita nadomestkov

Ti vnosi nadzorujejo, kako se dejanje obnaša, ko prevajalnik omeji vašo zahtevo, in kako ščiti začasne žetone, kot sta {{name}} ali {0}, pred pokvarjenostjo med prevajanjem.

maxRetries

Privzeto: 5

Največ poskusov ponovnega poskusa pri prehodnih HTTP odgovorih (408, 425, 429, 500, 502, 503, 504). Skupno število HTTP klicev na zahtevo je 1 + maxRetries.

retryBackoffMs

Privzeto: 30000

Ustavi (v milisekundah) pri vsakem posameznem pomirjujočem spanju. Dejanje spoštuje Azurejev Retry-After odgovor natanko takrat, ko je prisotno; v nasprotnem primeru uporablja nihanje eksponentnega povratka, omejenega na to vrednost.

protectPlaceholders

Privzeto: true

Ko true (privzeto), se nadomestni elementi, kot so {{name}}, ${var}, {0}, {0:N2}, %s, %1$s in HTML entitete, pred prevodom zamenjajo s sentinel žetoni in se po prevodu obnovijo. Onemogoči le, če tvoj vir namerno vsebuje dobesedno besedilo v obliki začasnega začasa, ki ga je treba prevesti.

customPlaceholderPatterns

Privzeto: Nič

Regexi, ločeni od novih vrstic (brez ločil), dodani privzetemu naboru nadomestkov, npr. <<.+?>> za sintakso prilagojenih žetonov.

noTranslatePatterns

Privzeto: Nič

Vzorci globov, ločeni po novih vrsticah, so se ujemali s ključi na ravni parserja (JSON pikčasta pot, RESX name, PO msgid, enota XLIFF id, INI/restext ključ). Ujemajoči se ključi odstranijo iz zahteve prevajalca in se prenesejo skozi z ohranjeno izvorno vrednostjo.

Izhodi

summary-title

Kratek povzetek, prijazen do PR naslovov, npr. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Povzetek Markdown, primeren za PR organ ali povzetek delovnega mesta.

has-new-translations

'true', ko je bil ustvarjen eden ali več novih prevodov.