Ofruesit e përkthimit

Plotësisht i pajtueshëm me prapambetje: provider parazgjedhje në azure, kështu që rrjedhat ekzistuese të Azure vazhdojnë të punojnë të pandryshuara - nuk kërkohen modifikime.

Zgjedhja e një ofruesi

Vendosni hyrjen provider në azure (parazgjedhje), aws ose google, më pas jepni kredencialet e atij ofruesi. Përdoret vetëm një ofrues për thirrje veprimi; veprimi delegohet në mënyrë deterministe në SDK-në që përputhet pas një fabrike.

Krahasimi i ofruesve

Azure AI Translator (parazgjedhje)

Ofruesi i paracaktuar. Siguroni një burim Azure AI Translator dhe kaloni subscriptionKey, endpoint dhe opsionalisht region. Ky është i njëjti konfigurim që përdorin tashmë flukset ekzistuese të punës.

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

Përkthej AWS

Përdor @aws-sdk/client-translate. Preferoni OIDC përmes aws-actions/configure-aws-credentials në mënyrë që të mos ruhen sekrete jetëgjata - veprimi lexon zinxhirin e paracaktuar të kredencialeve AWS SDK. Përndryshe, kaloni awsAccessKeyId dhe awsSecretAccessKey në mënyrë eksplicite. Kërkohet gjithmonë një rajon, nëpërmjet awsRegion ose variablit AWS_REGION të mjedisit.

Official AWS docs

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

OIDC (rekomandohet)

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

Për të përdorur çelësat statikë në vend të OIDC, hiqni hapin aws-actions/configure-aws-credentials dhe kaloni awsAccessKeyId / awsSecretAccessKey (nëpërmjet secrets) plus awsRegion.

Përkthimi i Google Cloud

Përdor @google-cloud/translate (v2). Autentifikoni me një çelës API (googleApiKey) ose një kredencial JSON të llogarisë së shërbimit (googleCredentials). Furnizoni saktësisht një; Një googleProjectId opsionale konkludohet nga kredenciali kur hiqet.

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

Harta e specifikuesit të qëllimit

Specifikuesit specifikë të ofruesit hartohen aty ku ekziston një ekuivalent. Gjithçka tjetër kthehet në parazgjedhje të arsyeshme në mënyrë që sjellja të mbetet e qëndrueshme.

Kodet e lokalizimit ndryshojnë sipas ofruesit

Çdo ofrues përdor kodet e veta të lokalizimit (për shembull kinezishtja e thjeshtuar është zh-Hans në Azure, zh në AWS dhe zh-CN në Google). Kodet kalojnë ashtu siç janë dhe drejtojnë emrat e skedarëve të daljes, kështu që zgjidhni toLocales vlerat që mbështet ofruesi juaj i zgjedhur.