دابینکەرانی وەرگێڕان

بەتەواوی گونجاوە بۆ دواوە: provider گریمانە بۆ azure، بۆیە بەڕێوەچونی کاری Azure بەردەوام بە بێ گۆڕان کاردەکات — هیچ دەستکارییەک پێویست ناکات.

دیاریکردنی دابینکەر

دانانی تێکردنی provider بۆ azure (گریمانەیی)، aws، یان google، پاشان دابینکردنی بڕواپێدانی ئەو دابینکارە. تەنها یەک دابینکەر بەکاردەهێنرێت بۆ هەر پەیوەندیەکی کردار. کردارەکە بە شێوەیەکی یەکلاکەرەوە نوێنەری SDK ی هاوشێوە لە پشت کارگەیەکەوە دەکات.

بەراوردکردنی دابینکەر

وەرگێڕی Azure AI (بنەڕەت)

دابینکەری بنەڕەت. دابینکردنی سەرچاوەی وەرگێڕی AI Azure و تێپەڕاندنی 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 (via secrets) plus 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"]'

نەخشەسازی دیاریکەری مەبەست

دیاریکەرە تایبەتەکانی دابینکەر نەخشە دەکێشرێن لەو شوێنەی هاوتایەک هەیە. هەموو شتێکی تر دەگەڕێتەوە بۆ بنەڕەتی ژیرانە بۆیە هەڵسوکەوت وەک خۆی دەمێنێتەوە.

کۆدەکانی لۆکاڵ جیاوازە بۆ دابینکەرێک

هەر دابینکەرێک کۆدی ناوخۆیی خۆی بەکاردەهێنێت (بۆ نموونە چینی سادە zh-Hans لە Azure، zh لە AWS، و zh-CN لە گووگڵ). کۆدەکان وەک خۆی تێدەپەڕن و ناوی فایلی دەرچو لێدەخوڕن، بۆیە ئەو بەهایانە هەڵبژێرە toLocales دابینکەرە دیاریکراوەکەت پشتیوانی دەکات.