ኣሰራርሓ · ምንጪ ተርጓሚ

ዘይግቡእ ቦታ እንተ ደሊኻ ነቲ መገዲ በቲ configPath መእተዊ ኣወግዶ።

ንድፊ

# .github/resource-translator.yml
sourceLocale: en
toLocales:
  - fr
  - de
  - es
include:
  - "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 | html
profanityAction: NoAction        # NoAction | Marked | Deleted
profanityMarker: 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: 5
retryBackoffMs: 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: true
customPlaceholderPatterns:
  - "<<.+?>>"                     # 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[]	ናይ ግሎብ ንድፊ ምስ ፍጹምን ምስ ናይ ስራሕ ቦታን ተዛማዲ መገድታት ገምጊሙ።
`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 version። ናብ `3.0` ዚኸይድ ዘሎ ጕድለታት።
`maxRetries`	integer	ኣብ ግዜያዊ HTTP መልስታት (`408, 425, 429, 500, 502, 503, 504`) ዝለዓለ ናይ ዳግመ-ፈተነ ፈተነ። ንጕድለታት `5`። ጠቕላላ ናይ ኤችቲቲፒ ጻውዒት ኣብ ነፍሲ ወከፍ ሕቶ `1 + maxRetries` እዩ።
`retryBackoffMs`	integer	ካፕ (ms) ኣብ ዝዀነ ይኹን ንድሕሪት ዚምለስ ድቃስ ናብ `30000` ዚኸይድ ዘሎ ጕድለታት። ኣዙር `Retry-After` ርእሲ ኣብ ዚህልወሉ እዋን ብልክዕ እዩ ዚኽበር፣ እንተ ዘይኰይኑ በዚ ዋጋ እዚ እተሸፈነ ኤክስፖነንሽያል ንድሕሪት ተመሊሱ ይጥቀመሉ።
`protectPlaceholders`	boolean	ናብ `true` ዚኸይድ ዘሎ ጕድለታት። ከም `{{name}}` `${var}` `{0}` `{0:N2}` `%s` `%1$s` ከምኡውን HTML ዝኣመሰሉ ቶከናት ቅድሚ ምትርጓሞም ብሴንቲነል ቶከን ይትካእ ድሕሪኡ ድማ ይምለስ። ምንጪ ደይመደይ ኢሉ ቃል ብቓሉ ምስ ዚሕዝ ጥራይ እዩ ኣሰናክሎ።
`customPlaceholderPatterns`	string[]	ተወሳኺ ናይ ሬጅክስ ንድፊ (ብዘይ ገደብ) ናብ ነባሪ ቦታ ተወሰኸ፣ ንኣብነት `<<.+?>>` ናይ ልሙድ ቶከን ኣገባብ። ዘይቅኑዓት ሪግክስ ዕሽሽ ይብሉ።
`noTranslatePatterns`	string[]	ንድፊ ግሎብ ምስ መፋትሕ ደረጃ ተንታኒ (JSON dotted path, RESX `name`, PO `msgid`, XLIFF unit `id`, INI/restext key) ይሰማማዕ ነበረ። እቲ ዝሰማማዕ መፍትሕ ካብቲ ሕቶ ይድርበ ምንጪ ዋጋኡ ድማ ይዕቀብ።

ናይ ጽዕነት ትእዛዝ

እቲ ተግባር ካብ ስራሕ ዝወጸ ንጹር ሓሳባት የንብብ።
ካብ configPath ዝወጸ ናይ YAML ቅርጺ ይጽዕኖ።
ንነፍሲ ወከፍ ሓባራዊ ዓውዲ እቲ ኣበርክቶ ይዕወት; እንተ ዘይኰይኑ ግን ዋጋ YAML ይጥቀም።
እቲ እተሓዋወሰ ዋጋታት ተቐባልነት ረኺቡ እዩ። ዘይቅቡል ቍጽሪ (ንኣብነት profanityAction: Mask) ነቲ ተግባር ብንጹር መልእኽቲ ብቕልጡፍ ከም ዚፈሽል ይገብሮ።

ቃናን ኢንዱስትርን ብንጹር

Azure AI Translator v3 API ሓንቲ ቃና ኣይነበሮን። ክልተ ኣቀማምጣታት ተደሚሩ ንመብዛሕትኡ ሓደ ዓይነት ቍጽጽር ይህቡኻ፦

ኢንዱስትሪ / ዶሜን፦ ኣብ ናይ ገዛእ ርእስኻ ኮርፐስ ዝሰልጠነ ናይ Azure Custom Translator ምድብ ንምሕባር categoryId ተጠቐመሉ — ሕጋዊ፣ ተክኒካዊ፣ ሕክምናዊ፣ ዕዳጋ ወይ ዝዀነ ይኹን ነገር። እዚ ንቃና ድምጽን ቃላትን ቃላትን እቲ ዝሓየለ መትረብ እዩ።
ናይ ገጽ ጽሑፍ፦ ነቲ መዝገበ-ቃላት ተጠቐመሉ ስማት ብራንድን ናይ ፍርያት ስያመታትን ቃል ብቓሉ ንምዕጻው ከምኡውን ንመንእሰያት ሰማዕቲ ኣብ ከባቢኦም ከተተኵር ከለኻ ጽዩፍ ቃላት ንምጥፋእ profanityAction ተጠቐም።

ቋንቋኻ ምረጽ

ኣሰራርሓ መኽዘን

ንድፊ

መወከሲ ግራት

ናይ ጽዕነት ትእዛዝ

ቃናን ኢንዱስትርን ብንጹር