Prevajalski ponudniki

Popolnoma združljiv nazaj: provider privzeto uporablja azure, zato obstoječi Azure delovni procesi delujejo nespremenjeni — brez potrebnih popravkov.

Izbira ponudnika

Nastavite provider vhod na azure (privzeto), aws ali google, nato vnesite podatke tega ponudnika. Na klic dejanja se uporablja le en ponudnik; dejanje deterministično delegira ustreznemu SDK za tovarno.

Primerjava ponudnikov

Azure AI Translator (privzeto)

Privzeti ponudnik. Zagotovite vir Azure AI Translator in opravite subscriptionKey, endpoint in po želji region. To je ista konfiguracija, ki jo že uporabljajo obstoječi delovni tokovi.

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

Uporablja @aws-sdk/client-translate. Raje OIDC preko aws-actions/configure-aws-credentials, da se ne shranjujejo dolgožive skrivnosti — dejanje prebere privzeto verigo poverilnic AWS SDK. Alternativno, awsAccessKeyId in awsSecretAccessKey izrecno prenesite. Regija je vedno obvezna, preko awsRegion ali AWS_REGION okoljske spremenljivke.

Official AWS docs

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

OIDC (priporočeno)

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

Za uporabo statičnih tipk namesto OIDC opustite aws-actions/configure-aws-credentials step in podajte awsAccessKeyId / awsSecretAccessKey (preko secrets) plus awsRegion.

Google Cloud prevajalnik

Uporablja @google-cloud/translate (v2). Avtentikirajte se bodisi z API ključem (googleApiKey) ali z JSON poverilnico storitvenega računa (googleCredentials). Ponudite natanko eno; iz poverilnice se ob izpuščanju izpeljejo neobvezni googleProjectId.

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

Preslikava z namenom in specifikatorjem

Specifikatorji, specifični za ponudnika, se preslikajo tam, kjer obstaja ekvivalent. Vse ostalo se vrne k razumnim privzetim nastavitvem, da vedenje ostane dosledno.

Lokalne kode se razlikujejo glede na ponudnika

Vsak ponudnik uporablja svoje lokalne kode (na primer poenostavljena kitajščina je zh-Hans na Azure, zh na AWS in zh-CN na Googlu). Kode gredo skozi takšno, kot so, in upravljajo imena izhodnih datotek, zato izberite vrednosti, toLocales ki jih podpira vaš izbrani ponudnik.