ꯌꯥꯎꯔꯤꯕ ꯃꯆꯥꯛꯁꯤꯡꯗ ꯆꯣꯡꯊꯣꯛꯎ

ꯂꯣꯟ

ꯅꯍꯥꯛꯀꯤ ꯂꯣꯟ ꯈꯜꯂꯨ

ꯑꯇꯣꯞꯄ ꯂꯣꯜꯗ ꯆꯞ ꯃꯥꯟꯅꯕ ꯂꯃꯥꯏꯗ ꯑꯣꯟꯊꯣꯛꯎ꯫

EnglishEnglishenAfrikaansAfrikaansafአማርኛAmharicamالعربيةArabicarঅসমীয়াAssameseasAzərbaycanAzerbaijaniazБашҡортBashkirbaБългарскиBulgarianbgभोजपुरीBhojpuribhoবাংলাBanglabnབོད་སྐད་Tibetanboबड़ोBodobrxBosanskiBosnianbsCatalàCatalancaČeštinaCzechcsCymraegWelshcyDanskDanishdaDeutschGermandeडोगरीDogridoiDolnoserbšćinaLower SorbiandsbދިވެހިބަސްDivehidvΕλληνικάGreekelEspañolSpanishesEestiEstonianetEuskaraBasqueeuفارسیPersianfaSuomiFinnishfiFilipinoFilipinofilVakavitiFijianfjFøroysktFaroesefoFrançaisFrenchfrFrançais (Canada)French (Canada)fr-CAGaeilgeIrishgaGalegoGalicianglकोंकणीKonkanigomગુજરાતીGujaratiguHausaHausahaעבריתHebrewheहिन्दीHindihiछत्तीसगढ़ीChhattisgarhihneHrvatskiCroatianhrHornjoserbsceUpper SorbianhsbHaitian CreoleHaitian CreolehtMagyarHungarianhuՀայերենArmenianhyIndonesiaIndonesianidÌgbòIgboigInuinnaqtunInuinnaqtuniktÍslenskaIcelandicisItalianoItalianitᐃᓄᒃᑎᑐᑦInuktitutiuInuktitut (Latin)Inuktitut (Latin)iu-Latn日本語JapanesejaქართულიGeorgiankaҚазақ ТіліKazakhkkខ្មែរKhmerkmKurmancîKurdish (Northern)kmrಕನ್ನಡKannadakn한국어KoreankoكٲشُرKashmiriksکوردیی ناوەندیKurdish (Central)kuКыргызчаKyrgyzkyLëtzebuergeschLuxembourgishlbLingálaLingalalnລາວLaoloLietuviųLithuanianltLugandaGandalugLatviešuLatvianlv中文 (文言文)Chinese (Literary)lzhमैथिलीMaithilimaiMalagasyMalagasymgTe Reo MāoriMāorimiМакедонскиMacedonianmkമലയാളംMalayalammlМонгол хэлMongolian (Cyrillic)mn-Cyrlᠮᠣᠩᠭᠣᠯ ᠬᠡᠯᠡMongolian (Traditional)mn-MongমৈতৈলোনManipurimniमराठीMarathimrMelayuMalaymsMaltiMaltesemtHmong DawHmong Dawmwwမြန်မာMyanmar (Burmese)myNorsk BokmålNorwegian BokmålnbनेपालीNepalineNederlandsDutchnlSesotho sa LeboaSesotho sa LeboansoChinyanjaChichewanyaଓଡ଼ିଆOdiaorHñähñuQuerétaro OtomiotqਪੰਜਾਬੀPunjabipaPolskiPolishplدریDariprsپښتوPashtopsPortuguês (Brasil)Portuguese (Brazil)ptPortuguês (Portugal)Portuguese (Portugal)pt-PTRomânăRomanianroРусскийRussianruIkirundiRundirunKinyarwandaKinyarwandarwسنڌيSindhisdසිංහලSinhalasiSlovenčinaSlovakskSlovenščinaSlovenianslGagana SāmoaSamoansmchiShonaShonasnSoomaaliSomalisoShqipAlbaniansqСрпски (ћирилица)Serbian (Cyrillic)sr-CyrlSrpski (latinica)Serbian (Latin)sr-LatnSesothoSesothostSvenskaSwedishsvKiswahiliSwahiliswதமிழ்TamiltaతెలుగుTeluguteไทยThaithትግርTigrinyatiTürkmen DiliTurkmentkLea fakatongaTongantoTürkçeTurkishtrТатарTatarttReo TahitiTahitiantyئۇيغۇرچەUyghurugУкраїнськаUkrainianukاردوUrduurUzbek (Latin)Uzbek (Latin)uzTiếng ViệtVietnameseviisiXhosaisiXhosaxhÈdè YorùbáYorubayoYucatec MayaYucatec Mayayua粵語Cantonese (Traditional)yue中文 (简体)Chinese Simplifiedzh-Hans中文 (繁體)Chinese Traditionalzh-HantisiZuluisiZuluzu

