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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent 98c1852d5b
commit edc8d3f5e3

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

@ -1,37 +1,37 @@
# AGENTS.md
## প্রকল্প বিবরণ
## Project Overview
এটি শিক্ষানবিশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর জন্য একটি শিক্ষামূলক পাঠ্যক্রম সংরক্ষণাগার। এই পাঠ্যক্রম একটি ব্যাপক ১২-সপ্তাহের কোর্স যা Microsoft Cloud Advocates দ্বারা বিকাশ করা হয়েছে, যার মধ্যে ২৪টি হাতে-কলমের পাঠ রয়েছে যা JavaScript, CSS, এবং HTML কভার করে
এটি শিক্ষানবিশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর একটি শিক্ষামূলক পাঠক্রম রেপোজিটরি। এই পাঠক্রমটি এক্সপ্রেসিভ ১২-সপ্তাহের একটি সম্পূর্ণ কোর্স যা মাইক্রোসফট ক্লাউড অ্যাডভোকেটদের দ্বারা বিকাশিত, যেখানে জাভাস্ক্রিপ্ট, সিএসএস এবং এইচটিএমএল সম্পর্কিত ২৪টি প্র্যাক্টিকাল পাঠ অন্তর্ভুক্ত
### প্রধান উপাদানসমূহ
### Key Components
- **শিক্ষামূলক বিষয়বস্তু**: প্রকল্প ভিত্তিক মডিউল আকারে সংগঠিত ২৪টি কাঠামোবদ্ধ পাঠ
- **প্রায়োগিক প্রকল্পসমূহ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, এবং AI Chat Assistant
- **ইন্টারেকটিভ কুইজ**: প্রতি কুইজে ৩টি প্রশ্নসহ ৪৮টি (পাঠের পূর্ব এবং পরবর্তী মূল্যায়ন)
- **বহুভাষিক সমর্থন**: GitHub Actions এর মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ
- **প্রযুক্তিসমূহ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI প্রকল্পের জন্য)
- **শিক্ষামূলক বিষয়বস্তু**: ২৪টি সুশৃঙ্খল পাঠ যা প্রজেক্ট-ভিত্তিক মডিউলগুলিতে সংগঠিত
- **প্রায়োগিক প্রকল্প**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাংকিং অ্যাপ, কোড এডিটর, এবং এআই চ্যাট সহকারী
- **ইন্টারেক্টিভ কুইজ**: ৪৮টি কুইজ, প্রতিটিতে ৩টি প্রশ্ন (পাঠের পূর্বে/পরে মূল্যায়ন)
- **বহু ভাষা সমর্থন**: গিটহাব অ্যাকশনস এর মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ
- **প্রযুক্তি**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI প্রকল্পের জন্য)
### স্থাপত্য
### Architecture
- পাঠ ভিত্তিক কাঠামোর অধীন শিক্ষামূলক সংরক্ষণাগার
- প্রতিটি পাঠ ফোল্ডারে README, কোড উদাহরণ, এবং সমাধান থাক
- স্বতন্ত্র প্রকল্পগুলি আলাদা ডিরেক্টরিতে রয়েছে (quiz-app, বিভিন্ন পাঠ প্রকল্প)
- GitHub Actions (co-op-translator) ব্যবহার করে অনুবাদ ব্যবস্থা
- Docsify দ্বারা ডকুমেন্টেশন পরিবেশন এবং PDF আকারে উপলব্ধ
- পাঠ-ভিত্তিক গঠন সহ শিক্ষামূলক রেপোজিটরি
- প্রতিটি পাঠ ফোল্ডারে README, কোড উদাহরণ এবং সমাধান রয়েছ
- আলাদা ডিরেক্টরিতে স্বতন্ত্র প্রকল্পসমূহ (quiz-app, বিভিন্ন পাঠ প্রকল্প)
- গিটহাব অ্যাকশনস ব্যবহার করে অনুবাদ ব্যবস্থা (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 সেটআপ (Vue 3 + Vite)
### Quiz App Setup (Vue 3 + Vite)
```bash
cd quiz-app
@ -41,7 +41,7 @@ npm run build # প্রোডাকশনের জন্য বিল্
npm run lint # ESLint চালান
```
### ব্যাংক প্রকল্প API (Node.js + Express)
### Bank Project API (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,15 +51,15 @@ npm run lint # ESLint চালান
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,46 +67,46 @@ npm install
# ব্রাউজারে index.html খুলুন অথবা লাইভ সার্ভার ব্যবহার করুন
```
### চ্যাট প্রকল্প (Python ব্যাকএন্ড)
### Chat Project (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN পরিবেশ ভেরিয়েবল সেট করুন
# GITHUB_TOKEN পরিবেশ পরিবর্তনশীল সেট করুন
python api.py
```
## ডেভেলপমেন্ট ওয়ার্কফ্লো
## Development Workflow
### বিষয়বস্তু প্রদানকারীদের জন্য
### For Content Contributors
1. আপনার GitHub অ্যাকাউন্টে **রিপোজিটোরিটি ফর্ক করুন**
2. **আপনার ফর্ক ক্লোন করুন** স্থানীয়ভাবে
3. আপনার পরিবর্তনের জন্য একটি নতুন ব্রাঞ্চ **তৈরি করুন**
4. পাঠের বিষয়বস্তু বা কোড উদাহরণ পরিবর্তন করুন
5. সংশ্লিষ্ট প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষা করুন
6. সহযোগিতা নির্দেশিকা অনুসরণ করে পুল রিকোয়েস্ট জমা দিন
১. আপনার গিটহাব অ্যাকাউন্টে **রেপোজিটরি ফর্ক করুন**
২. **লোকালি আপনার ফর্ক ক্লোন করুন**
. আপনার পরিবর্তনের জন্য একটি **নতুন ব্রাঞ্চ তৈরি করুন**
. পাঠের বিষয়বস্তু বা কোড উদাহরণ পরিবর্তন করুন
৫. প্রাসঙ্গিক প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষা করুন
৬. অবদান নির্দেশনাগুলি অনুসরণ করে পুল রিকোয়েস্ট সাবমিট করুন
### শিক্ষার্থীদের জন্য
### For Learners
1. রিপোজিটোরিটি ফর্ক বা ক্লোন করুন
2. ধারাবাহিকভাবে পাঠ ডিরেক্টরিতে যান
3. প্রতিটি পাঠের README ফাইল পড়ুন
4. https://ff-quizzes.netlify.app/web/ এ পূর্ব-পাঠ কুইজ সম্পন্ন করুন
5. পাঠের ফোল্ডারে কোড উদাহরণগুলি অনুসরণ করুন
6. অ্যাসাইনমেন্ট এবং চ্যালেঞ্জ সম্পন্ন করুন
7. পরবর্তী-পাঠ কুইজ দিন
১. রেপোজিটরি ফর্ক বা ক্লোন করুন
২. ক্রমবর্ধমান পাঠ ডিরেক্টরিতে নেভিগেট করুন
. প্রতিটি পাঠের README ফাইল পড়ুন
. https://ff-quizzes.netlify.app/web/ এ গিয়ে পূর্ব-পাঠ কুইজ সম্পন্ন করুন
৫. পাঠ ফোল্ডারে কোড উদাহরণগুলি অনুসরণ করুন
৬. অ্যাসাইনমেন্ট ও চ্যালেঞ্জ সম্পন্ন করুন
. পাঠের পরবর্তী কুইজ গ্রহণ করুন
### সরাসরি ডেভেলপমেন্ট
### Live Development
- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০)
- **Quiz App**: quiz-app ডিরেক্টরিতে `npm run dev` চালান
- **প্রকল্পসমূহ**: HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- **API প্রকল্পসমূহ**: সংশ্লিষ্ট API ডিরেক্টরিতে `npm start` চালান
- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০)
- **Quiz App**: quiz-app ডিরেক্টরিতে `npm run dev` চালান
- **প্রকল্পসমূহ**: এইচটিএমএল প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- **API প্রকল্পসমূহ**: সংশ্লিষ্ট API ডিরেক্টরিতে `npm start` চালান
## টেস্টিং নির্দেশাবলী
## Testing Instructions
### Quiz App টেস্টিং
### Quiz App Testing
```bash
cd quiz-app
@ -114,169 +114,169 @@ npm run lint # কোড স্টাইল সমস্যাগুলি
npm run build # নিশ্চিত করুন বিল্ড সফল হয়
```
### ব্যাংক API টেস্টিং
### Bank API Testing
```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+ সিনট্যাক্স ব্যবহার করুন
- প্রকল্পগুলিতে দেওয়া standaard ESLint কনফিগারেশন অনুসরণ করুন
- শিক্ষার্থীদের জন্য অর্থবহ ভেরিয়েবল এবং ফাংশন নাম ব্যবহার করুন
- ধারণাগুলো ব্যাখ্যা করার জন্য মন্তব্য যোগ করুন
- যেখানে কনফিগার করা আছে সেখানে Prettier দিয়ে ফরম্যাট করুন
- আধুনিক ES6+ সিনট্যাক্স ব্যবহার করুন
- প্রকল্পে দেয়া সাধারণ ESLint কনফিগারেশন অনুসরণ করুন
- শিক্ষামূলক স্পষ্টতার জন্য অর্থবহ ভেরিয়েবল ও ফাংশন নাম ব্যবহার করুন
- শিক্ষার্থীদের বোঝার জন্য মন্তব্য যোগ করুন
- যেখানে প্রয়োজন Prettier ব্যবহার করে ফরম্যাট করুন
### HTML/CSS
- সেমান্টিক HTML5 উপাদান ব্যবহার
- রেসপনসিভ ডিজাইন নীতিমালা
- স্পষ্ট ক্লাস নামকরণ নিয়ম
- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যা সহ মন্তব্য
- সেম্যান্টিক HTML5 উপাদান ব্যবহার করুন
- রেসপনসিভ ডিজাইন নীতিমালা অনুসরণ করুন
- স্পষ্ট ক্লাস নামকরণের নিয়ম মেনে চলুন
- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যার মন্তব্য যোগ করুন
### Python
- PEP 8 স্টাইল গাইডলাইনস
- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ
- শিখতে সহায়ক হলে টাইপ হিন্ট ব্যবহার
- PEP 8 স্টাইল গাইড অনুসরণ করুন
- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ দিন
- শেখার জন্য সুবিধাজনক হলে টাইপ হিন্ট ব্যবহার করুন
### Markdown ডকুমেন্টেশন
### Markdown Documentation
- স্পষ্ট শিরোনাম ধারা
- ভাষা নির্দিষ্ট কোড ব্লকসমূহ
- অতিরিক্ত সম্পদের লিঙ্ক
- `images/` ডিরেক্টরির স্ক্রীনশট ও ছবি
- সহায়তার জন্য ছবির Alt টেক্সট
- স্পষ্ট শিরোনাম কাঠামো বজায় রাখুন
- ভাষা নির্দিষ্ট কোড ব্লক ব্যবহার করুন
- অতিরিক্ত রিসোর্সের লিঙ্ক দিন
- `images/` ডিরেক্টরিতে স্ক্রিনশট ও ছবি রাখুন
- অ্যাক্সেসিবিলিটির জন্য ইমেজের জন্য Alt টেক্সট দিন
### ফাইল সংগঠন
### File Organization
- পাঠ নম্বর ক্রম অনুসারে (1-getting-started-lessons, 2-js-basics, ইত্যাদি)
- প্রতিটি প্রকল্পে `solution/` এবং প্রায়ই `start/` বা `your-work/` ডিরেক্টরি থাকে
- পাঠ নির্দিষ্ট `images/` ফোল্ডারে ছবি সংরক্ষণ
- অনুবাদ `translations/{language-code}/` কাঠামোতে
- পাঠগুলো ধারাবাহিক নম্বর অনুসারে (১-getting-started-lessons, ২-js-basics, ইত্যাদি)
- প্রতিটি প্রকল্পে আছে `solution/` এবং প্রায়ই `start/` বা `your-work/` ডিরেক্টরি
- পাঠ-বিশেষ `images/` ফোল্ডারে ছবি সংরক্ষণ
- অনুবাদগুলি `translations/{language-code}/` কাঠামোতে রাখা হয়
## বিল্ড এবং ডেপ্লয়মেন্ট
## Build and Deployment
### Quiz App ডেপ্লয়মেন্ট (Azure Static Web Apps)
### Quiz App Deployment (Azure Static Web Apps)
quiz-app Azure Static Web Apps ডেপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে:
Quiz-app টি Azure Static Web Apps ডিপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে:
```bash
cd quiz-app
npm run build # dist/ ফোল্ডার তৈরি করে
# main-এ push করার সময় GitHub Actions workflow এর মাধ্যমে ডিপ্লয় করে
# মেইন ব্রাঞ্চে পুশ করার মাধ্যমে 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 তৈরি
### Documentation PDF Generation
```bash
npm install # docsify-to-pdf ইনস্টল করুন
npm run convert # ডকস থেকে পিডিএফ তৈরি করুন
npm run convert # ডকস থেকে PDF তৈরি করুন
```
### Docsify ডকুমেন্টেশন
### Docsify Documentation
```bash
npm install -g docsify-cli # ডক্সিফাই গ্লোবালি ইনস্টল করুন
docsify serve # লোকালহোস্ট:৩০০০ এ সার্ভ করুন
npm install -g docsify-cli # গ্লোবালি Docsify ইনস্টল করুন
docsify serve # লোকালহোস্ট:3000 এ সার্ভ করুন
```
### প্রকল্প-নির্দিষ্ট বিল্ড
### Project-specific Builds
প্রত্যেক প্রকল্প ডিরেক্টরির নিজস্ব বিল্ড প্রক্রিয়া থাকতে পারে:
- Vue প্রকল্প: `npm run build` দ্বারা প্রোডাকশন বান্ডল তৈরি
- স্ট্যাটিক প্রকল্প: বিল্ড ধাপ নেই, সরাসরি ফাইল পরিবেশন
প্রতিটি প্রকল্পের নিজস্ব বিল্ড প্রক্রিয়া থাকতে পারে:
- Vue প্রকল্প: `npm run build` ব্যবহার করে প্রোডাকশন বান্ডল তৈরি হয়
- স্ট্যাটিক প্রকল্প: বিল্ড ধাপ নেই, সরাসরি ফাইল পরিবেশন
## পুল রিকোয়েস্ট নির্দেশিকা
## Pull Request Guidelines
### শিরোনাম বিন্যাস
### Title Format
পরিবর্তনের ক্ষেত্র স্পষ্টভাবে জানাতে স্বচ্ছ, বর্ণনামূলক শিরোনাম ব্যবহার করুন:
- `[Quiz-app] পাঠ X এর জন্য নতুন কুইজ যোগ করা`
- `[Lesson-3] terrarium প্রকল্পে টাইপো সংশোধন`
- `[Translation] পাঠ 5 এর জন্য স্প্যানিশ অনুবাদ যোগ`
- `[Docs] সেটআপ নির্দেশাবলী আপডেট`
পরিবর্তনের ক্ষেত্রটি স্পষ্টভাবে বুঝিয়ে শিরোনাম দিন:
- `[Quiz-app] পাঠ X এর জন্য নতুন কুইজ যুক্ত করুন`
- `[Lesson-3] টেরারিয়াম প্রকল্পের টাইপো ঠিক করুন`
- `[Translation] পাঠ এর জন্য স্প্যানিশ অনুবাদ যোগ করুন`
- `[Docs] সেটআপ নির্দেশাবলী আপডেট করুন`
### প্রয়োজনীয় পরীক্ষাসমূহ
### Required Checks
পিআর জমা দেওয়ার আগে:
PR সাবমিট করার আগে:
1. **কোড মান**:
- প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান
- সব লিন্ট ত্রুটি ও সতর্কতা নিরসন করুন
১. **কোড মান**:
   - প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান
   - সব লিন্টিং ত্রুটি এবং সতর্কতা সংশোধন করুন
