شێوەپێدان · وەرگێڕی سەرچاوە

زیادەڕەوی ڕێگاکە لەگەڵ تێکردنی 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> بۆیە زنجیرە کورتەکان بە شێوەیەکی ئۆتۆماتیکی نادۆزرێتەوە.

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

وەرگێڕی 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

Cap (ms) لە هەر تاکە خەوێکی گەڕانەوە. گریمانە بۆ 30000. سەرەوەی Retry-After Azure ڕێک کاتێک ئامادە دەبێت ڕێزی لێدەگیرێت. ئەگینا گەڕانەوەی توانی لەرزۆک بەکاردەهێنرێت، کە بەم بەهایە دادەنرێت.

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 بەکاردەهێنرێت.
بەها یەکخراوەکان ڕەوان. enums نادروست (بۆ نموونە profanityAction: Mask) دەبێتە هۆی سەرنەکەوتنی کردارەکە بە خێرایی لەگەڵ نامەیەکی ڕوون.

ئاوازی و پیشەسازی، بە شێوەیەکی سادە

Azure AI Translator v3 API یەک دەسکی ئاوازی نییە. دوو ڕێکخستن کۆدەکرێنەوە بۆ ئەوەی زۆربەی هەمان کۆنتڕۆڵت پێ بدەن:

پیشەسازی / دۆمەین: categoryId بەکاربێنە بۆ ئاماژەکردن بە هاوپۆلێکی Azure Custom Translator کە لەسەر کۆرپۆسی خۆت ڕاهێنراوە — یاسایی، تەکنیکی، پزیشکی، بەبازاڕکردن، یان هەر شتێکی تر. ئەمە بەهێزترین دەسکەیە بۆ ئاواز، دەنگی براند و وشە.
دەقی ڕووکەش: فەرهەنگ بەکاربێنە بۆ قفڵکردنی ناوی براند و دەستەواژەی بەرهەم بە پیت و وشە و profanityAction بەکاربێنە بۆ سڕینەوەی دەستەواژەی پیس کاتێک بە ئامانجی خۆماڵیکردن بۆ بینەرانی گەنج.

زمانەکەت هەڵبژێرە

ڕێکخستنی عەمبار

نەخشە

ژێدەری خانە

ڕێکخستنی بارکردن

ئاوازی و پیشەسازی، بە شێوەیەکی سادە