Oversettelsesleverandører

Fullstendig bakoverkompatibel: provider er som standard azure, så eksisterende Azure-arbeidsflyter fortsetter å fungere uendret — ingen redigeringer kreves.

Valg av leverandør

Sett provider input til azure (standard), aws eller google, og oppgi deretter leverandørens legitimasjon. Kun én leverandør brukes per handlingssamtale; handlingen delegerer deterministisk til den matchende SDK-en bak en fabrikk.

Leverandørsammenligning

Azure AI Translator (default)

Standardleverandøren. Installer en Azure AI Translator-ressurs og send subscriptionKey, endpoint og eventuelt region. Dette er samme konfigurasjon som eksisterende arbeidsflyter allerede bruker.

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

Bruker @aws-sdk/client-translate. Foretrekk OIDC via aws-actions/configure-aws-credentials slik at ingen langvarige hemmeligheter lagres — handlingen leser AWS SDK sin standard legitimasjonskjede. Alternativt, bestå awsAccessKeyId og awsSecretAccessKey eksplisitt. En region er alltid nødvendig, via awsRegion eller den AWS_REGION miljøvariabelen.

Official AWS docs

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

OIDC (anbefalt)

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

For å bruke statiske taster i stedet for OIDC, slipp aws-actions/configure-aws-credentials steg og send awsAccessKeyId / awsSecretAccessKey (via secrets) pluss awsRegion.

Google Sky-oversettelse

Bruker @google-cloud/translate (v2). Autentiser med enten en API-nøkkel (googleApiKey) eller en tjenestekonto-JSON-legitimasjon (googleCredentials). Gi nøyaktig én; En valgfri googleProjectId utledes fra kvalifikasjonen når den utelates.

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

Intensspesifiser-kartlegging

Leverandørspesifikke spesifikasjoner mappes der en ekvivalent finnes. Alt annet faller tilbake på fornuftige standardinnstillinger slik at oppførselen forblir konsistent.

Lokalkodene varierer fra leverandør til leverandør

Hver leverandør bruker sine egne lokalkoder (for eksempel er forenklet kinesisk zh-Hans på Azure, zh på AWS og zh-CN på Google). Koder går gjennom som de er og styrer utdatafilnavnene, så velg toLocales verdiene din valgte leverandør støtter.