Bixiyeyaasha turjumaadda

Si buuxda dib ula jaanqaadi kara: provider si caadi ah ugu shaqeeyaa azure, sidaas darteed habka Azure ee jira ayaa si aan isbeddelin u shaqeynaya — wax ka beddel looma baahna.

Xulashada bixiye

Deji gelinta provider azure (default), aws, ama google, kadibna bixi aqoonsiga bixiyahaas. Kaliya hal bixiye ayaa la isticmaalaa wicitaan kasta oo action ah; falkaas si go'aan ah ayuu u wareejiyaa SDK-ga la jaanqaadaya ee ka dambeeya warshad.

Isbarbardhigga bixiyeyaasha

Azure AI Translator (default)

Bixiyaha asalka ah. Keen kheyraad Azure AI Translator ah oo gudbi subscriptionKey, endpoint, iyo ikhtiyaari ahaan region. Tani waa isla qaabeynta ay horey u isticmaalaan hab-socodka hore.

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

Wuxuu isticmaalaa @aws-sdk/client-translate. Doorbid OIDC adigoo adeegsanaya aws-actions/configure-aws-credentials si aan loo keydinin siraha waqti dheer dheer — falku wuxuu akhriyaa silsiladda aqoonsiga asalka ah ee AWS SDK. Sidoo kale, si awsAccessKeyId ah u gudbi oo si cad awsSecretAccessKey. Gobol mar walba waa loo baahan yahay, iyada oo loo marayo awsRegion ama beddelka deegaanka AWS_REGION.

Official AWS docs

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

OIDC (lagu talinay)

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

Si aad u isticmaasho furayaasha static halkii laga isticmaali lahaa OIDC, ka tag talaabada aws-actions/configure-aws-credentials oo sii awsAccessKeyId / awsSecretAccessKey (iyada oo loo marayo secrets) iyo awsRegion.

Tarjumaadda Google Cloud

Wuxuu isticmaalaa @google-cloud/translate (v2). Xaqiiji adigoo adeegsanaya furaha API (googleApiKey) ama aqoonsiga JSON ee akoonka adeegga (googleCredentials). Keen hal sax ah; googleProjectId ikhtiyaari ah ayaa laga soo saaraa aqoonsiga marka laga saaro.

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

Mapping intent-specifier

Specifiers gaar ah oo bixiyaha ah ayaa lagu khariideeyaa meesha ay jirto mid la mid ah. Wax kasta oo kale waxay ku noqdaan default macquul ah si dhaqanka uu joogto u ahaado.

Koodhadhka deegaanka way kala duwan yihiin bixiye kasta

Bixiye kasta wuxuu isticmaalaa koodhadhkiisa deegaanka (tusaale ahaan Simplified Chinese waa zh-Hans Azure, zh AWS, iyo zh-CN Google). Koodhadhku waxay maraan sida ay yihiin waxayna wadaan magacyada faylalka wax soo saarka, markaa dooro toLocales uu taageero bixiyaha aad dooratay.