@ -2,29 +2,29 @@
## پروجیکٹ کا جائزہ
یہ ویب ڈویلپمنٹ کے بنیادی اصولوں کو ابتدائی افراد کو سکھانے کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے۔ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کی طرف سے تیار کردہ 12 ہفتوں پر محیط جامع کورس ہے، جس میں 24 عملی سبق شامل ہیں جو جاوا اسکرپٹ، CSS اور HTML کو کور کرتے ہیں۔
یہ ابتدائیوں کو ویب ڈویلپمنٹ کے بنیادی اصول سکھانے کے لیے ایک تعلیمی نصاب کا مخزن ہے۔ نصاب 12 ہفتوں پر محیط ایک جامع کورس ہے جو Microsoft Cloud Advocates نے تیار کیا ہے، جس میں جاوا اسکرپٹ، CSS، اور HTML پر مشتمل 24 عملی اسباق شامل ہیں۔
### اہم اجزاء
### کلیدی اجزاء
- ** تعلیمی مواد**: 24 منظم سبق جو پروجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں
- ** عملی پرو جیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بینکنگ ایپ، کوڈ ایڈیٹر، اور AI چیٹ اسسٹنٹ
- ** انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے/بعد کی جانچ)
- ** کثیر اللسانی حمای ت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترا
- ** ٹیکنالوجیز**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI پروجیکٹس کے لیے)
- ** تعلیمی مواد**: 24 منظم اسباق جو پراجیکٹ پر مبنی ماڈیولز میں منظم ہیں
- ** عملی پرا
- ** انٹرایکٹو کوئزز**: 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 کے ذریعے فراہم اور پی ڈی ایف میں دستیاب
- سبق پر مبنی تعلیمی مخزن
- ہر سبق فولڈر میں README، کوڈ مثالیں، اور حل شامل ہ وتے ہ یں
- علیحدہ ڈائریکٹریز میں آزاد پراجیکٹس (quiz-app، مختلف سبق پراجیکٹس)
- GitHub Actions کا استعمال کرتے ہوئے ترجمہ نظام (co-op-translator)
- Docsify کے ذریعے دستاویزات فراہم کی جاتی ہیں اور PDF میں دستیاب ہیں
## سیٹ اپ کمانڈز
یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس پر کام کرنے کے لیے:
یہ مخزن بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پراجیکٹس کے ساتھ کام کرنے کے لیے:
### مرکزی ذخیرہ سیٹ اپ
### مرکزی مخزن سیٹ اپ
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,246 +37,246 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # سرور کی ترقی شروع کریں
npm run build # پیداواری کے لیے تعم یر کریں
npm run build # پیداوار کے لیے تیا
npm run lint # ESLint چلائیں
```
### بینک پرو جیکٹ API (Node.js + Express)
### بینک پرا
```bash
cd 7-bank-project/api
npm install
npm start # اے پی آئی سرور شروع کریں
npm start # API سرور شروع کریں
npm run lint # ESLint چلائیں
npm run format # Prettier کے ساتھ فارمیٹ کر یں
npm run format # Prettier کے ساتھ شکل د یں
```
### براؤزر ایکسٹینشن پرو جیکٹس
### براؤزر ایکسٹینشن پرا
```bash
cd 5-browser-extension/solution
npm install
# براوزر مخصوص ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں
# مخصوص براؤزر کی توسیع لوڈ کرنے کی ہدایات پر عمل کریں
```
### اسپیس گیم پرو جیکٹس
### اسپیس گیم پرا
```bash
cd 6-space-game/solution
npm install
# index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں
# براوزر میں index.html کھولیں یا Live Server استعمال کریں
```
### چیٹ پروجیکٹ (Python Backend )
### چیٹ پراجیکٹ (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/
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 پر ا `npm start` چلائیں
## جانچ کے ہدایات
## ٹیسٹنگ کی ہدایات
### کوئز ایپ جانچ
### کوئز ایپ ٹیسٹنگ
```bash
cd quiz-app
npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں
npm run build # یقین دہانی کریں کہ تعمیری عمل کامیاب ہو گیا ہے
npm run build # تصدیق کریں کہ بلڈ کامیاب ہو گیا ہے
```
### بینک API جانچ
### بینک API ٹیسٹنگ
```bash
cd 7-bank-project/api
npm run lint # کوڈ کے طرز کے مسائل کی جانچ کریں
npm run lint # کوڈ کے انداز کے مسائل چیک کریں
node server.js # تصدیق کریں کہ سرور بغیر کسی خرابی کے شروع ہوتا ہے
```
### عمومی جانچ کا طریقہ کار
### عمومی ٹیسٹنگ طریقہ کار
- یہ تعلیمی ذخیرہ جامع خودکار ٹیسٹوں کے بغیر ہے
- دستی جانچ پر توجہ مرکوز ہے:
- کوڈ مثالیں بغیر غلطی کے چلیں
- دستاویزات میں لنکس درست کام کریں
- پروجیکٹ بنڈلز کامیابی سے مکمل ہوں
- مثالیں بہترین عملی طریقے اپنائیں
- یہ ایک تعلیمی مخزن ہے جس میں جامع خودکار ٹیسٹ شامل نہیں
- دستی ٹیسٹنگ پر توجہ مرکوز ہے:
- کوڈ مثالیں بغیر غلطی کے چلتی ہ یں
- دستاویزات میں لنکس درست کام کرتے ہ یں
- پراجیکٹ بلڈ کامیابی سے مکمل ہوتے ہیں
- مثالیں بہترین طریقے کار کی پیروی کرتی ہیں
### جمع کروانے سے پہلے چیک
### پیشگی چیک
- package.json والی ڈائریکٹریز میں `npm run lint` چلائیں
- مارک ڈاؤن لنکس کی درستگی یقینی بنائیں
- کوڈ مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- تصدیق کریں کہ تراجم صحیح ساخت برقرار رکھیں
- package.json والے فولڈرز میں `npm run lint` چلائیں
- مارک ڈاؤن لنکس کی درستگی کی تصدیق کریں
- کوڈ مثالوں کو براؤزر یا Node.js میں ٹیسٹ کریں
- یقینی بنائیں کہ تراجم ڈھانچے کو صحیح طریقے سے برقرار رکھتے ہیں
## کوڈ اسٹائل گائیڈ لائنز
## کوڈ اسٹائل کے رہنما اصول
### جاوا اسکرپٹ
- جدید ES6+ نحو استعمال کریں
- پروجیکٹس میں فراہم کردہ معیاری ESLint کنفیگریشن پر عمل کریں
- تعلیمی وضاحت کے لیے با معنی متغیر اور فنکشن کے نام استعمال کریں
- سیکھنے والوں کے لیے تصورات کی وضاحت کے لیے تبصرے شامل کریں
- جہاں کنفیگر ہو وہاں Prettier سے فارمیٹ کریں
- جدید ES6+ نحو استعمال کریں
- پراجیکٹس میں مہیا کردہ معیاری ESLint کنفیگریشن پر عمل کریں
- تعلیمی وضاحت کے لیے معنی خیز متغیر اور فنکشن نام استعمال کریں
- سیکھنے والوں کے لیے تصورات کی وضاحت کے لیے تبصرے شامل کریں
- جہاں کنفیگر کیا گیا ہو Prettier سے فارمیٹ کریں
### HTML/CSS
- معنوی HTML5 عناصر استعمال کریں
- ریسپانسیو ڈیزائن کے اصول
- واضح کلاس ناموں کے قواعد
- CSS تکنیک کی وضاحت کے لیے تبصرے
- معنوی 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/ بناتا ہے
# مرکزی شاخ پر push کرنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
# مین پر پش کرنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
```
Azure Static Web Apps کنفیگریشن:
- ** ا یپ کا مقام**: `/quiz-app`
- ** آؤٹ پٹ لوکیشن**: `dist`
- ** ورک فلو**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps کنفیگریشن:
- ** ا پلیکیشن مقام**: `/quiz-app`
- ** آؤٹ پٹ مقام**: `dist`
- ** ورک فلو**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### دستاویزات PDF جنریشن
```bash
npm install # docsify-to-pdf انسٹال کریں
npm run convert # دستاویزات سے PDF بنائیں
npm run convert # docs سے PDF بنائیں
```
### 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` سے پروڈکشن بنڈلز بنتے ہیں
- Static پراجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلیں براہ راست سرف کی جاتی ہیں
## پل ریکوئسٹ گائیڈ لائنز
## پل ریکویسٹ رہنما خطوط
### عنوان کی شکل
واضح، وضاحتی عنوان استعمال کریں جو تبدیلی کے شعبے کو ظاہر کریں:
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Lesson-3] ٹیریریم پر وجیکٹ میں ٹائپو درست کریں`
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Docs] سیٹ اپ ہدایات اپ ڈیٹ کریں`
صاف، وضاحتی عنوانات استعمال کریں جو تبدیلی کے علاقے کی نشاندہی کرتے ہوں:
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں`
- `[Lesson-3] ٹیریریم پر اجیکٹ میں ٹائپو کی اصلاح کریں`
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں`
- `[Docs] سیٹ اپ ہدایات اپ ڈیٹ کریں`
### ضروری چیکس
### درکار چیک
PR جمع کروانے سے پہلے:
1. ** کوڈ کوالٹی**:
- متعلقہ پرو جیکٹ ڈائریکٹریز میں `npm run lint` چلائیں
- تمام لِنٹنگ غلطیاں اور وارننگز حل کریں
1. ** کوڈ معیار**:
- متاثرہ پرا جیکٹ ڈائریکٹریز میں `npm run lint` چلائیں
- تمام 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 تفصیل میں اگر قابل اطلاق ہو تو مسئلہ نمبر شامل کریں
- Microsoft 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:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## ڈیبگنگ اور مسئلے حل کرنا
## خرابیوں کا سراغ لگانا اور مسائل حل کرنا
### عام مسائل
**کوئز ایپ شروع نہیں ہوتی**:
- Node.js ورژن چیک کریں (v14+ کی سفارش)
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- پورٹ تنازعہ
**کوئز ایپ شروع نہیں ہوتی**:
- 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 ہونا چاہیے
- چیک کریں کہ پورٹ استعمال میں نہ ہو
- تمام انحصارات `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 لائیو سرور ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں
- JavaScript ڈیبگنگ کے لیے براؤزر ڈویلپر ٹولز استعمال کریں
- Vue پرو جیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
- HTML پراجیکٹس کے لیے VS Code میں Live Server ایکسٹینشن استعمال کریں
- ESLint اور Prettier ایکسٹینشن انسٹال کریں تاکہ فارمیٹنگ یکساں رہے
- جاوا اسکرپٹ کی خرابیوں کے لیے براؤزر DevTools استعمال کریں
- Vue پرا
### کارکردگی کے پہلو
### کارکردگی کے امور
- بڑی تعداد میں ترجمہ شدہ فائلیں (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` میں ہیں)
- پروجیکٹ کے READMEs میں ضروری ماحول متغیرات دستاویز کریں
- API کیز کبھی بھی مخزن میں جمع نہ کریں
- `.env` فائلز کا استعمال کریں (جو پہلے ہی `.gitignore` میں ہیں)
- درکار ماحول کی ویریبلز پراجیکٹ READMEs میں دستاویزی کریں
### پائتھان پرو جیکٹس
### پائتھون پرا جیکٹس
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- dependencies کو اپ ڈیٹ رکھیں
- GitHub ٹوکنز میں کم از کم ضروری اجازتیں ہوں
- ورچوئل ماحول استعمال کریں: `python -m venv venv`
- انحصارات کو بروقت اپڈیٹ رکھیں
- GitHub ٹوکنز کو کم از کم ضروری اجازتیں دینی چاہئیں
### 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/ )
- [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 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 نصاب دستیاب ہیں
### مخصوص پروجیکٹس کے ساتھ کام کرنا
### مخصوص پراجیکٹس کے ساتھ کام
انفرادی پروجیکٹس کے لیے تفصیلی ہدایات کے لیے 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 چیٹ اسسٹنٹ پروجیکٹ
انفرادی پراجیکٹس کی تفصیلی ہدایات کے لیے، درج ذیل 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 نہیں رکھتے
- انفرادی پروجیکٹس پر بغیر دوسرے متاثر کیے کام کریں
- مکمل نصاب کے تجربے کے لیے پورا ریپو کلون کریں
اگرچہ یہ روایتی مونو رپو نہیں ہے، یہ مخزن متعدد آزاد پراجیکٹس پر مشتمل ہے:
- ہر سبق خود مختار ہے
- پراجیکٹس انحصارات شیئر نہیں کرتے
- بغیر دوسرے پراجیکٹس کو متاثر کیے انفرادی پراجیکٹس پر کام کریں
- پورے نصاب کے تجربے کے لیے پورا مخزن کلون کریں
---
<!-- 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]
2 weeks ago