Конфигурация · Ресурс аудармашы

Егер әдепкі емес орын қажет болса, configPath кірісімен жолды басып өтіңіз.

Схема

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# Translator request shape — most users can ignore these.
textType: plain                  # plain | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: Asterisk        # Asterisk | Tag (only when profanityAction == Marked)

# Resilience — Translator returns 429 under load. Defaults are usually
# fine; tune only if your runs are large enough to hit them.
maxRetries: 5
retryBackoffMs: 30000             # cap on any single backoff sleep (ms)

# Placeholder protection. ON by default — wraps tokens like {{name}},
# {0}, %s, ${var} into sentinels before translation and restores them
# on the way back. Set false only when source intentionally contains
# placeholder-shaped literals.
protectPlaceholders: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # any extra token syntax you use

# Per-key opt-out. Keys matching any glob are dropped from the request
# and pass through with the source value preserved.
noTranslatePatterns:
  - "errors.code.*"
  - "brands.*"

Өріс анықтамасы

provider

Түрі: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

sourceLocale

Түрі: string

Орнатылмаса, sourceLocale кірісіне қайта оралады. Сондай-ақ, қысқа жолдар автоматты түрде анықталмайды from=<locale> сондықтан Translator-ға жіберілді.

toLocales

Түрі: string[]

Не массив, не үтірмен бөлінген жол.

include / exclude

Түрі: string[]

Глоб үлгілері абсолютті және жұмыс кеңістігіне қатысты жолдар бойынша бағаланды.

glossary

Түрі: map<string,string>

Аудармадан кейінгі терминдердің артықшылықтары. Сөз шекарасын білу (C++, .NET деп аталады).

categoryId

Түрі: string

Azure Custom Translator категориясы — сіздің сала/домен тұтқаңыз (заңдық, медициналық, маркетингтік тон және т.б.). Жіберілді ?category=....

textType

Түрі: "plain" | "html"

Әдепкі plain. Тек ресурс мәндері шынайы HTML фрагменттері болса ғана html қолданыңыз.

profanityAction

Түрі: "NoAction" | "Marked" | "Deleted"

Аударылған нәтижедегі әдепсіз терминдерді қалай өңдеуге болады.

profanityMarker

Түрі: "Asterisk" | "Tag"

Мағынасы тек profanityAction болса "Marked".

allowFallback

Түрі: boolean

Егер categoryId мақсатты орынға орналастырылмаса, аудармада сәтсіздікке false күйінде орнатыңыз, жалпы модельге оралыңыз.

apiVersion

Түрі: string

Аудармашы REST API нұсқасы. Әдепкі 3.0.

awsFormality

Түрі: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

Түрі: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

Түрі: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

Түрі: string

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

googleApiEndpoint

Түрі: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

Түрі: boolean

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

maxRetries

Түрі: integer

Уақытша HTTP жауаптарына максималды қайта талпыныс (408, 425, 429, 500, 502, 503, 504). Әдепкі 5. Бір сұранысқа жалпы HTTP шақырулары 1 + maxRetries.

retryBackoffMs

Түрі: integer

Әрбір артқа шегіну ұйқысына (МС) кіріңіз. Әдепкі 30000. Azure-дың Retry-After тақырыбы дәл бар кезде құрметтеледі; Басқа жағдайда дірілдеген экспоненциалды кері шегіну осы мәнге дейін шектеледі.

protectPlaceholders

Түрі: boolean

Әдепкі true. Қосылған кезде, {{name}}, ${var}, {0}, {0:N2}, %s, %1$s және HTML сияқты токендер аудармас бұрын сентинел токендерімен ауыстырылып, кейін қалпына келтіріледі. Тек дереккөз әдейі орынбасар пішінді литералдар болғанда ғана өшіру керек.

customPlaceholderPatterns

Түрі: string[]

Қосымша regex үлгілері (шектірушілерсіз) әдепкі уақытша жиынтыққа қосылды, мысалы, <<.+?>> арнайы токен синтаксисі үшін. Жарамсыз регекстер ескерілмейді.

noTranslatePatterns

Түрі: string[]

Глоб үлгілері парсер деңгейіндегі кілттерге сәйкес келеді (JSON нүктелі жол, RESX name, PO msgid, XLIFF id, INI/restext кілті). Сәйкес кілттер сұраныстан алынып тасталады және бастапқы мәні сақталады.

changeDetection

Түрі: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

Түрі: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

Жүктеу тәртібі

Әрекет жұмыс процесінен алынған нақты енгізулерді оқиды.
Ол YAML конфигурациясын configPath-ден жүктейді.
Әрбір ортақ өріс үшін кіріс жеңеді; әйтпесе YAML мәні қолданылады.
Біріктірілген мәндер расталады. Жарамсыз enum-дар (мысалы, profanityAction: Mask) әрекетті анық хабарламамен тез сәтсіздікке ұшыратады.

Тон мен өнеркәсіп, қарапайым тілмен айтқанда

Azure AI Translator v3 API-де бір ғана тон тұтқасы жоқ. Екі параметр бірігіп, бірдей басқаруды қамтамасыз етеді:

Өнеркәсіп / домен: categoryId пайдаланып, өз корпусыңызда оқытылған Azure Custom Translator категориясын көрсетіңіз — заңдық, техникалық, медициналық, маркетинг немесе басқа кез келген салада. Бұл тон, бренд дауысы және сөздік қорының ең мықты рычагы.
Беткі мәтін: Бренд атаулары мен өнім терминдерін сөзбе-сөз бекіту үшін Сөздік қолданыңыз, ал profanityAction арқылы жас аудиторияға бағытталған локализацияны мақсат еткенде дөрекі сөздерді жою үшін қолданыңыз.

Тіліңді таңда

Репозиторий конфигурациясы

Схема

Өріс анықтамасы

Жүктеу тәртібі

Тон мен өнеркәсіп, қарапайым тілмен айтқанда