@ -1,28 +1,28 @@
# AGENTS.md
## منصوبے کا جائزہ
## پروجیکٹ کا جائزہ
یہ ویب ڈویلپمنٹ کی بنیادی باتیں سکھانے کے لیے ابتدائیوں کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع ۱۲ ہفتوں کا کورس ہے جو Microsoft Cloud Advocates نے تیار کیا ہے، جس میں جاوا اسکرپٹ، CSS، اور HTML پر مشتمل ۲۴ عملی اسباق شامل ہیں۔
یہ ویب ڈیولپمنٹ کے بنیادی اصولوں کی تعلیم کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے جو مبتدیوں کے لیے ہے۔ یہ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کے ذریعہ تیار کردہ ایک جامع 12 ہفتوں کا کورس ہے، جس میں 24 عملی اسباق شامل ہیں جو جاوا اسکرپٹ، CSS، اور HTML کا احاطہ کرتے ہیں۔
### کلیدی اجزاء
- ** تعلیمی مواد**: ۲۴ منظم اسباق جو پروجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں
- ** عملی پروجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بنکنگ ایپ، کوڈ ایڈیٹر، اور AI چیٹ اسسٹنٹ
- ** انٹرایکٹو کوئزز**: ۴۸ کوئزز، ہر ایک میں ۳ سوالات (سبق کے پہلے اور بعد میں تشخیص)
- ** کثیرالزبان معاونت**: 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 کے طور پر دستیاب ہیں
## سیٹ اپ کمانڈز
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس کے ساتھ کام کرنے کے لیے:
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس پر کام کرنے کے لیے:
### مرکزی ذخیرہ سیٹ اپ
@ -36,19 +36,19 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # ڈو یلپمنٹ سرور شروع کریں
npm run build # پیداوار کے لیے بنائ یں
npm run dev # ڈیو لپمنٹ سرور شروع کریں
npm run build # پروڈکشن کے لیے تیار کر یں
npm run lint # ESLint چلائیں
```
### بنک پروجیکٹ API (Node.js + Express)
### بی نک پروجیکٹ API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # اے پی آئی سرور شروع کریں
npm run lint # ای ایس لِنٹ چلائیں
npm run format # پریٹیئر کے ساتھ فارمیٹ کریں
npm start # API سرور شروع کریں
npm run lint # ESLint چلائیں
npm run format # Prettier کے ساتھ فارمیٹ کریں
```
### براؤزر ایکسٹینشن پروجیکٹس
@ -56,7 +56,7 @@ npm run format # پریٹیئر کے ساتھ فارمیٹ کریں
```bash
cd 5-browser-extension/solution
npm install
# مخصوص براؤزر کی توسیع لوڈ کرنے کی ہدایات پر عمل کریں
# مخصوص براؤزر کے لیے ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں
```
### اسپیس گیم پروجیکٹس
@ -64,15 +64,15 @@ npm install
```bash
cd 6-space-game/solution
npm install
# index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں
# براؤزر میں index.html کھولیں یا Live Server استعمال کریں
```
### چیٹ پروجیکٹ (Python بیک اینڈ )
### چیٹ پروجیکٹ (Python Backend )
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ماحول کی متغیر مقرر کریں
# GITHUB_TOKEN ماحول کا
python api.py
```
@ -80,203 +80,203 @@ 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/
5. سبق کے فولڈرز میں کوڈ مثالوں پر کام کریں
6. اسائنمنٹس اور چیلنجز مکمل کریں
7. سبق کے بعد کی کوئزز لیں
1. ذخیرہ کو فورک یا کلون کریں
2. سبق کی ڈائریکٹریز میں تسلسل کے ساتھ جائیں
3. ہر سبق کی README فائلز پڑھیں
4. سبق سے پہلے کے کوئزز پورے کریں https://ff-quizzes.netlify.app/web/
5. سبق کے فولڈرز میں کوڈ کی مثالوں پر کام کریں
6. تفویضات اور چیلنجز مکمل کریں
7. سبق کے بعد کے کوئزز لیں
### لائیو ڈیولپمنٹ
### لائیو ترقی
- ** دستاویزات**: جڑ فولڈر میں `docsify serve` چلائیں (پورٹ 3000)
- ** کوئز ایپ**: کوئز ایپ فولڈر میں `npm run dev` چلائیں
- ** پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- **API پروجیکٹس** : متعلقہ API ڈائ ریکٹری ز میں `npm start` چلائیں
- ** دستاویزات**: روٹ میں `docsify serve` چلائیں (پورٹ 3000)
- ** کوئز ایپ**: `quiz-app` ڈائریکٹری میں `npm run dev` چلائیں
- ** پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- **API پروجیکٹس** : متعلقہ API فول ڈرز میں `npm start` چلائیں
## جانچ کے ہدایات
## ٹیسٹنگ کی ہدایات
### کوئز ایپ کی جانچ
### کوئز ایپ ٹیسٹنگ
```bash
cd quiz-app
npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں
npm run build # تصدیق کریں کہ بلڈ کامیاب ہوا
npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں
npm run build # تعمیری کامیابی کی تصدیق کریں
```
### بنک API کی جانچ
### بینک API ٹیسٹنگ
```bash
cd 7-bank-project/api
npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں
node server.js # یقینی بنائیں کہ سرور بغیر غلطیوں کے شروع ہو رہ ا
npm run lint # کوڈ کی طرز کے مسائل کی جانچ کریں
node server.js # تصدیق کریں کہ سرور بغیر کسی غلطی کے شروع ہوت ا
```
### عمومی جانچ کا طریقہ
### عمومی ٹیسٹنگ کا طریقہ کار
- یہ تعلیمی ذخیرہ ہے، ا س میں مکمل خودکار ٹیسٹ نہیں ہیں
- دستی جانچ پر توجہ مرکوز ہے:
- کوڈ مثالیں بغیر ایررز کے چلیں
- دستاویزات میں لنکس صحیح چلیں
- پروجیکٹ کامیابی سے تعمیر ہوں
- مثالیں بہترین طریقوں کی پیروی کریں
- یہ ایک تعلیمی ذخیرہ ہے ج س میں مکمل خودکار ٹیسٹ نہیں ہیں
- دستی ٹیسٹنگ پر توجہ مرکوز ہے:
- کوڈ کی مثالیں بغیر غلطی کے چلیں
- دستاویزات میں لنکس صحیح کام کریں
- پروجیکٹ کی تعمیر کامیابی سے مکمل ہو
- مثالیں بہترین طریقے کار کی پیروی کریں
### سبمیشن سے پہلے کی جانچ
### پیشگی جانچ پڑتال
- `npm run lint` چلائیں ان فولڈرز میں جہاں package.json موجود ہو
- مارک ڈاؤن لنکس کی درستگی کی تصدیق کریں
- کوڈ مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- ترجمے کا ڈھانچہ صحیح برقرار رکھا گیا ہو
- وہ فولڈرز جہاں package.json ہو وہاں `npm run lint` چلائیں
- مارک ڈاؤن لنکس کی درستگی چی ک کریں
- کوڈ کی مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- یقینی بنائیں کہ ترجمے صحیح ساخت برقرار رکھتے ہیں
## کوڈ اسلوب کی ہدایات
## کوڈ اسٹائ ل کی ہدایات
### جاوا اسکرپٹ
- جدید ES6+ نحو استعمال کریں
- پروجیکٹس میں مہیا کردہ معیاری ESLint کنفیگریشنز پر عمل کریں
- تعلیمی وضاحت کے لیے بامعنی متغیر اور فنکشن نام استعمال ک ریں
- سیکھنے والوں کے لیے مفاہیم کی وضاحت کے لیے تبصرے شامل کریں
- جہاں مقرر ہو پر Prettier کے ذریعے فارمیٹ کریں
- جدید ES6+ نحو استعمال کریں
- پروجیکٹس میں فراہم کردہ معیاری ESLint کنفیگریشن استعمال کریں
- تعلیمی وضاحت کے لیے بامعنی متغیر اور فنکشن کے نام رکھ یں
- مفہوم وضاحت کے لیے تبصرے شامل کریں
- جہاں کنفیگر کیا گیا ہو وہاں Prettier سے فارمیٹنگ کریں
### HTML/CSS
- معنوی HTML5 عناصر
- جوابدہ ڈیزائن کے اصول
- واضح کلاس نامی کنونشنز
- معنوی HTML5 عناصر استعمال کریں
- جامع ریسپونسیو ڈیزائن اصول
- واضح کلاس ناموں کے اصول
- CSS تکنیک کی وضاحت کے لیے تبصرے
### پائتھو ن
### پائتھن
- PEP 8 طرز کی ہدایات
- واضح، تعلیمی کوڈ مثالیں
- جہاں مددگار ہو، ٹائپ ہنٹس
- PEP 8 اسٹائل گائیڈ لائنز
- واضح، تعلیمی کوڈ کی مثالیں
- جہاں مددگار ہو وہاں ٹائپ ہنٹس
### مارک ڈاؤن دستاویزات
- واضح ہیڈنگ ہائیرارکی
- زبان کی وضاح ت کے ساتھ کوڈ بلاکس
- اضافی وسائل کے لنکس
- `images/` فول ڈرز میں اسکرین شاٹس اور تصاویر
- امیجز کی رسائی کے لیے Alt ٹیکسٹ
- واضح ہیڈنگ ہائیرارکی
- زبان کی تفصیل کے ساتھ کوڈ بلاکس
- اضافی وسائل کے لنکس
- `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}/` فولڈرز میں
## تعمیر اور تعیناتی
## بلڈ اور تعیناتی
### کوئز ایپ کی تعیناتی (Azure Static Web Apps)
### کوئز ایپ تعیناتی (Azure Static Web Apps)
کوئز ایپ Azure Static Web Apps تعیناتی کے لیے مرتب ہے:
کوئز ایپ Azure Static Web Apps تعیناتی کے لیے کنفیگر ہے:
```bash
cd quiz-app
npm run build # فولڈر dist/ بناتا ہے
# مین پر پش ہو نے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
npm run build # dist/ فولڈر بناتا ہے
# مرکزی شاخ پر push کر نے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
```
Azure Static Web Apps کی ترتیب:
- ** ایپ مقام**: `/quiz-app`
- ** آؤٹ پٹ مقام**: `dist`
Azure Static Web Apps کی ترتیب:
- ** ایپ لوکیشن**: `/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 بنائیں
```
### Docsify دستاویزات
```bash
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] سیٹ اپ ہدایات کو اپ ڈیٹ کریں`
### ضروری چیکس
PR جمع کرانے سے پہلے:
پل ریکویسٹ جمع کرانے سے پہلے:
1. ** کوڈ کوالٹی**:
- متعلق ہ `npm run lint` چلائیں
- تمام لنٹنگ کی غلطیاں اور وارننگز درست کریں
1. ** کوڈ کوالٹی**:
- متاثر ہ `npm run lint` چلائیں
- تمام لنٹنگ کی غلطیاں اور وارننگز درست کریں
2. ** بی لڈ کی تصدیق**:
- اگر ضرورت ہو تو `npm run build` چلائیں
- یقینی بنائیں کہ کوئی بلڈ ایررز نہ ہوں
2. ** بلڈ کی تصدیق**:
- اگر قابل اطلاق ہو تو `npm run build` چلائیں
- یقینی بنائیں کہ کوئی بلڈ ایرر نہ ہو
3. ** لنک کی تصدیق**:
- تمام مارک ڈاؤن لنکس ٹیسٹ کریں
- تصاویر کے حوالے کی تصدیق کریں
3. ** لنک کی توثیق**:
- تمام مارک ڈاؤن لنکس ٹیسٹ کریں
- تصاویر کے ریفرنس درست ہوں
4. ** مواد کا جائزہ**:
- املا اور گرامر کی تصحیح کریں
- کوڈ مثالیں درست اور تعلیمی ہوں
4. ** مواد کا جائزہ**:
- ہجے اور گرائمر کی جانچ پڑتال کریں
- کوڈ کی مثالیں درست اور تعلیمی ہوں
- ترجمے اصل معنی کو برقرار رکھیں
### تعاون کی ضروریات
### تعاون کی شرائط
- Microsoft CLA سے اتفاق کریں (پہلی PR پر خودکار چیک)
- [Microsoft Open Source Code of Conduct ](https://opensource.microsoft.com/codeofconduct/ ) کی پیروی کریں
- مفصل ہدایات کے لیے [CONTRIBUTING.md ](./CONTRIBUTING.md ) دیکھیں
- PR کی وضاحت میں مسئلہ نمبرات حوالہ دیں اگر ضروری ہو
- مائیکروسافٹ CLA سے اتفاق کریں (پہلے PR پر خودکار چیک)
- [Microsoft Open Source Code of Conduct ](https://opensource.microsoft.com/codeofconduct/ ) کی پیروی کریں
- تفصیلی رہنما خطوط کے لیے [CONTRIBUTING.md ](./CONTRIBUTING.md ) دیکھیں
- اگر قابل اطلاق ہو تو PR وضاحت میں ایشو نمبرز کا حوالہ دیں
### جائزہ
### جائزے کا عمل
- PRs مینٹینرز اور کمیونٹی کے ذریعے جائزہ لیے جاتے ہیں
- تعلیمی وضاحت کو اولین ترجیح دی جاتی ہے
- کوڈ مثالیں حالیہ بہترین طریقوں کی پیروی کریں
- ترجمے درستگی اور ثقافتی مطابقت کے لیے دیکھے جاتے ہیں
- 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. کسی مقامی کوئز مواد کو ٹیسٹ کریں
### ترجمے کا میٹا ڈیٹ ا
### ترجمہ ا
ترجمہ شدہ فائلوں میں میٹا ڈیٹا ہیڈر شامل ہوتا ہے:
ترجمہ شدہ فائلوں میں مٹاداتا ہیڈر شامل ہوتا ہے:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## خرابی تلاش اور مسئلہ حل کرنا
## ڈیبگنگ اور مسئلہ حل کرنا
### عام مسائل
**کوئز ایپ شروع نہیں ہوتی**:
- Node.js کا ورژن چیک کریں (v14+ کی سفارش ہے)
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- پورٹ ٹکراؤ چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے)
**کوئز ایپ اسٹارٹ نہیں ہوتی**:
- Node.js ورژن چیک کریں (v14+ تجویز کردہ)
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- پورٹ تنازعہ چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے)
**API سرور شروع نہیں ہوتا**:
- Node.js ورژن کم از کم node >=10 ہونا چاہیے
- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو
- تمام dependencies `npm install` سے انسٹال ہوں
**API سرور اسٹارٹ نہیں ہوتا**:
- کم از کم Node.js ورژن تصدیق کریں (node >=10)
- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو
- یقینی بنائیں کہ تمام dependencies نصب ہیں `npm install` کے ذریعے
**براؤزر ایکسٹینشن لوڈ نہیں ہوتی**:
- manifest.json کی درست فارمیٹنگ چیک کریں
- براؤزر کنسول میں ایرر دیکھیں
- براؤزر مخصوص ایکسٹینشن انسٹال ہدایات پر عمل کریں
**براؤزر ایکسٹینشن لوڈ نہیں ہوتی**:
- manifest.json کی درست تشکیل چیک کریں
- براؤزر کے ک نسول میں ایررز دیکھیں
- براؤزر مخصوص ایکسٹینشن انسٹالیشن ہدایات پر عمل کریں
**Python چیٹ پروجیکٹ کے مسائل**:
- OpenAI پیکج انسٹال ہے: `pip install openai`
- GITHUB_TOKEN ماحولیاتی ویریبل سیٹ ہے
- GitHub Models کی رسائی کی اجازتیں چیک کریں
**Python چیٹ پروجیکٹ کے مسائل**:
- یقینی بنائیں OpenAI پیکیج نصب ہے: `pip install openai`
- GITHUB_TOKEN ماحول کا متغیر سیٹ ہے
- GitHub Models کی رسائی کی اجازت چیک کریں
**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 ایکسٹینشن انسٹال کریں
- جاوا اسکرپٹ کی خرابی تلاش کے لیے براؤزر ڈیولپر ٹولز استعمال کریں
- HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں
- JavaScript کی ڈیبگنگ کے لیے براؤزر DevTools استعمال کریں
- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
### کارکردگی کے امور
### کارکردگی کے پہلو
- ترجمہ شدہ فائلوں کی بڑی تعداد (50+ زبانیں) کی وجہ سے پورے کلون بڑے ہوتے ہیں
- صرف مواد پر کام کرنے ک ے لیے shallow clone کریں: `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`
- dependencies کو اپ ٹو ڈیٹ رکھیں
- GitHub ٹوکنز کو کم از کم ضروری اجازتیں د یں
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- dependencies کو اپ ٹو ڈیٹ رکھیں
- GitHub ٹوکنز کو کم سے کم درکار اجازتوں کے ساتھ رکھ یں
### GitHub Models ت ک رسائی
### GitHub Models کی رسائی
- GitHub Models کے لیے Personal Access Tokens (PAT) ضروری ہیں
- ٹوکنز ماحولیاتی ویریبلز کی طرح محفوظ رکھیں
- ٹوکنز یا اسناد کبھی ذخیرہ میں جمع نہ کریں
- GitHub Models کے لیے ذاتی رسائی کے ٹوکن (PAT) ضروری ہیں
- ٹوکنز کو ماحول کے متغیرات کے طور پر محفوظ کریں
- ٹوکنز یا اسناد کو ک بھی جمع نہ کریں
## اضافی نوٹس
## اضافی نوٹ
### ہدف سامعین
- ویب ڈویلپمنٹ کے مکمل ابتدائی
- طلباء اور خود سیکھنے والے
- معلمین جو نصاب کلاس روم میں استعمال کرتے ہیں
- مواد قابل رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے
- ویب ڈیولپمنٹ کے مکمل مبتدی
- طلباء اور خود آموز
- اساتذہ جو کلاس رومز میں نصاب استعمال کرتے ہیں
- مواد کو رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے
### تعلیمی فلسفہ
- پروجیکٹ پر مبنی سیکھنے کا طریقہ
- بار بار م علو مات ک ی جانچ (کوئزز)
- عملی کوڈنگ مشقیں
- حقیقی دنیا کی درخواست کی مثالیں
- فریم ورکس سے پہلے بنیادی بات وں پر توجہ
- پروجیکٹ پر مبنی تعلیمی طریقہ
- بار بار علمی جانچ (کوئزز)
- عملی کوڈنگ مشقیں
- حقیقی دنیا کی ایپلیکیشن کی مثالیں
- فریم ورکس سے پہلے بنیادی اصول وں پر توجہ
### ذخیرہ کا نگہداشت
### ذخیرہ کا انتظام
- سیکھنے والوں اور تعاون کاروں کی فعال کمیونٹی
- dependencies اور مواد کی باقاعدہ اپ ڈیٹس
- مسائل اور مباحثے مینٹینرز کے ز یر نگرانی
- ترجمے کی تازہ کاری خودکار طور پر GitHub Actions کے ذریعہ
- سیکھنے والوں اور تعاون کرنے والوں کی فعال کمیونٹی
- dependencies اور مواد کی باقاعدہ اپ ڈیٹس
- دیکھ بھال کرنے والوں کی جانب سے مسائل اور مباحثے کی نگرانی
- GitHub Actions کے ذریعے ترجم ہ کی خودکار اپ ڈیٹس
### متعلقہ وسائل
- [Microsoft Learn modules](https://docs.microsoft.com/learn/ )
- [Student Hub resources ](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/ )
- [Student Hub کے وسائل ](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 کوئز ایپلیکیشن
- `7-bank-project/README.md` - توثیق کے ساتھ بنکنگ ایپلیکیشن
- `5-browser-extension/README.md` - براؤزر ایکسٹینشن ڈیولپمنٹ
- `6-space-game/README.md` - کینوس پر مبنی گیم ڈیولپمنٹ
انفرادی پروجیکٹس کی تفصیلی ہدایات کے لیے درج ذیل 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 چیٹ اسسٹنٹ پروجیکٹ
### مونو ریپو ڈھانچہ
### منوریپو ساخت
روایتی مونو ریپو تو نہیں، لیکن اس ذخیرے میں متعدد آزاد پروجیکٹس شامل ہیں:
- ہر سبق خود مختار ہے
- پروجیکٹس کی dependencies مشترک نہیں ہیں
- ایک دوسرے کو متاثر کیے بغیر انفرادی پروجیکٹس پر کام کریں
- مکمل نصاب کے لیے پورے ذخیرے کو کلون کریں
اگرچہ یہ روایتی monorepo نہیں ہے، مگر اس ذخیرے میں متعدد آزاد پروجیکٹس شامل ہیں:
- ہر سبق خود سے مکمل ہے
- پروجیکٹس ایک دوسرے کی dependencies شیئر نہیں کرتے
- ایک ساتھ دوسرے پروجیکٹس کو متاثر کیے بغیر الگ الگ کام کریں
- پورے نصاب کے تجربے کے لیے مکمل ذخیرہ کلون کریں
---
<!-- 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 -->
localizeflow[bot]
4 weeks ago