Inputs & outputs · iVurevure ni Vakadewa

Raica na Tuvatuva me baleta na ituvatuva ni YAML kei na ituvatuva ni vakavodoki.

Inputs e gadrevi

Inputs e gadrevi
Yaca	iVakamacala
`sourceLocale`	Vanua ni ivurevure (e.g. `en`) e vakayagataki me kunei kina na faile ni ivurevure me vaka na `*/.en.resx`. Vakau talega ki na Dauvakadewa me `from=<locale>`.
`subscriptionKey`	Azure AI Translator subscription key. Lako yani ki na `secrets`.
`endpoint`	URL ni icavacava ni dauvakadewa, e.g. `https://api.cognitive.microsofttranslator.com/`.

Vakacurumi ni digidigi raraba

Vakacurumi ni digidigi raraba
Yaca	Lalai	iVakamacala
`region`	sega ni dua	Vanua ni ivurevure ni dauvakadewa (sega ni baleta na ivurevure ni vuravura raraba).
`toLocales`	Tokoni kece	Vanua me vakadewataki kina. Ciqoma e dua na JSON array (`["fr","de"]`) se yavunilewa tawasei koma.
`include`	sega ni dua	Newline-separated glob patterns; na faile veisotari ga e vakadewataki.
`exclude`	sega ni dua	Newline-separated glob patterns; Era sa calata na faile veisotari (vakayagataki ni sa okati oti).
`configPath`	`.github/resource-translator.yml`	Sala ki na faile ni config ni YAML (veiwekani ki na wakana ni vanua ni cakacaka).
`dryRun`	`false`	Ni `true`, cicivaka na vakadewa ka solia na ivakaleka ia kakua ni vola na faile.
`failOnError`	`true`	Ni sa `true`, na cala sega ni namaki ena sega ni yaco; Ni `false`, na cala e veivakasalataki.

Kerekere ni dauvakadewa

Oqo na mape vakadodonu ki na Azure AI Translator v3 query parameters. Na veika kece e digitaki; na default ni Translator e vakayagataki ni sega ni tuvatuva.

Kerekere ni dauvakadewa
Yaca	Lalai	iVakamacala
`categoryId`	general	Na iwasewase ni Azure Custom Translator — na knob ni cakacaka/domain/tone. Vakau me `?category=...`.
`textType`	`plain`	`plain` se `html`. Vakayagataka ga na `html` ni nomu ivurevure e tiki ni HTML dina.
`profanityAction`	`NoAction`	`NoAction`, `Marked`, se `Deleted`. Vakatulewataka na ivakarau ni kena kacivaki na vosa ca ena vakadewa.
`profanityMarker`	`Asterisk`	`Asterisk` se `Tag`. E vakaibalebale ga ni `profanityAction` `Marked`.
`allowFallback`	dina (Dauvakadewa lalai)	Ni sa `false`, ena vakalesuya mai na Translator e dua na cala ka sega ni lesu tale ki na ivakarau raraba kevaka e sega ni vakayagataki na nomu `categoryId` me baleta e dua na vanua takete.
`apiVersion`	`3.0`	Translator REST API version.

Resilience & placeholder protection

Na inputs oqo e vakatulewataka na ivakarau ni cakacaka ena gauna e throttles kina na nomu kerekere na Translator kei na sala e taqomaki kina na ivakatakilakila ni placeholder me vaka na {{name}} se {0} mai na kena mangled ena gauna ni vakadewa.

Resilience kei na veitaqomaki ni placeholder
Yaca	Lalai	iVakamacala
`maxRetries`	`5`	Maximum retry attempts on transient HTTP responses (`408, 425, 429, 500, 502, 503, 504`). Na iwiliwili taucoko ni veikacivi HTTP ena dua na kerekere e `1 + maxRetries`.
`retryBackoffMs`	`30000`	Cap (ena milliseconds) ena dua ga na moce ni backoff. Na cakacaka e doka na ulutaga ni isau ni `Retry-After` ni Azure ena gauna sara ga e tiko kina; kevaka e sega e vakayagataka na jittered exponential backoff capped ena yavunilewa oqo.
`protectPlaceholders`	`true`	Ni sa `true` (lalai), placeholders me vaka na `{{name}}`, `${var}`, `{0}`, `{0:N2}`, `%s`, `%1$s` kei na HTML entity era sa vakaisosomitaki vata kei na ivakatakilakila ni sentinel ni bera na vakadewataki ka vakalesui mai ni sa oti. Disable walega kevaka e nakiti na nomu ivurevure e tiko kina na itukutuku vakaibalebale e dodonu me vakadewataki.
`customPlaceholderPatterns`	sega ni dua	Newline-separated regexes (without delimiters) added to the default placeholder set, e.g. `<<.+?>>` for custom token syntax.
`noTranslatePatterns`	sega ni dua	Newline-separated glob patterns matched against parser-level keys (JSON dotted path, RESX `name`, PO `msgid`, XLIFF unit `id`, INI/restext key). Na idola veisotari era na biu laivi mai na kerekere ni Dauvakadewa ka curu yani ni maroroi tu na kedra ivurevure ni ivurevure.

Output

Output
Yaca	iVakamacala
`summary-title`	iVakaleka lekaleka ni ulutaga ni PR, e.g. Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	iVakaleka ni Markdown e veiganiti me baleta e dua na isoqosoqo ni PR se ivakaleka ni cakacaka.
`has-new-translations`	`'true'` na gauna e caka kina e dua se sivia na vakadewa vou.