ᠬᠡᠷᠪᠡ ᠪᠢᠲᠡᠭᠡᠢ ᠲᠣᠭᠲᠠᠭᠠᠭᠰᠠᠨ ᠣᠷᠣᠨ ᠪᠠᠶᠢᠷᠢᠯᠠᠯ ᠴᠢᠬᠤᠯᠠ ᠲᠠᠢ ᠪᠣᠯ configPath ᠤᠨ ᠣᠷᠴᠢᠯᠠᠯ ᠦᠭᠡ ᠪᠡᠷ ᠵᠠᠮ ᠢ ᠬᠠᠯᠠᠵᠤ ᠵᠠᠰᠠᠬᠤ
Schema
# .github/resource-translator.ymlsourceLocale: 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 - esinclude: - "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 | htmlprofanityAction: NoAction # NoAction | Marked | DeletedprofanityMarker: 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: 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.*"ᠹᠷᠠᠨᠲ᠋ ᠤᠨ ᠲᠤᠬᠠᠢ ᠨᠢᠭᠤᠴᠠ
providerEither 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ᠬᠡᠷᠪᠡ ᠲᠣᠭᠲᠠᠭᠠ ᠦᠭᠡᠢ ᠪᠤᠯ sourceLocale ᠳᠤ ᠪᠤᠴᠠᠵᠤ ᠢᠷᠡᠨᠡ ᠪᠠᠰᠠ ᠣᠷᠴᠢᠭᠤᠯᠤᠭᠴᠢ ᠶᠢᠨ from=<locale> ᠪᠠᠷ ᠳᠠᠮᠵᠢᠭᠤᠯᠤᠨ ᠥᠭ᠍ᠴᠦ ᠂ ᠪᠣᠭᠣᠨᠢ ᠤᠲᠠᠰᠤᠨ ᠤ ᠤᠲᠠᠰᠤ ᠶᠢ ᠥᠪᠡᠷ ᠢᠶᠡᠨ ᠮᠡᠳᠡᠭ᠍ᠳᠡᠬᠦ ᠦᠭᠡᠢ ᠃
toLocalesᠨᠢᠭᠡ ᠠᠰᠠᠷ ᠪᠤᠶᠤ ᠨᠢᠭᠡ ᠰᠠᠶᠠ ᠦᠰᠦᠭ ᠦᠨ ᠦᠰᠦᠭ᠍ ᠃
include / excludeᠬᠠᠷᠢᠴᠠᠯᠠᠰᠢ ᠦᠭᠡᠶ ᠪᠠ ᠠᠵᠢᠯ ᠤᠨ ᠣᠷᠣᠨ ᠵᠠᠶ ᠪᠠᠷ ᠬᠠᠷᠢᠴᠠᠩᠭᠤᠶ ᠱᠤᠭᠤᠮ ᠢᠶᠠᠷ ᠦᠨᠡᠯᠡᠬᠦ ᠭᠥᠷᠲᠡᠭ ᠦᠨ ᠰᠦᠷᠡᠯ ᠦᠨ ᠬᠡᠯᠪᠡᠷᠢ ᠃
glossaryᠣᠷᠴᠢᠭᠤᠯᠤᠭᠰᠠᠨ ᠤ ᠳᠠᠷᠠᠭᠠ ᠦᠭᠡ ᠶᠢ ᠣᠷᠣᠯᠠᠬᠤ ᠦᠰᠦᠭ ᠦᠨ ᠵᠠᠭᠠᠭ ᠢ ᠮᠡᠳᠡᠬᠦ ( ᠭᠠᠷ ᠤᠨ C++ ᠂ .NET ) ᠃
categoryIdAzure Custom Translator ᠶᠢᠨ ᠲᠦᠷᠦᠯ︱ ᠲᠠᠨ ᠤ ᠠᠵᠢᠯ ᠲᠥᠷᠥᠯ ᠦᠨ ᠳᠣᠲᠣᠨᠤ ( ᠬᠠᠤᠯᠢ ᠴᠠᠭᠠᠵᠠ ᠂ ᠡᠮᠨᠡᠯᠭᠡ ᠂ ᠵᠠᠬᠠ ᠳᠡᠯᠭᠡᠭᠦᠷ ᠦᠨ ᠠᠭᠤᠷ ᠠᠮᠢᠰᠬᠤᠯ ᠤᠨ ᠠᠷᠭᠠ ᠬᠡᠮᠵᠢᠶᠡ ) ᠃ ?category=... ᠪᠠᠷ ᠬᠦᠷᠭᠡᠬᠦ
textTypeᠪᠣᠯᠵᠣᠭᠠ ᠶᠢ plain ᠃ html ᠤᠨ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠳᠡᠭᠡᠨ ᠦᠨᠡᠨ HTML ᠵᠤᠷᠪᠤᠰ ᠪᠠᠶᠢᠬᠤ ᠦᠶᠡᠰ ᠰᠠᠶᠢ ᠬᠡᠷᠡᠭ᠍ᠯᠡ ᠃
profanityActionᠣᠷᠴᠢᠭᠤᠯᠭᠠ ᠶᠢᠨ ᠭᠠᠷᠭᠠᠯᠲᠠ ᠶᠢᠨ ᠳᠤᠮᠳᠠ ᠱᠠᠲᠤᠯᠢᠭ ᠦᠭᠡ ᠬᠡᠯᠡᠨ ᠳᠦ ᠬᠡᠷᠬᠢᠨ ᠬᠠᠨᠳᠤᠬᠤ ᠪᠤᠢ ᠃
profanityMarkerᠵᠥᠪᠬᠡᠨ profanityAction ᠪᠣᠯᠬᠤ ᠦᠶᠡ ᠳᠦ ᠰᠠᠶᠢ ᠤᠳᠭ᠋ᠠ ᠠᠭᠤᠯᠭᠠ ᠲᠠᠢ "Marked"
allowFallbackᠲᠠᠨ ᠤ false ᠳᠤ ᠪᠠᠶᠢᠬᠤ ᠦᠭᠡᠢ ᠪᠡᠷ categoryId ᠴᠢᠨᠢ ᠬᠠᠷᠠᠯᠲᠠ ᠶᠢᠨ ᠭᠠᠵᠠᠷ ᠣᠷᠣᠨ ᠳᠤ ᠭᠠᠷᠭᠠᠬᠤ ᠦᠭᠡᠢ ᠦᠶᠡ ᠳᠦ ᠣᠷᠴᠢᠭᠤᠯᠤᠯᠲᠠ ᠳᠤ ᠪᠦᠷᠢᠮᠦᠰᠦᠨ ᠪᠦᠷᠢᠮᠦᠰᠦᠨ ᠦᠭ᠍ᠭᠦᠨᠡ ᠂ ᠬᠠᠷᠢᠨ ᠶᠡᠷᠦ ᠶᠢᠨ ᠬᠡᠯᠪᠡᠷᠢ ᠳᠦ ᠪᠠᠰᠠ ᠳᠠᠬᠢᠨ ᠪᠠᠭᠤᠬᠤ ᠪᠢᠰᠢ ᠃
apiVersionTranslator REST API version. ᠪᠣᠯᠵᠣᠭᠠ ᠶᠢ 3.0 ᠃
awsFormalityAWS Translate formality setting for supported target languages.
awsBrevitySet to true to enable AWS Translate brevity mode for supported language pairs.
awsTerminologyNames / awsParallelDataNamesAWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.
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.
maxRetriesᠲᠦᠷ ᠴᠠᠭ ᠤᠨ U,ᠵᠧᠨᠧᠰ ᠦᠨ ᠬᠠᠷᠢᠭᠤ ᠳᠤᠰᠭᠠᠯ ᠳᠤ ᠬᠠᠮᠤᠭ ᠤᠨ ᠶᠡᠬᠡ 408, 425, 429, 500, 502, 503, 504 ᠲᠤᠷᠰᠢᠯᠲᠠ ᠶᠢ ᠣᠷᠣᠯᠳᠣᠨᠠ ᠃ ᠲᠣᠭᠲᠠᠭᠠᠯ ᠢ 5 ᠃ ᠴᠣᠪᠣᠭᠠ ᠡᠷᠢᠭ᠍ᠴᠢ ᠪᠥᠷᠢ ᠶᠢᠨ HTTP ᠳᠠᠭᠤᠳᠠᠯᠲᠠ 1 + maxRetries ᠃
retryBackoffMsᠥᠨᠳᠥᠷ ᠲᠦ ᠠᠷᠢᠬᠢᠨ ᠠᠴᠠ ᠪᠠᠨ ᠣᠷᠣᠭᠰᠠᠨ ᠬᠡᠰᠡᠭ ᠦᠨ ᠬᠡᠳᠦᠢ ᠳᠦ ᠠᠮᠠᠯᠯᠠᠬᠤ ( ms ᠪᠣᠯᠵᠣᠭᠠ ᠶᠢ 30000 ᠃ Azure ᠶᠢᠨ Retry-After ᠶᠢᠨ ᠲᠣᠯᠣᠭᠠᠢ ᠶᠢᠨ ᠪᠥᠬᠥ ᠲᠡᠮᠳᠡᠭ᠍ᠯᠡᠯ ᠢ ᠪᠠᠢ᠌ᠬᠤ ᠦᠶᠡ ᠳᠦ ᠶᠠᠭ ᠬᠦᠨᠳᠦᠳᠬᠡᠯ ᠲᠡᠢ ᠃ ᠲᠡᠢ᠌ᠮᠦ ᠪᠢᠰᠢ ᠪᠣᠯ ᠱᠣᠷᠣᠩᠬᠠᠢ ᠳᠠᠬᠢᠨ ᠬᠣᠴᠣᠷᠣᠭᠰᠠᠨ ᠬᠣᠴᠣᠷᠣᠯᠭᠠ ᠶᠢᠨ ᠬᠣᠴᠣᠷᠬᠤ ᠶᠢ ᠬᠡᠷᠡᠭ᠍ᠯᠡᠵᠦ ᠂ ᠡᠨᠡ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠦᠨ ᠳᠡᠭᠡᠷᠡ ᠲᠠᠯᠠ ᠪᠠᠷ ᠬᠢᠵᠠᠭᠠᠷᠯᠠᠨᠠ ᠃
protectPlaceholdersᠪᠣᠯᠵᠣᠭᠠ ᠶᠢ true ᠃ ᠵᠠᠯᠭᠠᠨ ᠡᠬᠢᠯᠡᠬᠦ ᠦᠶᠡ ᠳᠦ ᠂ {{name}} ᠂ ${var} ᠂ {0} ᠂ {0:N2} ᠂ %s ᠂ %1$s HTML ᠵᠡᠷᠭᠡ ᠦᠢᠯᠡᠳᠪᠦᠷᠡ ᠶᠢ ᠴᠡᠷᠢᠭ ᠦᠨ ᠬᠠᠶᠢᠭ ᠢᠶᠠᠷ ᠣᠷᠣᠯᠠᠵᠤ ᠂ ᠣᠷᠣᠯᠠᠭᠰᠠᠨ ᠤ ᠳᠠᠷᠠᠭᠠ ᠳᠠᠬᠢᠨ ᠰᠡᠷᠭᠦᠨᠡ ᠃ ᠰᠠᠶᠢ ᠡᠬᠢᠯᠡᠯᠲᠡ ᠳᠦ ᠵᠣᠷᠢᠭᠤᠳᠠ ᠲᠣᠭᠲᠠᠭᠰᠠᠨ ᠣᠷᠣᠨ ᠬᠡᠯᠪᠡᠷᠢ ᠶᠢᠨ nghĩa đen ᠪᠠᠶᠢᠨᠠ ᠃
customPlaceholderPatternsᠨᠡᠮᠡᠯᠲᠡ ᠡᠷᠡ ᠶᠢᠨ ᠨᠢᠭᠡᠴᠢ (ᠲᠣᠭᠠ ᠶᠢᠨ ᠲᠣᠭᠠ ᠶᠢᠨ ᠲᠡᠮᠳᠡᠭ᠍ ᠦᠭᠡᠢ ) ᠢ ᠨᠡᠮᠡᠵᠦ ᠣᠷᠣᠯᠳᠣᠭᠰᠠᠨ ᠰᠠᠭᠤᠷᠢᠨ ᠭᠠᠵᠠᠷ ᠲᠤ ᠣᠷᠣᠰᠢᠭᠤᠯᠬᠤ ᠨᠢᠭᠡᠴᠢ ᠂ ᠵᠢᠵᠢᠶᠠᠩ <<.+?>> ᠬᠡᠷᠡᠭ᠍ᠯᠡᠨᠡ ᠃ ᠬᠦᠴᠦᠨ ᠦᠭᠡᠢ ᠡᠷᠦᠬᠡ ᠶᠢᠨ ᠳᠠᠩᠰᠠᠯᠠᠯ ᠢ ᠬᠠᠮᠢᠶᠠᠷᠬᠤ ᠠᠴᠠ ᠲᠠᠲᠠᠭᠠᠯᠵᠠᠨᠠ ᠃
noTranslatePatternsᠰᠠᠯᠪᠤᠷᠢ ᠶᠢᠨ ᠢᠯᠭᠠᠯ ᠤᠨ ᠰᠢᠰᠲ᠋ᠧᠮ ( JSON ចំនុច pathᠯ ᠂ RESX name ᠂ PO msgid ᠂ XLIFF unit id ᠂ INI / restext key ) ᠲᠠᠢ ᠵᠠᠯᠭᠠᠭᠰᠠᠨ ᠦᠯᠢᠭᠡᠷ ᠲᠥᠰᠦᠯ ᠵᠠᠯᠭᠠᠯᠳᠤ ᠳᠠᠮᠵᠢᠭᠤᠯᠭᠠ ᠶᠢ ᠡᠷᠢᠯᠢᠭ᠍ ᠳᠡᠭᠡᠷᠡ ᠡᠴᠡ ᠣᠷᠬᠢᠵᠤ ᠂ ᠤᠭ ᠰᠣᠷᠪᠣᠯᠵᠢ ᠶᠢᠨ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠨᠢ ᠦᠯᠡᠳᠡᠭᠡᠨᠡ ᠃
changeDetectionDefaults 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.
statePathPath to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.
Load ᠠᠴᠢᠬᠤ ᠵᠠᠷᠯᠢᠭ
- ᠬᠦᠳᠡᠯᠭᠡᠭᠡᠨ ᠠᠵᠢᠯ ᠤᠨ ᠶᠠᠪᠤᠴᠠ ᠶᠢᠨ ᠢᠯᠡ ᠬᠦᠰᠦᠨᠦᠭᠲᠦ ᠶᠢ ᠤᠩᠰᠢᠨᠠ᠃
- ᠲᠡᠷᠡ ᠠᠮᠸᠷᠢᠺᠡ ᠡᠴᠡ YAML ᠶᠢᠨ ᠲᠠᠨ ᠤ ᠲᠦᠰᠦᠪᠯᠡᠯ ᠢ
configPathᠭᠠᠷᠭᠠᠨᠠ᠃ - ᠣᠯᠠᠨ ᠨᠡᠢ᠌ᠲᠡᠯᠡᠬᠦ ᠬᠦᠷᠢᠶᠡ ᠴᠠᠷᠠᠭᠠ ᠪᠥᠷᠢ ᠳᠦ ᠣᠷᠣᠭᠤᠯᠤᠯᠲᠠ ᠨᠢ ᠢᠯᠠᠨᠠ ᠃ ᠡᠰᠡ ᠲᠡᠭᠡᠪᠡᠯ YAML ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠬᠡᠷᠡᠭ᠍ᠯᠡᠨᠡ ᠃
- ᠨᠡᠢ᠌ᠯᠡᠭᠦᠯᠦᠭ᠍ᠰᠡᠨ ᠬᠡᠮᠵᠢᠭᠳᠡᠯ ᠢ ᠦᠨᠳᠦᠰᠦᠯᠡᠨ ᠲᠣᠭᠲᠠᠭᠠᠭᠳᠠᠨᠠ ᠃ ᠬᠦᠴᠦᠨ ᠦᠭᠡᠶ enum ( ᠲᠣᠬᠠᠶᠢᠯᠠᠪᠠᠯ ᠂
profanityAction: Mask) ᠦᠢᠯᠡ ᠠᠵᠢᠯᠯᠠᠭᠠ ᠶᠢ ᠢᠯᠡ ᠪᠣᠯᠭᠠᠬᠤ ᠪᠠᠷ ᠲᠦᠷᠭᠡᠨ ᠥᠭᠡᠷᠡᠴᠢᠯᠡᠯ ᠦᠭᠡᠶ ᠪᠣᠯᠭᠠᠨᠠ ᠃
ᠠᠶᠠᠰ ᠪᠣᠯᠣᠨ ᠠᠵᠤ ᠦᠢᠯᠡᠳᠪᠦᠷᠢ ᠶᠢ ᠬᠡᠯᠡᠪᠡᠯ
Azure AI ᠣᠷᠴᠢᠭᠴᠢ v3 API ᠳᠤ ᠥᠩᠭᠡᠲᠦ ᠳᠠᠭᠤᠨ ᠭᠠᠷᠤᠭ ᠡᠭᠦᠷᠭᠡ ᠪᠠᠢ᠌ᠬᠤ ᠦᠭᠡᠢ ᠃ ᠬᠣᠶᠠᠷ ᠪᠠᠢᠢᠭᠤᠯᠤᠯᠲᠠ ᠨᠡᠢ᠌ᠯᠡᠪᠡᠯ ᠂ ᠶᠡᠬᠡᠩᠬᠢ ᠯᠡ ᠠᠳᠠᠯᠢᠬᠠᠨ ᠡᠷᠬᠡᠰᠢᠶᠡᠯ ᠢ ᠴᠢᠨᠢ ᠣᠯᠭᠣᠨᠠ ᠄
- ᠠᠵᠤ ᠦᠢᠯᠡᠳᠪᠦᠷᠢ / โดเมน ( ᠬᠦᠷᠢᠶᠡ ) ᠄
categoryIdᠢᠶᠡᠷ ᠥᠪᠡᠷ ᠦᠨ ᠬᠥᠮᠥᠨ ᠦ ᠬᠥᠮᠥᠵᠢᠭᠦᠯᠯ ᠢ ᠣᠯᠣᠭᠰᠠᠨ ᠠᠵᠤ ᠠᠬᠤᠢ ᠶᠢᠨ Custom Translator ᠶᠢᠨ ᠲᠦᠷᠣᠯ ᠢ ᠵᠢᠭᠠᠵᠤ ᠂ ᠬᠠᠤᠯᠢ ᠴᠠᠭᠠᠵᠠ ᠂ ᠮᠡᠷᠭᠡᠵᠢᠯ ᠂ ᠡᠮᠨᠡᠯᠭᠡ ᠂ ᠵᠠᠬᠠ ᠳᠡᠯᠭᠡᠭᠦᠷ ᠦᠨ ᠶᠠᠮᠠᠷ ᠴᠤ ᠵᠦᠢᠯ ᠢ ᠵᠢᠭᠠᠨ ᠡᠨᠡ ᠪᠣᠯ ᠳᠠᠭᠤᠤ ᠠᠶᠠᠰ ᠂ ᠮᠠᠷᠳ᠋ᠢᠶᠠᠨ ᠤ ᠬᠣᠭᠣᠯᠠᠢ ᠪᠣᠯᠣᠨ ᠦᠭᠡᠰ ᠦᠨ ᠬᠢᠨᠢ ᠬᠠᠮᠤᠭ ᠤᠨ ᠬᠦᠴᠦᠲᠡᠢ ᠬᠥᠰᠢᠭᠦᠷᠭᠡ ᠶᠤᠮ ᠃ - ᠥᠩᠭᠡᠨ ᠲᠠᠯᠠ ᠶᠢᠨ ᠵᠣᠬᠢᠶᠠᠯ᠄ ᠨᠡᠷᠡ ᠲᠣᠮᠢᠶᠠ ᠢ ᠠᠰᠢᠭᠯᠠᠨ ᠨᠡᠷᠡᠲᠦ ᠲᠡᠮᠳᠡᠭᠲᠦ ᠶᠢᠨ ᠨᠡᠷᠡᠶᠢᠳᠦᠯ ᠪᠠ ᠦᠢᠯᠡᠳᠬᠦᠨ ᠦ ᠦᠰᠦᠭ ᠦᠨ ᠦᠰᠦᠭ ᠢ ᠨᠢᠭᠡ ᠲᠥᠷᠥᠯ ᠦᠨ ᠦᠰᠦᠭ ᠢᠶᠡᠷ ᠨᠢ ᠴᠣᠬᠣᠮ ᠨᠢ ᠴᠣᠬᠣᠮ ᠪᠠᠶᠢᠯᠭᠠᠵᠤ᠂
profanityActionᠢ ᠠᠰᠢᠭᠯᠠᠨ ᠱᠠᠯᠢᠭ ᠦᠭᠡᠶ ᠦᠭᠡ ᠬᠡᠯᠡᠯᠭᠡ ᠶᠢ ᠬᠣᠷᠢᠭᠯᠠᠬᠤ ᠬᠡᠷᠡᠭᠲᠡᠶ᠃