ꯔꯤꯐꯔꯦꯟꯁ

ꯍꯟꯗꯣꯛꯄ ꯄꯤꯔꯤꯕꯁꯤꯡ

ꯔꯟ ꯑꯃꯗ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯁꯟ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃ ꯈꯜꯂꯨ — ꯑꯦꯓꯨꯔ ꯑꯦꯑꯥꯏ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔ, ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯠ, ꯅꯠꯇ꯭ꯔꯒ ꯒꯨꯒꯜ ꯀ꯭ꯂꯥꯎꯗ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔ - ꯑꯃꯈꯛꯇ, ꯑꯃꯠꯇ ꯑꯣꯏꯅ ꯌꯨꯅꯤꯐꯥꯏꯗ ꯑꯦꯄꯤꯑꯥꯏ ꯁꯔꯐꯦꯁ ꯑꯃꯒꯤ ꯃꯅꯤꯡꯗ꯫ ꯍꯟꯗꯣꯛꯄ ꯃꯤꯑꯣꯏ ꯑꯗꯨꯅ ꯄꯤꯔꯤꯕ ꯃꯤꯑꯣꯏ ꯑꯗꯨ ꯌꯦꯡꯗꯅ ꯆꯞ ꯃꯥꯟꯅꯕ ꯃꯑꯣꯡꯗ ꯇꯧꯋꯤ; ꯁꯛꯇꯥꯛꯁꯤꯡ ꯈꯛꯇ ꯈꯦꯠꯅꯩ꯫

