@ -2,29 +2,29 @@
## پروجیکٹ کا جائزہ
## پروجیکٹ کا جائزہ
یہ ویب ڈویلپمنٹ کے بنیادی اصولوں کو ابتدائی افراد کو سکھانے کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے۔ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کی طرف سے تیار کردہ 12 ہفتوں پر محیط جامع کورس ہے، جس میں 24 عملی سبق شامل ہیں جو جاوا اسکرپٹ، CSS اور HTML کو کور کرتے ہیں۔
یہ ابتدائیوں کو ویب ڈویلپمنٹ کے بنیادی اصول سکھانے کے لیے ایک تعلیمی نصاب کا مخزن ہے۔ نصاب 12 ہفتوں پر محیط ایک جامع کورس ہے جو Microsoft Cloud Advocates نے تیار کیا ہے، جس میں جاوا اسکرپٹ، CSS، اور HTML پر مشتمل 24 عملی اسباق شامل ہیں۔
### اہم اجزاء
### کلیدی اجزاء
- ** تعلیمی مواد**: 24 منظم سبق جو پروجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں
- ** تعلیمی مواد**: 24 منظم اسباق جو پراجیکٹ پر مبنی ماڈیولز میں منظم ہیں
- ** عملی پرو جیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بینکنگ ایپ، کوڈ ایڈیٹر، اور AI چیٹ اسسٹنٹ
- ** عملی پرا
- ** انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے/بعد کی جانچ)
- ** انٹرایکٹو کوئزز**: 48 کوئزز جن میں ہر ایک میں 3 سوالات ہوتے ہیں (سبق سے پہلے/بعد کی تشخیص)
- ** کثیر اللسانی حمای ت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترا
- ** کثیراللسانی معاون ت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترجمے
- ** ٹیکنالوجیز**: HTML, CSS, JavaScript, 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 کے ذریعے فراہم اور پی ڈی ایف میں دستیاب
- Docsify کے ذریعے دستاویزات فراہم کی جاتی ہیں اور PDF میں دستیاب ہیں
## سیٹ اپ کمانڈز
## سیٹ اپ کمانڈز
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس پر کام کرنے کے لیے:
یہ مخزن بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پراجیکٹس کے ساتھ کام کرنے کے لیے:
### مرکزی ذخیرہ سیٹ اپ
### مرکزی مخزن سیٹ اپ
```bash
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,246 +37,246 @@ cd Web-Dev-For-Beginners
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)
### بینک پرا
```bash
```bash
cd 7-bank-project/api
cd 7-bank-project/api
npm install
npm install
npm start # اے پی آئی سرور شروع کریں
npm start # API سرور شروع کریں
npm run lint # ESLint چلائیں
npm run lint # ESLint چلائیں
npm run format # Prettier کے ساتھ فارمیٹ کر یں
npm run format # Prettier کے ساتھ شکل د یں
```
```
### براؤزر ایکسٹینشن پرو جیکٹس
### براؤزر ایکسٹینشن پرا
```bash
```bash
cd 5-browser-extension/solution
cd 5-browser-extension/solution
npm install
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 Backend )
### چیٹ پراجیکٹ (Python بیک اینڈ )
```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
```
```
## ترقیاتی ورک فلو
## ترقیاتی ورک فلو
### مواد کے تعاون ک اروں کے لیے
### مواد کے شراکت د اروں کے لیے
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 پر ا `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 # تصدیق کریں کہ سرور بغیر کسی خرابی کے شروع ہوتا ہے
```
```
### عمومی جانچ کا طریقہ کار
### عمومی ٹیسٹنگ طریقہ کار
- یہ تعلیمی ذخیرہ جامع خودکار ٹیسٹوں کے بغیر ہے
- یہ ایک تعلیمی مخزن ہے جس میں جامع خودکار ٹیسٹ شامل نہیں
- دستی جانچ پر توجہ مرکوز ہے:
- دستی ٹیسٹنگ پر توجہ مرکوز ہے:
- کوڈ مثالیں بغیر غلطی کے چلیں
- کوڈ مثالیں بغیر غلطی کے چلتی ہ یں
- دستاویزات میں لنکس درست کام کریں
- دستاویزات میں لنکس درست کام کرتے ہ یں
- پروجیکٹ بنڈلز کامیابی سے مکمل ہوں
- پراجیکٹ بلڈ کامیابی سے مکمل ہوتے ہیں
- مثالیں بہترین عملی طریقے اپنائیں
- مثالیں بہترین طریقے کار کی پیروی کرتی ہیں
### جمع کروانے سے پہلے چیک
### پیشگی چیک
- package.json والی ڈائریکٹریز میں `npm run lint` چلائیں
- 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/ بناتا ہے
# مرکزی شاخ پر push کرنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
# مین پر پش کرنے پر 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 # دستاویزات سے PDF بنائیں
npm run convert # docs سے PDF بنائیں
```
```
### Docsify دستاویزات
### Docsify دستاویزات
```bash
```bash
npm install -g docsify-cli # ڈاکسفائی کو عالمی سطح پر انسٹال کریں
npm install -g docsify-cli # ڈاکسفائی کو عالمی طور پر انسٹال کریں
docsify serve # لوکل ہوسٹ پر 3000 پورٹ پر سروس فراہم کر یں
docsify serve # لوکل ہوسٹ:3000 پر سروس د یں
```
```
### پرو جیکٹ مخصوص بلڈز
### پرا
ہر پرو جیکٹ ڈائریکٹری کا اپنا بلڈ عمل ہو سکتا ہے:
ہر پرا
- Vue پروجیکٹس: `npm run build` پروڈکشن بنڈل بناتا ہے
- Vue پراجیکٹس: `npm run build` سے پروڈکشن بنڈلز بنتے ہیں
- سٹیٹک پروجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلز براہ راست سرونگ
- Static پراجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلیں براہ راست سرف کی جاتی ہیں
## پل ریکوئسٹ گائیڈ لائنز
## پل ریکویسٹ رہنما خطوط
### عنوان کی شکل
### عنوان کی شکل
واضح، وضاحتی عنوان استعمال کریں جو تبدیلی کے شعبے کو ظاہر کریں: صاف، وضاحتی عنوانات استعمال کریں جو تبدیلی کے علاقے کی نشاندہی کرتے ہوں:
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Lesson-3] ٹیریریم پر وجیکٹ میں ٹائپو درست کریں`
- `[Lesson-3] ٹیریریم پر اجیکٹ میں ٹائپو کی اصلاح کریں`
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Docs] سیٹ اپ ہدایات اپ ڈیٹ کریں`
- `[Docs] سیٹ اپ ہدایات اپ ڈیٹ کریں`
### ضروری چیکس
### درکار چیک
PR جمع کروانے سے پہلے:
PR جمع کروانے سے پہلے:
1. ** کوڈ کوالٹی**:
1. ** کوڈ معیار**:
- متعلقہ پرو جیکٹ ڈائریکٹریز میں `npm run lint` چلائیں
- متاثرہ پرا جیکٹ ڈائریکٹریز میں `npm run lint` چلائیں
- تمام لِنٹنگ غلطیاں اور وارننگز حل کریں
- تمام lint غلطیاں اور وارننگز درست کریں
2. ** بلڈ تصدیق**:
2. ** بلڈ توثیق**:
- جہاں قابل اطلاق ہو `npm run build` چلائیں
- اگر قابل اطلاق ہو تو `npm run build` چلائیں
- یقینی بنائیں کہ کوئی بلڈ غلطی نہ ہو
- یقینی بنائیں کہ کوئی بلڈ غلطی نہ ہو
3. ** لنک ویلیڈیشن**:
3. ** لنک ویریفیکیشن**:
- تمام مارک ڈاؤن لنکس ٹیسٹ کریں
- تمام مارک ڈاؤن لنکس کی جانچ کریں
- تصویر کے ریفرنس کام کریں
- امیج حوالہ جات کی تصدیق کریں
4. ** مواد کا جائزہ**:
4. ** مواد کا جائزہ**:
- املا اور گرامر کی پروف ریڈنگ کریں
- املا اور گرامر کی جانچ کریں
- کوڈ مثالیں درست اور تعلیمی ہوں
- کوڈ مثالیں درست اور تعلیمی ہوں
- ترا
- ترجمے اصل معنی برقرار رکھیں
### تعاون کی ضروریات
### تعاون کی ضروریات
- Microsoft CLA سے اتفاق کریں (پہلے PR پر خودکار چیک)
- Microsoft 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:
@ -289,120 +289,120 @@ 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 استعمال کرتا ہے)
**API سرور شروع نہیں ہوتا**:
**API سرور شروع نہیں ہوتا**:
- Node.js ورژن کم از کم (node >=10) یقینی بنائیں
- Node.js ورژن کم از کم node >=10 ہونا چاہیے
- دیکھیں کہ پورٹ استعمال میں تو نہیں
- چیک کریں کہ پورٹ استعمال میں نہ ہو
- تمام dependencies `npm install` سے انسٹال ہوں
- تمام انحصارات `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 لائیو سرور ایکسٹینشن استعمال کریں
- HTML پراجیکٹس کے لیے VS Code میں Live Server ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں
- ESLint اور Prettier ایکسٹینشن انسٹال کریں تاکہ فارمیٹنگ یکساں رہے
- JavaScript ڈیبگنگ کے لیے براؤزر ڈویلپر ٹولز استعمال کریں
- جاوا اسکرپٹ کی خرابیوں کے لیے براؤزر DevTools استعمال کریں
- Vue پرو جیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
- Vue پرا
### کارکردگی کے پہلو
### کارکردگی کے امور
- بڑی تعداد میں ترجمہ شدہ فائلیں (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` میں ہیں)
- پروجیکٹ کے READMEs میں ضروری ماحول متغیرات دستاویز کریں
- درکار ماحول کی ویریبلز پراجیکٹ READMEs میں دستاویزی کریں
### پائتھان پرو جیکٹس
### پائتھون پرا جیکٹس
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- dependencies کو اپ ڈیٹ رکھیں
- انحصارات کو بروقت اپڈیٹ رکھیں
- GitHub ٹوکنز میں کم از کم ضروری اجازتیں ہوں
- GitHub ٹوکنز کو کم از کم ضروری اجازتیں دینی چاہئیں
### GitHub Models تک رسائی
### GitHub Models تک رسائی
- GitHub Models کے لیے پرسنل ایکسس ٹوکنز (PAT) ضروری
- GitHub Models کے لیے Personal Access Tokens (PAT) ضروری ہیں
- ٹوکنز ماحول متغیرات کے طور پر محفوظ
- ٹوکنز کو ماحول کی ویریبلز کے طور پر محفوظ کریں
- ٹوکنز یا کریڈینشلز کبھی بھی کمیٹ نہ کریں
- ٹوکنز یا اسناد کو کبھی بھی کمیٹ نہ کریں
## اضافی نوٹس
## اضافی نوٹس
### ہدف سامعین
### ہدف سامعین
- ویب ڈویلپمنٹ کے کل جب beginner
- ویب ڈویلپمنٹ کے مکمل نو آموز
- طلباء اور خود سیکھنے والے
- طلباء اور خود سیکھنے والے
- اساتذہ جو نصاب کلاس روم میں استعمال کرتے ہیں
- اساتذہ جو نصاب کو ک لاس رومز میں استعمال کرتے ہیں
- مواد رسائی کے لیے ڈیزائن کیا گیا ہے اور ہنر کی تدریجی ترقی
- مواد قابل رسائی اور بتدریج مہارت سازی کے لیے ڈیزائن کیا گیا ہے
### تعلیمی فلسفہ
### تعلیمی فلسفہ
- پرو جیکٹ پر مبنی سیکھنے کا طریقہ
- پرا
- کثرت سے علم کی جانچ (کوئزز)
- بار بار علم کی جانچ (کوئزز)
- عملی کوڈنگ مشقیں
- عملی کوڈنگ مشقیں
- حقیقی دنیا کی تطبیقی مثالیں
- حقیقی دنیا کی ایپلیکیشن کی مثالیں
- فریم ورکس سے پہلے بنیادی اصولوں پر توجہ
- فریم ورکس سے پہلے بنیادی اصولوں پر توجہ
### ذخیرہ کی دیکھ بھال
### مخزن کی دیکھ بھال
- سرگرم سیکھنے والوں اور تعاون کاروں کی کمیونٹی
- سیکھنے والوں اور تعاون کنندگان کی فعال کمیونٹی
- dependencies اور مواد کی باقاعدہ اپ ڈیٹ
- انحصارات اور مواد کی باقاعدہ اپ ڈیٹس
- مینٹینرز کی طرف سے اشوز اور مباحثے کی نگرانی
- مسائل اور مباحثے مینٹیینرز کی نگرانی میں
- GitHub Actions کے ذریعے ترجمہ اپ ڈیٹس خودکار
- ترجمہ کی اپ ڈیٹس GitHub Actions کے ذریعے خودکار
### متعلقہ وسائل
### متعلقہ وسائل
- [Microsoft Learn modules ](https://docs.microsoft.com/learn/ )
- [Microsoft Learn modules ](https://docs.microsoft.com/learn/ )
- [Student Hub resources ](https://docs.microsoft.com/learn/student-hub/ )
- [Student Hub resources ](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 چیٹ اسسٹنٹ پراجیکٹ
### مونو ریپو کا ڈھانچہ
### مونو رپو ساخت
اگرچہ روایتی مونو ریپو نہیں ہے، یہ ذخیرہ کئی آزاد پروجیکٹس پر مشتمل ہے:
اگرچہ یہ روایتی مونو رپو نہیں ہے، یہ مخزن متعدد آزاد پراجیکٹس پر مشتمل ہے:
- ہر سبق خود مختار ہے
- ہر سبق خود مختار ہے
- پروجیکٹس مشترکہ 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]
6 months ago