You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
359 lines
20 KiB
359 lines
20 KiB
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
|
|
"translation_date": "2025-10-03T11:23:33+00:00",
|
|
"source_file": "AGENTS.md",
|
|
"language_code": "pa"
|
|
}
|
|
-->
|
|
# AGENTS.md
|
|
|
|
## ਪ੍ਰੋਜੈਕਟ ਝਲਕ
|
|
|
|
ਇਹ ਸ਼ੁਰੂਆਤੀ ਸਿਖਿਆਰਥੀਆਂ ਨੂੰ ਵੈੱਬ ਡਿਵੈਲਪਮੈਂਟ ਦੇ ਮੂਲ ਸਿਧਾਂਤ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਿਆਕਰਮ ਰਿਪੋਜ਼ਟਰੀ ਹੈ। ਸਿੱਖਿਆਕਰਮ ਮਾਈਕਰੋਸਾਫਟ ਕਲਾਉਡ ਐਡਵੋਕੇਟਸ ਦੁਆਰਾ ਵਿਕਸਿਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਵਿਸਤ੍ਰਿਤ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS ਅਤੇ HTML ਦੇ 24 ਹੱਥ-ਅਨੁਭਵ ਪਾਠ ਸ਼ਾਮਲ ਹਨ।
|
|
|
|
### ਮੁੱਖ ਹਿੱਸੇ
|
|
|
|
- **ਸਿੱਖਿਆਕ ਸਮੱਗਰੀ**: ਪ੍ਰੋਜੈਕਟ-ਅਧਾਰਿਤ ਮੋਡੀਊਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ 24 ਪਾਠ
|
|
- **ਵਿਹਾਰਕ ਪ੍ਰੋਜੈਕਟ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, ਅਤੇ AI Chat Assistant
|
|
- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਪ੍ਰਸ਼ਨ (ਪਾਠ ਤੋਂ ਪਹਿਲਾਂ/ਬਾਅਦ ਦੇ ਮੁਲਾਂਕਣ)
|
|
- **ਬਹੁ-ਭਾਸ਼ਾ ਸਹਾਇਤਾ**: GitHub Actions ਰਾਹੀਂ 50+ ਭਾਸ਼ਾਵਾਂ ਲਈ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ
|
|
- **ਤਕਨਾਲੋਜੀਆਂ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)
|
|
|
|
### ਆਰਚਿਟੈਕਚਰ
|
|
|
|
- ਪਾਠ-ਅਧਾਰਿਤ ਢਾਂਚੇ ਵਾਲਾ ਸਿੱਖਿਆਕ ਰਿਪੋਜ਼ਟਰੀ
|
|
- ਹਰ ਪਾਠ ਫੋਲਡਰ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਨਾਂ ਅਤੇ ਹੱਲ ਸ਼ਾਮਲ ਹਨ
|
|
- ਵੱਖਰੇ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਸਵਤੰਤਰ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਵੱਖ-ਵੱਖ ਪਾਠ ਪ੍ਰੋਜੈਕਟ)
|
|
- GitHub Actions (co-op-translator) ਰਾਹੀਂ ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ
|
|
- Docsify ਰਾਹੀਂ ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਅਤੇ PDF ਦੇ ਰੂਪ ਵਿੱਚ ਉਪਲਬਧ
|
|
|
|
## ਸੈਟਅਪ ਕਮਾਂਡ
|
|
|
|
ਇਹ ਰਿਪੋਜ਼ਟਰੀ ਮੁੱਖ ਤੌਰ 'ਤੇ ਸਿੱਖਿਆਕ ਸਮੱਗਰੀ ਦੀ ਖਪਤ ਲਈ ਹੈ। ਖਾਸ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ:
|
|
|
|
### ਮੁੱਖ ਰਿਪੋਜ਼ਟਰੀ ਸੈਟਅਪ
|
|
|
|
```bash
|
|
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
|
|
cd Web-Dev-For-Beginners
|
|
```
|
|
|
|
### Quiz App ਸੈਟਅਪ (Vue 3 + Vite)
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm install
|
|
npm run dev # Start development server
|
|
npm run build # Build for production
|
|
npm run lint # Run ESLint
|
|
```
|
|
|
|
### Bank Project API (Node.js + Express)
|
|
|
|
```bash
|
|
cd 7-bank-project/api
|
|
npm install
|
|
npm start # Start API server
|
|
npm run lint # Run ESLint
|
|
npm run format # Format with Prettier
|
|
```
|
|
|
|
### Browser Extension ਪ੍ਰੋਜੈਕਟ
|
|
|
|
```bash
|
|
cd 5-browser-extension/solution
|
|
npm install
|
|
# Follow browser-specific extension loading instructions
|
|
```
|
|
|
|
### Space Game ਪ੍ਰੋਜੈਕਟ
|
|
|
|
```bash
|
|
cd 6-space-game/solution
|
|
npm install
|
|
# Open index.html in browser or use Live Server
|
|
```
|
|
|
|
### Chat Project (Python Backend)
|
|
|
|
```bash
|
|
cd 9-chat-project/solution/backend/python
|
|
pip install openai
|
|
# Set GITHUB_TOKEN environment variable
|
|
python api.py
|
|
```
|
|
|
|
## ਵਿਕਾਸ ਵਰਕਫਲੋ
|
|
|
|
### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਰਤਾ ਲਈ
|
|
|
|
1. **ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ** ਆਪਣੇ GitHub ਖਾਤੇ ਵਿੱਚ
|
|
2. **ਆਪਣੇ ਫੋਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ** ਸਥਾਨਕ ਤੌਰ 'ਤੇ
|
|
3. **ਆਪਣੇ ਬਦਲਾਅ ਲਈ ਨਵੀਂ ਸ਼ਾਖਾ ਬਣਾਓ**
|
|
4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਨਾਂ ਵਿੱਚ ਬਦਲਾਅ ਕਰੋ
|
|
5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਕੋਈ ਵੀ ਕੋਡ ਬਦਲਾਅ ਟੈਸਟ ਕਰੋ
|
|
6. ਯੋਗਦਾਨ ਦੇ ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹੋਏ ਪੂਲ ਰਿਕਵੇਸਟ ਜਮ੍ਹਾਂ ਕਰੋ
|
|
|
|
### ਸਿਖਿਆਰਥੀਆਂ ਲਈ
|
|
|
|
1. ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
|
|
2. ਪਾਠ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਲਗਾਤਾਰ ਜਾਓ
|
|
3. ਹਰ ਪਾਠ ਲਈ README ਫਾਈਲਾਂ ਪੜ੍ਹੋ
|
|
4. https://ff-quizzes.netlify.app/web/ 'ਤੇ ਪਾਠ ਤੋਂ ਪਹਿਲਾਂ ਦੇ ਕਵਿਜ਼ ਪੂਰੇ ਕਰੋ
|
|
5. ਪਾਠ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਨਾਂ 'ਤੇ ਕੰਮ ਕਰੋ
|
|
6. ਅਸਾਈਨਮੈਂਟ ਅਤੇ ਚੁਣੌਤੀਆਂ ਪੂਰੀਆਂ ਕਰੋ
|
|
7. ਪਾਠ ਤੋਂ ਬਾਅਦ ਦੇ ਕਵਿਜ਼ ਲਵੋ
|
|
|
|
### ਲਾਈਵ ਵਿਕਾਸ
|
|
|
|
- **ਦਸਤਾਵੇਜ਼**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (port 3000)
|
|
- **Quiz App**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
|
|
- **ਪ੍ਰੋਜੈਕਟ**: HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋ
|
|
- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm start` ਚਲਾਓ
|
|
|
|
## ਟੈਸਟਿੰਗ ਨਿਰਦੇਸ਼
|
|
|
|
### Quiz App ਟੈਸਟਿੰਗ
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm run lint # Check for code style issues
|
|
npm run build # Verify build succeeds
|
|
```
|
|
|
|
### Bank API ਟੈਸਟਿੰਗ
|
|
|
|
```bash
|
|
cd 7-bank-project/api
|
|
npm run lint # Check for code style issues
|
|
node server.js # Verify server starts without errors
|
|
```
|
|
|
|
### ਜਨਰਲ ਟੈਸਟਿੰਗ ਪਹੁੰਚ
|
|
|
|
- ਇਹ ਇੱਕ ਸਿੱਖਿਆਕ ਰਿਪੋਜ਼ਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਵਿਸਤ੍ਰਿਤ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ
|
|
- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ 'ਤੇ ਧਿਆਨ:
|
|
- ਕੋਡ ਉਦਾਹਰਨਾਂ ਬਿਨਾਂ ਗਲਤੀਆਂ ਦੇ ਚੱਲਣ
|
|
- ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ
|
|
- ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲਤਾਪੂਰਵਕ ਪੂਰੇ ਹੁੰਦੇ ਹਨ
|
|
- ਉਦਾਹਰਨਾਂ ਸਿੱਖਿਆਕ ਸਿੱਧਾਂਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹਨ
|
|
|
|
### ਪੂਰਨ-ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਚੈੱਕ
|
|
|
|
- `npm run lint` ਚਲਾਓ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਜਿੱਥੇ package.json ਹੈ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਵੈਧ ਹਨ
|
|
- ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਨਾਂ ਟੈਸਟ ਕਰੋ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਨੁਵਾਦ ਸਹੀ ਢਾਂਚਾ ਰੱਖਦੇ ਹਨ
|
|
|
|
## ਕੋਡ ਸਟਾਈਲ ਨਿਯਮ
|
|
|
|
### ਜਾਵਾਸਕ੍ਰਿਪਟ
|
|
|
|
- ਆਧੁਨਿਕ ES6+ ਸਿੰਟੈਕਸ ਵਰਤੋ
|
|
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ਮਿਆਰੀ ESLint ਸੰਰਚਨਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
|
|
- ਸਿੱਖਿਆਕ ਸਪਸ਼ਟਤਾ ਲਈ ਅਰਥਪੂਰਨ ਵੈਰੀਏਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋ
|
|
- ਸਿੱਖਿਆਰਥੀਆਂ ਲਈ ਸੰਕਲਪਾਂ ਦੀ ਵਿਆਖਿਆ ਕਰਨ ਵਾਲੇ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਲ ਕਰੋ
|
|
- ਜਿੱਥੇ ਸੰਰਚਿਤ ਹੈ, Prettier ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
|
|
|
|
### HTML/CSS
|
|
|
|
- ਸੈਮੈਂਟਿਕ HTML5 ਤੱਤ
|
|
- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਈਨ ਸਿਧਾਂਤ
|
|
- ਸਪਸ਼ਟ ਕਲਾਸ ਨਾਮਕਰਨ ਸੰਕਲਪ
|
|
- ਸਿੱਖਿਆਰਥੀਆਂ ਲਈ CSS ਤਕਨੀਕਾਂ ਦੀ ਵਿਆਖਿਆ ਕਰਨ ਵਾਲੀਆਂ ਟਿੱਪਣੀਆਂ
|
|
|
|
### Python
|
|
|
|
- PEP 8 ਸਟਾਈਲ ਨਿਯਮ
|
|
- ਸਪਸ਼ਟ, ਸਿੱਖਿਆਕ ਕੋਡ ਉਦਾਹਰਨਾਂ
|
|
- ਸਿੱਖਣ ਲਈ ਜਿੱਥੇ ਲਾਭਦਾਇਕ ਹੋਵੇ, ਟਾਈਪ ਹਿੰਟ ਸ਼ਾਮਲ ਕਰੋ
|
|
|
|
### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼
|
|
|
|
- ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ
|
|
- ਭਾਸ਼ਾ ਨਿਰਧਾਰਨ ਨਾਲ ਕੋਡ ਬਲਾਕ
|
|
- ਵਾਧੂ ਸਰੋਤਾਂ ਲਈ ਲਿੰਕ
|
|
- `images/` ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ
|
|
- ਪਹੁੰਚਯੋਗਤਾ ਲਈ ਚਿੱਤਰਾਂ ਲਈ Alt ਟੈਕਸਟ
|
|
|
|
### ਫਾਈਲ ਸੰਗਠਨ
|
|
|
|
- ਪਾਠ ਲਗਾਤਾਰ ਗਿਣਤੀ ਵਿੱਚ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
|
|
- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਜ਼ ਹੁੰਦੀਆਂ ਹਨ
|
|
- ਪਾਠ-ਵਿਸ਼ੇਸ਼ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ ਕੀਤੇ ਜਾਂਦੇ ਹਨ
|
|
- ਅਨੁਵਾਦ `translations/{language-code}/` ਢਾਂਚੇ ਵਿੱਚ
|
|
|
|
## ਬਿਲਡ ਅਤੇ ਡਿਪਲੌਇਮੈਂਟ
|
|
|
|
### Quiz App ਡਿਪਲੌਇਮੈਂਟ (Azure Static Web Apps)
|
|
|
|
Quiz-app Azure Static Web Apps ਡਿਪਲੌਇਮੈਂਟ ਲਈ ਸੰਰਚਿਤ ਹੈ:
|
|
|
|
```bash
|
|
cd quiz-app
|
|
npm run build # Creates dist/ folder
|
|
# Deploys via GitHub Actions workflow on push to main
|
|
```
|
|
|
|
Azure Static Web Apps ਸੰਰਚਨਾ:
|
|
- **ਐਪ ਸਥਾਨ**: `/quiz-app`
|
|
- **ਆਉਟਪੁੱਟ ਸਥਾਨ**: `dist`
|
|
- **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
|
|
|
|
### ਦਸਤਾਵੇਜ਼ PDF ਜਨਰੇਸ਼ਨ
|
|
|
|
```bash
|
|
npm install # Install docsify-to-pdf
|
|
npm run convert # Generate PDF from docs
|
|
```
|
|
|
|
### Docsify ਦਸਤਾਵੇਜ਼
|
|
|
|
```bash
|
|
npm install -g docsify-cli # Install Docsify globally
|
|
docsify serve # Serve on localhost:3000
|
|
```
|
|
|
|
### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ
|
|
|
|
ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ:
|
|
- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ
|
|
- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਕਦਮ ਨਹੀਂ, ਫਾਈਲਾਂ ਨੂੰ ਸਿੱਧੇ ਸੇਵਾ ਕਰੋ
|
|
|
|
## ਪੂਲ ਰਿਕਵੇਸਟ ਨਿਯਮ
|
|
|
|
### ਸਿਰਲੇਖ ਫਾਰਮੈਟ
|
|
|
|
ਬਦਲਾਅ ਦੇ ਖੇਤਰ ਨੂੰ ਦਰਸਾਉਣ ਵਾਲੇ ਸਪਸ਼ਟ, ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਵਰਤੋ:
|
|
- `[Quiz-app] Add new quiz for lesson X`
|
|
- `[Lesson-3] Fix typo in terrarium project`
|
|
- `[Translation] Add Spanish translation for lesson 5`
|
|
- `[Docs] Update setup instructions`
|
|
|
|
### ਲੋੜੀਂਦੇ ਚੈੱਕ
|
|
|
|
ਪੂਲ ਰਿਕਵੇਸਟ ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ:
|
|
|
|
1. **ਕੋਡ ਗੁਣਵੱਤਾ**:
|
|
- ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ
|
|
- ਸਾਰੇ ਲਿੰਟਿੰਗ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀਆਂ ਨੂੰ ਠੀਕ ਕਰੋ
|
|
|
|
2. **ਬਿਲਡ ਪ੍ਰਮਾਣਿਕਤਾ**:
|
|
- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ `npm run build` ਚਲਾਓ
|
|
- ਕੋਈ ਬਿਲਡ ਗਲਤੀਆਂ ਨਾ ਹੋਣ
|
|
|
|
3. **ਲਿੰਕ ਵੈਧਤਾ**:
|
|
- ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਚਿੱਤਰ ਸੰਦਰਭ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ
|
|
|
|
4. **ਸਮੱਗਰੀ ਸਮੀਖਾ**:
|
|
- ਹਜਾਰਾਂ ਅਤੇ ਵਿਆਕਰਨ ਲਈ ਪ੍ਰੂਫਰੀਡ ਕਰੋ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਕੋਡ ਉਦਾਹਰਨਾਂ ਸਹੀ ਅਤੇ ਸਿੱਖਿਆਕ ਹਨ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਨੁਵਾਦ ਮੂਲ ਅਰਥ ਨੂੰ ਰੱਖਦੇ ਹਨ
|
|
|
|
### ਯੋਗਦਾਨ ਦੀਆਂ ਲੋੜਾਂ
|
|
|
|
- ਮਾਈਕਰੋਸਾਫਟ CLA ਨਾਲ ਸਹਿਮਤ ਹੋਵੋ (ਪਹਿਲੀ ਪੂਲ ਰਿਕਵੇਸਟ 'ਤੇ ਆਟੋਮੈਟਿਕ ਚੈੱਕ)
|
|
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
|
|
- ਵਿਸਤ੍ਰਿਤ ਨਿਯਮਾਂ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ
|
|
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ ਪੂਲ ਰਿਕਵੇਸਟ ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਨੰਬਰਾਂ ਦਾ ਹਵਾਲਾ ਦਿਓ
|
|
|
|
### ਸਮੀਖਾ ਪ੍ਰਕਿਰਿਆ
|
|
|
|
- ਪੂਲ ਰਿਕਵੇਸਟ ਮੈਨਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਦੁਆਰਾ ਸਮੀਖਾ ਕੀਤੇ ਜਾਂਦੇ ਹਨ
|
|
- ਸਿੱਖਿਆਕ ਸਪਸ਼ਟਤਾ ਨੂੰ ਤਰਜੀਹ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ
|
|
- ਕੋਡ ਉਦਾਹਰਨਾਂ ਮੌਜੂਦਾ ਸਿੱਧਾਂਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ
|
|
- ਅਨੁਵਾਦ ਸਹੀ ਅਤੇ ਸੱਭਿਆਚਾਰਕ ਤੌਰ 'ਤੇ ਉਚਿਤ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ
|
|
|
|
## ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ
|
|
|
|
### ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ
|
|
|
|
- GitHub Actions ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ
|
|
- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
|
|
- ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਸਰੋਤ ਫਾਈਲਾਂ
|
|
- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਈਲਾਂ `translations/{language-code}/` ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ
|
|
|
|
### ਮੈਨੂਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਸ਼ਾਮਲ ਕਰਨਾ
|
|
|
|
1. ਫਾਈਲ ਨੂੰ `translations/{language-code}/` ਵਿੱਚ ਲੱਭੋ
|
|
2. ਢਾਂਚਾ ਰੱਖਦੇ ਹੋਏ ਸੁਧਾਰ ਕਰੋ
|
|
3. ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਕੋਡ ਉਦਾਹਰਨਾਂ ਕਾਰਗਰ ਰਹਿੰਦੇ ਹਨ
|
|
4. ਕੋਈ ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਟੈਸਟ ਕਰੋ
|
|
|
|
### ਅਨੁਵਾਦ ਮੈਟਾਡੇਟਾ
|
|
|
|
ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਈਲਾਂ ਵਿੱਚ ਮੈਟਾਡੇਟਾ ਹੈਡਰ ਸ਼ਾਮਲ ਹੈ:
|
|
```markdown
|
|
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "...",
|
|
"translation_date": "...",
|
|
"source_file": "...",
|
|
"language_code": "..."
|
|
}
|
|
-->
|
|
```
|
|
|
|
## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆ ਹੱਲ
|
|
|
|
### ਆਮ ਸਮੱਸਿਆਵਾਂ
|
|
|
|
**Quiz app ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦੀ**:
|
|
- Node.js ਵਰਜਨ ਚੈੱਕ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀ)
|
|
- `node_modules` ਅਤੇ `package-lock.json` ਮਿਟਾਓ, ਮੁੜ `npm install` ਚਲਾਓ
|
|
- ਪੋਰਟ ਸੰਘਰਸ਼ਾਂ ਦੀ ਜਾਂਚ ਕਰੋ (ਡਿਫਾਲਟ: Vite ਪੋਰਟ 5173 ਵਰਤਦਾ ਹੈ)
|
|
|
|
**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ Node.js ਵਰਜਨ ਘੱਟੋ-ਘੱਟ ਲੋੜਾਂ ਨੂੰ ਪੂਰਾ ਕਰਦਾ ਹੈ (node >=10)
|
|
- ਚੈੱਕ ਕਰੋ ਕਿ ਪੋਰਟ ਪਹਿਲਾਂ ਹੀ ਵਰਤ ਵਿੱਚ ਹੈ
|
|
- `npm install` ਨਾਲ ਸਾਰੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਇੰਸਟਾਲ ਕੀਤੇ ਹਨ
|
|
|
|
**Browser extension ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**:
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ manifest.json ਸਹੀ ਤਰੀਕੇ ਨਾਲ ਫਾਰਮੈਟ ਕੀਤਾ ਗਿਆ ਹੈ
|
|
- ਬ੍ਰਾਊਜ਼ਰ ਕਨਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੀ ਜਾਂਚ ਕਰੋ
|
|
- ਬ੍ਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
|
|
|
|
**Python chat project ਸਮੱਸਿਆਵਾਂ**:
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਹੈ: `pip install openai`
|
|
- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਸੈਟ ਕਰੋ
|
|
- GitHub Models ਪਹੁੰਚ ਅਧਿਕਾਰਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
|
|
|
|
**Docsify ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਨਹੀਂ ਕਰ ਰਿਹਾ**:
|
|
- Docsify-cli ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
|
|
- ਰਿਪੋਜ਼ਟਰੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਚਲਾਓ
|
|
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ
|
|
|
|
### ਵਿਕਾਸ ਵਾਤਾਵਰਣ ਟਿੱਪਸ
|
|
|
|
- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਨਾਲ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋ
|
|
- ਸਥਿਰ ਫਾਰਮੈਟਿੰਗ ਲਈ ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
|
|
- ਜਾਵਾਸਕ੍ਰਿਪਟ ਡੀਬੱਗ ਕਰਨ ਲਈ ਬ੍ਰਾਊਜ਼ਰ DevTools ਵਰਤੋ
|
|
- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ, Vue DevTools ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
|
|
|
|
### ਪ੍ਰਦਰਸ਼ਨ ਵਿਚਾਰ
|
|
|
|
- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਈਲਾਂ ਦੀ ਵੱਡੀ ਗਿਣਤੀ (50+ ਭਾਸ਼ਾਵਾਂ) ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਪੂਰੀ ਕਲੋਨ ਵੱਡੀ ਹੈ
|
|
- ਜੇ ਸਿਰਫ਼ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ ਤਾਂ ਸ਼ੈਲੋ ਕਲੋਨ ਵਰਤੋ: `git clone --depth 1`
|
|
- ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜਾਂ ਤੋਂ ਬਾਹਰ ਰੱਖੋ ਜਦੋਂ ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ
|
|
- ਪਹਿਲੀ ਵਾਰ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੌਲੀ ਹੋ ਸਕਦੀ ਹੈ (npm install, Vite build)
|
|
|
|
## ਸੁਰੱਖਿਆ ਵਿਚਾਰ
|
|
|
|
### ਵਾਤਾਵਰਣ ਚਰ
|
|
|
|
- API ਕੁੰਜੀਆਂ ਕਦੇ ਵੀ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ ਕਮਿਟ ਨਹੀਂ ਕੀਤੀਆਂ ਜਾਣੀਆਂ ਚਾਹੀਦੀਆਂ
|
|
- `.env` ਫਾਈਲਾਂ ਵਰਤੋ (ਪਹਿਲਾਂ ਹੀ `.gitignore` ਵਿੱਚ)
|
|
- ਪ੍ਰੋਜੈਕਟ README ਵਿੱਚ ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਚਰ ਦਸਤਾਵੇਜ਼ ਕਰੋ
|
|
|
|
### Python ਪ੍ਰੋਜੈਕਟ
|
|
|
|
- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋ:
|
|
|
|
---
|
|
|
|
**ਅਸਵੀਕਰਤਾ**:
|
|
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਹਾਲਾਂਕਿ ਅਸੀਂ ਸਹੀ ਹੋਣ ਦਾ ਯਤਨ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਦਿਓ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੁਚੀਤਤਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਮੌਜੂਦ ਦਸਤਾਵੇਜ਼ ਨੂੰ ਅਧਿਕਾਰਤ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਪੈਦਾ ਹੋਣ ਵਾਲੇ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆ ਲਈ ਅਸੀਂ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ। |