chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes)

pull/1690/head
localizeflow[bot] 3 weeks ago
parent af5dd44004
commit fd134dfdf3

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:15:20+00:00",
"translation_date": "2026-02-06T12:40:40+00:00",
"source_file": "AGENTS.md",
"language_code": "bn"
},

@ -1,65 +1,65 @@
# AGENTS.md
## Project Overview
## প্রকল্পের সারমর্ম
এটি শিক্ষানবিশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর একটি শিক্ষামূলক পাঠক্রম রেপোজিটরি। এই পাঠক্রমটি এক্সপ্রেসিভ ১২-সপ্তাহের একটি সম্পূর্ণ কোর্স যা মাইক্রোসফট ক্লাউড অ্যাডভোকেটদের দ্বারা বিকাশিত, যেখানে জাভাস্ক্রিপ্ট, সিএসএস এবং এইচটিএমএল সম্পর্কিত ২৪টি প্র্যাক্টিকাল পাঠ অন্তর্ভুক্ত
এটি শিক্ষামূলক পাঠক্রমের রেপোজিটরি যা নতুনদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর জন্য তৈরি। এই পাঠক্রমটি মাইক্রোসফট ক্লাউড অ্যাডভোকেটস দ্বারা উন্নত একটি সমগ্র ১২ সপ্তাহের কোর্স, যার মধ্যে রয়েছে ২৪টি হ্যান্ডস-অন লেসন যা জাভাস্ক্রিপ্ট, CSS এবং HTML কভার করে
### Key Components
### মূল উপাদানসমূহ
- **শিক্ষামূলক বিষয়বস্তু**: ২৪টি সুশৃঙ্খল পাঠ যা প্রজেক্ট-ভিত্তিক মডিউলগুলিতে সংগঠিত
- **প্রায়োগিক প্রকল্প**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাংকিং অ্যাপ, কোড এডিটর, এবং এআই চ্যাট সহকারী
- **ইন্টারেক্টিভ কুইজ**: ৪৮টি কুইজ, প্রতিটিতে ৩টি প্রশ্ন (পাঠের পূর্ব/পরে মূল্যায়ন)
- **বহু ভাষা সমর্থন**: গিটহাব অ্যাকশনস এর মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ
- **প্রযুক্তি**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI প্রকল্পের জন্য)
- **শিক্ষামূলক বিষয়বস্তু**: ২৪টি সুগঠিত লেসন যা প্রকল্পভিত্তিক মডিউলে শ্রেণীবদ্ধ
- **ব্যবহারিক প্রকল্পসমূহ**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাঙ্কিং অ্যাপ, কোড এডিটর, এবং AI চ্যাট সহকারী
- **ইন্টারঅ্যাকটিভ কুইজ**: ৪৮টি কুইজ, প্রতিটিতে ৩টি প্রশ্ন (পূর্ব/পরবর্তী লসন মূল্যায়ন)
- **বহুভাষিক সমর্থন**: GitHub Actions এর মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ
- **প্রযুক্তি**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, পাইথন (AI প্রকল্পের জন্য)
### Architecture
### স্থাপত্য
- পাঠ-ভিত্তিক গঠন সহ শিক্ষামূলক রেপোজিটরি
- প্রতিটি পাঠ ফোল্ডারে README, কোড উদাহরণ এবং সমাধান রয়েছে
- আলাদা ডিরেক্টরিতে স্বতন্ত্র প্রকল্পসমূহ (quiz-app, বিভিন্ন পাঠ প্রকল্প)
- গিটহাব অ্যাকশনস ব্যবহার করে অনুবাদ ব্যবস্থা (co-op-translator)
- ডকুমেন্টেশন Docsify দ্বারা পরিবেশন এবং PDF আকারে উপলব্ধ
- লেসনভিত্তিক গঠন সহ শিক্ষামূলক রেপোজিটরি
- প্রতিটি লেসন ফোল্ডারে README, কোড উদাহরণ এবং সমাধান রয়েছে
- স্বাধীন প্রকল্পগুলি আলাদা ডিরেক্টরিতে (quiz-app, বিভিন্ন লেসন প্রকল্প)
- GitHub Actions (co-op-translator) ব্যবহার করে অনুবাদ ব্যবস্থা
- ডকুমেন্টেশন Docsify এর মাধ্যমে পরিবেশিত এবং PDF আকারে উপলব্ধ
## Setup Commands
## সেটআপ কমান্ডসমূহ
এই রেপোজিটরিটি মূলত শিক্ষামূলক বিষয়বস্তু ব্যবহার করার জন্য। নির্দিষ্ট প্রকল্পে কাজ করার জন্য:
এই রেপোজিটরিটি মূলত শিক্ষামূলক বিষয়বস্তু ব্যবহারর জন্য। নির্দিষ্ট প্রকল্প নিয়ে কাজ করার জন্য:
### Main Repository Setup
### প্রধান রেপোজিটরি সেটআপ
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App Setup (Vue 3 + Vite)
### কুইজ অ্যাপ সেটআপ (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 চালান
```
### Bank Project API (Node.js + Express)
### ব্যাঙ্ক প্রকল্প API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # এপিআই সার্ভার শুরু করুন
npm run lint # ESLint চালান
npm run format # Prettier দিয়ে ফরম্যাট করুন
npm run format # Prettier দিে ফরম্যাট করুন
```
### Browser Extension Projects
### ব্রাউজার এক্সটেনশন প্রকল্পসমূহ
```bash
cd 5-browser-extension/solution
npm install
# ব্রাউজার-নির্দিষ্ট এক্সটেনশন লোড করার নির্দেশগুলি অনুসরণ করুন
# ব্রাউজার-নির্দিষ্ট এক্সটেনশন লোডিং নির্দেশাবলী অনুসরণ করুন
```
### Space Game Projects
### স্পেস গেম প্রকল্পসমূহ
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# ব্রাউজারে index.html খুলুন অথবা লাইভ সার্ভার ব্যবহার করুন
```
### Chat Project (Python Backend)
### চ্যাট প্রকল্প (Python ব্যাকএন্ড)
```bash
cd 9-chat-project/solution/backend/python
@ -76,207 +76,207 @@ pip install openai
python api.py
```
## Development Workflow
## ডেভেলপমেন্ট ওয়ার্কফ্লো
### For Content Contributors
### বিষয়বস্তু অবদানকারীদের জন্য
১. আপনার গিটহাব অ্যাকাউন্টে **রেপোজিটরি ফর্ক করুন**
. **লোকালি আপনার ফর্ক ক্লোন করুন**
. আপনার পরিবর্তনের জন্য একটি **নতুন ব্রাঞ্চ তৈরি করুন**
. পাঠের বিষয়বস্তু বা কোড উদাহরণ পরিবর্তন করুন
৫. প্রাসঙ্গিক প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষা করুন
৬. অবদান নির্দেশনাগুলি অনুসরণ করে পুল রিকোয়েস্ট সাবমিট করুন
1. আপনার GitHub একাউন্টে **রেপোজিটরি ফর্ক করুন**
2. **লোকালি আপনার ফর্ক ক্লোন করুন**
3. আপনার পরিবর্তনের জন্য **নতুন ব্রাঞ্চ তৈরি করুন**
4. লেসন বিষয়বস্তু বা কোড উদাহরণ পরিবর্তন করুন
5. সংশ্লিষ্ট প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষণ করুন
6. অবদান নির্দেশিকা অনুসারে পুল রিকোয়েস্ট জমা দিন
### For Learners
### শিক্ষার্থীদের জন্য
১. রেপোজিটরি ফর্ক বা ক্লোন করুন
২. ক্রমবর্ধমান পাঠ ডিরেক্টরিতে নেভিগেট করুন
৩. প্রতিটি পাঠের README ফাইল পড়ুন
. https://ff-quizzes.netlify.app/web/ এ গিয়ে পূর্ব-পাঠ কুইজ সম্পন্ন করুন
৫. পাঠ ফোল্ডারে কোড উদাহরণগুলি অনুসরণ করুন
৬. অ্যাসাইনমেন্ট ও চ্যালেঞ্জ সম্পন্ন করুন
. পাঠের পরবর্তী কুইজ গ্রহণ করুন
1. রেপোজিটরি ফর্ক অথবা ক্লোন করুন
2. পর্যায়ক্রমে লেসন ডিরেক্টরিতে যান
3. প্রতিটি লেসনের README ফাইল পড়ুন
4. https://ff-quizzes.netlify.app/web/ এ প্রিলেসন কুইজ সম্পন্ন করুন
5. লেসন ফোল্ডারে কোড উদাহরণ ব্যবহার করুন
6. অ্যাসাইনমেন্ট এবং চ্যালেঞ্জ শেষ করুন
7. পরবর্তী লেসন কুইজ দিন
### Live Development
### লাইভ ডেভেলপমেন্ট
- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০)
- **Quiz App**: quiz-app ডিরেক্টরিতে `npm run dev` চালান
- **প্রকল্পসমূহ**: এইচটিএমএল প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- **API প্রকল্পসমূহ**: সংশ্লিষ্ট API ডিরেক্টরিতে `npm start` চালান
- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০)
- **কুইজ অ্যাপ**: quiz-app ডিরেক্টরিতে `npm run dev` চালান
- **প্রকল্পসমূহ**: HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- **API প্রকল্পসমূহ**: যথাযথ ডিরেক্টরিতে `npm start` চালান
## Testing Instructions
## টেস্টিং নির্দেশনা
### Quiz App Testing
### কুইজ অ্যাপ টেস্টিং
```bash
cd quiz-app
npm run lint # কোড স্টাইল সমস্যাগুলি পরীক্ষা করুন
npm run build # নিশ্চিত করুন বিল্ড সফল হয়
npm run lint # কোড স্টাইল সমস্যা পরীক্ষা করুন
npm run build # বিল্ড সফল হচ্ছে কিনা নিশ্চিত করুন
```
### Bank API Testing
### ব্যাঙ্ক API টেস্টিং
```bash
cd 7-bank-project/api
npm run lint # কোড স্টাইল সমস্যা পরীক্ষা করুন
node server.js # নিশ্চিত করুন সার্ভার ত্রুটি ছাড়াই শুরু হয়
npm run lint # কোড স্টাইল সমস্যাগুলো পরীক্ষা করুন
node server.js # সার্ভার ত্রুটি ছাড়াই শুরু হয় কিনা নিশ্চিত করুন
```
### General Testing Approach
### সাধারণ টেস্টিং পদ্ধতি
- এটি একটি শিক্ষামূলক রেপোজিটরি, পূর্ণাঙ্গ স্বয়ংক্রিয় পরীক্ষা নেই
- ম্যানুয়াল পরীক্ষার গুরুত্ব:
- কোড উদাহরণগুলি ত্রুটি ছাড়াই চলতে হবে
- ডকুমেন্টেশনের লিঙ্কগুলি সঠিক কাজ করবে
- প্রকল্প বিল্ড সফলভাবে সম্পন্ন হবে
- উদাহরণগুলি সর্বোত্তম অনুশীলন অনুসরণ করবে
- এটি একটি শিক্ষামূলক রেপোজিটরি যেখানে ব্যাপক স্বয়ংক্রিয় টেস্ট নেই
- ম্যানুয়াল টেস্টিং ফোকাস:
- কোড উদাহরণ ত্রুটিমুক্ত রান হওয়া
- ডকুমেন্টেশনের লিঙ্ক কাজ করা
- প্রকল্প বিল্ড সফল হওয়া
- উদাহরণসমূহে সেরা অনুশীলন অনুসরণ
### Pre-submission Checks
### সাবমিশনের পূর্ব পরীক্ষা
- package.json থাকা ডিরেক্টরিতে `npm run lint` চালান
- মার্কডাউন লিঙ্কগুলি যাচাই করুন
- ব্রাউজার বা Node.js তে কোড উদাহরণ পরীক্ষা করুন
- অনুবাদগুলো সঠিক গঠন বজায় রাখে কিনা নিশ্চিত করুন
- যেখানে package.json আছে সেখানে `npm run lint` চালান
- মার্কডাউন লিঙ্কগুলি বৈধ কিনা যাচাই করুন
- ব্রাউজার বা Node.js কোড উদাহরণ পরীক্ষা করুন
- অনুবাদগুলি সঠিক কাঠামো বজায় রাখে কিনা নিশ্চিত করুন
## Code Style Guidelines
## কোড স্টাইল গাইডলাইন
### JavaScript
### জাভাস্ক্রিপ্ট
- আধুনিক ES6+ সিনট্যাক্স ব্যবহার করুন
- প্রকল্পে দেয়া সাধা ESLint কনফিগারেশন অনুসরণ করুন
- শিক্ষামূলক স্পষ্টতার জন্য অর্থবহ ভেরিয়েবল ও ফাংশন নাম ব্যবহার করুন
- শিক্ষার্থীদের বোঝার জন্য মন্তব্য যোগ করুন
- যেখানে প্রয়োজন Prettier ব্যবহার করে ফরম্যাট করুন
- আধুনিক ES6+ সিনট্যাক্স ব্যবহার করুন
- প্রকল্পের ESLint কনফিগারেশন অনুসরণ করুন
- শিক্ষার্থীর বোঝার জন্য অর্থপূর্ণ ভেরিয়েবল ও ফাংশন নাম ব্যবহার করুন
- বিষয়বস্তু ব্যাখ্যার জন্য মন্তব্য যোগ করুন
- Prettier দ্বারা ফরম্যাট করুন যেখানে কনফিগার করা আছে
### HTML/CSS
- সেম্যান্টিক HTML5 উপাদান ব্যবহার করুন
- রেসপনসিভ ডিজাইন নীতিমালা অনুসরণ করুন
- স্পষ্ট ক্লাস নামকরণের নিয়ম মেনে চলুন
- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যার মন্তব্য যোগ করুন
- সেম্যান্টিক HTML5 উপাদান ব্যবহার করুন
- রেসপনসিভ ডিজাইন নীতিমালা অনুসরণ করুন
- স্পষ্ট ক্লাস নামকরণ সিস্টেম
- CSS টেকনিক ব্যাখ্যার জন্য মন্তব্য যোগ করুন
### Python
### পাইথন
- PEP 8 স্টাইল গাইড অনুসরণ করুন
- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ দিন
- শেখার জন্য সুবিধাজনক হলে টাইপ হিন্ট ব্যবহার করুন
- PEP 8 শৈলী নির্দেশিকা অনুসরণ করুন
- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ দিন
- শেখার সুবিধার জন্য টাইপ হিন্ট ব্যবহার করুন
### Markdown Documentation
### মার্কডাউন ডকুমেন্টেশন
- স্পষ্ট শিরোনাম কাঠামো বজায় রাখুন
- ভাষা নির্দিষ্ট কোড ব্লক ব্যবহার করুন
- অতিরিক্ত রিসোর্সের লিঙ্ক দিন
- `images/` ডিরেক্টরিতে স্ক্রিনশট ও ছবি রাখুন
- অ্যাক্সেসিবিলিটির জন্য ইমেজের জন্য Alt টেক্সট দিন
- স্পষ্ট হেডিং স্তর
- ভাষা নির্দিষ্ট কোড ব্লক
- অতিরিক্ত রিসোর্সের জন্য লিঙ্ক
- `images/` ডিরেক্টরির স্ক্রিনশট এবং ছবি
- প্রবেশাধিকারতার জন্য ছবির জন্য অল্ট টেক্সট
### File Organization
### ফাইল সংগঠন
- পাঠগুলো ধারাবাহিক নম্বর অনুসারে (১-getting-started-lessons, ২-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}/` গঠনে থাকে
## Build and Deployment
## বিল্ড এবং ডিপ্লয়মেন্ট
### Quiz App Deployment (Azure Static Web Apps)
### কুইজ অ্যাপ ডিপ্লয়মেন্ট (Azure Static Web Apps)
Quiz-app টি Azure Static Web Apps ডিপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে:
কুইজ-অ্যাপ Azure Static Web Apps ডিপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে:
```bash
cd quiz-app
npm run build # dist/ ফোল্ডার তৈরি করে
# মেইন ব্রাঞ্চে পুশ করার মাধ্যমে GitHub Actions ওয়ার্কফ্লো দ্বারা ডিপ্লয় করে
# main-এ push করার পর 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`
### Documentation PDF Generation
### ডকুমেন্টেশন PDF জেনারেশন
```bash
npm install # docsify-to-pdf ইনস্টল করুন
npm run convert # ডকস থেকে PDF তৈরি করুন
npm run convert # ডকস থেকে PDF তৈরি করুন
```
### Docsify Documentation
### Docsify ডকুমেন্টেশন
```bash
npm install -g docsify-cli # গ্লোবালি Docsify ইনস্টল করুন
docsify serve # লোকালহোস্ট:3000 এ সার্ভ করুন
npm install -g docsify-cli # Docsify গ্লোবালি ইনস্টল করুন
docsify serve # localhost:3000 এ সার্ভ করুন
```
### Project-specific Builds
### প্রকল্প-নির্দিষ্ট বিল্ড
প্রতিটি প্রকল্পের নিজস্ব বিল্ড প্রক্রিয়া থাকতে পারে:
- Vue প্রকল্প: `npm run build` ব্যবহার করে প্রোডাকশন বান্ডল তৈরি হয়
- স্ট্যাটিক প্রকল্প: বিল্ড ধাপ নেই, সরাসরি ফাইল পরিবেশন
প্রতিটি প্রকল্প ডিরক্টরির নিজস্ব বিল্ড প্রক্রিয়া থাকতে পারে:
- Vue প্রকল্প: `npm run build` প্রোডাকশন বান্ডেল তৈরি করে
- স্ট্যাটিক প্রকল্প: কোন বিল্ড ধাপ নেই, সরাসরি ফাইল পরিবেশন
## Pull Request Guidelines
## পুল রিকোয়েস্ট গাইডলাইন
### Title Format
### শিরোনাম ফরম্যাট
পরিবর্তনের ক্ষেত্রটি স্পষ্টভাবে বুঝিয়ে শিরোনাম দিন:
- `[Quiz-app] পাঠ X এর জন্য নতুন কুইজ যুক্ত করুন`
- `[Lesson-3] টেরারিয়াম প্রকল্পের টাইপো ঠিক করুন`
- `[Translation] পাঠ ৫ এর জন্য স্প্যানিশ অনুবাদ যোগ করুন`
- `[Docs] সেটআপ নির্দেশাবলী আপডেট করুন`
পরিবর্তনের ক্ষেত্র স্পষ্ট করে বর্ণনামূলক শিরোনাম ব্যবহার করুন:
- `[Quiz-app] নতুন কুইজ যোগ করুন লেসন X এর জন্য`
- `[Lesson-3] টেরারিয়াম প্রকল্পে টাইপো সংশোধন`
- `[Translation] লেসন ৫ এর জন্য স্প্যানিশ অনুবাদ যোগ`
- `[Docs] সেটআপ নির্দেশাবলী আপডেট`
### Required Checks
### প্রয়োজনীয় পরীক্ষা
PR সাবমিট করার আগে:
PR জমা দেওয়ার আগে:
১. **কোড মান**:
   - প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান
   - সব লিন্টিং ত্রুটি এবং সতর্কতা সংশোধন করুন
