Թարգմանչական ծառայություններ մատուցողներ

Լիովին հետադարձ համատեղելիություն. provider լռելյայն է azure, այնպես որ գոյություն ունեցող Azure աշխատանքային հոսքերը շարունակում են աշխատել անփոփոխ.

Մատակարարի ընտրություն

Սահմանեք provider մուտքագրումը azure (լռելյայն), aws կամ google, այնուհետեւ տրամադրեք այդ մատակարարի հավատարմագրերը: Գործողության կանչի համար օգտագործվում է միայն մեկ պրովայդեր. գործողությունը դետերմինիստորեն պատվիրակում է գործարանի հետեւում գտնվող համապատասխան SDK-ին։

Մատակարարների համեմատություն

Azure AI Translator (default)

Լռելյայն մատակարարը: Տրամադրել Azure AI Translator ռեսուրս եւ անցնել 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"]'

Մտադրությունների հատկորոշիչ քարտեզագրում

Մատակարարի հատուկ հատկորոշիչները քարտեզագրվում են այնտեղ, որտեղ գոյություն ունի համարժեք։ Մնացած ամեն ինչ վերադառնում է խելամիտ դեֆոլտներին, որպեսզի վարքագիծը մնա հետեւողական։

Տեղակայման կոդերը տարբերվում են ըստ մատակարարի

Յուրաքանչյուր պրովայդեր օգտագործում է իր տեղային կոդերը (օրինակ՝ պարզեցված չինարենը zh-Hans է Azure-ում, zh-ում՝ AWS-ում եւ zh-CN-ում՝ Google-ում)։ Կոդերը անցնում են այնպես, ինչպես կա, եւ քշում են ելքային ֆայլերի անունները, այնպես որ ընտրեք toLocales արժեքները, որոնք աջակցում են ձեր ընտրած պրովայդերին: