Step 1: Изберете преводачески доставчик
Действието работи с Azure AI Translator, AWS Translate и Google Cloud превод зад единна API повърхност. Изберете един доставчик на изпълнение с provider вход — работният процес се държи еднакво независимо от доставчика; Само квалификациите се различават. Вижте Доставчици на преводи за пълно сравнение.
Step 2: Добавете идентификационни данни и работен процес
Съхранявайте данните на вашия доставчик като тайни на хранилището на GitHub, след което създавайте .github/workflows/translate.yml. Изберете вашия доставчик по-долу за конкретната му конфигурация — останалата част от работния процес е идентична.
Azure AI Translator
Azure е стандартният доставчик, така че provider може да бъде пропуснат. Осигурете ресурс за Azure AI преводач в Azure портала, след което съхранявайте неговите идентификационни данни:
Съхранявайте ги като тайни на хранилището
TRANSLATOR_KEY— ключът за абонамент за ресурса.TRANSLATOR_ENDPOINT— регионалният URL на крайната точка.TRANSLATOR_REGION— ресурсът е Azure регионът.
Добавете работния процес
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
Настрой provider на aws. Предпочитайте OIDC чрез aws-actions/configure-aws-credentials, за да не се съхраняват дълготрайни тайни — стъпката за експорт AWS_REGION за вас. За да използвате статични ключове, запазете:
Съхранявайте ги като тайни на хранилището
AWS_ACCESS_KEY_ID— вашият AWS ключ ID.AWS_SECRET_ACCESS_KEY— твоят AWS таен достъп ключ.
Винаги е необходим регион — задайте го с awsRegion или с променливата AWS_REGION среда.
Добавете работния процес
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 превод
Настрой provider на google. Удостоверете се с JSON идентификационни данни за service-account или API ключ — предоставите точно един:
Съхранявайте ги като тайни на хранилището
GCP_TRANSLATE_CREDENTIALS— JSON ключ за служебна сметка (като JSON низ).GCP_TRANSLATE_API_KEY— или Google Cloud API ключ.
От удостоверението се извежда опционален googleProjectId, когато бъде пропуснат.
Добавете работния процес
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: Зафайл на изходен ресурсен файл
Файловете с ресурси използват конвенцията Name.<sourceLocale>.<ext>. Например Greetings.en.resx става Greetings.fr.resx, Greetings.de.resx и така нататък след бягане.
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: Инспектирайте изхода
След като работният процес приключи, действието показва три изхода, които можете да свържете в PR описание: summary-title, summary-details и has-new-translations. Също така се записва резюме на Markdown на страницата за работа чрез core.summary.