Fornitori di traduzione

Completamente retrocompatibile: provider predefinito su azure, così i flussi di lavoro Azure esistenti continuano a funzionare invariati — senza modifiche necessarie.

Scelta di un fornitore

Imposta l'ingresso provider su azure (predefinito), aws o google, poi fornisci le credenziali di quel fornitore. Viene utilizzato un solo provider per ogni chiamata d'azione; l'azione delega deterministicamente all'SDK corrispondente dietro una fabbrica.

Confronto dei fornitori

Azure AI Translator (predefinito)

Il fornitore predefinito. Provvedi una risorsa Azure AI Translator e passa subscriptionKey, endpoint e opzionalmente region. Questa è la stessa configurazione che i flussi di lavoro esistenti già utilizzano.

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

Usa @aws-sdk/client-translate. Preferisci OIDC tramite aws-actions/configure-aws-credentials così non vengono memorizzati segreti duraturi — l'azione legge la catena di credenziali predefinita dell'AWS SDK. In alternativa, passa awsAccessKeyId e awsSecretAccessKey esplicitamente. Una regione è sempre necessaria, tramite awsRegion o la variabile AWS_REGION ambiente.

Official AWS docs

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

OIDC (consigliato)

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

Per usare tasti statici invece dell'OIDC, elimina il passo aws-actions/configure-aws-credentials e passa awsAccessKeyId / awsSecretAccessKey (tramite secrets) più awsRegion.

Traduzione Google Cloud

Utilizza @google-cloud/translate (v2). Autentica con una chiave API (googleApiKey) o con una credenziale JSON (googleCredentials) dell'account di servizio. Fornisci esattamente uno; una googleProjectId opzionale viene dedotta dalla credenziale quando viene omessa.

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

Mappatura dello specificatore di intento

Gli specificatori specifici del fornitore vengono mappati dove esiste un equivalente. Tutto il resto torna a valori predefiniti sensati così il comportamento rimane coerente.

I codici locali variano a seconda del fornitore

Ogni fornitore utilizza i propri codici di località (ad esempio, il cinese semplificato è zh-Hans su Azure, zh su AWS e zh-CN su Google). I codici passano così com'è e guidano i nomi dei file di output, quindi scegli toLocales valori supportati dal provider selezionato.