Тәрҗемә күрсәтүчеләр

Тулысынча артка туры килә: 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 Тәрҗемә

Кулланыла @aws-sdk/client-translate. Озак вакытлы серләр сакланмас өчен OIDC аша 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 Болыт тәрҗемәсе

Кулланыла @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 zh-Hans да Simplified Chinese , AWS-та zh һәм Google-да zh-CN). Кодлар шулай үтә һәм чыга торган файл исемнәрен идарә итә, шуңа күрә сайлаган провайдер хуплаган toLocales кыйммәтләрне сайлагыз.