Founisè tradiksyon yo

Konplètman bak konpatib: provider default azure, se konsa ki deja egziste Azure workflows kontinye ap travay san chanje - pa gen okenn modifikasyon obligatwa.

Chwazi yon founisè

Mete opinyon an provider azure (default), aws oswa google, Lè sa a, bay kalifikasyon founisè sa a. Se sèlman yon sèl founisè yo itilize pou chak apèl aksyon; aksyon an detèminatif delege nan matche SDK la dèyè faktori a.

Konparezon founisè

Azure AI Translator (default)

Founisè a default. Pwovizyon yon resous Azure AI Translator epi pase subscriptionKey, endpoint, ak opsyonèlman region. Sa a se menm konfigirasyon ki deja egziste workflows itilize.

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 Tradui

Sèvi ak @aws-sdk/client-translate Prefere OIDC via aws-actions/configure-aws-credentials konsa pa gen sekrè ki viv lontan ki estoke - aksyon an li chèn kalifikasyon AWS SDK default. Altènativman, pase awsAccessKeyId ak awsSecretAccessKey ekspresite. Yon rejyon toujou obligatwa, via awsRegion oswa varyab anviwònman an AWS_REGION.

Official AWS docs

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

OIDC (rekòmande)

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

Pou itilize kle estatik olye pou yo OIDC, lage etap la aws-actions/configure-aws-credentials epi pase awsAccessKeyId / awsSecretAccessKey (via secrets) plis awsRegion.

Google Cloud Tradiksyon

Sèvi ak @google-cloud/translate (v2) Otantifye ak swa yon kle API (googleApiKey) oswa yon sèvis-kont JSON kalifikasyon (googleCredentials). Pwovizyon pou egzakteman yon sèl; Yon googleProjectId si ou vle dedwi soti nan kalifikasyon an lè omite.

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

Entansyon espesifyan kat

Espesifikasyon founisè espesifik yo kat kote yon ekivalan egziste. Tout lòt bagay tonbe tounen nan défauts sansib pou konpòtman rete konsistan.

Lokal kòd diferan pou chak founisè

Chak founisè itilize pwòp kòd lokal li yo (pou egzanp Chinwa senplifye se zh-Hans sou Azure, zh sou AWS, ak zh-CN sou Google). Kòd pase nan jan se ak kondwi non dosye pèsistans yap ogmante jiska yo, se konsa chwazi valè toLocales ou chwazi founisè sipòte.