الوصفات · مترجم الموارد

افتح طلب سحب بعد كل محاولة

- id: translate
  uses: IEvangelist/resource-translator@v3
  with:
    sourceLocale: en
    subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
    endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
    region: ${{ secrets.TRANSLATOR_REGION }}

- if: steps.translate.outputs.has-new-translations == 'true'
  uses: peter-evans/create-pull-request@v7
  with:
    branch: machine-translation
    title: ${{ steps.translate.outputs.summary-title }}
    body: ${{ steps.translate.outputs.summary-details }}
    labels: localization

Monorepos: ترجمة النطاق لكل حزمة

with:
  sourceLocale: en
  include: |
    apps/web/**/*.en.resx
    packages/shared/**/*.en.json
  exclude: |
    **/dist/**
    **/__tests__/**

مسرد لأسماء العلامات التجارية ومصطلحات المنتجات

ضع .github/resource-translator.yml في المستودع:

glossary:
  Acme: Contoso
  Octocat: Octocat
  ".NET": ".NET"
  "C++": "C++"

تستخدم مصطلحات المعجم بعد ذلك الترجمة، لذا يحافظ الناتج المترجم آليا على علامتك التجارية المفضلة حتى عندما استبدلها النموذج بمرادف.

فئة المترجم المخصص (الصناعة / المجال)

with:
  sourceLocale: en
  subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
  endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
  categoryId: 1234abcd-5678-90ef-...

درب فئة Azure Custom Translator على مجموعة تعكس مفرداتك ونبرتك في الصناعة (القانونية، الطبية، التسويقية، الهندسة الداخلية، إلخ) واجتاز معرفها عبر categoryId. هذه أقوى رافعة نغمة تقدمها Azure.

التحكم في النغمة + خطة بدائية صارمة

# .github/resource-translator.yml
# Industry / domain — choose your tone via a Custom Translator category
categoryId: legal-en

# Treat profanity strictly for content aimed at younger audiences
profanityAction: Marked
profanityMarker: Tag

# Fail the run rather than silently fall back to the general model
allowFallback: false

اجمع بين categoryId المترجم المخصص مع profanityAction و allowFallback: false لفرض صوت متسق وتفشل سير العمل إذا لم يكن لدى الفئة المختارة نشر لأحد المواقع المستهدفة.

قم بتجربة تجريبية قبل تفعيل سير العمل

with:
  dryRun: true
  failOnError: false

لا تزال الفعل تصدر ملخصات وملخص خطوات، لكن لا يتم كتابة أي ملفات. اجمع بين failOnError: false لإظهار كل مشكلة كتحذير أثناء التكرار.