Step 1: Pilih pembekal terjemahan
Tindakan ini berfungsi dengan Penterjemah Azure AI, Terjemahan AWS dan Terjemahan Awan Google di sebalik satu permukaan API bersatu. Pilih satu pembekal setiap larian dengan input provider — aliran kerja berkelakuan sama tanpa mengira pembekal; hanya kelayakan yang berbeza. Lihat Pembekal terjemahan untuk perbandingan penuh.
Step 2: Tambah kelayakan dan aliran kerja
Simpan kelayakan pembekal anda sebagai rahsia repositori GitHub, kemudian buat .github/workflows/translate.yml. Pilih pembekal anda di bawah untuk persediaan khususnya — aliran kerja yang lain adalah sama.
Penterjemah Azure AI
Azure ialah pembekal lalai, jadi provider mungkin ditinggalkan. Peruntukkan sumber Azure AI Translator dalam portal Microsoft Azure, kemudian simpan kelayakannya:
Simpan ini sebagai rahsia repositori
TRANSLATOR_KEY— kunci langganan untuk sumber.TRANSLATOR_ENDPOINT— URL titik akhir serantau.TRANSLATOR_REGION— rantau Azure sumber.
Tambah aliran kerja
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-translationTerjemahan AWS
Tetapkan provider kepada aws. Lebih suka OIDC melalui aws-actions/configure-aws-credentials supaya tiada rahsia jangka panjang disimpan — AWS_REGION eksport langkah untuk anda. Untuk menggunakan kunci statik, simpan:
Simpan ini sebagai rahsia repositori
AWS_ACCESS_KEY_ID— ID kunci akses AWS anda.AWS_SECRET_ACCESS_KEY— kunci akses rahsia AWS anda.
Rantau sentiasa diperlukan — tetapkannya dengan awsRegion atau pembolehubah persekitaran AWS_REGION.
Tambah aliran kerja
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-translationTerjemahan Awan Google
Tetapkan provider kepada google. Sahkan sama ada dengan kelayakan JSON akaun perkhidmatan atau kunci API — bekalkan tepat satu:
Simpan ini sebagai rahsia repositori
GCP_TRANSLATE_CREDENTIALS— kunci JSON akaun perkhidmatan (sebagai rentetan JSON).GCP_TRANSLATE_API_KEY— atau kunci API Google Cloud.
googleProjectId pilihan disimpulkan daripada kelayakan apabila ditinggalkan.
Tambah aliran kerja
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: Commit fail sumber sumber
Fail sumber menggunakan konvensyen Name.<sourceLocale>.<ext>. Contohnya Greetings.en.resx menjadi Greetings.fr.resx, Greetings.de.resx, dan sebagainya selepas berlari.
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: Periksa output
Setelah aliran kerja selesai, tindakan itu mendedahkan tiga output yang boleh anda sambungkan ke dalam perihalan PR: summary-title, summary-details dan has-new-translations. Ia juga menulis ringkasan Markdown ke dalam halaman kerja melalui core.summary.