Step 1: Digitaka e dua na dauvakadewa
Na cakacaka e cakacaka vata kei na Azure AI Translator, Vakadewa ni AWS, kei na iVakadewa ni O ni Google ena daku ni dua na dela ni API cokovata Digitaka e dua na dauveiqaravi ena dua na cici vata kei na vakacurumi ni provider — na cakacaka e tautauvata ga veitalia na dauveiqaravi; e duidui ga na ivakatakilakila. Raica na Dauvakadewa me baleta e dua na veivakatauvatani taucoko.
Step 2: Kuria na ivakatakilakila kei na dua na cakacaka
Maroroya na ivakatakilakila ni nomu dauveiqaravi me vaka na GitHub repository vuni, qai tauyavutaka .github/workflows/translate.yml. Digitaka na nomu dauveiqaravi e ra me baleta na kena ituvatuva vakatabakidua — na vo ni cakacaka e tautauvata.
Azure AI Translator
Azure sa ikoya na dausoli lalai, provider rawa ni kau laivi. Vakarautaka e dua na ivurevure ni Azure AI Translator ena Azure portal, qai maroroya na kena ivakatakilakila:
Maroroya oqo me ka vuni ni repository
TRANSLATOR_KEY— na idola ni sausaumi me baleta na ivurevure.TRANSLATOR_ENDPOINT— na URL ni icavacava ni iwasewase.TRANSLATOR_REGION— na iwasewase ni Azure ni ivurevure.
Kuria na cakacaka ni cakacaka
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-translationVakadewa ni AWS
Tuvanaka provider ki na aws. Taleitaka na OIDC mai na aws-actions/configure-aws-credentials me kakua kina ni maroroi na veika vuni balavu — na ikalawa ni vakau AWS_REGION me baleti iko. Me vakayagataki na idola static, maroroya na:
Maroroya oqo me ka vuni ni repository
AWS_ACCESS_KEY_ID— nomu ID ni idola ni curu ki na AWS.AWS_SECRET_ACCESS_KEY— nomu idola vuni ni curu ki na AWS.
E dau gadrevi e dua na iwasewase — tuvanaka vata kei na awsRegion se na AWS_REGION environment variable.
Kuria na cakacaka ni cakacaka
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-translationiVakadewa ni O ni Google
Tuvanaka provider ki na google. Authenticate vata kei na dua na ivakatakilakila ni JSON ni akaude ni veiqaravi se dua na idola ni API — vakarautaka sara ga e dua:
Maroroya oqo me ka vuni ni repository
GCP_TRANSLATE_CREDENTIALS— e dua na idola ni JSON ni akaude ni veiqaravi (me vaka e dua na string ni JSON).GCP_TRANSLATE_API_KEY— se dua na idola ni Google Cloud API.
E dua na googleProjectId digitaki e inferred mai na credential ni sa sega ni vakayagataki.
Kuria na cakacaka ni cakacaka
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: Vakadeitaka e dua na faile ni ivurevure ni ivurevure
Na faili ni ivurevure e vakayagataka na Name.<sourceLocale>.<ext> convention. Kena ivakaraitaki Greetings.en.resx yaco me Greetings.fr.resx, Greetings.de.resx, kei na so tale ni oti e dua na cici.
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: Dikeva na output
Ni sa oti na cakacaka, na cakacaka e vakaraitaka e tolu na outputs e rawa ni o vakauqeta ki na dua na ivakamacala ni PR: summary-title, summary-details, kei na has-new-translations. E vola talega e dua na ivakaleka ni Markdown ki na tabana ni cakacaka ena core.summary.