Ku Páaybe'en u traducción

Jaatsatako'ob tak paachil: provider predeterminada ti' azure, yo'olal le flujos meyaj existentes u Azure siguen funcionando xma' cambios — Xma' necesidad ediciones.

Selección jump'éel proveedor

Configurar le provider yaan tu azure (tumen defecto), aws wa google, ts'o'okole' suministrar credenciales le proveedor. Chéen jump'éel proveedor ku meyajtiko'ob tumen t'aano' asab; le molayil delega determinísticamente ti' le SDK coincidencia paach jump'éel fábrica.

Comparación le proveedor

Azure AI Translator (default)

Le proveedor tumen defecto. Provisionar jump'éel recurso Azure AI Translator yéetel máan subscriptionKey, endpoint, ka opcionalmente region. Lela' le ti' jump'éeli' kuchil-configuración le flujos meyaj existentes ts'o'ok utilizan.

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

Ku meyaj @aws-sdk/client-translate. Prefiere OIDC yóol aws-actions/configure-aws-credentials utia'al u ma' u almacenan secretos chowak kuxtal — le molayil xok le tsolokbal credenciales predeterminada SDK AWS. Alternativamente, máan awsAccessKeyId ka awsSecretAccessKey explícitamente. Mantats' k'a'abet jump'éel petenil ti' awsRegion wa le variable jeets' AWS_REGION.

Official AWS docs

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

OIDC (recomendado)

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

Utia'al u utilizar wach'ebo'obo' estáticas kúuchil OIDC, ja'at le paso aws-actions/configure-aws-credentials ka máan awsAccessKeyId awsSecretAccessKey (yóol secrets) awsRegion.

Traducción u múuyal u Google

Meyajtiko'ob @google-cloud/translate (v2). Autenticar yéetel jump'éel clave API (googleApiKey) wa jump'éel credencial JSON (googleCredentials). Suministrar exactamente juntúule'; Juntúul googleProjectId opcional ku infiere ti' le credencial ken u omit.

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

Mapeado u especificador intención

Le especificadores específicos ti' le proveedor ku mapean tu'ux yaan jump'éel equivalente. Tuláakal le demás ku ka'a ti' predeterminados sensatos yo'olal le comportamiento ku mantiene constante.

Le códigos locales difieren tumen proveedor

Amal proveedor meyajtiko'ob u leti'ob códigos locales (je'ebix, chino simplificado jach zh-Hans ti' Azure, zh ti' AWS yéetel zh-CN ti' Google). Le códigos ku yúuchul tumen tal bix yéetel ku impulsan le k'aaba'obo' archivo salida, bey u elija toLocales uts' k'ajóolilo'obo' u seleccionado u proveedor ti'.