Πάροχοι μετάφρασης

Πλήρως συμβατό με προηγούμενες εκδόσεις: provider προεπιλογή σε azure, επομένως οι υπάρχουσες ροές εργασίας Azure συνεχίζουν να λειτουργούν αμετάβλητες — δεν απαιτούνται αλλαγές.

Επιλογή παρόχου

Ορίστε την είσοδο provider σε azure (προεπιλογή), aws ή google και, στη συνέχεια, δώστε τα διαπιστευτήρια αυτού του παρόχου. Χρησιμοποιείται μόνο ένας πάροχος ανά κλήση ενέργειας. η δράση ανατίθεται ντετερμινιστικά στο αντίστοιχο SDK πίσω από ένα εργοστάσιο.

Σύγκριση παρόχων

Azure AI Translator (προεπιλογή)

Ο προεπιλεγμένος πάροχος. Παρέχετε έναν πόρο Azure AI Translator και περάστε subscriptionKey, endpoint και προαιρετικά region. Αυτή είναι η ίδια ρύθμιση παραμέτρων που χρησιμοποιούν ήδη οι υπάρχουσες ροές εργασίας.

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

Χρήσεις @aws-sdk/client-translate. Προτιμήστε το OIDC μέσω aws-actions/configure-aws-credentials, ώστε να μην αποθηκεύονται μακροχρόνια μυστικά — η ενέργεια διαβάζει την προεπιλεγμένη αλυσίδα διαπιστευτηρίων AWS SDK. Εναλλακτικά, περάστε awsAccessKeyId και awsSecretAccessKey ρητά. Απαιτείται πάντα μια περιοχή, μέσω awsRegion ή της μεταβλητής περιβάλλοντος AWS_REGION.

Official AWS docs

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

OIDC (συνιστάται)

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

Για να χρησιμοποιήσετε στατικά κλειδιά αντί για OIDC, αφήστε το βήμα aws-actions/configure-aws-credentials και περάστε awsAccessKeyId / awsSecretAccessKey (μέσω secrets) συν awsRegion.

Μετάφραση Google Cloud

Χρησιμοποιεί @google-cloud/translate (v2). Πραγματοποιήστε έλεγχο ταυτότητας είτε με κλειδί API (googleApiKey) είτε με διαπιστευτήρια JSON λογαριασμού υπηρεσίας (googleCredentials). Προμήθεια ακριβώς ένα. Μια προαιρετική googleProjectId συνάγεται από τα διαπιστευτήρια όταν παραλείπεται.

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

Αντιστοίχιση προσδιοριστή πρόθεσης

Οι προσδιοριστές για συγκεκριμένους παρόχους αντιστοιχίζονται όπου υπάρχει ισοδύναμο. Όλα τα άλλα επιστρέφουν σε λογικές προεπιλογές, ώστε η συμπεριφορά να παραμένει συνεπής.

Οι τοπικοί κωδικοί διαφέρουν ανά πάροχο

Κάθε πάροχος χρησιμοποιεί τους δικούς του κωδικούς τοπικών ρυθμίσεων (για παράδειγμα, τα Απλοποιημένα Κινεζικά είναι zh-Hans στο Azure, zh στο AWS και zh-CN στο Google). Οι κωδικοί περνούν ως έχουν και οδηγούν τα ονόματα των αρχείων εξόδου, επομένως επιλέξτε toLocales τιμές που υποστηρίζει ο επιλεγμένος πάροχος.