Mga tagapagbigay ng pagsasalin

Ganap na pabalik na katugma: Ang provider ay default sa azure, kaya ang mga umiiral na mga daloy ng trabaho ng Azure ay patuloy na gumagana nang hindi nagbabago - walang kinakailangang mga pag-edit.

Pumili ng isang tagapagbigay ng serbisyo

Itakda ang input ng provider sa azure (default), aws, o google, pagkatapos ay ibigay ang mga kredensyal ng provider na iyon. Isang provider lamang ang ginagamit sa bawat tawag sa pagkilos; ang aksyon deterministically delegado sa pagtutugma SDK sa likod ng isang pabrika.

Paghahambing ng provider

Azure AI Translator (default)

Ang default na tagapagbigay ng serbisyo. Magbibigay ng isang mapagkukunan ng Azure AI Translator at ipasa ang subscriptionKey, endpoint, at opsyonal na region. Ito ang parehong configuration na ginagamit na ng mga umiiral na daloy ng trabaho.

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

Email Address *

Gumagamit ng @aws-sdk/client-translate. Mas gusto ang OIDC sa pamamagitan ng aws-actions/configure-aws-credentials upang walang pangmatagalang lihim na naka-imbak - binabasa ng aksyon ang default na kadena ng kredensyal ng AWS SDK. Bilang kahalili, ipasa ang awsAccessKeyId at awsSecretAccessKey nang malinaw. Ang isang rehiyon ay palaging kinakailangan, sa pamamagitan ng awsRegion o ang variable ng kapaligiran ng AWS_REGION.

Official AWS docs

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

OIDC (inirerekomenda)

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

Upang magamit ang mga static key sa halip na OIDC, i-drop ang aws-actions/configure-aws-credentials hakbang at ipasa ang awsAccessKeyId / awsSecretAccessKey (sa pamamagitan ng secrets) at awsRegion.

Pagsasalin ng Google Cloud

Gamitin ang @google-cloud/translate (v2). Magpatunay gamit ang alinman sa isang API key (googleApiKey) o isang kredensyal ng JSON ng service-account (googleCredentials). Magbigay ng eksaktong isa; Ang isang opsyonal na googleProjectId ay hinuha mula sa kredensyal kapag tinanggal ito.

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

Pagma-map ng intent-specifier

Ang mga specifier na tukoy sa provider ay naka-map kung saan umiiral ang isang katumbas. Lahat ng iba pa ay bumabalik sa makatwirang mga default kaya ang pag-uugali ay nananatiling pare-pareho.

Ang mga lokal na code ay naiiba sa bawat provider

Ang bawat provider ay gumagamit ng sarili nitong mga locale code (halimbawa, ang Pinasimpleng Tsino ay zh-Hans sa Azure, zh sa AWS, at zh-CN sa Google). Ang mga code ay dumadaan sa as-is at hinimok ang mga pangalan ng output file, kaya piliin ang toLocales mga halaga na sinusuportahan ng iyong napiling provider.