Тәржемә тәьмин итеүсе провайдерҙар

Тулыһынса артҡа ярашлы: provider azure-ға ҡуйылған, шуға күрә Azure эш ағымдары үҙгәрешһеҙ эшләй — үҙгәреш талап ителмәй.

Провайдер һайлау

provider инпутын azure (стандарт), aws йәки google итеп ҡуйығыҙ, һуңынан шул провайдерҙың мәғлүмәттәрен индерегеҙ. Һәр эш шылтыратыу өсөн бер генә провайдер ҡулланыла; был хәрәкәт завод артында тап килгән 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"]'

Ниәт-спецификатор картаһы

Провайдерға хас спецификаторҙар эквивалент булған урындарҙа картаға төшөрөлә. Ҡалған бөтәһе лә аҡыллы стандарттарға ҡайта, шуға күрә тәртип берҙәй ҡала.

Локаль кодтар провайдерға ҡарата айырыла

Һәр провайдер үҙенең локаль кодтарын ҡуллана (мәҫәлән, Azure-ҙа Simplified Chinese zh-Hans, AWS-та zh, Google-ҙа zh-CN). Кодтар үҙ формаһында үтә һәм сығыу файл исемдәрен йөрөтә, шуға күрә һеҙ һайлаған провайдер хуплаған toLocales ҡиммәттәрҙе һайлағыҙ.