Step 1: Pasirinkite vertimo paslaugų teikėją
Veiksmas veikia su Azure AI Translator, AWS vertimas ir "Google" debesies vertimas už vieno vieningo API paviršiaus. Pasirinkite vieną teikėją vienam vykdymui su provider įvestimi – darbo eiga veikia identiškai, nepriklausomai nuo teikėjo; skiriasi tik kredencialai. Žiūrėkite Vertimo paslaugų teikėjai išsamų palyginimą.
Step 2: Kredencialų ir darbo eigos įtraukimas
Saugokite teikėjo kredencialus kaip "GitHub" saugyklos paslaptis, tada sukurkite .github/workflows/translate.yml. Toliau pasirinkite paslaugų teikėją pagal konkrečią sąranką – likusi darbo eigos dalis yra identiška.
Azure AI Translator
"Azure" yra numatytasis teikėjas, todėl provider gali būti praleistas. Konfigūruokite "Azure AI Translator" išteklius "Azure" portale, tada išsaugokite jo kredencialus:
Saugokite juos kaip saugyklos paslaptis
TRANSLATOR_KEY— Ištekliaus prenumeratos raktas.TRANSLATOR_ENDPOINT— regioninio galinio punkto URL.TRANSLATOR_REGION— ištekliaus "Azure" regione.
Darbo eigos įtraukimas
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate uses: IEvangelist/resource-translator@v3 with: provider: | azure: subscriptionKey: ${{ secrets.TRANSLATOR_KEY }} endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }} region: ${{ secrets.TRANSLATOR_REGION }} sourceLocale: en toLocales: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationAWS vertimas
Nustatykite provider į aws. Pirmenybę teikite OIDC per aws-actions/configure-aws-credentials kad nebūtų saugomos ilgaamžės paslaptys – žingsnis eksportas AWS_REGION jums. Jei norite naudoti statinius raktus, saugokite:
Saugokite juos kaip saugyklos paslaptis
AWS_ACCESS_KEY_ID— jūsų AWS prieigos rakto ID.AWS_SECRET_ACCESS_KEY— jūsų AWS slaptas prieigos raktas.
Regionas visada reikalingas – nustatykite jį naudodami awsRegion arba AWS_REGION aplinkos kintamąjį.
Darbo eigos įtraukimas
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
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: translate 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: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translation"Google" debesies vertimas
Nustatykite provider į google. Autentifikuokite naudodami paslaugos paskyros JSON kredencialą arba API raktą – pateikite tiksliai vieną:
Saugokite juos kaip saugyklos paslaptis
GCP_TRANSLATE_CREDENTIALS— paslaugos abonemento JSON raktas (kaip JSON eilutė).GCP_TRANSLATE_API_KEY— arba "Google Cloud API" raktą.
Neprivalomas googleProjectId išvedamas iš kredencialų, kai jis praleidžiamas.
Darbo eigos įtraukimas
name: translate
on: push: branches: [main] paths: - "src/**/*.en.resx" - "src/**/*.en.json"
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translate 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: '["fr","de","es"]' - if: steps.translate.outputs.has-new-translations == 'true' uses: peter-evans/create-pull-request@v7 with: title: ${{ steps.translate.outputs.summary-title }} body: ${{ steps.translate.outputs.summary-details }} branch: machine-translationStep 3: Šaltinio išteklių failo patvirtinimas
Išteklių failuose naudojama Name.<sourceLocale>.<ext> konvencija. Pavyzdžiui, Greetings.en.resx po bėgimo tampa Greetings.fr.resx, Greetings.de.resx ir pan.
Step 4: Let smart change detection protect your bill
changeDetection defaults to smart and stores a compact .github/resource-translator-state.json manifest in the repo. Commit that file so future runs can reuse stable translations, preserve manual target edits, and send only new, missing, changed, or settings-invalidated keys to the provider. If localized files already exist, run once with snapshotOnly: true to create the manifest without provider calls.
Step 5: Patikrinkite išvestį
Kai darbo eiga baigiasi, veiksmas atskleidžia tris išvestis, kurias galite prijungti prie PR aprašymo: summary-title, summary-details ir has-new-translations. Jis taip pat įrašo "Markdown" santrauką į darbo puslapį per core.summary.