Зохион байгуулалт · Нөөцийн орчуулагч

Хэрэв анхдагч бус байршил хэрэгтэй бол 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 оролт руу буцдаг. Мөн Translator руу from=<locale> хэлбэрээр дамжуулсан бөгөөд богино мөрнүүдийг автоматаар илрүүлэхгүй.

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

Translator 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

Нэг удаагийн ухрах унталтын хязгаар (ms). Анхдагч 30000. Azure-ийн Retry-After толгойг яг байгаа үед хүндэтгэдэг; Өөрөөр хэлбэл гиттертэй экспоненциаль буцаалт ашиглагддаг бөгөөд энэ утгаар хязгаарлагддаг.

protectPlaceholders

Төрөл: boolean

Анхдагч true. Асаалттай үед {{name}}, ${var}, {0}, {0:N2}, %s, %1$s болон HTML нэгжүүд хөрвүүлэлтийн өмнө sentinel токеноор солигдож, дараа нь сэргээдэг. Зөвхөн эх сурвалж зориуд түр орлуулалтын хэлбэртэй литералуудыг агуулсан үед л идэвхгүй болго.

customPlaceholderPatterns

Төрөл: string[]

Нэмэлт regex загварууд (delimiter-гүй) анхдагч placeholder багцад нэмэгдсэн, жишээ нь <<.+?>> custom token синтакс. Буруу 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 нэр томъёог арилгадаг.

Хэлээ сонго

Репозиторийн тохиргоо

Схем

Талбарын лавлах

Ачаалах дараалал

Уур амьсгал ба үйлдвэрлэл, энгийнээр