Fordítószolgáltatók

Teljesen visszafelé kompatibilis: provider alapértelmezett azure-et használ, így a meglévő Azure munkafolyamatok változatlanul működnek — szerkesztés nélkül.

Szolgáltató kiválasztása

Állítsd be a provider bemenetet azure (alapértelmezett), aws vagy google-re, majd add meg az adott szolgáltató hitelesítéseit. Műveleti hívás esetén csak egy szolgáltatót használnak; a cselekvés determinisztikusan delegálja a gyár mögötti megfelelő SDK-nak.

Szolgáltatói összehasonlítás

Azure AI Translator (default)

Az alapértelmezett szolgáltató. Biztosíts egy Azure AI Fordító erőforrást, és passzolj subscriptionKey, endpoint és opcionálisan region. Ez ugyanaz a konfiguráció, amit a meglévő munkafolyamatok már használnak.

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 Fordító

Használja @aws-sdk/client-translate. Az OIDC-t aws-actions/configure-aws-credentials-n keresztül preferáljuk, így nem tárolódnak hosszú életű titkok — a művelet az AWS SDK alapértelmezett credential láncát olvasza. Alternatívaként adj awsAccessKeyId és awsSecretAccessKey explicit. Mindig szükség van egy régióra, akár awsRegion vagy a AWS_REGION környezeti változó segítségével.

Official AWS docs

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

OIDC (ajánlott)

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

Ha statikus billentyűket szeretnél használni az OIDC helyett, hagyd el a aws-actions/configure-aws-credentials lépést, és add át awsAccessKeyId / awsSecretAccessKey-et (secrets-on keresztül) plusz awsRegion.

Google Cloud Translation

Használja @google-cloud/translate (v2). Hitelesítés API kulccsal (googleApiKey) vagy szolgáltatási fiók JSON hitelesítéssel (googleCredentials). Adj pontosan egyet; A képesítésből kihagyva egy opcionális googleProjectId következtetést kap.

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

Szándék-specifier leképezés

A szolgáltató-specifikus specifikátorokat ott térképezzük, ahol létezik megfelelő. Minden más visszaesik az ésszerű alapértelmezésre, így a viselkedés következetes marad.

A helyi kódok szolgáltatónként eltérnek

Minden szolgáltató saját helyi kódokat használ (például az egyszerűsített kínai az Azure-on zh-Hans, az AWS-en zh, a Google-on pedig zh-CN). A kódok úgy haladnak át, ahogy vannak, és a kimeneti fájlneveket irányítják, ezért válaszd toLocales értékeket támogat a választott szolgáltatód.