Vakai ki he Fokotuʻutuʻu ki he schema ʻo e YAML mo e loading order.
Ngaahi meʻa ʻoku fie maʻu
| Hingoa | Fakamatala |
|---|---|
sourceLocale | ʻOku fakaʻaongaʻi ʻa e feituʻu maʻuʻanga tokoni (e.g. en) ke kumi ʻa e ngaahi faile ʻo e maʻuʻanga tokoni hange ko e **/*.en.resx. Naʻe toe ʻave foki ki he Translator ko e from=<locale>. |
subscriptionKey | Azure AI Translator subscription key. Paasi ʻi he secrets. |
endpoint | URL ʻo e endpoint ʻo e tokotaha liliu lea, e.g. https://api.cognitive.microsofttranslator.com/. |
Ngaahi meʻa angamaheni ʻoku fili ke fakahu
| Hingoa | Default | Fakamatala |
|---|---|---|
region | ʻikai ha taha | Vahefonua maʻuʻanga tokoni ʻa e tokotaha liliu lea (toʻo ki he ngaahi maʻuʻanga tokoni fakaemamani lahi). |
toLocales | poupouʻi kotoa | Ngaahi feituʻu ke liliu ki ai. Tali ha fokotuʻutuʻu JSON (["fr","de"]) pe ngaahi tuʻunga ʻulungaanga mahuʻinga ʻoku fakamavahevaheʻi ʻe he koma. |
include | ʻikai ha taha | Ngaahi sipinga ʻo e glob ʻoku fakamavahevaheʻi ʻe he laine foʻou; ko e ngaahi faile tatau pe ʻoku liliu. |
exclude | ʻikai ha taha | Ngaahi sipinga ʻo e glob ʻoku fakamavahevaheʻi ʻe he laine foʻou; ʻOku hiki fakalaka ʻa e ngaahi faile ʻoku fakatauhoa (fakaʻaongaʻi hili hono fakakau mai). |
configPath | .github/resource-translator.yml | Hala ki he faile config ʻo e YAML (fekauʻaki mo e root ʻo e workspace). |
dryRun | false | ʻI he taimi ʻoku true ai, fakalele ʻa e ngaahi liliu lea pea ʻoatu ha ngaahi fakamatala fakanounou kae ʻoua naʻa ke hiki ha ngaahi faile. |
failOnError | true | ʻI he taimi ʻoku true ai, ʻoku ʻikai lava ke fai ha ngaahi fehalaaki taʻeʻamanekina; ʻI he taimi ʻoku false ai, ko e ngaahi fehalaaki ko ha ngaahi fakatokanga. |
Kole ʻa e tokotaha liliu lea ke fakahu mai
ʻOku mape fakahangatonu ʻeni ki he Azure AI Translator v3 query parameters. ʻOku fili pe ʻa e meʻa kotoa pe; ʻoku fakaʻaongaʻi ʻa e default ʻa e Translator ʻi he taimi ʻoku ʻikai seti ai.
| Hingoa | Default | Fakamatala |
|---|---|---|
categoryId | general | Azure Custom Translator kulupu — ko e ngaueʻanga/domain/tone knob. ʻAve ko e ?category=.... |
textType | plain | plain pe html. Fakaʻaongaʻi pe ʻhtml ʻi he taimi ʻoku hoko ai hoʻo ngaahi maʻuʻanga tokoni ko ha ngaahi kongokonga HTML moʻoni. |
profanityAction | NoAction | NoAction, Marked pe Deleted. Puleʻi ʻa e founga ʻoku tuku atu ai ʻa e ngaahi lea kapekape ʻi he ngaahi liliu. |
profanityMarker | Asterisk | Asterisk pe Tag. ʻOku toki mahuʻingamalie pe ʻi he taimi ʻoku Marked ai profanityAction. |
allowFallback | true (Translator default) | ʻI he taimi ʻoku false ai, ʻoku fakafoki mai ʻe he Translator ha fehalaaki kae ʻikai foki ki he polokalama fakalukufua kapau ʻoku ʻikai ke ʻi ai ha deployment ʻi hoʻo categoryId ki ha feituʻu ʻoku fakataumuʻa ki ai. |
apiVersion | 3.0 | Liliu lea REST API version. |
Resilience & placeholder maluʻi
ʻOku puleʻi ʻe he ngaahi input ko ʻeni ʻa e anga ʻo e ngaue ʻi he taimi ʻoku taʻofi ai ʻe he Translator hoʻo kole mo e founga ʻoku ne maluʻi ai ʻa e ngaahi fakaʻilonga placeholder hange ko e {{name}} pe {0} mei hono fakaʻauha lolotonga ʻa e liliu.
| Hingoa | Default | Fakamatala |
|---|---|---|
maxRetries | 5 | Lahi taha ʻo e ngaahi feinga ke toe feinga ʻi he ngaahi tali HTTP fakataimi (408, 425, 429, 500, 502, 503, 504). Ko e lahi fakakatoa ʻo e ngaahi telefoni HTTP ʻi he kole ʻoku 1 + maxRetries. |
retryBackoffMs | 30000 | Tataʻo (ʻi he milliseconds) ʻi ha faʻahinga mohe pe ʻe taha. ʻOku fakaʻapaʻapaʻi ʻe he ngaue ʻa e ʻuluʻi fakamatala ʻo e tali ʻa e Retry-After ʻo e Azure ʻi he taimi ʻoku ʻi ai ai; ka ʻikai, ʻoku ne fakaʻaongaʻi ʻa e jittered exponential backoff ʻoku fakangatangata ʻi he tuʻunga mahuʻinga ko ʻeni. |
protectPlaceholders | true | ʻI he taimi ʻoku true ai (default), ʻoku fetongi ʻa e placeholders hange ko e {{name}}, ${var}, {0}, {0:N2}, %s, %1$s mo e HTML ʻaki ʻa e ngaahi fakaʻilonga sentinel kimuʻa pea toki liliu pea toe fakafoki mai ʻamui. Tamateʻi pe ʻi he taimi ʻoku ʻi ai ha fakamatala ʻoku totonu ke liliu ʻi hoʻo maʻuʻanga tokoni. |
customPlaceholderPatterns | ʻikai ha taha | Newline-separated regexes (without delimiters) added to the default placeholder set, e.g. <<.+?>> for custom token syntax. |
noTranslatePatterns | ʻikai ha taha | ʻOku fakafehoanaki ʻa e ngaahi sipinga ʻo e glob ʻi he laine foʻou mo e ngaahi ki ʻi he tuʻunga ʻo e parser (JSON dotted path, RESX name, PO msgid, XLIFF unit id, INI/restext key). ʻOku toʻo ʻa e ngaahi ki ʻoku hoa mei he kole ʻa e Tokotaha Liliu Lea pea ʻoku fakatolonga pe ʻa e mahuʻinga ʻo e maʻuʻanga tokoni. |
Ngaahi meʻa ʻoku maʻu
| Hingoa | Fakamatala |
|---|---|
summary-title | Nounou ʻo e PR-title-friendly summary, e.g. Machine-translated 320 files, a total of 5,418 translations. |
summary-details | Fakamatala fakanounou ʻo e Markdown ʻoku feʻunga mo ha sino PR pe fakamatala fakanounou ʻo e ngaue. |
has-new-translations | 'true' taimi naʻe faʻu ai ha liliu foʻou ʻe taha pe lahi ange. |