Masu ba da fassara

Cikakken jituwa a baya: provider tsoho zuwa azure, don haka ayyukan Azure na yanzu suna ci gaba da aiki ba tare da canzawa ba - babu gyare-gyare da ake buƙata.

Zaɓin mai ba da sabis

Saita shigarwar provider zuwa azure (tsoho), aws, ko google, sa'an nan kuma samar da takardun shaidar wannan mai bayarwa. Ana amfani da mai ba da sabis ɗaya kawai a kowane kiran aiki; aikin yana ƙayyade zuwa SDK mai dacewa a bayan masana'anta.

Kwatancen mai ba da sabis

Azure AI Translator (tsoho)

Mai ba da sabis na tsoho. Samar da kayan aikin mai fassara na Azure AI kuma wuce subscriptionKey, endpoint, da zaɓi region. Wannan shi ne tsarin da aka riga aka yi amfani da shi a yanzu.

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

Fassarar AWS

Yi amfani da @aws-sdk/client-translate. Zaɓi OIDC ta hanyar aws-actions/configure-aws-credentials don haka ba a adana sirri na dogon lokaci ba - aikin yana karanta sarkar takardun shaida ta AWS SDK. A madadin haka, wuce awsAccessKeyId kuma awsSecretAccessKey a bayyane. Ana buƙatar yanki koyaushe, ta hanyar awsRegion ko AWS_REGION yanayin yanayi.

Official AWS docs

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

OIDC (an ba da shawarar)

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

Don amfani da maɓallan tsayayye maimakon OIDC, sauke matakin aws-actions/configure-aws-credentials kuma wuce awsAccessKeyId / awsSecretAccessKey (ta hanyar secrets) da awsRegion.

Fassarar Google Cloud

Yi amfani da @google-cloud/translate (v2). Tabbatar da ko dai maɓallin API (googleApiKey) ko takaddun shaidar JSON na asusun sabis (googleCredentials). Samar da daidai daya; Ana samun zaɓi googleProjectId daga takardun shaida idan aka cire shi.

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

Taswirar taswirar niyya

An tsara ƙayyadaddun ƙayyadaddun ƙa Duk sauran abubuwa sun koma ga kuskure mai ma'ana don haka halayyar ta kasance daidai.

Lambobin yanki sun bambanta da mai ba da sabis

Kowane mai ba da sabis yana amfani da lambobin yanki na kansa (misali Sinanci mai sauƙi yana zh-Hans akan Azure, zh akan AWS, da zh-CN akan Google). Lambobin suna wucewa kamar yadda yake kuma suna fitar da sunayen fayil ɗin fitarwa, don haka zaɓi ƙimar da toLocales zaɓa mai ba da sabis ɗin da kuka zaɓa ke tallafawa.