Step 1: अणकार पुरवणदार निवडात
ही क्रिया एका एकवटीत API पृष्ठभागा फाटल्यान Azure AI Translator, AWS अणकार आनी गूगल क्लाऊड ट्रान्सलेशन[बदल] घेवन काम करता. provider इनपुटा सयत दर धांवड्याक एकूच पुरवणदार वेंचून काडात — कार्यप्रवाह पुरवणदाराची पर्वा करिनासतना एकसारको वागता. फकत प्रमाणपत्रां वेगळीं आसात. पुराय तुलनेखातीर भाक्षांतोर पुरवणदार[सुदार] पळयात.
Step 2: क्रेडेन्शियल्स आनी वर्कफ्लो जोडात
तुमच्या पुरवणदाराची क्रेडेन्शियल्स GitHub रिपॉझिटरी गुपीत म्हणून सांठोवन दवरात, मागीर .github/workflows/translate.yml तयार करात. ताच्या विशिश्ट मांडपा खातीर सकयल तुमचो पुरवणदार निवडात — उरिल्लो कार्यप्रवाह एकसारको आसा.
Azure AI Translator
Azure हो डिफॉल्ट पुरवणदार आसा, देखून 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 अणकार
Set provider to aws. aws-actions/configure-aws-credentials वरवीं OIDC पसंत करात जाका लागून चड काळ तिगून उरपी गुपीत सांठोवन दवरूंक जायना — स्टेप एक्सपोर्ट तुमकां AWS_REGION जाता. ताचे बदला स्थीर कळ वापरपाक, सांठोवन दवरप:
हीं भांडार गुपीत म्हणून सांठोवन दवरचीं
AWS_ACCESS_KEY_ID— तुमचो AWS ऍक्सेस की आयडी.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गूगल क्लाऊड ट्रान्सलेशन[बदल]
Set provider to google. सेवा-खातें JSON क्रेडेन्शियल वा API की वापरून प्रमाणीत करात — तंतोतंत एक पुरवण करात:
हीं भांडार गुपीत म्हणून सांठोवन दवरचीं
GCP_TRANSLATE_CREDENTIALS— एक सेवा-खातें JSON की (JSON स्ट्रिंग म्हणून).GCP_TRANSLATE_API_KEY— वा गूगल क्लाऊड एपीआय की.
पर्यायी 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: आउटपुटाची तपासणी करात
एकदां वर्कफ्लो सोंपतकच ही क्रिया तीन आउटपुटां उक्ताडार हाडटा जी तुमी पीआर वर्णनांत वायर करूंक शकतात: summary-title, summary-details आनी has-new-translations. तशेंच कामाच्या पानाचेर मार्कडावन सारांश बरयता core.summary.