მთარგმნელობითი პროვაიდერები

სრულად უკან თავსებადი: provider ნაგულისხმევად azure, ამიტომ არსებული Azure სამუშაო ნაკადები უცვლელად მუშაობენ - რედაქტირება არ არის საჭირო.

პროვაიდერის შერჩევა

დააყენეთ provider შეყვანა azure (ნაგულისხმევი), aws ან google, შემდეგ მიაწოდეთ ამ პროვაიდერის რწმუნებათა სიგელები. თითო მოქმედების ზარზე გამოიყენება მხოლოდ ერთი პროვაიდერი; მოქმედება დეტერმინისტულად დელეგირებს შესაბამის SDK-ს ქარხნის უკან.

პროვაიდერის შედარება

Azure AI Translator (ნაგულისხმევი)

ნაგულისხმევი პროვაიდერი. მიაწოდეთ 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 თარგმნა

იყენებს @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 მნიშვნელობები, რომლებსაც მხარს უჭერს თქვენს მიერ არჩეული პროვაიდერი.