Ababoneleli bokuguqulela

Ukubuyela umva ngokupheleleyo: provider okungagqibekanga kwi-azure, ke ukuhamba komsebenzi okukhoyo kwe-Azure kuhlala kusebenza kungatshintshi - akukho zilungiso zifunekayo.

Ukukhetha umboneleli

Misela igalelo provider kwi-azure (emiselweyo), aws, okanye google, ze unikeze abaqinisekisi bomnikezeli. Mnye kuphela umboneleli osetyenziswayo kwifowuni nganye yesenzo; isenzo sidlulisela ngokucacileyo kwi-SDK ehambelanayo emva kwefektri.

Uthelekiso lomboneleli

Azure AI Translator (default)

Umboneleli ongagqibekanga. Ukubonelela ngesixhobo se-Azure AI Translator kwaye uphumelele i-subscriptionKey, endpoint, kwaye ngokuzikhethela region. Olu luhlobo olufanayo lwezixhobo zokusebenza ezikhoyo esele zisetyenziswa.

Official Azure docs

• Azure Translator documentation
• Translate API reference
• Custom Translator overview
• Language support

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"]'

Ukuguqulela kwe-AWS

Sebenzisa @aws-sdk/client-translate. Khetha i-OIDC nge-aws-actions/configure-aws-credentials ukuze kungabikho zimfihlo zexesha elide ezigcinwayo-isenzo sifunda ikhonkco leziqinisekiso ze-AWS SDK. Ngenye indlela, dlulisa awsAccessKeyId kwaye awsSecretAccessKey ngokucacileyo. Indawo ihlala ifuneka, nge-awsRegion okanye i-AWS_REGION yokusingqongileyo eyahlukileyo.

Official AWS docs

• Amazon Translate overview
• TranslateText API reference
• Setting formality
• Using brevity
• Custom terminology
• Parallel data
• Supported languages

I-OIDC (icetyiswa)

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"]'

Ukusebenzisa amaqhosha emizantsi endaweni ye OIDC, lahla inyathelo aws-actions/configure-aws-credentials kwaye udlule awsAccessKeyId / awsSecretAccessKey (nge secrets) kunye awsRegion.

Inguqulelo yelifu likaGoogle

Sebenzisa @google-cloud/translate (v2). Qinisekisa ngesitshixo se-API (googleApiKey) okanye isiqinisekiso se-JSON se-akhawunti yenkonzo (googleCredentials). Nika enye ngokuchanekileyo; googleProjectId yokuzikhethela ithathwa kwisiqinisekiso xa ishiyiwe.

Official Google docs

• Cloud Translation documentation
• Cloud Translation setup
• Translating text
• Supported languages

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"]'

Imephu ye-Intent-specifier

Ii-specifiers ezithile zibekwe kwimephu apho kukho into elinganayo. Yonke enye into ibuyela kwiimpazamo ezisengqiqweni ukuze ukuziphatha kuhlala kungaguquguquki.

Iikhowudi zangaphakathi ziyahluka kumnikezeli ngamnye

Umboneleli ngamnye usebenzisa iikhowudi zakhe zendawo (umzekelo isiTshayina esenziwe lula zh-Hans kwi-Azure, zh kwi-AWS, kunye ne-zh-CN kuGoogle). Iikhowudi zidlula njengoko zinjalo kwaye ziqhube amagama efayile yeziphumo, ke khetha amaxabiso toLocales umboneleli wakho okhethiweyo axhaswayo.