د ژباړې چمتو کوونکی

بشپړ شاته سازګار: 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. د aws-actions/configure-aws-credentials له لارې OIDC غوره ګڼم ترڅو اوږدمهاله رازونه ذخیره نه شی — عمل د 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 (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"]'

د نیت ټاکونکی نقشه

د عرضه کوونکی ځانګړی مشخصونه هغه ځای نقشه کېږی چې معادل موجود وی. نور هر څه بېرته معقولو ډیفالټونو ته راګرځی، نو چلند ثابت پاتې شی.

محلی کوډونه هر چمتو کوونکی سره توپیر لری

هر چمتو کوونکی خپل محلی کوډونه کاروی (د بېلګې په توګه Simplified Chinese په Azure کې zh-Hans، zh په AWS، او zh-CN په Google کې شتون لری). کوډونه لکه څنګه چې دی تېرېږی او د محصول فایل نومونه چلوی، نو هغه ارزښتونه انتخاب کړئ چې toLocales ټاکل شوی چمتو کوونکی ملاتړ کوی.