Inputs & outputs · Pśełožowaŕ resursow

Glědajśo Konfiguracija za šemu YAML a slěd zacytanja.

Pominane inputy

sourceLocale

Žrědłowe lokale (na pś. en) se wužywa, aby resursowe dataje na pśikład **/*.en.resx namakali. Teke ako from=<locale> dalej na nosarja.

Provider selection & credentials

Wubjeŕśo jadnogo póbitowarja na běg z provider. Zapódajśo jano pśiznanjanja wubranego póbitowarja – woglědajśo se Inputs & outputs za dopołne zarědowanje.

provider

Etablěrowanje: azure

Pśełožowański póbitowaŕ: azure (standard), aws abo google. Wužywa se jano jaden póbitowaŕ na akciske wołanje.

subscriptionKey

Etablěrowanje: Žedne

Abonentski klucz Azure AI Translator. Za azure trjebne. Pśejěźo pśez secrets.

endpoint

Etablěrowanje: Žedne

URL kóńcnego směra Azure Translatora, na pśikład https://api.cognitive.microsofttranslator.com/. Trjebne za azure.

awsAccessKeyId

Etablěrowanje: Žedne

ID pśistupnego kluca AWS. Opcionalnje – wuwóstajijośo (z awsSecretAccessKey), aby wužywał standardny rjeśaz pśidawańskich pśigłosow / OIDC AWS. Pśejěźo pśez secrets.

awsSecretAccessKey

Etablěrowanje: Žedne

Kšajźny pśichadny kluc AWS. Dej se gromaźe z awsAccessKeyId dodawaś. Pśejěźo pśez secrets.

awsSessionToken

Etablěrowanje: Žedne

Opciski AWS-session-token za nachylne pśiznanjenja. Pśejěź pśez secrets.

awsRegion

Etablěrowanje: Žedne

AWS-region za pśełožowańsku słužbu (na pś. us-east-1). Trjebne za aws, gaž njejo AWS_REGION we wobswěśe zapisane.

awsFormality

Etablěrowanje: Žedne

AWS Translate formality setting: FORMAL or INFORMAL.

awsBrevity

Etablěrowanje: Žedne

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

awsTerminologyNames

Etablěrowanje: Žedne

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

awsParallelDataNames

Etablěrowanje: Žedne

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

googleApiKey

Etablěrowanje: Žedne

Google Cloud API key. Pódaj za google toś ten abo googleCredentials. Pśejěź pśez secrets.

googleCredentials

Etablěrowanje: Žedne

Google Cloud Service-Account Key ako JSON-string. Pódaj za google toś ten abo googleApiKey. Pśejěź pśez secrets.

googleProjectId

Etablěrowanje: Žedne

Opcionalny ID projekta Google Cloud. Zwětšego se wótwóźujo z pśiznanka słužbowego konta.

googleModel

Etablěrowanje: Žedne

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

googleApiEndpoint

Etablěrowanje: Žedne

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Etablěrowanje: Žedne

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

Common Optional inputs

region

Etablěrowanje: Žedne

Region resursow pśełožowarja (za globalne resurse wuwóstajiś).

toLocales

Etablěrowanje: Wšykne pódpěrane

Lokale k pśełožowanju. Akceptěrujo JSON-rěd (["fr","de"]) abo komy źělone gódnoty.

include

Etablěrowanje: Žedne

wót nowolinijow źělone kulkowe mustry; Pśełožyju se jano se wótpowědujuce dataje.

exclude

Etablěrowanje: Žedne

wót nowolinijow źělone kulkowe mustry; Wótpowědujuce dataje se pśeskocyju (nałožuju se pó pśirědowanju).

configPath

Etablěrowanje: .github/resource-translator.yml

Droga k konfigurěrowańskej dataji YAML (relatiwnje k kórjenju źěłowego ruma).

changeDetection

Etablěrowanje: 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

Etablěrowanje: .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

Etablěrowanje: 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

Etablěrowanje: false

Gaž true, wuběžyjśo pśełožki a wusćełajśo zespominanja, ale njepišćo dataje.

failOnError

Etablěrowanje: true

Gaž true, njewócakane zmólki njedocyniju jadnanje; Gaž false, zmólki su warnowanja.

Azure Translator request inputs

Toś te mapěruju se direktnje na zapšašowańske parametry Azure AI Translator v3 a nałožuju se na póbitowarja Azure. textType a profanityAction se teke na AWS/Google mapěruju, źož wótpowědnik eksistěrujo. Zbytk jo jano Azure. Kuždy jo fakultatiwny; Płaśi Translatorowe standardy, jolic njejo nastajony.

categoryId

Etablěrowanje: general

Azure Custom Translator category — buttonus industry/domain/tone. Dalej ako ?category=....

textType

Etablěrowanje: plain

plain abo html. Wužywajśo html jano, gaž waše resursowe gódnoty su napšawdne HTML-fragmenty.

profanityAction

Etablěrowanje: NoAction

NoAction, Marked abo Deleted. Kontrolěrujśo, kak se profane zapśimjeśa w pśełožkach wusćełaju.

profanityMarker

Etablěrowanje: Asterisk

Asterisk abo Tag. Zmysłapołne akle pótom, gaž jo profanityAction Marked.

allowFallback

Etablěrowanje: true (standardny pśełožowar)

Gaž false, pśełožowaŕ zmólku wrośijo, město aby se wrośił do powšyknego systema, gaž waš categoryId njama zasajźenje za celowu lokaciju.

apiVersion

Etablěrowanje: 3.0

Translator REST API version.

Odpornosć & šćit za placeholdery

Toś te inputy kontrolěruju, kak se akcija zaźaržujo, gaž pśełožowaŕ wašo napšašowanje pómjeńšyjo a kak šćita placeholderowe tokeny ako {{name}} abo {0} pśed tym, až su se pśi pśełožowanju znjemóžnili.

maxRetries

Etablěrowanje: 5

Maksimalne wopyty pśi pśechodnych wótegronach HTTP (408, 425, 429, 500, 502, 503, 504). Cełkowna licba HTTP-wołanjow na napšašowanje jo 1 + maxRetries.

retryBackoffMs

Etablěrowanje: 30000

Mejk (w milisekundach) pśi kuždem jadnučkem spanju. Akcija gódnośi głowowu smužku Retry-After wótegrona Azure dokradnje, gaž jo prezentna; Howac wužywa na toś tu gódnotu wobgranicowany eksponencialny backoff.

protectPlaceholders

Etablěrowanje: true

Gaž true (standard), se městnowe symbole ako {{name}}, ${var}, {0}, {0:N2}, %s, %1$s a HTML entitety pśed pśełožkom pśez Sentinelowe tokeny wuměnjaju a pó tom zasej wótnowiju. Znjemóžniśo jano pótom, gaž waš žrědło wótglědanje wopśimujo tekst w formje rědnego symbola, kótaryž ma se pśełožyś.

customPlaceholderPatterns

Etablěrowanje: Žedne

Nowosmužki źělone regularne ekseksa (bźez wótgranicowakow) su wordowali k standardnej sajźbje symbolow pśidane, na pś. <<.+?>> za swójsku syntaksu tokena.

noTranslatePatterns

Etablěrowanje: Žedne

Pśez nowu liniju źělone globowe mustry su pśirownali k tastkam na rowninje parsera (smužkowana droga JSON, RESX name, PO msgid, jednotka XLIFF id, INI/restextowy tast). Wótpowědujuce kluce se z napšašowanja pśełožowarja wótwónoźiju a pśejdu z zachowaneju žrědłoweju gódnotu.

Wugbaśa

summary-title

Krotke PR-titel pśijaśelne zespominanje, na pś. Machine-translated 320 files, a total of 5,418 translations.

summary-details

Markdown-zespominanje góźi se za PR-body abo zespominanje źěłowego městna.

has-new-translations

'true', gaž jo se jaden abo někotare nowe pśełožki wugenerěrowali.