ئەگەر كۆڭۈلدىكى بولمىغان ئورۇنغا ئېھتىياجلىق بولسىڭىز، 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[] | Glob ئەندىزىسى مۇتلەق ۋە خىزمەت ئورنى نىسپىي يوللار بىلەن باھالىنىدۇ. |
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 | تەرجىمان REST API نەشرى. كۆڭۈلدىكىدەك 3.0. |
maxRetries | integer | ئۆتكۈنچى HTTP ئىنكاسلىرىدا ئەڭ كۆپ قېتىم قايتا سىناپ بېقىش (408, 425, 429, 500, 502, 503, 504). كۆڭۈلدىكىدەك 5. ھەر بىر ئىلتىماسنىڭ HTTP چاقىرىش مىقدارى 1 + maxRetries. |
retryBackoffMs | integer | ھەر قانداق يەككە چېكىنىش ئۇيقۇسىدا Cap (ms). كۆڭۈلدىكىدەك 30000. Azureنىڭ Retry-After بېشى دەل شۇ ۋاقىتتا شەرەپلىنىدۇ. بولمىسا تىترەپ كەتكەن كۆرسەتكۈچ چېكىنىش ئىشلىتىلىدۇ، بۇ قىممەتكە چەكلىنىدۇ. |
protectPlaceholders | boolean | كۆڭۈلدىكىدەك true. ئىشلەتكەندە، {{name}}، ${var}، {0}، {0:N2}، %s، %1$s ۋە HTML گەۋدىسى تەرجىمە قىلىشتىن بۇرۇن Sentinel Tokens بىلەن ئالماشتۇرۇلىدۇ ۋە كېيىن ئەسلىگە كەلتۈرۈلىدۇ. پەقەت مەنبە قەستەن ئورۇن بەلگىلىگۈچى شەكىللىك ھەرپلەرنى ئۆز ئىچىگە ئالغاندا ئىناۋەتسىز بولىدۇ. |
customPlaceholderPatterns | string[] | ئارتۇق regex ئەندىزىسى (ئايرىش بەلگىلىگۈچى يوق) سۈكۈتتىكى ئورۇن بەلگىلىگۈچى توپلىمىغا قوشۇلىدۇ، مەسىلەن، <<.+?>> بەلگىلىگەن توكن گىرامماتىكىسى ئۈچۈن ئىشلىتىلىدۇ. ئىناۋەتسىز regex ئېتىبارغا ئېلىنمايدۇ. |
noTranslatePatterns | string[] | Glob نۇسخىسى تەھلىل قىلغۇچى دەرىجىلىك ئاچقۇچلار (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ئارقىلىق پەسكەش ئاتالغۇلارنى چىقىرىۋېتىڭ.