Погледнете Конфигурација за YAML шемата и редоследот на вчитување.
Потребни влезови
sourceLocaleИзворната локација (на пр. en) се користи за наоѓање ресурсни датотеки како **/*.en.resx. Исто така е проследено до провајдерот како from=<locale>.
Избор на давател и квалификации
Изберете еден провајдер по секоја трка со provider. Наведете ги само акредитивите на избраниот давател — погледнете го водичот за Влезови и излези за целосна поставка.
providerДавател на превод: azure (стандардно), aws или google. Се користи само еден провајдер по акциски повик (action call).
subscriptionKeyAzure AI Translator subscription key. Задолжително за azure. Поминете преку secrets.
endpointAzure Translator endpoint URL, на пр. https://api.cognitive.microsofttranslator.com/. Задолжително за azure.
awsAccessKeyIdAWS пристапен клуч ID. Опционално — изоставете (со awsSecretAccessKey) за користење на AWS стандардниот ланец на креденцијали / OIDC. Поминете преку secrets.
awsSecretAccessKeyAWS таен пристапен клуч. Мора да се обезбеди заедно со awsAccessKeyId. Поминете преку secrets.
awsSessionTokenОпционален AWS сесија токен за привремени креденцијали. Поминете низ secrets.
awsRegionAWS регион за услугата Translate (на пр. us-east-1). Задолжително за aws освен ако AWS_REGION не е поставено во околината.
awsFormalityAWS Translate formality setting: FORMAL or INFORMAL.
awsBrevityWhen true, enables AWS Translate brevity mode for supported language pairs.
awsTerminologyNamesAWS Translate custom terminology resource names. Accepts a JSON array or comma-separated values.
awsParallelDataNamesAWS Translate parallel data resource names. Accepts a JSON array or comma-separated values.
googleApiKeyGoogle Cloud API клуч. Обезбедете ја оваа операциона сала googleCredentials за google. Поминете преку secrets.
googleCredentialsGoogle Cloud сервисен клуч за сметка како JSON низ. Обезбедете ја оваа операциона сала googleApiKey за google. Поминете преку secrets.
googleProjectIdОпционален Google Cloud проект id. Обично се заклучува од акредитивот на сервисната сметка.
googleModelGoogle Cloud Translation model, e.g. nmt or base.
googleApiEndpointOptional Google Cloud Translation API endpoint override.
googleAutoRetryOptional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.
Чести опционални влезови
regionРегион на преведувачки ресурси (изоставен за глобални ресурси).
toLocalesЛокации за превод. Прифаќа JSON низа (["fr","de"]) или вредности одделени со запири.
includeШеми на топчиња одделени по нова линија; се преведуваат само совпаѓачки датотеки.
excludeШеми на топчиња одделени по нова линија; Matching датотеките се прескокнуваат (се применуваат по вклучување).
configPathПат до YAML конфигурациската датотека (во однос на коренот на работниот простор).
changeDetectionSmart 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.
statePathPath 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.
snapshotOnlyWhen 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Кога true, изврши преводи и испраќај резимеа, но не пишувај датотеки.
failOnErrorКога true, неочекувани грешки ја откажуваат акцијата; кога false, грешките се предупредувања.
Azure Translator request inputs
Овие директно се мапираат на Azure AI Translator v3 параметри за пребарување и се применуваат на Azure провајдерот. textType и profanityAction исто така се мапираат на AWS/Google каде што постои еквивалент (видете го водичот за давателите); останатите се само на Azure. Секоја е опционална; стандардните преведувачи се применуваат кога не е поставен.
categoryIdAzure Custom Translator категорија — the industry/domain/tone knob. Препратено како ?category=....
textTypeplain или html. Користи html само кога вредностите на ресурсите ти се вистински HTML фрагменти.
profanityActionNoAction, Marked или Deleted. Контролира како се емитуваат вулгарни термини во преводите.
profanityMarkerAsterisk или Tag. Смислено е само кога profanityAction е Marked.
allowFallbackКога false, Translator враќа грешка наместо да се врати на општиот систем ако вашиот categoryId нема распоредување за целна локација.
apiVersionВерзија на REST API за преведувач.
Отпорност и заштита на замена
Овие влезови контролираат како се однесува акцијата кога Translator го намалува вашето барање и како ги штити привремените токени како {{name}} или {0} од оштетување при преводот.
maxRetriesМаксимални обиди за повторување на привремени HTTP одговори (408, 425, 429, 500, 502, 503, 504). Вкупниот број на HTTP повици по барање е 1 + maxRetries.
retryBackoffMsОграничување (во милисекунди) на секој поединечен повлекувачки сон. Акцијата го почитува Retry-After одговор на Azure токму кога е присутен; во спротивно, користи џитериран експоненцијален повлекување ограничено на оваа вредност.
protectPlaceholdersКога true (стандардно), привремени елементи како {{name}}, ${var}, {0}, {0:N2}, %s, %1$s и HTML ентитети се заменуваат со сентинел токени пред преводот и се враќаат по преводот. Оневозможи само кога твојот извор намерно содржи буквален текст во форма на привремено што треба да се преведе.
customPlaceholderPatternsНоворедовни регуларни регули (без делимитери) се додаваат на стандардниот сет на место, на пр. <<.+?>> за прилагодена синтакса на токени.
noTranslatePatternsШемите на глоб одделени по нова линија се совпаѓаа со клучеви од ниво на парсер (JSON пунктирана патека, RESX name, PO msgid, XLIFF единица id, INI/restext клуч). Клучевите за совпаѓање се отстрануваат од барањето на преведувачот и поминуваат со зачувување на нивната изворна вредност.
Излези
summary-titleКраток резиме погоден за насловот на ПР, на пр. Machine-translated 320 files, a total of 5,418 translations.
summary-detailsРезиме на пониска цена погодна за PR тело или резиме на работа.
has-new-translations'true' кога беа генерирани еден или повеќе нови преводи.