Dzvanya bhatani rekumisikidza configPath kana iwe uchida nzvimbo isiri yekutadza.
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.*"Field reference
| Munda | Type | Zvinyorwa |
|---|---|---|
sourceLocale | string | Dzokera kunzvimbo sourceLocale kana isina kumisikidzwa. Also forwarded to Translator as from=<locale> so short strings are not autodetected. |
toLocales | string[] | Kana kuti yakaparadzaniswa kana yakaparadzaniswa nekomma. |
include / exclude | string[] | Glob mapatani akaongororwa achipesana neyakakwana uye nzvimbo yekushandira-hukama nzira. |
glossary | map<string,string> | Post-shanduro yemazwi anodarika. Shoko-muganho kuziva (kubata C++, .NET). |
categoryId | string | Azure Custom Translator chikamu — yako indasitiri / domain knob (zviri pamutemo, zvekurapa, kushambadzira toni, nezvimwewo). Yakatumirwa ?category=.... |
textType | "plain" | "html" | Kukundikana plain. Shandisa html chete kana zviwanikwa zvako zviine chaiyo HTML zvidimbu. |
profanityAction | "NoAction" | "Marked" | "Deleted" | Nzira yekugadzirisa sei mazwi akashata mushanduro? |
profanityMarker | "Asterisk" | "Tag" | Izvo zvinongobatsira chete kana profanityAction "Marked". |
allowFallback | boolean | Set to false to fail the translation when your categoryId has no deployment for a target locale instead of falling back to the general model. |
apiVersion | string | Translator REST API version. Kukundikana 3.0. |
maxRetries | integer | ● Yakanyanya kuedza kuedza pane yenguva pfupi HTTP mhinduro (408, 425, 429, 500, 502, 503, 504). Kukundikana 5. Yese HTTP kufona pachikumbiro 1 + maxRetries. |
retryBackoffMs | integer | Dzvanya pano kuti uone chero chinhu chisina kukodzera kurara. Kukundikana 30000. Azure's Retry-After header inokudzwa chaizvo kana iripo; zvikasadaro, jittered exponential backoff inoshandiswa, yakavharwa pakukosha uku. |
protectPlaceholders | boolean | Kukundikana true. Kana iripo, zviratidzo zvakaita se {{name}}, ${var}, {0}, {0:N2}, %s, %1$s uye HTML masangano anotsiviwa nezviratidzo zvesentinel zvisati zvashandurwa uye kudzoreredzwa mushure. Disable only when source intentionally contains placeholder-shaped literals. |
customPlaceholderPatterns | string[] | Mamwe regex mapatani (pasina delimiters) akawedzerwa kune default placeholder seti, semuenzaniso <<.+?>> yetsika chiratidzo syntax. Regexes dzisina kukodzera dzinofuratirwa. |
noTranslatePatterns | string[] | Glob mapatani anoenderana neparser-level makiyi (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI / restext kiyi). Makiyi anowirirana anodonhedzwa kubva pachikumbiro uye anopfuura nekukosha kwavo kunobva kwakachengetedzwa. |
Kurodha kurodha
- Chiito chinoverenga zvakajeka zvinongedzo kubva kubasa.
- Inotakura iyo YAML config kubva
configPath. - Kune yega yega yakagovaniswa munda, iyo yekupinza inokunda; Zvikasadaro, kukosha kweYAML kunoshandiswa.
- Zviyero zvakabatanidzwa zvinosimbiswa. Zvishandiso zvisina kukodzera (semuenzaniso
profanityAction: Mask) zvinokonzeresa kuti chiito chikundikane nekukurumidza neshoko rakajeka.
Toni uye indasitiri mune yakajeka mazwi
Iyo Azure AI Muturikiri v3 API haina imwechete toni knob. Zvirongwa zviviri zvinobatana kuti zvikupe iwe yakawanda yekutonga kwakafanana:
- Indasitiri / Domain: shandisa
categoryIdkunongedzera kuchikamu cheAzure Custom Translator chakadzidziswa pane yako corpus — zviri pamutemo, zvehunyanzvi, zvekurapa, kushambadzira, kana chero chimwe chinhu. Iyi ndiyo yakasimba lever yetoni, izwi rechiratidzo, uye mazwi. - Zvinyorwa zvepamusoro: Shandisa Glossary kukiya mazita emhando uye mazwi echigadzirwa verbatim, uye shandisa
profanityActionkupukuta mazwi anosemesa kana uchitarisa nzvimbo kune vateereri vadiki.