Poskytovatelia prekladu

Plne spätne kompatibilné: provider predvolene azure, takže existujúce Azure pracovné postupy fungujú nezmenené — nie sú potrebné žiadne úpravy.

Výber poskytovateľa

Nastavte vstup provider na azure (predvolené), aws alebo google a potom zadajte prihlasovacie údaje daného poskytovateľa. Na jedno volanie akcie sa používa iba jeden poskytovateľ; akcia deterministicky deleguje zodpovedajúcemu SDK za továrňou.

Porovnanie poskytovateľov

Azure AI Translator (default)

Predvolený poskytovateľ. Nastavte si zdroj Azure AI Translator a prejdite subscriptionKey, endpoint a voliteľne region. Toto je rovnaká konfigurácia, ktorú už existujúce pracovné postupy používajú.

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

Používa @aws-sdk/client-translate. Uprednostňujte OIDC cez aws-actions/configure-aws-credentials, aby sa neukladali dlhotrvajúce tajomstvá — akcia číta predvolený reťazec prihlasovacích údajov AWS SDK. Prípadne odovzdávajte awsAccessKeyId a awsSecretAccessKey explicitne. Vždy je potrebná oblasť, cez awsRegion alebo AWS_REGION environmentálnu premennú.

Official AWS docs

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

OIDC (odporúčané)

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

Ak chcete použiť statické klávesy namiesto OIDC, vynechajte aws-actions/configure-aws-credentials step a prejdite awsAccessKeyId / awsSecretAccessKey (cez secrets) plus awsRegion.

Google Cloud preklad

Používa @google-cloud/translate (v2). Autentifikujte sa buď pomocou API kľúča (googleApiKey) alebo JSON prihlasovacích údajov servisného účtu (googleCredentials). Dodaj presne jeden; voliteľný googleProjectId sa odvodzuje z osvedčenia, ak je vynechaný.

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

Mapovanie zámeru a špecifikátora

Špecifické špecifikátory pre poskytovateľa sú mapované tam, kde existuje ekvivalent. Všetko ostatné sa vracia k rozumným štandardom, takže správanie zostáva konzistentné.

Kódy miest sa líšia podľa poskytovateľa

Každý poskytovateľ používa vlastné lokálne kódy (napríklad zjednodušená čínština je zh-Hans na Azure, zh na AWS a zh-CN na Google). Kódy prechádzajú tak, ako sú, a riadia názvy výstupných súborov, preto si vyberte toLocales hodnoty, ktoré váš vybraný poskytovateľ podporuje.