Terjimeçiler

Doly yza gabat gelýär: provider öň bellenilen azure, şonuň üçin bar bolan Azure iş akymlary üýtgemän işleýär — hiç hili düzediş gerek däl.

Üpjünçini saýlamak

provider girişini azure (default), aws ýa-da google edip goýuň, soňra şol üpjünçiniň maglumatyny beriň. Her hereketli çagyryşda diňe bir üpjünçi ulanylýar; bu hereket deterministik taýdan fabrikanyň arkasyndaky gabat gelýän SDK-a tabşyrylýar.

Üpjünçiniň deňeşdirmesi

Azure AI Translator (default)

Öň bellenilen üpjünçi. Azure AI Translator resursyny üpjün ediň we subscriptionKey, endpoint we opsiyonel region. Bu konfigurasiýa bar bolan iş akışlarynyň ulanýan konfigurasiýasy.

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

Ulanylyşy @aws-sdk/client-translate. OIDC-ni aws-actions/configure-aws-credentials arkaly saýlaň, şonda uzak ömürli syrlar saklanmaz — bu hereket AWS SDK-nyň öň bellenen kimlik zynjyryny okaýar. Şeýle-de awsAccessKeyId we awsSecretAccessKey açyk geçiriň. Bir region hemişe awsRegion ýa-da AWS_REGION değişkeni arkaly talap edilýär.

Official AWS docs

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

OIDC (maslahat berilýär)

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

OIDC ýerine statik açarlary ulanmak üçin aws-actions/configure-aws-credentials ädimini aşak düşüriň we awsAccessKeyId / awsSecretAccessKey (secrets arkaly) we awsRegion geçiriň.

Google Cloud Translation

Ulanylyşy @google-cloud/translate (v2). API açary (googleApiKey) ýa-da hyzmat hasabynyň JSON maglumaty (googleCredentials) bilen tassyklaň. Diňe birini üpjün ediň; goşmaça googleProjectId çykarylan ýagdaýynda şahadatnamadan çykarylýar.

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

Provider-specific specificifikatorlar ekvivalentiň bar ýerinde kartalaşdyrylýar. Beýleki zatlar paýhasly öňünden bellenilýär, şonuň üçin özüňi alyp barşyň üýtgemeýär.

Ýerli kodlar her üpjünçä tapawutlanýar

Her üpjünçi öz ýerli kodlaryny ulanýar (mysal üçin, Simplified Chinese Azure-da zh-Hans, AWS-de zh we Google-da zh-CN). Kodlar edil bolşy ýaly geçýär we çykyş faýllarynyň atlaryny dolandyrýar, şonuň üçin saýlan üpjünçiňiziň goldaýan toLocales gymmatlyklaryny saýlaň.