ᠬᠡᠷᠪᠡ ᠪᠢᠲᠡᠭᠡᠢ ᠲᠣᠭᠲᠠᠭᠠᠭᠰᠠᠨ ᠣᠷᠣᠨ ᠪᠠᠶᠢᠷᠢᠯᠠᠯ ᠴᠢᠬᠤᠯᠠ ᠲᠠᠢ ᠪᠣᠯ configPath ᠤᠨ ᠣᠷᠴᠢᠯᠠᠯ ᠦᠭᠡ ᠪᠡᠷ ᠵᠠᠮ ᠢ ᠬᠠᠯᠠᠵᠤ ᠵᠠᠰᠠᠬᠤ
Schema
# .github/resource-translator.ymlsourceLocale: entoLocales: - fr - de - esinclude: - "src/**/*.en.json" - "apps/**/*.en.resx"exclude: - "**/__tests__/**"glossary: Acme: Contoso Octocat: Octocat # keep brand names verbatim
# Domain / industry — uses an Azure Custom Translator category trained on# your tone and vocabulary. Leave unset for the general model.categoryId: my-custom-translator-category
# Translator request shape — most users can ignore these.textType: plain # plain | htmlprofanityAction: NoAction # NoAction | Marked | DeletedprofanityMarker: Asterisk # Asterisk | Tag (only when profanityAction == Marked)allowFallback: true # false fails when the categoryId has no deployment
apiVersion: "3.0"
# Resilience — Translator returns 429 under load. Defaults are usually# fine; tune only if your runs are large enough to hit them.maxRetries: 5retryBackoffMs: 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: truecustomPlaceholderPatterns: - "<<.+?>>" # 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.*"ᠹᠷᠠᠨᠲ᠋ ᠤᠨ ᠲᠤᠬᠠᠢ ᠨᠢᠭᠤᠴᠠ
| สนาม | ប្រភេទ | หมายเหตุ |
|---|---|---|
sourceLocale | string | ᠬᠡᠷᠪᠡ ᠲᠣᠭᠲᠠᠭᠠ ᠦᠭᠡᠢ ᠪᠤᠯ sourceLocale ᠳᠤ ᠪᠤᠴᠠᠵᠤ ᠢᠷᠡᠨᠡ ᠪᠠᠰᠠ ᠣᠷᠴᠢᠭᠤᠯᠤᠭᠴᠢ ᠶᠢᠨ 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 | ᠲᠠᠨ ᠤ false ᠳᠤ ᠪᠠᠶᠢᠬᠤ ᠦᠭᠡᠢ ᠪᠡᠷ categoryId ᠴᠢᠨᠢ ᠬᠠᠷᠠᠯᠲᠠ ᠶᠢᠨ ᠭᠠᠵᠠᠷ ᠣᠷᠣᠨ ᠳᠤ ᠭᠠᠷᠭᠠᠬᠤ ᠦᠭᠡᠢ ᠦᠶᠡ ᠳᠦ ᠣᠷᠴᠢᠭᠤᠯᠤᠯᠲᠠ ᠳᠤ ᠪᠦᠷᠢᠮᠦᠰᠦᠨ ᠪᠦᠷᠢᠮᠦᠰᠦᠨ ᠦᠭ᠍ᠭᠦᠨᠡ ᠂ ᠬᠠᠷᠢᠨ ᠶᠡᠷᠦ ᠶᠢᠨ ᠬᠡᠯᠪᠡᠷᠢ ᠳᠦ ᠪᠠᠰᠠ ᠳᠠᠬᠢᠨ ᠪᠠᠭᠤᠬᠤ ᠪᠢᠰᠢ ᠃ |
apiVersion | string | Translator REST API version. ᠪᠣᠯᠵᠣᠭᠠ ᠶᠢ 3.0 ᠃ |
maxRetries | integer | ᠲᠦᠷ ᠴᠠᠭ ᠤᠨ U,ᠵᠧᠨᠧᠰ ᠦᠨ ᠬᠠᠷᠢᠭᠤ ᠳᠤᠰᠭᠠᠯ ᠳᠤ ᠬᠠᠮᠤᠭ ᠤᠨ ᠶᠡᠬᠡ 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 ᠵᠡᠷᠭᠡ ᠦᠢᠯᠡᠳᠪᠦᠷᠡ ᠶᠢ ᠴᠡᠷᠢᠭ ᠦᠨ ᠬᠠᠶᠢᠭ ᠢᠶᠠᠷ ᠣᠷᠣᠯᠠᠵᠤ ᠂ ᠣᠷᠣᠯᠠᠭᠰᠠᠨ ᠤ ᠳᠠᠷᠠᠭᠠ ᠳᠠᠬᠢᠨ ᠰᠡᠷᠭᠦᠨᠡ ᠃ ᠰᠠᠶᠢ ᠡᠬᠢᠯᠡᠯᠲᠡ ᠳᠦ ᠵᠣᠷᠢᠭᠤᠳᠠ ᠲᠣᠭᠲᠠᠭᠰᠠᠨ ᠣᠷᠣᠨ ᠬᠡᠯᠪᠡᠷᠢ ᠶᠢᠨ nghĩa đen ᠪᠠᠶᠢᠨᠠ ᠃ |
customPlaceholderPatterns | string[] | ᠨᠡᠮᠡᠯᠲᠡ ᠡᠷᠡ ᠶᠢᠨ ᠨᠢᠭᠡᠴᠢ ᠨᠢᠭᠡᠴᠢ (ᠲᠣᠭᠠ ᠶᠢᠨ ᠲᠣᠭᠠ ᠦᠭᠡᠢ) ᠶᠢ ᠲᠣᠭᠲᠠᠭᠠᠭᠰᠠᠨ ᠲᠣᠭᠲᠠᠭᠰᠠᠨ ᠬᠡᠮᠵᠢᠶᠡ ᠳᠦ ᠣᠷᠣᠭᠤᠯᠵᠠᠢ ᠂ ᠵᠢᠵᠢᠭ᠌ <<.+?>> ᠳᠤᠷᠠ ᠪᠠᠷ ᠢᠶᠠᠨ ᠬᠡᠷᠡᠭᠯᠡᠬᠦ ᠲᠡᠮᠳᠡᠭ᠍ ᠤᠳᠬᠠ ᠶᠢ ᠨᠡᠮᠡᠵᠦ ᠣᠷᠣᠭᠤᠯᠤᠨᠠ ᠃ ᠬᠦᠴᠦᠨ ᠦᠭᠡᠢ ᠡᠷᠦᠬᠡ ᠶᠢᠨ ᠳᠠᠩᠰᠠᠯᠠᠯ ᠢ ᠬᠠᠮᠢᠶᠠᠷᠬᠤ ᠠᠴᠠ ᠲᠠᠲᠠᠭᠠᠯᠵᠠᠨᠠ ᠃ |
noTranslatePatterns | string[] | ᠰᠠᠯᠪᠤᠷᠢ ᠶᠢᠨ ᠢᠯᠭᠠᠯ ᠤᠨ ᠰᠢᠰᠲ᠋ᠧᠮ ( JSON ចំនុច pathᠯ ᠂ RESX name ᠂ PO msgid ᠂ XLIFF unit id ᠂ INI / restext key ) ᠲᠡᠢ ᠵᠠᠯᠭᠠᠭᠰᠠᠨ ᠦᠯᠢᠭᠡᠷ ᠲᠥᠰᠦᠯ ᠵᠠᠯᠭᠠᠯᠳᠤ ᠳᠠᠮᠵᠢᠭᠤᠯᠭᠠ ᠶᠢ ᠡᠷᠢᠯᠢᠭ᠍ ᠳᠡᠭᠡᠷᠡ ᠡᠴᠡ ᠣᠷᠬᠢᠵᠤ ᠂ ᠤᠭ ᠰᠣᠷᠪᠣᠯᠵᠢ ᠶᠢᠨ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠨᠢ ᠦᠯᠡᠳᠡᠭᠡᠨᠡ ᠃ |
Load ᠠᠴᠢᠬᠤ ᠵᠠᠷᠯᠢᠭ
- ᠬᠦᠳᠡᠯᠭᠡᠭᠡᠨ ᠠᠵᠢᠯ ᠤᠨ ᠶᠠᠪᠤᠴᠠ ᠶᠢᠨ ᠢᠯᠡ ᠬᠦᠰᠦᠨᠦᠭᠲᠦ ᠶᠢ ᠤᠩᠰᠢᠨᠠ᠃
- ᠲᠡᠷᠡ ᠠᠮᠸᠷᠢᠺᠡ ᠡᠴᠡ YAML ᠶᠢᠨ ᠲᠠᠨ ᠤ ᠲᠦᠰᠦᠪᠯᠡᠯ ᠢ
configPathᠭᠠᠷᠭᠠᠨᠠ᠃ - ᠣᠯᠠᠨ ᠨᠡᠢ᠌ᠲᠡᠯᠡᠬᠦ ᠬᠦᠷᠢᠶᠡ ᠴᠠᠷᠠᠭᠠ ᠪᠥᠷᠢ ᠳᠦ ᠣᠷᠣᠭᠤᠯᠤᠯᠲᠠ ᠨᠢ ᠢᠯᠠᠨᠠ ᠃ ᠡᠰᠡ ᠲᠡᠭᠡᠪᠡᠯ YAML ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠬᠡᠷᠡᠭ᠍ᠯᠡᠨᠡ ᠃
- ᠨᠡᠢ᠌ᠯᠡᠭᠦᠯᠦᠭ᠍ᠰᠡᠨ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠦᠨᠳᠦᠰᠦᠯᠡᠨ ᠲᠣᠭᠲᠠᠭᠠᠭᠳᠠᠨᠠ ᠃ ᠬᠦᠴᠦᠨ ᠦᠭᠡᠶ enum ( ᠲᠣᠬᠠᠶᠢᠯᠠᠪᠠᠯ ᠂
profanityAction: Mask) ᠦᠢᠯᠡ ᠠᠵᠢᠯᠯᠠᠭᠠ ᠶᠢ ᠢᠯᠡ ᠪᠣᠯᠭᠠᠬᠤ ᠪᠠᠷ ᠲᠦᠷᠭᠡᠨ ᠥᠭᠡᠷᠡᠴᠢᠯᠡᠯ ᠦᠭᠡᠶ ᠪᠣᠯᠭᠠᠨᠠ ᠃
ᠠᠶᠠᠰ ᠪᠣᠯᠣᠨ ᠠᠵᠤ ᠦᠢᠯᠡᠳᠪᠦᠷᠢ ᠶᠢ ᠬᠡᠯᠡᠪᠡᠯ
Azure AI ᠣᠷᠴᠢᠭᠴᠢ v3 API ᠳᠤ ᠥᠩᠭᠡᠲᠦ ᠳᠠᠭᠤᠨ ᠭᠠᠷᠤᠭ ᠡᠭᠦᠷᠭᠡ ᠪᠠᠢ᠌ᠬᠤ ᠦᠭᠡᠢ ᠃ ᠬᠣᠶᠠᠷ ᠪᠠᠢᠢᠭᠤᠯᠤᠯᠲᠠ ᠨᠡᠢ᠌ᠯᠡᠪᠡᠯ ᠂ ᠣᠯᠠᠨᠭ᠍ᠬᠢ ᠪᠦᠷ ᠠᠳᠠᠯᠢᠬᠠᠨ ᠡᠷᠬᠡᠰᠢᠶᠡᠯ ᠢ ᠤᠯᠭᠤᠨᠠ᠄
- ᠠᠵᠤ ᠦᠢᠯᠡᠳᠪᠦᠷᠢ / โดเมน ( ᠬᠦᠷᠢᠶᠡ ) ᠄
categoryIdᠢᠶᠡᠷ ᠥᠪᠡᠷ ᠦᠨ ᠬᠥᠮᠥᠨ ᠦ ᠬᠥᠮᠥᠵᠢᠭᠦᠯᠯ ᠢ ᠣᠯᠣᠭᠰᠠᠨ ᠠᠵᠤ ᠠᠬᠤᠢ ᠶᠢᠨ Custom Translator ᠶᠢᠨ ᠲᠦᠷᠣᠯ ᠢ ᠵᠢᠭᠠᠵᠤ ᠂ ᠬᠠᠤᠯᠢ ᠴᠠᠭᠠᠵᠠ ᠂ ᠮᠡᠷᠭᠡᠵᠢᠯ ᠂ ᠡᠮᠨᠡᠯᠭᠡ ᠂ ᠵᠠᠬᠠ ᠳᠡᠯᠭᠡᠭᠦᠷ ᠦᠨ ᠶᠠᠮᠠᠷ ᠴᠤ ᠵᠦᠢᠯ ᠢ ᠵᠢᠭᠠᠨ ᠡᠨᠡ ᠪᠣᠯ ᠳᠠᠭᠤᠤ ᠠᠶᠠᠰ ᠂ ᠮᠠᠷᠳ᠋ᠢᠶᠠᠨ ᠤ ᠬᠣᠭᠣᠯᠠᠢ ᠪᠣᠯᠣᠨ ᠦᠭᠡᠰ ᠦᠨ ᠬᠢᠨᠢ ᠬᠠᠮᠤᠭ ᠤᠨ ᠬᠦᠴᠦᠲᠡᠢ ᠬᠥᠰᠢᠭᠦᠷᠭᠡ ᠶᠤᠮ ᠃ - ᠥᠩᠭᠡᠨ ᠲᠠᠯᠠ ᠶᠢᠨ ᠵᠣᠬᠢᠶᠠᠯ᠄ ᠨᠡᠷᠡ ᠲᠣᠮᠢᠶᠠ ᠢ ᠠᠰᠢᠭᠯᠠᠨ ᠨᠡᠷᠡᠲᠦ ᠲᠡᠮᠳᠡᠭᠲᠦ ᠶᠢᠨ ᠨᠡᠷᠡᠶᠢᠳᠦᠯ ᠪᠠ ᠦᠢᠯᠡᠳᠬᠦᠨ ᠦ ᠦᠰᠦᠭ ᠦᠨ ᠦᠰᠦᠭ ᠢ ᠨᠢᠭᠡ ᠲᠥᠷᠥᠯ ᠦᠨ ᠦᠰᠦᠭ ᠢᠶᠡᠷ ᠨᠢ ᠴᠣᠬᠣᠮ ᠨᠢ ᠴᠣᠬᠣᠮ ᠪᠠᠶᠢᠯᠭᠠᠵᠤ᠂
profanityActionᠢ ᠠᠰᠢᠭᠯᠠᠨ ᠱᠠᠯᠢᠭ ᠦᠭᠡᠶ ᠦᠭᠡ ᠬᠡᠯᠡᠯᠭᠡ ᠶᠢ ᠬᠣᠷᠢᠭᠯᠠᠬᠤ ᠬᠡᠷᠡᠭᠲᠡᠶ᠃