Провајдери на превод

Целосно компатибилен наназад: provider по дифолт е на azure, така што постоечките Azure работни процеси продолжуваат да работат непроменети — без потреба од уредувања.

Избор на провајдер

Поставете го provider влезот на azure (стандардно), aws или google, па потоа внесете ги креденцијалите на тој провајдер. Се користи само еден провајдер по акциски повик (action call); акцијата детерминистички се делегира на соодветниот SDK зад фабрика.

Споредба на провајдери

Azure AI Translator (default)

Стандардниот провајдер. Обезбеди Azure AI преведувач ресурс и положи subscriptionKey, endpoint, и опционално region. Ова е иста конфигурација што веќе ја користат постоечките работни процеси.

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

Користи @aws-sdk/client-translate. Преферирам OIDC преку aws-actions/configure-aws-credentials за да не се чуваат долготрајни тајни — акцијата го чита стандардниот ланец на креденцијали на AWS SDK. Алтернативно, поминете awsAccessKeyId и awsSecretAccessKey експлицитно. Секогаш е потребен регион, преку awsRegion или AWS_REGION променливата на околината.

Official AWS docs

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

OIDC (препорачано)

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, отпуштете го чекорот aws-actions/configure-aws-credentials и пренесете awsAccessKeyId / awsSecretAccessKey (преку secrets) плус awsRegion.

Google Cloud превод

Користи @google-cloud/translate (v2). Автентикирајте со API клуч (googleApiKey) или со JSON креденцијал за сервис-сметка (googleCredentials). Обезбеди точно еден; Опционален 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"]'

Мапирање на спецификатори на намера

Специфичните специјализатори за провајдер се мапираат каде што постои еквивалент. Сè друго се враќа на разумни стандарди за однесувањето да остане конзистентно.

Кодовите на локалите се разликуваат по провајдери

Секој провајдер користи свои локални кодови (на пример, Simplified Chinese е zh-Hans на Azure, zh на AWS и zh-CN на Google). Кодовите минуваат како што се и ги управуваат имињата на излезните датотеки, па изберете toLocales вредности што ги поддржува избраниот провајдер.