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

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

ንድፊ

# .github/resource-translator.yml
sourceLocale: en

# Provider config can be nested. Keep secrets in workflow inputs; use repo
# config for non-secret defaults like region, model, formality, or category.
provider:
  azure:
    categoryId: my-custom-translator-category
    apiVersion: "3.0"
    allowFallback: true

toLocales:
  - fr
  - de
  - es
include:
  - "src/**/*.en.json"
  - "apps/**/*.en.resx"
exclude:
  - "**/__tests__/**"
glossary:
  Acme: Contoso
  Octocat: Octocat   # keep brand names verbatim

# 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)

# 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.*"

መወከሲ ግራት

provider

ዓይነት: "azure" | "aws" | "google" | provider block

Either a provider string or a nested provider block (provider.azure, provider.aws, or provider.google). Prefer nested blocks for provider-specific settings; keep secrets in workflow inputs rather than committed config.

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 ዚኸይድ ዘሎ ጕድለታት።

awsFormality

ዓይነት: "FORMAL" | "INFORMAL"

AWS Translate formality setting for supported target languages.

awsBrevity

ዓይነት: boolean

Set to true to enable AWS Translate brevity mode for supported language pairs.

awsTerminologyNames / awsParallelDataNames

ዓይነት: string[]

AWS Translate custom terminology and parallel data resource names. Either an array or comma-separated string.

googleModel

ዓይነት: string

Google Cloud Translation model, e.g. nmt or base.

googleApiEndpoint

ዓይነት: string

Optional Google Cloud Translation API endpoint override.

googleAutoRetry

ዓይነት: boolean

Optional Google Cloud Translation automatic retry toggle. Leave unset to use the Google client default.

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) ይሰማማዕ ነበረ። እቲ ዝሰማማዕ መፍትሕ ካብቲ ሕቶ ይድርበ ምንጪ ዋጋኡ ድማ ይዕቀብ።

changeDetection

ዓይነት: "smart" | "disabled"

Defaults to smart. Uses the committed state manifest to translate only changed or missing parser keys. Set to disabled or false to preserve the legacy always-translate behavior.

statePath

ዓይነት: string

Path to the deterministic smart change-detection state manifest. Defaults to .github/resource-translator-state.json.

ናይ ጽዕነት ትእዛዝ

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

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

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

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

ቋንቋኻ ምረጽ

ኣሰራርሓ መኽዘን

ንድፊ

መወከሲ ግራት

ናይ ጽዕነት ትእዛዝ

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