1. **কোড গুণমান**:
- প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান
- সকল লিন্টিং ত্রুটি এবং সতর্কতা ঠিক করুন
২. **বিল্ড যাচাই**:
   - প্রয়োজনে `npm run build` চালান
   - কোন বিল্ড ত্রুটি নেই কিনা নিশ্চিত করুন
2. **বিল্ড যাচাই**:
- প্রয়োজনে `npm run build` চালান
- কোন বিল্ড ত্রুটি নেই নিশ্চিত করুন
৩. **লিঙ্ক যাচাই**:
   - সব মার্কডাউন লিঙ্ক পরীক্ষা করুন
   - ইমেজ রেফারেন্স ঠিক আছে কিনা নিশ্চিত করুন
3. **লিঙ্ক ভ্যালিডেশন**:
- সব মার্কডাউন লিঙ্ক পরীক্ষা করুন
- ছবির রেফারেন্স কাজ করে কিনা যাচাই করুন
. **বিষয়বস্তু পর্যালোচনা**:
   - বানান ও ব্যাকরণ পরীক্ষা করুন
   - কোড উদাহরণ সঠিক ও শিক্ষামূলক কিনা নিশ্চিত করুন
   - অনুবাদ মূল মান অর্থ ঠিক রাখে কিনা যাচাই করুন
