msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes)

Browse Source
pull/1793/head
localizeflow[bot] 1 month ago
parent 74e656e6fb
commit 56eac86043
6 changed files with 526 additions and 526 deletions
Show Stats Download Patch File Download Diff File

2
translations/pa/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:38:39+00:00",
"translation_date": "2026-04-20T15:48:43+00:00",
"source_file": "AGENTS.md",
"language_code": "pa"
},

424
translations/pa/AGENTS.md
Unescape View File

@ -1,37 +1,37 @@
# AGENTS.md
## ਪ੍ਰੋਜੈਕਟ ਝਲਕ
## ਪ੍ਰੋਜੈਕਟ ਓਵਰਵਿਊ
ਇਹ ਸ਼ੁਰੂਆਤੀ ਸਤਰਾ ਲਈ ਵੈੱਬ ਵਿਕਾਸ ਮੂਲਭੂਤਾਂ ਸਿਖਾਉਣ ਲਈ ਸਿੱਖਿਆ ਕੋਰਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਕੋਰਸ 12 ਹਫ਼ਤੇ ਦਾ ਵਿਸਥਾਰਿਕ ਕੋਰਸ ਹੈ ਜੋ Microsoft Cloud Advocates ਵੱਲੋਂ ਤਿਆਰ ਕੀਤਾ ਗਿਆ ਹੈ, ਜਿਸ ਵਿੱਚ 24 ਪ੍ਰਯੋਗਕਾਰੀ ਪਾਠ ਹਨ ਜੋ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS ਅਤੇ HTML ਨੂੰ ਕਵਰ ਕਰਦੇ ਹਨ।
ਇਹ शुरुआਤੀ ਵੈੱਬ ਵਿੱਕਾਸ਼ ਮੂਲਾਂਕਣ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਣਯੋਗ ਸਿਲੇਬਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਸਿਲੇਬਸ ਮਾਈਕ੍ਰੋਸਾਫਟ ਕਲਾਉਡ ਅਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸੀਤ ਇੱਕ ਸਮੱਗਰੀਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ JavaScript, 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, ਜਾਵਾਸਕ੍ਰਿਪਟ, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)
- **ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ**: ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਮੋਡਿਊਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ 24 ਪਾਠ
- **ਪ੍ਰਯੋਗਸ਼ੀਲ ਪ੍ਰੋਜੈਕਟ**: ਟੈਰੀਆਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ AI ਚੈਟ ਅਸਿਸਟੈਂਟ
- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 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 ਰੂਪ ਵਿੱਚ ਉਪਲਬਧ
- ਪਾਠ ਅਧਾਰਿਤ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ
- ਹਰ ਪਾਠ ਫੋਲਡਰ 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)
### ਕਵਿਜ਼ ਐਪ ਸੈਟਅਪ (Vue 3 + Vite)
```bash
cd quiz-app
@ -41,242 +41,242 @@ npm run build # ਉਤਪਾਦਨ ਲਈ ਬਿਲਡ ਕਰੋ
npm run lint # ESLint ਚਲਾਓ
```
### Bank ਪ੍ਰੋਜੈਕਟ API (Node.js + Express)
### ਬੈਂਕ ਪ੍ਰੋਜੈਕਟ API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # ਏਪੀਆਈ ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
npm run lint # ESLint ਚਲਾਓ
npm run format # Prettier ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
npm run format # ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੇਟ ਕਰੋ
```
### Browser Extension ਪ੍ਰੋਜੈਕਟ
### ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਪ੍ਰੋਜੈਕਟ
```bash
cd 5-browser-extension/solution
npm install
# ਬ੍ਰਾਊਜ਼ਰ-ਖਾਸ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡਿੰਗ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
# ਬਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦਾ ਪਾਲਣ ਕਰੋ
```
### Space Game ਪ੍ਰੋਜੈਕਟ
### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ
```bash
cd 6-space-game/solution
npm install
# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋ
# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋਂ
```
### Chat ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਐਂਡ)
### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਏਂਡ)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਸੈੱਟ ਕਰੋ
# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਲ ਬਦਲੋ ਸੈਟ ਕਰੋ
python api.py
```
## ਵਿਕਾਸ ਦਾ ਕੰਮ ਕਰਨ ਦਾ ਤਰੀਕਾ
## ਵਿਕਾਸ ਵਰਕਫਲੋ
### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਰਤਾਵਾਂ ਲਈ
### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਾਰਾਂ ਲਈ
1. ਆਪਣੇ GitHub ਖਾਤੇ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ
2. ਆਪਣੇ ਫੋਰਕ ਨੂੰ ਸਥਾਨਕ ਕਲੋਨ ਕਰੋ
3. ਆਪਣੀਆਂ ਬਦਲਾਵਾਂ ਲਈ ਨਵਾਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਵ ਕਰੋ
5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਕੋਡ ਨੂੰ ਟੈਸਟ ਕਰੋ
6. ਯੋਗਦਾਨ ਸਬੰਧੀ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ਾਂ ਅਨੁਸਾਰ ਪੁਲ ਰਿਕਵੈਸਟ ਭੇਜੋ
1. ਆਪਣਾ GitHub ਖਾਤਾ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਕਰੋ
2. ਲੋ컬ੀ ਆਪਣੇ ਫੌਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ
3. ਆਪਣੇ ਬਦਲਾਅ ਲਈ ਨਵੀਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਅ ਕਰੋ
5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਅ ਦੀ ਜਾਂਚ ਕਰੋ
6. ਯੋਗਦਾਨ ਦਿਓ ਧਿਆਨ ਦਿੰਦੇ ਹੋਏ ਪੂਲ ਰਿਕਵੇਸਟ ਸਬਮਿਟ ਕਰੋਂ
### ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ
1. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੋਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
2. ਲਗਾਤਾਰ ਪਾਠ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਜਾਓ
3. ਹਰ ਪਾਠ ਲਈ README ਫਾਈਲਾਂ ਪੜ੍ਹੋ
4. ਪ੍ਰੀ-ਪਾਠ ਕੁਇਜ਼ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰੇ ਕਰੋ
1. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
2. ਲੈਸਨ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕ੍ਰਮਵਾਰ ਜਾਓ
3. ਹਰ ਪਾਠ ਲਈ README ਫਾਇਲਾਂ ਪੜ੍ਹੋ
4. ਪਹਿਲਾਂ ਲੈਸਨ ਬਣਾਉਣ ਵਾਲੇ ਕਵਿਜ਼ ਨੂੰ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰਾ ਕਰੋ
5. ਪਾਠ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਣਾਂ 'ਤੇ ਕੰਮ ਕਰੋ
6. ਅਸਾਈਨਮੈਂਟ ਅਤੇ ਚੈਲੈਂਜ ਪੂਰੇ ਕਰੋ
7. ਪੋਸਟ-ਪਾਠ ਕੁਇਜ਼ ਲਓ
6. ਅਸਾਇਨਮੈਂਟ ਅਤੇ ਚੈਲੇਂਜ ਪੂਰੇ ਕਰੋ
7. ਬਾਅਦ ਦੇ ਲੈਸਨ ਕਵਿਜ਼ ਲਵੋ
### ਲਾਈਵ ਵਿਕਾਸ
- **ਦਸਤਾਵੇਜ਼**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000)
- **ਕੁਇਜ਼ ਐਪ**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
- **ਪ੍ਰੋਜੈਕਟ**: VS Code Live Server ਐਕਸਟੇਸ਼ਨ ਵਲੋਂ HTML ਪ੍ਰੋਜੈਕਟ ਚਲਾਓ
- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm start` ਚਲਾਓ
- **ਕਵਿਜ਼ ਐਪ**: `quiz-app` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
- **ਪ੍ਰੋਜੈਕਟਾਂ**: HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm start` ਚਲਾਓ
## ਟੈਸਟਿੰਗ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
## ਟੈਸਟਿੰਗ ਨਿਰਦੇਸ਼
### Quiz ਐਪ ਟੈਸਟਿੰਗ
### ਕਵਿਜ਼ ਐਪ ਟੈਸਟਿੰਗ
```bash
cd quiz-app
npm run lint # ਕੋਡ ਸ਼ੈਲੀ ਦੇ ਮੁੱਦਿਆਂ ਦੀ ਜਾਂچ ਕਰੋ
npm run build # ਬਣਾਉਂਡ ਦੁਆਰਾ ਸਫਲ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
npm run lint # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਲਈ ਜਾਂਚ ਕਰੋ
npm run build # ਨਿਰਮਾਣ ਸਫਲ ਹੋਣਾ ਪੁਸ਼ਟੀ ਕਰੋ
```
### ਬੈਂਕ API ਟੈਸਟਿੰਗ
```bash
cd 7-bank-project/api
npm run lint # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
node server.js # ਸਰਵਰ ਬਿਨਾ ਗਲਤੀਆਂ ਦੇ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
npm run lint # ਕੋਡ ਅੰਦਾਜ਼ ਸਮੱਸਿਆਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
node server.js # ਬਿਨਾਂ ਗਲਤੀਆਂ ਦੇ ਸਰਵਰ ਸ਼ੁਰੂ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
```
### ਆਮ ਟੈਸਟਿੰਗ ਪদ্ধਤੀ
### ਆਮ ਟੈਸਟਿੰਗ ਪਹੁੰਚ
- ਇਹ ਇੱਕ ਸਿੱਖਿਆ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਵਿਆਪਕ ਆਟੋਮੇਟੇਡ ਟੈਸਟ ਨਹੀਂ ਹਨ
- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ ਧਿਆਨ ਦੇਂਦਾ ਹੈ:
- ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਬਿਨਾ ਗਲਤੀ ਚਲਾਉਣਾ
- ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹੋਣ
- ਪ੍ਰੋਜੈਕਟ ਸਹੀ ਖ਼ਤਮ ਹੋਣ
- ਉਦਾਹਰਣ ਵਧੀਆ ਤਰੀਕੇ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹੋਣ
- ਇਹ ਇੱਕ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ
- ਮੈਨੁਅਲ ਟੈਸਟਿੰਗ ‘ਤੇ ਧਿਆਨ:
- ਕੋਡ ਉਦਾਹਰਣਾਂ ਬਿਨਾਂ ਗਲਤੀਆਂ ਚੱਲ ਰਹੇ ਹੋਣ
- ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਲਿੰਕ ਠੀਕ ਕੰਮ ਕਰ ਰਹੇ ਹੋਣ
- ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲਤਾਪੂਰਵਕ ਹੋਣ
- ਉਦਾਹਰਣਾਂ ਵਧੀਆ ਪ੍ਰਥਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰ ਰਹੇ ਹੋਣ
### ਪਰੇ-ਸਬਮਿਸ਼ਨ ਚੈਕਸ
### ਪੂਰਵ-ਦਾਖਲਾ ਚੈੱਕ
- ਜਿਨ੍ਹਾਂ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ package.json ਹੈ ਉਥੇ `npm run lint` ਚਲਾਓ
- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਨੂੰ ਸਹੀ ਪਰਖੋ
- ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਬਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
- ਅਨੁਵਾਦ ਸੰਰਚਨਾ ਨੂੰ ਠੀਕ ਰੱਖਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
- `package.json` ਵਾਲੇ ਫੋਲਡਰਾਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸੰਪੂਰਨਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
- ਕੋਡ ਉਦਾਹਰਣ ਬ੍ਰਾਉਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
- ਅਨੁਵਾਦਾਂ ਦੀ ਸਠਿਕ ਰਚਨਾ ਬਰਕਰਾਰ ਰਹਿੰਦੀ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
## ਕੋਡ ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
## ਕੋਡ ਸਟਾਈਲ ਨਿਰਦੇਸ਼
### ਜਾਵਾਸਕ੍ਰਿਪਟ
### JavaScript
- ਆਧੁਨਿਕ ES6+ ਸਿੰਟੈਕਸ ਵਰਤੋਂ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ESLint ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਸਿੱਖਿਆ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਵਿਆਖਿਆਤਮਕ ਵੇਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਂ ਵਰਤੋ
- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
- ਜਿੱਥੇ ਤੇਜ਼ੀ ਨਾਲ ਹੱਲ ਕਰਨ ਵਾਲੇ ਪ੍ਰੀਟੀਅਰ ਵਰਤੋ
- ਆਧੁਨਿਕ ES6+ ਵਾਕਯਾਂ ਨੂੰ ਵਰਤੋਂ
- ਪ੍ਰਾਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਵਿਵਸਥਾਪਨ ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਸਿੱਖਣ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਮਾਇਨੇਵਾਲੇ ਵੈਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋਂ
- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਨਾ ਸਮਝਾਉਣ ਵਾਲੇ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
### HTML/CSS
- ਸੈਂਟੀਮੈਟਿਕ HTML5 ਇਲੈਮੈਂਟ
- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਈਨ ਸਿਧਾਂਤ
- ਸਾਫ਼ ਸੰਗਠਿਤ ਕਲਾਸ ਨਾਂ
- CSS ਤਕਨੀਕਾਂ ਲਈ ਟਿੱਪਣੀਆਂ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ
- ਸਮਾਂਤਾਰਕ HTML5 ਤੱਤ
- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਇਨ ਨੀਤੀ
- ਸਾਫ਼ ਸਿੱਧੇ ਕਲਾਸ ਨਾਂਮ
- CSS ਤਕਨੀਕਾਂ ਸਿੱਖਾਉਂਦੀਆਂ ਟਿੱਪਣੀਆਂ
### ਪਾਇਥਨ
### Python
- PEP 8 ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
- ਸਪਸ਼ਟ ਅਤੇ ਸਿੱਖਣ ਜੋਗੇ ਕੋਡ ਉਦਾਹਰਣ
- ਸਿੱਖਣ ਲਈ ਟਾਈਪ ਹਿੰਟ ਜਿੱਥੇ ਲੋੜ ਹੋਵੇ
- PEP 8 ਸਟਾਈਲ ਧਾਰਾਵਾਂ
- ਸਿੱਖਣ ਲਈ ਸਾਫ਼ ਕੋਡ ਉਦਾਹਰਣ
- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਟਾਈਪ ਉਹ ਘੁੱਟਨ ਸਮੇਤ
### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼ੀ
### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼
- ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ
- ਭਾਸ਼ਾ ਨਿਰਧਾਰਿਤ ਕੋਡ ਬਲਾਕ
- ਵਾਧੂ ਸਾਧਨਾਂ ਲਈ ਲਿੰਕ
- `images/` ਫੋਲਡਰ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ੌਟ ਅਤੇ ਚਿੱਤਰ
- ਸਪਸ਼ਟ ਸਿਰਲੇਖਾਂ ਦੀ ਵਰਕਿਰਤਾ
- ਭਾਸ਼ਾ ਨਾਲ ਕੋਡ ਬਲਾਕ
- ਵਾਧੂ ਸਰੋਤਾਂ ਲਈ ਲਿੰਕ
- `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ
- ਪਹੁੰਚਯੋਗਤਾ ਲਈ ਚਿੱਤਰਾਂ ਦਾ Alt ਟੈਕਸਟ
### ਫਾਈਲ ਸੰਗਠਨ
### ਫਾਇਲ ਸੰਗਠਨ
- ਪਾਠਾਂ ਨੂੰ ਲਗਾਤਾਰ ਨੰਬਰ ਦਿੱਤਾ ਗਿਆ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਜ਼
- ਪਾਠ ਅਨੁਸਾਰ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ
- ਅਨੁਵਾਦ `translations/{language-code}/` ਬਣਤਰ ਵਿੱਚ
- ਲੈਸਨ ਕ੍ਰਮਵਾਰ ਨੰਬਰਿਤ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਆਂ
- ਪਾਠ-ਵਿਸ਼ੇਸ਼ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ ਹੁੰਦੇ ਹਨ
- ਤਰਜਮੇ ਨੂੰ `translations/{language-code}/` ਵਿੱਚ ਸੰਗ੍ਰਹਿਤ ਕਰਨਾ
## ਬਣਾਉ ਅਤੇ ਤैनਾਤੀ
## ਬਿਲਡ ਅਤੇ ਡਿਪਲੋਇਮੈਂਟ
### Quiz ਐਪ ਤੈਨਾਤੀ (Azure Static Web Apps)
### ਕਵਿਜ਼ ਐਪ ਡਿਪਲੋਇਮੈਂਟ (Azure Static Web Apps)
quiz-app ਨੂੰ Azure Static Web Apps ਲਈ ਤਾਇਨਾਤ ਕੀਤਾ ਗਿਆ ਹੈ:
quiz-app ਨੂੰ Azure Static Web Apps ਡਿਪਲੋਇਮੈਂਟ ਲਈ ਸੈਟ ਕੀਤਾ ਗਿਆ ਹੈ:
```bash
cd quiz-app
npm run build # dist/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ
# ਮੂਲ ‘ਤੇ ਧੱਕਣ ‘ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਤਾਇਨਾਤ ਕਰਦਾ ਹੈ
# ਮੈਨ branch 'ਤੇ push ਕਰਨ 'ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੌਏਂਡ ਕਰਦਾ ਹੈ
```
Azure Static Web Apps ਸੰਰਚਨਾ:
- **ਐਪ ਸਥਾਨ**: `/quiz-app`
- **ਆਉਟਪੁੱਟ ਸਥਾਨ**: `dist`
- **ਐਪ ਸਥਿਤੀ**: `/quiz-app`
- **ਆਉਟਪੁੱਟ ਸਥਿਤੀ**: `dist`
- **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### ਦਸਤਾਵੇਜ਼ PDF ਬਣਾਉ
### ਦਸਤਾਵੇਜ਼ PDF ਬਣਾਉਣਾ
```bash
npm install # docsify-to-pdf ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ
npm run convert # docs ਤੋਂ PDF ਤਿਆਰ ਕਰੋ
npm run convert # docs ਤੋਂ PDF ਬਣਾਓ
```
### Docsify ਦਸਤਾਵੇਜ਼ੀ
### Docsify ਦਸਤਾਵੇਜ਼
```bash
npm install -g docsify-cli # ਡੋਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲ ਤੌਰ 'ਤੇ ਇੰਸਟਾਲ ਕਰੋ
docsify serve # ਲੋਕਲਹੁਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
npm install -g docsify-cli # ਡੌਕਸੀਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ
docsify serve # ਲੋਕਲਹੋਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
```
### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਣਾਉ
### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ
ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਣਾਉ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ:
- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ
- ਸਥਿਰ ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ: ਕੋਈ ਬਣਾਉ ਕਦਮ ਨਹੀਂ, ਫਾਈਲਾਂ ਸਿੱਧਾ ਸਰਵ ਕਰੋ
ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦਾ ਹੈ:
- 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` ਚਲਾਓ
- ਸਾਰੇ ਕਮੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਸੁਧਾਰੋ
- ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
- ਸਾਰੇ ਲਿੰਟ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਦੂਰ ਕਰੋ
2. **ਬਿਲਡ ਚੈਕ**:
2. **ਬਿਲਡ ਪੁਸ਼ਟੀ**:
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ
- ਕੋਈ ਬਣਾਉ ਗਲਤੀ ਨਾ ਹੋਵੇ
- ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਹੀਂ ਹੋਣ
3. **ਲਿੰਕ ਦਾ ਪਰਖ**:
- ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਟੈਸਟ ਕਰੋ
- ਚਿੱਤਰ ਦੇ ਸੰਦਰਭ ਸਹੀ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
3. **ਲਿੰਕ ਵੈਧਤਾ**:
- ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ
- ਚਿੱਤਰ ਸੰਦਰਭਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**:
- ਵਰਣਮਾਲਾ ਅਤੇ ਵਿਆਕਰਨ ਸਹੀ ਹੈ ਕੀ ਨਹੀਂ ਪੜ੍ਹੋ
- ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣ ਯੋਗ ਹਨ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
- ਅਨੁਵਾਦ ਅਸਲੀ ਮਹੱਤਵ ਬਣਾਈ ਰੱਖਦੇ ਹਨ
- ਸਪੈਲਿੰਗ ਅਤੇ ਵਿਆਕਰਨ ਲਈ ਪ੍ਰੂਫਰੀਡ ਕਰੋ
- ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣਯੋਗ ਹੋਣ
- ਅਨੁਵਾਦਾਂ ਦਾ ਮੂਲ ਅਰਥ ਬਣਿਆ ਰਹੇ ਇਹ ਚੈੱਕ ਕਰੋ
### ਯੋਗਦਾਨ ਦੇ ਅਹੁਦੇ
### ਯੋਗਦਾਨ ਲੈਣ ਦੀਆਂ ਸ਼ਰਤਾਂ
- Microsoft CLA ਨਾਲ ਸਹਿਮਤ ਹੋਵੋ (ਪਹਿਲੀ PR ਲਈ ਆਟੋਚੈਕ)
- [Microsoft Open Source ਕੋਡ ਆਫ਼ ਕੰਡੱਕਟ](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਮਾਈਕ੍ਰੋਸਾਫਟ CLA (ਸਵੈਚਾਲਿਤ ਜਾਂਚ ਪਹਿਲੀ PR ‘ਤੇ) ਨੂੰ ਮਨਜ਼ੂਰ ਕਰੋ
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ ਪੁਲ ਰਿਕਵੈਸਟ ਵੇਰਵੇ ਵਿੱਚ ਮੁਦਦਾ ਨੰਬਰ ਦਰਜ ਕਰੋ
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਨੰਬਰ ਦਰਜ ਕਰੋ
### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ
- ਪੁਲ ਰਿਕਵੈਸਟ ਨੂੰ ਸੁਚਾਲਕ ਅਤੇ ਕਮਿਊਨਿਟੀ ਦੁਆਰਾ ਸਮੀਖਿਆ ਕੀਤਾ ਜਾਵੇਗਾ
- ਸਿੱਖਿਆ ਸਪਸ਼ਟਤਾ ਨੂੰ ਪਹਿਲ ਦਿੱਤੀ ਜਾਵੇਗੀ
- ਕੋਡ ਉਦਾਹਰਣ ਨੂੰ ਵਰਤਮਾਨ ਵਧੀਆ ਤਰੀਕੇ ਅਨੁਸਾਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
- ਅਨੁਵਾਦ ਨੂੰ ਯਥਾਰਥ ਅਤੇ ਸੱਭਿਆਚਾਰਕ ਤੌਰ 'ਤੇ ਜ਼ਾਂਚਿਆ ਜਾਵੇਗਾ
- PRs ਨੂੰ ਮੇਂਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਵੱਲੋਂ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ
- ਸਿੱਖਣਯੋਗ ਸਪਸ਼ਟਤਾ ਪ੍ਰਾਥਮਿਕਤਾ ਹੈ
- ਕੋਡ ਉਦਾਹਰਣ ਮੌਜੂਦਾ ਵਧੀਆ ਅਭਿਆਸਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ
- ਅਨੁਵਾਦਾਂ ਦੀ ਸੁਨਿਸ਼ਚਿਤਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਉਚਿਤਤਾ ਲਈ ਸਮੀਖਿਆ
## ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ
## ਅਨੁਵਾਦ ਸਿਸਟਮ
### ਆਟੋਮੇਟੇਡ ਅਨੁਵਾਦ
### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ
- GitHub Actions ਵਿੱਚ co-op-translator ਵਰਕਫਲੋ ਵਾਪਰਦਾ ਹੈ
- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਪਣੇ ਆਪ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
- ਮੂਲ ਫਾਈਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਹਨ
- ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ
- GitHub Actions ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ
- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸਵੈਚਾਲਿਤ ਤੌਰ 'ਤੇ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
- ਸੋ스 ਫਾਇਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਹਨ
- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ
### ਮੈਨੂਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ
### ਮੈਨੁਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ
1. `translations/{language-code}/` ਵਿੱਚ ਫਾਈਲ ਲੱਭੋ
2. ਸੰਰਚਨਾ ਬਿਨਾ ਬਦਲੇ ਸੁਧਾਰ ਕਰੋ
3. ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਫੰਕਸ਼ਨਲ ਰੱਖੋ
4. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕੁਇਜ਼ ਸਮੱਗਰੀ ਨੂੰ ਟੈਸਟ ਕਰੋ
1. `translations/{language-code}/` ਵਿੱਚ ਫਾਇਲ ਲੱਭੋ
2. ਸੰਰਚਨਾ ਨੂੰ ਸੁਰੱਖਿਅਤ ਰੱਖਦਿਆਂ ਸੁਧਾਰ ਕਰੋ
3. ਕੋਡ ਉਦਾਹਰਣ ਕੰਮਕਾਜ਼ ਹੁੰਦੇ ਰਹਿੰਦੇ ਹਨ ਇਹ ਯਕੀਨੀ ਬਣਾਓ
4. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਦੀ ਜਾਂਚ ਕਰੋ
### ਅਨੁਵਾਦ ਮੇਟਾਡਾਟਾ
### ਅਨੁਵਾਦ ਮੈਟਾ ਡੇਟਾ
ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ ਵਿੱਚ ਮੇਟਾਡਾਟਾ ਹੈਡਰ ਹੁੰਦਾ ਹੈ:
ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ metadata ਹੈੱਡਰ ਸ਼ਾਮਲ ਕਰਦੀਆਂ ਹਨ:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆ ਸਲਝਾਉਣਾ
## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆਵਾਂ ਦਾ ਨਿਵਾਰਣ
### ਆਮ ਸਮੱਸਿਆਵਾਂ
**ਕੁਇਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜ਼ਨ (v14+ ਸਿਫਾਰਸ਼ੀ) ਚੈੱਕ ਕਰੋ
**ਕਵਿਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜਨ ਚੈੱਕ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀ ਹੈ)
- `node_modules` ਅਤੇ `package-lock.json` ਮਿਟਾਓ, ਫਿਰ `npm install` ਚਲਾਓ
- ਪੋਰਟ ਟਕਰਾਅ ਦੇਖੋ (ਡਿਫਾਲਟ: Vite ਪੋਰਟ 5173 ਵਰਤਦਾ ਹੈ)
- ਪੋਰਟ ਟਕਰਾਅ ਚੈੱਕ ਕਰੋ (ਮੂਲ: Vite 5173 ਪੋਰਟ ਵਰਤਦਾ ਹੈ)
**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜ਼ਨ ਨਿਯਮਤ ਹੈ (node >=10)
- ਪੋਰਟ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ ਜਾਂ ਨਹੀਂ ਵੇਖੋ
- ਸਾਰੀਆਂ ਲਾਇਬ੍ਰੇਰੀਆਂ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਈਆਂ ਹਨ
**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜਨ ਨਿਰੀਖਣ ਕਰੋ (node >=10)
- ਜੇ ਪੋਰਟ ਪਹਿਲਾਂ ਹੀ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ ਤਾਂ ਚੈੱਕ ਕਰੋ
- ਸਾਰੀਆਂ ਡਿਪੈਂਡੈਂਸੀਜ਼ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਈਆਂ ਹਨ ਜਾਂ ਨਹੀਂ
**ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**:
- manifest.json ਸਹੀ ਫਾਰਮੈਟ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
- ਬ੍ਰਾਉਜ਼ਰ ਕਨਸੋਲ ਦੀ ਗਲਤੀ ਦਿਖਾਈ ਦੇ ਰਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਵੇਖੋ
- ਬ੍ਰਾਉਜ਼ਰ-ਵਿਸ਼ੇਸ਼ਤ ਐਕਸਟੈਂਸ਼ਨ ਸਥਾਪਨਾ ਹਦਾਇਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
**ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦਾ**:
- manifest.json ਢੰਗ ਨਾਲ ਫਾਰਮੈਟਡ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
- ਬਰਾਊਜ਼ਰ ਕਨਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੇਖੋ
- ਵਰਤੇ ਜਾ ਰਹੇ ਬਰਾਊਜ਼ਰ ਲਈ ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਅਨੁਸਾਰ ਕੰਮ ਕਰੋ
**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆ**:
**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**:
- OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai`
- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਸੈਟ ਹੋਣਾ ਜ਼ਰੂਰੀ
- GitHub ਮਾਡਲਾਂ ਦੀ ਐਕਸੈਸ ਅਧਿਕਾਰ ਚੈੱਕ ਕਰੋ
- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ (environment variable) ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ
- GitHub ਮਾਡਲਜ਼ ਐਕਸੈਸ ਪਰਮਿਸ਼ਨਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
**Docsify ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਸਰਵ ਕਰਦਾ**:
- docsify-cli ਗਲੋਬਲਤੌਰ 'ਤੇ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
- ਰਿਪੋਜ਼ਿਟਰੀ ਦੇ ਰੂਟ ਤੋਂ ਚਲਾਓ
- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਦੇਖੋ
**Docsify ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਨਹੀਂ ਕਰ ਰਿਹਾ**:
- docsify-cli ਗਲੋਬਲ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
- ਰਿਪੋਜ਼ਿਟਰੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਚਲਾਓ
- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
### ਵਿਕਾਸ ਵਾਤਾਵਰਣ ਟਿਪਸ
- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਨਾਲ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਸ ਸਥਾਪਤ ਕਰੋ
- ਜਾਵਾਸਕ੍ਰਿਪਟ ਡੀਬੱਗਿੰਗ ਲਈ ਬ੍ਰਾਉਜ਼ਰ DevTools ਵਰਤੋਂ
- Vue ਪ੍ਰੋਜੈਕਟ ਲਈ Vue DevTools ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਵਿੱਚ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਾਂ ਨੂੰ ਅਨੁਕੂਲ ਫਾਰਮੈਟਿੰਗ ਲਈ ਇੰਸਟਾਲ ਕਰੋ
- ਜਾਵਾਸਕ੍ਰਿਪਟ ਲਈ ਬਰਾਊਜ਼ਰ ਡਿਵੈਲਪਰ ਟੂਲਜ਼ ਵਰਤੋਂ
- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ Vue DevTools ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
### ਪ੍ਰਦਰਸ਼ਨ ਧਿਆਨ ਵਿੱਚ ਰੱਖਣ ਵਾਲੀਆਂ ਗੱਲਾਂ
### ਪ੍ਰਦਰਸ਼ਨ ਦੀਆਂ ਗੱਲਾਂ
- 50+ ਭਾਸ਼ਾਵਾਂ ਦੇ ਅਨੁਵਾਦ ਨਾਲ ਕਲੋਨ ਵੱਡਾ ਹੈ
- ਸਿਰਫ ਸਮੱਗਰੀ `git clone --depth 1` ਨਾਲ ਘੱਟ ਡੈਪਥ ਕਲੋਨ ਕਰੋ
- ਅੰਗ੍ਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਚ ਕੰਮ ਦੌਰਾਨ ਅਨੁਵਾਦ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
- ਪਹਿਲੀ ਵਾਰੀ ਚਲਾਉਣ ਤੇ npm install ਤੇ Vite build ਕਰਨਾ ਧੀਮਾ ਹੋ ਸਕਦਾ ਹੈ
- ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਅਨੁਵਾਦਤ ਫਾਇਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦੀ ਵਜੇ ਨਾਲ ਪੂਰੇ ਕਲੋਨ ਵੱਡੇ ਹਨ
- ਕੇਵਲ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ ਤਾਂ shallow clone ਵਰਤੋਂ: `git clone --depth 1`
- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ ’ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
- ਪਹਿਲੀ ਵਾਰੀ npm install ਅਤੇ Vite build ਦੇ ਕਾਰਨ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਧੀਮੀ ਹੋ ਸਕਦੀ ਹੈ
## ਸੁਰੱਖਿਆ ਸਬੰਧੀ ਗੱਲਾਂ
## ਸੁਰੱਖਿਆ ਦੀਆਂ ਗੱਲਾਂ
### ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ
### ਵਾਤਾਵਰਣ ਚਰ
- API ਕੁੰਜੀਆਂ ਕਦੇ ਭੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿਚ ਜਮ੍ਹਾਂ ਨਾ ਕਰੋ
- `.env` ਫਾਈਲਾਂ ਵਰਤੋ (ਪਹਿਲਾਂ ਹੀ `.gitignore` ਵਿੱਚ ਹਨ)
- ਪ੍ਰੋਜੈਕਟ README ਵਿੱਚ ਲੋਜ਼ਮੀ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਦਸਤਾਵੇਜ਼ ਕਰੋ
- API ਕੁੰਜੀਆਂ ਕਦੇ ਵੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿੱਚ ਕਮਿੱਟ ਨਾ ਕਰੋ
- `.env` ਫਾਇਲਾਂ ਵਰਤੋ (ਜੋ `.gitignore` ਵਿੱਚ ਹਨ)
- ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਵਿੱਚ ਦਰਜ ਕਰੋ
### Python ਪ੍ਰੋਜੈਕਟ
- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋਂ: `python -m venv venv`
- ਨਿਰਭਰਤਾਵਾਂ ਹਮੇਸ਼ਾ ਅਪਡੇਟ ਰੱਖੋ
- GitHub ਟੋਕਨਾਂ ਨੂੰ ਘੱਟੋ-ਘੱਟ ਜਰੂਰੀ ਅਧਿਕਾਰ ਦਿਓ
- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋ: `python -m venv venv`
- ਡਿਪੇਂਡੈਂਸੀਜ਼ ਅਪਡੇਟ ਰੱਖੋ
- GitHub ਟੋਕੇਨ ਨੂੰ ਘੱਟੋ ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰਾਂ ਨਾਲ ਵਰਤੋਂ
### GitHub ਮਾਡਲ ਐਕਸੈਸ
- GitHub ਮਾਡਲ ਲਈ Personal Access Tokens (PAT) ਲਾਜ਼ਮੀ
- ਟੋਕਨ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਵਜੋਂ ਸੁਰੱਖਿਅਤ ਰੱਖੋ
- ਕਦੇ ਟੋਕਨਾਂ ਜਾਂ ਲਾਗਇਨ ਜਾਣਕਾਰੀ ਰਿਪੋ ਵਿੱਚ ਭੇਜੋ ਨਾ
- GitHub ਮਾਡਲਾਂ ਲਈ ਪਰਸਨਲ ਐਕਸੈਸ ਟੋਕੇਨ (PAT) ਲੋੜੀਂਦੇ ਹਨ
- ਟੋਕੇਨ ਵਾਤਾਵਰਣ ਚਰ ਵਜੋਂ ਰੱਖੋ
- ਟੋਕੇਨ ਜਾਂ ਪ੍ਰਮਾਣ ਪੱਤਰ ਕਦੇ ਵੀ ਕਮਿੱਟ ਨਾ ਕਰੋ
## ਵਾਧੂ ਨੋਟਾਂ
## ਵਧੂ ਨੋਟਸ
### ਟਾਰਗਟ ਦਰਸ਼ਕ
### ਲਕੜਾਰਥ ਸੰਗ੍ਰਾਹਕ
- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਬਿਲਕੁਲ ਸ਼ੁਰੂਆਤੀ ਲੋਕ
- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖ਼ੁਦ ਸਿੱਖਣ ਵਾਲੇ
- ਅਧਿਆਪਕ ਜਿਹੜੇ ਕਲਾਸਾਂ ਵਿੱਚ ਕੋਰਸ ਵਰਤਦੇ ਹਨ
- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗ ਅਤੇ ਹੌਲੀ-ਹੌਲੀ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਬਨਾਈ ਗਈ
- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਪੂਰਨ ਸ਼ੁਰੂਆਤੀ
- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ
- ਕਲਾਸਰੂਮਾਂ ਵਿੱਚ ਸਿਲੇਬਸ ਦਾ ਉਪਯੋਗ ਕਰਨ ਵਾਲੇ ਅਧਿਆਪਕ
- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਕਦਮ-ਦਰ-ਕਦਮ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ
### ਸਿੱਖਿਆ ਦਾ ਦ੍ਰਿੜ੍ਹ ਨਜ਼ਰੀਆ
### ਸਿੱਖਣ ਦੀ ਦਾਰਸ਼ਨਿਕਤਾ
- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣਾ
- ਅਕਸਰ ਗਿਆਨ ਜਾਂਚ (ਕੁਇਜ਼)
- ਹੱਥ ਨਾਲ ਕੋਡ ਲਿਖਣ ਵਾਲੀਆਂ ਕਸਰਤਾਂ
- ਅਸਲੀ ਦੁਨੀਆ ਦੀਆਂ ਉਦਾਹਰਣਾਂ
- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਮੂਲ ਭੂਤਾਂ 'ਤੇ ਧਿਆਨ
- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣ ਦੀ ਪਢ਼ਤਾਲ
- ਮੁੜ-ਮੁੜ ਗਿਆਨ ਦੀ ਜਾਂਚ (ਕਵਿਜ਼)
- ਹੱਥ-ਵਿੱਚ ਕੋਡਿੰਗ ਅਭਿਆਸ
- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦਾਹਰਣ
- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਜਾਣਕਾਰੀ ’ਤੇ ਧਿਆਨ
### ਰਿਪੋਜ਼ਿਟਰੀ ਦੇਖ-ਰੇਖ
### ਰਿਪੋਜ਼ਿਟਰੀ ਦਾ ਸੰਭਾਲ
- ਕਮਿਊਨਿਟੀ ਦੀ ਸਰਗਰਮ ਭਾਗੀਦਾਰੀ
- ਨਿਰਭਰਤਾਵਾਂ ਅਤੇ ਸਮੱਗਰੀ ਨੂੰ ਨਿਯਮਤ ਅਪਡੇਟ
- ਸਮੱਸਿਆਵਾਂ ਅਤੇ ਵਿਚਾਰ-वਟਾਂਦਰੇ ਦੀ ਮਾਨੀਟਰੇਟ
- GitHub Actions ਨਾਲ ਅਨੁਵਾਦ ਨਵੀਨਕਰਨ
- ਸਿੱਖਣ ਵਾਲਿਆਂ ਅਤੇ ਯੋਗਦਾਨਕਾਰਾਂ ਦੀ ਸਰਗਰਮ ਸਮੁਦਾਇ
- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦਾ ਨਿਯਮਤ ਅੱਪਡੇਟ
- ਮੈਨਟੇਨਰਾਂ ਵੱਲੋਂ ਮੁੱਦੇ ਅਤੇ ਗੱਲਬਾਤਨੂੰ ਨਿਗਰਾਨੀ
- ਅਨੁਵਾਦਾਂ ਦੇ ਅੱਪਡੇਟ GitHub Actions ਰਾਹੀਂ ਆਟੋਮੈਟਿਕ
### ਸੰਬੰਧਿਤ ਸਾਧਨ
### ਸੰਬੰਧਤ ਸਰੋਤ
- [Microsoft Learn ਮੌਡੀਊਲ](https://docs.microsoft.com/learn/)
- [Student Hub ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸੁਝਾਅ
- ਹੋਰ ਕੋਰਸ: ਜਨਰੇਟਿਵ AI, ਡਾਟਾ ਸਾਇੰਸ, ML, IoT ਕੋਰਸਾਂ ਉਪਲਬਧ
- [Microsoft Learn ਮੋਡਿਊਲ](https://docs.microsoft.com/learn/)
- [ਵਿਦਿਆਰਥੀ ਹੋਬ ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸੁਝਾਇਆ ਗਿਆ
- ਵਾਧੂ ਕੋਰਸ: ਜਨਰੇਟਿਵ AI, ਡੇਟਾ ਸਾਇੰਸ, ML, IoT ਸਿਲੇਬਸ ਉਪਲਬਧ
### ਵਿਸ਼ੇਸ਼ ਪ੍ਰੋਜੈਕਟ ਨਾਲ ਕੰਮ ਕਰਨਾ
### ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ
ਵਿਸ਼ੇਸ਼ ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ ਵਿਸਥਾਰ ਨਾਲ ਦਸਤਾਵੇਜ਼ README ਫਾਈਲਾਂ ਵਿੱਚ ਹਨ:
- `quiz-app/README.md` - Vue 3 quiz ਐਪਲੀਕੇਸ਼ਨ
- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪ
- `5-browser-extension/README.md` - ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ
- `6-space-game/README.md` - ਕੈਨਵਸ-ਆਧਾਰਿਤ ਗੇਮ ਵਿਕਾਸ
- `9-chat-project/README.md` - AI ਚੈਟ ਸਹਾਇਕ ਪ੍ਰੋਜੈਕਟ
ਵਿਸਥਾਰਿਤ ਨਿਰਦੇਸ਼ਾਂ ਲਈ ਹਰੇਕ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਨੂੰ ਵੇਖੋ:
- `quiz-app/README.md` - Vue 3 ਕਵਿਜ਼ অ্যਪਲੀਕੇਸ਼ਨ
- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪਲੀਕੇਸ਼ਨ
- `5-browser-extension/README.md` - ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ
- `6-space-game/README.md` - ਕੈਨਵਾਸ ਆਧਾਰਤ ਗੇਮ ਵਿਕਾਸ
- `9-chat-project/README.md` - AI ਚੈਟ ਅਸਿਸਟੈਂਟ ਪ੍ਰੋਜੈਕਟ
### ਮੋਨੋਰੇਪੋ ਬਣਤਰ
### ਮੋਨੋਰੇਪੋ ਸੰਰਚਨਾ
ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਾ ਹੋਣ ਦੇ ਬਾਵਜੂਦ, ਇਹ ਰਿਪੋਜ਼ਿਟਰੀ ਕਈ ਸਵਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
- ਹਰ ਪਾਠ ਖੁਦ ਮੁਖਤਿਆਰ ਹੈ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿਚ ਨਿਰਭਰਤਾਵਾਂ ਸਾਂਝੀਆਂ ਨਹੀਂ
- ਵਿਅਕਤੀਗਤ ਪ੍ਰੋਜੈਕਟਾਂ 'ਤੇ ਕੰਮ ਕਰੋ ਬਿਨਾ ਦੂਜਿਆਂ 'ਤੇ ਅਸਰ ਪਾਏ
- ਪੂਰਾ ਕੋਰਸ ਤਜਰਬਾ ਲਈ ਪੂਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ
ਇਹ ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ ਪਰ ਇਸ ਵਿੱਚ ਬਹੁਤ ਸਾਰੇ ਸੁਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
- ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਸਾਂਝੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨਹੀਂ ਹਨ
- ਇਕ-ਦੂਜੇ ਉੱਤੇ ਪ੍ਰਭਾਵ ਨਾ ਪਾਉਂਦੇ ਹੋਏ ਵੱਖ-ਵੱਖ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਕੰਮ ਕਰੋ
- ਪੂਰਾ ਸਿਲੇਬਸ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ਅਸਵੀਕਾਰਤਾ**:
ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਅਤ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਣਸੱਥਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਅਧਿਕਾਰਤ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਨਾਲ ਪੈਦਾ ਹੋਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤ ਸਮਝ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆਵਾਂ ਲਈ ਅਸੀਂ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ।
**ਅਸਵੀਕਾਰੋpetition**:
ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਨਾਲ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸ਼ੁੱਧਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੰਸ਼ੋਧਿਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦਾ ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਇਸਦਾ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਣ ਜਾਣਕਾਰੀ ਲਈ ਵਿਸ਼ੇਸ਼ਗੀ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀ ਜਾਂ ਗਲਤ ਵਿਵਿਚਾਰ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

2
translations/pt-BR/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:40:43+00:00",
"translation_date": "2026-04-20T15:51:19+00:00",
"source_file": "AGENTS.md",
"language_code": "pt-BR"
},

382
translations/pt-BR/AGENTS.md
Unescape View File

@ -2,29 +2,29 @@
## Visão Geral do Projeto
Este é um repositório educacional para ensinar fundamentos de desenvolvimento web para iniciantes. O currículo é um curso completo de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 aulas práticas cobrindo JavaScript, CSS e HTML.
Este é um repositório educacional para ensinar fundamentos de desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 aulas práticas abordando JavaScript, CSS e HTML.
### Componentes Principais
- **Conteúdo Educacional**: 24 aulas estruturadas organizadas em módulos baseados em projetos
- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicativo Bancário, Editor de Código e Assistente de Chat com IA
- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré/pós-aula)
- **Suporte Multilíngue**: Traduções automatizadas para mais de 50 idiomas via GitHub Actions
- **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA)
- **Conteúdo Educacional**: 24 aulas estruturadas organizadas em módulos baseados em projetos
- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, App Bancário, Editor de Código e Assistente de Chat de IA
- **Quizzes Interativos**: 48 quizzes com 3 perguntas cada (avaliações pré e pós-lesson)
- **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions
- **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA)
### Arquitetura
- Repositório educacional com estrutura baseada em aulas
- Cada pasta de aula contém README, exemplos de código e soluções
- Projetos independentes em diretórios separados (quiz-app, vários projetos de aulas)
- Sistema de tradução usando GitHub Actions (co-op-translator)
- Documentação servida via Docsify e disponível em PDF
- Repositório educacional com estrutura baseada em lições
- Cada pasta de lição contém README, exemplos de código e soluções
- Projetos independentes em diretórios separados (quiz-app, vários projetos de lição)
- Sistema de tradução usando GitHub Actions (co-op-translator)
- Documentação servida via Docsify e disponível em PDF
## Comandos de Configuração
Este repositório é voltado principalmente para consumo de conteúdo educacional. Para trabalhar com projetos específicos:
Este repositório é principalmente para consumo de conteúdo educacional. Para trabalhar com projetos específicos:
### Configuração do Repositório Principal
### Configuração Principal do Repositório
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -41,7 +41,7 @@ npm run build # Construir para produção
npm run lint # Executar ESLint
```
### API do Projeto Bancário (Node.js + Express)
### Projeto API Bancária (Node.js + Express)
```bash
cd 7-bank-project/api
@ -72,37 +72,37 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Definir variável de ambiente GITHUB_TOKEN
# Defina a variável de ambiente GITHUB_TOKEN
python api.py
```
## Fluxo de Trabalho para Desenvolvimento
## Fluxo de Desenvolvimento
### Para Contribuidores de Conteúdo
1. **Faça um fork do repositório** para sua conta no GitHub
2. **Clone seu fork** localmente
3. **Crie um novo branch** para suas alterações
4. Faça alterações no conteúdo das aulas ou exemplos de código
5. Teste quaisquer mudanças de código nos diretórios relevantes do projeto
6. Envie pull requests seguindo as diretrizes de contribuição
1. **Fork o repositório** para sua conta no GitHub
2. **Clone seu fork** localmente
3. **Crie uma nova branch** para suas alterações
4. Faça mudanças no conteúdo das lições ou exemplos de código
5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes
6. Envie pull requests seguindo as diretrizes de contribuição
### Para Estudantes
### Para Aprendizes
1. Faça fork ou clone o repositório
2. Navegue pelas pastas das aulas sequencialmente
3. Leia os arquivos README de cada aula
4. Complete os questionários pré-aula em https://ff-quizzes.netlify.app/web/
5. Trabalhe nos exemplos de código nas pastas das aulas
6. Complete tarefas e desafios
7. Faça os questionários pós-aula
1. Faça fork ou clone do repositório
2. Navegue sequencialmente pelos diretórios das lições
3. Leia os arquivos README de cada lição
4. Complete os quizzes pré-lição em https://ff-quizzes.netlify.app/web/
5. Trabalhe nos exemplos de código nas pastas da lição
6. Complete as tarefas e desafios
7. Faça os quizzes pós-lição
### Desenvolvimento ao Vivo
- **Documentação**: Execute `docsify serve` na raiz (porta 3000)
- **Quiz App**: Execute `npm run dev` no diretório quiz-app
- **Projetos**: Use a extensão Live Server do VS Code para projetos HTML
- **Projetos API**: Execute `npm start` nos diretórios das APIs correspondentes
- **Documentação**: Rode `docsify serve` na raiz (porta 3000)
- **Quiz App**: Rode `npm run dev` no diretório quiz-app
- **Projetos**: Use a extensão Live Server do VS Code para projetos HTML
- **Projetos API**: Rode `npm start` nos diretórios das APIs respectivas
## Instruções de Teste
@ -110,8 +110,8 @@ python api.py
```bash
cd quiz-app
npm run lint # Verifique problemas de estilo de código
npm run build # Verifique se a compilação é bem-sucedida
npm run lint # Verificar problemas de estilo de código
npm run build # Verificar se a compilação foi bem-sucedida
```
### Teste da API Bancária
@ -122,82 +122,82 @@ npm run lint # Verificar problemas de estilo de código
node server.js # Verificar se o servidor inicia sem erros
```
### Abordagem Geral de Testes
### Abordagem Geral de Teste
- Este é um repositório educacional sem testes automatizados abrangentes
- Testes manuais focam em:
- Exemplos de código executam sem erros
- Links na documentação funcionam corretamente
- Builds dos projetos concluem com sucesso
- Exemplos seguem boas práticas
- Este é um repositório educacional sem testes automatizados abrangentes
- Teste manual foca em:
- Exemplos de código executando sem erros
- Links na documentação funcionando corretamente
- Builds dos projetos completando com sucesso
- Exemplos seguindo as melhores práticas
### Checagens Antes do Envio
### Checagens Pré-envio
- Execute `npm run lint` em diretórios com package.json
- Verifique se os links em markdown são válidos
- Teste exemplos de código no navegador ou Node.js
- Verifique se as traduções mantêm a estrutura correta
- Execute `npm run lint` em diretórios com package.json
- Verifique se os links markdown são válidos
- Teste exemplos de código no navegador ou Node.js
- Verifique que as traduções mantêm a estrutura adequada
## Diretrizes de Estilo de Código
### JavaScript
- Use sintaxe moderna ES6+
- Siga as configurações padrão do ESLint fornecidas nos projetos
- Use nomes de variáveis e funções significativos para clareza educacional
- Adicione comentários explicando conceitos para estudantes
- Formate usando Prettier onde configurado
- Use sintaxe moderna ES6+
- Siga as configurações padrão do ESLint fornecidas nos projetos
- Use nomes significativos para variáveis e funções para clareza educacional
- Adicione comentários explicando conceitos para os aprendizes
- Formate usando Prettier quando configurado
### HTML/CSS
- Elementos semânticos HTML5
- Princípios de design responsivo
- Convenções claras de nomenclatura de classes
- Comentários explicando técnicas CSS para estudantes
- Elementos semânticos HTML5
- Princípios de design responsivo
- Convenções claras de nomenclatura de classes
- Comentários explicando técnicas CSS para aprendizes
### Python
- Diretrizes de estilo PEP 8
- Exemplos claros e educacionais
- Anotações de tipo úteis para aprendizado
- Diretrizes de estilo PEP 8
- Exemplos de código claros e educacionais
- Dicas de tipo onde úteis para aprendizagem
### Documentação Markdown
### Documentação em Markdown
- Hierarquia clara de títulos
- Blocos de código com especificação de linguagem
- Links para recursos adicionais
- Capturas de tela e imagens nas pastas `images/`
- Texto alternativo para acessibilidade das imagens
- Hierarquia clara de títulos
- Blocos de código com especificação de linguagem
- Links para recursos adicionais
- Capturas de tela e imagens nas pastas `images/`
- Texto alternativo para imagens para acessibilidade
### Organização de Arquivos
- Aulas numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)
- Cada projeto possui diretórios `solution/` e frequentemente `start/` ou `your-work/`
- Imagens armazenadas em pastas específicas `images/` de cada aula
- Traduções na estrutura `translations/{language-code}/`
- Lições numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)
- Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/`
- Imagens armazenadas em pastas `images/` específicas da lição
- Traduções na estrutura `translations/{language-code}/`
## Build e Implantação
## Build e Deploy
### Implantação do Quiz App (Azure Static Web Apps)
### Deploy do Quiz App (Azure Static Web Apps)
O quiz-app está configurado para implantação no Azure Static Web Apps:
O quiz-app está configurado para deploy no Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Cria a pasta dist/
# Faz o deploy via workflow do GitHub Actions ao enviar para a branch main
# Implanta via workflow do GitHub Actions ao enviar para a branch main
```
Configuração do Azure Static Web Apps:
- **Localização do app**: `/quiz-app`
- **Localização de saída**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Configuração Azure Static Web Apps:
- **Localização da app**: `/quiz-app`
- **Localização de saída**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Geração de PDF da Documentação
```bash
npm install # Instale docsify-to-pdf
npm run convert # Gere PDF a partir do docs
npm install # Instalar docsify-to-pdf
npm run convert # Gerar PDF a partir do docs
```
### Documentação Docsify
@ -207,76 +207,76 @@ npm install -g docsify-cli # Instalar Docsify globalmente
docsify serve # Servir em localhost:3000
```
### Builds Específicos por Projeto
### Builds específicos de projetos
Cada diretório de projeto pode ter seu próprio processo de build:
- Projetos Vue: `npm run build` cria pacotes de produção
- Projetos estáticos: Sem passo de build, sirva os arquivos diretamente
Cada diretório de projeto pode ter seu próprio processo de build:
- Projetos Vue: `npm run build` cria bundles para produção
- Projetos estáticos: Sem etapa de build, servem arquivos diretamente
## Diretrizes para Pull Requests
### Formato do Título
Use títulos claros e descritivos indicando a área da mudança:
- `[Quiz-app] Adicionar novo quiz para a lição X`
- `[Lesson-3] Corrigir erro de digitação no projeto terrarium`
- `[Translation] Adicionar tradução para espanhol na lição 5`
- `[Docs] Atualizar instruções de configuração`
Use títulos claros e descritivos indicando a área de mudança:
- `[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`
### Verificações Necessárias
### Checagens Necessárias
Antes de enviar um PR:
1. **Qualidade do Código**:
- Execute `npm run lint` nos diretórios dos projetos afetados
- Corrija todos os erros e avisos do lint
1. **Qualidade do Código**:
- Rode `npm run lint` nos diretórios afetados
- Corrija todos os erros e avisos de lint
2. **Verificação do Build**:
- Execute `npm run build` se aplicável
- Garanta que não haja erros no build
2. **Verificação de Build**:
- Rode `npm run build` se aplicável
- Garanta que não ocorram erros no build
3. **Validação de Links**:
- Teste todos os links em markdown
- Verifique se referências de imagens funcionam
3. **Validação de Links**:
- Teste todos os links markdown
- Verifique referências a imagens
4. **Revisão do Conteúdo**:
- Revise ortografia e gramática
- Assegure que exemplos de código estão corretos e educacionais
- Verifique se traduções mantêm o significado original
4. **Revisão de Conteúdo**:
- Revise ortografia e gramática
- Assegure que exemplos de código estão corretos e educativos
- Verifique que as traduções mantêm o significado original
### Requisitos para Contribuição
### Requisitos de Contribuição
- Aceitar a CLA da Microsoft (verificação automática no primeiro PR)
- Seguir o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Ver [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
- Referenciar números de issues na descrição do PR, se aplicável
- Aceite o CLA da Microsoft (verificação automática no primeiro PR)
- Siga o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Veja [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
- Referencie números de issues na descrição do PR, se aplicável
### Processo de Revisão
- PRs revisados por mantenedores e comunidade
- Clareza educacional é priorizada
- Exemplos de código devem seguir melhores práticas atuais
- Traduções revisadas quanto a precisão e adequação cultural
- PRs são revisados por mantenedores e comunidade
- Clareza educacional tem prioridade
- Exemplos de código devem seguir melhores práticas atuais
- Traduções revisadas quanto à precisão e adequação cultural
## Sistema de Tradução
### Tradução Automatizada
- Usa GitHub Actions com workflow co-op-translator
- Traduz automaticamente para mais de 50 idiomas
- Arquivos fonte nos diretórios principais
- Arquivos traduzidos em `translations/{language-code}/`
- Usa GitHub Actions com workflow co-op-translator
- Traduz para mais de 50 idiomas automaticamente
- Arquivos originais nos diretórios principais
- Arquivos traduzidos em `translations/{language-code}/`
### Adicionando Melhorias Manuais na Tradução
### Adicionando Melhorias Manuais nas Traduções
1. Localize o arquivo em `translations/{language-code}/`
2. Faça melhorias preservando a estrutura
3. Certifique-se que exemplos de código continuam funcionais
4. Teste qualquer conteúdo localizado dos quizzes
1. Localize o arquivo em `translations/{language-code}/`
2. Faça melhorias preservando a estrutura
3. Garanta que exemplos de código permanecem funcionais
4. Teste qualquer conteúdo de quiz localizado
### Metadados da Tradução
### Metadados de Tradução
Arquivos traduzidos incluem cabeçalho de metadados:
Arquivos traduzidos incluem cabeçalho de metadados:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Problemas Comuns
**Quiz app não inicia**:
- Verifique a versão do Node.js (recomendado v14+)
- Apague `node_modules` e `package-lock.json`, execute `npm install` novamente
- Verifique conflitos de porta (padrão: Vite usa porta 5173)
**O quiz app não inicia**:
- Verifique a versão do Node.js (recomendado v14+)
- Apague `node_modules` e `package-lock.json`, rode `npm install` novamente
- Verifique conflitos de portas (padrão: Vite usa porta 5173)
**Servidor API não inicia**:
- Confirme que Node.js atende o mínimo (node >=10)
- Verifique se a porta já não está em uso
- Garanta que todas as dependências estejam instaladas com `npm install`
**Servidor API não inicia**:
- Confirme a versão mínima do Node.js (node >=10)
- Verifique se a porta não está em uso
- Garanta que todas as dependências foram instaladas com `npm install`
**Extensão do navegador não carrega**:
- Verifique se o manifest.json está formatado corretamente
- Confira o console do navegador para erros
- Siga as instruções específicas para instalação da extensão no navegador
**Extensão de navegador não carrega**:
- Verifique se o manifest.json está formatado corretamente
- Verifique erros no console do navegador
- Siga as instruções específicas de instalação da extensão para o navegador
**Problemas no projeto de chat Python**:
- Assegure que o pacote OpenAI está instalado: `pip install openai`
- Verifique se a variável de ambiente GITHUB_TOKEN está definida
- Confirme permissões de acesso aos GitHub Models
**Problemas no projeto de chat Python**:
- Certifique-se que o pacote OpenAI está instalado: `pip install openai`
- Verifique se a variável de ambiente GITHUB_TOKEN está definida
- Confirme as permissões de acesso ao GitHub Models
**Docsify não serve a documentação**:
- Instale globalmente o docsify-cli: `npm install -g docsify-cli`
- Execute a partir do diretório raiz do repositório
- Verifique se o arquivo `docs/_sidebar.md` existe
**Docsify não serve a documentação**:
- Instale docsify-cli globalmente: `npm install -g docsify-cli`
- Rode a partir do diretório raiz do repositório
- Confira se `docs/_sidebar.md` existe
### Dicas para Ambiente de Desenvolvimento
- Use VS Code com a extensão Live Server para projetos HTML
- Instale extensões ESLint e Prettier para formatação consistente
- Use DevTools do navegador para depurar JavaScript
- Para projetos Vue, instale a extensão Vue DevTools no navegador
- Use VS Code com extensão Live Server para projetos HTML
- Instale as extensões ESLint e Prettier para formatação consistente
- Use DevTools do navegador para depurar JavaScript
- Para projetos Vue, instale a extensão Vue DevTools para navegador
### Considerações de Performance
- Grande número de arquivos traduzidos (mais de 50 idiomas) torna clones completos grandes
- Use clone superficial se trabalhar somente com conteúdo: `git clone --depth 1`
- Exclua traduções das buscas ao trabalhar com conteúdo em inglês
- Processos de build podem ser lentos na primeira execução (npm install, build Vite)
- Grande número de arquivos traduzidos (50+ idiomas) torna clones completos grandes
- Use clone raso se estiver trabalhando apenas no conteúdo: `git clone --depth 1`
- Exclua traduções das buscas ao trabalhar no conteúdo em inglês
- Processos de build podem ser lentos na primeira execução (npm install, build Vite)
## Considerações de Segurança
### Variáveis de Ambiente
- Chaves de API nunca devem ser commitadas no repositório
- Use arquivos `.env` (já no `.gitignore`)
- Documente variáveis de ambiente necessárias nos README dos projetos
- Chaves de API nunca devem ser commitadas no repositório
- Use arquivos `.env` (já listados no `.gitignore`)
- Documente variáveis de ambiente necessárias nos READMEs dos projetos
### Projetos Python
- Use ambientes virtuais: `python -m venv venv`
- Mantenha dependências atualizadas
- Tokens do GitHub devem ter permissões mínimas necessárias
- Use ambientes virtuais: `python -m venv venv`
- Mantenha as dependências atualizadas
- Tokens GitHub devem ter permissões mínimas necessárias
### Acesso aos GitHub Models
### Acesso GitHub Models
- Tokens de Acesso Pessoal (PAT) são necessários para GitHub Models
- Armazene tokens como variáveis de ambiente
- Nunca faça commit de tokens ou credenciais
- Tokens de Acesso Pessoal (PAT) são exigidos para GitHub Models
- Os tokens devem ser armazenados como variáveis de ambiente
- Nunca commit tokens ou credenciais
## Notas Adicionais
### Público-Alvo
### Público-alvo
- Iniciantes completos em desenvolvimento web
- Estudantes e autodidatas
- Professores usando o currículo em salas de aula
- Conteúdo projetado para acessibilidade e construção gradual de habilidades
- Iniciantes completos em desenvolvimento web
- Estudantes e autodidatas
- Professores utilizando o currículo em salas de aula
- Conteúdo desenhado para acessibilidade e construção gradual de habilidades
### Filosofia Educacional
- Abordagem de aprendizado baseado em projetos
- Verificações frequentes de conhecimento (quizzes)
- Exercícios práticos de codificação
- Exemplos de aplicação no mundo real
- Foco nos fundamentos antes de frameworks
- Abordagem de aprendizado baseada em projetos
- Verificações frequentes de conhecimento (quizzes)
- Exercícios práticos de codificação
- Exemplos de aplicação no mundo real
- Foco em fundamentos antes de frameworks
### Manutenção do Repositório
- Comunidade ativa de aprendizes e contribuidores
- Atualizações regulares de dependências e conteúdo
- Issues e discussões monitoradas por mantenedores
- Atualizações de tradução automatizadas via GitHub Actions
- Comunidade ativa de aprendizes e contribuintes
- Atualizações regulares em dependências e conteúdo
- Issues e discussões monitoradas por mantenedores
- Atualizações de tradução automatizadas via GitHub Actions
### Recursos Relacionados
- [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)
- [Recursos do Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para estudantes
- Cursos adicionais: AI Generativa, Ciência de Dados, ML, IoT disponíveis
- [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)
- [Recursos Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendizes
- Cursos adicionais: AI Generativa, Ciência de Dados, ML, currículos IoT disponíveis
### Trabalhando com Projetos Específicos
Para instruções detalhadas sobre projetos individuais, consulte os arquivos README em:
- `quiz-app/README.md` - aplicação de quiz Vue 3
- `7-bank-project/README.md` - aplicativo bancário com autenticação
- `5-browser-extension/README.md` - desenvolvimento de extensão de navegador
- `6-space-game/README.md` - desenvolvimento de jogo baseado em canvas
- `9-chat-project/README.md` - projeto assistente de chat com IA
Para instruções detalhadas sobre projetos individuais, consulte os arquivos README em:
- `quiz-app/README.md` - Aplicação de quiz Vue 3
- `7-bank-project/README.md` - Aplicação bancária com autenticação
- `5-browser-extension/README.md` - Desenvolvimento de extensão de navegador
- `6-space-game/README.md` - Desenvolvimento de jogo baseado em canvas
- `9-chat-project/README.md` - Projeto assistente de chat IA
### Estrutura Monorepo
Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes:
- Cada aula é autossuficiente
- Projetos não compartilham dependências
- Trabalhe em projetos individuais sem afetar outros
- Clone o repositório completo para a experiência do curso completo
Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes:
- Cada lição é autocontida
- Projetos não compartilham dependências
- Trabalhe em projetos individuais sem afetar outros
- Faça clone do repositório completo para experiência total do currículo
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Aviso Legal**:
Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.
Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, por favor, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

2
translations/pt-PT/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:39:35+00:00",
"translation_date": "2026-04-20T15:49:55+00:00",
"source_file": "AGENTS.md",
"language_code": "pt-PT"
},

240
translations/pt-PT/AGENTS.md
Unescape View File

@ -2,13 +2,13 @@
## Visão Geral do Projeto
Este é um repositório de currículo educativo para ensinar os fundamentos do desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 lições práticas que cobrem JavaScript, CSS e HTML.
Este é um repositório de currículo educativo para ensinar fundamentos do desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, apresentando 24 lições práticas que cobrem JavaScript, CSS e HTML.
### Componentes Principais
- **Conteúdo Educativo**: 24 lições estruturadas organizadas em módulos baseados em projetos
- **Projetos Práticos**: Terrário, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat de IA
- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré e pós-lição)
- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat IA
- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré/pós-lição)
- **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions
- **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA)
@ -16,8 +16,8 @@ Este é um repositório de currículo educativo para ensinar os fundamentos do d
- Repositório educativo com estrutura baseada em lições
- Cada pasta de lição contém README, exemplos de código e soluções
- Projetos autónomos em diretórios separados (quiz-app, vários projetos de lições)
- Sistema de tradução utilizando GitHub Actions (co-op-translator)
- Projetos independentes em diretórios separados (quiz-app, vários projetos de lição)
- Sistema de tradução usando GitHub Actions (co-op-translator)
- Documentação servida via Docsify e disponível em PDF
## Comandos de Configuração
@ -31,7 +31,7 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Configuração da Quiz App (Vue 3 + Vite)
### Configuração do Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
@ -59,12 +59,12 @@ npm install
# Siga as instruções específicas do navegador para carregar extensões
```
### Projetos do Jogo Espacial
### Projetos de Jogo Espacial
```bash
cd 6-space-game/solution
npm install
# Abra index.html no navegador ou use Live Server
# Abra index.html no navegador ou use o Live Server
```
### Projeto de Chat (Backend em Python)
@ -72,7 +72,7 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Definir a variável de ambiente GITHUB_TOKEN
# Definir variável de ambiente GITHUB_TOKEN
python api.py
```
@ -80,41 +80,41 @@ python api.py
### Para Contribuidores de Conteúdo
1. **Faça fork do repositório** para sua conta GitHub
1. **Faça fork do repositório** na sua conta GitHub
2. **Clone o seu fork** localmente
3. **Crie uma nova branch** para suas alterações
4. Faça alterações no conteúdo das lições ou nos exemplos de código
5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes
3. **Crie uma nova branch** para as suas alterações
4. Faça alterações no conteúdo da lição ou nos exemplos de código
5. Teste quaisquer alterações de código nos diretórios de projeto relevantes
6. Submeta pull requests seguindo as diretrizes de contribuição
### Para Aprendizes
1. Fork ou clone o repositório
2. Navegue pelas pastas das lições sequencialmente
1. Faça fork ou clone o repositório
2. Navegue sequencialmente pelos diretórios das lições
3. Leia os ficheiros README de cada lição
4. Complete os questionários pré-lição em https://ff-quizzes.netlify.app/web/
5. Trabalhe nos exemplos de código nas pastas das lições
6. Complete tarefas e desafios
7. Faça os questionários pós-lição
4. Complete os quizzes pré-lição em https://ff-quizzes.netlify.app/web/
5. Trabalhe os exemplos de código nas pastas das lições
6. Complete trabalhos e desafios
7. Realize os quizzes pós-lição
### Desenvolvimento em Tempo Real
### Desenvolvimento ao Vivo
- **Documentação**: Execute `docsify serve` na raiz (porta 3000)
- **Quiz App**: Execute `npm run dev` na pasta quiz-app
- **Quiz App**: Execute `npm run dev` no diretório quiz-app
- **Projetos**: Use a extensão Live Server do VS Code para projetos HTML
- **Projetos API**: Execute `npm start` nos respetivos diretórios API
- **Projetos API**: Execute `npm start` nos diretórios API respetivos
## Instruções de Testes
## Instruções de Teste
### Testes da Quiz App
### Teste do Quiz App
```bash
cd quiz-app
npm run lint # Verificar problemas de estilo de código
npm run build # Verificar se a compilação tem sucesso
npm run build # Verificar se a compilação é bem-sucedida
```
### Testes da API Bancária
### Teste da API Bancária
```bash
cd 7-bank-project/api
@ -124,73 +124,73 @@ node server.js # Verificar se o servidor inicia sem erros
### Abordagem Geral de Testes
- Este é um repositório educativo sem testes automáticos abrangentes
- Testes manuais focam em:
- Exemplos de código executam sem erros
- Este é um repositório educativo sem testes automatizados abrangentes
- O teste manual foca-se em:
- Exemplos de código que executam sem erros
- Links na documentação funcionam corretamente
- Construções dos projetos completam com sucesso
- Exemplos seguem as melhores práticas
- Builds dos projetos completam com sucesso
- Exemplos seguem as boas práticas
### Verificações Pré-envio
### Verificações Pré-Submissão
- Execute `npm run lint` nas pastas com package.json
- Verifique se os links markdown são válidos
- Teste os exemplos de código no navegador ou Node.js
- Confirme que as traduções mantêm a estrutura correta
- Execute `npm run lint` nos diretórios com package.json
- Verifique que os links markdown são válidos
- Teste exemplos de código no navegador ou Node.js
- Confirme que as traduções mantêm a estrutura adequada
## Diretrizes de Estilo de Código
### JavaScript
- Use sintaxe moderna ES6+
- Siga as configurações padrão ESLint fornecidas nos projetos
- Use nomes de variáveis e funções significativos para clareza educativa
- Adicione comentários explicando conceitos para os aprendizes
- Formate usando Prettier onde configurado
- Siga as configurações padrão do ESLint fornecidas nos projetos
- Use nomes significativos de variáveis e funções para clareza educativa
- Adicione comentários explicativos para os conceitos
- Formate com Prettier onde estiver configurado
### HTML/CSS
- Elementos semânticos HTML5
- Princípios de design responsivo
- Convenções claras de nomenclatura de classes
- Comentários explicando técnicas CSS para os aprendizes
- Convenções claras de nomeação de classes
- Comentários explicando técnicas CSS para aprendizes
### Python
- Diretrizes de estilo PEP 8
- Exemplos de código claros e educativos
- Anotações de tipos onde úteis para o aprendizado
- Anotações de tipo onde ajudarem na aprendizagem
### Documentação Markdown
- Hierarquia clara de títulos
- Blocos de código com especificação da linguagem
- Blocos de código com especificação de linguagem
- Links para recursos adicionais
- Capturas de tela e imagens nas pastas `images/`
- Capturas de ecrã e imagens nas pastas `images/`
- Texto alternativo para imagens para acessibilidade
### Organização de Ficheiros
- Lições numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)
- Cada projeto possui diretórios `solution/` e frequentemente `start/` ou `your-work/`
- Imagens armazenadas em pastas `images/` específicas de cada lição
- Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/`
- Imagens guardadas nas pastas `images/` específicas da lição
- Traduções em estrutura `translations/{language-code}/`
## Construção e Deploy
## Construção e Implementação
### Deploy da Quiz App (Azure Static Web Apps)
### Deploy do Quiz App (Azure Static Web Apps)
A quiz-app está configurada para deployment em Azure Static Web Apps:
O quiz-app está configurado para deploy em Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Cria a pasta dist/
# Faz o deploy através do workflow do GitHub Actions ao fazer push para a main
# Faz o deploy através do fluxo de trabalho do GitHub Actions ao fazer push para a main
```
Configuração Azure Static Web Apps:
- **Localização da app**: `/quiz-app`
- **Localização da saída**: `dist`
- **Localização de saída**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Geração de PDF da Documentação
@ -203,11 +203,11 @@ npm run convert # Gerar PDF a partir do docs
### Documentação Docsify
```bash
npm install -g docsify-cli # Instalar o Docsify globalmente
npm install -g docsify-cli # Instalar Docsify globalmente
docsify serve # Servir em localhost:3000
```
### Builds Específicos de Projetos
### Builds Específicos por Projeto
Cada diretório de projeto pode ter seu próprio processo de build:
- Projetos Vue: `npm run build` cria bundles para produção
@ -217,62 +217,62 @@ Cada diretório de projeto pode ter seu próprio processo de build:
### Formato do Título
Use títulos claros e descritivos indicando a área da alteração:
- `[Quiz-app] Adicionar novo quiz para a lição X`
Use títulos claros e descritivos indicativos da área de alteração:
- `[Quiz-app] Adicionar novo quiz para lição X`
- `[Lesson-3] Corrigir erro tipográfico no projeto terrarium`
- `[Translation] Adicionar tradução em espanhol para a lição 5`
- `[Translation] Adicionar tradução para espanhol na lição 5`
- `[Docs] Atualizar instruções de configuração`
### Verificações Obrigatórias
### Verificações Necessárias
Antes de submeter um PR:
1. **Qualidade de Código**:
- Execute `npm run lint` nos diretórios dos projetos afetados
- Corrija todos os erros e avisos de linting
1. **Qualidade do Código**:
- Execute `npm run lint` nos diretórios de projeto afetados
- Corrija todos os erros e avisos de lint
2. **Verificação de Build**:
2. **Verificação do Build**:
- Execute `npm run build` se aplicável
- Assegure que não existem erros no build
- Garanta ausência de erros no build
3. **Validação de Links**:
- Teste todos os links de markdown
- Verifique referências de imagens funcionais
- Teste todos os links markdown
- Verifique referências de imagens
4. **Revisão de Conteúdo**:
- Revise ortografia e gramática
- Confirme que exemplos de código estão corretos e educativos
- Verifique que traduções mantêm o significado original
- Confirme que os exemplos de código estão corretos e educativos
- Verifique que as traduções mantêm o significado original
### Requisitos de Contribuição
- Aceitar o CLA da Microsoft (verificação automática no 1.º PR)
- Seguir o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Ver [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
- Concordar com o CLA da Microsoft (verificação automática no primeiro PR)
- Seguir o [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Consultar [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
- Referenciar números de issues na descrição do PR, se aplicável
### Processo de Revisão
- PRs são revistos pelos mantenedores e comunidade
- Clareza educativa é prioritária
- PRs revistos por mantenedores e comunidade
- Clareza educativa é prioridade
- Exemplos de código devem seguir as melhores práticas atuais
- Traduções são revistas para precisão e adequação cultural
- Traduções revisadas quanto a exatidão e adequação cultural
## Sistema de Tradução
### Tradução Automática
- Usa GitHub Actions com workflow co-op-translator
- Tradução automática para mais de 50 idiomas
- Ficheiros originais nos diretórios principais
- Traduz para mais de 50 idiomas automaticamente
- Ficheiros fonte nos diretórios principais
- Ficheiros traduzidos em `translations/{language-code}/`
### Adicionar Melhorias Manuais às Traduções
### Adição de Melhorias Manuais de Tradução
1. Localize o ficheiro em `translations/{language-code}/`
2. Faça melhorias mantendo a estrutura
3. Assegure que exemplos de código continuam funcionais
4. Teste qualquer conteúdo local de quiz
2. Faça melhorias preservando a estrutura
3. Garanta que exemplos de código permanecem funcionais
4. Teste qualquer conteúdo de quizzes localizado
### Metadados de Tradução
@ -293,64 +293,64 @@ CO_OP_TRANSLATOR_METADATA:
### Problemas Comuns
**Quiz app não inicia**:
- Verifique versão do Node.js (recomendado v14+)
**App do Quiz não inicia**:
- Verifique a versão do Node.js (recomendado v14+)
- Apague `node_modules` e `package-lock.json`, execute `npm install` novamente
- Verifique conflitos de porta (padrão: Vite usa porta 5173)
**Servidor API não inicia**:
- Confirme que versão do Node.js é mínima (node >=10)
- Confirme que a versão do Node.js é mínima (node >=10)
- Verifique se a porta já está em uso
- Assegure que todas as dependências estão instaladas com `npm install`
- Certifique-se de que todas as dependências foram instaladas com `npm install`
**Extensão do navegador não carrega**:
- Verifique se o manifest.json está corretamente formatado
- Consulte a consola do navegador para erros
- Siga instruções específicas do navegador para instalação da extensão
**Extensão de navegador não carrega**:
- Verifique se o manifest.json está formatado corretamente
- Consulte o console do navegador para erros
- Siga as instruções específicas do navegador para instalação de extensões
**Problemas no projeto de chat em Python**:
- Assegure que o pacote OpenAI está instalado: `pip install openai`
- Verifique variável de ambiente GITHUB_TOKEN definida
- Verifique permissões de acesso do GitHub Models
- Certifique-se de que o pacote OpenAI está instalado: `pip install openai`
- Verifique se a variável de ambiente GITHUB_TOKEN está definida
- Confirme as permissões de acesso aos GitHub Models
**Docsify não serve documentação**:
- Instale docsify-cli globalmente: `npm install -g docsify-cli`
- Execute a partir do diretório raiz do repositório
- Verifique que `docs/_sidebar.md` existe
- Execute desde o diretório raiz do repositório
- Verifique se `docs/_sidebar.md` existe
### Dicas de Ambiente de Desenvolvimento
### Dicas para o Ambiente de Desenvolvimento
- Use VS Code com extensão Live Server para projetos HTML
- Use VS Code com a extensão Live Server para projetos HTML
- Instale extensões ESLint e Prettier para formatação consistente
- Use DevTools do navegador para depurar JavaScript
- Para projetos Vue, instale extensão Vue DevTools no navegador
- Utilize DevTools do navegador para depurar JavaScript
- Para projetos Vue, instale a extensão Vue DevTools no navegador
### Considerações de Performance
- Grande número de ficheiros traduzidos (mais de 50 idiomas) torna clones completos grandes
- Grande quantidade de ficheiros traduzidos (50+ idiomas) torna os clones completos pesados
- Use clone superficial se trabalhar apenas com conteúdo: `git clone --depth 1`
- Exclua traduções de pesquisas ao trabalhar no conteúdo em inglês
- Exclua traduções de pesquisas ao trabalhar com conteúdo em inglês
- Processos de build podem ser lentos na primeira execução (npm install, build Vite)
## Considerações de Segurança
### Variáveis de Ambiente
- Chaves de API nunca devem ser commitadas no repositório
- Use ficheiros `.env` (já em `.gitignore`)
- Documente variáveis de ambiente requeridas nos READMEs do projeto
- Chaves API nunca devem ser commitadas no repositório
- Use ficheiros `.env` (já listados no `.gitignore`)
- Documente as variáveis de ambiente necessárias nos READMEs dos projetos
### Projetos em Python
### Projetos Python
- Use ambientes virtuais: `python -m venv venv`
- Utilize ambientes virtuais: `python -m venv venv`
- Mantenha dependências atualizadas
- Tokens GitHub devem ter permissões mínimas necessárias
### Acesso a GitHub Models
### Acesso aos GitHub Models
- Necessários Personal Access Tokens (PAT) para GitHub Models
- Tokens devem ser guardados como variáveis de ambiente
- Nunca comite tokens ou credenciais
- São necessários tokens de acesso pessoal (PAT) para GitHub Models
- Armazene os tokens como variáveis de ambiente
- Nunca faça commit de tokens ou credenciais
## Notas Adicionais
@ -358,22 +358,22 @@ CO_OP_TRANSLATOR_METADATA:
- Iniciantes completos em desenvolvimento web
- Estudantes e autodidatas
- Professores a usar o currículo em salas de aula
- Conteúdo desenhado para acessibilidade e desenvolvimento gradual de competências
- Professores que usam o currículo em sala de aula
- Conteúdo desenhado para acessibilidade e construção gradual de competências
### Filosofia Educativa
- Abordagem baseada em projetos
- Verificações frequentes de conhecimento (quizzes)
- Abordagem de aprendizagem baseada em projetos
- Verificação frequente do conhecimento (quizzes)
- Exercícios práticos de codificação
- Exemplos de aplicação no mundo real
- Exemplos de aplicação real
- Foco nos fundamentos antes dos frameworks
### Manutenção do Repositório
- Comunidade ativa de aprendizes e contribuidores
- Atualizações regulares de dependências e conteúdo
- Issues e discussões monitorizadas pelos mantenedores
- Issues e discussões monitorizadas por mantenedores
- Atualizações de tradução automatizadas via GitHub Actions
### Recursos Relacionados
@ -381,7 +381,7 @@ CO_OP_TRANSLATOR_METADATA:
- [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)
- [Recursos do Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendizes
- Cursos adicionais: Currículos de IA Generativa, Ciência de Dados, ML, IoT disponíveis
- Cursos adicionais: AI Generativa, Ciência de Dados, ML, IoT disponíveis
### Trabalhar com Projetos Específicos
@ -389,20 +389,20 @@ Para instruções detalhadas sobre projetos individuais, consulte os ficheiros R
- `quiz-app/README.md` - Aplicação de quiz Vue 3
- `7-bank-project/README.md` - Aplicação bancária com autenticação
- `5-browser-extension/README.md` - Desenvolvimento de extensão de navegador
- `6-space-game/README.md` - Desenvolvimento de jogo em Canvas
- `9-chat-project/README.md` - Projeto assistente de chat IA
- `6-space-game/README.md` - Desenvolvimento de jogo em canvas
- `9-chat-project/README.md` - Projeto de assistente de chat IA
### Estrutura Monorepo
Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes:
- Cada lição é autónoma
- Cada lição é autocontida
- Projetos não partilham dependências
- Trabalhe em projetos individuais sem afetar os outros
- Clone o repositório completo para a experiência total do currículo
- Trabalhe em projetos individuais sem afetar outros
- Clone todo o repositório para a experiência completa do currículo
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Aviso Legal**:
Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.
Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte oficial. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save