Override chemen an ak opinyon configPath si ou bezwen yon kote ki pa default.
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.*"Referans jaden an
| Jaden an | Kalite | Nòt yo |
|---|---|---|
sourceLocale | string | Tonbe tounen nan opinyon an sourceLocale si se pa mete Tou voye pou tradiktè kòm from=<locale> se konsa strings kout yo pa otodetected. |
toLocales | string[] | Swa yon etalaj oswa yon kòd separe virgèl. |
include / exclude | string[] | Modèl Glob evalye kont chemen absoli ak espas travay relatif. |
glossary | map<string,string> | Post tradiksyon tèm Mo-fwontyè okouran (manch C++, .NET) |
categoryId | string | Kategori Custom Translator Azure — endistri ou / domèn bouton (legal, medikal, ton maketing, elatriye). Voye kòm ?category=... |
textType | "plain" | "html" | Défaut plain Sèvi ak html sèlman si valè resous ou yo gen fragman HTML reyèl. |
profanityAction | "NoAction" | "Marked" | "Deleted" | Ki jan yo trete tèm pwofèn nan pwodiksyon tradui |
profanityMarker | "Asterisk" | "Tag" | Sèlman sans lè profanityAction "Marked". |
allowFallback | boolean | Mete nan false yo echwe tradiksyon an lè categoryId ou a pa gen okenn deplwaman pou yon lokal sib olye pou yo tonbe tounen nan modèl la jeneral. |
apiVersion | string | Tradiktè vèsyon API REST Défaut 3.0 |
maxRetries | integer | Tantativ retan maksimòm sou repons HTTP pasajè (408, 425, 429, 500, 502, 503, 504) Défaut 5 Total HTTP apèl pou chak demann 1 + maxRetries. |
retryBackoffMs | integer | Cap (ms) sou nenpòt ki sèl dòmi retounen. Défaut 30000 Azure Retry-After header onore egzakteman lè prezan; Sinon, jittered eksponansyèl rebak, bouche nan valè sa a. |
protectPlaceholders | boolean | Défaut true Lè sou, marqueur tankou {{name}}, ${var}, {0}, {0:N2}, %s, %1$s ak antite HTML yo ranplase ak siy santinèl anvan tradiksyon ak retabli apre sa. Enfim sèlman lè sous entansyonèlman gen literal plas-ki gen fòm. |
customPlaceholderPatterns | string[] | Modèl regex siplemantè (san delimiteur) ajoute nan seri a placeholder default, egzanp <<.+?>> pou sentaks siy koutim. Regexes envalid yo inyore. |
noTranslatePatterns | string[] | Modèl Glob matche ak parser-nivo kle (JSON pwen chimen, RESX name, PO msgid, XLIFF inite id, INI / retext kle). Matche kle yo tonbe nan demann lan ak pase nan ak valè sous yo konsève. |
Loading lòd
- Aksyon an li entrain eksplisit soti nan workflow la.
- Li chaje konfigirasyon an YAML soti nan
configPath. - Pou chak jaden pataje, opinyon an ranport; sinon se valè YAML la itilize.
- Valè yo fusionné yo valide. Enums envalid (egzanp
profanityAction: Mask) lakòz aksyon an echwe vit ak yon mesaj klè.
Ton ak endistri, an tèm plenn
API Azure AI Translator v3 pa gen yon bouton ton sèl. De anviwònman konbine ba ou pi fò nan kontwòl la menm:
- Endistri / domèn: Sèvi ak
categoryIdpou pwen nan yon kategori Custom Translator Azure ki resevwa fòmasyon sou pwòp corpus ou - legal, teknik, medikal, maketing, oswa nenpòt lòt bagay. Sa a se levye ki pi fò pou ton, vwa mak ak vokabilè. - Sifas tèks: Sèvi ak Glosè a pou fèmen non mak ak tèm pwodwi pou l verbatim, epi sèvi ak
profanityActionpou fwote tèm pwofon lè vize lokalizasyon pou odyans ki pi piti.