زیادەڕەوی ڕێگاکە لەگەڵ تێکردنی configPath ئەگەر پێویستت بە شوێنێکی نائاسایی هەیە.
نەخشە
# .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 | وەرگێڕی REST API. گریمانە بۆ 3.0. |
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). کلیلەکانی هاوشێوە لە داواکاریەکە فڕێدەدرێن و تێدەپەڕن لەگەڵ بەهای سەرچاوەکەیان کە دەپارێزرێت. |
ڕێکخستنی بارکردن
- کردارەکە خوێندنەوەی تێکردنە ئاشکراکان لە ۆرکفلۆکە.
- کۆنفیگەری YAML لە
configPathدادەبەزێنێت. - بۆ هەر بوارێکی هاوبەش، تێکردنەکە دەیباتەوە. ئەگەرنا بەهای YAML بەکاردەهێنرێت.
- بەها یەکخراوەکان ڕەوان. enums نادروست (بۆ نموونە
profanityAction: Mask) دەبێتە هۆی سەرنەکەوتنی کردارەکە بە خێرایی لەگەڵ نامەیەکی ڕوون.
ئاوازی و پیشەسازی، بە شێوەیەکی سادە
Azure AI Translator v3 API یەک دەسکی ئاوازی نییە. دوو ڕێکخستن کۆدەکرێنەوە بۆ ئەوەی زۆربەی هەمان کۆنتڕۆڵت پێ بدەن:
- پیشەسازی / دۆمەین:
categoryIdبەکاربێنە بۆ ئاماژەکردن بە هاوپۆلێکی Azure Custom Translator کە لەسەر کۆرپۆسی خۆت ڕاهێنراوە — یاسایی، تەکنیکی، پزیشکی، بەبازاڕکردن، یان هەر شتێکی تر. ئەمە بەهێزترین دەسکەیە بۆ ئاواز، دەنگی براند و وشە. - دەقی ڕووکەش: فەرهەنگ بەکاربێنە بۆ قفڵکردنی ناوی براند و دەستەواژەی بەرهەم بە پیت و وشە و
profanityActionبەکاربێنە بۆ سڕینەوەی دەستەواژەی پیس کاتێک بە ئامانجی خۆماڵیکردن بۆ بینەرانی گەنج.