Fornituri tat-traduzzjoni

Kompletament kompatibbli 'l quddiem: provider default għal azure, għalhekk il-flussi tax-xogħol eżistenti ta' Azure jibqgħu jaħdmu bla bidla — l-ebda modifikazzjonijiet meħtieġa.

Għażla ta' fornitur

Issettja l-input provider għal azure (default), aws, jew google, imbagħad ipprovdi l-kredenzjali ta' dak il-fornitur. Jintuża biss fornitur wieħed għal kull sejħa ta' azzjoni; l-azzjoni tiddelega b'mod deterministiku lill-SDK li jaqbel wara fabbrika.

Paragun tal-fornituri

Azure AI Translator (default)

Il-fornitur default. Ipprovdi riżorsa Azure AI Translator u għaddi subscriptionKey, endpoint, u fakultattivament region. Din hija l-istess konfigurazzjoni li diġà jużaw il-flussi tax-xogħol eżistenti.

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

Jintużaw @aws-sdk/client-translate. Ippreferi OIDC permezz ta' aws-actions/configure-aws-credentials sabiex ma jinħażnu l-ebda sigrieti ta' ħajja twila — l-azzjoni taqra l-katina ta' kredenzjali default tal-AWS SDK. Alternattivament, għaddi awsAccessKeyId u awsSecretAccessKey b'mod esplicitu. Reġjun dejjem huwa meħtieġ, permezz ta' awsRegion jew il-varjabbli ta' AWS_REGION ambjent.

Official AWS docs

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

OIDC (rakkomandat)

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

Biex tuża ċwievet statiku minflok OIDC, neħħi l-aws-actions/configure-aws-credentials step u għaddi awsAccessKeyId / awsSecretAccessKey (permezz ta' secrets) flimkien ma' awsRegion.

Traduzzjoni tal-Cloud ta' Google

Tuża @google-cloud/translate (v2). Awtentika jew b'ċavetta API (googleApiKey) jew b'kredenzjali JSON ta' kont ta' servizz (googleCredentials). Ipprovdi eżatt wieħed; googleProjectId fakultattiv jiġi dedott mill-kredenzjali meta jitħalla barra.

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

Mappatura ta' speċifikazzjoni ta' intenzjoni

Speċifikaturi speċifiċi għall-fornitur jiġu mappjati fejn hemm ekwivalenti. Kollox ieħor jerġa' lura għal defaults sensibbli sabiex l-imġiba tibqa' konsistenti.

Il-kodiċijiet lokali jvarjaw skont il-fornitur

Kull fornitur juża l-kodiċijiet lokali tiegħu stess (per eżempju Simplified Chinese is zh-Hans fuq Azure, zh fuq AWS, u zh-CN fuq Google). Il-kodiċijiet jgħaddu kif huma u jmexxu l-ismijiet tal-fajls tal-output, għalhekk agħżel toLocales valuri li l-fornitur magħżul tiegħek jappoġġja.