Override txoj kev nrog cov configPath tswv yim yog tias koj xav tau qhov chaw tsis yog lub neej ntawd.
Cov phiaj xwm
# .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.*"Field reference
| Daim teb | Hom | Cov ntawv sau tseg |
|---|---|---|
sourceLocale | string | Ntog rov qab mus rau qhov sourceLocale tswv yim yog tias tsis tau teeb tsa. Kuj tau xa mus rau Tus Neeg Txhais Lus raws li from=<locale> yog li cov hlua luv luv tsis autodetected. |
toLocales | string[] | Tog twg los ib tug array los yog ib tug comma-cais hlua. |
include / exclude | string[] | Glob qauv ntsuam xyuas tawm tsam qhov tseeb thiab chaw ua hauj lwm-txheeb ze txoj kev. |
glossary | map<string,string> | Tom qab txhais lus overrides. Lo lus-ciam teb paub (tuav C++, .NET). |
categoryId | string | Azure Custom Translator qeb — koj qhov kev lag luam / sau pob (kev cai lij choj, kev kho mob, kev lag luam suab, thiab lwm yam). Xa raws li ?category=.... |
textType | "plain" | "html" | Defaults rau plain. Siv html tsuas yog tias koj cov peev txheej muaj cov khoom siv tiag tiag HTML tawg. |
profanityAction | "NoAction" | "Marked" | "Deleted" | Yuav ua li cas kho cov ntsiab lus profane hauv cov zis txhais |
profanityMarker | "Asterisk" | "Tag" | Tsuas yog muaj txiaj ntsig thaum profanityAction yog "Marked". |
allowFallback | boolean | Teem rau false kom ua tsis tiav qhov kev txhais lus thaum koj lub categoryId tsis muaj kev xa tawm rau lub hom phiaj hauv zos es tsis txhob poob rov qab mus rau tus qauv dav dav. |
apiVersion | string | Tus neeg txhais lus REST API version. Defaults rau 3.0. |
maxRetries | integer | Qhov siab tshaj plaws rov sim ntawm cov lus teb HTTP ib ntus (408, 425, 429, 500, 502, 503, 504). Defaults rau 5. Tag nrho HTTP hu rau ib qho kev thov yog 1 + maxRetries. |
retryBackoffMs | integer | Cap (ms) ntawm ib qho kev pw tsaug zog rov qab. Defaults rau 30000. Azure lub Retry-After header yog honored raws nraim thaum muaj; txwv tsis pub jittered exponential backoff yog siv, capped ntawm tus nqi no. |
protectPlaceholders | boolean | Defaults rau true. Thaum nyob rau, tokens zoo li {{name}}, ${var}, {0}, {0:N2}, %s, %1$s thiab HTML cov chaw raug hloov nrog sentinel tokens ua ntej txhais lus thiab rov qab kho tom qab. Lov tes taw tsuas yog thaum qhov chaw txhob txwm muaj qhov chaw zoo li qhov tseeb. |
customPlaceholderPatterns | string[] | Ntxiv regex qauv (tsis muaj delimiters) ntxiv rau lub neej ntawd placeholder teeb, piv txwv li <<.+?>> rau kev cai token syntax. Cov regexes tsis raug tsis quav ntsej. |
noTranslatePatterns | string[] | Glob qauv sib phim tiv thaiv parser-theem yuam sij (JSON dotted path, RESX name, PO msgid, XLIFF chav tsev id, INI / restext yuam sij). Cov yuam sij sib txuam yog poob los ntawm qhov kev thov thiab dhau los ntawm lawv qhov chaw tus nqi khaws cia. |
Chaw thau khoom txiav txim
- Qhov kev nqis tes ua nyeem cov tswv yim meej los ntawm kev ua haujlwm.
- Nws thauj khoom YAML config los ntawm
configPath. - Rau txhua daim teb sib koom, cov tswv yim yeej; txwv tsis pub siv tus nqi YAML.
- Cov txiaj ntsig sib koom ua ke yog validated. Cov enums tsis raug (piv txwv li
profanityAction: Mask) ua rau qhov kev ua tsis tiav sai nrog cov lus meej.
Lub suab thiab kev lag luam, hauv cov ntsiab lus yooj yim
Azure AI Translator v3 API tsis muaj ib lub suab nrov. Ob qhov chaw ua ke los muab koj feem ntau ntawm tib qho kev tswj hwm:
- Kev lag luam / domain: siv
categoryIdtaw tes rau ib qho Azure Custom Translator qeb uas tau kawm ntawm koj tus kheej corpus — kev cai lij choj, thev naus laus zis, kev kho mob, kev lag luam, lossis lwm yam. Qhov no yog qhov muaj zog tshaj plaws rau lub suab, hom suab thiab cov lus. - Cov ntawv nyeem: Siv cov phau ntawv txhais lus los xauv cov npe lag luam thiab cov khoom lag luam cov lus verbatim, thiab siv
profanityActionlos txhuam cov lus tsis zoo thaum lub hom phiaj hauv zos rau cov neeg tuaj saib hluas.