Çeviri sağlayıcıları

Tamamen geriye dönük uyumluluk: provider varsayılan olarak azure kullanıyor, böylece mevcut Azure iş akışları değişmeden çalışmaya devam ediyor — düzenleme gerektirmiyor.

Sağlayıcı Seçimi

provider girdisini azure (varsayılan), aws veya google olarak ayarlayın, ardından o sağlayıcının kimlik bilgilerini verin. Her eylem çağrısı için yalnızca bir sağlayıcı kullanılır; eylem, bir fabrikanın arkasındaki eşleşen SDK'ya deterministik olarak devreder.

Sağlayıcı karşılaştırması

Azure AI Translator (default)

Varsayılan sağlayıcı. Bir Azure AI Çevirici kaynağı sağlayıp subscriptionKey, endpoint ve isteğe bağlı olarak region geçirin. Bu, mevcut iş akışlarının zaten kullandığı konfigürasyondur.

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

Kullanıyor @aws-sdk/client-translate. OIDC'yi aws-actions/configure-aws-credentials üzerinden tercih edin ki uzun ömürlü sırlar saklanmasın — eylem AWS SDK varsayılan kimlik zincirini okuyor. Alternatif olarak, awsAccessKeyId ve açıkça awsSecretAccessKey yapın. Her zaman bir bölge gereklidir; awsRegion veya AWS_REGION ortam değişkeni aracılığıyla.

Official AWS docs

• Amazon Translate overview
• TranslateText API reference
• Setting formality
• Using brevity
• Custom terminology
• Parallel data
• Supported languages

OIDC (önerilir)

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 yerine statik tuşlar kullanmak için aws-actions/configure-aws-credentials adımını bırakıp awsAccessKeyId / awsSecretAccessKey (secrets aracılığıyla) ve awsRegion ile geçin.

Google Bulut Çevirisi

@google-cloud/translate (v2) kullanır. Ya API anahtarı (googleApiKey) ya da hizmet hesabı JSON credential (googleCredentials) ile kimlik doğrulama yapın. Tam olarak bir tane verin; Belge çıkarıldığında isteğe bağlı bir googleProjectId çıkarılır.

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"]'

Intent-specifier mapping

Sağlayıcıya özgü belirticiler, eşdeğer bir şeyin bulunduğu yerlerde eşlenmiştir. Diğer her şey mantıklı varsayılan durumlara geri dönüyor, böylece davranış tutarlı kalır.

Yerel kodlar sağlayıcıya göre farklılık gösterir

Her sağlayıcı kendi yerel kodlarını kullanır (örneğin Simplified Chinese Azure'da zh-Hans, AWS'de zh ve Google'da zh-CN). Kodlar olduğu gibi geçer ve çıkış dosya isimlerini yönlendirir, bu yüzden seçtiğiniz sağlayıcının desteklediği toLocales değerleri seçin.