Step 1: అనువాద ప్రదాతను ఎంచుకోండి
చర్య ఒక ఏకీకృత API ఉపరితలం వెనుక Azure AI Translator, AWS అనువాదం మరియు గూగుల్ క్లౌడ్ అనువాదం తో పనిచేస్తుంది. provider ఇన్ పుట్ తో ప్రతి పరుగుకు ఒకే ప్రొవైడర్ ను ఎంచుకోండి - వర్క్ ఫ్లో ప్రొవైడర్ తో సంబంధం లేకుండా ఒకే విధంగా ప్రవర్తిస్తుంది; ఆధారాలు మాత్రమే భిన్నంగా ఉంటాయి. పూర్తి పోలిక కోసం అనువాద ప్రొవైడర్లు చూడండి.
Step 2: క్రెడెన్షియల్స్ మరియు వర్క్ ఫ్లో జోడించండి
మీ ప్రొవైడర్ యొక్క ఆధారాలను GitHub రిపోజిటరీ రహస్యాలుగా నిల్వ చేసి, ఆపై .github/workflows/translate.yml సృష్టించండి. దాని నిర్దిష్ట సెటప్ కోసం క్రింద ఉన్న మీ ప్రొవైడర్ ను ఎంచుకోండి - మిగిలిన వర్క్ ఫ్లో ఒకేలా ఉంటుంది.
Azure AI Translator
అజ్యూరే డిఫాల్ట్ ప్రొవైడర్, అందువల్ల provider మినహాయించవచ్చు. Azure పోర్టల్ లో Azure AI Translator రిసోర్స్ ని ప్రొవిజన్ చేయండి, తరువాత దాని క్రెడెన్షియల్స్ ని స్టోర్ చేయండి:
వీటిని రిపోజిటరీ సీక్రెట్స్ గా నిల్వ చేయండి.
TRANSLATOR_KEY— రిసోర్స్ కొరకు సబ్ స్క్రిప్షన్ కీ.TRANSLATOR_ENDPOINT— ప్రాంతీయ ఎండ్ పాయింట్ URL.TRANSLATOR_REGION— రిసోర్స్ యొక్క అజ్యూరే రీజియన్.
వర్క్ ఫ్లో జోడించండి
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 అనువాదం
provider ను aws కు సెట్ చేయండి. aws-actions/configure-aws-credentials ద్వారా OIDC కి ప్రాధాన్యత ఇవ్వండి, కాబట్టి దీర్ఘకాలిక రహస్యాలు నిల్వ చేయబడవు - దశ ఎగుమతులు మీ కోసం 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-translationగూగుల్ క్లౌడ్ అనువాదం
provider ను google కు సెట్ చేయండి. సర్వీస్-అకౌంట్ JSON క్రెడెన్షియల్ లేదా API కీతో ప్రామాణీకరించండి — ఖచ్చితంగా ఒకదాన్ని సరఫరా చేయండి:
వీటిని రిపోజిటరీ సీక్రెట్స్ గా నిల్వ చేయండి.
GCP_TRANSLATE_CREDENTIALS— ఒక సేవ-ఖాతా JSON కీ (JSON స్ట్రింగ్ వలె).GCP_TRANSLATE_API_KEY— లేదా గూగుల్ క్లౌడ్ 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. ఇది core.summary ద్వారా ఉద్యోగ పేజీలో మార్క్ డౌన్ సారాంశాన్ని కూడా వ్రాస్తుంది.