Преводилачки провајдери

Потпуно компатибилан са претходним верзијама: provider подразумева azure, тако да постојећи Азуре токови посла настављају да раде непромењени — нису потребне измене.

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

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

Поређење провајдера

Азуре АИ Транслатор (подразумевано)

Подразумевани провајдер. Обезбедите ресурс Азуре АИ Транслатор и прођите 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-sdk/client-translate. Преферирајте ОИДЦ преко aws-actions/configure-aws-credentials тако да се не чувају дуготрајне тајне — акција чита АWС СДК подразумевани ланац акредитива. Алтернативно , прођите awsAccessKeyId и awsSecretAccessKey експлицитно. Регион је увек потребан, преко awsRegion или AWS_REGION променљиве окружења.

Official AWS docs

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

ОИДЦ (препоручено)

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

Да бисте користили статичке тастере уместо ОИДЦ-а, испустите aws-actions/configure-aws-credentials корак и прођите awsAccessKeyId / awsSecretAccessKey (преко secrets) плус awsRegion.

Гоогле Цлоуд Превод

Користи @google-cloud/translate (v2). Потврдите аутентичност помоћу АПИ кључа (googleApiKey) или ЈСОН акредитива сервисног рачуна (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"]'

Мапирање намера-спецификација

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

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

Сваки провајдер користи сопствене локалне кодове (на пример, поједностављени кинески се zh-Hans на Азуре, zh на АВС-у и zh-CN на Гоогле-у). Кодови пролазе кроз какви јесу и покрећу имена излазних датотека, тако да изаберете toLocales вредности које ваш изабрани провајдер подржава.