Step 1: Izberite ponudnika prevajanja
Akcija deluje z Azure AI Translator, AWS Translate in Google Cloud prevajalnik za eno enotno površino API-ja. Izberite enega ponudnika na zagon z provider vhodom — potek dela se obnaša enako ne glede na ponudnika; razlikujejo se le kvalifikacije. Za popolno primerjavo glejte Prevajalski ponudniki.
Step 2: Dodajte poverilnice in potek dela
Shranite poverilnice svojega ponudnika kot skrivnosti GitHub repozitorija, nato ustvarite .github/workflows/translate.yml. Izberite svojega ponudnika spodaj glede na njegovo specifično nastavitev — preostali delovni proces je enak.
Azure AI Translator
Azure je privzeti ponudnik, zato se provider lahko izpusti. Vzpostavite vir Azure AI Translator v Azure portalu in nato shranite njegove poverilnice:
Te shranite kot skrivnosti repozitorija
TRANSLATOR_KEY— naročniški ključ za vir.TRANSLATOR_ENDPOINT— regionalni URL končne točke.TRANSLATOR_REGION— azure regija vira.
Dodajte delovni proces
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 Translate
Nastavi provider na aws. Raje izberite OIDC preko aws-actions/configure-aws-credentials, da se ne shranjujejo dolgotrajne skrivnosti — korak izvoza AWS_REGION za vas. Za uporabo statičnih ključev namesto tega shranite:
Te shranite kot skrivnosti repozitorija
AWS_ACCESS_KEY_ID— vaš AWS access key ID.AWS_SECRET_ACCESS_KEY— vaš AWS tajni dostopni ključ.
Regija je vedno potrebna — nastavite jo z awsRegion ali AWS_REGION okoljske spremenljivke.
Dodajte delovni proces
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-translationGoogle Cloud prevajalnik
Nastavi provider na google. Avtentikirajte z JSON poverilnico storitvenega računa ali API ključem — vnesite natanko enega:
Te shranite kot skrivnosti repozitorija
GCP_TRANSLATE_CREDENTIALS— JSON ključ storitvenega računa (kot JSON niz).GCP_TRANSLATE_API_KEY— ali Google Cloud API ključ.
Neobvezno googleProjectId se sklepa iz poverilnice, če je izpuščena.
Dodajte delovni proces
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: Potrdite datoteko izvornega vira
Datoteke z viri uporabljajo Name.<sourceLocale>.<ext> konvencijo. Na primer Greetings.en.resx postane Greetings.fr.resx, Greetings.de.resx in tako naprej po teku.
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: Preverite izhod
Ko potek dela konča, akcija razkrije tri izhode, ki jih lahko povežete v PR opis: summary-title, summary-details in has-new-translations. Prav tako zapiše povzetek Markdown na stran delovnega mesta preko core.summary.