Te mau taata iriti parau

E tu'ati maitai i muri : E mea azure te provider, no reira, e tamau noa te mau tereraa ohipa Azure e vai ra ma te taui ore — aita e titauhia te mau tauiraa.

Te ma'itiraa i te hoê taata horo'a

A tuu i te provider i ni'a i te azure (default), aws, e aore râ google, e i muri iho a horo'a i te mau parau faati'a a taua taata ra. Hoê ana'e faanahoraa e faaohipahia i te hoê piiraa ohipa ; te ohipa e tuuhia i roto i te SDK tu'ati i muri mai i te hoê fare hamaniraa.

Faaauraa i te feia horo'a

Azure AI Translator (default)

Te taata horo'a matauhia. A horo'a i te hoê rave'a Azure AI Translator e a horo'a i te subscriptionKey, te endpoint, e te region. Hoê â faanahoraa teie ta te mau tereraa ohipa e faaohipa nei.

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

E faaohipa i te @aws-sdk/client-translate. A ma'iti a'e i te OIDC na roto i te aws-actions/configure-aws-credentials ia ore te mau parau huna maoro e haaputuhia. E aore râ, a horo'a awsAccessKeyId e awsSecretAccessKey ma te papû maitai. E titauhia te hoê tuhaa fenua i te mau taime atoa, na roto i te awsRegion e aore râ, na roto i te AWS_REGION vahi nohoraa.

Official AWS docs

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

OIDC (faaitoitoraa)

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

No te faaohipa i te mau taviri static eiaha râ te OIDC, a tuu i te taahiraa aws-actions/configure-aws-credentials e a tuu i te awsAccessKeyId / awsSecretAccessKey (na roto i te secrets) e te awsRegion.

Google Cloud Translation

E faaohipa i te @google-cloud/translate (v2). A haapapû na roto i te hoê API key (googleApiKey) e aore râ, te hoê parau faati'a JSON (googleCredentials). A horo'a mai i te hoê ti'a; e faahitihia te hoê googleProjectId ma'itiraa mai roto mai i te parau faati'a ia faaorehia.

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

Hoho'a no te haapapûraa i te opuaraa

E faanahohia te mau faataaraa taa ê no te taata horo'a i te mau vahi e vai ra te hoê aifaitoraa. Te tahi atu mau mea atoa, e ho'i mai ïa i ni'a i te mau hape tano maitai, no reira e vai tamau noa te haerea.

E mea taa ê te mau numera no te fenua tata'itahi

Te faaohipa nei te pûpû tata'itahi i ta'na iho mau numera fenua (ei hi'oraa, e zh-Hans te reo Tinito faaohie i ni'a i te Azure, te zh i ni'a i te AWS, e te zh-CN i ni'a i te Google). E haere te mau numera na roto i te mau i'oa o te mau putu'toLocales e arata'i i te mau i'oa o te putu'ite, no reira, a ma'iti i te mau faufaa ta outou i ma'iti.