Step 1: Zgjidhni një ofrues përkthimi
Veprimi funksionon me Azure AI Translator, Përkthej AWS dhe Përkthimi i Google Cloud pas një sipërfaqeje të unifikuar API. Zgjidhni një ofrues të vetëm për ekzekutim me hyrjen provider - rrjedha e punës sillet në mënyrë identike pavarësisht nga ofruesi; vetëm kredencialet ndryshojnë. Shih Ofruesit e përkthimit për një krahasim të plotë.
Step 2: Shtoni kredencialet dhe një rrjedhë pune
Ruani kredencialet e ofruesit tuaj si sekrete të depove GitHub, më pas krijoni .github/workflows/translate.yml. Zgjidhni ofruesin tuaj më poshtë për konfigurimin e tij specifik - pjesa tjetër e rrjedhës së punës është identike.
Azure AI Translator
Azure është ofruesi i paracaktuar, kështu që provider mund të hiqet. Siguroni një burim Azure AI Translator në portalin Azure, më pas ruani kredencialet e tij:
Ruani këto si sekrete depoje
TRANSLATOR_KEY— çelësi i abonimit për burimin.TRANSLATOR_ENDPOINT— URL-ja e pikës përfundimtare rajonale.TRANSLATOR_REGION— rajoni Azure i burimit.
Shtoni rrjedhën e punës
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-translationPërkthej AWS
Vendosni provider në aws. Preferoni OIDC përmes aws-actions/configure-aws-credentials në mënyrë që të mos ruhen sekrete jetëgjata - eksportet e hapit AWS_REGION për ju. Për të përdorur çelësat statikë në vend të kësaj, ruani:
Ruani këto si sekrete depoje
AWS_ACCESS_KEY_ID— ID-ja juaj e çelësit të aksesit AWS.AWS_SECRET_ACCESS_KEY— çelësi juaj sekret i aksesit AWS.
Kërkohet gjithmonë një rajon - vendoseni atë me awsRegion ose variablin e mjedisit AWS_REGION.
Shtoni rrjedhën e punës
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-translationPërkthimi i Google Cloud
Vendosni provider në google. Autentifikoni ose me një kredencial JSON të llogarisë së shërbimit ose një çelës API - jepni saktësisht një:
Ruani këto si sekrete depoje
GCP_TRANSLATE_CREDENTIALS— një çelës JSON të llogarisë së shërbimit (si një varg JSON).GCP_TRANSLATE_API_KEY— ose një çelës API të Google Cloud.
Një googleProjectId opsionale konkludohet nga kredencialet kur hiqet.
Shtoni rrjedhën e punës
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: Kryeni një skedar burimi burimor
Skedarët e burimeve përdorin konventën Name.<sourceLocale>.<ext>. Për shembull Greetings.en.resx bëhet Greetings.fr.resx, Greetings.de.resx, e kështu me radhë pas një vrapimi.
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: Inspektoni daljen
Pasi të përfundojë rrjedha e punës, veprimi ekspozon tre dalje që mund t'i lidhni në një përshkrim PR: summary-title, summary-details dhe has-new-translations. Ai gjithashtu shkruan një përmbledhje Markdown në faqen e punës përmes core.summary.