跳至內容

語言

選擇你嘅語言

用另一種語言切換到同一頁。

English English en Afrikaans Afrikaans af አማርኛ Amharic am العربية Arabic ar অসমীয়া Assamese as Azərbaycan Azerbaijani az Башҡорт Bashkir ba Български Bulgarian bg भोजपुरी Bhojpuri bho বাংলা Bangla bn བོད་སྐད་ Tibetan bo बड़ो Bodo brx Bosanski Bosnian bs Català Catalan ca Čeština Czech cs Cymraeg Welsh cy Dansk Danish da Deutsch German de डोगरी Dogri doi Dolnoserbšćina Lower Sorbian dsb ދިވެހިބަސް Divehi dv Ελληνικά Greek el Español Spanish es Eesti Estonian et Euskara Basque eu فارسی Persian fa Suomi Finnish fi Filipino Filipino fil Vakaviti Fijian fj Føroyskt Faroese fo Français French fr Français (Canada) French (Canada) fr-CA Gaeilge Irish ga Galego Galician gl कोंकणी Konkani gom ગુજરાતી Gujarati gu Hausa Hausa ha עברית Hebrew he हिन्दी Hindi hi छत्तीसगढ़ी Chhattisgarhi hne Hrvatski Croatian hr Hornjoserbsce Upper Sorbian hsb Haitian Creole Haitian Creole ht Magyar Hungarian hu Հայերեն Armenian hy Indonesia Indonesian id Ìgbò Igbo ig Inuinnaqtun Inuinnaqtun ikt Íslenska Icelandic is Italiano Italian it ᐃᓄᒃᑎᑐᑦ Inuktitut iu Inuktitut (Latin) Inuktitut (Latin) iu-Latn 日本語 Japanese ja ქართული Georgian ka Қазақ Тілі Kazakh kk ខ្មែរ Khmer km Kurmancî Kurdish (Northern) kmr ಕನ್ನಡ Kannada kn 한국어 Korean ko كٲشُر Kashmiri ks کوردیی ناوەندی Kurdish (Central) ku Кыргызча Kyrgyz ky Lëtzebuergesch Luxembourgish lb Lingála Lingala ln ລາວ Lao lo Lietuvių Lithuanian lt Luganda Ganda lug Latviešu Latvian lv 中文 (文言文) Chinese (Literary) lzh मैथिली Maithili mai Malagasy Malagasy mg Te Reo Māori Māori mi Македонски Macedonian mk മലയാളം Malayalam ml Монгол хэл Mongolian (Cyrillic) mn-Cyrl ᠮᠣᠩᠭᠣᠯ ᠬᠡᠯᠡ Mongolian (Traditional) mn-Mong মৈতৈলোন Manipuri mni मराठी Marathi mr Melayu Malay ms Malti Maltese mt Hmong Daw Hmong Daw mww မြန်မာ Myanmar (Burmese) my Norsk Bokmål Norwegian Bokmål nb नेपाली Nepali ne Nederlands Dutch nl Sesotho sa Leboa Sesotho sa Leboa nso Chinyanja Chichewa nya ଓଡ଼ିଆ Odia or Hñähñu Querétaro Otomi otq ਪੰਜਾਬੀ Punjabi pa Polski Polish pl دری Dari prs پښتو Pashto ps Português (Brasil) Portuguese (Brazil) pt Português (Portugal) Portuguese (Portugal) pt-PT Română Romanian ro Русский Russian ru Ikirundi Rundi run Kinyarwanda Kinyarwanda rw سنڌي Sindhi sd සිංහල Sinhala si Slovenčina Slovak sk Slovenščina Slovenian sl Gagana Sāmoa Samoan sm chiShona Shona sn Soomaali Somali so Shqip Albanian sq Српски (ћирилица) Serbian (Cyrillic) sr-Cyrl Srpski (latinica) Serbian (Latin) sr-Latn Sesotho Sesotho st Svenska Swedish sv Kiswahili Swahili sw தமிழ் Tamil ta తెలుగు Telugu te ไทย Thai th ትግር Tigrinya ti Türkmen Dili Turkmen tk Lea fakatonga Tongan to Türkçe Turkish tr Татар Tatar tt Reo Tahiti Tahitian ty ئۇيغۇرچە Uyghur ug Українська Ukrainian uk اردو Urdu ur Uzbek (Latin) Uzbek (Latin) uz Tiếng Việt Vietnamese vi isiXhosa isiXhosa xh Èdè Yorùbá Yoruba yo Yucatec Maya Yucatec Maya yua 粵語 Cantonese (Traditional) yue 中文 (简体) Chinese Simplified zh-Hans 中文 (繁體) Chinese Traditional zh-Hant isiZulu isiZulu zu

亞姆爾

儲存庫配置

在存儲庫配置文件中表達一次默認值,然後讓每個工作流程繼承它們。 當兩者都提供嘅時候,動作輸入永遠都會贏。

本頁內容

    如果你需要一個非預設位置,請用configPath輸入覆蓋路徑。

    圖式

    .github/resource-translator.yml
    # .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[] 根據絕對路徑和工作空間相對路徑評估的 Glob 模式。
    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 設定為false,當你的categoryId沒有為目標語言環境部署時,翻譯失敗,而不是回退到通用模型。
    apiVersion string Translator REST API 版本。 預設為3.0
    maxRetries integer 暫時性 HTTP 回應的最大重試嘗試次數 (408, 425, 429, 500, 502, 503, 504)。 預設為5。 每個請求的 HTTP 呼叫總數為 1 + maxRetries
    retryBackoffMs integer 任何一次退避睡眠嘅上限(毫秒)。 預設為30000。 Azure 的 Retry-After 標頭在存在時會被準確地接受; 否則會使用抖動指數退避,上限為此值。
    protectPlaceholders boolean 預設為true。 當打開時,{{name}}${var}{0}{0:N2}%s%1$s 和 HTML 實體等標記會在翻譯前被 sentinel 標記取代,並在翻譯後恢復。 只有當來源故意包含佔位符形狀的文字時才禁用。
    customPlaceholderPatterns string[] 額外嘅正則表達式模式(無分隔符)加入到預設佔位符集中,例如自訂標記語法嘅<<.+?>>。 無效的正則表達式將被忽略。
    noTranslatePatterns string[] Glob 模式與解析器級鍵(JSON 虛線路徑、RESX name、PO msgid、XLIFF 單位id、INI/restext 鍵)匹配。 匹配的鍵會從請求中刪除並通過,並保留其源值。

    裝貨令

    1. 該操作從工作流程中讀取明確的輸入。
    2. 它從configPath載入 YAML 配置。
    3. 對於每一個共享字段,輸入就會獲勝; 否則會使用YAML值。
    4. 合併後嘅數值會得到驗證。 無效的枚舉(例如profanityAction: Mask)會導致操作快速失敗,並顯示清晰的訊息。

    語氣同工業,簡單嚟講

    Azure AI Translator v3 API 沒有單一音調旋鈕。 兩個設定組合起來,就可以得到大部分相同嘅控制:

    • 行業/領域:categoryId指向一個根據你自己嘅語料庫訓練嘅 Azure Custom Translator類別 -- 法律、技術、醫療、市場營銷,或者其他任何嘢。 呢個係語氣,品牌聲音同詞彙嘅最有力嘅槓桿。
    • 表面文字: 用呢個詞彙表逐字鎖定品牌名稱同產品術語,同時用profanityAction去刪除粗俗嘅詞語,同時針對年輕受眾進行本地化。