@ -2,281 +2,281 @@
## پروجیکٹ کا جائزہ
یہ ابتدائیوں کو ویب ترقی کے بنیادی اصول سکھانے کے لیے تعلیمی نصاب کا مخزن ہے۔ یہ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کے تیار کردہ 12 ہفتوں پر مشتمل جامع کورس ہے، جس میں 24 عملی اسباق شامل ہیں جو جاوا اسکرپٹ، سی ایس ایس، اور ایچ ٹی ایم ایل کی تعلیم دیتے ہیں۔
یہ ویب ڈیولپمنٹ کے بنیادی اصول نوجوانوں کو سکھانے کے لیے تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع 12 ہفتوں کا کورس ہے جسے Microsoft Cloud Advocates نے تیار کیا ہے، جس میں JavaScript، CSS، اور HTML پر مشتمل 24 عملی اسباق شامل ہیں۔
### اہم اجزاء
### کلیدی اجزاء
- ** تعلیمی مواد**: 24 منظم اسباق پروجیکٹ بیسڈ ماڈیولز میں ترتیب دیے گئے ہیں
- ** عملی پروجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بینکنگ ایپ، کوڈ ایڈیٹر، اور اے آئی چیٹ اسسٹنٹ
- ** انٹرایکٹو کوئزز**: 48 کوئزز ہر ایک میں 3 سوالات (سبق سے پہلے اور بعد میں تشخیص )
- ** کئی زبانوں کی معاونت**: گٹ ہب ایکشنز کے ذریعے 50+ زبانوں میں خودکار ترجمہ
- ** ٹیکنالوجیز**: ایچ ٹی ایم ایل، سی ایس ایس، جاوا اسکرپٹ، ویو۔جے ایس 3، وائٹ، نوڈ۔جے ایس، ایکسپریس، پائتھون (AI پروجیکٹس کے لیے)
- ** تعلیمی مواد**: 24 منظم اسباق جو پروجیکٹ کی بنیاد پر ماڈیولز میں ترتیب دیے گئے ہیں
- ** عملی پروجیکٹس**: Terrarium، Typing Game، Browser Extension، Space Game، Banking App، Code Editor، اور AI Chat Assistant
- ** انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے اور بعد کے جائزے )
- ** کئی زبانوں کی حمایت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترجمے
- ** ٹیکنالوجیز**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI پروجیکٹس کے لیے)
### ساخت
### فن تعمیر
- سبق پر مبنی تعلیمی مخزن
- ہر سبق کا
- الگ الگ ڈائریکٹریز میں اسٹینڈ الون پروجیکٹس (quiz-app، مختلف سبق کے پروجیکٹس)
- گٹ ہب ایکشنز سے ترجمہ کا نظام (co-op-translator)
- ڈاکسفائی کے ذریعے دستاویزات کی فراہمی اور 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
```
### کوئز ایپ سیٹ اپ (ویو 3 + وائٹ )
### Quiz App سیٹ اپ (Vue 3 + Vite )
```bash
cd quiz-app
npm install
npm run dev # سرور کی ترقی شروع کریں
npm run build # پیداوار کے لیے تعمیر کر یں
npm run dev # سرور ترقی شروع کریں
npm run build # پیداوار کے لیے بنائ یں
npm run lint # ESLint چلائیں
```
### بینک پروجیکٹ API (نوڈ۔جے ایس + ایکسپریس )
### Bank پروجیکٹ API (Node.js + Express )
```bash
cd 7-bank-project/api
npm install
npm start # اے پی آئی سرور شروع کریں
npm run lint # ESLint چلائیں
npm run format # Prettier کے ساتھ فارمیٹ کریں
npm run lint # ای ایس لنٹ چلائیں
npm run format # پریٹیئر سے فارمیٹ کریں
```
### براؤزر ایکسٹینشن پروجیکٹس
### Browser Extension پروجیکٹس
```bash
cd 5-browser-extension/solution
npm install
# مخصوص براؤزر کے ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں
# براؤزر-مخصوص ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں
```
### اسپیس گیم پروجیکٹس
### Space Game پروجیکٹس
```bash
cd 6-space-game/solution
npm install
# فائل index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں
# index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں
```
### چیٹ پروجیکٹ (پائتھون بیک اینڈ )
### Chat پروجیکٹ (Python Backend )
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ماحولیاتی متغیر کو سیٹ کریں
# GITHUB_TOKEN ماحولیاتی متغیر مقرر کریں
python api.py
```
## ترقیاتی ورک فلو
## ڈیولپمنٹ ورک فلو
### مواد کے تعاون کنندگان کے لیے
### مواد کے کنٹری بیوٹرز کے لیے
1. اپنی گٹ ہب اکاؤنٹ میں مخزن کی فورک کریں
2. اپنی فورک کو مقامی طور پر کلون کریں
3. تبدیلیوں کے لیے نئی برانچ بنائیں
4. سبق کے مواد یا کوڈ کی مثالوں میں تبدیلی کریں
5. متعلقہ پروجیکٹ ڈائریکٹریز میں کوڈ کی تبدیلیوں کی جانچ کریں
6. تعاون کے رہنما اصولوں کی پیروی کرتے ہوئے پل ریکویسٹ جمع کر ائیں
1. ** ریپوزٹری کو اپنے GitHub اکاؤنٹ پر فورک کریں**
2. ** اپنے**
3. ** اپنے **
4. سبق کے مواد یا کوڈ مثالوں میں تبدیلی کریں
5. متعلقہ پروجیکٹ فولڈرز میں کوڈ کی تبدیلیاں ٹیسٹ کریں
6. تعاون کی ہدایات کے مطابق پل ریکویسٹ جمع کرو ائیں
### سیکھنے والوں کے لیے
1. مخزن کو فورک یا کلون کریں
2. سبق کی ڈائریکٹریز میں ترتیب سے جائیں
1. ریپوزٹری کو فورک یا کلون کریں
2. سبق کی ڈائریکٹریز میں تسلسل کے ساتھ جائیں
3. ہر سبق کے README فائلیں پڑھیں
4. سبق سے پہلے کی ک وئزز مکمل کریں https://ff-quizzes.netlify.app/web/
5. سبق کے فولڈرز میں کوڈ مثالوں پر کام کریں
4. سبق سے پہلے کوئزز مکمل کریں https://ff-quizzes.netlify.app/web/
5. سبق کے فولڈرز میں کوڈ کی مثالوں پر کام کریں
6. اسائنمنٹس اور چیلنجز مکمل کریں
7. سبق کے بعد کی ک وئزز لیں
7. سبق کے بعد کوئزز لیں
### لائیو ڈیویلپمنٹ
### براہ راست ترقی
- ** دستاویزات**: روٹ میں `docsify serve` چلائیں (پورٹ 3000)
- ** کوئز ایپ**: `quiz-app` ڈائریکٹری`npm run dev` چلائیں
- ** پروجیکٹس**: ایچ ٹی ایم ایل پروجیکٹس کے لیے VS کوڈ لائیو سرور ایکسٹینشن استعمال کریں
- **API پروجیکٹس** : متعلقہ API ڈائ ریکٹری ز میں `npm start` چلائیں
- **Quiz App** : quiz-app فولڈر`npm run dev` چلائیں
- ** پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں
- **API پروجیکٹس** : متعلقہ API فول ڈرز میں `npm start` چلائیں
## ٹیسٹنگ کی ہدایات
## ٹیسٹنگ ہدایات
### کوئز ایپ کی ٹیسٹنگ
### Quiz App کی ٹیسٹنگ
```bash
cd quiz-app
npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں
npm run build # تصدیق کریں کہ تعمیر کامیاب ہو گئی ہے
npm run lint # کوڈ کے طرز کے مسائل چیک کریں
npm run build # تعمیر کی کامیابی کی تصدیق کریں
```
### بینک API کی ٹیسٹنگ
### Bank API کی ٹیسٹنگ
```bash
cd 7-bank-project/api
npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں
node server.js # سرور کے بغیر غلطیوں کے شروع ہونے کی تصدیق کریں
node server.js # تصدیق کریں کہ سرور بغیر غلطیوں کے شروع ہوتا ہے
```
### عمومی ٹیسٹنگ کا طریقہ کار
### عمومی ٹیسٹنگ طریقہ کار
- یہ تعلیمی مخزن جامع خودکار ٹیسٹس نہیں رکھتا
- دستی ٹیسٹنگ پر توجہ مرکوز ہے:
- کوڈ کی مثالیں بغیر کسی ایرر کے چلیں
- دستاویزات میں لنکس درست کام کریں
- پروجیکٹ کامیابی سے بنیں
- مثالیں بہترین طریقہ
- یہ ایک تعلیمی ذخیرہ ہے اور جامع خودکار ٹیسٹ نہیں رکھتا
- دستی ٹیسٹنگ پر توجہ دی جاتی ہے:
- کوڈ کی مثالیں بغیر غلطی چلیں
- دستاویزات کی لنکس صحیح کام کریں
- پروجیکٹ کی تعمیر کامیابی سے مکمل ہو
- مثالیں بہترین طریقوں پر عمل کریں
### قبل از جمع کرانے چیکس
### جمع کرو انے سے پہل ے چیکس
- `npm run lint` چلائیں جہاں `package.json` ہو
- مارک ڈاؤن لنکس کی درستگی کی تصدیق کریں
- کوڈ کی مثالوں کی براؤزر یا نوڈ۔جے ایس میں جانچ کریں
- ترجمہ
- جہاں package.json موجود ہو، `npm run lint` چلائیں
- مارکڈاؤن کے لنکس کی تصدیق کریں
- مثالیں براؤزر یا Node.js میں ٹیسٹ کریں
- ترجمے مناسب ساخت کو برقرار رکھ یں
## کوڈ اسٹائل کے رہنما اصول
## کوڈ اسٹائل گائیڈ لائنز
### جاوا اسکرپٹ
### JavaScript
- جدید ES6+ نحو استعمال کریں
- پروجیکٹس میں فراہم کردہ ESLint کنفیگریشنز کا استعما ل کریں
- تعلیمی وضاحت کے لیے با معنی متغیر اور فنکشن کے نام رکھ یں
- سیکھنے والوں کے لیے تصریحات شامل کریں
- جہاں ممکن ہو پریٹیئر سے فارمیٹنگ کریں
- پروجیکٹس میں فراہم کردہ ESLint کنفیگریشنز پر عم ل کریں
- تعلیمی وضاحت کے لیے معنی خیز متغیر اور فنکشن کے نام استعمال ک ریں
- سیکھنے والوں کے لیے تصو رات ک ی وضا حت و ا لے تبصرے شامل کریں
- جہاں Prettier مرتب ہو، اس سے فارمیٹ کریں
### HTML/CSS
- سمانٹک HTML5 عناصر
- ریسپانسیو ڈیزائن کے اصول
- واضح کلاس ناموں کے کنونشن
- CSS تکنیکوں کی وضاحت کے لیے تبصر ے
- معنوی HTML5 عناصر
- جوابدہ (Responsive) ڈیزائن اصول
- صاف ستھری کلاس نام کاری
- CSS تکنیکس کی وضاحت کرنے والے تبصرے سیکھنے والوں کے لی ے
### پائتھون
### Python
- PEP 8 اسٹائل گائیڈ لائنز
- واضح، تعلیمی کوڈ مثالیں
- سیکھنے میں مدد کے لیے ٹائپ ہنٹس
- جہاں مفید ہو ٹائپ ہنٹس
### مارک ڈاؤن دستاویزات
### مارکڈاؤن دستاویزات
- واضح سرخیوں کی ترتیب
- صاف سرخیوں کی ترتیب
- زبان کی وضاحت کے ساتھ کوڈ بلاکس
- اضافی وسائل کے لنکس
- `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)
### Quiz App کی تعیناتی (Azure Static Web Apps)
کوئز-ایپ کو Azure Static Web Apps کے لیے ترتیب دیا گیا ہے:
quiz-app Azure Static Web Apps کے لیے ترتیب دیا گیا ہے:
```bash
cd quiz-app
npm run build # فولڈر dist/ بناتا ہے
# مین پر دھکیل نے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے
# مین پر پوش کر نے پر 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 # دستاویزات کو پی ڈی ایف میں تبدیل کرنے والی داکسیفائی انسٹال کریں
npm run convert # داکس سے پی ڈی ایف تیار کر یں
npm install # انسٹال کریں docsify-to-pdf
npm run convert # docs سے PDF بنائ یں
```
### Docsify دستاویزات
```bash
npm install -g docsify-cli # ڈوکسف ی کو عالمی طور پر انسٹال کریں
docsify serve # localhost :3000 پر سروس فراہم کریں
npm install -g docsify-cli # ڈاکسفائ ی کو عالمی طور پر انسٹال کریں
docsify serve # لوکل ہوسٹ :3000 پر سروس فراہم کریں
```
### پروجیکٹ مخصوص بلڈز
### پروجیکٹ مخصوص تعمیر
ہر پروجیکٹ ڈائریکٹری کا اپنا بلڈ عمل ہو سکتا ہے:
- ویو پروجیکٹس: `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 `
صاف اور وضاحتی عنوانات استعمال کریں جو تبدیلی کے علاقے کو ظاہر کریں:
- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں `
- `[Lesson-3] terrarium پروجیکٹ میں ٹائپو درست کریں `
- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں `
- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں `
### مطلوبہ چیکس
### درکار چیکس
PR جمع کرانے سے پہلے:
PR جمع کرو انے سے پہلے:
1. ** کوڈ کی کوالٹی **:
- متاثرہ پروجیکٹ ڈائ ریکٹری ز میں `npm run lint` چلائیں
- تمام لینٹنگ ایررز اور وارننگز درست کریں
1. ** کوڈ کی معیار **:
- متاثرہ پروجیکٹ فول ڈرز میں `npm run lint` چلائیں
- تمام lint کی غلطیاں اور وارننگز ٹھیک کریں
2. ** بلڈ کی تصدیق**:
- اگر قابل اطلاق ہے ت و `npm run build` چلائیں
- یقینی بنائیں کہ کوئی بلڈ ایرر نہیں ہے
2. ** تعمیر کی تصدیق**:
- جہاں لاگو ہ و `npm run build` چلائیں
- یقینی بنائیں کہ کوئی تعمیر کی غلطی نہ ہو
3. ** لنک ویلیڈیشن **:
- تمام مارک ڈاؤن لنکس کی جانچ کریں
- امیج ریفرنسز کام کر رہے ہ یں
3. ** لنک کی توثیق **:
- تمام مارکڈاؤن لنکس کا ٹیسٹ کریں
- تصویری حوالہ جات کام کر رہے ہیں کی تصدیق کر یں
4. ** مواد کا جائزہ**:
- ہجے اور گرامر کی جانچ کریں
- کوڈ کی مثالیں درست اور تعلیمی ہوں
- ترجمے اصل معنی برقرار رکھیں
- املا اور گرامر کی جانچ کریں
- کوڈ مثالیں درست اور تعلیمی ہوں
- ترجمے اصل معنی کو برقرار رکھیں
### شراکت کے تقاضے
### تعاون کی ضروریات
- مائیکروسافٹ 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 مینٹینرز اور کمیونٹی کے ذریعے جائزہ لیے جاتے ہیں
- تعلیمی وضاحت کو ترجیح دی جاتی ہے
- کوڈ مثالیں موجودہ بہترین طریقہ
- ترجمے درستگی اور ثقافتی مناسبت کے لیے جائزہ لیے جاتے ہ یں
- کوڈ مثالیں موجودہ بہترین طریقوں کی پیروی کریں
- ترجمے درستگی اور ثقافتی مناسبت کی جانچ پڑتال سے گزر یں
## ترجمہ کا نظام
## ترجمہ نظام
### خودکار ترجمہ
- گٹ ہب ایکشنز کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے
- 50+ زبانوں میں خودکار ترجمہ
- GitHub Actions کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے
- 50+ زبانوں میں خود بخود ترجمہ کرتا ہے
- ماخذ فائلیں مرکزی ڈائریکٹریز میں
- ترجمہ شدہ فائلیں `translations/{language-code}/` میں
- ترجمہ شدہ فائلیں `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:
-->
```
## ڈیبگنگ اور مسئلہ حل کرنا
## ڈی بگنگ اور مسئلہ حل کرنا
### عام مسائل
**کوئز ایپ شروع نہیں ہوتی **:
- نوڈ۔جے ایس کا ورژن چیک کریں (v14+ سفارش کی جاتی ہے )
**Quiz app شروع نہیں ہو رہا **:
- Node.js کا ورژن چیک کریں (v14+ تجویز شدہ )
- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں
- پورٹ کے تصادمات کی جانچ کریں (ڈیفالٹ: وائٹ 5173 پورٹ استعمال کرتا ہے)
- پورٹ کی ٹکراؤ کو چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے)
**API سرور شروع نہیں ہوت ا
- نوڈ۔جے ایس کا ورژن کم از کم 10 ہو
- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو
- تمام dependencies `npm install` سے انسٹال کری ں
**API سرور شروع نہیں ہو رہ ا
- کم از کم Node.js ورژن کا یقین دہانی کریں (node >=10)
- چیک کریں کہ پورٹ پہلے سے استعمال میں تو نہیں
- تمام dependencies `npm install` سے انسٹال ہو ں
**براؤزر ایکسٹینشن لوڈ نہیں ہوتی **:
- `manifest.json` کی صحیح فارمیٹنگ یقینی بنائ
- براؤزر کنسول میں ایررز چیک کریں
- براؤزر مخصوص انسٹالیشن ہدایات پر عمل کریں
**Browser extension لوڈ نہیں ہو رہا **:
- manifest.json کے درست فارمیٹ کی تصدیق کر یں
- براؤزر کنسول میں غلطیوں کی جانچ کریں
- براؤزر مخصوص ا یکسٹینشن ا نسٹالیشن ہدایات پر عمل کریں
**پائتھون چیٹ پروجیکٹ کے مسائل**:
**Python chat پروجیکٹ مسائل**:
- OpenAI پیکیج انسٹال کریں: `pip install openai`
- GITHUB_TOKEN ماحول متغیر سیٹ ہے
- GitHub Models کی رسائی کی اجازتیں چیک کریں
- GITHUB_TOKEN ماحول متغیر سیٹ ہے کی جانچ کریں
- GitHub Models کے رسائی حقوق چیک کریں
**Docsify دستاویزات ظاہر نہیں کرت ا
**Docsify دستاویزات سرور نہیں کر رہ ا
- docsify-cli عالمی طور پر انسٹال کریں: `npm install -g docsify-cli`
- مخزن کی روٹ ڈائریکٹری سے چلائیں
- `docs/_sidebar.md` موجود ہے
- ذخیرہ کی روٹ ڈائریکٹری سے چلائیں
- یقینی بنائیں کہ `docs/_sidebar.md` موجود ہے
### ترقیاتی ماحول کے ٹپس
### ترقی کے ماحول کے نکات
- HTML پروجیکٹس کے لیے VS کوڈ میں لائیو سرور ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن نصب کریں
- جاوا اسکرپٹ کے لیے براؤزر کے ڈویلپر ٹولز استعمال کریں
- ویو پروجیکٹس کے لیے، Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
- HTML پروجیکٹس کے لیے VS Code کے ساتھ Live Server ایکسٹینشن استعمال کریں
- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشنز انسٹال کریں
- JavaScript کی ڈی بگنگ کے لیے براؤزر DevTools کا استعمال کریں
- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں
### کارکردگی کے ملاحظات
### کارکردگی کے لیے توجہ
- ترجمہ شدہ فائلوں کی بڑی تعداد (50+ زبانیں) مکمل کلون کو بڑا بناتی ہے
- صرف مواد پر کام کے لیے شالو کلون استعمال کریں: `git clone --depth 1`
- انگریزی مواد پر کام کرتے وقت ترجموں کو تلاش سے خارج کریں
- پہلی بار چلانے پر بلڈ عمل سست ہو سکتا ہے (npm install، وائٹ بلڈ )
- بڑی تعداد میں ترجمہ شدہ فائلیں (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 ٹوکنز کو کم سے کم ضروری اجازت دی جائے
- dependencies کو اپ ٹو ڈیٹ رکھیں
- GitHub کے ٹوکنز کم از کم ضروری اجازتوں کے ساتھ ہوں
### GitHub Models کی رسائی
### GitHub Models ت ک رسائی
- ذاتی رسائی ٹوکنز (PAT) GitHub Models کے لیے ضروری ہیں
- ٹوکنز کو ماحول متغیرات کے طور پر محفوظ کریں
- ٹوکنز یا اسناد کبھی جمع نہ کریں
- GitHub Models کے لیے Personal Access Tokens (PAT) مطلوب ہیں
- ٹوکنز کو ماحول کے متغیرات کے طور پر محفوظ کریں
- ٹوکنز یا اسناد کو کبھی ذخیرہ میں کمٹ نہ کریں
## اضافی نوٹس
### ہدف مخاطب
### ہدف سامعین
- ویب ترقی میں مکمل نئے شروعات کرنے والے
- ویب ڈیولپمنٹ کے مکمل نو آموز
- طلباء اور خود سیکھنے والے
- اساتذہ جو نصاب کو کلاس رومز میں استعمال کرتے ہیں
- مواد رسائی کے لیے ڈیزائن کیا گیا ہ ے اور ہنر کی تدریجی تعمیر کے لی ے
- کلاس رومز میں نصاب استعمال کرنے والے اساتذہ
- مواد آسان رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے
### تعلیمی فلسفہ
- پروجیکٹ بیسڈ سیکھنے کا طریقہ
- کثرت سے علم ک ی جان چ (کوئزز)
- عملی کوڈنگ مشقیں
- پروجیکٹ پر م بن ی سیکھنے کا طریقہ
- کثرت سے علمی چیکز (کوئزز)
- عملی کوڈنگ کی مشقیں
- حقیقی دنیا کی مثالیں
- فریم ورکس سے پہلے بنیادی بات وں پر توجہ
- فریم ورکس سے پہلے بنیادی اصول وں پر توجہ
### مخزن کی دیکھ بھال
### ذخیرہ کی دیکھ بھال
- متحرک سیکھنے والوں اور تعاون کنندگان کی کمیونٹی
- dependencies اور مواد کو باقاعدگی سے اپ ڈیٹ کیا جاتا ہے
- ایشوز اور مباحثوں کی نگرانی مینٹینرز کرتے ہ یں
- ترجمہ کی اپ ڈیٹس گٹ ہب ایکشنز سے خودکار ہیں
- سیکھنے والوں اور کنٹری بیوٹرز کی فعال کمیونٹی
- 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 نصابات دستیاب ہیں
- [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot ) سیکھنے والوں کے لیے تجویز کردہ
- اضافی کورسز: Generative AI, Data Science, ML, IoT نصاب دستیاب
### مخصوص پروجیکٹس کے ساتھ کام کرنا
مخصوص پروجیکٹس کے تفصیلی ہدایات کے لیے درج ذیل README فائلز دیکھیں:
- `quiz-app/README.md` - ویو 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 مشترک نہیں
- ایک پروجیکٹ پر کام کریں بغیر دوسرے متاثر کیے
- مکمل نصاب کا
- پروجیکٹس dependencies شیئر نہیں کرتے
- بغیر ایک دوسرے کو متاثر کیے انفرادی پروجیکٹس پر کام کریں
- مکمل نصاب کے لیے پورے ریپوزٹری کو کلون کریں
---
<!-- CO - OP TRANSLATOR DISCLAIMER START -->
**دستخطی نوٹس **:
یہ دستاویز AI ترجمہ سروس [Co-op Translator ](https://github.com/Azure/co-op-translator ) کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کی کوشش کرتے ہیں، براہ کرم اس بات سے آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا کمی بیشی ہوسکتی ہے۔ اصل دستاویز اپنے مادری زبان میں ہی مستند ذریعہ سمجھی جائ ے۔ اہم معلومات کے لیے پیشہ ورانہ انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمہ کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا بدفہمی کی ذمہ داری ہم پر عائد نہیں ہوگی ۔
**دستخطی رہنمائی **:
اس دستاویز کا ترجمہ مصنوعی ذہانت کی ترجمہ سہولت [Co-op Translator ](https://github.com/Azure/co-op-translator ) کے ذریعے کیا گیا ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم یہ بات ذہن میں رکھیں کہ خودکار ترجموں میں غلطیاں یا عدم مطابقت ہو سکتی ہے۔ اصل دستاویز اپنی مایہ ناز زبان میں معتبر ماخذ تصور کی جانی چاہی ے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ ہم اس ترجمہ کے استعمال سے ہونے والی کسی بھی غلط فہمی یا غلط تشریح کے ذمہ دار نہیں ہیں ۔
<!-- CO - OP TRANSLATOR DISCLAIMER END -->
localizeflow[bot]
3 weeks ago