Pružatelji prevođenja

Potpuno kompatibilno unatrag: provider je zadano azure, pa postojeći Azure radni tokovi rade nepromijenjeni — bez potrebe za izmjenama.

Odabir pružatelja usluga

Postavite ulaz provider na azure (zadani), aws ili google, zatim unesite vjerodajnice tog pružatelja. Koristi se samo jedan pružatelj po pozivu akcije; akcija deterministički delegira odgovarajućem SDK-u iza tvornice.

Usporedba pružatelja usluga

Azure AI Translator (default)

Zadani pružatelj. Osigurajte Azure AI Translator resurs i položite subscriptionKey, endpoint i opcionalno region. To je ista konfiguracija koju već koriste postojeći radni tokovi.

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 kako se ne pohranjuju dugotrajne tajne — akcija čita AWS SDK zadani lanac vjerodajnica. Alternativno, prenesite awsAccessKeyId i awsSecretAccessKey eksplicitno. Uvijek je potrebna regija, 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"]'

Za korištenje statičkih tipki umjesto OIDC-a, izostavite aws-actions/configure-aws-credentials step i proslijedite awsAccessKeyId / awsSecretAccessKey (putem secrets) plus awsRegion.

Google Cloud prijevod

Koristi @google-cloud/translate (v2). Autentificirajte se pomoću API ključa (googleApiKey) ili JSON vjerodajnice servisnog računa (googleCredentials). Opskrbite točno jednu; opcionalni googleProjectId se izvlači iz povjerovnice 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"]'

Preslikavanje namjerno-specificerskog preslikavanja

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

Lokalni kodovi razlikuju se od pružatelja do pružatelja usluga

Svaki pružatelj koristi svoje lokalne kodove (na primjer, pojednostavljeni kineski se zh-Hans na Azureu, zh na AWS-u, a zh-CN na Googleu). Kodovi prolaze u postojećem stanju i upravljaju imenima izlaznih datoteka, pa odaberite toLocales vrijednosti koje vaš odabrani pružatelj podržava.