@ -1,28 +1,28 @@
# AGENTS.md
# AGENTS.md
## منصوبے کا جائزہ
## پروجیکٹ کا جائزہ
یہ ویب ڈویلپمنٹ کی بنیادی باتیں سکھانے کے لیے ابتدائیوں کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع ۱۲ ہفتوں کا کورس ہے جو Microsoft Cloud Advocates نے تیار کیا ہے، جس میں جاوا اسکرپٹ، CSS، اور HTML پر مشتمل ۲۴ عملی اسباق شامل ہیں۔
یہ ویب ڈیولپمنٹ کے بنیادی اصولوں کی تعلیم کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے جو مبتدیوں کے لیے ہے۔ یہ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کے ذریعہ تیار کردہ ایک جامع 12 ہفتوں کا کورس ہے، جس میں 24 عملی اسباق شامل ہیں جو جاوا اسکرپٹ، CSS، اور HTML کا احاطہ کرتے ہیں۔
### کلیدی اجزاء
### کلیدی اجزاء
- ** تعلیمی مواد**: ۲۴ منظم اسباق جو پروجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں
- ** تعلیمی مواد**: 24 منظم اسباق جو پروجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں
- ** عملی پروجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بنکنگ ایپ، کوڈ ایڈیٹر، اور AI چیٹ اسسٹنٹ
- ** عملی پروجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بی نکنگ ایپ، کوڈ ایڈیٹر، اور AI چیٹ اسسٹنٹ
- ** انٹرایکٹو کوئزز**: ۴۸ کوئزز، ہر ایک میں ۳ سوالات (سبق کے پہلے اور بعد میں تشخیص)
- ** انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے/بعد کے جائزے)
- ** کثیرالزبان معاونت**: GitHub Actions کے ذریعہ 50+ زبانوں میں خودکار ترجمے
- ** کثیر لسانی معاونت**: GitHub Actions کے ذریعے 50+ زبانوں کے لیے خودکار تراجم
- ** ٹیکنالوجیز**: HTML، CSS، جاوا اسکرپٹ ، Vue.js 3، Vite، Node.js، Express، Python (AI پروجیکٹس کے لیے)
- ** تکنالوجیز**: HTML، CSS، JavaScript ، Vue.js 3، Vite، Node.js، Express، Python (AI پروجیکٹس کے لیے)
### آرکیٹیکچ ر
### فن تعمی ر
- سبق پر مبنی ڈھانچہ کے ساتھ تعلیمی ذخیرہ
- سبق کی بنیاد پر تعلیمی ذخیرہ
- ہر سبق کے فولڈر میں README، کوڈ مثالیں، اور حل شامل ہیں
- ہر سبق فولڈر میں README، کوڈ کے نمونے اور حل شامل ہیں
- الگ الگ ڈائریکٹریز میں اسٹینڈ الون پروجیکٹس (quiz-app، مختلف سبق کے پروجیکٹس)
- علیحدہ ڈائریکٹریز میں آزاد پروجیکٹس (quiz-app، مختلف سبق کے پروجیکٹس)
- GitHub Actions استعمال کرتے ہوئے ترجمہ جات کا نظام (co-op-translator)
- ترجمہ کا نظام GitHub Actions (co-op-translator) استعمال کرتا ہے
- Docsify کے ذریعے دستاویزات فراہم کی جاتی ہیں اور PDF کے طور پر دستیاب ہیں
- دستاویزات Docsify کے ذریعے فراہم کی جاتی ہیں اور PDF کے طور پر دستیاب ہیں
## سیٹ اپ کمانڈز
## سیٹ اپ کمانڈز
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس کے ساتھ کام کرنے کے لیے:
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس پر کام کرنے کے لیے:
### مرکزی ذخیرہ سیٹ اپ
### مرکزی ذخیرہ سیٹ اپ
@ -36,19 +36,19 @@ cd Web-Dev-For-Beginners
```bash
```bash
cd quiz-app
cd quiz-app
npm install
npm install
npm run dev # ڈو یلپمنٹ سرور شروع کریں
npm run dev # ڈیو لپمنٹ سرور شروع کریں
npm run build # پیداوار کے لیے بنائ یں
npm run build # پروڈکشن کے لیے تیار کر یں
npm run lint # ESLint چلائیں
npm run lint # ESLint چلائیں
```
```
### بنک پروجیکٹ API (Node.js + Express)
### بی نک پروجیکٹ API (Node.js + Express)
```bash
```bash
cd 7-bank-project/api
cd 7-bank-project/api
npm install
npm install
npm start # اے پی آئی سرور شروع کریں
npm start # API سرور شروع کریں
npm run lint # ای ایس لِنٹ چلائیں
npm run lint # ESLint چلائیں
npm run format # پریٹیئر کے ساتھ فارمیٹ کریں
npm run format # Prettier کے ساتھ فارمیٹ کریں
```
```
### براؤزر ایکسٹینشن پروجیکٹس
### براؤزر ایکسٹینشن پروجیکٹس
@ -56,7 +56,7 @@ npm run format # پریٹیئر کے ساتھ فارمیٹ کریں
```bash
```bash
cd 5-browser-extension/solution
cd 5-browser-extension/solution
npm install
npm install
# مخصوص براؤزر کی توسیع لوڈ کرنے کی ہدایات پر عمل کریں
# مخصوص براؤزر کے لیے ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں
```
```
### اسپیس گیم پروجیکٹس
### اسپیس گیم پروجیکٹس
@ -64,15 +64,15 @@ npm install
```bash
```bash
cd 6-space-game/solution
cd 6-space-game/solution
npm install
npm install
# index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں
# براؤزر میں index.html کھولیں یا Live Server استعمال کریں
```
```
### چیٹ پروجیکٹ (Python بیک اینڈ )
### چیٹ پروجیکٹ (Python Backend )
```bash
```bash
cd 9-chat-project/solution/backend/python
cd 9-chat-project/solution/backend/python
pip install openai
pip install openai
# GITHUB_TOKEN ماحول کی متغیر مقرر کریں
# GITHUB_TOKEN ماحول کا
python api.py
python api.py
```
```
@ -80,203 +80,203 @@ python api.py
### مواد فراہم کرنے والوں کے لیے
### مواد فراہم کرنے والوں کے لیے
1. ** ذخیرہ کو فورک کریں** اپنے GitHub اکاؤنٹ پر
1. اپنے GitHub اکاؤنٹ میں ذخیرہ کی فورک کریں
2. ** اپنے فورک کو لوکل کلون کریں**
2. اپنی فورک کا کلون لوکل کریں
3. ** ایک نیا **
3. اپنی تبدیلیوں کے لیے نئ ی برانچ بنائیں
4. سبق کے مواد یا کوڈ مثالوں میں تبدیلی کریں
4. سبق کے مواد یا کوڈ کی مثالوں میں تبدیلی کریں
5. متعلقہ پروجیکٹ ڈائریکٹریز میں کسی بھی کوڈ تبدیلی کی جانچ کریں
5. متعلقہ پروجیکٹ ڈائریکٹریز میں کوڈ کی تبدیلیوں کا ٹیسٹ کریں
6. تعاون کی ہدایتوں کے مطابق پل ریکویسٹ جمع کروائیں
6. تعاون کی رہنمائی کے مطابق پل ریکویسٹ جمع کروائیں
### سیکھنے والوں کے لیے
### سیکھنے والوں کے لیے
1. ذخیرہ فورک یا کلون کریں
1. ذخیرہ کو فورک یا کلون کریں
2. سبق کی ڈائریکٹریز متواتر ملاحظہ کریں
2. سبق کی ڈائریکٹریز میں تسلسل کے ساتھ جائیں
3. ہر سبق کی README فائل پڑھیں
3. ہر سبق کی README فائلز پڑھیں
4. سبق سے پہلے کی کوئزز مکمل کریں https://ff-quizzes.netlify.app/web/
4. سبق سے پہلے کے کوئزز پورے کریں https://ff-quizzes.netlify.app/web/
5. سبق کے فولڈرز میں کوڈ مثالوں پر کام کریں
5. سبق کے فولڈرز میں کوڈ کی مثالوں پر کام کریں
6. اسائنمنٹس اور چیلنجز مکمل کریں
6. تفویضات اور چیلنجز مکمل کریں
7. سبق کے بعد کی کوئزز لیں
7. سبق کے بعد کے کوئزز لیں
### لائیو ڈیولپمنٹ
### لائیو ترقی
- ** دستاویزات**: جڑ فولڈر میں `docsify serve` چلائیں (پورٹ 3000)
- ** دستاویزات**: روٹ میں `docsify serve` چلائیں (پورٹ 3000)
- ** کوئز ایپ**: کوئز ایپ فولڈر میں `npm run dev` چلائیں
- ** کوئز ایپ**: `quiz-app` ڈائریکٹری میں `npm run dev` چلائیں
- ** پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- ** پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- **API پروجیکٹس** : متعلقہ API ڈائ ریکٹری ز میں `npm start` چلائیں
- **API پروجیکٹس** : متعلقہ API فول ڈرز میں `npm start` چلائیں
## جانچ کے ہدایات
## ٹیسٹنگ کی ہدایات
### کوئز ایپ کی جانچ
### کوئز ایپ ٹیسٹنگ
```bash
```bash
cd quiz-app
cd quiz-app
npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں
npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں
npm run build # تصدیق کریں کہ بلڈ کامیاب ہوا
npm run build # تعمیری کامیابی کی تصدیق کریں
```
```
### بنک API کی جانچ
### بینک API ٹیسٹنگ
```bash
```bash
cd 7-bank-project/api
cd 7-bank-project/api
npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں
npm run lint # کوڈ کی طرز کے مسائل کی جانچ کریں
node server.js # یقینی بنائیں کہ سرور بغیر غلطیوں کے شروع ہو رہ ا
node server.js # تصدیق کریں کہ سرور بغیر کسی غلطی کے شروع ہوت ا
```
```
### عمومی جانچ کا طریقہ
### عمومی ٹیسٹنگ کا طریقہ کار
- یہ تعلیمی ذخیرہ ہے، ا س میں مکمل خودکار ٹیسٹ نہیں ہیں
- یہ ایک تعلیمی ذخیرہ ہے ج س میں مکمل خودکار ٹیسٹ نہیں ہیں
- دستی جانچ پر توجہ مرکوز ہے:
- دستی ٹیسٹنگ پر توجہ مرکوز ہے:
- کوڈ مثالیں بغیر ایررز کے چلیں
- کوڈ کی مثالیں بغیر غلطی کے چلیں
- دستاویزات میں لنکس صحیح چلیں
- دستاویزات میں لنکس صحیح کام کریں
- پروجیکٹ کامیابی سے تعمیر ہوں
- پروجیکٹ کی تعمیر کامیابی سے مکمل ہو
- مثالیں بہترین طریقوں کی پیروی کریں
- مثالیں بہترین طریقے کار کی پیروی کریں
### سبمیشن سے پہلے کی جانچ
### پیشگی جانچ پڑتال
- `npm run lint` چلائیں ان فولڈرز میں جہاں package.json موجود ہو
- وہ فولڈرز جہاں package.json ہو وہاں `npm run lint` چلائیں
- مارک ڈاؤن لنکس کی درستگی کی تصدیق کریں
- مارک ڈاؤن لنکس کی درستگی چی ک کریں
- کوڈ مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- کوڈ کی مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- ترجمے کا ڈھانچہ صحیح برقرار رکھا گیا ہو
- یقینی بنائیں کہ ترجمے صحیح ساخت برقرار رکھتے ہیں
## کوڈ اسلوب کی ہدایات
## کوڈ اسٹائ ل کی ہدایات
### جاوا اسکرپٹ
### جاوا اسکرپٹ
- جدید ES6+ نحو استعمال کریں
- جدید ES6+ نحو استعمال کریں
- پروجیکٹس میں مہیا کردہ معیاری ESLint کنفیگریشنز پر عمل کریں
- پروجیکٹس میں فراہم کردہ معیاری ESLint کنفیگریشن استعمال کریں
- تعلیمی وضاحت کے لیے بامعنی متغیر اور فنکشن نام استعمال ک ریں
- تعلیمی وضاحت کے لیے بامعنی متغیر اور فنکشن کے نام رکھ یں
- سیکھنے والوں کے لیے مفاہیم کی وضاحت کے لیے تبصرے شامل کریں
- مفہوم وضاحت کے لیے تبصرے شامل کریں
- جہاں مقرر ہو پر Prettier کے ذریعے فارمیٹ کریں
- جہاں کنفیگر کیا گیا ہو وہاں Prettier سے فارمیٹنگ کریں
### HTML/CSS
### HTML/CSS
- معنوی HTML5 عناصر
- معنوی HTML5 عناصر استعمال کریں
- جوابدہ ڈیزائن کے اصول
- جامع ریسپونسیو ڈیزائن اصول
- واضح کلاس نامی کنونشنز
- واضح کلاس ناموں کے اصول
- CSS تکنیک کی وضاحت کے لیے تبصرے
- CSS تکنیک کی وضاحت کے لیے تبصرے
### پائتھو ن
### پائتھن
- PEP 8 طرز کی ہدایات
- PEP 8 اسٹائل گائیڈ لائنز
- واضح، تعلیمی کوڈ مثالیں
- واضح، تعلیمی کوڈ کی مثالیں
- جہاں مددگار ہو، ٹائپ ہنٹس
- جہاں مددگار ہو وہاں ٹائپ ہنٹس
### مارک ڈاؤن دستاویزات
### مارک ڈاؤن دستاویزات
- واضح ہیڈنگ ہائیرارکی
- واضح ہیڈنگ ہائیرارکی
- زبان کی وضاح ت کے ساتھ کوڈ بلاکس
- زبان کی تفصیل کے ساتھ کوڈ بلاکس
- اضافی وسائل کے لنکس
- اضافی وسائل کے لنکس
- `images/` فول ڈرز میں اسکرین شاٹس اور تصاویر
- `images/` ڈائ ریکٹری ز میں اسکرین شاٹس اور تصاویر
- امیجز کی رسائی کے لیے Alt ٹیکسٹ
- دستیابی کے لیے تصاویر کا alt متن
### فائل آرگنائزیشن
### فائل کا انتظام
- اسباق متواتر نمبروں کے ساتھ (1-getting-started-lessons، 2-js-basics وغیرہ)
- اسباق کی متواتر نمبرنگ (1-getting-started-lessons, 2-js-basics وغیرہ)
- ہر پروجیکٹ میں `solution/` اور اکثر `start/` یا `your-work/` ڈائریکٹریز
- ہر پروجیکٹ میں `solution/` اور اکثر `start/` یا `your-work/` ڈائریکٹریز
- اسباق کے مخصوص `images/` فولڈرز میں تصاویر محفوظ
- تصاویر سبق کی مخصوص `images/` فولڈرز میں محفوظ
- ترجمے `translations/{language-code}/` ڈھانچے میں
- تراجم `translations/{language-code}/` فولڈرز میں
## تعمیر اور تعیناتی
## بلڈ اور تعیناتی
### کوئز ایپ کی تعیناتی (Azure Static Web Apps)
### کوئز ایپ تعیناتی (Azure Static Web Apps)
کوئز ایپ Azure Static Web Apps تعیناتی کے لیے مرتب ہے:
کوئز ایپ Azure Static Web Apps تعیناتی کے لیے کنفیگر ہے:
```bash
```bash
cd quiz-app
cd quiz-app
npm run build # فولڈر dist/ بناتا ہے
npm run build # dist/ فولڈر بناتا ہے
# مین پر پش ہو نے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
# مرکزی شاخ پر push کر نے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
```
```
Azure Static Web Apps کی ترتیب:
Azure Static Web Apps کی ترتیب:
- ** ایپ مقام**: `/quiz-app`
- ** ایپ لوکیشن**: `/quiz-app`
- ** آؤٹ پٹ مقام**: `dist`
- ** آؤٹ پٹ لوکیشن**: `dist`
- ** ورک فلو**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- ** ورک فلو**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### دستاویزات کا PDF جنریشن
### دستاویزات PDF جنریشن
```bash
```bash
npm install # docsify-to-pdf انسٹال کریں
npm install # docsify-to-pdf انسٹال کریں
npm run convert # docs سے PDF بنائیں
npm run convert # docs سے PDF بنائیں
```
```
### Docsify دستاویزات
### Docsify دستاویزات
```bash
```bash
npm install -g docsify-cli # دستاویزات کو عالمی سطح پر انسٹال کریں
npm install -g docsify-cli # دستاویزات کو عالمی سطح پر انسٹال کریں
docsify serve # localhost:3000 پر خدمت د یں
docsify serve # لوکل ہوسٹ:3000 پر خدمت کر یں
```
```
### پروجیکٹ مخصوص بیلڈز
ہر پروجیکٹ ڈائریکٹری کا اپنا بنایا جا سکتا عمل ہو سکتا ہے:
### پروجیکٹ مخصوص بلڈز
- Vue پروجیکٹس: `npm run build` پروڈکشن بنڈلز بناتا ہے
- سٹیٹک پروجیکٹس: کوئی بلڈ اسٹیپ نہیں، فائلیں براہ راست سرور کی جاتی ہیں
## پل ریکویسٹ کی ہدایات
ہر پروجیکٹ فولڈر میں اپنا بلڈ عمل ہو سکتا ہے:
- Vue پروجیکٹس: `npm run build` پروڈکشن بنڈلز بناتا ہے
- سادہ پروجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلز براہ راست فراہم کی جاتی ہیں
### عنوان کا انداز
## پل ریکویسٹ کی رہنمائی
صاف اور وضاحتی عنوانات استعمال کریں جو تبدیلی کے شعبے کی نشاندہی کریں:
### عنوان کی صورت
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Lesson-3] ٹیریریم پروجیکٹ میں ٹائپ کی اصلاح کریں`
صاف اور وضاحتی عنوانات استعمال کریں جو تبدیلی کے دائرہ کو ظاہر کریں:
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Lesson-3] ٹیریریم پروجیکٹ میں ٹائپو درست کریں`
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں`
- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں`
### ضروری چیکس
### ضروری چیکس
PR جمع کرانے سے پہلے:پل ریکویسٹ جمع کرانے سے پہلے:
1. ** کوڈ کوالٹی**:
1. ** کوڈ کوالٹی**:
- متعلق ہ `npm run lint` چلائیں
- متاثر ہ `npm run lint` چلائیں
- تمام لنٹنگ کی غلطیاں اور وارننگز درست کریں
- تمام لنٹنگ کی غلطیاں اور وارننگز درست کریں
2. ** بی لڈ کی تصدیق**:
2. ** بلڈ کی تصدیق**:
- اگر ضرورت ہو تو `npm run build` چلائیں
- اگر قابل اطلاق ہو تو `npm run build` چلائیں
- یقینی بنائیں کہ کوئی بلڈ ایررز نہ ہوں
- یقینی بنائیں کہ کوئی بلڈ ایرر نہ ہو
3. ** لنک کی تصدیق**:
3. ** لنک کی توثیق**:
- تمام مارک ڈاؤن لنکس ٹیسٹ کریں
- تمام مارک ڈاؤن لنکس ٹیسٹ کریں
- تصاویر کے حوالے کی تصدیق کریں
- تصاویر کے ریفرنس درست ہوں
4. ** مواد کا جائزہ**:
4. ** مواد کا جائزہ**:
- املا اور گرامر کی تصحیح کریں
- ہجے اور گرائمر کی جانچ پڑتال کریں
- کوڈ مثالیں درست اور تعلیمی ہوں
- کوڈ کی مثالیں درست اور تعلیمی ہوں
- ترجمے اصل معنی کو برقرار رکھیں
- ترجمے اصل معنی کو برقرار رکھیں
### تعاون کی ضروریات
### تعاون کی شرائط
- Microsoft CLA سے اتفاق کریں (پہلی PR پر خودکار چیک)
- مائیکروسافٹ CLA سے اتفاق کریں (پہلے PR پر خودکار چیک)
- [Microsoft Open Source Code of Conduct ](https://opensource.microsoft.com/codeofconduct/ ) کی پیروی کریں
- [Microsoft Open Source Code of Conduct ](https://opensource.microsoft.com/codeofconduct/ ) کی پیروی کریں
- مفصل ہدایات کے لیے [CONTRIBUTING.md ](./CONTRIBUTING.md ) دیکھیں
- تفصیلی رہنما خطوط کے لیے [CONTRIBUTING.md ](./CONTRIBUTING.md ) دیکھیں
- PR کی وضاحت میں مسئلہ نمبرات حوالہ دیں اگر ضروری ہو
- اگر قابل اطلاق ہو تو PR وضاحت میں ایشو نمبرز کا حوالہ دیں
### جائزہ
### جائزے کا عمل
- PRs مینٹینرز اور کمیونٹی کے ذریعے جائزہ لیے جاتے ہیں
- PRs دیکھ بھال کرنے والے اور کمیونٹی کی جانب سے جائزہ لیے جاتے ہیں
- تعلیمی وضاحت کو اولین ترجیح دی جاتی ہے
- تعلیمی وضاحت کو ترجیح دی جاتی ہے
- کوڈ مثالیں حالیہ بہترین طریقوں کی پیروی کریں
- کوڈ کی مثالیں موجودہ بہترین طریقے کار کی پیروی کریں
- ترجمے درستگی اور ثقافتی مطابقت کے لیے دیکھے جاتے ہیں
- ترجمے درستگی اور ثقافتی مطابقت کے لیے جائزہ کے تابع ہیں
## ترجمے کا نظام
## ترجمہ
### خودکار ترجمہ
### خودکار ترجمہ
- GitHub Actions کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے
- GitHub Actions کو co-op-translator ورک فلو کے ساتھ استعمال کرتا ہے
- 50+ زبانوں میں خودکار ترجمے
- 50+ زبانوں میں خودکار طور پر ترجمہ کرتا ہے
- ماخذ فائلیں مرکزی ڈائریکٹریز میں
- ماخذ فائلیں مرکزی ڈائریکٹریز میں ہیں
- ترجمہ کی گئی فائلیں `translations/{language-code}/` میں
- ترجمہ شدہ فائلیں `translations/{language-code}/` ڈائریکٹریز میں
### دستی ترجمے میں بہتری شامل کرنا
### دستی ترجمہ
1. `translations/{language-code}/` میں فائل تلاش کریں
1. `translations/{language-code}/` میں فائل تلاش کریں
2. ڈھانچہ برقرار رکھتے ہوئے بہتری کریں
2. ساخت برقرار رکھتے ہوئے بہتریاں کریں
3. یقینی بنائیں کہ کوڈ مثالیں فعال رہیں
3. یقینی بنائیں کہ کوڈ کی مثالیں کارآمد رہیں
4. کسی بھی مقامی کوئز مواد کی جانچ کریں
4. کسی مقامی کوئز مواد کو ٹیسٹ کریں
### ترجمے کا میٹا ڈیٹ ا
### ترجمہ ا
ترجمہ شدہ فائلوں میں میٹا ڈیٹا ہیڈر شامل ہوتا ہے:
ترجمہ شدہ فائلوں میں مٹاداتا ہیڈر شامل ہوتا ہے:
```markdown
```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA:
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
}
-->
-->
```
```
## خرابی تلاش اور مسئلہ حل کرنا
## ڈیبگنگ اور مسئلہ حل کرنا
### عام مسائل
### عام مسائل
**کوئز ایپ شروع نہیں ہوتی**:
**کوئز ایپ اسٹارٹ نہیں ہوتی**:
- Node.js کا ورژن چیک کریں (v14+ کی سفارش ہے)
- Node.js ورژن چیک کریں (v14+ تجویز کردہ)
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- پورٹ ٹکراؤ چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے)
- پورٹ تنازعہ چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے)
**API سرور شروع نہیں ہوتا**:
**API سرور اسٹارٹ نہیں ہوتا**:
- Node.js ورژن کم از کم node >=10 ہونا چاہیے
- کم از کم Node.js ورژن تصدیق کریں (node >=10)
- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو
- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو
- تمام dependencies `npm install` سے انسٹال ہوں
- یقینی بنائیں کہ تمام dependencies نصب ہیں `npm install` کے ذریعے
**براؤزر ایکسٹینشن لوڈ نہیں ہوتی**:
**براؤزر ایکسٹینشن لوڈ نہیں ہوتی**:
- manifest.json کی درست فارمیٹنگ چیک کریں
- manifest.json کی درست تشکیل چیک کریں
- براؤزر کنسول میں ایرر دیکھیں
- براؤزر کے ک نسول میں ایررز دیکھیں
- براؤزر مخصوص ایکسٹینشن انسٹال ہدایات پر عمل کریں
- براؤزر مخصوص ایکسٹینشن انسٹالیشن ہدایات پر عمل کریں
**Python چیٹ پروجیکٹ کے مسائل**:
**Python چیٹ پروجیکٹ کے مسائل**:
- OpenAI پیکج انسٹال ہے: `pip install openai`
- یقینی بنائیں OpenAI پیکیج نصب ہے: `pip install openai`
- GITHUB_TOKEN ماحولیاتی ویریبل سیٹ ہے
- GITHUB_TOKEN ماحول کا متغیر سیٹ ہے
- GitHub Models کی رسائی کی اجازتیں چیک کریں
- GitHub Models کی رسائی کی اجازت چیک کریں
**Docsify دستاویزات سرور نہیں کر رہا**:
**Docsify دستاویزات فراہم نہیں کر رہا**:
- docsify-cli عالمی طور پر انسٹال کریں: `npm install -g docsify-cli`
- docsify-cli گلوبلی انسٹال کریں: `npm install -g docsify-cli`
- ذخیرہ جڑ فولڈر سے چلائیں
- ذخیرہ کی روٹ ڈائریکٹری سے چلائیں
- چیک کریں کہ `docs/_sidebar.md` موجود ہ و
- چیک کریں کہ `docs/_sidebar.md` موجود ہ ے
### ترقیاتی ماحول کی تجاویز
### ترقیاتی ماحول کی تجاویز
- HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں
- جاوا اسکرپٹ کی خرابی تلاش کے لیے براؤزر ڈیولپر ٹولز استعمال کریں
- JavaScript کی ڈیبگنگ کے لیے براؤزر DevTools استعمال کریں
- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
### کارکردگی کے امور
### کارکردگی کے پہلو
- ترجمہ شدہ فائلوں کی بڑی تعداد (50+ زبانیں) کی وجہ سے پورے کلون بڑے ہوتے ہیں
- بڑی تعداد میں ترجمہ شدہ فائلیں (50+ زبانیں) مکمل کلون کو بڑا بناتی ہیں
- صرف مواد پر کام کرنے ک ے لیے shallow clone کریں: `git clone --depth 1`
- صرف مواد پر کام کے لیے shallow clone استعمال کریں: `git clone --depth 1`
- انگریزی مواد پر کام کرتے ہوئے ترجموں کو سرچ سے خارج کریں
- انگریزی مواد پر کام کرتے وقت سرچ سے تراجم کو خارج کریں
- پہلی بار رن پر بلڈ عمل (npm install، Vite build) سست ہو سکتا ہے
- بلڈ عمل پہلے رن پر سست ہو سکتا ہے (npm install, Vite build)
## سیکورٹی کے مسائل
## سیکیورٹی کے پہلو
### ماحولیاتی ویریبلز
### ماحول کے متغ یر ات
- API کیز کبھی بھی ذخیرہ میں جمع نہ کریں
- API کیز کو ذخیرہ میں کبھی جمع نہ کریں
- `.env` فائلیں استعمال کریں (جو پہلے ہی `.gitignore` میں شامل ہیں)
- `.env` فائلز استعمال کریں (جو پہلے سے `.gitignore` میں ہیں)
- ضروری ماحولیاتی ویریبلز کو README میں دستاویز کریں
- درکار ماحول کے متغیرات کو پروجیکٹ کی README میں دستاویز کریں
### پائتھون پروجیکٹس
### Python پروجیکٹس
- ورچوئل اینوائرنمنٹ استعمال کریں: `python -m venv venv`
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- dependencies کو اپ ٹو ڈیٹ رکھیں
- dependencies کو اپ ٹو ڈیٹ رکھیں
- GitHub ٹوکنز کو کم از کم ضروری اجازتیں د یں
- GitHub ٹوکنز کو کم سے کم درکار اجازتوں کے ساتھ رکھ یں
### GitHub Models ت ک رسائی
### GitHub Models کی رسائی
- GitHub Models کے لیے Personal Access Tokens (PAT) ضروری ہیں
- GitHub Models کے لیے ذاتی رسائی کے ٹوکن (PAT) ضروری ہیں
- ٹوکنز ماحولیاتی ویریبلز کی طرح محفوظ رکھیں
- ٹوکنز کو ماحول کے متغیرات کے طور پر محفوظ کریں
- ٹوکنز یا اسناد کبھی ذخیرہ میں جمع نہ کریں
- ٹوکنز یا اسناد کو ک بھی جمع نہ کریں
## اضافی نوٹس
## اضافی نوٹ
### ہدف سامعین
### ہدف سامعین
- ویب ڈویلپمنٹ کے مکمل ابتدائی
- ویب ڈیولپمنٹ کے مکمل مبتدی
- طلباء اور خود سیکھنے والے
- طلباء اور خود آموز
- معلمین جو نصاب کلاس روم میں استعمال کرتے ہیں
- اساتذہ جو کلاس رومز میں نصاب استعمال کرتے ہیں
- مواد قابل رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے
- مواد کو رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے
### تعلیمی فلسفہ
### تعلیمی فلسفہ
- پروجیکٹ پر مبنی سیکھنے کا طریقہ
- پروجیکٹ پر مبنی تعلیمی طریقہ
- بار بار م علو مات ک ی جانچ (کوئزز)
- بار بار علمی جانچ (کوئزز)
- عملی کوڈنگ مشقیں
- عملی کوڈنگ مشقیں
- حقیقی دنیا کی درخواست کی مثالیں
- حقیقی دنیا کی ایپلیکیشن کی مثالیں
- فریم ورکس سے پہلے بنیادی بات وں پر توجہ
- فریم ورکس سے پہلے بنیادی اصول وں پر توجہ
### ذخیرہ کا نگہداشت
### ذخیرہ کا انتظام
- سیکھنے والوں اور تعاون کاروں کی فعال کمیونٹی
- سیکھنے والوں اور تعاون کرنے والوں کی فعال کمیونٹی
- dependencies اور مواد کی باقاعدہ اپ ڈیٹس
- dependencies اور مواد کی باقاعدہ اپ ڈیٹس
- مسائل اور مباحثے مینٹینرز کے ز یر نگرانی
- دیکھ بھال کرنے والوں کی جانب سے مسائل اور مباحثے کی نگرانی
- ترجمے کی تازہ کاری خودکار طور پر GitHub Actions کے ذریعہ
- GitHub Actions کے ذریعے ترجم ہ کی خودکار اپ ڈیٹس
### متعلقہ وسائل
### متعلقہ وسائل
- [Microsoft Learn modules](https://docs.microsoft.com/learn/ )
- [Microsoft Learn ماڈیولز](https://docs.microsoft.com/learn/ )
- [Student Hub resources ](https://docs.microsoft.com/learn/student-hub/ )
- [Student Hub کے وسائل ](https://docs.microsoft.com/learn/student-hub/ )
- [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot ) جو سیکھنے والوں کے لیے تجویز کردہ ہے
- [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot ) سیکھنے والوں کے لیے تجویز کردہ
- اضافی کورسز: جنریٹو AI، ڈیٹا سائنس، ML، IoT نصاب دستیاب ہیں
- اضافی کورسز: جنریٹو AI، ڈیٹا سائنس، ML، IoT نصاب دستیاب
### مخصوص پروجیکٹس کے ساتھ کام
### مخصوص پروجیکٹس کے ساتھ کام کرنا
انفرادی پروجیکٹس کی تفصیلی ہدایات کے لیے، README فائلیں دیکھیں:
انفرادی پروجیکٹس کی تفصیلی ہدایات کے لیے درج ذیل README فائلز دیکھیں:
- `quiz-app/README.md` - Vue 3 کوئز ایپلیکیشن
- `quiz-app/README.md` - Vue 3 کوئز ایپلیکیشن
- `7-bank-project/README.md` - توثیق کے ساتھ بنکنگ ایپلیکیشن
- `7-bank-project/README.md` - بینکنگ ایپلیکیشن کے ساتھ توثیق
- `5-browser-extension/README.md` - براؤزر ایکسٹینشن ڈیولپمنٹ
- `5-browser-extension/README.md` - براؤزر ایکسٹینشن ڈیولپمنٹ
- `6-space-game/README.md` - کینوس پر مبنی گیم ڈیولپمنٹ
- `6-space-game/README.md` - کینوس پر مبنی گیم کی تیاری
- `9-chat-project/README.md` - AI چیٹ اسسٹنٹ پروجیکٹ
- `9-chat-project/README.md` - AI چیٹ اسسٹنٹ پروجیکٹ
### مونو ریپو ڈھانچہ
### منوریپو ساخت
روایتی مونو ریپو تو نہیں، لیکن اس ذخیرے میں متعدد آزاد پروجیکٹس شامل ہیں: اگرچہ یہ روایتی monorepo نہیں ہے، مگر اس ذخیرے میں متعدد آزاد پروجیکٹس شامل ہیں:
- ہر سبق خود مختار ہے
- ہر سبق خود سے مکمل ہے
- پروجیکٹس کی dependencies مشترک نہیں ہیں
- پروجیکٹس ایک دوسرے کی dependencies شیئر نہیں کرتے
- ایک دوسرے کو متاثر کیے بغیر انفرادی پروجیکٹس پر کام کریں
- ایک ساتھ دوسرے پروجیکٹس کو متاثر کیے بغیر الگ الگ کام کریں
- مکمل نصاب کے لیے پورے ذخیرے کو کلون کریں
- پورے نصاب کے تجربے کے لیے مکمل ذخیرہ کلون کریں
---
---
<!-- CO - OP TRANSLATOR DISCLAIMER START --> <!-- CO - OP TRANSLATOR DISCLAIMER START -->
**ڈس کلیمر **:
**دھرنا **:
یہ دستاویز AI ترجمہ خدمت [Co-op Translator ](https://github.com/Azure/co-op-translator ) استعمال کرتے ہوئے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم آگاہ رہیں کہ خودکار تراجم میں غلطیاں یا عدم درست یاں ہو سکتی ہیں۔ اصل دستاویز اپنی مادری زبان میں مستند ماخذ سمجھی جانی چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ ہم اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تعبیر کے ذمہ دار نہیں ہیں ۔
یہ دستاویز AI ترجمہ سروس [Co-op Translator ](https://github.com/Azure/co-op-translator ) کے ذریعے ترجمہ کی گئی ہے۔ اگرچه ہم درستگی کے لیے کوشاں ہیں، براہ کرم نوٹ کریں کہ خودکار ترجموں میں غلطیاں یا عدم درستگ یاں ہو سکتی ہیں۔ اصل دستاویز اپنی مادری زبان میں ہی مستند ماخذ سمجھی جانی چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کی ذمہ داری ہم پر نہیں ہوگی ۔
<!-- CO - OP TRANSLATOR DISCLAIMER END --> <!-- CO - OP TRANSLATOR DISCLAIMER END -->
localizeflow[bot]
5 months ago