Prevodilački provajderi

Potpuno kompatibilan sa prethodnim verzijama: provider podrazumeva azure, tako da postojeći Azure tokovi posla nastavljaju da rade nepromenjeni — nisu potrebne izmene.

Izbor provajdera

Podesite ulaz provider na azure (podrazumevano), aws ili google, a zatim dostavite akreditive tog provajdera. Samo jedan provajder se koristi po akcionom pozivu; akcija deterministički delegira na odgovarajući SDK iza fabrike.

Poređenje provajdera

Azure AI Translator (podrazumevano)

Podrazumevani provajder. Obezbedite resurs Azure AI Translator i prođite subscriptionKey, endpoint i opciono region. Ovo je ista konfiguracija postojeći tokovi posla već koriste.

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

AVS Prevedi

Koristi @aws-sdk/client-translate. Preferirajte OIDC preko aws-actions/configure-aws-credentials tako da se ne čuvaju dugotrajne tajne — akcija čita AWS SDK podrazumevani lanac akreditiva. Alternativno, prođite awsAccessKeyId i awsSecretAccessKey eksplicitno. Region je uvek potreban, preko awsRegion ili AWS_REGION promenljive okruženja.

Official AWS docs

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

OIDC (preporučeno)

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

Da biste koristili statičke tastere umesto OIDC-a, ispustite aws-actions/configure-aws-credentials korak i prođite awsAccessKeyId / awsSecretAccessKey (preko secrets) plus awsRegion.

Google Cloud Prevod

Koristi @google-cloud/translate (v2). Potvrdite autentičnost pomoću API ključa (googleApiKey) ili JSON akreditiva servisnog računa (googleCredentials). Snabdevanje tačno jedan; Opcioni googleProjectId se zaključuje iz akreditiva kada je izostavljen.

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

Mapiranje namera-specifikacija

Specificeri specifični za provajdera su mapirani tamo gde postoji ekvivalent. Sve ostalo se vraća na razumne podrazumevane postavke, tako da ponašanje ostaje konzistentno.

Lokalni kodovi se razlikuju po provajderu

Svaki provajder koristi sopstvene lokalne kodove (na primer, pojednostavljeni kineski se zh-Hans na Azure, zh na AVS-u i zh-CN na Google-u). Kodovi prolaze kroz kakvi jesu i pokreću imena izlaznih datoteka, tako da izaberete toLocales vrednosti koje vaš izabrani provajder podržava.