Pružatelji prevođenja

Potpuno kompatibilno unazad: provider podrazumijevano azure, tako da postojeći Azure radni tokovi rade nepromijenjeni — bez potrebe za izmjenama.

Odabir pružatelja usluga

Postavite ulaz provider na azure (podrazumijevano), aws ili google, zatim unesite vjerodajnice tog provajdera. Koristi se samo jedan provajder po pozivu akcije; akcija deterministički delegira odgovarajućem SDK-u iza fabrike.

Poređenje pružalaca usluga

Azure AI Translator (default)

Podrazumijevani provajder. Postavite Azure AI Translator resurs i položite subscriptionKey, endpoint i opcionalno region. Ovo je ista konfiguracija koju postojeći radni tokovi 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"]'

AWS Translate

Koristi @aws-sdk/client-translate. Preferirajte OIDC putem aws-actions/configure-aws-credentials tako da se ne čuvaju dugotrajne tajne — akcija čita podrazumijevani lanac vjerodajnica AWS SDK-a. Alternativno, prenesite awsAccessKeyId i awsSecretAccessKey eksplicitno. Regija je uvijek potrebna, putem awsRegion ili AWS_REGION varijable okoline.

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 tipke umjesto OIDC-a, izbacite aws-actions/configure-aws-credentials step i proslijedite awsAccessKeyId / awsSecretAccessKey (putem secrets) plus awsRegion.

Google Cloud prevod

Koristi @google-cloud/translate (v2). Autentifikujte se pomoću API ključa (googleApiKey) ili JSON vjerodajnice servisnog računa (googleCredentials). Obezbijedite tačno jedan; opcionalni googleProjectId se izvodi iz akreditacije kada se izostavi.

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 namjere i specifikatora

Specifičeri specifični za provajdera mapiraju se tamo gdje postoji ekvivalent. Sve ostalo se vraća na razumne podrazumijevane postavke kako bi ponašanje ostalo dosljedno.

Lokalni kodovi se razlikuju od provajdera do provajdera

Svaki provajder koristi svoje lokalne kodove (na primjer, pojednostavljeni kineski se zh-Hans na Azureu, zh na AWS-u, a zh-CN na Googleu). Kodovi prolaze kao što jesu i upravljaju imenima izlaznih datoteka, pa birajte toLocales vrijednosti koje vaš odabrani provajder podržava.