4. **বিষয়বস্তু পর্যালোচনা**:
- বানান এবং ব্যাকরণ পরীক্ষা করুন
- কোড উদাহরণ সঠিক এবং শিক্ষামূলক কিনা দেখুন
- অনুবাদগুলি মূল অর্থ বজায় রাখে কিনা যাচাই করুন
### Contribution Requirements
### অবদানের শর্তাবলী
- 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 বিবরণে ইস্যু নম্বর উল্লেখ করুন
### Review Process
### পর্যালোচনা প্রক্রিয়া
- PR গুলো রক্ষণাবেক্ষক ও কমিউনিটির দ্বারা পর্যালোচনা হয়
- শিক্ষামূলক স্পষ্টতায় গুরুত্ব দেওয়া হয়
- কোড উদাহরণগুলি সর্বশেষ শ্রেষ্ঠ অনুশীলন অনুসরণ করবে
- অনুবাদ সঠিকতা ও সাংস্কৃতিক প্রাসঙ্গিকতা যাচাই করা হয়
- PR রক্ষণাবেক্ষক এবং কমিউনিটি দ্বারা পর্যালোচনা হয়
- শিক্ষামূলক স্পষ্টতা অগ্রাধিকার পায়
- কোড উদাহরণ সমসাময়িক সেরা অনুশীলন অনুসরণ করে
- অনুবাদ সঠিকতা ও সাংস্কৃতিক উপযুক্ততা যাচাই করা হয়
## Translation System
## অনুবাদ ব্যবস্থা
### Automated Translation
### স্বয়ংক্রিয় অনুবাদ
- GitHub Actions এ co-op-translator ওয়ার্কফ্লো ব্যবহার
- স্বয়ংক্রিয়ভাবে ৫০+ ভাষায় অনুবাদ
- মূল ফাইল প্রধান ডিরেক্টরিতে থাকে
- অনূদিত ফাইল `translations/{language-code}/` ডিরেক্টরিতে থাকে
- GitHub Actions এ co-op-translator ওয়ার্কফ্লো ব্যবহার
- ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ
- মূল ফাইল প্রধান ডিরেক্টরিতে
- অনূদিত ফাইলসমূহ `translations/{language-code}/` ডিরেক্টরিতে
### Adding Manual Translation Improvements
### ম্যানুয়াল অনুবাদ উন্নতি যোগ করা
১. `translations/{language-code}/` ডিরেক্টরিতে ফাইলটি খুঁজুন
২. কাঠামো বজায় রেখে উন্নতি করুন
৩. কোড উদাহরণগুলোর কার্যকারিতা বজায় রাখুন
. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন
1. `translations/{language-code}/` এ ফাইল খুঁজে বের করুন
2. কাঠামো অক্ষুন্ন রেখে উন্নতি করুন
3. কোড উদাহরণ কার্যকর থাকে নিশ্চিত করুন
4. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন
### Translation Metadata
### অনুবাদ মেটাডাটা
অনূদিত ফাইলগুলিতে মেটাডেটা হেডার থাকে:
অনূদিত ফাইলগুলিতে মেটাডাটা হেডার থাকে:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Debugging and Troubleshooting
## ডিবাগিং ও সমস্যার সমাধান
### Common Issues
### সাধারণ সমস্যা
**কুইজ অ্যাপ শুরু হয় না**:
- Node.js সংস্করণ পরীক্ষা করুন (v14+ প্রস্তাবিত)
- `node_modules` এবং `package-lock.json` মুছে পুনরায় `npm install` চালান
- পোর্ট সংঘর্ষ পরীক্ষা করুন (ডিফল্ট: Vite পোর্ট ৫১৭৩)
**কুইজ অ্যাপ শুরু হচ্ছে না**:
- Node.js সংস্করণ পরীক্ষা করুন (v14+ সুপারিশকৃত)
- `node_modules` `package-lock.json` মুছে `npm install` আবার চালান
- পোর্ট সংঘর্ষ আছে কিনা দেখুন (ডিফল্ট: Vite পোর্ট ৫১৭৩)
**API সার্ভার শুরু হয় না**:
- Node.js সংস্করণ ন্যূনতম (node >=10) যাচাই করুন
- পোর্ট ইতিমধ্যে ব্যবহৃত হচ্ছে কিনা পরীক্ষা করুন
- সব নির্ভরশীলতা `npm install` দিয়ে ইনস্টল করেছেন কিনা নিশ্চিত করুন
**API সার্ভার শুরু হচ্ছে না**:
- Node.js কমপক্ষে node >=10 কিনা যাচাই করুন
- পোর্ট ব্যবহারযোগ্য কিনা দেখুন
- সব ডিপেনডেন্সি `npm install` দিয়ে ইনস্টল আছে কিনা নিশ্চিত করুন
**ব্রাউজার এক্সটেনশন লোড হয় না**:
- manifest.json সঠিক ফরম্যাটে আছে কিনা পরীক্ষা করুন
- ব্রাউজার কনসোলে ত্রুটি খুঁজু
- ব্রাউজার-ভিত্তিক এক্সটেনশন ইনস্টলেশন নির্দেশনা অনুসরণ করুন
**ব্রাউজার এক্সটেনশন লোড হচ্ছে না**:
- manifest.json সঠিক ফরম্যাটে আছে কিনা যাচাই করুন
- ব্রাউজার কনসোলে ত্রুটি দেখুন
- ব্রাউজার-নির্দিষ্ট এক্সটেনশন ইনস্টলেশন নির্দেশনা অনুসরণ করুন
**পাইথন চ্যাট প্রকল্প সমস্যা**:
- নিশ্চিত করুন OpenAI প্যাকেজ ইনস্টল হয়েছে: `pip install openai`
- GITHUB_TOKEN পরিবেশ ভেরিয়েবল সেট করা আছে
- GitHub Models অ্যাক্সেস অনুমতি পরীক্ষা করুন
**পাইথন চ্যাট প্রকল্প সমস্যা**:
- 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` আছে কিনা যাচাই করুন
### Development Environment Tips
### ডেভেলপমেন্ট পরিবেশ টিপস
- HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- সামঞ্জস্যপূর্ণ ফরম্যাটের জন্য ESLint এবং Prettier এক্সটেনশন ইনস্টল করুন
- জাভাস্ক্রিপ্ট ডিবাগ করার জন্য ব্রাউজার DevTools ব্যবহার করুন
- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন
- HTML প্রকল্পের জন্য VS Code এর Live Server এক্সটেনশন ব্যবহার করুন
- ধারাবাহিক ফরম্যাটিং এর জন্য ESLint এবং Prettier এক্সটেনশন ইনস্টল করুন
- জাভাস্ক্রিপ্ট ডিবাগিং এর জন্য ব্রাউজার DevTools ব্যবহার করুন
- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন
### Performance Considerations
### কর্মক্ষমতা বিবেচনা
- অনুবাদ ফাইলের সংখ্যা বেশি (৫০+ ভাষা) হওয়ায় ফুলো ক্লোন বড় হয়
- শুধুমাত্র বিষয়বস্তুে কাজ করলে শ্যালো ক্লোন ব্যবহার করুন: `git clone --depth 1`
- ইংরেজি বিষয়বস্তুতে কাজ করার সময় অনুবাদ ফাইল অনুসন্ধান থেকে বাদ দিন
- প্রথম রান-এ বিল্ড প্রক্রিয়া ধীর হতে পারে (npm install, Vite build)
- অনেক অনূদিত ফাইল (৫০+ ভাষা) থাকার কারণে পুরো ক্লোন বড় হবে
- শুধুমাত্র বিষয়বস্তু নিয়ে কাজ করলে শ্যালো ক্লোন ব্যবহার করুন: `git clone --depth 1`
- ইংরেজি বিষয়বস্তুতে কাজ করার সময় অনুবাদের উপর অনুসন্ধান বাদ দিন
- বিল্ড প্রক্রিয়া প্রথম চালনার সময় ধীর হতে পারে (npm install, Vite build)
## Security Considerations
## সুরক্ষা বিবেচনা
### Environment Variables
### পরিবেশ ভেরিয়েবল
- API কী গুলি কখনো রেপোজিটরিতে কমিট করবেন না
- `.env` ফাইল ব্যবহার করুন (যা `.gitignore` এ আছে)
- প্রকল্প README ফাইলে প্রয়োজনীয় পরিবেশ ভেরিয়েবল ডকুমেন্ট করুন
- API কী কখনই রেপোজিটরিতে কমিট করবেন না
- `.env` ফাইল ব্যবহার করুন (`.gitignore` তে অন্তর্ভুক্ত)
- প্রকল্পের README এ প্রয়োজনীয় পরিবেশ ভেরিয়েবলগুলি ডকুমেন্ট করুন
### Python Projects
### পাইথন প্রকল্পসমূহ
- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv`
- নির্ভরশীলতা আপ টু ডেট রাখুন
- GitHub টোকেনগুলির সর্বনিম্ন প্রয়োজনীয় অনুমতি থাকা উচিত
- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv`
- ডিপেনডেন্সি আপডেট রাখুন
- GitHub টোকেনের ন্যূনতম প্রয়োজনীয় অনুমতি দিন
### GitHub Models Access
### GitHub Models অ্যাক্সেস
- GitHub Models-এ ব্যবহারের জন্য Personal Access Tokens (PAT) প্রয়োজন
- টোকেনগুলো পরিবেশ ভেরিয়েবল হিসাবে সংরক্ষণ করুন
- কখনো টোকেন বা ক্রিডেনশিয়ালস কমিট করবেন না
- GitHub Models এর জন্য পার্সোনাল অ্যাক্সেস টোকেন (PAT) প্রয়োজন
- টোকেনগুলি পরিবেশ ভেরিয়েবল হিসেবে সংরক্ষণ করুন
- কখনও টোকেন বা বিশ্বাসযোগ্যতা কমিট করবেন না
## Additional Notes
## অতিরিক্ত নোট
### Target Audience
### লক্ষ্যমাত্রা শ্রোতা
- ওয়েব ডেভেলপমেন্টের সম্পূর্ণ শিক্ষানবিশ
- ছাত্র-ছাত্রী এবং স্বশিক্ষার্থীরা
- শ্রেণিকক্ষে এই পাঠক্রম ব্যবহারকারী শিক্ষক
- বিষয়বস্তু অ্যাক্সেসযোগ্য এবং ধীরে ধীরে দক্ষতা বৃদ্ধির জন্য ডিজাইন করা হয়েছে
- ওয়েব ডেভেলপমেন্টে সম্পূর্ণ নতুন
- শিক্ষার্থী ও স্বশিক্ষার্থীরা
- শ্রেণীকক্ষে শিক্ষার্থীদের জন্য শিক্ষকগণ
- প্রবেশযোগ্যতা ও ধাপে ধাপে দক্ষতা বৃদ্ধির জন্য বিষয়বস্তু তৈরি
### Educational Philosophy
### শিক্ষাদর্শন
- প্রকল্প-ভিত্তিক শেখার পদ্ধতি
- নিয়মিত জ্ঞানের পরীক্ষা (কুইজ)
- হাতে-কলমে কোডিং অনুশীলন
- বাস্তব জীবনের উদাহরণ
- ফ্রেমওয়ার্কের আগে মৌলিক বিষয়গুলিত জো
- প্রকল্পভিত্তিক শেখার পদ্ধতি
- নিয়মিত জ্ঞান যাচাই (কুইজ)
- হাতেকলমে কোডিং অনুশীলন
- বাস্তব জগতের উদাহরণসমূহ
- ফ্রেমওয়ার্কের আগে মৌলিক বিষয়ের উপর গুরুত্ব
### Repository Maintenance
### রেপোজিটরি রক্ষণাবেক্ষণ
- শিখতে চাওয়া ও অবদানকারীদের সক্রিয় কমিউনিটি
- নির্ভরশীলতা ও বিষয়বস্তু নিয়মিত আপডেট হয়
- রক্ষণাবেক্ষক দ্বারা ইস্যু ও আলোচনা পর্যবেক্ষণ করা হয়
- অনুবাদ আপডেট গিটহাব অ্যাকশনস দ্বারা স্বয়ংক্রিয়ভাবে হয়
- সক্রিয় শিক্ষার্থী ও অবদানকারীদের কমিউনিটি
- ডিপেনডেন্সি ও বিষয়বস্তু নিয়মিত আপডেট
- রক্ষণাবেক্ষক দ্বারা সমস্যা ও আলোচনার নজরদারি
- অনুবাদ আপডেট স্বয়ংক্রিয় via GitHub Actions
### Related Resources
### সম্পর্কিত রিসোর্স
- [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 পাঠক্রম উপলব্ধ
- [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) সুপারিশকৃত
- অতিরিক্ত কোর্স: Generative AI, Data Science, ML, IoT পাঠক্রম উপলব্ধ
### Working with Specific Projects
### নির্দিষ্ট প্রকল্পের সাথে কাজ
নির্দিষ্ট প্রকল্পের বিস্তারিত নির্দেশনা জন্য সংশ্লিষ্ট 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 চ্যাট সহকারী প্রকল্প
### Monorepo Structure
### মনোরেপো গঠন
পুরোপুরি মনোরেপো না হলেও, এই রেপোজিটরিতেই একাধিক স্বতন্ত্র প্রকল্প আছে:
- প্রতিটি পাঠ স্বতন্ত্র
- প্রকল্পগুলো নির্ভরশীলতা শেয়ার করে না
- একক প্রকল্পে কাজ করলে অন্য প্রভাবিত হয় না
- সম্পূর্ণ পাঠক্রম অভিজ্ঞতার জন্য পুরো রেপো ক্লোন করুন
এটি ঐতিহ্যবাহী মনোরেপো নয়, কিন্তু এখানে একাধিক স্বতন্ত্র প্রকল্প রয়েছে:
- প্রতিটি লেসন স্বনির্ভর
- প্রকল্পসমূহ ডিপেনডেন্সি শেয়ার করে না
- প্রকল্পভিত্তিক কাজ বিনা বাধায় করতে পারবেন
- পুরো পাঠক্রম অভিজ্ঞতার জন্য পুরো রেপো ক্লোন করুন
---
<!-- 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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:14:03+00:00",
"translation_date": "2026-02-06T12:39:29+00:00",
"source_file": "AGENTS.md",
"language_code": "hi"
},

@ -2,56 +2,56 @@
## परियोजना अवलोकन
यह शुरुआती लोगों को वेब विकास के मूल सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपोजिटरी है। यह पाठ्यक्रम एक व्यापक 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 हैंड्स-ऑन लेसन शामिल हैं।
यह शुरुआती लोगों को वेब विकास के मूल सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉजिटरी है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ शामिल हैं।
### मुख्य घटक
- **शैक्षिक सामग्री**: 24 संरचित लेसन जिन्हें प्रोजेक्ट-आधारित मॉड्यूल में व्यवस्थित किया गया है
- **प्रायोगिक प्रोजेक्ट्स**: टेरारियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड एडिटर, और AI चैट सहायक
- **इंटरैक्टिव क्विज़**: 48 क्विज़ हर एक में 3 प्रश्न (प्री/पोस्ट-लेसन आकलन)
- **बहुभाषी समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए ऑटोमैटिक अनुवाद
- **प्रौद्योगिकियाँ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रोजेक्ट्स के लिए)
- **शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ
- **व्यावहारिक परियोजनाएं**: टेरारियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड एडिटर, और AI चैट असिस्टेंट
- **इंटरएक्टिव क्विज़**: प्रत्येक में 3 प्रश्नों के साथ 48 क्विज़ (पाठ के पूर्व/पश्चात आकलन)
- **बहुभाषी समर्थन**: 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 के रूप में भी
## सेटअप कमांड्स
## सेटअप कमांड
यह रिपोजिटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट प्रोजेक्ट्स पर काम करने के लिए:
यह रिपॉजिटरी मुख्य रूप से शैक्षिक सामग्री उपयोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
### मुख्य रिपजिटरी सेटअप
### मुख्य रिपजिटरी सेटअप
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### क्विज ऐप सेटअप (Vue 3 + Vite)
### क्विज ऐप सेटअप (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # विकास सर्वर शुरू करें
npm run build # उत्पादन के लिए बनाएँ
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 # API सर्वर शुरू करें
npm start # एपीआई सर्वर शुरू करें
npm run lint # ESLint चलाएं
npm run format # Prettier के साथ फॉर्मेट करें
```
### ब्राउज़र एक्सटेंशन प्रोजेक्ट्स
### ब्राउज़र एक्सटेंशन परियोजनाएं
```bash
cd 5-browser-extension/solution
@ -59,15 +59,15 @@ npm install
# ब्राउज़र-विशिष्ट एक्सटेंशन लोडिंग निर्देशों का पालन करें
```
### स्पेस गेम प्रोजेक्ट्स
### स्पेस गेम परियोजनाएं
```bash
cd 6-space-game/solution
npm install
# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें
# ब्राउज़र में index.html खोलें या Live Server का उपयोग करें
```
### चैट प्रोजेक्ट (Python बैकएंड)
### चैट परियोजना (Python बैकएंड)
```bash
cd 9-chat-project/solution/backend/python
@ -80,112 +80,112 @@ python api.py
### सामग्री योगदानकर्ताओं के लिए
1. **रिपोजिटरी को फोर्क करें** अपने GitHub खाते पर
2. **अपने फोर्क को स्थानीय रूप से क्लोन करें**
3. **अपने परिवर्तनों के लिए नई ब्रांच बनाएं**
4. लेसन सामग्री या कोड उदाहरणों में बदलाव करें
5. संबंधित प्रोजेक्ट डायरेक्टरीज में किसी भी कोड परिवर्तन का परीक्षण करें
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)
- **क्विज ऐप**: quiz-app डायरेक्ट्री में `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 परीक्षण
```bash
cd 7-bank-project/api
npm run lint # कोड शैली की समस्याओं की जांच करें
node server.js # सत्यापित करें कि सर्वर बिना त्रुटियों के शुरू होता है
npm run lint # कोड स्टाइल की समस्याओं के लिए जाँच करें
node server.js # सुनिश्चित करें कि सर्वर बिना त्रुटियों के शुरू होता है
```
### सामान्य परीक्षण दृष्टिकोण
- यह एक शैक्षिक रिपजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण मुख्य रूप से निम्न पर केंद्रित है:
- कोड उदाहरण त्रुटि के बिना चलते हैं
- डॉक्यूमेंटेशन में लिंक सही ढंग से काम करते हैं
- प्रोजेक्ट बिल्ड सफलतापूर्वक पूरा होते हैं
- यह एक शैक्षिक रिपजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैन्युअल परीक्षण इस पर केंद्रित है:
- कोड उदाहरण त्रुटि मुक्त रूप से चलते हैं
- दस्तावेज़ीकरण में लिंक सही काम करते हैं
- परियोजना की बिल्ड सफलतापूर्वक पूरी होती है
- उदाहरण सर्वोत्तम प्रथाओं का पालन करते हैं
### पूर्व-प्रस्तुति चेक्स
### प्रेषण से पहले जांच
- पैकेज.json वाली डायरेक्ट्रीज़ में `npm run lint` चलाएं
- मार्कडाउन लिंक वैध हैं यह सत्यापित करें
- package.json वाली निर्देशिकाओं में `npm run lint` चलाएं
- मार्कडाउन लिंक की वैधता जांचें
- ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें
- जांचें कि अनुवाद संरचना बनाए रख है
- जांचें कि अनुवाद संरचना को सही ढंग से बनाए रखें
## कोड स्टाइल दिशानिर्देश
## कोड शैली दिशा-निर्देश
### JavaScript
- आधुनिक ES6+ वाक्य रचना का उपयोग करें
- प्रोजेक्ट्स में उपलब्ध मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए अर्थपूर्ण वेरिएबल और फंक्शन नामों का उपयोग करें
- आधुनिक ES6+ सिंटैक्स का उपयोग करें
- परियोजनाओं में प्रदान किए गए मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए अर्थपूर्ण वेरिएबल और फंक्शन नाम उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं को समझाने वाले कमेंट्स जोड़ें
- जहां आवश्यक हो Prettier से फॉर्मेट करें
- Prettier से स्वरूपण करें जहां कॉन्फ़िगर हो
### HTML/CSS
- सेमांटिक HTML5 तत्वों का उपयोग
- रिस्पॉन्सिव डिजाइन सिद्धांतों का पालन
- स्पष्ट क्लास नामकरण सम्मेलन
- शिक्षार्थियों के लिए CSS तकनीकों को समझाने वाले कमेंट्स
- सेमेंटिक HTML5 तत्व
- उत्तरदायी डिज़ाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंशंस
- CSS तकनीकों को समझाने वाले कमेंट्स शिक्षार्थियों के लिए
### Python
- PEP 8 शैली दिशानिर्देशों का पालन करें
- PEP 8 शैली दिशानिर्देश
- स्पष्ट, शैक्षिक कोड उदाहरण
- सीखने में मदद के लिए जहां सहायक हो टाइप हिंट्स
- सीखने के लिए उपयोगी होने पर टाइप हिंट्स
### मार्कडाउन डॉक्यूमेंटेशन
### Markdown दस्तावेज़ीकरण
- स्पष्ट हेडिंग संरचना
- स्पष्ट हेडिंग पदानुक्रम
- भाषा विनिर्देशन के साथ कोड ब्लॉक्स
- अतिरिक्त संसाधनों के लिंक
- `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 परिनियोजन के लिए कॉन्फ़िगर है:
quizz-app Azure Static Web Apps के लिए कॉन्फ़िगर है:
```bash
cd quiz-app
npm run build # dist/ फ़ोल्डर बनाता है
# मुख्य शाखा पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है
# मुख्य शाखा में पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है
```
Azure Static Web Apps कॉन्फ़िगरेशन:
@ -193,90 +193,90 @@ Azure Static Web Apps कॉन्फ़िगरेशन:
- **आउटपुट स्थान**: `dist`
- **वर्कफ़्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### डॉक्यूमेंटेशन PDF जनरेशन
### दस्तावेज़ीकरण PDF निर्माण
```bash
npm install # docsify-to-pdf इंस्टॉल करें
npm run convert # docs से PDF बनाए
npm install # docsify-to-pdf स्थापित करें
npm run convert # docs से PDF जनरेट करे
```
### Docsify डॉक्यूमेंटेशन
### Docsify दस्तावेज़ीकरण
```bash
npm install -g docsify-cli # Docisfy को वैश्विक रूप से इंस्टॉल करें
npm install -g docsify-cli # Docsify को वैश्विक रूप से स्थापित करें
docsify serve # localhost: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` चलाएं
- सभी लिंटिंग त्रुटि और वार्निंग्स को ठीक करें
- प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएं
- सभी लिंटिंग त्रुटियों और चेतावनियों को ठीक करें
2. **बिल्ड सत्यापन**:
- उपयुक्त होने पर `npm run build` चलाएं
- सुनिश्चित करें कि बिल्ड त्रुटियां न हों
- लागू होने पर `npm run build` चलाएं
- सुनिश्चित करें कि कोई बिल्ड त्रुटि नहीं है
3. **लिंक मान्यता**:
3. **लिंक सत्यापन**:
- सभी मार्कडाउन लिंक का परीक्षण करें
- छवि संदर्भों की जांच करें
4. **सामग्री समीक्षा**:
- वर्तनी और व्याकरण की जांच करें
- सुनिश्चित करें कि कोड उदाहरण सही और शैक्षिक हैं
- अनुवाद मूल अर्थ बनाए रखें
- जांचें कि अनुवाद मूल अर्थ बनाए रख है
### योगदान आवश्यकताए
### योगदान आवश्यकताए
- Microsoft CLA से सहमति दें (पहले PR पर स्वचालित जांच)
- Microsoft CLA (पहली PR पर स्वचालित जांच) से सहमति दें
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) का पालन करें
- विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](./CONTRIBUTING.md) देखें
- यदि लागू हो तो PR विवरण में इश्यू नंबर का संदर्भ दें
- यदि लागू हो तो PR विवरण में इश्यू नंबर संदर्भित करें
### समीक्षा प्रक्रिया
- PR की समीक्षा मेंटेनर्स और समुदाय द्वारा की जाएगी
- PR मेंटेनर्स और समुदाय द्वारा समीक्षा किए जाते हैं
- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए
- अनुवादों की सटीकता और सांस्कृतिक उपयुक्तता की समीक्षा की जाती है
- कोड उदाहरण वर्तमान सर्वोत्तम प्रथाओं का पालन करें
- अनुवाद की सटीकता और सांस्कृतिक उपयुक्तता की समीक्षा की जाती है
## अनुवाद प्रणाली
### स्वचालित अनुवाद
- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग करता है
- 50+ भाषाओं के लिए स्वचालित अनुवाद करता है
- स्रोत फाइलें मुख्य डायरेक्टरीज़ में है
- अनूदित फाइलें `translations/{language-code}/` डायरेक्टरीज़ में
- 50+ भाषाओं में स्वचालित अनुवाद करता है
- स्रोत फ़ाइलें मुख्य निर्देशिकाओं मे
- अनुवादित फ़ाइलें `translations/{language-code}/` निर्देशिकाओं में
### मैनुअल अनुवाद सुधार जोड़ना
1. फाइल को `translations/{language-code}/` में खोजें
1. `translations/{language-code}/` में फ़ाइल खोजें
2. संरचना बनाए रखते हुए सुधार करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील बने रहे
4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
3. सुनिश्चित करें कि कोड उदाहरण काम कर रहे है
4. किसी भी स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
### अनुवाद मेटाडेटा
अनूदित फाइलों में मेटाडेटा हेडर शामिल होता है:
अनुवादित फ़ाइलों में मेटाडेटा हेडर शामिल होता है:
```markdown
<!--
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` चलाएं
- पोर्ट संघर्ष जांचें (डिफ़ॉल्ट: Vite पोर्ट 5173 उपयोग करता है)
**API सर्वर शुरू नहीं हो रहा**:
- जांचें Node.js संस्करण न्यूनतम आवश्यक (node >=10)
- देखें कि पोर्ट पहले से उपयोग में तो नहीं है
- सभी निर्भरताएं `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 मॉडल्स की एक्सेस अनुमतियाँ देखें
**Docsify डॉक नहीं सर्व कर रहा**:
**Docsify दस्तावेज़ नहीं सर्व हो रहा**:
- 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 एक्सटेंशन इंस्टॉल करें
- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue प्रोजेक्ट्स के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
### प्रदर्शन विचार
- अनुवादित फाइलों (50+ भाषाओं) की बड़ी संख्या के कारण पूरी क्लोनिंग बड़ी होती है
- केवल सामग्री पर काम करने के लिए shallow clone का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवादों को खोज से बाहर रें
- बिल्ड प्रक्रिया पहली बार धीमी हो सकती है (npm install, Vite बिल्ड)
- अनुवादित फ़ाइलों की बड़ी संख्या (50+ भाषाएं) पूर्ण क्लोन बड़े बनाते हैं
- केवल सामग्री पर काम करना है तो शैलो क्लोन का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवादों को खोज से बाहर रें
- पहली बार रन (npm install, Vite बिल्ड) में बिल्ड प्रक्रियाएं धीमी हो सकती हैं
## सुरक्षा विचार
### पर्यावरण चर
- API कुंजी कभी भी रिपोजिटरी में कमिट न करें
- `.env` फाइल्स का उपयोग करें (पहले से `.gitignore` में रखा गया है)
- आवश्यक पर्यावरण चर प्रोजेक्ट README में दस्तावेजीकृत करें
- API चाबियां कभी रिपॉजिटरी में कमिट न करें
- `.env` फाइलों का उपयोग करें (पहले से `.gitignore` में है)
- आवश्यक पर्यावरण चर परियोजना के README में दस्तावेज़ करें
### Python प्रोजेक्ट्स
### Python परियोजनाएं
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- निर्भरताओं को अपडेट रखें
- GitHub टोकन न्यूनतम आवश्यक अनुमतिया रखें
- GitHub टोकन के लिए न्यूनतम आवश्यक अनुमतिया रखें
### GitHub Models एक्सेस
### GitHub मॉडल एक्सेस
- GitHub Models के लिए Personal Access Tokens (PAT) आवश्यक हैं
- टोकन पर्यावरण चर के रूप में स्टोर करें
- टोकन या क्रेडेंशियल्स कभी कमिट न करें
- GitHub मॉडल्स के लिए पर्सनल एक्सेस टोकन (PAT) आवश्यक है
- टोकन को पर्यावरण चर के रूप में स्टोर करें
- टोकन या क्रेडेंशियल्स को कभी कमिट न करें
## अतिरिक्त नोट्स
### लक्षित दर्शक
- वेब विकास के पूर्ण शुरुआत करने वाले
- छात्र और स्वयं-अध्ययनकर्ता
- कक्षा में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुंच योग्य और धीरे-धीरे कौशल निर्माण के लिए डिज़ाइन की गई है
- वेब विकास में पूरी तरह से शुरुआती
- छात्र और स्व-शিক্ষार्थी
- कक्षाओं में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुंच योग्य और क्रमिक कौशल निर्माण के लिए डिज़ाइन की गई है
### शैक्षिक दर्शन
- प्रोजेक्ट-आधारित शिक्षा दृष्टिकोण
- परियोजना-आधारित सीखने का दृष्टिकोण
- बार-बार ज्ञान जांच (क्विज़)
- हैंड्स-ऑन कोडिंग अभ्यास
- हाथों-हाथ कोडिंग अभ्यास
- वास्तविक दुनिया के अनुप्रयोग उदाहरण
- फ्रेमवर्क से पहले मूल सिद्धांतों पर ध्यान केंद्रित
- फ्रेमवर्क्स से पहले मूल बातें पर ध्यान केंद्रित
### रिपजिटरी रखरखाव
### रिपजिटरी रखरखाव
- सक्रिय शिक्षार्थी और योगदानकर्ता समुदाय
- निर्भरताओं और सामग्री का नियमित अपडेट
- मेंटेनर्स द्वारा मुद्दों और चर्चाओं की निगरानी
- मेंटेनर्स द्वारा मुद्द और चर्चाओं की निगरानी
- 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)
- अतिरिक्त कोर्स: जनरेटिव AI, डेटा साइंस, ML, IoT पाठ्यक्रम उपलब्ध
### विशिष्ट प्रोजेक्ट्स के साथ काम करना
### विशिष्ट परियोजनाओं के साथ काम करना
व्यक्तिगत प्रोजेक्ट पर विस्तृत निर्देशों के लिए निम्न README फाइलें देखें:
व्यक्तिगत परियोजनाओं पर विस्तृत निर्देशों के लिए, निम्न README फाइल देखें:
- `quiz-app/README.md` - Vue 3 क्विज़ एप्लिकेशन
- `7-bank-project/README.md` - ऑथेंटिकेशन के साथ बैंकिंग एप्लिकेशन
- `5-browser-extension/README.md` - ब्राउज़र एक्सटेंशन डेवलपमेंट
- `7-bank-project/README.md` - प्रमाणीकरण के साथ बैंकिंग एप्लिकेशन
- `5-browser-extension/README.md` - ब्राउज़र एक्सटेंशन विकास
- `6-space-game/README.md` - कैनवास आधारित गेम विकास
- `9-chat-project/README.md` - AI चैट सहायक प्रोजेक्ट
- `9-chat-project/README.md` - AI चैट असिस्टेंट परियोजना
### मोनोरिपोजिटरी संरचना
### मोनोरिप संरचना
हालांकि यह पारंपरिक मोनोरिपोजिटरी नहीं है, इस रिपोजिटरी में कई स्वतंत्र प्रोजेक्ट्स शामिल हैं:
- प्रत्येक लेसन स्व-निहित है
- प्रोजेक्ट्स निर्भरताएं साझा नहीं करते
- बिना दूसरों को प्रभावित किए व्यक्तिगत प्रोजेक्ट्स पर काम करें
- पूर्ण पाठ्यक्रम अनुभव के लिए पूरी रिपोजिटरी क्लोन करें
यह एक पारंपरिक मोनोरिपॉ नहीं है, लेकिन यह रिपॉजिटरी कई स्वतंत्र परियोजनाओं को समाहित करती है:
- प्रत्येक पाठ स्वतंत्र है
- परियोजनाएं निर्भरताएं साझा नहीं करतीं
- व्यक्तिगत परियोजनाओं पर बिना दूसरों को प्रभावित किए काम करें
- पूरे पाठ्यक्रम का अनुभव पाने के लिए पूरी रिपॉजिटरी क्लोन करें
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**अस्वीकरण**:
यह दस्तावेज़ एआई अनुवादन सेवा [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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:12:54+00:00",
"translation_date": "2026-02-06T12:38:23+00:00",
"source_file": "AGENTS.md",
"language_code": "ko"
},

@ -2,27 +2,27 @@
## 프로젝트 개요
이 저장소는 초보자를 위한 웹 개발 기본 교육 커리큘럼 저장소입니다. 이 커리큘럼은 Microsoft Cloud Advocates가 개발한 12주 과정의 종합 교육 과정으로, JavaScript, CSS, HTML을 다루는 24개의 실습 중심 수업으로 구성되어 있습니다.
이 저장소는 웹 개발 기초를 초보자에게 가르치기 위한 교육 과정 저장소입니다. 이 교육 과정은 Microsoft Cloud Advocates가 개발한 12주간의 종합 코스로, JavaScript, CSS, HTML을 다루는 24개의 실습 수업으로 구성되어 있습니다.
### 주요 구성 요소
- **교육 콘텐츠**: 프로젝트 기반 모듈로 구성된 24개의 체계적인 수업
- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 은행 앱, 코드 편집기 및 AI 채팅 어시스턴트
- **인터랙티브 퀴즈**: 각 3문항씩 포함된 48개의 퀴즈 (수업 전/후 평가)
- **다국어 지원**: GitHub Actions를 통한 50개 이상 언어 자동 번역
- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 은행 앱, 코드 에디터, AI 챗 어시스턴트
- **인터랙티브 퀴즈**: 각 3문항으로 구성된 48개의 퀴즈(수업 전/후 평가)
- **다국어 지원**: 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로 제공
## 설 명령어
## 설 명령어
이 저장소는 주로 교육 콘텐츠 소비를 위한 것입니다. 특정 프로젝트 작업 시:
이 저장소는 주로 교육 콘텐츠 열람용입니다. 특정 프로젝트 작업 시:
### 메인 저장소 설정
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # 개발 서버 시작
npm run build # 프로덕션 빌드
npm run build # 프로덕션 빌드
npm run lint # ESLint 실행
```
@ -67,7 +67,7 @@ npm install
# 브라우저에서 index.html을 열거나 Live Server를 사용하세요
```
### 채팅 프로젝트 (Python 백엔드)
### 프로젝트 (Python 백엔드)
```bash
cd 9-chat-project/solution/backend/python
@ -80,29 +80,29 @@ python api.py
### 콘텐츠 기여자용
1. 저장소를 GitHub 계정으로 **포크(fork)** 합니다.
2. 포크한 저장소를 **로컬에 클론(clone)** 합니다.
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)
- **퀴즈 앱**: quiz-app 디렉리에서 `npm run dev` 실행
- **문서**: 루트에서 `docsify serve` 실행 (포트 3000)
- **퀴즈 앱**: quiz-app 디렉리에서 `npm run dev` 실행
- **프로젝트**: HTML 프로젝트는 VS Code Live Server 확장 사용
- **API 프로젝트**: 각 API 디렉리에서 `npm start` 실행
- **API 프로젝트**: 각 API 디렉리에서 `npm start` 실행
## 테스트 지침
@ -110,8 +110,8 @@ python api.py
```bash
cd quiz-app
npm run lint # 코드 스타일 문제 확인
npm run build # 빌드 성공 여부 확인
npm run lint # 코드 스타일 문제 확인하세요
npm run build # 빌드가 성공하는지 확인하세요
```
### 은행 API 테스트
@ -119,76 +119,76 @@ npm run build # 빌드 성공 여부 확인
```bash
cd 7-bank-project/api
npm run lint # 코드 스타일 문제 확인
node server.js # 오류 없이 서버가 시작되는지 확인
node server.js # 서버가 오류 없이 시작하는지 확인
```
### 일반 테스트 접근법
- 본 저장소는 포괄적인 자동화 테스트는 없습니다.
- 수동 테스트는 다음에 중점 둡니다:
- 코드 예제 오류 없이 실행되는지
- 문서 내 링크 작동 여부
- 프로젝트 빌드가 정상 완료되는지
- 예제가 최선의 실무 관행을 따르는지
- 이 저장소는 포괄적인 자동화 테스트가 없습니다
- 수동 테스트는 다음에 중점:
- 코드 예제 오류 없이 실행되는지
- 문서 내 링크가 제대로 작동하는지
- 프로젝트 빌드가 성공적으로 완료되는지
- 예제가 베스트 프랙티스를 따르는지
### 사전 제출 체크
### 제출 전 점검 사항
- package.json 있는 디렉토리에서 `npm run lint` 실행
- 마크다운 링크 유효성 확인
- package.json이 있는 디렉터리에서 `npm run lint` 실행
- 마크다운 링크 유효성 검증
- 브라우저 또는 Node.js에서 코드 예제 테스트
- 번역물의 구조 유지 확인
- 번역 구조가 제대로지되는지 확인
## 코드 스타일 지침
## 코드 스타일 가이드라인
### JavaScript
- 최신 ES6+ 문법 사용
- 프로젝트에서 제공하는 표준 ESLint 설정 준수
- 교육 목적에 맞는 의미 있는 변수 및 함수명 사용
- 프로젝트 표준 ESLint 설정 준수
- 교육 용이성을 위한 의미 있는 변수 및 함수 이름 사용
- 학습자 이해를 돕는 주석 추가
- 설정된 곳에서는 Prettier로 포맷팅
- 구성된 경우 Prettier로 코드 포맷팅 수행
### HTML/CSS
- 의미론적 HTML5 요소 사용
- 반응형 디자인 원칙 적용
- 명확한 클래스 명명 규칙
- CSS 기법에 관한 설명 주석 추가
- 학습자 이해를 위한 CSS 기법 주석
### Python
- PEP 8 스타일 가이드 준수
- 교육용 명확한 코드 예제 제공
- 학습에 도움이 되는 타입 힌트 사용
- PEP 8 스타일 가이드라인 준수
- 명확하고 교육적인 코드 예제
- 학습에 도움이 되는 경우 타입 힌트 사용
### 마크다운 문서
### 마크다운 문서
- 명확한 제목 계층 구조
- 언어 명시가 있는 코드 블록
- 추가 자료 링크 제공
- `images/` 폴더에 스크린샷 및 이미지 저장
- `images/` 디렉터리 내 스크린샷 및 이미지 포함
- 접근성을 위한 이미지 Alt 텍스트 제공
### 파일 구성
- 수업은 순차 번호로 정리 (1-getting-started-lessons, 2-js-basics 등)
- 각 프로젝트에 `solution/` 과 보통 `start/` 또는 `your-work/` 디렉토리 포함
- 순차 번호가 있는 수업 폴더 (1-getting-started-lessons, 2-js-basics 등)
- 각 프로젝트에 `solution/` 및 종종 `start/` 또는 `your-work/` 폴더 포함
- 수업별 `images/` 폴더에 이미지 저장
- 번역 파일은 `translations/{language-code}/` 구조
- `translations/{language-code}/` 구조로 번역 파일 관리
## 빌드 및 배포
### 퀴즈 앱 배포 (Azure Static Web Apps)
퀴즈 앱은 Azure Static Web Apps 배포에 맞게 설정됨:
quiz-app은 Azure Static Web Apps 배포 구성됨:
```bash
cd quiz-app
npm run build # dist/ 폴더를 만듭니다
# main 브랜치에 푸시할 때 GitHub Actions 워크플로를 통해 배포합니다
npm run build # dist/ 폴더를 생성합니다
# main 브랜치에 푸시 GitHub Actions 워크플로를 통해 배포합니다
```
Azure Static Web Apps 설정:
Azure Static Web Apps 구성:
- **앱 위치**: `/quiz-app`
- **출력 위치**: `dist`
- **워크플로우**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -200,79 +200,79 @@ npm install # docsify-to-pdf 설치
npm run convert # docs에서 PDF 생성
```
### Docsify 문서
### Docsify 문서
```bash
npm install -g docsify-cli # Docsify를 전역으로 설치합니다
docsify serve # localhost:3000에서 서비스합니다
npm install -g docsify-cli # Docsify를 전역으로 설치
docsify serve # localhost:3000에서 서비스하기
```
### 프로젝트별 빌드
각 프로젝트 디렉토리는 자체 빌드 프로세스가 있을 수 있음:
- Vue 프로젝트: `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] 테라리움 프로젝트 오탈자 수정`
- `[Translation] 5번째 수업의 스페인어 번역 추가`
- `[Docs] 설정 지침 업데이트`
### 필수 검사
### 필수
PR 제출 전:
1. **코드 품질**:
- 관련 프로젝트 디렉토리에서 `npm run lint` 실행
- 영향 받는 프로젝트 디렉터리에서 `npm run lint` 실행
- 모든 린트 오류 및 경고 수정
2. **빌드 확인**:
2. **빌드 검증**:
- 해당 시 `npm run build` 실행
- 빌드 오류 없음 확인
3. **링크 검증**:
- 모든 마크다운 링크 테스트
- 이미지 참조 작동 확인
3. **링크 유효성 검사**:
- 마크다운 내 모든 링크 테스트
- 이미지 참조 확인
4. **내용 검토**:
- 맞춤법 및 문법 교정
- 코드 예제의 정확성과 교육적 가치 확인
- 번역물의 원 뜻 유지 여부 확인
4. **콘텐츠 검토**:
- 맞춤법 및 문법 확인
- 코드 예제가 정확하고 교육적으로 적합한지 확인
- 번역이 원본 의미를 유지하는지 검토
### 기여 요
### 기여 요구 사항
- Microsoft CLA 동의 (첫 PR 시 자동 검사)
- [Microsoft 오픈소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수
- Microsoft CLA 동의 (첫 PR 자동 체크)
- [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수
- 자세한 지침은 [CONTRIBUTING.md](./CONTRIBUTING.md) 참고
- PR 설명에 이슈 번호 참조 가능 시 명시
- 이슈 번호가 있으면 PR 설명에 언급
### 리뷰 프로세스
### 검토 절차
- PR은 메인테이너와 커뮤니티 리뷰
- 교육적 명확성 우선
- 코드 예제는 최신 최선 관행 준수 필요
- 번역 정확성과 문화적 적합성 검토
- 메인테이너 및 커뮤니티 리뷰 진행
- 교육적 명확성 우선
- 코드 예제는 최신 베스트 프랙티스 준수
- 번역 정확성과 문화적 적합성 검토
## 번역 시스템
### 자동 번역
- GitHub Actions의 co-op-translator 워크플로우 사용
- co-op-translator 워크플로우가 적용된 GitHub Actions 사용
- 50개 이상의 언어로 자동 번역
- 소스 파일은 메인 디렉토리에 위치
- 번역 파일은 `translations/{language-code}/` 에 저장
- 메인 디렉터리에 원본 파일 존재
- 번역 파일은 `translations/{language-code}/` 에 저장
### 수동 번역 개선 추가
### 수동 번역 개선 추가 방법
1. `translations/{language-code}/` 내 파일 위치 확인
2. 구조를 유지하며 개선 진행
1. `translations/{language-code}/` 안의 파일 찾기
2. 구조를 유지하며 개선 사항 반영
3. 코드 예제가 정상 작동하는지 확인
4. 지화된 퀴즈 콘텐츠 테스트
4. 지화된 퀴즈 콘텐츠 테스트
### 번역 메타데이터
@ -291,118 +291,118 @@ CO_OP_TRANSLATOR_METADATA:
## 디버깅 및 문제 해결
### 흔한 문제
### 흔한 문제
**퀴즈 앱 실행 실패**:
**퀴즈 앱 시작 실패**:
- Node.js 버전 확인 (v14 이상 권장)
- `node_modules` `package-lock.json` 삭제 후 `npm install` 재실행
- 포트 충돌 여부 확인 (기본: Vite 포트 5173)
- `node_modules` `package-lock.json` 삭제 후 `npm install` 재실행
- 포트 충돌 확인 (기본: Vite 포트 5173 사용)
**API 서버가 시작되지 않을 때**:
- Node.js 최소 버전 충족 확인 (node >=10)
- 포트 사용 중인지 확인
**API 서버가 시작되지 않**:
- Node.js 버전 최소 충족 확인 (node >=10)
- 포트 사용 중 여부 확인
- `npm install`로 모든 의존성 설치 확인
**브라우저 확장 로드 실패**:
- manifest.json 형식 올바른지 확인
- 브라우저 콘솔 오류 확인
- 브라우저별 확장 설치 지침 따름
- manifest.json 포맷 확인
- 브라우저 콘솔에서 오류 확인
- 브라우저별 확장 설치 지침 준수
**Python 채팅 프로젝트 문제**:
**Python 프로젝트 문제**:
- OpenAI 패키지 설치 확인: `pip install openai`
- GITHUB_TOKEN 환경 변수 설정 여부 확인
- GITHUB_TOKEN 환경 변수 설정 확인
- GitHub Models 접근 권한 확인
**Docsify 문서 미서빙 문제**:
**Docsify가 문서 서빙 안됨**:
- 전역에 docsify-cli 설치: `npm install -g docsify-cli`
- 저장소 루트에서 실행
- `docs/_sidebar.md` 파일 존재 확인
### 개발 환경 팁
- Vue 프로젝트는 Vue DevTools 브라우저 확장 사용
- HTML 프로젝트는 VS Code Live Server 확장 활용
- ESLint, Prettier 확장 설치로 일관된 코드 포맷팅 적
- JavaScript 디버깅 시 브라우저 개발자 도구 사용
- HTML 프로젝트는 VS Code Live Server 확장 사용
- 일관된 포맷을 위해 ESLint 및 Prettier 확장 설치
- JavaScript 디버깅에 브라우저 개발자 도구 활
- Vue 프로젝트를 위한 Vue DevTools 브라우저 확장 설치
### 성능 고려사항
- 50개 이상의 언어 번역 파일 수 많아 전체 클론 시 크기 큼
- 콘텐츠 작업만 할 시 얕은 클론 사용: `git clone --depth 1`
- 영어 콘텐츠 작업 시 번역물 검색에서 제외 권장
- 초기 빌드 (npm install, Vite 빌드) 시 느릴 수 있음
- 번역 파일이 많아 (50개 이상 언어) 전체 클론 크기 큼
- 콘텐츠 작업 시 깊이 1로 얕은 클론 권장: `git clone --depth 1`
- 영어 콘텐츠 작업 시 번역 파일 검색 제외 권장
- 첫 실행 시 빌드 과정이 느릴 수 있음 (npm install, Vite 빌드)
## 보안 고려사항
### 환경 변수
- API 키는 절대 저장소에 커밋하지 말 것
- `.env` 파일 사용 (이미 `.gitignore` 등록)
- 프로젝트 README에 필요한 환경 변수 문서화
- `.env` 파일 사용 (이미 `.gitignore`에 포함)
- 필요한 환경 변수는 프로젝트 README에 문서화
### Python 프로젝트
- 가상 환경 사용: `python -m venv venv`
- 종속성 최신 상태 유지
- GitHub 토큰 권한 최소화
- 가상 환경 사용 권장: `python -m venv venv`
- 의존성 최신 상태 유지
- GitHub 토큰은 최소 권한으로 설정
### GitHub Models 접근
- 개인 접근 토큰(PAT) 필요
- GitHub Models 사용을 위한 개인 액세스 토큰(PAT) 필요
- 토큰은 환경 변수로 저장
- 토큰이나 자격 증명 절대 커밋 금지
- 토큰 자격 증명 절대 커밋 금지
## 추가 참고 사항
### 대상 사용자
- 웹 개발 전 초보자
- 학생 및 독학
- 교실에서 커리큘럼 용하는 교사
- 접근성과 점진적 스킬 향상에 맞춘 콘텐츠
- 웹 개발 전혀 모르는 초보자
- 학생 및 자기주도 학습
- 교실에서 커리큘럼 용하는 교사
- 접근성 및 점진적 기술 상승에 초점
### 교육 철학
- 프로젝트 기반 학습
- 빈번한 지식 점검(퀴즈)
- 프로젝트 기반 학습
- 빈번한 지식 확인(퀴즈)
- 실습 코딩 연습
- 실무 적용 사례 중심
- 프레임워크 전 기초 집중
- 실세계 적용 예제
- 프레임워크보다 기초 개념 중점
### 저장소 유지 관리
- 활발한 학습자 및 기여자 커뮤니티
- 종속성 및 콘텐츠 정기 업데이트
- 메인테이너가 이슈 및 토론 모니터링
- GitHub Actions 통한 번역 업데이트 자동화
- 의존성 및 콘텐츠 정기 업데이트
- 이슈 및 토론 상시 모니터링
- 번역 업데이트는 GitHub Actions 자동화
### 관련 자료
- [Microsoft Learn 모듈](https://docs.microsoft.com/learn/)
- [학생 허브 자료](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)
- 추가 강좌: 생성 AI, 데이터 과학, ML, IoT 커리큘럼 제공
### 특정 프로젝트 작업
개별 프로젝트에 대한 상세 지침은 다음 README 파일 참조:
개별 프로젝트의 상세 지침은 다음 README 파일 참고:
- `quiz-app/README.md` - Vue 3 퀴즈 앱
- `7-bank-project/README.md` - 인증 기능 있는 은행 애플리케이션
- `7-bank-project/README.md` - 인증 포함 은행 앱
- `5-browser-extension/README.md` - 브라우저 확장 개발
- `6-space-game/README.md` - 캔버스 기반 게임 개발
- `9-chat-project/README.md` - AI 채팅 어시스턴트 프로젝트
- `9-chat-project/README.md` - AI 어시스턴트 프로젝트
### 모노레포 구조
전통적 모노레포는 아니지만 여러 독립 프로젝트 포함:
- 각 수업은 독립적 구성
- 프로젝트 간 종속성 공유 없음
전통적 모노레포는 아니지만, 여러 독립 프로젝트 포함:
- 각 수업은 독립적
- 프로젝트 간 의존성 공유 없음
- 개별 프로젝트 작업 시 다른 프로젝트에 영향 없음
- 전체 커리큘럼 체험하려면 전체 저장소를 클론하세요
- 전체 커리큘럼 경험을 위해 전체 저장소 클론 가능
---
<!-- 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 -->
Loading…
Cancel
Save