ꯂꯃꯥꯏ ꯑꯁꯤꯗ

    ꯃꯄꯨꯡ ꯐꯥꯅ ꯕꯦꯛꯋꯥꯔꯗ ꯀꯝꯄꯦꯇꯤꯕꯜ: provider azure ꯇꯧꯕꯗ ꯗꯤꯐꯣꯜꯠꯁꯤꯡ, ꯃꯔꯝ ꯑꯗꯨꯅ ꯍꯧꯖꯤꯛ ꯂꯩꯔꯤꯕ ꯑꯦꯓꯨꯔ ꯋꯥꯔ꯭ꯛꯐ꯭ꯂꯣꯁꯤꯡ ꯑꯁꯤ ꯍꯣꯡꯗꯣꯛꯄ ꯂꯩꯇꯅ ꯃꯊꯧ ꯇꯧꯋꯤ — ꯏꯗꯤꯠ ꯇꯧꯕꯒꯤ ꯃꯊꯧ ꯇꯥꯗꯦ꯫

    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃ ꯈꯟꯕ

    provider ꯏꯟꯄꯨꯠ ꯑꯗꯨ azure (ꯗꯤꯐꯣꯜꯠ), aws ꯅꯠꯇ꯭ꯔꯒ google ꯍꯥꯏꯅ ꯁꯦꯠ ꯇꯧ, ꯃꯗꯨꯒꯤ ꯃꯇꯨꯡꯗ ꯄꯤꯔꯤꯕ ꯑꯗꯨꯒꯤ ꯀ꯭ꯔꯦꯗꯦꯟꯁ꯭ꯌꯦꯜꯁꯤꯡ ꯄꯤꯌꯨ꯫ ꯑꯦꯛꯁꯟ ꯀꯣꯜ ꯑꯃꯗ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃꯈꯛꯇꯃꯛ ꯁꯤꯖꯤꯟꯅꯩ; ꯊꯧꯋꯣꯡ ꯑꯁꯤꯅ ꯐꯦꯛꯇꯔꯤ ꯑꯃꯒꯤ ꯃꯅꯤꯡꯗ ꯂꯩꯕ ꯑꯦꯁ.ꯗꯤ.ꯀꯦ. ꯗ ꯂꯦꯞꯄ ꯃꯑꯣꯡꯗ ꯗꯦꯂꯤꯒꯦꯠ ꯇꯧꯋꯤ꯫

    ꯄꯤꯔꯤꯕ ꯃꯤꯒꯤ ꯆꯥꯡꯗꯝꯅꯕ

    Azure AI Translator
    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯚꯦꯂꯨ
    Azure (default)
    ꯑꯦꯁ.ꯗꯤ.ꯀꯦ.
    @azure-rest/ai-translation-text

    subscriptionKey, endpoint, region (optional)

    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ. ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯠ
    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯚꯦꯂꯨ
    ꯑꯥꯎꯁ
    ꯑꯦꯁ.ꯗꯤ.ꯀꯦ.
    @aws-sdk/client-translate

    OIDC / ꯗꯤꯐꯣꯜꯠ ꯆꯦꯟ, ꯅꯠꯇ꯭ꯔꯒ awsAccessKeyId + awsSecretAccessKey; ꯑꯎꯁꯔꯤꯖꯟ

    ꯒꯨꯒꯜ ꯀ꯭ꯂꯥꯎꯗ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯁꯟ
    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯚꯦꯂꯨ
    ꯒꯨꯒꯜ
    ꯑꯦꯁ.ꯗꯤ.ꯀꯦ.
    @google-cloud/translate

    googleApiKey ꯅꯠꯇ꯭ꯔꯒ googleCredentials (ꯁꯔꯚꯤꯁ-ꯑꯦꯀꯥꯎꯟ JSON)

    Azure AI Translator (default)

    ꯗꯤꯐꯣꯜꯠ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯫ ꯑꯦꯓꯨꯔ ꯑꯦꯑꯥꯏ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯇꯔ ꯔꯤꯁꯣꯔꯁ ꯑꯃ ꯄꯤꯌꯨ ꯑꯃꯁꯨꯡ subscriptionKey, endpoint, ꯑꯃꯁꯨꯡ ꯑꯣꯞꯁꯟꯂꯤ region ꯄꯤꯌꯨ꯫ ꯃꯁꯤ ꯍꯥꯟꯅꯅ ꯂꯩꯔꯤꯕ ꯋꯥꯔ꯭ꯛꯐ꯭ꯂꯣꯁꯤꯡꯅ ꯁꯤꯖꯤꯟꯅꯔꯤꯕ ꯆꯞ ꯃꯥꯟꯅꯕ ꯀꯟꯐꯤꯒꯨꯔꯦꯁꯟꯅꯤ꯫

    Official Azure docs

    .github/workflows/translate.yml
    jobs:
    translate:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v5
    - id: translator
    uses: IEvangelist/resource-translator@v3
    with:
    provider: |
    azure:
    subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
    endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
    region: ${{ secrets.TRANSLATOR_REGION }}
    sourceLocale: en
    toLocales: '["es","fr","de"]'

    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ. ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯠ

    ꯁꯤꯖꯤꯟꯅꯩ @aws-sdk/client-translate ꯫ ꯃꯇꯝ ꯁꯥꯡꯅ ꯍꯤꯡꯕ ꯑꯔꯣꯟꯕ ꯋꯥꯔꯣꯜ ꯑꯃꯠꯇ ꯊꯝꯗꯅꯕ ꯑꯣ.ꯑꯥꯏ.ꯗꯤ.ꯁꯤ.ꯒꯤ ꯈꯨꯠꯊꯥꯡꯗ ꯑꯣ.ꯑꯥꯏ.ꯗꯤ.ꯁꯤ.aws-actions/configure-aws-credentials ꯄꯥꯝꯕꯤꯌꯨ — ꯑꯦꯛꯁꯟ ꯑꯁꯤꯅ ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁ ꯑꯦꯁ.ꯗꯤ.ꯀꯦ. ꯗꯤꯐꯣꯜꯠ ꯀ꯭ꯔꯦꯗꯦꯟꯁ꯭ꯌꯦꯜ ꯆꯦꯟ ꯑꯗꯨ ꯄꯥꯏ꯫ ꯅꯠꯇ꯭ꯔꯒ, awsAccessKeyId ꯑꯃꯁꯨꯡ awsSecretAccessKey ꯃꯌꯦꯛ ꯁꯦꯡꯅ ꯄꯥꯁ ꯇꯧꯕꯤꯌꯨ꯫ ꯃꯐꯝ ꯑꯃ ꯃꯇꯝ ꯄꯨꯝꯅꯃꯛꯇ ꯃꯊꯧ ꯇꯥꯏ, awsRegion ꯅꯠꯇ꯭ꯔꯒ AWS_REGION ꯑꯀꯣꯏꯕꯒꯤ ꯑꯍꯣꯡꯕ ꯐꯥꯎꯕꯗ꯫

    Official AWS docs

    ꯑꯣ.ꯑꯥꯏ.ꯗꯤ.ꯁꯤ. (ꯔꯤꯀꯃꯦꯟꯗꯦꯗ)

    .github/workflows/translate.yml
    permissions:
    id-token: write # for aws-actions/configure-aws-credentials OIDC
    contents: write
    pull-requests: write
    jobs:
    translate:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v5
    - uses: aws-actions/configure-aws-credentials@v4
    with:
    role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate
    aws-region: us-east-1
    - id: translator
    uses: IEvangelist/resource-translator@v3
    with:
    provider: |
    aws:
    region: us-east-1 # or rely on AWS_REGION from the step above
    formality: FORMAL
    brevity: true
    sourceLocale: en
    toLocales: '["es","fr","de"]'

    ꯑꯣ.ꯑꯥꯏ.ꯗꯤ.ꯁꯤ.ꯒꯤ ꯃꯍꯨꯠꯇ ꯁ꯭ꯇꯦꯇꯤꯛ ꯀꯤꯁꯤꯡ ꯁꯤꯖꯤꯟꯅꯅꯕ, aws-actions/configure-aws-credentials ꯈꯣꯡꯊꯥꯡ ꯑꯗꯨ ꯊꯥꯗꯣꯛꯄꯤꯌꯨ ꯑꯃꯁꯨꯡ awsAccessKeyId / awsSecretAccessKey (secrets ꯐꯥꯎꯗꯨꯅ) ꯄ꯭ꯂꯁ awsRegion ꯄꯥꯁ ꯇꯧ꯫

    ꯒꯨꯒꯜ ꯀ꯭ꯂꯥꯎꯗ ꯇ꯭ꯔꯥꯟꯁ꯭ꯂꯦꯁꯟ

    ꯁꯤꯖꯤꯟꯅꯩ @google-cloud/translate (v2). ꯑꯦꯄꯤꯑꯥꯏ ꯀꯤ (googleApiKey) ꯅꯠꯇ꯭ꯔꯒ ꯁꯔꯚꯤꯁ-ꯑꯦꯀꯥꯎꯟꯠ JSON ꯀ꯭ꯔꯦꯗꯦꯟꯁ꯭ꯌꯦꯜ (googleCredentials) ꯑꯃꯒ ꯂꯣꯏꯅꯅ ꯑꯣꯊꯦꯟꯇꯤꯀꯦꯠ ꯇꯧ꯫ ꯆꯞ ꯆꯥꯅ ꯑꯃ ꯄꯤꯌꯨ; ꯑꯣꯞꯁꯅꯦꯜ googleProjectId ꯑꯃ ꯊꯥꯗꯣꯛꯄ ꯃꯇꯝꯗ ꯀ꯭ꯔꯦꯗꯦꯟꯁ꯭ꯌꯦꯜ ꯑꯗꯨꯗꯒꯤ ꯂꯧꯅꯩ ꯫

    Official Google docs

    .github/workflows/translate.yml
    jobs:
    translate:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v5
    - id: translator
    uses: IEvangelist/resource-translator@v3
    with:
    provider: |
    google:
    # Provide EITHER a service-account JSON credential...
    credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }}
    # ...OR an API key:
    # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }}
    model: nmt
    sourceLocale: en
    toLocales: '["es","fr","de"]'

    ꯏꯟꯇꯦꯟꯠ-ꯁ꯭ꯄꯦꯁꯤꯐꯥꯏꯌꯔ ꯃꯦꯄꯤꯡ

    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ-ꯑꯀꯛꯅꯕ ꯁ꯭ꯄꯦꯁꯤꯐꯥꯏꯌꯔꯁꯤꯡ ꯑꯁꯤ ꯃꯥꯟꯅꯕ ꯑꯃ ꯂꯩꯕ ꯃꯐꯝꯗ ꯃꯦꯞ ꯇꯧꯋꯤ꯫ ꯑꯇꯣꯞꯄ ꯄꯨꯝꯅꯃꯛ ꯑꯁꯤ ꯋꯥꯈꯜ ꯐꯠꯇꯕ ꯃꯑꯣꯡꯗ ꯍꯜꯂꯛꯏ ꯃꯔꯝ ꯑꯗꯨꯅ ꯂꯝꯆꯠ-ꯁꯥꯖꯠ ꯑꯁꯤ ꯂꯦꯞꯇꯅ ꯂꯩ꯫

    textType
    Azure
    textType (plain / html)
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    ꯏꯀꯥꯏ ꯈꯨꯝꯅꯈꯤꯗꯦ (ꯇꯣꯒꯜ ꯂꯩꯇꯦ)
    ꯒꯨꯒꯜ
    ꯐꯣꯔꯃꯦꯠ (ꯇꯦꯛꯁ / HTML)
    profanityAction
    Azure
    ꯃꯄꯨꯡ ꯐꯥꯕ ꯁꯧꯒꯠꯄ
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    ꯃꯥꯔꯛ / ꯀꯛꯊꯠꯂꯕ →
    ꯒꯨꯒꯜ
    ꯊꯋꯥꯏ ꯌꯥꯎꯈꯤꯗꯦ
    categoryId
    Azure
    ꯀꯁꯇꯝ ꯍꯟꯗꯣꯛꯄ
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    ꯊꯋꯥꯏ ꯌꯥꯎꯈꯤꯗꯦ
    ꯒꯨꯒꯜ
    ꯊꯋꯥꯏ ꯌꯥꯎꯈꯤꯗꯦ
    allowFallback
    Azure
    ꯁꯧꯒꯠꯄ
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    ꯊꯋꯥꯏ ꯌꯥꯎꯈꯤꯗꯦ
    ꯒꯨꯒꯜ
    ꯊꯋꯥꯏ ꯌꯥꯎꯈꯤꯗꯦ
    awsFormality
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Formality setting
    ꯒꯨꯒꯜ
    Ignored
    awsBrevity
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Brevity mode
    ꯒꯨꯒꯜ
    Ignored
    awsTerminologyNames
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Custom terminology
    ꯒꯨꯒꯜ
    Ignored
    awsParallelDataNames
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Parallel data
    ꯒꯨꯒꯜ
    Ignored
    googleModel
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Ignored
    ꯒꯨꯒꯜ
    Translation model
    googleApiEndpoint
    Azure
    Ignored
    ꯑꯦ.ꯗꯕꯜꯌꯨ.ꯑꯦꯁ.
    Ignored
    ꯒꯨꯒꯜ
    API endpoint override

    ꯂꯣꯀꯦꯜ ꯀꯣꯗꯁꯤꯡ ꯑꯁꯤ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯑꯃꯃꯝꯗ ꯈꯦꯠꯅꯩ

    ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔ ꯈꯨꯗꯤꯡꯃꯛꯅ ꯃꯁꯥꯒꯤ ꯂꯣꯀꯦꯜ ꯀꯣꯗꯁꯤꯡ ꯁꯤꯖꯤꯟꯅꯩ (ꯈꯨꯗꯝ ꯑꯣꯏꯅ ꯁꯤꯝꯞꯂꯤꯐꯥꯏꯗ ꯆꯥꯏꯅꯤꯁ ꯑꯁꯤ ꯑꯦꯓꯨꯔꯗ zh-Hans, zh ꯑꯦꯗꯕꯜꯌꯨꯑꯦꯁꯇ ꯑꯃꯁꯨꯡ zh-CN ꯒꯨꯒꯜꯗ)꯫ ꯀꯣꯗꯁꯤꯡ ꯑꯁꯤ ꯃꯇꯧ ꯑꯗꯨꯃꯛ ꯐꯥꯎꯗꯨꯅ ꯆꯠꯂꯤ ꯑꯃꯁꯨꯡ ꯑꯥꯎꯠꯄꯨꯠ ꯐꯥꯏꯜꯒꯤ ꯃꯃꯤꯡꯁꯤꯡ ꯑꯗꯨ ꯊꯧꯒꯠꯏ, ꯃꯔꯝ ꯑꯗꯨꯅ ꯅꯍꯥꯛꯅ ꯈꯟꯒꯠꯂꯕ ꯄ꯭ꯔꯣꯚꯥꯏꯗꯔꯅ ꯁꯄꯣꯔꯠ toLocales ꯚꯦꯂꯨꯁꯤꯡ ꯈꯜꯂꯨ꯫