ਲਕੜੀ ਦਰਸ਼ਕ: ਇਹ ਗਾਈਡ Microsoft ਦੇ ਅੰਦਰੂਨੀ ਉਪਭੋਗਤਾਵਾਂ ਜਾਂ ਉਹ ਟੀਮਾਂ ਜਿਨ੍ਹਾਂ ਕੋਲ ਪ੍ਰੀ-ਬਿਲਟ ਕੋ-ਆਪ ਟ੍ਰਾਂਸਲੇਟਰ GitHub ਐਪ ਲਈ ਲੋੜੀਂਦੇ ਪ੍ਰਮਾਣ ਪੱਤਰ ਹਨ ਜਾਂ ਜੋ ਆਪਣਾ ਕਸਟਮ GitHub ਐਪ ਬਣਾਉ ਸਕਦੀਆਂ ਹਨ ਲਈ ਬਣਾਈ ਗਈ ਹੈ।
ਆਪਣੇ ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਦਾ ਅਨੁਵਾਦ ਆਸਾਨੀ ਨਾਲ ਕੋ-ਆਪ ਟ੍ਰਾਂਸਲੇਟਰ GitHub ਐਕਸ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਟੋਮੇਟ ਕਰੋ। ਇਹ ਗਾਈਡ ਤੁਹਾਨੂੰ ਇਹ ਦਿਖਾਉਂਦੀ ਹੈ ਕਿ ਕਿਵੇਂ ਐਕਸ਼ਨ ਨੂੰ ਸੈੱਟਅੱਪ ਕਰਨਾ ਹੈ ਤਾਂ ਜੋ ਜਦੋਂ ਵੀ ਤੁਹਾਡੇ ਸਰੋਤ Markdown ਫਾਈਲਾਂ ਜਾਂ ਤਸਵੀਰਾਂ ਵਿੱਚ ਬਦਲਾਅ ਹੋਵੇ, ਤਾਂ ਇਹ ਆਪਣੇ ਆਪ ਅਪਡੇਟ ਕੀਤੇ ਅਨੁਵਾਦਾਂ ਨਾਲ ਪુલ ਰਿਕਵੇਸਟ ਬਣਾਏ।
[!IMPORTANT]
ਸਹੀ ਗਾਈਡ ਚੁਣਨਾ:
ਇਹ ਗਾਈਡ GitHub ਐਪ ID ਅਤੇ ਪ੍ਰਾਈਵੇਟ ਕੀ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸੈੱਟਅੱਪ ਦੀ ਵਿਸਥਾਰ ਨਾਲ ਜਾਣਕਾਰੀ ਦਿੰਦੀ ਹੈ। ਤੁਸੀਂ ਆਮ ਤੌਰ ‘ਤੇ ਇਹ “ਸੰਸਥਾ ਗਾਈਡ” ਤਰੀਕਾ ਇਸ ਵਾਰਤੋਂ ਕਰਦੇ ਹੋ ਜੇ:
GITHUB_TOKEN
ਦੀਆਂ ਅਨੁਮਤੀਆਂ ਸੀਮਿਤ ਹਨ: ਤੁਹਾਡੀ ਸੰਸਥਾ ਜਾਂ ਰਿਪੋਜ਼ਟਰੀ ਸੈਟਿੰਗਜ਼ ਮੂਲGITHUB_TOKEN
ਨੂੰ ਦਿੱਤੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਡਿਫੌਲਟ ਅਨੁਮਤੀਆਂ ਨੂੰ ਰੋਕਦੀਆਂ ਹਨ। ਖਾਸ ਕਰਕੇ, ਜੇGITHUB_TOKEN
ਨੂੰ ਲੋੜੀਂਦੀਆਂwrite
ਅਨੁਮਤੀਆਂ (ਜਿਵੇਂcontents: write
ਜਾਂpull-requests: write
) ਨਹੀਂ ਮਿਲਦੀਆਂ, ਤਾਂ ਪਬਲਿਕ ਸੈੱਟਅੱਪ ਗਾਈਡ ਵਿੱਚ ਵਰਕਫਲੋ ਅਨੁਮਤੀਆਂ ਦੀ ਘਾਟ ਕਾਰਨ ਫੇਲ ਹੋ ਜਾਵੇਗਾ। ਇੱਕ ਸਮਰਪਿਤ GitHub ਐਪ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਜੋ ਖਾਸ ਤੌਰ ‘ਤੇ ਅਨੁਮਤੀਆਂ ਮਿਲੀਆਂ ਹਨ, ਇਹ ਸੀਮਾ ਪਾਰ ਕਰ ਲਈ ਜਾਂਦੀ ਹੈ।ਜੇ ਇਹ ਤੁਹਾਡੇ ਉੱਤੇ ਲਾਗੂ ਨਹੀਂ ਹੁੰਦਾ:
ਜੇ ਤੁਹਾਡੇ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ ਮੂਲ
GITHUB_TOKEN
ਕੋਲ ਕਾਫੀ ਅਨੁਮਤੀਆਂ ਹਨ (ਜਿਵੇਂ ਕਿ ਤੁਸੀਂ ਸੰਸਥਾ ਦੀਆਂ ਰੋਕਾਂ ਨਾਲ ਬੰਦ ਨਹੀਂ ਹੋ), ਤਾਂ ਕਿਰਪਾ ਕਰਕੇ GITHUB_TOKEN ਦੀ ਵਰਤੋਂ ਕਰਦਿਆਂ ਪਬਲਿਕ ਸੈੱਟਅੱਪ ਗਾਈਡ ਦੀ ਵਰਤੋਂ ਕਰੋ। ਪਬਲਿਕ ਗਾਈਡ ਨੂੰ ਐਪ ID ਜਾਂ ਪ੍ਰਾਈਵੇਟ ਕੀ ਪ੍ਰਾਪਤ ਕਰਨ ਜਾਂ ਪ੍ਰਬੰਧਨ ਕਰਨ ਦੀ ਲੋੜ ਨਹੀਂ ਹੁੰਦੀ ਅਤੇ ਇਹ ਸਿਰਫ ਮੂਲGITHUB_TOKEN
ਅਤੇ ਰਿਪੋਜ਼ਟਰੀ ਅਨੁਮਤੀਆਂ ‘ਤੇ ਨਿਰਭਰ ਕਰਦਾ ਹੈ।
GitHub ਐਕਸ਼ਨ ਨੂੰ ਸੈੱਟਅੱਪ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਤੁਹਾਡੇ ਕੋਲ ਲੋੜੀਂਦੇ AI ਸਰਵਿਸ ਪ੍ਰਮਾਣ ਪੱਤਰ ਤਿਆਰ ਹਨ।
1. ਲੋੜੀਂਦਾ: AI ਭਾਸ਼ਾ ਮਾਡਲ ਪ੍ਰਮਾਣ ਪੱਤਰ
ਤੁਹਾਨੂੰ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਸਪੋਰਟ ਕੀਤੇ ਭਾਸ਼ਾ ਮਾਡਲ ਲਈ ਪ੍ਰਮਾਣ ਪੱਤਰ ਦੀ ਲੋੜ ਹੈ:
2. ਵਿਕਲਪਿਕ: ਕੰਪਿਊਟਰ ਵਿਜ਼ਨ ਪ੍ਰਮਾਣ ਪੱਤਰ (ਤਸਵੀਰਾਂ ਦੇ ਅਨੁਵਾਦ ਲਈ)
ਆਪਣੇ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ ਕੋ-ਆਪ ਟ੍ਰਾਂਸਲੇਟਰ GitHub ਐਕਸ਼ਨ ਨੂੰ ਸੈੱਟਅੱਪ ਕਰਨ ਲਈ ਹੇਠਾਂ ਦਿੱਤੇ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ:
ਵਰਕਫਲੋ GitHub ਐਪ ਪ੍ਰਮਾਣਿਕਤਾ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ ਤਾਂ ਜੋ ਤੁਹਾਡੇ ਰਿਪੋਜ਼ਟਰੀ ਨਾਲ ਸੁਰੱਖਿਅਤ ਤਰੀਕੇ ਨਾਲ ਸੰਚਾਰ ਕੀਤਾ ਜਾ ਸਕੇ (ਜਿਵੇਂ ਕਿ ਪુલ ਰਿਕਵੇਸਟ ਬਣਾਉਣਾ) ਤੁਹਾਡੇ ਵੱਲੋਂ। ਇੱਕ ਵਿਕਲਪ ਚੁਣੋ:
Co-op Translator GitHub App ਪੇਜ ‘ਤੇ ਜਾਓ।
Install ਚੁਣੋ ਅਤੇ ਉਹ ਖਾਤਾ ਜਾਂ ਸੰਸਥਾ ਚੁਣੋ ਜਿੱਥੇ ਤੁਹਾਡਾ ਲਕੜੀ ਰਿਪੋਜ਼ਟਰੀ ਹੈ।
Only select repositories ਚੁਣੋ ਅਤੇ ਆਪਣਾ ਲਕੜੀ ਰਿਪੋਜ਼ਟਰੀ (ਜਿਵੇਂ ਕਿ PhiCookBook
) ਚੁਣੋ। ਫਿਰ Install ‘ਤੇ ਕਲਿੱਕ ਕਰੋ। ਤੁਹਾਨੂੰ ਪ੍ਰਮਾਣਿਕਤਾ ਲਈ ਪੁੱਛਿਆ ਜਾ ਸਕਦਾ ਹੈ।
1164076
।.pem
ਪ੍ਰਾਈਵੇਟ ਕੀ ਫਾਈਲ ਦਾ ਪੂਰਾ ਸਮੱਗਰੀ ਮੈੰਟੇਨਰ ਸੰਪਰਕ ਤੋਂ ਲੈਣਾ ਹੈ। ਇਸ ਕੀ ਨੂੰ ਪਾਸਵਰਡ ਵਾਂਗ ਸੰਭਾਲੋ ਅਤੇ ਸੁਰੱਖਿਅਤ ਰੱਖੋ।ਤੁਹਾਨੂੰ GitHub ਐਪ ਪ੍ਰਮਾਣ ਪੱਤਰ ਅਤੇ ਆਪਣੀ AI ਸਰਵਿਸ ਦੇ ਪ੍ਰਮਾਣ ਪੱਤਰ ਰਿਪੋਜ਼ਟਰੀ ਸੈਟਿੰਗਜ਼ ਵਿੱਚ ਇੰਕ੍ਰਿਪਟ ਕੀਤੇ ਸਿਕ੍ਰੇਟਸ ਵਜੋਂ ਜੋੜਣੇ ਹੋਣਗੇ।
ਆਪਣੀ ਲਕੜੀ GitHub ਰਿਪੋਜ਼ਟਰੀ (ਜਿਵੇਂ ਕਿ PhiCookBook
) ‘ਤੇ ਜਾਓ।
Settings > Secrets and variables > Actions ‘ਤੇ ਜਾਓ।
Repository secrets ਹੇਠਾਂ, ਹਰੇਕ ਹੇਠਾਂ ਦਿੱਤੇ ਸਿਕ੍ਰੇਟ ਲਈ New repository secret ‘ਤੇ ਕਲਿੱਕ ਕਰੋ।
ਲੋੜੀਂਦੇ ਸਿਕ੍ਰੇਟ (GitHub ਐਪ ਪ੍ਰਮਾਣਿਕਤਾ ਲਈ):
ਸਿਕ੍ਰੇਟ ਨਾਮ | ਵਰਣਨ | ਮੁੱਲ ਦਾ ਸਰੋਤ |
---|---|---|
GH_APP_ID |
GitHub ਐਪ ਦਾ ਐਪ ID (ਕਦਮ 1 ਤੋਂ) | GitHub ਐਪ ਸੈਟਿੰਗਜ਼ |
GH_APP_PRIVATE_KEY |
ਡਾਊਨਲੋਡ ਕੀਤੇ ਹੋਏ .pem ਫਾਈਲ ਦੀ ਪੂਰੀ ਸਮੱਗਰੀ |
.pem ਫਾਈਲ (ਕਦਮ 1 ਤੋਂ) |
AI ਸਰਵਿਸ ਸਿਕ੍ਰੇਟ (ਆਪਣੀ ਲੋੜ ਅਨੁਸਾਰ ਸਾਰੇ ਲਾਭਦੇ ਹੋਏ ਸ਼ਾਮਲ ਕਰੋ):
ਸਿਕ੍ਰੇਟ ਨਾਮ | ਵਰਣਨ | ਮੁੱਲ ਦਾ ਸਰੋਤ |
---|---|---|
AZURE_SUBSCRIPTION_KEY |
Azure AI ਸਰਵਿਸ (ਕੰਪਿਊਟਰ ਵਿਜ਼ਨ) ਲਈ ਕੁੰਜੀ | Azure AI Foundry |
AZURE_AI_SERVICE_ENDPOINT |
Azure AI ਸਰਵਿਸ (ਕੰਪਿਊਟਰ ਵਿਜ਼ਨ) ਲਈ Endpoint | Azure AI Foundry |
AZURE_OPENAI_API_KEY |
Azure OpenAI ਸਰਵਿਸ ਲਈ ਕੁੰਜੀ | Azure AI Foundry |
AZURE_OPENAI_ENDPOINT |
Azure OpenAI ਸਰਵਿਸ ਲਈ Endpoint | Azure AI Foundry |
AZURE_OPENAI_MODEL_NAME |
ਤੁਹਾਡਾ Azure OpenAI ਮਾਡਲ ਨਾਮ | Azure AI Foundry |
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME |
ਤੁਹਾਡਾ Azure OpenAI ਡਿਪਲੋਇਮੈਂਟ ਨਾਮ | Azure AI Foundry |
AZURE_OPENAI_API_VERSION |
Azure OpenAI ਲਈ API ਵਰਜਨ | Azure AI Foundry |
OPENAI_API_KEY |
OpenAI ਲਈ API ਕੁੰਜੀ | OpenAI Platform |
OPENAI_ORG_ID |
OpenAI ਸੰਸਥਾ ID | OpenAI Platform |
OPENAI_CHAT_MODEL_ID |
ਖਾਸ OpenAI ਮਾਡਲ ID | OpenAI Platform |
OPENAI_BASE_URL |
ਕਸਟਮ OpenAI API ਬੇਸ URL | OpenAI Platform |
ਅਖੀਰਕਾਰ, ਉਹ YAML ਫਾਈਲ ਬਣਾਓ ਜੋ ਆਟੋਮੇਟਿਕ ਵਰਕਫਲੋ ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੀ ਹੈ।
ਆਪਣੀ ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ, ਜੇ ਮੌਜੂਦ ਨਾ ਹੋਵੇ ਤਾਂ .github/workflows/
ਡਾਇਰੈਕਟਰੀ ਬਣਾਓ।
.github/workflows/
ਦੇ ਅੰਦਰ, ਇੱਕ ਫਾਈਲ ਬਣਾਓ ਜਿਸਦਾ ਨਾਮ co-op-translator.yml
ਰੱਖੋ।
ਹੇਠਾਂ ਦਿੱਤੀ ਸਮੱਗਰੀ co-op-translator.yml ਵਿੱਚ ਪੇਸਟ ਕਰੋ।
name: Co-op Translator
on:
push:
branches:
- main
jobs:
co-op-translator:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.10'
- name: Install Co-op Translator
run: |
python -m pip install --upgrade pip
pip install co-op-translator
- name: Run Co-op Translator
env:
PYTHONIOENCODING: utf-8
# Azure AI Service Credentials
AZURE_SUBSCRIPTION_KEY: $
AZURE_AI_SERVICE_ENDPOINT: $
# Azure OpenAI Credentials
AZURE_OPENAI_API_KEY: $
AZURE_OPENAI_ENDPOINT: $
AZURE_OPENAI_MODEL_NAME: $
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME: $
AZURE_OPENAI_API_VERSION: $
# OpenAI Credentials
OPENAI_API_KEY: $
OPENAI_ORG_ID: $
OPENAI_CHAT_MODEL_ID: $
OPENAI_BASE_URL: $
run: |
# =====================================================================
# IMPORTANT: Set your target languages here (REQUIRED CONFIGURATION)
# =====================================================================
# Example: Translate to Spanish, French, German. Add -y to auto-confirm.
translate -l "es fr de" -y # <--- MODIFY THIS LINE with your desired languages
- name: Authenticate GitHub App
id: generate_token
uses: tibdex/github-app-token@v1
with:
app_id: $
private_key: $
- name: Create Pull Request with translations
uses: peter-evans/create-pull-request@v5
with:
token: $
commit-message: "🌐 Update translations via Co-op Translator"
title: "🌐 Update translations via Co-op Translator"
body: |
This PR updates translations for recent changes to the main branch.
### 📋 Changes included
- Translated contents are available in the `translations/` directory
- Translated images are available in the `translated_images/` directory
---
🌐 Automatically generated by the [Co-op Translator](https://github.com/Azure/co-op-translator) GitHub Action.
branch: update-translations
base: main
labels: translation, automated-pr
delete-branch: true
add-paths: |
translations/
translated_images/
Run Co-op Translator
step, you MUST review and modify the list of language codes within the translate -l "..." -y
command to match your project’s requirements. The example list (ar de es...
) needs to be replaced or adjusted.on:
): The current trigger runs on every push to main
. For large repositories, consider adding a paths:
filter (see commented example in the YAML) to run the workflow only when relevant files (e.g., source documentation) change, saving runner minutes.commit-message
, title
, body
, branch
name, and labels
in the Create Pull Request
step if needed.AZURE_OPENAI_...
ਕੁੰਜੀਆਂ ਵਿੱਚ ਸਮੇਂ ਤੋਂ ਪਹਿਲਾਂ ਟਾਰਗੇਟ ਭਾਸ਼ਾਵਾਂ ਸ਼ਾਮਲ ਕਰੋ ਤਾਂ ਜੋ ਵਰਕਫਲੋ ਫੇਲ ਨਾ ਹੋਵੇ।ਜਦੋਂ co-op-translator.yml
ਫਾਈਲ ਤੁਹਾਡੇ ਮੇਨ ਬ੍ਰਾਂਚ (ਜਾਂ on:
trigger), the workflow will automatically run whenever changes are pushed to that branch (and match the paths
ਫਿਲਟਰ ਵਿੱਚ ਦਿੱਤੀ ਬ੍ਰਾਂਚ) ਵਿੱਚ ਮਰਜ ਹੋ ਜਾਵੇਗੀ।
ਜੇ ਅਨੁਵਾਦ ਬਣਾਏ ਜਾਂ ਅਪਡੇਟ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਤਾਂ ਐਕਸ਼ਨ ਆਪਣੇ ਆਪ ਇੱਕ ਪુલ ਰਿਕਵੇਸਟ ਬਣਾਏਗਾ ਜਿਸ ਵਿੱਚ ਇਹ ਤਬਦੀਲੀਆਂ ਹੋਣਗੀਆਂ, ਜੋ ਤੁਹਾਡੇ ਸਮੀਖਿਆ ਅਤੇ ਮਰਜ ਕਰਨ ਲਈ ਤਿਆਰ ਹੋਵੇਗੀ।
ਅਸਵੀਕਾਰੋਪਣ:
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ Co-op Translator ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਅਤ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਹੀਤਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੇ ਉਪਯੋਗ ਤੋਂ ਉਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀਆਂ ਜਾਂ ਭ੍ਰਮਾਂ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।