ግብዓቶች እና ውጤቶች · የመርጃ ተርጓሚ

ለ YAML መርሃግብር እና የመጫኛ ቅደም ተከተል ውቅር ይመልከቱ።

የሚያስፈልጉ ግብዓቶች

የሚያስፈልጉ ግብዓቶች
ስም	መግለጫ
`sourceLocale`	የምንጭ አካባቢ (ለምሳሌ `en`) እንደ `*/.en.resx` ያሉ የመርጃ ፋይሎችን ለማግኘት ጥቅም ላይ ይውላል። እንደ `from=<locale>` ወደ ተርጓሚም ተላልፏል።
`subscriptionKey`	Azure AI ተርጓሚ የደንበኝነት ምዝገባ ቁልፍ። በ `secrets` በኩል ማለፍ.
`endpoint`	የተርጓሚ የመጨረሻ ነጥብ ዩአርኤል፣ ለምሳሌ `https://api.cognitive.microsofttranslator.com/`.

የተለመዱ አማራጭ ግብዓቶች

የተለመዱ አማራጭ ግብዓቶች
ስም	ነባር	መግለጫ
`region`	ምንም	የተርጓሚ ሀብት ክልል (ለአለም አቀፍ ሀብቶች መተው)።
`toLocales`	ሁሉም ይደገፋሉ	የሚተረጎሙ አካባቢዎች። የ JSON ማዘጋጃ (`["fr","de"]`) ወይንም በነጠላ ሰረዝ የተለያዩ ዋጋዎች መቀበል
`include`	ምንም	አዲስ መስመር-የተለዩ የግሎብ ቅጦች; የሚተረጎሙ ተዛማጅ ፋይሎች ብቻ ናቸው።
`exclude`	ምንም	አዲስ መስመር-የተለዩ የግሎብ ቅጦች; ተዛማጅ ፋይሎች ተዘለሉ (ከተካተቱ በኋላ ይተገበራሉ)።
`configPath`	`.github/resource-translator.yml`	ወደ YAML ውቅር ፋይል የሚወስደው መንገድ (ከስራ ቦታ ሥር አንፃር)።
`dryRun`	`false`	`true` ሲሆኑ ትርጉሞችን ያሂዱ እና ማጠቃለያዎችን ያውጡ ነገር ግን ፋይሎችን አይፃፉ።
`failOnError`	`true`	`true`, ያልተጠበቁ ስህተቶች ድርጊቱን ይወድቃሉ; `false` ስህተቶች ማስጠንቀቂያ ይሆናሉ።

የአስተርጓሚ ጥያቄ ግብዓቶች

እነዚህ በቀጥታ ወደ Azure AI Translator v3 መጠይቅ መለኪያዎች ካርታ ያደርጋሉ። እያንዳንዱ አማራጭ ነው; የ የተርጓሚ ነባሪዎች ሲዘጋጁ ተፈጻሚ ይሆናሉ።

የአስተርጓሚ ጥያቄ ግብዓቶች
ስም	ነባር	መግለጫ
`categoryId`	general	Azure Custom Translator ምድብ - የኢንዱስትሪ/ጎራ/ቃና ቁልፍ። እንደ `?category=...` ተላልፏል።
`textType`	`plain`	`plain` ወይም `html`. የንብረት እሴቶችዎ እውነተኛ የኤችቲኤምኤል ቁርጥራጮች ሲሆኑ ብቻ `html` ይጠቀሙ።
`profanityAction`	`NoAction`	`NoAction`፣ `Marked` ወይም `Deleted`። በትርጉሞች ውስጥ ጸያፍ ቃላት እንዴት እንደሚወጡ ይቆጣጠራል።
`profanityMarker`	`Asterisk`	`Asterisk` ወይም `Tag`. ትርጉም ያለው `profanityAction` `Marked` ሲሆን ብቻ ነው።
`allowFallback`	እውነት (የተርጓሚ ነባሪ)	`false` በሚሆንበት ጊዜ ተርጓሚዎ `categoryId` ለታለመው አካባቢ ምንም ማሰማራት ከሌለው ወደ አጠቃላይ ስርዓቱ ከመውደቅ ይልቅ ስህተት ይመልሳል።
`apiVersion`	`3.0`	ተርጓሚ REST API ሥሪት።

