YAML схемасы мен жүктеу тәртібі Конфигурация-дан қараңыз.
Қажетті кірістер
sourceLocaleSource locale (мысалы, en) **/*.en.resx сияқты ресурс файлдарын табу үшін қолданылады. Сондай-ақ провайдерге from=<locale> ретінде жіберілді.
Провайдерді таңдау және біліктіліктер
Әр рейс үшін бір провайдерді таңдаңыз provider. Тек таңдалған провайдердің куәліктерін ұсыныңыз — толық баптау үшін Кірістер мен шығыстар нұсқаулығын қараңыз.
providerАударма провайдері: azure (әдепкі), aws немесе google. Әр әрекет қоңырауына тек бір провайдер қолданылады.
subscriptionKeyAzure AI Translator жазылу кілті. Қажетті azure. secrets арқылы өтіңіз.
endpointAzure Translator endpoint URL, мысалы, https://api.cognitive.microsofttranslator.com/. Қажетті azure.
awsAccessKeyIdAWS қол жеткізу кілтінің идентификаторы. Міндетті емес — AWS-тің әдепкі тіркеу тізбегін / OIDC-ны пайдалану үшін (awsSecretAccessKey-мен бірге) алып тастау. secrets арқылы өтіңіз.
awsSecretAccessKeyAWS құпия кіру кілті. Оларды awsAccessKeyId бірге жеткізу керек. secrets арқылы өтіңіз.
awsSessionTokenУақытша тіркеу деректері үшін қосымша AWS сессия токені. secrets арқылы өт.
awsRegionTranslate қызметі үшін AWS аймағы (мысалы, 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 жоба идентификаторы. Әдетте қызмет есепшотының тіркеу деректерінен анықталады.
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Жаңа сызықпен бөлінген шар үлгілері; сәйкестендіру файлдары өткізіледі (include-ден кейін қолданылады).
configPathYAML конфигурация файлына (жұмыс кеңістігінің түбіріне қатысты) жол.
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.
dryRuntrue болғанда, аудармаларды іске қосып, қысқаша мазмұнын шығарыңыз, бірақ файл жазбаңыз.
failOnErrortrue кезде, күтпеген қателіктер әрекетті тоқтатады; false кезде қателер ескерту болып табылады.
Azure Translator request inputs
Олар Azure AI Translator v3 сұрау параметрлеріне тікелей сәйкестендіріліп, Azure провайдеріне қолданылады. textType және profanityAction AWS/Google-ға сәйкестендіріледі, мұнда баламасы бар (провайдер нұсқаулығын қараңыз); қалғандары тек Azure форматында. Әрқайсысы міндетті емес; Аудармашы әдепкі параметрлері орнатылмаған кезде қолданылады.
categoryIdAzure Custom Translator category — industry/domain/tone knob. ?category=... ретінде жіберілді.
textTypeplain немесе html. Тек ресурс мәндеріңіз шынайы HTML фрагменттері болғанда ғана html қолданыңыз.
profanityActionNoAction, Marked немесе Deleted. Аудармаларда дөрекі сөздердің қалай таратылуын басқарады.
profanityMarkerAsterisk немесе Tag. Мағынасы тек profanityAction Marked.
allowFallbackfalse болғанда, егер categoryId мақсатты орынға орналастырылмаса, Translator жалпы жүйеге қайта оралмайды, қате қайтарады.
apiVersionАудармашы REST API нұсқасы.
Төзімділік және уақытша қорғау
Бұл енгізулер Translator сұранысыңызды шектегенде әрекеттің қалай әрекет ететінін және {{name}} немесе {0} сияқты уақытша токендердің аударма кезінде бұзылып қалуынан қалай қорғайтынын басқарады.
maxRetriesУақытша HTTP жауаптарына максималды қайта талпыныс (408, 425, 429, 500, 502, 503, 504). Сұранысқа HTTP қоңырауларының жалпы саны 1 + maxRetries.
retryBackoffMsКез келген бір артқа шегіну ұйқының лимиті (миллисекундтармен). Әрекет Azure-дың Retry-After жауап тақырыбын дәл бар кезде құрметтейді; әйтпесе, ол осы мәнге шектелген дірілдеген экспоненциалды кері шегінуді қолданады.
protectPlaceholderstrue (әдепкі) болғанда, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s және HTML объектілері аударма алдында сентинел токендерімен ауыстырылып, кейін қалпына келтіріледі. Тек дереккөзіңізде әдейі аудару тиіс мәтін мәтіні бар болса ғана өшіріңіз.
customPlaceholderPatternsЖаңа жолға бөлінген регулярлар (шектеушілерсіз) әдепкі уақытша жиынтыққа қосылды, мысалы, <<.+?>> арнайы токен синтаксисі үшін.
noTranslatePatternsЖаңа жолмен бөлінген глоб үлгілері парсер деңгейіндегі кілттерге сәйкес келді (JSON нүктелі жол, RESX name, PO msgid, XLIFF блогы id, INI/restext кілті). Сәйкес кілттер аудармашы сұранысынан алынып тасталады және бастапқы мәні сақталады.
Шығарылымдар
summary-titlePR атауына сай қысқа қысқаша шолу, мысалы, Machine-translated 320 files, a total of 5,418 translations.
summary-detailsPR ұйымы немесе жұмыс қорытындысы үшін сай markdown қысқаша мазмұны.
has-new-translations'true' бір немесе бірнеше жаңа аудармалар жасалғанда.