البدء

Step 1: اختر مزود ترجمة

يعمل الإجراء مع Azure AI Translator و AWS Translate و ترجمة جوجل كلاود خلف واجهة برمجة تطبيقات موحدة واحدة. اختر مزودا واحدا لكل تشغيل مع مدخل provider — حيث يتصرف سير العمل بشكل متطابق بغض النظر عن المزود؛ لكن المؤهلات تختلف. انظر مزودو الترجمة للمقارنة الكاملة.

Step 2: أضف بيانات الاعتماد وسير عمل

قم بتخزين بيانات اعتماد مزود الخدمة كأسرار مستودعات GitHub، ثم أنشئ .github/workflows/translate.yml. اختر مزودك أدناه لإعداد الإعداد الخاص به — بقية سير العمل متطابق.

Azure AI Translator

Azure هو المزود الافتراضي، لذا قد يتم حذف provider. توفير مورد Azure AI Translator في بوابة Azure، ثم تخزين بيانات اعتماده:

احتفظ بهذه الأسرار كمستودع

TRANSLATOR_KEY — مفتاح الاشتراك للمورد.
TRANSLATOR_ENDPOINT — رابط نقطة النهاية الإقليمية.
TRANSLATOR_REGION — منطقة Azure الخاصة بالمصدر.

أضف سير العمل

name: translate

on:
  push:
    branches: [main]
    paths:
      - "src/**/*.en.resx"
      - "src/**/*.en.json"

permissions:
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - id: translate
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            azure:
              subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
              endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
              region: ${{ secrets.TRANSLATOR_REGION }}
          sourceLocale: en
          toLocales: '["fr","de","es"]'
      - if: steps.translate.outputs.has-new-translations == 'true'
        uses: peter-evans/create-pull-request@v7
        with:
          title: ${{ steps.translate.outputs.summary-title }}
          body: ${{ steps.translate.outputs.summary-details }}
          branch: machine-translation

AWS Translate

اضبط provider على aws. أفضل OIDC عبر aws-actions/configure-aws-credentials حتى لا تخزن الأسرار الطويلة الأمد — AWS_REGION التصدير لك. لاستخدام المفاتيح الثابتة بدلا من ذلك، خزن:

احتفظ بهذه الأسرار كمستودع

AWS_ACCESS_KEY_ID — معرف مفتاح الوصول الخاص بك إلى AWS.
AWS_SECRET_ACCESS_KEY — مفتاح الوصول السري الخاص بك على AWS.

المنطقة مطلوبة دائما — إضبطها مع awsRegion أو متغير البيئة AWS_REGION.

أضف سير العمل

name: translate

on:
  push:
    branches: [main]
    paths:
      - "src/**/*.en.resx"
      - "src/**/*.en.json"

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: translate
        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: '["fr","de","es"]'
      - if: steps.translate.outputs.has-new-translations == 'true'
        uses: peter-evans/create-pull-request@v7
        with:
          title: ${{ steps.translate.outputs.summary-title }}
          body: ${{ steps.translate.outputs.summary-details }}
          branch: machine-translation

ترجمة جوجل كلاود

اضبط provider على google. قم بالتحقق إما باستخدام بيانات اعتماد JSON لحساب الخدمة أو مفتاح API — وفر واحدا فقط:

احتفظ بهذه الأسرار كمستودع

GCP_TRANSLATE_CREDENTIALS — مفتاح JSON لحساب الخدمة (كسلسلة JSON).
GCP_TRANSLATE_API_KEY — أو مفتاح Google Cloud API.

يتم استنتاج googleProjectId اختياري من الشهادة عند حذفها.

أضف سير العمل

name: translate

on:
  push:
    branches: [main]
    paths:
      - "src/**/*.en.resx"
      - "src/**/*.en.json"

permissions:
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - id: translate
        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: '["fr","de","es"]'
      - if: steps.translate.outputs.has-new-translations == 'true'
        uses: peter-evans/create-pull-request@v7
        with:
          title: ${{ steps.translate.outputs.summary-title }}
          body: ${{ steps.translate.outputs.summary-details }}
          branch: machine-translation

/* No JavaScript: the tablist can't switch panels, so hide it and reveal every provider's setup stacked. Keeps the page provider-neutral. */ [data-provider-tablist] { display: none !important; } [data-provider-panel][hidden] { display: block !important; }

Step 3: التزام ملف مورد المصدر

تستخدم ملفات الموارد اتفاقية Name.<sourceLocale>.<ext>. على سبيل المثال، Greetings.en.resx يصبح Greetings.fr.resx و Greetings.de.resx وهكذا بعد الجري.

Step 4: Let smart change detection protect your bill

changeDetection defaults to smart and stores a compact .github/resource-translator-state.json manifest in the repo. Commit that file so future runs can reuse stable translations, preserve manual target edits, and send only new, missing, changed, or settings-invalidated keys to the provider. If localized files already exist, run once with snapshotOnly: true to create the manifest without provider calls.

Step 5: فحص المخرجات

بمجرد انتهاء سير العمل، يكشف الإجراء عن ثلاثة مخرجات يمكنك دمجها في وصف العلاقات العامة: summary-title، summary-details، و has-new-translations. كما يكتب ملخص ماركداون في صفحة الوظيفة عبر core.summary.

اختر لغتك

Step 1: اختر مزود ترجمة

Step 2: أضف بيانات الاعتماد وسير عمل

Step 3: التزام ملف مورد المصدر

Step 4: Let smart change detection protect your bill

Step 5: فحص المخرجات

الخطوات التالية