የመቋቋም ችሎታ እና የቦታ ያዥ ጥበቃ

እነዚህ ግብዓቶች ተርጓሚ ጥያቄዎን ሲያደናቅፍ ድርጊቱ እንዴት እንደሚሰራ እና እንደ {{name}} ወይም {0} ያሉ የቦታ ያዥ ቶከኖችን በትርጉም ጊዜ እንዳይበላሹ እንዴት እንደሚከላከል ይቆጣጠራሉ።

የመቋቋም እና የቦታ ያዥ ጥበቃ ግብዓቶች
ስም	ነባር	መግለጫ
`maxRetries`	`5`	በጊዜያዊ የኤችቲቲፒ ምላሾች ላይ ከፍተኛው የድጋሚ ሙከራ ሙከራዎች (`408, 425, 429, 500, 502, 503, 504`)። በአንድ ጥያቄ አጠቃላይ የኤችቲቲፒ ጥሪዎች ብዛት `1 + maxRetries` ነው።
`retryBackoffMs`	`30000`	በማንኛውም ነጠላ የኋላ እንቅልፍ ላይ ካፕ (በሚሊሰከንዶች)። ድርጊቱ የ Azure `Retry-After` ምላሽ ራስጌን በትክክል በሚገኝበት ጊዜ ያከብራል; . ያለበለዚያ በዚህ እሴት ላይ የተያዘ የተንቆጠቆጠ ገላጭ ጀርባ ይጠቀማል።
`protectPlaceholders`	`true`	`true` (ነባሪ) እንደ `{{name}}`፣ `${var}`፣ `{0}`፣ `{0:N2}`፣ `%s`፣ `%1$s` እና ኤችቲኤምኤል አካላት ያሉ ቦታ ያዢዎች ከመተርጎማቸው በፊት በሴንቲነል ቶከኖች ይተካሉ እና ከዚያ በኋላ ይመለሳሉ። ያሰናክሉት ምንጭዎ ሆን ብሎ መተርጎም ያለበት ቃል በቃል የቦታ ያዥ ቅርጽ ያለው ጽሑፍ ሲይዝ ብቻ ነው።
`customPlaceholderPatterns`	ምንም	በአዲስ መስመር የተለዩ regexes (ያለ ገደቢዎች) ወደ ነባሪው የቦታ ያዥ ስብስብ ታክሏል፣ ለምሳሌ `<<.+?>>` ለብጁ ማስመሰያ አገባብ።
`noTranslatePatterns`	ምንም	በአዲስ መስመር የተለዩ የግሎብ ቅጦች ከትንተና-ደረጃ ቁልፎች ጋር ይዛመዳሉ (JSON ነጥብ ያለው መንገድ፣ RESX `name`፣ PO `msgid`፣ XLIFF አሃድ `id`፣ INI/restext ቁልፍ)። ተዛማጅ ቁልፎች ከተርጓሚ ጥያቄ ይጣላሉ እና የምንጭ እሴታቸው ተጠብቆ ያልፋሉ።

ውጤቶች

ውጤቶች
ስም	መግለጫ
`summary-title`	አጭር PR-ርዕስ-ተስማሚ ማጠቃለያ፣ ለምሳሌ Machine-translated 320 files, a total of 5,418 translations.
`summary-details`	የማርክዳውን ማጠቃለያ ለ PR አካል ወይም ለስራ ማጠቃለያ ተስማሚ።
`has-new-translations`	`'true'` አንድ ወይም ከዚያ በላይ አዳዲስ ትርጉሞች ሲፈጠሩ።