Přełožowarjo

Dospołnje wróćo kompatibelne: provider je po defaultje azure, tak zo wobstejace Azure dźěłowe wotběhi njezměnjene funguja – žane wobdźěłanja trěbne.

Wuzwolenje poskićerja

Nastaj provider input na azure (standard), aws abo google a zapodadź potom přiznačenja tutoho poskićerja. Na akciske wołanje wužiwa so jenož jedyn poskićer; Akcija deleguje so deterministisce na so hodźacy SDK zady twornje.

Přirunanje poskićowarjow

Azure AI Translator (default)

Standardny poskićer. Alokěrujće resursu Azure AI Translator a podajće subscriptionKey, endpoint a opcionalnje region. To je samsna konfiguracija, kotruž hižo wobstejace dźěłowe wotběhi wužiwaja.

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 přełožować

Wužiwa @aws-sdk/client-translate. Preferuj OIDC přez aws-actions/configure-aws-credentials, zo so žane dołho žiwe potajnstwa njeskładuja – akcija čita standardny rjećaz přidawanskich přidaćow AWS SDK. Alternatiwnje dajće awsAccessKeyId a awsSecretAccessKey eksplicitnje. Trěbny je přeco jedyn region, přez awsRegion abo AWS_REGION wobswětowu wariablu.

Official AWS docs

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

OIDC (doporučene)

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

Zo byšće město OIDC statiske tasty wužiwali, pušćiće aws-actions/configure-aws-credentials step a přeńdźće awsAccessKeyId / awsSecretAccessKey (přez secrets) plus awsRegion.

Google Cloud Translation

Wužiwa @google-cloud/translate (v2). Awtentifikacija z API-klučom (googleApiKey) abo Service-Account JSON credential (googleCredentials). Dypkownje jednoho zastarać; Fakultatiwny googleProjectId wotwodźuje, hdyž so wuwostaji.

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

Intent-specifier mapping

Na poskićowarjow specifiske specifika so kartěruja, hdźež ekwiwalent eksistuje. Wšo druhe padnje wróćo k zmysłapołnym standardam, tak zo zadźerženje konsekwentne wostanje.

Regionalne kody so po poskićerju rozeznawaja

Kóždy poskićer wužiwa swójske regionalne kody (na přikład zjednorjena chinšćina so zh-Hans na Azure, zh na AWS a zh-CN na Google). Kody přeńdu tak, kaž su, a ćěrja mjena outputowych datajow, tohodla wolće toLocales hódnoty, kotrež waš wuzwoleny poskićer podpěruje.