ارائه دهندگان ترجمه

کاملاً سازگار با نسخه های قبلی: 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/translate (نسخه ۲) استفاده می کند. احراز هویت را با کلید 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، zh در AWS و zh-CN در گوگل). کدها همانطور که هستند عبور می کنند و نام فایل های خروجی را هدایت می کنند، پس مقادیری toLocales را که ارائه دهنده انتخابی شما پشتیبانی می کند انتخاب کنید.