2. **বিল্ড যাচাই**:
- প্রযোজ্য হলে `npm run build` চালান
- কোন বিল্ড ত্রুটি নেই তা নিশ্চিত করুন
২. **বিল্ড যাচাই**:
   - প্রয়োজনে `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) দেখুন
- প্রযোজ্য ক্ষেত্রে ইস্যু নম্বর পিআর বর্ণনায় উল্লেখ করুন
- Microsoft CLA অনুদানে সম্মত হন (প্রথম PR এ স্বয়ংক্রিয় চেক)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) অনুসরণ করুন
- বিস্তারিত নির্দেশনার জন্য [CONTRIBUTING.md](./CONTRIBUTING.md) দেখুন
- প্রয়োজন হলে PR বর্ণনায় ইস্যু নম্বর উল্লেখ করুন
### পর্যালোচনা প্রক্রিয়া
### Review Process
- পিআর গুলো রক্ষণাবেক্ষক এবং কমিউনিটির দ্বারা পর্যালোচনা করা হয়
- শিক্ষণীয় স্পষ্টতা অগ্রাধিকার পায়
- কোড উদাহরণ বর্তমান সেরা অনুশীলন অনুসরণ করা উচিত
- অনুবাদ সঠিকতা এবং সাংস্কৃতিক উপযোগিতা যাচাই করা হয়
- 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
1. `translations/{language-code}/` এ ফাইল খুঁজে বের করুন
2. কাঠামো বজায় রেখে উন্নতি করুন
3. কোড উদাহরণ কার্যকর থাকা নিশ্চিত করুন
4. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন
১. `translations/{language-code}/` ডিরেক্টরিতে ফাইলটি খুঁজুন
. কাঠামো বজায় রেখে উন্নতি করুন
৩. কোড উদাহরণগুলোর কার্যকারিতা বজায় রাখুন
. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন
### অনুবাদ মেটাডেটা
### Translation Metadata
অনূদিত ফাইলগুলিতে মেটাডেটা হেডার থাকে:
অনূদিত ফাইলগুলিতে মেটাডেটা হেডার থাকে:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## ডিবাগিং এবং সমস্যা সমাধান
## Debugging and Troubleshooting
### সাধারণ সমস্যা
### Common Issues
**Quiz app চালু হয় না**:
- 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 সঠিক ফরম্যাটে আছে কিনা পরীক্ষা করুন
- ব্রাউজার কনসোলে ত্রুটি খুঁজু
- ব্রাউজার-ভিত্তিক এক্সটেনশন ইনস্টলেশন নির্দেশনা অনুসরণ করুন
**Python চ্যাট প্রকল্প সমস্যা**:
- 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 এক্সটেনশন ইনস্টল করুন
- জাভাস্ক্রিপ্ট ডিবাগিং এর জন্য ব্রাউজার ডেভটুলস ব্যবহার করুন
- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন
- HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন
- সামঞ্জস্যপূর্ণ ফরম্যাটের জন্য ESLint এবং Prettier এক্সটেনশন ইনস্টল করুন
- জাভাস্ক্রিপ্ট ডিবাগ করার জন্য ব্রাউজার DevTools ব্যবহার করুন
- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন
### কর্মক্ষমতা বিবেচনা
### Performance Considerations
- ৫০+ ভাষার প্রচুর অনূদিত ফাইল থাকার কারণে সম্পূর্ণ ক্লোন বড় হতে পারে
- শুধুমাত্র বিষয়বস্তু নিয়ে কাজ করলে shallow clone ব্যবহার করুন: `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 প্রকল্পসমূহ
### Python Projects
- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv`
- নির্ভরশীলতা হালনাগাদ রাখুন
- GitHub টোকেনগুলিতে সর্বনিম্ন প্রয়োজনীয় অনুমতি থাকা উচিত
- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv`
- নির্ভরশীলতা আপ টু ডেট রাখুন
- GitHub টোকেনগুলি সর্বনিম্ন প্রয়োজনীয় অনুমতি থাকা উচিত
### GitHub Models অ্যাক্সেস
### GitHub Models Access
- GitHub Models ব্যবহারের জন্য Personal Access Tokens (PAT) প্রয়োজন
- টোকেনগুলি পরিবেশ ভেরিয়েবল হিসেবে সংরক্ষণ করুন
- কখনো টোকেন বা ক্রেডেনশিয়াল কমিট করবেন না
- GitHub Models-এ ব্যবহারের জন্য Personal Access Tokens (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)
- অতিরিক্ত কোর্সসমূহ: Generative AI, Data Science, ML, IoT পাঠ্যক্রম উপলব্ধ
- [Microsoft Learn মডিউলস](https://docs.microsoft.com/learn/)
- [Student Hub রিসোর্স](https://docs.microsoft.com/learn/student-hub/)
- শিক্ষার্থীদের জন্য [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) সুপারিশকৃত
- অতিরিক্ত কোর্স: জেনারেটিভ AI, ডেটা সায়েন্স, ML, IoT পাঠক্রম উপলব্ধ
### নির্দিষ্ট প্রকল্প নিয়ে কাজ
### 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-06T08:07:14+00:00",
"translation_date": "2026-02-06T11:14:03+00:00",
"source_file": "AGENTS.md",
"language_code": "hi"
},

@ -2,42 +2,42 @@
## परियोजना अवलोकन
यह शुरुआती लोगों को वेब विकास के मूलभूत सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉज़िटरी है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ शामिल हैं।
यह शुरुआती लोगों को वेब विकास के मूल सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपोजिटरी है। यह पाठ्यक्रम एक व्यापक 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें 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 चैट सहायक
- **इंटरैक्टिव क्विज़**: 48 क्विज़ हर एक में 3 प्रश्न (प्री/पोस्ट-लेसन आकलन)
- **बहुभाषी समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए ऑटोमैटिक अनुवाद
- **प्रौद्योगिकिया**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रोजेक्ट्स के लिए)
### वास्तुकला
- पाठ आधारित संरचना के साथ शैक्षिक रिपॉज़िटरी
- प्रत्येक पाठ फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं
- अलग-अलग निर्देशिकाओं में स्टैंडअलोन प्रोजेक्ट्स (quiz-app, विभिन्न पाठ प्रोजेक्ट्स)
- GitHub Actions (co-op-translator) का उपयोग करते हुए अनुवाद प्रणाली
- Docsify के माध्यम से दस्तावेज़ीकरण सेवा और PDF के रूप में उपलब्ध
- लेसन-आधारित संरचना वाला शैक्षिक रिपोजिटरी
- प्रत्येक लेसन फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं
- स्वतंत्र प्रोजेक्ट्स अलग-अलग डायरेक्टरीज़ में (quiz-app, विभिन्न लेसन प्रोजेक्ट्स)
- ट्रांसलेशन सिस्टम GitHub Actions (co-op-translator) का उपयोग करता है
- डॉक्यूमेंटेशन Docsify के माध्यम से प्रदान किया जाता है और PDF के रूप में भी उपलब्ध है
## सेटअप कमांड्स
यह रिपॉज़िटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
यह रिपोजिटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट प्रोजेक्ट्स पर काम करने के लिए:
### मुख्य रिपॉज़िटरी सेटअप
### मुख्य रिपोजिटरी सेटअप
```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 चलाएं
```
@ -46,9 +46,9 @@ npm run lint # ESLint चलाएं
```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 के साथ फॉर्मेट करें
```
### ब्राउज़र एक्सटेंशन प्रोजेक्ट्स
@ -64,10 +64,10 @@ npm install
```bash
cd 6-space-game/solution
npm install
# index.html ब्राउज़र में खोलें या Live Server का उपयोग करें
# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें
```
### चैट प्रोजेक्ट (Python Backend)
### चैट प्रोजेक्ट (Python बैकएंड)
```bash
cd 9-chat-project/solution/backend/python
@ -80,112 +80,112 @@ 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)
- **क्विज़ ऐप**: 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` चलाएं
## जांच निर्देश
## परीक्षण निर्देश
### क्विज ऐप परीक्षण
```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 # सत्यापित करें कि सर्वर बिना त्रुटियों के शुरू होा है
```
### सामान्य परीक्षण दृष्टिकोण
- यह एक शैक्षिक रिपॉज़िटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण पर फोकस है:
- कोड उदाहरण बिना त्रुटि के चलें
- दस्तावेज़ में लिंक ठीक से काम करे
- प्रोजेक्ट बिल्ड सफलतापूर्वक पूरी हो
- उदाहरण सर्वोत्तम प्रथाओं का पालन करें
- यह एक शैक्षिक रिपोजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण मुख्य रूप से निम्न पर केंद्रित है:
- कोड उदाहरण त्रुटि के बिना चल है
- डॉक्यूमेंटेशन में लिंक सही ढंग से काम करते है
- प्रोजेक्ट बिल्ड सफलतापूर्वक पूरा होते है
- उदाहरण सर्वोत्तम प्रथाओं का पालन कर है
### पूर्व-प्रस्तुति जां
### पूर्व-प्रस्तुति चेक्स
- package.json के साथ निर्देशिकाओं में `npm run lint` चलाएं
- मार्कडाउन लिंक की वैधता सत्यापित करें
- पैकेज.json वाली डायरेक्ट्रीज़ में `npm run lint` चलाएं
- मार्कडाउन लिंक वैध हैं यह सत्यापित करें
- ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें
- जांचें कि अनुवाद संरचना सही बनाए रखें
- जांचें कि अनुवाद संरचना बनाए रख है
## कोड स्टाइल दिशानिर्देश
### JavaScript
- आधुनिक ES6+ सिंटैक्स का उपयोग करें
- आधुनिक ES6+ वाक्य रचना का उपयोग करें
- प्रोजेक्ट्स में उपलब्ध मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक चर और फ़ंक्शन नाम उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं की व्याख्या करते हुए टिप्पणियां जोड़ें
- जहां कॉन्फ़िगर किया गया हो Prettier का उपयोग करें
- शैक्षिक स्पष्टता के लिए अर्थपूर्ण वेरिएबल और फंक्शन नामों का उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं को समझाने वाले कमेंट्स जोड़ें
- जहां आवश्यक हो Prettier से फॉर्मेट करें
### HTML/CSS
- सेमान्टिक HTML5 तत्व
- उत्तरदायी डिजाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंशन्स
- CSS तकनीकों को समझाते हुए टिप्पणियां शिक्षार्थियों के लिए
- सेमांटिक HTML5 तत्वों का उपयोग
- रिस्पॉन्सिव डिजाइन सिद्धांतों का पालन
- स्पष्ट क्लास नामकरण सम्मेलन
- शिक्षार्थियों के लिए CSS तकनीकों को समझाने वाले कमेंट्स
### Python
- PEP 8 स्टाइल दिशानिर्देश
- PEP 8 शैली दिशानिर्देशों का पालन करें
- स्पष्ट, शैक्षिक कोड उदाहरण
- जहां उपयोगी हो, टाइप हिंट्स
- सीखने में मदद के लिए जहां सहायक हो टाइप हिंट्स
### Markdown दस्तावेज़ीकरण
### मार्कडाउन डॉक्यूमेंटेशन
- स्पष्ट शीर्षक संरचना
- भाषा विनिर्देशन के साथ कोड ब्लॉक
- स्पष्ट हेडिंग संरचना
- भाषा विनिर्देशन के साथ कोड ब्लॉक्स
- अतिरिक्त संसाधनों के लिंक
- `images/` निर्देशिकाओं में स्क्रीनशॉट और चित्र
- छवियों के लिए वैकल्पिक पाठ (alt text) पहुंच योग्यता के लिए
- `images/` डायरेक्टरीज़ में स्क्रीनशॉट और छवियां
- पहुँच के लिए छवियों के लिए Alt टेक्स्ट
### फाइल संगठन
### फाइल संगठन
- पाठ अनुक्रम में नंबर किए गए (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिका होती है
- पाठ-विशिष्ट `images/` फ़ोल्डरों में छवियां स्टोर करे
- लेसन्स को क्रमवार नंबर दिया गया है (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक प्रोजेक्ट में `solution/` और अक्सर `start/` या `your-work/` डायरेक्टरीज़ होती हैं
- छवियां लेसन-विशिष्ट `images/` फ़ोल्डर्स में संग्रहीत है
- अनुवाद `translations/{language-code}/` संरचना में
## निर्माण और तैनाती
## बिल्ड और परिनियोजन
### क्विज ऐप तैनाती (Azure Static Web Apps)
### क्विज ऐप परिनियोजन (Azure Static Web Apps)
क्विज ऐप Azure Static Web Apps तैनाती के लिए कॉन्फ़िगर किया गया है:
क्विज-ऐप Azure Static Web Apps परिनियोजन के लिए कॉन्फ़िगर है:
```bash
cd quiz-app
npm run build # dist/ फ़ोल्डर बनाता है
# मुख्य ब्रांच पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है
# मुख्य शाखा पर पुश करने पर 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 # Docsify को वैश्विक रूप से इंस्टॉल करें
npm install -g docsify-cli # Docisfy को वैश्विक रूप से इंस्टॉल करें
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. **निर्माण सत्यापन**:
2. **बिल्ड सत्यापन**:
- उपयुक्त होने पर `npm run build` चलाएं
- सुनिश्चित करें कि बिल्ड त्रुटि नहीं है
- सुनिश्चित करें कि बिल्ड त्रुटियां न हों
3. **लिंक सत्यापन**:
- सभी मार्कडाउन लिंक जांचें
- चित्र संदर्भ ठीक काम करें
3. **लिंक मान्यता**:
- सभी मार्कडाउन लिंक का परीक्षण करें
- छवि संदर्भों की जांच करें
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 विवरण में इश्यू नंबर का संदर्भ दें
### समीक्षा प्रक्रिया
- PR का संयोजकों और समुदाय द्वारा समीक्षा
- PR की समीक्षा मेंटेनर्स और समुदाय द्वारा की जाएगी
- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
- कोड उदाहरण वर्तमान सर्वोत्तम प्रथाओं का पालन करें
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा की जाती है
- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए
- अनुवादों की सटीकता और सांस्कृतिक उपयुक्तता क समीक्षा की जाती है
## अनुवाद प्रणाली
### स्वचालित अनुवाद
- GitHub Actions के साथ co-op-translator वर्कफ़्लो उपयोग करता है
- 50+ भाषाओं में स्वचालित अनुवाद करता है
- मुख्य निर्देशिकाओं में स्रोत फ़ाइले
- `translations/{language-code}/` निर्देशिकाओं में अनुवादित फ़ाइलें
- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग करता है
- 50+ भाषाओं के लिए स्वचालित अनुवाद करता है
- स्रोत फाइलें मुख्य डायरेक्टरीज़ में है
- अनूदित फाइलें `translations/{language-code}/` डायरेक्टरीज़ में
### मैनुअल अनुवाद सुधार जोड़ना
1. `translations/{language-code}/` में फ़ाइल ढूंढें
1. फाइल को `translations/{language-code}/` में खोजें
2. संरचना बनाए रखते हुए सुधार करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील रहें
4. किसी भी स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील बने रहें
4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
### अनुवाद मेटाडेटा
अनुवादित फ़ाइलों में मेटाडेटा हेडर शामिल होता है:
अनूदित फाइलों में मेटाडेटा हेडर शामिल होता है:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -291,118 +291,118 @@ CO_OP_TRANSLATOR_METADATA:
## डिबगिंग और समस्या निवारण
### सामान्य समस्याए
### सामान्य समस्याए
**क्विज ऐप शुरू नहीं हो रहा**:
- Node.js संस्करण की जाँच करें (v14+ अनुशंसित)
**क्विज ऐप शुरू नहीं हो रहा है**:
- Node.js संस्करण जांचें (v14+ अनुशंसित)
- `node_modules` और `package-lock.json` हटाएं, फिर `npm install` चलाएं
- पोर्ट संघर्षों की जाँच करें (डिफ़ॉल्ट: Vite पोर्ट 5173 उपयोग करता है)
- पोर्ट संघर्ष जांचें (डिफ़ॉल्ट: Vite पोर्ट 5173 उपयोग करता है)
**API सर्वर शुरू नहीं हो रहा**:
- कम से कम Node.js संस्करण सुनिश्चित करें (node >=10)
- जांचें कि पोर्ट पहले से उपयोग में नहीं है
- सभी निर्भरताओं को `npm install` द्वारा स्थापित करे
- जांचें 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 डॉक नहीं सर्व कर रहा**:
- docsify-cli ग्लोबली इंस्टॉल करें: `npm install -g docsify-cli`
- रिपॉज़िटरी रूट निर्देशिका से चलाएं
- रिपोजिटरी रूट डायरेक्टरी से चलाएं
- जांचें कि `docs/_sidebar.md` मौजूद है
### विकास पर्यावरण सुझाव
- HTML प्रोजेक्ट्स के लिए VS Code में Live Server एक्सटेंशन उपयोग करें
- स्थिर स्वरूपण के लिए ESLint और Prettier एक्सटेंशंस इंस्टॉल करें
- HTML प्रोजेक्ट्स के लिए VS Code में Live Server एक्सटेंशन का उपयोग करें
- समान स्वरूपण के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue प्रोजेक्ट्स के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
### प्रदर्शन विचार
- बहुत अधिक अनुवादित फ़ाइलें (50+ भाषाएं) बड़े क्लोन बनाती हैं
- केवल सामग्री पर काम करने के लिए शैलो क्लोन का उपयोग करें: `git clone --depth 1`
- अंग्रेजी सामग्री पर काम करते समय अनुवाद खोजों से बाहर रखें
- बिल्ड प्रक्रियाएँ पहली बार धीमी हो सकती हैं (npm install, Vite build)
- अनुवादित फाइलों (50+ भाषाओं) की बड़ी संख्या के कारण पूरी क्लोनिंग बड़ी होती है
- केवल सामग्री पर काम करने के लिए shallow clone का उपयोग करें: `git clone --depth 1`
- अंग्रेजी सामग्री पर काम करते समय अनुवादों को खोज से बाहर रखें
- बिल्ड प्रक्रिया पहली बार धीमी हो सकती है (npm install, Vite बिल्ड)
## सुरक्षा विचार
### पर्यावरण वेरिएबल्स
### पर्यावरण चर
- API कुंजी कभी भी रिपॉज़िटरी में कमिट न करें
- `.env` फाइलों का उपयोग करें (जो `.gitignore` में शामिल हैं)
- आवश्यक पर्यावरण वेरिएबल्स प्रोजेक्ट READMEs में दस्तावेजीकृत करें
- API कुंजी कभी भी रिपोजिटरी में कमिट न करें
- `.env` फाइल्स का उपयोग करें (पहले से `.gitignore` में रखा गया है)
- आवश्यक पर्यावरण चर प्रोजेक्ट README में दस्तावेजीकृत करें
### Python प्रोजेक्ट्स
- वर्चुअल वातावरण का उपयोग करें: `python -m venv venv`
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- निर्भरताओं को अपडेट रखें
- GitHub टोकन के लिए न्यूनतम आवश्यक अनुमतिया रखें
- GitHub टोकन न्यूनतम आवश्यक अनुमतिया रखें
### GitHub मॉडल्स एक्सेस
### GitHub Models एक्सेस
- GitHub मॉडल्स के लिए Personal Access Tokens (PAT) आवश्यक हैं
- टोकन पर्यावरण वेरिएबल्स के रूप में संग्रहित करें
- टोकन या क्रेडेंशियल कभी कमिट न करें
- GitHub Models के लिए Personal Access Tokens (PAT) आवश्यक हैं
- टोकन पर्यावरण चर के रूप में स्टोर करें
- टोकन या क्रेडेंशियल्स कभी कमिट न करें
## अतिरिक्त नोट्स
### लक्षित दर्शक
- वेब विकास के पूर्ण शुरुआत
- छात्र और स्वयं-अध्यता
- वेब विकास के पूर्ण शुरुआत करने वाले
- छात्र और स्वयं-अध्ययनकर्ता
- कक्षा में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुंच योग्य और चरणबद्ध कौशल विकास के लिए डिज़ाइन की गई है
- सामग्री पहुंच योग्य और धीरे-धीरे कौशल निर्माण के लिए डिज़ाइन की गई है
### शैक्षिक दर्शन
- परियोजना-आधारित शिक्षण दृष्टिकोण
- प्रोजेक्ट-आधारित शिक्षा दृष्टिकोण
- बार-बार ज्ञान जांच (क्विज़)
- व्यावहारिक कोडिंग अभ्यास
- हैंड्स-ऑन कोडिंग अभ्यास
- वास्तविक दुनिया के अनुप्रयोग उदाहरण
- फ्रेमवर्क से पहले मूल सिद्धांतों पर ध्यान केंद्रित
### रिपॉज़िटरी रखरखाव
### रिपोजिटरी रखरखाव
- सक्रिय समुदाय जिसमें शिक्षार्थी और योगदानकर्ता शामिल हैं
- निर्भरताओं और सामग्री क नियमित अपडेट
- मुद्दों और चर्चाओं की निगरानी संयोजकों द्वारा
- अनुवाद अपडेट GitHub Actions से स्वचालित
- सक्रिय शिक्षार्थी और योगदानकर्ता समुदाय
- निर्भरताओं और सामग्री क नियमित अपडेट
- मेंटेनर्स द्वारा मुद्दों और चर्चाओं की निगरानी
- GitHub Actions के माध्यम से अनुवाद अपडेट स्वचालित
### संबंधित संसाधन
- [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) सीखने वालों के लिए अनुशंसित
- अतिरिक्त पाठ्यक्रम: Generative AI, Data Science, 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 फ़ाइलों को देखें:
व्यक्तिगत प्रोजेक्ट पर विस्तृत निर्देशों के लिए निम्न README फाइलें देखें:
- `quiz-app/README.md` - Vue 3 क्विज़ एप्लिकेशन
- `7-bank-project/README.md` - प्रमाणीकरण के साथ बैंकिंग एप्लिकेशन
- `5-browser-extension/README.md` - ब्राउज़र एक्सटेंशन विकास
- `6-space-game/README.md` - कैनवास-आधारित गेम विकास
- `7-bank-project/README.md` - ऑथेंटिकेशन के साथ बैंकिंग एप्लिकेशन
- `5-browser-extension/README.md` - ब्राउज़र एक्सटेंशन डेवलपमेंट
- `6-space-game/README.md` - कैनवास आधारित गेम विकास
- `9-chat-project/README.md` - AI चैट सहायक प्रोजेक्ट
### मونوरेपो संरचना
### मोनोरिपोजिटरी संरचना
यह पारंपरिक मونوरेपो नहीं है, लेकिन इस रिपॉज़िटरी में कई स्वतंत्र प्रोजेक्ट्स हैं:
- प्रत्येक पाठ स्वतंत्र है
- प्रोजेक्ट्स निर्भरताए साझा नहीं करते
- व्यक्तिगत प्रोजेक्ट्स पर काम करें बिना दूसरों को प्रभावित किए
- पूरे पाठ्यक्रम अनुभव के लिए पूरी रिपॉज़िटरी क्लोन करें
हालांकि यह पारंपरिक मोनोरिपोजिटरी नहीं है, इस रिपोजिटरी में कई स्वतंत्र प्रोजेक्ट्स शामिल हैं:
- प्रत्येक लेसन स्व-निहित है
- प्रोजेक्ट्स निर्भरताए साझा नहीं करते
- बिना दूसरों को प्रभावित किए व्यक्तिगत प्रोजेक्ट्स पर काम करें
- पूर्ण पाठ्यक्रम अनुभव के लिए पूरी रिपोजिटरी क्लोन करें
---
<!-- 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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T08:06:05+00:00",
"translation_date": "2026-02-06T11:12:54+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개의 퀴즈 (수업 전/후 평가)
- **교육 콘텐츠**: 프로젝트 기반 모듈로 구성된 24개의 체계적인 수업
- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 은행 앱, 코드 편집기 및 AI 채팅 어시스턴트
- **인터랙티브 퀴즈**: 각 3문항씩 포함된 48개의 퀴즈 (수업 전/후 평가)
- **다국어 지원**: GitHub Actions를 통한 50개 이상의 언어 자동 번역
- **기술 스택**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI 프로젝트용)
### 아키텍처
- 수업 기반 구조의 교육용 저장소
- 각 수업 폴더에는 README, 코드 예제, 솔루션 포함
- quiz-app, 여러 수업 프로젝트와 같이 독립 프로젝트 별도 디렉터리
- 각 수업 폴더에 README, 코드 예제 및 솔루션 포함
- 독립형 프로젝트들은 별도의 디렉토리에 위치 (quiz-app, 다양한 수업 프로젝트)
- GitHub Actions (co-op-translator)를 이용한 번역 시스템
- Docsify로 제공되는 문서 및 PDF 형태로 이용 가능
- 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 실행
```
@ -56,7 +56,7 @@ npm run format # Prettier로 포맷팅
```bash
cd 5-browser-extension/solution
npm install
# 브라우저 별 확장 프로그램 로딩 지침을 따르세요
# 브라우저별 확장 프로그램 로딩 지침을 따르십시오
```
### 우주 게임 프로젝트
@ -78,31 +78,31 @@ python api.py
## 개발 워크플로우
### 콘텐츠 기여자를 위해
### 콘텐츠 기여자
1. 저장소를 GitHub 계정으로 **포크**합니다.
2. 포크한 저장소를 로컬에 **클론**합니다.
3. 변경사항용으로 **새 브랜치**를 생성합니다.
4. 수업 콘텐츠 또는 코드 예제를 수정합니다.
5. 관련 프로젝트 디렉터리에서 코드 변경사항을 테스트합니다.
1. 저장소를 GitHub 계정으로 **포크(fork)** 합니다.
2. 포크한 저장소를 **로컬에 클론(clone)** 합니다.
3. 변경 사항을 위한 새로운 **브랜치 생성** 합니다.
4. 수업 콘텐츠 코드 예제를 수정합니다.
5. 관련 프로젝트 디렉토리에서 코드 변경 사항을 테스트합니다.
6. 기여 가이드라인에 따라 풀 리퀘스트를 제출합니다.
### 학습자를 위해
### 학습자
1. 저장소를 포크하거나 클론합니다.
2. 수업 디렉터리를 순차적으로 이동합니다.
2. 수업 디렉토리를 순서대로 이동합니다.
3. 각 수업의 README 파일을 읽습니다.
4. https://ff-quizzes.netlify.app/web/ 에서 수업 전 퀴즈를 완료합니다.
5. 수업 폴더 내 코드 예제를 실행해 봅니다.
6. 과제 및 챌린지를 완료합니다.
7. 수업 후 퀴즈를 응시합니다.
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` 실행
## 테스트 지침
@ -118,77 +118,77 @@ npm run build # 빌드 성공 여부 확인
```bash
cd 7-bank-project/api
npm run lint # 코드 스타일 문제 확인합니다
node server.js # 서버가 오류 없이 시작되는지 확인합니다
npm run lint # 코드 스타일 문제 확인
node server.js # 오류 없이 서버가 시작되는지 확인
```
### 일반 테스트 접근법
- 이 저장소는 교육용으로 포괄적인 자동화 테스트는 포함하지 않음
- 수동 테스트는 다음에 중점:
- 본 저장소는 포괄적인 자동화 테스트는 없습니다.
- 수동 테스트는 다음에 중점 둡니다:
- 코드 예제가 오류 없이 실행되는지
- 문서 내 링크가 정상 작동하는지
- 프로젝트 빌드가 성공적으로 완료되는지
- 예제가 모범 사례를 따르는지
- 문서 내 링크 작동 여부
- 프로젝트 빌드가 정상 완료되는지
- 예제가 최선의 실무 관행을 따르는지
### 제출 전 점검
### 사전 제출 체크
- package.json이 있는 디렉터리에서 `npm run lint` 실행
- 마크다운 링크가 유효한지 검증
- 브라우저 Node.js에서 코드 예제 테스트
- 번역이 올바른 구조를 유지하는지 확인
- package.json 있는 디렉토리에서 `npm run lint` 실행
- 마크다운 링크 유효성 확인
- 브라우저 또는 Node.js에서 코드 예제 테스트
- 번역물의 구조 유지 확인
## 코드 스타일 가이드라인
## 코드 스타일 지침
### JavaScript
- 최신 ES6+ 문 사용
- 프로젝트에 제공된 표준 ESLint 설정 준수
- 교육적 명확성을 위해 의미 있는 변수 및 함수명 사용
- 학습자를 위한 개념 설명 주석 추가
- 설정된 경우 Prettier로 포맷팅
- 최신 ES6+ 문 사용
- 프로젝트에서 제공하는 표준 ESLint 설정 준수
- 교육 목적에 맞는 의미 있는 변수 및 함수명 사용
- 학습자 이해를 돕는 주석 추가
- 설정된 곳에서는 Prettier로 포맷팅
### HTML/CSS
- 시멘틱 HTML5 요소 사용
- 의미론적 HTML5 요소 사용
- 반응형 디자인 원칙 적용
- 명확한 클래스 명명 규칙
- 학습자를 위한 CSS 기술 설명 주석 포함
- CSS 기법에 관한 설명 주석 추가
### Python
- PEP 8 스타일 가이드 준수
- 명확하고 교육적인 코드 예제
- 교육용 명확한 코드 예제 제공
- 학습에 도움이 되는 타입 힌트 사용
### 마크다운 문서화
- 명확한 헤딩 계층 구조
- 언어 지정 코드 블록 사용
- 추가 자료에 대한 링크 포함
- `images/` 폴더의 스크린샷 및 이미지
- 접근성을 위한 이미지 대체 텍스트
- 명확한 제목 계층 구조
- 언어 명시가 있는 코드 블록
- 추가 자료 링크 제공
- `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 배포에 맞게 설정됨:
```bash
cd quiz-app
npm run build # dist/ 폴더를 생성합니다
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`
@ -203,80 +203,80 @@ npm run convert # docs에서 PDF 생성
### 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] 수업 X에 새 퀴즈 추가`
- `[Lesson-3] 테라리움 프로젝트 오타 수정`
- `[Translation] 5과 스페인어 번역 추가`
- `[Docs] 설치 지침 업데이트`
변경 영역을 명확하게 표현하는 제목 사용:
- `[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`
### 필수 검사
### 필수 검사
PR 제출 전:
PR 제출 전:
1. **코드 품질**:
- 관련 프로젝트 디렉리에서 `npm run lint` 실행
- 관련 프로젝트 디렉리에서 `npm run lint` 실행
- 모든 린트 오류 및 경고 수정
2. **빌드 검증**:
- 가능한 경우 `npm run build` 실행
2. **빌드 확인**:
- 해당 시 `npm run build` 실행
- 빌드 오류 없음 확인
3. **링크 검증**:
- 모든 마크다운 링크 테스트
- 이미지 참조 정상 작동 확인
- 이미지 참조 작동 확인
4. **내용 검토**:
- 맞춤법 문법 교정
- 코드 예제의 정확성 및 교육적 적합성 확인
- 번역이 원래 의미를 유지하는지 검증
- 맞춤법 문법 교정
- 코드 예제의 정확성과 교육적 가치 확인
- 번역물의 원 뜻 유지 여부 확인
### 기여
### 기여
- Microsoft CLA 동의 (첫 PR에서 자동 검사)
- [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수
- 자세한 가이드는 [CONTRIBUTING.md](./CONTRIBUTING.md) 참조
- PR 설명에 관련 이슈 번호 참조 가능
- Microsoft CLA 동의 (첫 PR 자동 검사)
- [Microsoft 오픈소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수
- 자세한 지침은 [CONTRIBUTING.md](./CONTRIBUTING.md) 참고
- PR 설명에 이슈 번호 참조 가능 시 명시
### 검토 과정
### 리뷰 프로세스
- PR은 유지관리자 및 커뮤니티가 검토
- 교육적 명확성 우선
- 코드 예제는 최신 모범 사례 준수 필요
- 번역 정확성과 문화적 적합성 검토
- PR은 메인테이너와 커뮤니티 리뷰
- 교육적 명확성 우선
- 코드 예제는 최신 최선 관행 준수 필요
- 번역 정확성과 문화적 적합성 검토
## 번역 시스템
### 자동 번역
- GitHub Actions co-op-translator 워크플로우 사용
- 50개 이상 언어로 자동 번역 지원
- 소스 파일은 메인 디렉리에 위치
- 번역 파일은 `translations/{language-code}/`에 위치
- GitHub Actions co-op-translator 워크플로우 사용
- 50개 이상 언어로 자동 번역
- 소스 파일은 메인 디렉리에 위치
- 번역 파일은 `translations/{language-code}/` 에 저장
### 수동 번역 개선 추가 방법
### 수동 번역 개선 추가
1. `translations/{language-code}/` 내 파일 위치 찾기
2. 구조를 유지하며 개선 작업 수
1. `translations/{language-code}/` 내 파일 위치 확인
2. 구조를 유지하며 개선
3. 코드 예제가 정상 작동하는지 확인
4. 현지화된 퀴즈 내용 테스트
4. 현지화된 퀴즈 콘텐츠 테스트
### 번역 메타데이터
번역 파일 메타데이터 헤더 포함:
번역 파일 메타데이터 헤더 포함:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -291,66 +291,66 @@ 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)
- 포트가 이미 사용 중인지 점검
- 모든 의존성 `npm install`로 설치 여부 확인
**API 서버가 시작되지 않을 때**:
- Node.js 최소 버전 충족 확인 (node >=10)
- 포트 사용 중인지 확인
- `npm install`모든 의존성 설치 확인
**브라우저 확장이 로드되지 않는 경우**:
- manifest.json 형식 확인
- 브라우저 콘솔 오류 점검
- 브라우저별 확장 설치 지침 준수
**브라우저 확장 로드 실패**:
- manifest.json 형식 올바른지 확인
- 브라우저 콘솔 오류 확인
- 브라우저별 확장 설치 지침 따름
**Python 채팅 프로젝트 문제**:
- OpenAI 패키지 설치 확인: `pip install openai`
- GITHUB_TOKEN 환경 변수 설정 여부 확인
- GitHub Models 접근 권한 점검
- GitHub Models 접근 권한 확인
**Docsify가 문서를 제공하지 않는 경우**:
**Docsify 문서 미서빙 문제**:
- 전역에 docsify-cli 설치: `npm install -g docsify-cli`
- 저장소 루트에서 실행
- `docs/_sidebar.md` 파일 존재 여부 확인
- `docs/_sidebar.md` 파일 존재 확인
### 개발 환경 팁
- HTML 프로젝트는 VS Code와 Live Server 확장 사용
- 일관된 포맷팅을 위해 ESLint, Prettier 확장 설치
- JavaScript 디버깅에 브라우저 개발자 도구 사
- Vue 프로젝트는 Vue DevTools 브라우저 확장 설치
- Vue 프로젝트는 Vue DevTools 브라우저 확장 사용
- HTML 프로젝트는 VS Code Live Server 확장 활용
- ESLint, Prettier 확장 설치로 일관된 코드 포맷팅 적
- JavaScript 디버깅 시 브라우저 개발자 도구 사용
### 성능 고려사항
- 50개 이상의 번역 파일로 인해 전체 클론 시 큰 용량 발생
- 콘텐츠 작업만 할 경우 얕은 클론 사용: `git clone --depth 1`
- 영어 콘텐츠 작업 시 번역 파일 검색 제외 권장
- 초기 실행 시 빌드 프로세스가 느릴 수 있음 (npm install, Vite 빌드)
- 50개 이상의 언어 번역 파일 수 많아 전체 클론 시 크기 큼
- 콘텐츠 작업만 할 얕은 클론 사용: `git clone --depth 1`
- 영어 콘텐츠 작업 시 번역물 검색에서 제외 권장
- 초기 빌드 (npm install, Vite 빌드) 시 느릴 수 있음
## 보안 고려사항
### 환경 변수
- API 키는 절대 저장소에 커밋하지 말 것
- `.env` 파일 사용 (.gitignore에 포함됨)
- `.env` 파일 사용 (이미 `.gitignore` 등록)
- 프로젝트 README에 필요한 환경 변수 문서화
### Python 프로젝트
- 가상환경 사용 권장: `python -m venv venv`
- 의존성 최신 상태 유지
- GitHub 토큰은 최소 권한 적용
- 가상 환경 사용: `python -m venv venv`
- 종속성 최신 상태 유지
- GitHub 토큰 권한 최소화
### GitHub Models 접근
- 개인 액세스 토큰(PAT) 필요
- 개인 접근 토큰(PAT) 필요
- 토큰은 환경 변수로 저장
- 토큰 또는 자격 증명 절대 커밋 금지
- 토큰이나 자격 증명 절대 커밋 금지
## 추가 참고 사항
@ -358,51 +358,51 @@ CO_OP_TRANSLATOR_METADATA:
- 웹 개발 완전 초보자
- 학생 및 독학자
- 교실에서 커리큘럼 사용하는 교사
- 접근성 및 단계적 기술 습득에 최적화된 콘텐츠
- 교실에서 커리큘럼 사용하는 교사
- 접근성과 점진적 스킬 향상에 맞춘 콘텐츠
### 교육 철학
- 프로젝트 기반 학습 방식
- 프로젝트 기반 학습
- 빈번한 지식 점검(퀴즈)
- 실습 코딩 연습
- 실제 적용 사례
- 프레임워크보다 기초에 집중
- 실무 적용 사례 중심
- 프레임워크 전 기초 집중
### 저장소 유지 관리
- 학습자와 기여자 커뮤니티 활성화
- 의존성 및 콘텐츠 정기 업데이트
- 유지관리자가 이슈 및 토론 감시
- 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 파일에서 확인:
- `quiz-app/README.md` - Vue 3 퀴즈 애플리케이션
- `7-bank-project/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 채팅 도우미 프로젝트
- `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