Tlosa tsela ka ho kenya configPath haeba u hloka sebaka se sa fetoheng.
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.*"Reference ea tšimo
| Tšimo | Mofuta | Lintlha |
|---|---|---|
sourceLocale | string | Khutlela ho kenyelletso ea sourceLocale haeba e sa sebelisoe. E boetse e romelloa ho Mofetoleli joalo ka from=<locale> e le hore likhoele tse khuts'oane ha li fumanoe ka boiketsetso. |
toLocales | string[] | Ebang ke letoto kapa khoele e arohaneng ea comma. |
include / exclude | string[] | Lipaterone tsa Glob tse hlahlojoang khahlano le litsela tse felletseng le tsa mosebetsi. |
glossary | map<string,string> | Phetolelo ea morao-rao e fetisoa. Ho tseba moeli oa lentsoe (ho sebetsana le C++, .NET). |
categoryId | string | Azure Custom Translator category — your industry/domain knob (legal, medical, marketing tone, etc.). E rometsoe joalo ka ?category=.... |
textType | "plain" | "html" | Ho hloleha ho plain. Sebelisa html feela haeba boleng ba hau ba mohloli bo na le likotoana tsa 'nete tsa HTML. |
profanityAction | "NoAction" | "Marked" | "Deleted" | Mokhoa oa ho sebetsana le lipolelo tse sa tloaelehang liphetolelong tsa liphetolelo? |
profanityMarker | "Asterisk" | "Tag" | E na le moelelo feela ha profanityAction "Marked". |
allowFallback | boolean | Beha ho false ho hloleha phetolelo ha categoryId hau e se na ts'ebetso bakeng sa sebaka se shebiloeng ho fapana le ho khutlela mofuteng o akaretsang. |
apiVersion | string | Translator REST API version. Ho hloleha ho 3.0. |
maxRetries | integer | Liteko tse phahameng tsa ho leka hape ho likarabo tsa nakoana tsa HTTP (408, 425, 429, 500, 502, 503, 504). Ho hloleha ho 5. Kakaretso ea mehala ea HTTP ka kopo e 1 + maxRetries. |
retryBackoffMs | integer | Cap (MS) bakeng sa boroko bofe kapa bofe ba mokokotlo. Ho hloleha ho 30000. Hlooho ea Retry-After ea Azure e hlomphuoa hantle ha e le teng; ho seng joalo ho sebelisoa li-backoff tse sa tloaelehang, tse koahetsoeng ka boleng bona. |
protectPlaceholders | boolean | Ho hloleha ho true. Ha e le teng, li-tokens tse kang {{name}}, ${var}, {0}, {0:N2}, %s, %1$s le HTML li nkeloa sebaka ke li-tokens tsa sentinel pele li fetoleloa ebe li khutlisetsoa morao. Tima feela ha mohloli o na le li-literals tse bōpehileng joaloka placeholder. |
customPlaceholderPatterns | string[] | Lipaterone tse eketsehileng tsa regex (ntle le li-delimiters) li ekelitsoe ho sete ea sebaka sa marang-rang, mohlala <<.+?>> bakeng sa syntax ea letšoao la tloaelo. Li-regex tse sa sebetseng li hlokomolohuoa. |
noTranslatePatterns | string[] | Lipaterone tsa Glob li bapisoa le linotlolo tsa boemo ba parser (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI / restext key). Linotlolo tse lumellanang li tlosoa ho tsoa ho kopo ebe li feta ka boleng ba tsona ba mohloli bo bolokiloeng. |
Taelo ea ho kenya
- Ketso e bala litlatsetso tse hlakileng ho tsoa ts'ebetsong ea mosebetsi.
- E kenya YAML config ho tloha
configPath. - Bakeng sa tšimo e 'ngoe le e' ngoe e arolelanoeng, kenyelletso e hlola; ho seng joalo, boleng ba YAML bo sebelisoa.
- Litekanyetso tse kopaneng li netefalitsoe. Li-enums tse sa sebetseng (mohlala,
profanityAction: Mask) li etsa hore ketso e hlōlehe ka potlako ka molaetsa o hlakileng.
Tone le indasteri ka mantsoe a hlakileng
Azure AI Translator v3 API ha e na konopo e le 'ngoe ea molumo. Li-setting tse peli li kopanya ho u fa boholo ba taolo e tšoanang:
- Indasteri / Domain: sebelisa
categoryIdho supa sehlopha sa Azure Custom Translator se koetlisitsoeng ka corpus ea hau — molao, tekheniki, bongaka, papatso, kapa eng kapa eng. Ena ke sesebelisoa se matla ka ho fetisisa sa molumo, lentsoe la lebitso le mantsoe. - Sengoloa sa bokaholimo: Sebelisa Glossary ho notlela mabitso a lihlahisoa le mantsoe a sehlahisoa ka nepo, 'me u sebelise
profanityActionho hlakola mantsoe a litšila ha u shebile sebaka sa bamameli ba banyenyane.