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

update-translations
localizeflow[bot] 2 days ago
parent c86ae1dab9
commit 142c632888

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "d45ddcc54eb9232a76d08328b09d792e",
"translation_date": "2026-01-06T17:11:56+00:00",
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:49:03+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "hi"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T16:35:45+00:00",
"translation_date": "2026-03-06T14:52:45+00:00",
"source_file": "AGENTS.md",
"language_code": "hi"
},
@ -516,8 +516,8 @@
"language_code": "hi"
},
"README.md": {
"original_hash": "6d6385fd098088cb2d690fb0a6cdaedc",
"translation_date": "2026-02-06T16:30:40+00:00",
"original_hash": "a2c9eed480687319517c08a6319e5536",
"translation_date": "2026-03-06T14:44:55+00:00",
"source_file": "README.md",
"language_code": "hi"
},

@ -1,30 +1,30 @@
# AGENTS.md
## परियोजना अवलोकन
## प्रोजेक्ट अवलोकन
यह शुरुआती लोगों के लिए वेब विकास के मूल सिद्धांतों को सिखाने हेतु एक शैक्षिक पाठ्यक्रम रिपॉज़िटरी है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें 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 चैट सहायक
- **इंटरैक्टिव क्विज़**: 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
@ -36,8 +36,8 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # विकास सर्वर शुरू करें
npm run build # उत्पादन के लिए बिल्ड करे
npm run dev # विकास सर्वर प्रारंभ करें
npm run build # उत्पादन के लिए बनाए
npm run lint # ESLint चलाएं
```
@ -47,8 +47,8 @@ npm run lint # ESLint चलाएं
cd 7-bank-project/api
npm install
npm start # एपीआई सर्वर शुरू करें
npm run lint # ESLint चलाए
npm run format # Prettier के साथ स्वरूपित करें
npm run lint # ESLint चलाए
npm run format # Prettier के साथ फ़ॉर्मेट करें
```
### ब्राउज़र एक्सटेंशन परियोजनाएं
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें
# ब्राउज़र में index.html खोलें या Live Server का उपयोग करें
```
### चैट प्रोजेक्ट (Python Backend)
@ -72,7 +72,7 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN पर्यावरण चरों को सेट करें
# GITHUB_TOKEN पर्यावरण चर सेट करें
python api.py
```
@ -80,27 +80,27 @@ python api.py
### सामग्री योगदानकर्ताओं के लिए
1. अपनी GitHub खाता में **रिपॉज़िटरी को फोर्क करें**
1. **रिपॉजिटरी को अपने GitHub अकाउंट में फोर्क करें**
2. **अपने फोर्क को लोकली क्लोन करें**
3. **अपने परिवर्तनों के लिए नई ब्रांच बनाएं**
4. पाठ सामग्री या कोड उदाहरणों में परिवर्तन करें
5. संबंधित परियोजना निर्देशिकाओं में किसी भी कोड परिवर्तन का परीक्षण करें
6. योगदान दिशानिर्देशों के अनुसार पुल अनुरोध सबमिट करें
3. **अपने परिवर्तनों के लिए नई शाखा बनाएं**
4. लेसन सामग्री या कोड उदाहरणों में परिवर्तन करें
5. संबंधित परियोजना निर्देशिकाओं में कोई भी कोड परिवर्तन परीक्षण करें
6. योगदान दिशानिर्देशों का पालन करते हुए पुल अनुरोध सबमिट करें
### शिक्षार्थियों के लिए
1. रिपॉजिटरी को फोर्क या क्लोन करें
2. पाठ निर्देशिकाओं में क्रमबद्ध रूप से जाए
3. प्रत्येक पाठ के README फ़ाइल पढ़ें
4. https://ff-quizzes.netlify.app/web/ पर पूर्व-पाठ क्विज़ पूरा करें
5. पाठ फ़ोल्डरों में कोड उदाहरणों पर काम करें
1. रिपॉजिटरी को फोर्क या क्लोन करें
2. लेसन निर्देशिकाओं में क्रमबद्ध रूप से नेविगेट करे
3. प्रत्येक लेसन के README फ़ाइल पढ़ें
4. प्री-लेसन क्विज़ https://ff-quizzes.netlify.app/web/ पर पूरा करें
5. लेसन फोल्डर्स में कोड उदाहरणों के माध्यम से काम करें
6. असाइनमेंट और चुनौतियां पूरी करें
7. पश्च-पाठ क्विज़ लें
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` चलाएं
@ -110,7 +110,7 @@ python api.py
```bash
cd quiz-app
npm run lint # कोड शैली की समस्याओं की जांच करें
npm run lint # कोड शैली की समस्याओं के लिए जांचें
npm run build # सत्यापित करें कि बिल्ड सफल होता है
```
@ -118,82 +118,82 @@ npm run build # सत्यापित करें कि बिल्
```bash
cd 7-bank-project/api
npm run lint # कोड शैली की समस्याओं की जाँच करें
npm run lint # कोड स्टाइल समस्याओं के लिए जांच करें
node server.js # जांचें कि सर्वर बिना त्रुटियों के शुरू होता है
```
### सामान्य परीक्षण दृष्टिकोण
- यह एक शैक्षिक रिपॉजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण पर ध्यान दिया जाता है:
- कोड उदाहरण त्रुटि रहित चलें
- दस्तावेज़ में लिंक सही काम करें
- परियोजना बिल्ड सफलतापूर्वक पूरी हो
- उदाहरणों का पालन सर्वोत्तम प्रथाओं के अनुसार हो
- यह एक शैक्षिक रिपॉजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण पर ध्यान केंद्रित करता है:
- कोड उदाहरण बिना त्रुटि के चलना चाहिए
- दस्तावेज़ीकरण में लिंक सही तरीके से काम करें
- परियोजना निर्माण सफलतापूर्वक पूर्ण होना चाहिए
- उदाहरण सर्वोत्तम प्रथाओं का पालन करें
### प्री-सबमिशन जांच
- `package.json` वाले निर्देशकों में `npm run lint` चलाएं
- मार्कडाउन लिंक मान्य हैं, यह पुष्टि करें
- ब्राउज़र या Node.js में कोड उदाहरण का परीक्षण करें
- जांचें कि अनुवाद संरचना को सही ढंग से बनाए रख है
- package.json वाले निर्देशिकाओं में `npm run lint` चलाएं
- मार्कडाउन लिंक वैध हैं या नहीं जांचें
- कोड उदाहरण ब्राउज़र या Node.js में टेस्ट करें
- जांचें कि अनुवाद संरचना बनाए रखें
## कोड शैली दिशानिर्देश
### JavaScript
- आधुनिक ES6+ सिंटैक्स का उपयोग करें
- परियोजनाओं में दिए गए मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक वरिएबल और फ़ंक्शन नामों का उपयोग करें
- पाठकों के लिए अवधारणाओं को स्पष्ट करने वाली टिप्पणियाँ जोड़ें
- जहाँ कॉन्फ़िगर किया गया हो, वहां Prettier से प्रारूपित करें
- परियोजनाओं में उपलब्ध मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक वरिएबल और फ़ंक्शन नामों का उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं की व्याख्या करने वाले टिप्पणियाँ जोड़ें
- जहां कॉन्फ़िगर हो वहां Prettier का उपयोग करें
### HTML/CSS
- सेमांटिक HTML5 तत्व
- प्रतिक्रियाशील डिज़ाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंशंस
- CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
- उत्तरदायी डिज़ाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंश
- शिक्षार्थियों के लिए CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
### Python
- PEP 8 शैली दिशानिर्देश
- स्पष्ट, शैक्षिक कोड उदाहरण
- जहां सहायक हो, टाइप हिंट्स
- सीखने में सहायक टाइप संकेत
### मार्कडाउन दस्तावेज़ीकरण
### Markdown दस्तावेज़ीकरण
- स्पष्ट शीर्षक पदानुक्रम
- भाषा निर्दिष्ट कोड ब्लॉक
- स्पष्ट हेडिंग पदानुक्रम
- भाषा निर्दिष्ट कोड ब्लॉक्स
- अतिरिक्त संसाधनों के लिंक
- `images/` निर्देशिकाओं में स्क्रीनशॉट और छवियाँ
- पहुँच के लिए छवियों का Alt टेक्स्ट
- `images/` निर्देशिकाओं में स्क्रीनशॉट और चित्र
- पहुँच के लिए चित्रों के लिए Alt पाठ
### फ़ाइल संगठन
- पाठ क्रमांकित (1-getting-started-lessons, 2-js-basics, आदि)
- लेसन क्रमशः नंबरित (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिकाएं
- पाठ-विशिष्ट `images/` फ़ोल्डरों में छवियाँ संग्रही
- चित्र लेसन-विशिष्ट `images/` फोल्डर में संग्रहि
- अनुवाद `translations/{language-code}/` संरचना में
## बिल्ड और परिनियोजन
## निर्माण और परिनियोजन
### क्विज़ ऐप परिनियोजन (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 कॉन्फ़िगरेशन:
- **प स्थान**: `/quiz-app`
- **प स्थान**: `/quiz-app`
- **आउटपुट स्थान**: `dist`
- **वर्कफ़्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **कार्यप्रवाह**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### डॉक्यूमेंटेशन PDF जेनरेशन
### दस्तावेज़ीकरण PDF जनरेशन
```bash
npm install # docsify-to-pdf इंस्टॉल करें
@ -207,72 +207,72 @@ 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` चलाएं
- सभी लिंटिंग त्रुटियाँ और चेतावनियाँ ठीक करें
- सभी लिंटिंग त्रुटियां और चेतावनियां ठीक करें
2. **बिल्ड सत्यापन**:
- यदि लागू हो, `npm run build` चलाएं
- कोई बिल्ड त्रुटि नहीं होनी चाहिए
2. **निर्माण सत्यापन**:
- लागू होने पर `npm run build` चलाएं
- कोई निर्माण त्रुटियां न हों
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 विवरण में मुद्दा संख्या संदर्भित करें
### समीक्षा प्रक्रिया
- PRs मेंटेनरों और समुदाय द्वारा समीक्षा किए जाते हैं
- PR को रखरखावकर्ताओं और समुदाय द्वारा समीक्षा किया जाता है
- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
- कोड उदाहरण वर्तमान सर्वोत्तम प्रथाओं का पालन करें
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा किये जाते हैं
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा की जाती है
## अनुवाद प्रणाली
### स्वचालित अनुवाद
- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग
- co-op-translator वर्कफ़्लो के साथ GitHub Actions का उपयोग करता है
- 50+ भाषाओं में स्वचालित अनुवाद करता है
- मुख्य निर्देशिकाओं में स्रोत फ़ाइलें
- अनुवादित फाइलें `translations/{language-code}/` निर्देशिकाओं में
- स्रोत फाइलें मुख्य निर्देशिकाओं में
- अनुवादित फाइलें `translations/{language-code}/` निर्देशिकाओं में
### मैनुअल अनुवाद सुधार जोड़ना
1. `translations/{language-code}/` में फ़ाइल खोजें
2. संरचना को बनाए रखते हुए सुधार करें
3. सुनिश्चित करें कोड उदाहरण कार्यात्मक रहे
4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
1. `translations/{language-code}/` में फ़ाइल ढूंढ़ें
2. संरचना बनाए रखते हुए सुधार करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील हो
4. कोई स्थानीयकृत क्विज़ सामग्री हो तो उसका परीक्षण करें
### अनुवाद मेटाडेटा
@ -291,118 +291,118 @@ CO_OP_TRANSLATOR_METADATA:
## डिबगिंग और समस्या निवारण
### सामान्य समस्याए
### सामान्य समस्याए
**क्विज़ ऐप शुरू नहीं होता**:
- 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 मॉडलों की पहुँच अनुमतियाँ जांचें
**Python चैट प्रोजेक्ट समस्याएं**:
- सुनिश्चित करें OpenAI पैकेज इंस्टॉल है: `pip install openai`
- GITHUB_TOKEN पर्यावरण चर सेट है
- 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 डिबगिंग हेतु ब्राउज़र DevTools का प्रयोग करें
- संगत स्वरूपण के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
- जावास्क्रिप्ट डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
### प्रदर्शन विचार
- बहुत सारी अनुवादित फाइलें (50+ भाषाएं) होने से पूर्ण क्लोन बड़े होते हैं
- केवल सामग्री पर काम करने के लिए shallow clone का प्रयोग करें: `git clone --depth 1`
- बड़ी संख्या में अनुवादित फाइलें (50+ भाषाएँ) होने से पूर्ण क्लोन बड़े होते हैं
- केवल सामग्री पर काम करने पर shallow clone का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवादों को खोज से बाहर रखें
- पहली बार चलाते समय बिल्ड प्रक्रियाएं धीमी हो सकती हैं (`npm install`, Vite बिल्ड)
- पहला रन (npm install, Vite निर्माण) धीमा हो सकता है
## सुरक्षा विचार
### पर्यावरण चर
- API कुंजियाँ कभी भी रिपॉज़िटरी में कमिट न करें
- `.env`ाइलों का उपयोग करें (पहले से `.gitignore` में शामिल)
- परियोजना README में आवश्यक पर्यावरण चर डॉक्यूमेंट करें
- API कुंजी कभी भी रिपॉजिटरी में कमिट न करें
- `.env` फाइलों का उपयोग करें (पहले से `.gitignore` में शामिल)
- आवश्यक पर्यावरण चर परियोजना README में दस्तावेजित करें
### Python परियोजनाएं
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- निर्भरताएँ अपडेट रखें
- GitHub टोकन को न्यूनतम आवश्यक अनुमतिें
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- निर्भरताओं को अपडेट रखें
- GitHub टोकन न्यूनतम आवश्यक अनुमतियाँ रखें
### GitHub मॉडल पहुँच
### GitHub Models एक्सेस
- GitHub मॉडल के लिए Personal Access Tokens (PAT) आवश्यक हैं
- टोकन पर्यावरण चर के रूप में संग्रहीत करें
- टोकन या साख कभी कमिट न करें
- GitHub Models के लिए Personal Access Tokens (PAT) आवश्यक
- टोकन पर्यावरण चरों के रूप में संग्रहीत करें
- टोकन या क्रेडेंशियल कभी कमिट न करें
## अतिरिक्त नोट्स
### लक्षित दर्शक
- वेब विकास के पूर्ण शुरुआत
- छात्र और आत्म-अध्ययन करने वाले
- कक्षा में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुंच और क्रमिक कौशल निर्माण के लिए डिज़ाइन की गई है
- वेब विकास के पूर्ण शुरुआत करने वाले
- छात्र और स्व-अध्ययनकर्ता
- कक्षाओं में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुँचनीयता और धीरे-धीरे कौशल निर्माण के लिए डिज़ाइन की गई है
### शैक्षिक दर्शन
- परियोजना-आधारित सीखने का दृष्टिकोण
- बार-बार ज्ञान जाच (क्विज़)
- हैंड्स-ऑन कोडिंग अभ्यास
- परियोजना-आधारित शिक्षण दृष्टिकोण
- बार-बार ज्ञान जाच (क्विज़)
- हाथों-हाथ कोडिंग अभ्यास
- वास्तविक दुनिया के अनुप्रयोग उदाहरण
- फ्रेमवर्क से पहले मूल बातें सीखने पर ध्यान
- फ्रेमवर्क से पहले मूल बातें पर ध्यान केंद्रित
### रिपॉजिटरी रखरखाव
### रिपॉजिटरी रखरखाव
- सक्रिय शिक्षार्थी और योगदानकर्ता समुदाय
- निर्भरताओं और सामग्री का नियमित अद्यतन
- मेंटेनरों द्वारा मुद्दों और चर्चाओं की निगरानी
- GitHub Actions के माध्यम से अनुवाद अपडेट्स स्वचालित
- निर्भरताओं और सामग्री का नियमित अपडेट
- मुद्दों और चर्चाओं पर रखरखावकर्ताओं द्वारा निगरानी
- अनुवाद अपडेट GitHub Actions द्वारा स्वचालित
### संबंधित संसाधन
- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- सीखने वालों के लिए अनुशंसित [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
- अतिरिक्त पाठ्यक्रम: जनरेटिव AI, डेटा साइंस, एमएल, 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` - ब्राउज़र एक्सटेंशन विकास
- `6-space-game/README.md` - कन्वास आधारित गेम विकास
- `9-chat-project/README.md` - AI चैट असिस्टेंट प्रोजेक्ट
- `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) का उपयोग करके किया गया है। हम सटीकता के लिए प्रयासरत हैं, लेकिन कृपया ध्यान दें कि स्वचालित अनुवाद में त्रुटियाँ या असंगतियाँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में अधिकारिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं।
**अस्वीकरण**:
यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनूदित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवादों में त्रुटियाँ या अशुद्धियाँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में ही प्रामाणिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए पेशेवर मानवीय अनुवाद की सिफारिश की जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या मिसइंटरप्रिटेशन के लिए हम जिम्मेदार नहीं हैं।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,211 +1,198 @@
[![GitHub license](https://img.shields.io/github/license/microsoft/Web-Dev-For-Beginners.svg)](https://github.com/microsoft/Web-Dev-For-Beginners/blob/master/LICENSE)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
# शुरुआती लोगों के लिए वेब विकास - एक पाठ्यक्रम
[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/stargazers/)
Microsoft क्लाउड एडवोकेट्स द्वारा हमारे 12-सप्ताह के व्यापक पाठ्यक्रम के साथ वेब विकास के मूल बातें सीखें। 24 पाठों में से प्रत्येक JavaScript, CSS, और HTML को हाथों-हाथ प्रोजेक्ट्स जैसे टेरारियम, ब्राउज़र एक्सटेंशनों, और स्पेस गेम्स के माध्यम से गहराई से समझाता है। क्वीज़, चर्चाओं, और व्यावहारिक असाइनमेंट्स में भाग लें। हमारी प्रभावी परियोजना-आधारित शिक्षा पद्धति के साथ अपनी कौशलों को बढ़ाएं और आपकी ज्ञान की स्मृति को बेहतर बनाएं। आज ही अपनी कोडिंग यात्रा शुरू करें!
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
# शुरुआती लोगों के लिए वेब डेवलपमेंट - एक पाठ्यक्रम
माइक्रोसॉफ्ट क्लाउड एडवोकेट्स द्वारा हमारे 12 सप्ताह के व्यापक कोर्स के साथ वेब डेवलपमेंट के मूल सिद्धांत सीखें। 24 पाठों में से प्रत्येक में टेरारियम, ब्राउज़र एक्सटेंशन और स्पेस गेम जैसे हैंड्स-ऑन प्रोजेक्ट्स के जरिए JavaScript, CSS, और HTML पर गहराई से चर्चा की गई है। क्विज़, चर्चाओं, और व्यावहारिक असाइनमेंट्स के साथ जुड़ें। अपनी कौशल को बढ़ाएं और हमारे प्रभावी प्रोजेक्ट-आधारित शिक्षण पद्धति के साथ अपने ज्ञान को यादगार बनाएं। आज ही अपनी कोडिंग यात्रा शुरू करें!
Azure AI Foundry Discord समुदाय में शामिल हों
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
Azure AI Foundry डिसकॉड समुदाय में शामिल हों
इन संसाधनों का उपयोग शुरू करने के लिए इन चरणों का पालन करें:
1. **रिपॉजिटरी को फोर्क करें**: क्लिक करें [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)
2. **रिपॉजिटरी क्लोन करें**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discord में शामिल हों और विशेषज्ञों व साथी डेवलपर्स से मिलें**](https://discord.com/invite/ByRwuEEgH4)
1. **रिपॉजिटरी को फ़ोर्क करें**: क्लिक करें [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)
2. **रिपॉजिटरी को क्लोन करें**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discord में शामिल हों और विशेषज्ञों तथा अन्य डेवलपर्स से मिलें**](https://discord.com/invite/ByRwuEEgH4)
### 🌐 बहुभाषी समर्थन
#### GitHub एक्शन के माध्यम से समर्थित (स्वचालित एवं हमेशा अपडेट रहता है)
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](./README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md)
#### GitHub Action के माध्यम से समर्थित (स्वचालित और हमेशा अद्यतित)
> **स्थानीय रूप से क्लोन करना पसंद करते हैं?**
> यह रिपॉजिटरी 50+ भाषा अनुवाद शामिल करता है जो डाउनलोड आकार को काफी बढ़ा देता है। बिना अनुवाद के क्लोन करने के लिए sparse checkout का उपयोग करें:
> **क्या आप स्थानीय रूप से क्लोन करना पसंद करते हैं?**
>
> इस रिपॉजिटरी में 50+ भाषा अनुवाद शामिल हैं, जिससे डाउनलोड आकार काफी बढ़ जाता है। बिना अनुवाद के क्लोन करने के लिए, sparse checkout का प्रयोग करें:
>
> **Bash / macOS / Linux:**
> ```bash
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
> ```
> यह आपको कोर्स पूरा करने के लिए आवश्यक सभी चीज़ें तेज डाउनलोड के साथ देता है।
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
**यदि आप अतिरिक्त भाषाओं के अनुवाद चाहते हैं तो वे [यहाँ](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md) सूचीबद्ध हैं**
>
> **CMD (Windows):**
> ```cmd
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
> ```
>
> यह आपको कोर्स पूरा करने के लिए आवश्यक सब कुछ देता है और डाउनलोड भी तेज होता है।
[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners)
**यदि आप अतिरिक्त अनुवाद भाषा चाहते हैं, तो वे [यहाँ](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md) सूचीबद्ध हैं**
#### 🧑‍🎓 _क्या आप छात्र हैं?_
#### 🧑‍🎓 _क्या आप एक छात्र हैं?_
[**स्टूडेंट हब पेज**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) पर जाएं जहाँ आपको शुरुआती संसाधन, छात्र पैक और यहां तक कि मुफ्त प्रमाणपत्र वाउचर पाने के तरीके मिलेंगे। यह वह पेज है जिसे आप बुकमार्क करें और समय-समय पर देखें क्योंकि हम सामग्री माहवारी बदलते रहते हैं।
[**छात्र हब पेज**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) देखें जहाँ आपको शुरुआती संसाधन, छात्र पैक और मुक्त सर्टिफिकेट वाउचर प्राप्त करने के तरीके मिलेंगे। यह वह पेज है जिसे आप बुकमार्क करें और समय-समय पर देखें क्योंकि हम मासिक रूप से सामग्री बदलते रहते हैं।
### 📣 घोषणा - नई GitHub Copilot एजेंट मोड चुनौतियाँ पूरी करें!
### 📣 घोषणा - नए GitHub Copilot Agent मोड चुनौतियाँ पूरी करें!
नई चुनौती जोड़ी गई है, ज्यादातर अध्यायों में "GitHub Copilot Agent Challenge 🚀" देखें। यह आपके लिए GitHub Copilot और एजेंट मोड का उपयोग करके पूरी करने के लिए नई चुनौती है। यदि आपने पहले एजेंट मोड का उपयोग नहीं किया है, तो यह केवल टेक्स्ट जनरेट ही नहीं करता बल्कि फाइलें बना सकता है, संपादित कर सकता है, कमांड चला सकता है और भी बहुत कुछ।
नई चुनौती जोड़ी गई है, अधिकांश अध्यायों में "GitHub Copilot Agent Challenge 🚀" ढूंढें। यह GitHub Copilot और Agent मोड का उपयोग करके पूरी करने के लिए आपकी एक नई चुनौती है। यदि आपने पहले Agent मोड का उपयोग नहीं किया है, तो यह केवल टेक्स्ट उत्पन्न करने में सक्षम नहीं है, बल्कि यह फ़ाइलें बना सकता है, संपादित कर सकता है, कमांड चला सकता है और भी बहुत कुछ कर सकता है
### 📣 घोषणा - _जनरेटिव AI का उपयोग करते हुए नया प्रोजेक्ट बनाएं_
### 📣 घोषणा - _Generative AI का उपयोग करके निर्माण करने के लिए नया प्रोजेक्ट_
नया AI असिस्टेंट प्रोजेक्ट हाल ही में जोड़ा गया है, इसे देखें [project](./9-chat-project/README.md)
नया AI सहायक प्रोजेक्ट अभी जोड़ा गया है, इसे देखें [project](./9-chat-project/README.md)
### 📣 घोषणा - _JavaScript के लिए जनरेटिव AI पर नया पाठ्यक्रम_ अभी जारी हुआ है
### 📣 घोषणा - _Javascript के लिए Generative AI_ पर नया पाठ्यक्रम अभी जारी किया गया है
हमारा नया जनरेटिव AI पाठ्यक्रम मिस न करें!
हमारा नया Generative AI पाठ्यक्रम न चूकें!
शुरू करने के लिए जाए [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)!
शुरू करने के लिए जाए [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
![Background](../../translated_images/hi/background.148a8d43afde5730.webp)
- मूल बातें से लेकर RAG तक सब विषय को कवर करने वाले पाठ।
- GenAI और हमारे सहायक ऐप के माध्यम से ऐतिहासिक पात्रों के साथ बातचीत करें।
- मज़ेदार और आकर्षक कथा, आप समय यात्रा करेंगे!
- बुनियादी से RAG तक सब कुछ कवर करता पाठ।
- GenAI और हमारे सहायक ऐप का उपयोग कर ऐतिहासिक पात्रों के साथ बातचीत करें।
- मज़ेदार और आकर्षक कथा, आप समय यात्रा कर रह होंगे!
![character](../../translated_images/hi/character.5c0dd8e067ffd693.webp)
प्रत्येक पाठ में एक असाइनमेंट, एक ज्ञान जांच और एक चुनौती शामिल है जो आपको निम्न विषयों पर मार्गदर्शन करती है:
प्रत्येक पाठ में एक असाइनमेंट, ज्ञान जांच और एक चुनौती शामिल है जो आपको निम्न विषयों पर सीखने में मार्गदर्शन करती है:
- प्रॉम्प्टिंग और प्रॉम्प्ट इंजीनियरिंग
- टेक्स्ट और इमेज ऐप निर्माण
- खोज ऐप्स
शुरू करने के लिए जाएं [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)!
- टेक्स्ट और इमेज एप जनरेशन
- सर्च एप्लिकेशन
शुरू करने के लिए जाएँ [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
## 🌱 शुरुआत करना
## 🌱 शुरूआत
> **शिक्षकों**, हमने इस पाठ्यक्रम का उपयोग करने के लिए [कुछ सुझाव](for-teachers.md) शामिल किए हैं। हमें आपकी प्रतिक्रिया [हमारे डिस्कशन फोरम](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner) में पसंद आएगी!
> **शिक्षकगण**, हमने [कुछ सुझाव](for-teachers.md) शामिल किए हैं कि इस पाठ्यक्रम का उपयोग कैसे करें। हम आपकी प्रतिक्रिया के लिए उत्सुक हैं [हमारे चर्चा मंच](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner) में!
**[शिक्षार्थी](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, प्रत्येक पाठ के लिए, एक पूर्व व्याख्यान क्विज़ के साथ शुरू करें और व्याख्यान सामग्री पढ़ने, विभिन्न गतिविधियों को पूरा करने, और पोस्ट-व्याख्यान क्विज़ के साथ अपनी समझ जाँचें।
**[शिक्षार्थी](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, हर पाठ के लिए, एक प्री-लेक्चर क्विज़ के साथ शुरू करें और फिर व्याख्यान सामग्री पढ़ें, विभिन्न गतिविधियाँ पूरी करें और पोस्ट-लेक्चर क्विज़ के साथ अपनी समझ जांचें
अपनी सीखने के अनुभव को बेहतर बनाने के लिए, अपने सहपाठियों के साथ जुड़ें और परियोजनाओं पर एक साथ काम करें! चर्चाओं का स्वागत है हमारे [डिस्कशन फोरम](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) में, जहाँ हमारे मॉडरेटर प्रश्नों का जवाब देने के लिए उपलब्ध होंगे
अपना अधिगम अनुभव बेहतर बनाने के लिए, अपने साथियों के साथ जुड़ें और प्रोजेक्ट्स पर मिलकर काम करें! चर्चाएँ हमारे [चर्चा मंच](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) में प्रोत्साहित की जाती हैं जहाँ हमारे मॉडरेटर आपकी मदद के लिए उपलब्ध रहेंगे
अपनी शिक्षा को और बढ़ाने के लिए, हम अत्यधिक अनुशंसा करते हैं कि आप अतिरिक्त अध्ययन सामग्री के लिए [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) देखें
अपनी शिक्षा को आगे बढ़ाने के लिए, हम अतिरिक्त अध्ययन सामग्री के लिए [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) का पता लगाने की सिफारिश करते हैं।
### 📋 अपना पर्यावरण सेट करें
### 📋 अपना परिवेश सेटअप करना
इस पाठ्यक्रम के पास तैयार विकास पर्यावरण है! शुरुआत करते समय आप पाठ्यक्रम को [Codespace](https://github.com/features/codespaces/) (ब्राउज़र-आधारित, बिना इंस्टॉल के वातावरण) में चलाना चुन सकते हैं, या अपने कंप्यूटर पर स्थानीय रूप से [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) जैसे टेक्स्ट संपादक का उपयोग कर सकते हैं।
इस पाठ्यक्रम के लिए एक विकास पर्यावरण तैयार है! जैसे ही आप शुरू करें, आप इस पाठ्यक्रम को [Codespace](https://github.com/features/codespaces/) (_एक ब्राउज़र-आधारित, बिना इंस्टॉल वाले पर्यावरण_) में चला सकते हैं, या अपने कंप्यूटर पर ही [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) जैसे टेक्स्ट एडिटर का उपयोग कर सकते हैं।
#### अपनी रिपॉजिटरी बनाएं
अपना कार्य आसानी से सहेजने के लिए, यह अनुशंसा की जाती है कि आप इस रिपॉजिटरी की अपनी प्रति बनाएं। ऐसा करने के लिए पेज के शीर्ष पर **Use this template** बटन पर क्लिक करें। यह आपके GitHub खाते में पाठ्यक्रम की एक प्रति के साथ नई रिपॉजिटरी बनाएगा।
#### अपनी रिपॉजिटरी बनाएँ
अपने कार्य को आसानी से सहेजने के लिए, ये अनुशंसित है कि आप इस रिपॉजिटरी की अपनी कॉपी बनाएं। आप इसे पेज के ऊपर के **Use this template** बटन पर क्लिक करके कर सकते हैं। यह आपके GitHub खाते में पाठ्यक्रम की एक कॉपी के साथ एक नई रिपॉजिटरी बनाएगा।
इन चरणों का पालन करें:
1. **रिपॉजिटरी को फोर्क करें**: इस पेज के टॉप-राइट कोने में "Fork" बटन पर क्लिक करें।
2. **रिपॉजिटरी क्लोन करें**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
1. **रिपॉजिटरी को फोर्क करें**: इस पेज के ऊपर-दाएं कोने में "Fork" बटन पर क्लिक करें।
2. **रिपॉजिटरी को क्लोन करें**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
#### Codespace में पाठ्यक्रम चलाना
#### एक Codespace में पाठ्यक्रम चलाएँ
आपने जो रिपॉजिटरी की प्रति बनाई है, उसमें **Code** बटन पर क्लिक करें और **Open with Codespaces** चुनें। इससे आपके लिए एक नया Codespace बनेगा जिसमें आप काम कर सकते हैं
आपकी बनाई गई इस रिपॉजिटरी की कॉपी में, **Code** बटन पर क्लिक करें और **Open with Codespaces** चुनें। यह आपके लिए काम करने के लिए एक नया Codespace बनाएगा
![Codespace](../../translated_images/hi/createcodespace.0238bbf4d7a8d955.webp)
#### अपने कंप्यूटर पर स्थानीय रूप से पाठ्यक्रम चलाना
इस पाठ्यक्रम को अपने कंप्यूटर पर चलाने के लिए, आपको एक टेक्स्ट एडिटर, एक ब्राउज़र और एक कमांड लाइन टूल की आवश्यकता होगी। हमारा पहला पाठ, [Introduction to Programming Languages and Tools of the Trade](../../1-getting-started-lessons/1-intro-to-programming-languages), आपको इन टूल्स के विभिन्न विकल्पों के बारे में मार्गदर्शन करेगा ताकि आप अपने लिए सबसे अच्छा चुन सकें।
#### अपने कंप्यूटर पर स्थानीय रूप से पाठ्यक्रम चलाएँ
हमारा सुझाव है कि आप [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) का उपयोग करें, जो एक अंतर्निर्मित [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) भी प्रदान करता है। आप Visual Studio Code यहां से डाउनलोड कर सकते हैं: [यहाँ](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)
अपने कंप्यूटर पर स्थानीय रूप से इस पाठ्यक्रम को चलाने के लिए, आपको एक टेक्स्ट संपादक, एक ब्राउज़र और एक कमांड लाइन टूल की आवश्यकता होगी। हमारा पहला पाठ, [Introduction to Programming Languages and Tools of the Trade](../../1-getting-started-lessons/1-intro-to-programming-languages), आपको इन टूल्स के विभिन्न विकल्पों के बारे में गाइड करेगा ताकि आप अपने लिए सबसे अच्छा विकल्प चुन सकें।
1. अपनी रिपॉजिटरी अपने कंप्यूटर पर क्लोन करें। ऐसा करने के लिए **Code** बटन पर क्लिक करें और URL कॉपी करें:
हमारा सुझाव है कि आप [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) का उपयोग संपादक के रूप में करें, जिसमें एक अंतर्निहित [टर्मिनल](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) भी है। आप Visual Studio Code को [यहाँ](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) से डाउनलोड कर सकते हैं।
1. अपने रिपोजिटरी को अपने कंप्यूटर पर क्लोन करें। आप यह **Code** बटन पर क्लिक करके और URL कॉपी करके कर सकते हैं:
[CodeSpace](./images/createcodespace.png)
फिर, [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) के भीतर [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) खोलें और निम्नलिखित कमांड चलाएँ, `<your-repository-url>` को उस URL से बदलते हुए जो आपने अभी कॉपी किया है:
फिर, [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) के भीतर [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) खोलें और निम्नलिखित कमांड चलाएं, `<your-repository-url>` के स्थान पर वह URL डालें जो आपने अभी कॉपी किया है:
```bash
git clone <your-repository-url>
```
2. Visual Studio Code में फोल्डर खोलें। आप यह **File** > **Open Folder** पर क्लिक करके कर सकते हैं और उस फोल्डर का चयन कर हैं जिसे आपने अभी क्लोन किया है।
2. Visual Studio Code में फोल्डर खोलें। आप यह करके कर सकते हैं **File** > **Open Folder** पर क्लिक करके और उस फोल्डर का चयन करके जिसे आपने अभी क्लोन किया है।
> अनुशंसित Visual Studio Code एक्सटेंशन:
> अनुशंसित Visual Studio Code एक्सटेंशन्स:
>
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code के भीतर HTML पृष्ठों का पूर्वावलोकन करने के लिए
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - कोड तेजी से लिखने में मदद करने के लिए
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code के भीतर HTML पेजों का पूर्वावलोकन करने के लिए
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - कोड तेजी से लिखने में मदद के लिए
## 📂 प्रत्येक पाठ में शामिल हैं:
## 📂 हर पाठ में शामिल हैं:
- वैकल्पिक स्केचनोट
- वैकल्पिक पूरक वीडियो
- प्री-लेसन वार्मअप क्विज़
- लिखित पाठ
- प्रोजेक्ट-आधारित पाठों के लिए, प्रोजेक्ट बनाने के चरण-दर-चरण गाइड
- प्रोजेक्ट-आधारित पाठों के लिए, प्रोजेक्ट बनाने के चरण-दर-चरण मार्गदर्शिकाएँ
- ज्ञान जांच
- एक चुनौती
- पूरक पठन सामग्री
- पूरक पठन
- असाइनमेंट
- [पोस्ट-लेसन क्विज़](https://ff-quizzes.netlify.app/web/)
> **क्विज़ के बारे में एक नोट**: सभी क्विज़ Quiz-app फोल्डर में रखे गए हैं, कुल 48 क्विज़ जिनमें तीन-तीन प्रश्न हैं। ये [यहा](https://ff-quizzes.netlify.app/web/) उपलब्ध हैं, क्विज़ ऐप को लोकली चला सकते हैं या Azure पर तैनात कर सकते हैं; `quiz-app` फ़ोल्डर में निर्देशों का पालन करें।
> **क्विज़ के बारे में एक नोट**: सभी क्विज़ क्विज़-ऐप फ़ोल्डर में हैं, कुल 48 क्विज़ जिनमें तीन-तीन प्रश्न हैं। ये [यहा](https://ff-quizzes.netlify.app/web/) उपलब्ध हैं, क्विज़ ऐप को स्थानीय रूप से चलाया जा सकता है या Azure पर परिनियोजित किया जा सकता है; `quiz-app` फ़ोल्डर में दिए निर्देशों का पालन करें।
## 🗃️ पाठ
| | प्रोजेक्ट का नाम | सिखाए गए विषय | सीखने के उद्देश्य | लिंक किया गया पाठ | लेखक |
| :-: | :------------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: |
| 01 | शुरुआत करना | प्रोग्रामिंग और उपयोगी उपकरणों का परिचय | अधिकांश प्रोग्रामिंग भाषाओं के मूल तत्व सीखें और उन सॉफ्टवेयर के बारे में जानें जो पेशेवर डेवलपर्स को उनके काम में मदद करते हैं | [प्रोग्रामिंग भाषाओं और उपकरणों का परिचय](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | शुरुआत करना | GitHub का मूल स्वरूप, टीम के साथ काम करना | अपने प्रोजेक्ट में GitHub का उपयोग करना सीखें, एक कोड बेस पर दूसरों के साथ सहयोग कैसे करें | [GitHub का परिचय](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | शुरुआत करना | पहुँच योग्यता | वेब पहुँच के मूल बातें सीखें | [पहुँच योग्यता के मूल सिद्धांत](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS बुनियादी बातें | JavaScript डेटा प्रकार | JavaScript डेटा प्रकारों का मूल ज्ञान | [डेटा प्रकार](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS बुनियादी बातें | फंक्शन और मेथड्स | एप्लिकेशन के लॉजिक फ्लो को प्रबंधित करने के लिए फंक्शन और मेथड्स के बारे में सीखें | [फ़ंक्शन और मेथड्स](./2-js-basics/2-functions-methods/README.md) | Jasmine और Christopher |
| 06 | JS बुनियादी बातें | JS के साथ निर्णय लेना | निर्णय-लेने के तरीके उपयोग करके अपने कोड में शर्तें बनाना सीखें | [निर्णय लेना](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS बुनियादी बातें | एरे और लूप | JavaScript में डेटा के साथ काम करने के लिए एरे और लूप का उपयोग करें | [एरे और लूप](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML का अभ्यास | एक ऑनलाइन टेरारीयम बनाने के लिए HTML बनाएं, लेआउट बनाने पर ध्यान केंद्रित करें | [HTML का परिचय](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS का अभ्यास | ऑनलाइन टेरारीयम को स्टाइल करने के लिए CSS बनाएं, CSS के मूल सिद्धांतों के साथ पेज को प्रतिक्रियाशील बनाएं | [CSS का परिचय](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScript क्लोज़र, DOM मैनिपुलेशन | टेरारीयम को ड्रैग/ड्रॉप इंटरफेस के रूप में कार्य करने के लिए JavaScript बनाएं, क्लोज़र और DOM मैनिपुलेशन पर ध्यान केंद्रित करें | [JavaScript क्लोज़र, DOM मैनिपुलेशन](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [टाइपिंग गेम](./4-typing-game/solution/README.md) | टाइपिंग गेम बनाना | अपने JavaScript ऐप की लॉजिक चलाने के लिए कीबोर्ड ईवेंट का उपयोग करना सीखें | [ईवेंट-ड्रिवन प्रोग्रामिंग](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | ब्राउज़र के साथ काम करना | ब्राउज़र कैसे काम करते हैं, उनका इतिहास और एक ब्राउज़र एक्सटेंशन के पहले तत्वों का आधार बनाना सीखें | [ब्राउज़र के बारे में](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | फॉर्म बनाना, API कॉल करना और स्थानीय स्टोरेज में वेरिएबल्स स्टोर करना | API कॉल करने के लिए अपने ब्राउज़र एक्सटेंशन के JavaScript तत्व बनाएं, स्थानीय स्टोरेज में रखें गए वेरिएबल्स का उपयोग करें | [API, फॉर्म, और स्थानीय स्टोरेज](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | ब्राउज़र में पृष्ठभूमि प्रक्रियाएं, वेब प्रदर्शन | एक्सटेंशन के आइकन को प्रबंधित करने के लिए ब्राउज़र की पृष्ठभूमि प्रक्रियाओं का उपयोग करें; वेब प्रदर्शन और कुछ अनुकूलन सीखें | [पृष्ठभूमि कार्य और प्रदर्शन](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [स्पेस गेम](./6-space-game/solution/README.md) | JavaScript के साथ अधिक उन्नत गेम विकास | क्लासेज और कम्पोजीशन दोनों का उपयोग करके इनहेरिटेंस और Pub/Sub पैटर्न सीखें, गेम बनाने की तैयारी में | [उन्नत गेम विकास का परिचय](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [स्पेस गेम](./6-space-game/solution/README.md) | कैनवास पर ड्राइंग | स्क्रीन पर तत्वों को ड्रॉ करने के लिए उपयोग की जाने वाली Canvas API के बारे में जानें | [कैनवास पर ड्राइंग](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [स्पेस गेम](./6-space-game/solution/README.md) | स्क्रीन पर तत्वों को स्थानांतरित करना | समझें कि कैसे तत्व कार्टेशियन निर्देशांकों और Canvas API का उपयोग कर गतिशील हो सकते हैं | [तत्वों को स्थानांतरित करना](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [स्पेस गेम](./6-space-game/solution/README.md) | टकराव का पता लगाना | तत्वों को आपस में टकराने दें और कीप्रेस का उपयोग करके प्रतिक्रिया करें तथा गेम के प्रदर्शन सुनिश्चित करने के लिए कूलडाउन फंक्शन प्रदान करें | [टकाव पता लगाना](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [स्पेस गेम](./6-space-game/solution/README.md) | स्कोर बनाए रखना | गेम की स्थिति और प्रदर्शन के आधार पर गणना करें | [स्कोर बनाए रखना](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [स्पेस गेम](./6-space-game/solution/README.md) | गेम को समाप्त करना और पुनः शुरू करना | गेम समाप्त करने और पुनः शुरू करने के बारे में जानें, जिसमें संसाधनों की सफाई और वरिएबल मानों को रीसेट करना शामिल है | [समाप्ति की शर्त](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | वेब ऐप में HTML टेम्पलेट और रूट्स | रूटिंग और HTML टेम्पलेट का उपयोग करके एक मल्टीपेज वेबसाइट की संरचना बनाना सीखें | [HTML टेम्पलेट और रूट्स](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | लॉगिन और पंजीकरण फॉर्म बनाना | फॉर्म बनाना और सत्यापन प्रक्रियाओं को संभालना सीखें | [फॉर्म](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | डेटा प्राप्त करने और उपयोग करने की विधियाँ | आपके ऐप में डेटा कैसे आता है और जाता है, इसे कैसे प्राप्त करें, संग्रहीत करें और नष्ट करें | [डेटा](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | स्टेट प्रबंधन की अवधारणाएँ | सीखें कि आपका ऐप स्टेट को कैसे बनाए रखता है और इसे प्रोग्रामिंग के माध्यम से कैसे प्रबंधित किया जाता है | [स्टेट प्रबंधन](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [Browser/VScode Code](../../8-code-editor) | VScode के साथ काम करना | कोड संपादक का उपयोग करना सीखें | [VScode कोड संपादक का उपयोग](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [AI सहायक](./9-chat-project/README.md) | AI के साथ काम करना | अपना AI सहायक बनाना सीखें | [AI सहायक प्रोजेक्ट](./9-chat-project/README.md) | Chris |
## 🏫 शिक्षाशास्त्र
हमारा पाठ्यक्रम दो महत्वपूर्ण शिक्षाशास्त्रीय सिद्धांतों के साथ डिज़ाइन किया गया है:
| | प्रोजेक्ट का नाम | सिखाए गए अवधारणाएं | सीखने के उद्देश्य | लिंक्ड पाठ | लेखक |
| :-: | :----------------------------------------------------------: | :-----------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------: | :-------------------: |
| 01 | शुरुआत करना | प्रोग्रामिंग और टूल्स का परिचय | अधिकांश प्रोग्रामिंग भाषाओं के पीछे के बुनियादी सिद्धांत सीखें और सॉफ़्टवेयर के बारे में जानें जो पेशेवर विकासकर्ताओं को मदद करता है | [प्रोग्रामिंग भाषाओं और टूल्स का परिचय](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | शुरुआत करना | GitHub के मूल बातें, टीम के साथ काम करना | अपने प्रोजेक्ट में GitHub का उपयोग कैसे करें, और किसी कोड बेस पर दूसरों के साथ सहयोग कैसे करें | [GitHub का परिचय](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | शुरुआत करना | एक्सेबिलिटी | वेब एक्सेसिबिलिटी के मूल बातें सीखें | [एक्सेसिबिलिटी के मूल सिद्धांत](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS बेसिक्स | जावास्क्रिप्ट डेटा टाइप | जावास्क्रिप्ट डेटा टाइप के मूल बातें | [डेटा टाइप](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS बेसिक्स | फंक्शन और मेथड्स | किसी एप्लिकेशन के लॉजिक फ्लो को प्रबंधित करने के लिए फंक्शन और मेथड्स के बारे में जानें | [ंक्शन और मेथड्स](./2-js-basics/2-functions-methods/README.md) | Jasmine और Christopher |
| 06 | JS बेसिक्स | JS के साथ निर्णय लेना | निर्णय लेने के तरीकों का उपयोग करके अपने कोड में कंडीशन्स कैसे बनाएं सीखें | [निर्णय लेना](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS बेसिक्स | एरे और लूप्स | जावास्क्रिप्ट में एरे और लूप्स का उपयोग करके डेटा के साथ काम करें | [एरे और लूप्स](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [टेरियम](./3-terrarium/solution/README.md) | HTML का अभ्यास | ऑनलाइन टेरियम बनाने के लिए HTML बनाएं, विशेष रूप से लेआउट बनाने पर ध्यान केंद्रित करें | [HTML का परिचय](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [टेरियम](./3-terrarium/solution/README.md) | CSS का अभ्यास | ऑनलाइन टेरियम को स्टाइल करने के लिए CSS बनाएं, जिसमें CSS की बुनियादें शामिल हैं और पेज को उत्तरदायी बनाना | [CSS का परिचय](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [टेरियम](./3-terrarium/solution/README.md) | जावास्क्रिप्ट क्लोज़र्स, DOM हेरफेर | टेरियम को ड्रैग/ड्रॉप इंटरफ़ेस के रूप में बनाने के लिए जावास्क्रिप्ट बनाएं, क्लोज़र्स और DOM हेरफेर पर ध्यान केंद्रित करें | [जावास्क्रिप्ट क्लोज़र्स, DOM हेरफेर](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [टाइपिंग गेम](./4-typing-game/solution/README.md) | टाइपिंग गेम बनाएं | अपने जावास्क्रिप्ट ऐप का लॉजिक चलाने के लिए कीबोर्ड इवेंट्स का उपयोग करना सीखें | [इवेंट-संचालित प्रोग्रामिंग](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | ब्राउज़र के साथ काम करना | ब्राउज़र कैसे काम करते हैं, उनका इतिहास और ब्राउज़र एक्सटेंशन के पहले तत्वों को स्कैफोल्ड करना सीखें | [ब्राउज़र के बारे में](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | फॉर्म बनाना, API कॉल करना और लोकल स्टोरेज में वेरिएबल स्टोर करना | अपने ब्राउज़र एक्सटेंशन के जावास्क्रिप्ट तत्व बनाएँ जो API कॉल करें और लोकल स्टोरेज में रखे गए वेरिएबल्स का उपयोग करें | [API, फॉर्म, और लोकल स्टोरेज](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [ग्रीन ब्राउज़र एक्सटेंशन](./5-browser-extension/solution/README.md) | ब्राउज़र में पृष्ठभूमि प्रक्रियाएं, वेब प्रदर्शन | एक्सटेंशन के आइकन को प्रबंधित करने के लिए ब्राउज़र की पृष्ठभूमि प्रक्रियाओं का उपयोग करें; वेब प्रदर्शन और कुछ अनुकूलन सीखें | [पृष्ठभूमि कार्य और प्रदर्शन](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [स्पेस गेम](./6-space-game/solution/README.md) | जावास्क्रिप्ट के साथ अधिक उन्नत गेम विकास | इनहेरिटेंस के बारे में जानें, क्लासेस और कंपोजीशन और Pub/Sub पैटर्न का उपयोग करके, गेम बनाने की तैयारी में | [उन्नत गेम विकास का परिचय](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [स्पेस गेम](./6-space-game/solution/README.md) | कैनवास पर ड्राइंग | Canvas API के बारे में जानें, जिसका उपयोग स्क्रीन पर तत्वों को ड्रॉ करने के लिए किया जाता है | [कैनवास पर ड्राइंग](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [स्पेस गेम](./6-space-game/solution/README.md) | स्क्रीन पर तत्वों को घुमाना | खोजें कि तत्व कैसा गति प्राप्त कर सकते हैं कार्टेशियन कोऑर्डिनेट्स और Canvas API का उपयोग करके | [तत्वों को घुमाना](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [स्पेस गेम](./6-space-game/solution/README.md) | टक्कर पता लगाना | तत्वों को टकराने दें और एक-दूसरे के प्रति प्रतिक्रिया दें कीप्रेस का उपयोग करके, और गेम के प्रदर्शन सुनिश्चित करने के लिए कूलडाउन फंक्शन प्रदान करें | [टक्कर पता लगाना](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [स्पेस गेम](./6-space-game/solution/README.md) | स्कोर बनाए रखना | गेम की स्थिति और प्रदर्शन के आधार पर गणितीय गणनाएँ करें | [स्कोर बनाए रखना](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [स्पेस गेम](./6-space-game/solution/README.md) | गेम को खत्म करना और पुनः शुरू करना | गेम खत्म करने और पुनः शुरू करने के बारे में जानें, जिसमें संसाधनों की सफाई और वरिएबल मानों को रीसेट करना शामिल है | [समाप्ति शर्त](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | वेब ऐप में HTML टेम्प्लेट और रूट्स | रूटिंग और HTML टेम्प्लेट का उपयोग करते हुए एक मल्टिपेज वेबसाइट की संरचना बनाने का तरीका सीखें | [HTML टेम्पलेट और रूट्स](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | लॉगिन और रजिस्ट्रेशन फॉर्म बनाएं | फॉर्म बनाना और वैधता प्रक्रियाओं को संभालने के बारे में जानें | [फॉर्म](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | डेटा प्राप्त करने और उपयोग करने के तरीके | आपका ऐप डेटा को कैसे प्रवाहित करता है, इसे कैसे प्राप्त करे, संग्रहित करे, और निपटाएं | [डेटा](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [बैंकिंग ऐप](./7-bank-project/solution/README.md) | स्टेट मैनेजमेंट की अवधारणाएं | सीखें कि आपका ऐप स्टेट को कैसे रखता है और प्रोग्रामेटिक रूप से इसे कैसे प्रबंधित करता है | [स्टेट मैनेजमेंट](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [ब्राउज़र/VScode कोड](../../8-code-editor) | VScode के साथ काम करना | सीखें कि कोड एडिटर का उपयोग कैसे करें | [VScode कोड एडिटर का उपयोग](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [एआई सहायक](./9-chat-project/README.md) | AI के साथ काम करना | अपना खुद का AI सहायक बनाना सीखें | [AI सहायक प्रोजेक्ट](./9-chat-project/README.md) | Chris |
## 🏫 शिक्षा पद्धति
हमारा पाठ्यक्रम दो मुख्य शैक्षिक सिद्धांतों के साथ डिज़ाइन किया गया है:
* प्रोजेक्ट-आधारित सीखना
* नियमित क्विज़
* बारम्बार क्विज़
कार्यक्रम JavaScript, HTML, और CSS के मूलभूत सिद्धांतों के साथ-साथ आज के वेब डेवलपर्स द्वारा उपयोग किए जाने वाले नवीनतम उपकरणों और तकनीकों को सिखाता है। छात्र व्यापक अनुभव प्राप्त करने के लिए टाइपिंग गेम, वर्चुअल टेरारीयम, पर्यावरण-अनुकूल ब्राउज़र एक्सटेंशन, स्पेस-इन्‍वे़डर-शैली का गेम, और व्यवसायों के लिए बैंकिंग ऐप बना पाएंगे। श्रृंखला के अंत तक, छात्रों को वेब विकास की ठोस समझ प्राप्त होगी।
यह प्रोग्राम जावास्क्रिप्ट, HTML, और CSS के मूल सिद्धांतों के साथ-साथ आज के वेब डेवलपर्स द्वारा उपयोग किए जाने वाले नवीनतम टूल्स और तकनीकों को सिखाता है। छात्र टाइपिंग गेम, वर्चुअल टेरियम, इको-फ्रेंडली ब्राउज़र एक्सटेंशन, स्पेस-इनवेडर शैली के गेम, और व्यवसायों के लिए बैंकिंग ऐप बनाकर व्यावहारिक अनुभव प्राप्त करेंगे। श्रृंखला के अंत तक, छात्रों को वेब विकास की ठोस समझ प्राप्त हो जाएगी।
> 🎓 आप माइक्रोसॉफ्ट लर्न पर इस पाठ्यक्रम की पहली कुछ कक्षाएँ [Lear Path](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) के रूप में ले सकते हैं!
> 🎓 आप इस पाठ्यक्रम के पहले कुछ पाठ [Learn Path](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) के रूप में Microsoft Learn पर ले सकते हैं!
यह सुनिश्चित करके कि सामग्री प्रोजेक्ट्स के अनुरूप हो, प्रक्रिया छात्रों के लिए अधिक आकर्षक हो जाती है और अवधारणाओं को बनाए रखने में सहायता मिलती है। हमने कई शुरुआती पाठ JavaScript के मूल सिद्धांतों पर भी लिखे हैं ताकि अवधारणाओं का परिचय हो सके, ये "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" वीडियो ट्यूटोरियल संग्रह का एक वीडियो के साथ जोड़ा गया है, जिनके कुछ लेखक इस पाठ्यक्रम के योगदानकर्ता हैं
सुनिश्चित करके कि सामग्री प्रोजेक्ट के अनुरूप हो, प्रक्रिया को छात्रों के लिए अधिक आकर्षक बनाया जाता है और अवधारणाओं की पकड़ बढ़ती है। हमने जावास्क्रिप्ट बेसिक्स में कई प्रारंभिक पाठ भी तैयार किए हैं, जो अवधारणाओं का परिचय देते हैं, साथ ही "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" वीडियो ट्यूटोरियल संग्रह से एक वीडियो है, जिनके कुछ लेखक ने इस पाठ्यक्रम में योगदान दिया है
अतिरिक्त रूप से, कक्षा से पहले एक कम दबाव वाला क्विज़ छात्र की सीखने की मंशा को सेट करता है, जबकि कक्षा के बाद दूसरा क्विज़ आगे की अवधारण सुनिश्चित करता है। यह पाठ्यक्रम लचीला और मजेदार बनाने के लिए डिज़ाइन किया गया है और इसे पूरी तरह या आंशिक रूप से लिया जा सकता है। प्रोजेक्ट्स छोटे से शुरू होकर 12-सप्ताह की अवधि के अंत तक धीरे-धीरे जटिल हो जाते हैं।
इसके अतिरिक्त, कक्षा से पहले एक कम जोखिम वाला क्विज़ छात्र की सीखने की इच्छा सेट करता है, जबकि कक्षा के बाद दूसरा क्विज़ और अधिक पकड़ सुनिश्चित करता है। यह पाठ्यक्रम लचीला और मजेदार बनाने के लिए डिज़ाइन किया गया है और संपूर्ण या आंशिक रूप से लिया जा सकता है। प्रोजेक्ट छोटे से शुरू होते हैं और 12 सप्ताह के चक्र के अंत तक काफी जटिल हो जाते हैं।
जबकि हमने जानबूझकर JavaScript फ्रेमवर्क्स का परिचय नहीं दिया है ताकि एक वेब डेवलपर के रूप में आवश्यक बुनियादी कौशलों पर ध्यान केंद्रित किया जा सके, इस पाठ्यक्रम को पूरा करने के लिए अगला अच्छा कदम Node.js के बारे में सीखना होगा, जो एक और वीडियो संग्रह के माध्यम से उपलब्ध है: "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)"।
जबकि हमने जावास्क्रिप्ट फ्रेमवर्क पेश करने से जानबूझकर बचा है ताकि एक वेब डेवलपर के रूप में आवश्यक बुनियादी कौशल पर ध्यान केंद्रित किया जा सके, इस पाठ्यक्रम को पूरा करने के बाद अगला अच्छा कदम Node.js के बारे में सीखना होगा, जो एक और वीडियो संग्रह "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)" के माध्यम से किया जा सकता है
> हमारे [कोड ऑफ कंडक्ट](CODE_OF_CONDUCT.md) और [योगदान देने के नियम](CONTRIBUTING.md) देखें। हम आपकी रचनात्मक प्रतिक्रिया का स्वागत करते हैं!
> हमारे [व्यवहार संहिता](CODE_OF_CONDUCT.md) और [योगदान](CONTRIBUTING.md) दिशानिर्देश देखें। हम आपके रचनात्मक सुझावों का स्वागत करते हैं!
## 🧭 ऑफ़लाइन पहुँच
## 🧭 ऑफ़लाइन एक्सेस
आप यह दस्तावेज़ [Docsify](https://docsify.js.org/#/) का उपयोग करके ऑफ़लाइन चला सकते हैं। इस रिपॉजिटरी को फॉर्क करें, अपनी स्थानीय मशीन पर [Docsify इंस्टॉल करें](https://docsify.js.org/#/quickstart), फिर इस रिपॉजिटरी के रूट फोल्डर में `docsify serve` टाइप करें। वेबसाइट आपके लोकलहोस्ट के पोर्ट 3000 पर सर्व होगी: `localhost:3000`
## 📘 पीडीएफ
सभी पाठों का PDF [यहाँ](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf) पाया जा सकता है।
आप [Docsify](https://docsify.js.org/#/) का उपयोग करके इस दस्तावेज़ को ऑफ़लाइन चला सकते हैं। इस रिपोजिटरी को फोर्क करें, अपने स्थानीय मशीन पर [Docsify इंस्टॉल करें](https://docsify.js.org/#/quickstart), और फिर इस रिपोजिटरी के रूट फ़ोल्डर में टाइप करें `docsify serve`। वेबसाइट आपके लोकलहोस्ट पर पोर्ट 3000 पर सर्व होगी: `localhost:3000`
## 📘 PDF
सभी पाठों का एक पीडीएफ [यहाँ](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf) पाया जा सकता है।
## 🎒 अन्य पाठ्यक्रम
हमारी टीम अन्य कोर्स भी बनाती है! देखें:
हमारी टीम अन्य पाठ्यक्रम भी बनाती है! देखें:
<!-- CO-OP TRANSLATOR OTHER COURSES START -->
### LangChain
@ -221,16 +208,16 @@ Azure AI Foundry Discord समुदाय में शामिल हों
[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst)
---
### Generative AI Series
### जनरेटिव AI श्रृंखला
[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst)
---
### Core Learning
### मुख्य शिक्षण
[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
@ -240,30 +227,30 @@ Azure AI Foundry Discord समुदाय में शामिल हों
[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst)
---
### Copilot Series
### कॉपिलट श्रृंखला
[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)
<!-- CO-OP TRANSLATOR OTHER COURSES END -->
## मदद प्राप्त करना
## सहायता प्राप्त करना
यदि आप फंस जाते हैं या AI ऐप्स बनाने के बारे में कोई प्रश्न है। MCP के बारे में चर्चा में अन्य शिक्षार्थियों और अनुभवी डेवलपर्स से जुड़ें। यह एक सहायक समुदाय है जहां प्रश्न स्वागत है और ज्ञान मुफ्त में साझा किया जाता है।
यदि आप फंसे हुए हैं या AI ऐप बनाने के बारे में कोई प्रश्न हैं, तो MCP के बारे में चर्चा में अन्य सीखने वालों और अनुभवी डेवलपर्स से जुड़ें। यह एक सहायक समुदाय है जहाँ प्रश्नों का स्वागत है और ज्ञान स्वतंत्र रूप से साझा किया जाता है।
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
यदि आपके पास उत्पाद प्रतिक्रिया या निर्माण के दौरान त्रुटियां हैं तो जाएँ:
यदि आपके पास उत्पाद प्रतिक्रिया या निर्माण के दौरान त्रुटियाँ हैं तो यहाँ जाएँ:
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)
## लाइसेंस
यह रिपॉजिटरी MIT लाइसेंस के तहत लाइसेंस प्राप्त है। अधिक जानकारी के लिए [LICENSE](../../LICENSE) फ़ाइल देखें।
यह रिपॉजिटरी MIT लाइसेंस के अंतर्गत लाइसेंस प्राप्त है। अधिक जानकारी के लिए [LICENSE](../../LICENSE) फ़ाइल देखें।
---
<!-- 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 -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "d45ddcc54eb9232a76d08328b09d792e",
"translation_date": "2025-11-06T12:32:35+00:00",
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:34:54+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "ja"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T16:25:20+00:00",
"translation_date": "2026-03-06T14:50:22+00:00",
"source_file": "AGENTS.md",
"language_code": "ja"
},
@ -516,8 +516,8 @@
"language_code": "ja"
},
"README.md": {
"original_hash": "6d6385fd098088cb2d690fb0a6cdaedc",
"translation_date": "2026-02-06T16:21:13+00:00",
"original_hash": "a2c9eed480687319517c08a6319e5536",
"translation_date": "2026-03-06T14:29:38+00:00",
"source_file": "README.md",
"language_code": "ja"
},

@ -1,37 +1,37 @@
# AGENTS.md
## Project Overview
## プロジェクト概要
これは初心者にウェブ開発の基礎を教えるための教育用カリキュラムリポジトリです。Microsoft Cloud Advocatesによって開発された12週間の包括的なコースで、JavaScript、CSS、およびHTMLをカバーする24の実践的なレッスンが含まれています。
これは初心者向けのWeb開発の基礎を教えるための教育カリキュラムリポジトリです。このカリキュラムはMicrosoft Cloud Advocatesによって開発された包括的な12週間コースで、JavaScript、CSS、HTMLをカバーする24の実践的なレッスンを含みます。
### Key Components
### 主な構成要素
- **Educational Content**: プロジェクトベースのモジュールに整理された24の構造化されたレッスン
- **Practical Projects**: テラリウム、タイピングゲーム、ブラウザ拡張機能、スペースゲーム、バンキングアプリ、コードエディター、AIチャットアシスタント
- **Interactive Quizzes**: 各3問のクイズ48回レッスン前後の評価
- **Multi-language Support**: GitHub Actionsによる50以上の言語の自動翻訳
- **Technologies**: HTML、CSS、JavaScript、Vue.js 3、Vite、Node.js、Express、PythonAIプロジェクト用
- **教育コンテンツ**: プロジェクトベースのモジュールに整理された24の構造化されたレッスン
- **実践プロジェクト**: テラリウム、タイピングゲーム、ブラウザ拡張機能、スペースゲーム、バンキングアプリ、コードエディター、AIチャットアシスタント
- **インタラクティブクイズ**: 各3問の48のクイズレッスン前後の評価用
- **多言語サポート**: GitHub Actionsを使用した50以上の言語への自動翻訳
- **技術スタック**: HTML、CSS、JavaScript、Vue.js 3、Vite、Node.js、Express、PythonAIプロジェクト向け
### Architecture
### アーキテクチャ
- レッスンベースの構造を持つ教育用リポジトリ
- 各レッスンフォルダーにはREADME、コード例、解決策を含む
- 独立したプロジェクトは別ディレクトリに配置quiz-app、各レッスンプロジェクト)
- GitHub Actionsを使った翻訳システムco-op-translator
- Docsifyを通じたドキュメント提供およびPDF形式での利用可能
- レッスンベースの構造をもつ教育リポジトリ
- 各レッスンフォルダーにはREADME、コード例、解答が含まれる
- 独立したプロジェクトは別ディレクトリに配置quiz-app、各レッスンプロジェクト
- GitHub Actionsco-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
@ -41,17 +41,17 @@ npm run build # 本番用にビルドする
npm run lint # ESLintを実行する
```
### Bank Project API (Node.js + Express)
### バンクプロジェクトAPINode.js + Express
```bash
cd 7-bank-project/api
npm install
npm start # APIサーバーを起動する
npm run lint # ESLintを実行する
npm run format # Prettierでフォーマットする
npm start # APIサーバーを起動
npm run lint # ESLintを実行
npm run format # Prettierでフォーマット
```
### Browser Extension Projects
### ブラウザ拡張機能プロジェクト
```bash
cd 5-browser-extension/solution
@ -59,15 +59,15 @@ npm install
# ブラウザ固有の拡張機能読み込み手順に従ってください
```
### Space Game Projects
### スペースゲームプロジェクト
```bash
cd 6-space-game/solution
npm install
# ブラウザでindex.htmlを開くか、Live Serverを使用してください
# index.htmlをブラウザで開くか、Live Serverを使用してください
```
### Chat Project (Python Backend)
### チャットプロジェクトPythonバックエンド
```bash
cd 9-chat-project/solution/backend/python
@ -76,37 +76,37 @@ pip install openai
python api.py
```
## Development Workflow
## 開発ワークフロー
### For Content Contributors
### コンテンツ寄稿者向け
1. **リポジトリをフォーク**してGitHubアカウントにコピー
2. **フォークをローカルにクローン**
3. **変更用の新しいブランチを作成**
4. レッスンの内容またはコード例を編集
5. 関連プロジェクトディレクトリでコードをテスト
6. 貢献ガイドラインに従ってプルリクエストを提出
1. リポジトリをGitHubアカウントに**フォーク**する
2. フォークをローカルに**クローン**する
3. 変更用に**新しいブランチ**を作成する
4. レッスンコンテンツやコード例を編集する
5. 関連プロジェクトディレクトリでコード変更をテストする
6. コントリビューションガイドラインに従ってプルリクエストを送る
### For Learners
### 学習者向け
1. リポジトリをフォークまたはクローン
1. リポジトリをフォークまたはクローンする
2. レッスンディレクトリを順に進む
3. 各レッスンのREADMEを読む
4. https://ff-quizzes.netlify.app/web/ で事前クイズを完了
5. レッスンフォルダ内のコード例を実行
6. 課題やチャレンジを終え
7. 事後クイズを受ける
3. 各レッスンのREADMEファイルを読む
4. https://ff-quizzes.netlify.app/web/ でレッスン前のクイズを完了する
5. レッスンフォルダ内のコード例を進める
6. 課題やチャレンジを完了す
7. レッスン後のクイズを受ける
### Live Development
### ライブ開発
- **Documentation**: ルート`docsify serve` を実行ポート3000
- **Quiz App**: quiz-appディレクトリ内`npm run dev` を実行
- **Projects**: HTMLプロジェクトはVS Code Live Server拡張機能を利
- **API Projects**: 各APIディレクトリで `npm start` を実行
- **ドキュメント**: ルートディレクトリ`docsify serve` を実行ポート3000
- **クイズアプリ**: quiz-appディレクトリ`npm run dev` を実行
- **プロジェクト**: HTMLプロジェクトにはVS Code Live Server拡張を使
- **APIプロジェクト**: 各APIディレクトリで `npm start` を実行
## Testing Instructions
## テスト手順
### Quiz App Testing
### クイズアプリのテスト
```bash
cd quiz-app
@ -114,78 +114,78 @@ npm run lint # コードスタイルの問題をチェックする
npm run build # ビルドが成功することを確認する
```
### Bank API Testing
### バンクAPIのテスト
```bash
cd 7-bank-project/api
npm run lint # コードスタイルの問題をチェックする
node server.js # サーバーがエラーなく起動する確認する
node server.js # サーバーがエラーなく起動することを確認する
```
### General Testing Approach
### 一般的なテスト方針
- 教育用リポジトリのため包括的な自動テストは無し
- 手動テストの主なポイント
- エラーなくコード例が実行されること
- ドキュメントリンクが正しく機能すること
- プロジェクトのビルドが成功すること
- コード例がベストプラクティスに準拠していること
- 包括的な自動テストはなく教育用リポジトリです
- 手動テストでは次を重点的に行います
- コード例がエラーなく動作すること
- ドキュメントリンクが正しく機能すること
- プロジェクトのビルドが正常に完了すること
- コード例がベストプラクティスに従っていること
### Pre-submission Checks
### 提出前チェック
- package.jsonがあるディレクトリで `npm run lint` を実行
- Markdownリンクの有効性を検証
- ブラウザNode.jsでコード例をテスト
- 翻訳が正しい構造を維持していることを確認
- package.jsonのあるディレクトリで`npm run lint`を実行
- マークダウンリンクの有効性を確認
- ブラウザまたはNode.jsでコード例をテスト
- 翻訳が構造を維持しているか確認
## Code Style Guidelines
## コードスタイルガイドライン
### JavaScript
- モダンES6以降の構文を使用
- プロジェクトに提供された標準ESLint設定に従う
- 教育用に意味のある変数名、関数名を使用
- 最新のES6+構文を使用
- プロジェクトに提供された標準ESLint設定に従う
- 教育のために意味のある変数・関数名を使う
- 学習者向けにコンセプトを説明するコメントを追加
- 設定された場合はPrettierでフォーマット
- 設定されている場合はPrettierで整形
### HTML/CSS
- セマンティックなHTML5要素を使用
- レスポンシブデザインの原則
- レスポンシブデザインの原則を適用
- 明確なクラス命名規則
- 学習者向けにCSS技術の説明コメントを付加
- CSS技術について学習者向けにコメントを付与
### Python
- PEP 8スタイルガイドラインを遵守
- PEP 8スタイルガイドラインに従う
- 分かりやすく教育的なコード例
- 学習に役立つ場合は型ヒントを使用
- 学習支援として型ヒントを使用
### Markdown Documentation
### Markdownドキュメント
- 明確な見出し階層
- 言語指定をしたコードブロック
- 言語指定ありのコードブロック
- 追加リソースへのリンク
- `images/`ディレクトリ内のスクリーンショットや画像
- アクセシビリティのための画像の代替テキスト
- アクセシビリティのための画像のaltテキスト
### File Organization
### ファイル構成
- レッスンは連番で管理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}/`構造で管理
## Build and Deployment
## ビルドとデプロイ
### Quiz App Deployment (Azure Static Web Apps)
### クイズアプリのデプロイ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 ブランチへのプッシュ時に GitHub Actions ワークフローを通じてデプロイしま
npm run build # dist/ フォルダを作成す
# main へのプッシュ時に GitHub Actions ワークフローを通じてデプロイす
```
Azure Static Web Appsの設定
@ -193,90 +193,90 @@ Azure Static Web Appsの設定
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
### ドキュメントPDF生成
```bash
npm install # docsify-to-pdfをインストールする
npm run convert # docsからPDFを生成する
npm install # docsify-to-pdf をインストールする
npm run convert # docs から PDF を生成する
```
### Docsify Documentation
### Docsifyドキュメント
```bash
npm install -g docsify-cli # Docsifyをグローバルにインストールする
docsify serve # localhost:3000で提供する
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] テラリウムプロジェクトの誤字修正`
変更箇所が分かりやすい明確なタイトルを使う
- `[Quiz-app] レッスンXの新クイズ追加`
- `[Lesson-3] Terrariumプロジェクトのタイプミス修正`
- `[Translation] レッスン5のスペイン語翻訳追加`
- `[Docs] セットアップ手順更新`
### Required Checks
### 必須チェック
PR提出前に
1. **コード品質**
- 影響のあるプロジェクトディレクトリで `npm run lint` 実行
- 該当プロジェクトディレクトリで`npm run lint`実行
- すべての警告・エラーを修正
2. **ビルド確認**
- 該当する場合は `npm run build` 実行
2. **ビルド検証**
- 適用可能なら`npm run build`を実行
- ビルドエラーなしを確認
3. **リンク検証**
- すべてのMarkdownリンクをテスト
- 画像参照が機能するか確認
- 全マークダウンリンクをテスト
- 画像参照が正しいか確認
4. **内容チェック**
4. **内容レビュー**
- スペルや文法の校正
- コード例が正しく教育的であること
- 翻訳が原文の意味を維持していること
- コード例が正しく教育的であることの確認
- 翻訳が原文の意味を維持しているかチェック
### Contribution Requirements
### コントリビューション要件
- Microsoft CLAに同意最初のPR時に自動チェック)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)に従う
- 詳細は [CONTRIBUTING.md](./CONTRIBUTING.md)参照
- PR説明に関連Issue番号を記載該当時
- Microsoft CLAに同意初回PRで自動チェック)
- [Microsoft OSS行動規範](https://opensource.microsoft.com/codeofconduct/)を遵守
- 詳細は[CONTRIBUTING.md](./CONTRIBUTING.md)参照
- 必要に応じてPR説明にイシュー番号を記載
### Review Process
### レビュー手順
- PRはメンテナーおよびコミュニティがレビュー
- 教育上の分かりやすさを優先
- コード例は最新のベストプラクティスに準拠していること
- 翻訳は正確さと文化的適合性を確認
- PRはメンテナとコミュニティによるレビュー
- 教育的明確さを重視
- コード例は現行のベストプラクティスに準拠
- 翻訳は正確かつ文化的に適切であることを確認
## Translation System
## 翻訳システム
### Automated Translation
### 自動翻訳
- GitHub Actionsのco-op-translatorワークフローを利
- 50以上の言語自動翻訳
- ソースファイルは主要ディレクトリに配置
- 翻訳ファイルは `translations/{language-code}/` に配置
- GitHub Actionsでco-op-translatorワークフローを使
- 50以上の言語自動翻訳
- ソースファイルはメインディレクトリに配置
- 翻訳ファイルは`translations/{language-code}/`に配置
### Adding Manual Translation Improvements
### 手動翻訳の改善追加
1. `translations/{language-code}/`内のファイルを見つける
2. 構造を維持しつつ改善を行う
3. コード例が動作し続けることを保証
4. ローカライズたクイズ内容をテスト
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
### よくある問題
**Quiz appが起動しない場合**
- Node.jsバージョンを確認v14+推奨)
- `node_modules` `package-lock.json` を削除し再度 `npm install`
**クイズアプリが起動しない場合**
- Node.jsのバージョンを確認v14以上推奨)
- `node_modules`と`package-lock.json`を削除し再度 `npm install`
- ポート競合を確認デフォルトはViteのポート5173
**APIサーバーが起動しない場合**
- Node.jsバージョンが要件(node >=10)を満たしているか確認
- Node.jsのバージョンが必要条件 (node >=10) を満たすか確認
- ポートが既に使用中でないかチェック
- 依存パッケージを `npm install` でインストール済みか確認
- 依存関係が全て`npm install`でインストール済みか確認
**ブラウザ拡張機能が読み込まれない場合**
- manifest.jsonの形式が正しいか検証
- ブラウザのコンソールでエラーを確認
- ブラウザごとの拡張機能インストール手順に従う
- manifest.json の形式が正しいか確認
- ブラウザコンソールのエラーをチェック
- ブラウザ固有の拡張インストール手順に従う
**Pythonチャットプロジェクトの問題**
- OpenAIパッケージがインストール済みか確認:`pip install openai`
- OpenAIパッケージがインストールされているか確認:`pip install openai`
- GITHUB_TOKEN環境変数が設定されているか確認
- GitHub Modelsのアクセス権をチェック
- 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拡張をインストール
- HTMLプロジェクトにはVS CodeのLive Server拡張を利
- ESLintとPrettier拡張をインストールして一貫したフォーマットを維持
- JavaScriptのデバッグにブラウザのDevToolsを活用
- VueプロジェクトにはVue DevToolsブラウザ拡張をインストール
### Performance Considerations
### パフォーマンスに関する注意
- 50以上の言語の大量翻訳ファイルによりフルクローンは大きい
- コンテンツのみ作業する場合は浅いクローンを使用:`git clone --depth 1`
- 英語コンテンツ作業時は翻訳を検索対象から除外
- 初回実行時はnpm installやViteビルドで遅延が発生することもある
- 50以上の言語の翻訳ファイルが多いためフルクローンは大容量
- コンテンツのみ作業するなら浅いクローンを使用:`git clone --depth 1`
- 英語コンテンツ作業時は翻訳ファイルを検索から除外推奨
- 初回実行時のビルド処理は遅い場合ありnpm install、Viteビルド
## Security Considerations
## セキュリティに関する注意点
### Environment Variables
### 環境変数
- APIキーをリポジトリにコミットしてはいけません
- `.env` ファイルを使用(`.gitignore` に含まれています
- 必要な環境変数はプロジェクトのREADMEに記述
- APIキーはリポジトリに絶対コミットしないこと
- `.env`ファイルを利用(既に`.gitignore`に設定済み
- 必須の環境変数はプロジェクトREADMEに記載
### Python Projects
### Pythonプロジェクト
- 仮想環境を使用する`python -m venv venv`
- 依存関係最新に保つ
- GitHubトークンは最小権限で管理
- 仮想環境を使用推奨`python -m venv venv`
- 依存関係は常に最新に保つ
- GitHubトークンは必要最小限の権限で管理
### GitHub Models Access
### GitHub Modelsアクセス
- GitHub ModelsにはPersonal Access TokensPATが必要
- GitHub Models利用には個人アクセストークンPATが必要
- トークンは環境変数として管理
- トークンや認証情報を絶対にコミットしない
- トークンや資格情報を絶対にコミットしない
## Additional Notes
## 追加ノート
### Target Audience
### 対象ユーザー
- ウェブ開発の完全初心者
- 学習者および自主学習
- 教室でカリキュラムを使用する教師
- アクセシビリティと段階的なスキルアップを重視した内容
- Web開発の完全な初心者
- 学生や独学
- 教室でカリキュラムを使教師
- アクセシビリティと段階的スキル構築を重視したコンテンツ
### Educational Philosophy
### 教育哲学
- プロジェクトベースの学習アプローチ
- 頻繁な知識チェック(クイズ)
- 実践的なコーディング演習
- ハンズオンコーディング演習
- 実世界の応用例
- フレームワーク前の基礎重視
- フレームワーク前の基礎重視
### Repository Maintenance
### リポジトリ運用
- 活発な学習者と貢献者コミュニティ
- 依存関係やコンテンツの定期更新
- メンテナーによる課題と議論の監視
- GitHub Actionsを利用した翻訳更新の自動化
- 活発な学習者とコントリビューターコミュニティ
- 依存関係とコンテンツの定期的な更新
- イシュー・ディスカッションはメンテナが監視
- 翻訳更新はGitHub Actionsで自動化
### Related Resources
### 関連リソース
- [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、データサイエンス、機械学習、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、データサイエンス、機械学習、IoTカリキュラムなど
### Working with Specific Projects
### 各プロジェクトの作業
個別プロジェクトの詳細な手順は以下のREADMEを参照
- `quiz-app/README.md` - Vue 3クイズアプリ
個別プロジェクトの詳細手順はそれぞれのREADMEを参照
- `quiz-app/README.md` - Vue 3クイズアプリ
- `7-bank-project/README.md` - 認証付きバンキングアプリ
- `5-browser-extension/README.md` - ブラウザ拡張機能開発
- `6-space-game/README.md` - Canvasベースゲーム開発
- `6-space-game/README.md` - Canvasベースゲーム開発
- `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 -->

@ -10,205 +10,211 @@
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
# 初心者向けウェブ開発 - カリキュラム
# はじめてのウェブ開発 - カリキュラム
Microsoft Cloud Advocatesによる12週間の総合コースでウェブ開発の基本を学びましょう。24のレッスンそれぞれで、テラリウム、ブラウザ拡張機能、宇宙ゲームなどの実践的なプロジェクトを通じてJavaScript、CSS、HTMLを掘り下げます。クイズ、ディスカッション、実践的な課題も用意。効果的なプロジェクトベースの教授法でスキルを向上し、知識の定着を最適化しましょう。今日からコーディングの旅を始めましょう!
Microsoft Cloud Advocatesによる全12週間の包括的なコースでウェブ開発の基礎を学びましょう。24の各レッスンは、テラリウムやブラウザ拡張機能、宇宙ゲームといった実践的なプロジェクトを通じてJavaScript、CSS、HTMLを深く掘り下げます。クイズ、ディスカッション、実習課題に取り組みましょう。効果的なプロジェクトベースの教育法でスキルを向上させ、知識の定着を最大化します。今日からコーディングの旅を始めましょう!
Azure AI Foundry Discordコミュニティに参加
Azure AI Foundry Discordコミュニティに参加しよう
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
これらのリソースを使い始める手順
1. **リポジトリをフォーク**クリック [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)
2. **リポジトリをクローン**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discordに参加して専門家や他の開発者と交流**](https://discord.com/invite/ByRwuEEgH4)
以下の手順でこれらのリソースの利用を始めましょう
1. **リポジトリをフォークする**[![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)をクリック
2. **リポジトリをクローンする**`git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discordに参加し、専門家や開発者仲間と出会う**](https://discord.com/invite/ByRwuEEgH4)
### 🌐 多言語サポート
### 🌐 多言語対応
#### GitHub Actionで対応(自動かつ常に最新)
#### GitHub Actionsでサポート自動化常に最新)
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](./README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md)
> **ローカルでクローンしますか?**
> このリポジトリには50以上の言語翻訳が含まれているため、ダウンロードサイズが大きくなっています。翻訳なしでクローンするにはスパースチェックアウトを使ってください
> **ローカルでクローンしたいですか?**
>
> このリポジトリには50以上の言語翻訳が含まれており、ダウンロードサイズが大幅に増加します。翻訳を含めずにクローンするには、スパースチェックアウトを使用してください
>
> **Bash / macOS / Linux:**
> ```bash
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
> ```
> これにより、コース完了に必要なすべてがより高速にダウンロードできます。
>
> **CMDWindows:**
> ```cmd
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
> ```
>
> これにより、コースを完了するために必要なすべてがより高速なダウンロードで得られます。
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
**追加翻訳言語の希望は[こちら](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)で確認可能です**
**追加の翻訳言語を希望される場合は、[こちら](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)をご覧ください**
[![Visual Studio Codeで開く](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners)
[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners)
#### 🧑‍🎓 _学生の方へ_
#### 🧑‍🎓 _学生の方ですか?_
[**Student Hubページ**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon)をご覧ください。初心者向けリソース、学生パック、無料の証明書バウチャー取得方法などがあります。月ごとにコンテンツが入れ替わるので、ブックマークして定期的にチェックすることをお勧めします
[**Student Hubページ**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon)へアクセスすると、初心者向けの教材、学生パック、無料の証明書バウチャー取得方法などが見つかります。このページをブックマークし、毎月コンテンツが更新されるので定期的にチェックしてください
### 📣 お知らせ - 新しいGitHub Copilot Agentモードチャレンジが追加されました!
### 📣 お知らせ - 新しいGitHub Copilot Agentモードチャレンジが追加されました
多くの章に「GitHub Copilot Agent Challenge 🚀」という新しいチャレンジがあります。GitHub CopilotとAgentモードを使って完了するチャレンジです。Agentモードはテキスト生成だけでなく、ファイル作成・編集、コマンド実行なども可能です。
多くの章で「GitHub Copilot Agent Challenge 🚀」という新しいチャレンジが追加されています。これはGitHub CopilotとAgentモードを使って完了するチャレンジです。Agentモードを使ったことがない方は、テキスト生成だけでなく、ファイルの作成・編集やコマンドの実行なども可能な機能です。
### 📣 お知らせ - _新しいGenerative AIを使ったプロジェクト_
### 📣 お知らせ - 生成AIを使った新プロジェクト
新しいAIアシスタントプロジェクトが追加されました。詳細は[プロジェクト](./9-chat-project/README.md)をご覧ください。
新しいAIアシスタントプロジェクトが追加されました。こちらの[プロジェクト](./9-chat-project/README.md)をチェックしてください。
### 📣 お知らせ - _生成AIを使ったJavaScript向けの新カリキュラムをリリース_
### 📣 お知らせ - JavaScriptの生成AIに関する新カリキュラムがリリースされました
新しい生成AIカリキュラムをぜひお見逃しなく!
生成AIの新カリキュラムをお見逃しなく!
開始はこちら[https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
開始はこちら [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
![Background](../../translated_images/ja/background.148a8d43afde5730.webp)
- 基礎からRAGまでをカバーしたレッスン
- GenAIとコンパニオンアプリで歴史上のキャラクターと対話
- 楽しく魅力的なストーリーでタイムトラベル
- 基礎からRAGまでカバーするレッスン
- GenAIとコンパニオンアプリで歴史上の人物と対話可能
- 楽しく引き込まれるストーリー、タイムトラベル体験
![character](../../translated_images/ja/character.5c0dd8e067ffd693.webp)
各レッスンには課題、理解度チェック、チャレンジが含まれ、以下のようなテーマの学習をサポートします
各レッスンには課題、理解度チェック、チャレンジが用意されています。学習トピック例
- プロンプトとプロンプトエンジニアリング
- テキストと画像のアプリ生成
- テキストおよび画像アプリの生成
- 検索アプリ
開始はこちら[https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
開始はこちら [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)
## 🌱 はじめに
> **教師の方へ**、このカリキュラムの使い方について[いくつかの提案](for-teachers.md)を含めています。ぜひ[ディスカッションフォーラム](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)でご意見をお聞かせください!
> **先生方へ**、このカリキュラムの使い方に関する[提案](for-teachers.md)を用意しています。ぜひ[ディスカッションフォーラム](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)でフィードバックをお寄せください!
**[学習者](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**は、各レッスンで事前クイズから始め、講義資料を読み、様々なアクティビティを完遂した後、事後クイズで理解度をチェックしましょう
**[学習者の皆さん](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**、各レッスンは事前クイズから始め、講義資料の読解、様々なアクティビティの実施、終了後の確認用クイズへと進んでください
学習効果を高めるために、仲間とつながってプロジェクトを一緒に進めてください!質問は[ディスカッションフォーラム](https://github.com/microsoft/Web-Dev-For-Beginners/discussions)で受け付けており、モデレーターが対応します。
学習経験を向上させるため、仲間とつながって一緒にプロジェクトに取り組みましょう!ディスカッションは[ディスカッションフォーラム](https://github.com/microsoft/Web-Dev-For-Beginners/discussions)で推奨しており、モデレーターが質問に対応します。
さらに学びを深めるために、[Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon)の追加教材の利用を強く推奨します
さらなる学習のために、追加教材がある[Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon)をぜひご利用ください
### 📋 環境設定
### 📋 開発環境のセットアップ
このカリキュラムはすぐに使える開発環境が整っています!開始時には、[Codespace](https://github.com/features/codespaces/)(ブラウザベース、インストール不要)で実行するか、[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)などのテキストエディターを使ってローカル実行も可能です。
このカリキュラムはすぐに使える開発環境を用意しています!開始時には[Codespace](https://github.com/features/codespaces/)(ブラウザベースでインストール不要の環境)で実行するか、お使いのコンピューター上で[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)などのテキストエディターを使って実行するか選べます。
#### リポジトリの作成
#### リポジトリを作成する
作業を簡単に保存するため、自分のコピーのリポジトリを作成することをお勧めします。ページ上部の**Use this template**ボタンをクリックすると、自分のGitHubアカウントにカリキュラムのコピーが作成されます。
作業を簡単に保存できるよう、このリポジトリのコピーを作成することをおすすめします。ページ上部の**Use this template**ボタンをクリックすると、あなたのGitHubアカウントにカリキュラムのコピーが新規リポジトリとして作成されます。
手順はこちら:
1. **リポジトリをフォークする**ページ右上の「Fork」ボタンをクリックします。
2. **リポジトリをクローンする**`git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
手順は以下の通り:
1. **リポジトリをフォーク**ページ右上の「Fork」ボタンをクリック
2. **リポジトリをクローン**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
#### Codespaceでカリキュラムを実行する
#### Codespaceでカリキュラムを実行
作成したリポジトリのコピーで、**Code**ボタンをクリックし、**Open with Codespaces**を選択。新しいCodespaceが作成され、作業可能になります。
作成したリポジトリのコピーで、**Code**ボタンをクリックし、**Open with Codespaces**を選択します。すると作業用の新しいCodespaceが作成されます。
![Codespace](../../translated_images/ja/createcodespace.0238bbf4d7a8d955.webp)
#### ローカルでカリキュラムを実行
ローカル実行にはテキストエディター、ブラウザ、コマンドラインツールが必要です。最初のレッスンである[プログラミング言語と開発ツールの紹介](../../1-getting-started-lessons/1-intro-to-programming-languages)は、複数のツールオプションを紹介し、最適なものを選べるよう案内します。
#### お使いのコンピューターでカリキュラムを実行する
推奨は、エディターに[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)を使うことです。VS Codeには[ターミナル](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)が内蔵されています。ダウンロードはこちら:
カリキュラムをローカルで実行するには、テキストエディター、ブラウザー、コマンドラインツールが必要です。最初のレッスン[プログラミング言語とツールの紹介](../../1-getting-started-lessons/1-intro-to-programming-languages)で、それぞれのツールの選択肢を説明しています。自分に合ったものを選びましょう。
[https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)
1. リポジトリをパソコンにクローンします。**Code**ボタンをクリックし、URLをコピーしてください
お勧めは、[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)のエディター使用で、内蔵の[ターミナル](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)が便利です。Visual Studio Codeは[こちら](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)からダウンロードできます。
1. リポジトリをコンピューターにクローンします。これは **Code** ボタンをクリックしてURLをコピーすることで行えます
[CodeSpace](./images/createcodespace.png)
次に、[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 内の [ターミナル](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) を開き、先ほどコピーした URL に `<your-repository-url>` を置き換えて次のコマンドを実行します:
次に、[Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 内の [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) を開き、コピーした `<your-repository-url>` を置き換えて次のコマンドを実行します:
```bash
git clone <your-repository-url>
```
2. Visual Studio Code でフォルダーを開きます。**ファイル** > **フォルダーを開く** をクリックして、先ほどクローンしたフォルダーを選択します。
2. Visual Studio Codeでフォルダーを開きます。これには **File** > **Open Folder** をクリックし、先ほどクローンしたフォルダーを選択します。
> 推奨される Visual Studio Code拡張機能:
> 推奨されるVisual Studio Code拡張機能
>
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code 内で HTML ページのプレビューをするため
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - コードを書くのをより速く助けるため
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code内でHTMLページをプレビューするため
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - コードを書くのを速く助けるため
## 📂 各レッスンには以下が含まれます:
## 📂 各レッスンには次が含まれます:
- 任意のスケッチノート
- 任意の補足ビデオ
- レッスンのウォームアップクイズ
- 文章によるレッスン
- プロジェクトベースのレッスンの場合は、プロジェクト構築のステップバイステップガイド
- 知識チェック
- 事前レッスンのウォームアップクイズ
- 書かれたレッスン
- プロジェクトベースのレッスンの場合、プロジェクトの作り方の手順付きガイド
- 理解度チェック
- チャレンジ
- 補足読書
- 課題
- [レッスン後のクイズ](https://ff-quizzes.netlify.app/web/)
- [ポストレッスンクイズ](https://ff-quizzes.netlify.app/web/)
> **クイズについての注意**: すべてのクイズは Quiz-app フォルダーにあり、合計48のクイズで各クイズは3問あります。[こちら](https://ff-quizzes.netlify.app/web/)で利用可能で、クイズアプリはローカルで実行することも Azure にデプロイすることもできます。`quiz-app` フォルダーの指示に従ってください。
> **クイズについての注意**すべてのクイズはQuiz-appフォルダーに収められており、合計48の3問クイズがあります。これらは[こちら](https://ff-quizzes.netlify.app/web/)から利用可能で、クイズアプリはローカルで実行するかAzureにデプロイできます。`quiz-app`フォルダー内の指示に従ってください。
## 🗃️ レッスン一覧
| | プロジェクト名 | 教える概念 | 学習目標 | リンクされたレッスン | 著者 |
| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: |
| 01 | Getting Started | プログラミング入門と業務ツールの概要 | ほとんどのプログラミング言語の基本とプロの開発者が仕事をするのに助けとなるソフトウェアについて学ぶ | [プログラミング言語と業務ツール入門](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | Getting Started | GitHubの基本、チームでの作業方法 | プロジェクトでGitHubを使う方法、コードベースでの他者とのコラボレーション方法を学ぶ | [GitHub入門](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | Getting Started | アクセシビリティ | Webアクセシビリティの基本を学ぶ | [アクセシビリティ基礎](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS Basics | JavaScriptのデータ型 | JavaScriptのデータ型の基礎を学ぶ | [データ型](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS Basics | 関数とメソッド | アプリケーションのロジックフローを管理するための関数とメソッドについて学ぶ | [関数とメソッド](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher |
| 06 | JS Basics | JavaScriptによる条件分岐 | 条件分岐メソッドを使ってコードに条件を作成する方法を学ぶ | [条件分岐](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS Basics | 配列とループ | JavaScriptで配列とループを使ってデータを扱う | [配列とループ](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTMLの実践 | オンラインテラリウムを作るHTML構築、レイアウト構築に注力 | [HTML入門](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSSの実践 | オンラインテラリウムをスタイル付けするCSS構築、レスポンシブ対応を含むCSSの基本に注力 | [CSS入門](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScriptのクロージャ、DOM操作 | ドラッグドロップ機能を持つテラリウムを作るJavaScript構築、クロージャとDOM操作に注力 | [JavaScriptのクロージャ、DOM操作](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [Typing Game](./4-typing-game/solution/README.md) | タイピングゲームを作る | キーボードイベントを使ってJavaScriptアプリのロジックを動かす方法 | [イベント駆動プログラミング](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | ブラウザの動作 | ブラウザの仕組み、歴史、ブラウザ拡張機能の最初の要素を作る方法を学ぶ | [ブラウザについて](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | フォーム構築、API呼び出し、ローカルストレージ変数保存 | APIを呼び出すためのブラウザ拡張機能のJavaScript要素構築、ローカルストレージに保存した変数を使用 | [API、フォーム、ローカルストレージ](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | ブラウザのバックグラウンドプロセス、ウェブパフォーマンス | 拡張機能のアイコン管理のためブラウザのバックグラウンドプロセスを利用、ウェブパフォーマンスと最適化について学ぶ | [バックグラウンドタスクとパフォーマンス](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [Space Game](./6-space-game/solution/README.md) | JavaScriptによる高度なゲーム開発 | クラスとコンポジション両方を使った継承とパブ/サブパターンの理解、ゲーム作成の準備として学ぶ | [高度なゲーム開発入門](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [Space Game](./6-space-game/solution/README.md) | Canvasへの描画 | 画面に要素を描画するための Canvas API を学ぶ | [Canvasへの描画](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [Space Game](./6-space-game/solution/README.md) | 画面上の要素を動かす | 要素に動きをつけるための直交座標とCanvas APIの使い方を発見 | [要素を動かす](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [Space Game](./6-space-game/solution/README.md) | 衝突判定 | キープレスを使った要素同士の衝突と反応、ゲーム性能向上のためのクールダウン機能を作る | [衝突判定](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [Space Game](./6-space-game/solution/README.md) | スコア管理 | ゲームの状態と動作に基づく数学計算を行う | [スコア管理](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [Space Game](./6-space-game/solution/README.md) | ゲーム終了と再スタート | ゲームの終了と再スタートについて、アセットのクリーンアップや変数のリセットを含む方法を学ぶ | [終了条件](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [Banking App](./7-bank-project/solution/README.md) | WebアプリにおけるHTMLテンプレートとルーティング | ルーティングとHTMLテンプレートを使ってマルチページのウェブサイト構造を作る方法を学ぶ | [HTMLテンプレートとルー](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [Banking App](./7-bank-project/solution/README.md) | ログインおよび登録フォームの作成 | フォーム作成とバリデーション処理について学ぶ | [フォーム](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [Banking App](./7-bank-project/solution/README.md) | データの取得と利用の方法 | アプリへのデータの流入と流出、フェッチ、保存、破棄方法を学ぶ | [データ](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [Banking App](./7-bank-project/solution/README.md) | 状態管理の概念 | アプリが状態を保持し、それをプログラム的に管理する方法を学ぶ | [状態管理](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [Browser/VScode Code](../../8-code-editor) | VSCodeの使い方 | コードエディターの使い方を学ぶ| [VSCodeコードエディターの使い方](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [AI Assistants](./9-chat-project/README.md) | AIの活用 | 独自のAIアシスタントの作り方を学ぶ | [AIアシスタントプロジェクト](./9-chat-project/README.md) | Chris |
| | プロジェクト名 | 学習内容 | 学習目標 | 関連レッスン | 著者 |
| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: |
| 01 | Getting Started | プログラミングの紹介と開発ツールの基礎 | 主要なプログラミング言語の基本的な基礎知識と、プロの開発者が仕事に使うソフトウェアについて学ぶ | [プログラミング言語と開発ツールの紹介](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | Getting Started | GitHubの基本、チームでの作業を含む | プロジェクトでGitHubを利用する方法とコードベースで他者と協力する方法 | [GitHubの紹介](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | Getting Started | アクセシビリティ | ウェブアクセシビリティの基本を学ぶ | [アクセシビリティ基礎](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS Basics | JavaScriptのデータ型 | JavaScriptのデータ型の基本を学ぶ | [データ型](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS Basics | 関数とメソッド | アプリケーションのロジックの流れを管理する関数とメソッドについて学ぶ | [関数とメソッド](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher |
| 06 | JS Basics | JSでの条件分岐 | コード内で条件を作る決定手法について学ぶ | [条件分岐](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS Basics | 配列とループ | JavaScriptで配列やループを使ってデータを操作する方法 | [配列とループ](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [Terrarium](./3-terrarium/solution/README.md) | 実践的HTML | オンラインテラリウムを作成するためのHTMLを構築し、レイアウトを重視 | [HTMLの紹介](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [Terrarium](./3-terrarium/solution/README.md) | 実践的CSS | オンラインテラリウムのスタイリング用CSSを構築し、ページのレスポンシブ化などCSSの基本を学ぶ | [CSSの紹介](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScriptのクロージャーとDOM操作 | ドラッグドロップインターフェースとして機能するテラリウムのJavaScriptを構築し、クロージャーとDOM操作に注力 | [クロージャーとDOM操作](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [Typing Game](./4-typing-game/solution/README.md) | タイピングゲームを作る | キーボードイベントを利用してJavaScriptアプリのロジックを操作する方法 | [イベント駆動プログラミング](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | ブラウザの仕組み | ブラウザの動作や歴史を学び、ブラウザー拡張機能の最初の要素をスキャフォールドする方法 | [ブラウザについて](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | フォーム構築、API呼び出し、ローカルストレージ変数の利用 | 変数をローカルストレージに保存しAPIを呼び出すブラウザー拡張機能のJavaScript要素を作成 | [API、フォーム、ローカルストレージ](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | ブラウザのバックグラウンドプロセス、ウェブパフォーマンス | 拡張機能のアイコン管理にブラウザのバックグラウンドプロセスを使い、ウェブパフォーマンスと最適化手法を学ぶ | [バックグラウンドタスクとパフォーマンス](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [Space Game](./6-space-game/solution/README.md) | JavaScriptによる高度なゲーム開発 | クラスとコンポジションの継承およびPub/Subパターンについて学び、ゲーム開発の準備をする | [高度なゲーム開発の紹介](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [Space Game](./6-space-game/solution/README.md) | Canvasへの描画 | 画面に要素を描画するためのCanvas APIについて学ぶ | [Canvasへの描画](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [Space Game](./6-space-game/solution/README.md) | 画面上での要素の動かし方 | 要素に動きを与えるためのデカルト座標系とCanvas APIの使い方を学ぶ | [要素の移動](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [Space Game](./6-space-game/solution/README.md) | 衝突検知 | 要素を衝突させ、互いに反応させ、パフォーマンスを維持するためのクールダウン機能を提供する方法 | [衝突検知](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [Space Game](./6-space-game/solution/README.md) | 得点管理 | ゲームの状態とパフォーマンスに基づいた数学的計算を行う | [得点管理](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [Space Game](./6-space-game/solution/README.md) | ゲームの終了と再開 | アセットのクリーンアップと変数値のリセットを含む、ゲームの終了と再開方法について学ぶ | [終了条件](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [Banking App](./7-bank-project/solution/README.md) | ウェブアプリのHTMLテンプレートとルーティング | 複数ページのウェブサイト構造のスキャフォールディングをルーティングとHTMLテンプレートを使って学ぶ | [HTMLテンプレートとルーティング](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [Banking App](./7-bank-project/solution/README.md) | ログインと登録フォームの構築 | フォーム作成およびバリデーション処理について学ぶ | [フォーム](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [Banking App](./7-bank-project/solution/README.md) | データ取得と使用の方法 | アプリ内でのデータの流れ、取得、保存、破棄の方法を学ぶ | [データ](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [Banking App](./7-bank-project/solution/README.md) | ステート管理の概念 | アプリがステートを保持し、プログラムで管理する方法を学ぶ | [ステート管理](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [Browser/VScode Code](../../8-code-editor) | VScodeの使い方 | コードエディタの使い方を学ぶ| [VScodeコードエディタの使い方](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [AI Assistants](./9-chat-project/README.md) | AIを使う | オリジナルのAIアシスタントの作り方を学ぶ | [AIアシスタントプロジェクト](./9-chat-project/README.md) | Chris |
## 🏫 教育方針
当カリキュラムは以下の2つの教育原則を軸に設計されています:
* プロジェクトベース学習
* 頻繁なクイズ
当カリキュラムは次の2つの主要な教育原則を基に設計されています
* プロジェクトベース学習
* 頻繁なクイズ実施
プログラムはJavaScript、HTML、CSSの基本に加え、現代のウェブ開発者が使う最新のツールや技術を教えます。学生はタイピングゲーム、仮想テラリウム、環境にやさしいブラウザ拡張機能、スペースインベーダースタイルのゲーム、企業向けバンキングアプリ作成を通じて実践的な経験を積む機会を持てます。シリーズ終了時にはウェブ開発の確かな理解を得られます。
プログラムはJavaScript、HTML、CSSの基本と、今日のウェブ開発者が使う最新のツールや技術を教えます。学習者はタイピングゲーム、バーチャルテラリウム、環境配慮型ブラウザー拡張機能、スペースインベーダースタイルのゲーム、ビジネス向け銀行アプリ構築を通じて実践経験を積むことができます。シリーズの終了時にはウェブ開発の確固たる理解が得られます。
> 🎓 このカリキュラムの最初の数レッスンは Microsoft Learn の[ラーニングパス](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon)としても学べます!
> 🎓 このカリキュラムの最初の数レッスンはMicrosoft Learnの[Learn Path](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon)として受講可能です!
コンテンツをプロジェクトに連動させることで、学習者の関与を高め、概念の定着を助けるように設計しています。また、JavaScript基礎のスターターレッスンをいくつか作成し、[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)動画チュートリアルコレクションの一部と組み合わせています。このシリーズの一部の著者も本カリキュラムに寄稿しています。
内容をプロジェクトに沿わせることで学習者の興味を引きつけ、概念の定着効果を高めます。また、JavaScriptの基本を紹介するいくつかのスターターレッスンと、“[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)”の動画シリーズ(本カリキュラムの著者の一部も関わっている)も組み合わせています。
さらに、低難度のクラス前クイズで学習への意識を促し、クラス後の第2回クイズで深い定着を促進。フレキシブルで楽しく取り組めるように設計されており、12週間の期間中にプロジェクトが徐々に複雑化していきます。
さらに、クラス前の低負荷クイズで学習者の学習意欲を高め、クラス後の2回目のクイズで理解の定着を促します。このカリキュラムは柔軟かつ楽しく受講でき、全体または一部を選んで学ぶことができます。プロジェクトは小さなものから始まり、12週間コースの終わりにかけて徐々に複雑になります。
JavaScriptフレームワークの導入を意図的に避け、ウェブ開発者としての基本スキルを身につけることに集中していますが、カリキュラム修了後の次のステップとしてNode.jsを学ぶための別コレクション動画「[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)」もお勧めします。
> 当プロジェクトの[行動規範](CODE_OF_CONDUCT.md)および[貢献ガイドライン](CONTRIBUTING.md)をご覧ください。建設的なご意見を歓迎します!
フレームワーク導入をあえて避けているため、まずはウェブ開発者としての基本スキルを身につけることに集中できます。次のステップとしては別の動画シリーズ「[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)」を通じてNode.jsを学ぶことが推奨されます。
> 当プロジェクトの[行動規範](CODE_OF_CONDUCT.md)と[貢献ガイド](CONTRIBUTING.md)をご覧ください。建設的なフィードバックを歓迎します!
## 🧭 オフラインアクセス
このドキュメントは [Docsify](https://docsify.js.org/#/) を使ってオフラインで閲覧できます。このリポジトリをフォークし、ローカル環境に [Docsifyをインストール](https://docsify.js.org/#/quickstart)してから、このリポジトリのルートフォルダーで `docsify serve` を実行すると、ウェブサイトがローカルホストの3000番ポートで提供されます: `localhost:3000`
[Docsify](https://docsify.js.org/#/)を使うことで、このドキュメントをオフラインで利用できます。このリポジトリをフォークし、ローカルマシンに[Docsifyをインストール](https://docsify.js.org/#/quickstart)した後、リポジトリのルートフォルダーで `docsify serve` コマンドを実行します。ウェブサイトはローカルホストのポート3000で提供されます: `localhost:3000`
## 📘 PDF
すべてのレッスンをまとめたPDFは[こちら](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf)で入手できます。
すべてのレッスンのPDFは、[こちら](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf)で入手できます。
## 🎒 その他のコース
私たちのチームは他にもコースを制作しています!ぜひご覧ください:
私たちのチームはその他のコースも制作しています!ぜひご覧ください:
<!-- CO-OP TRANSLATOR OTHER COURSES START -->
### LangChain
@ -225,7 +231,7 @@ JavaScriptフレームワークの導入を意図的に避け、ウェブ開発
---
### Generative AI Series
### ジェネレーティブAIシリーズ
[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
@ -233,7 +239,7 @@ JavaScriptフレームワークの導入を意図的に避け、ウェブ開発
---
### Core Learning
### コア学習
[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
@ -244,19 +250,19 @@ JavaScriptフレームワークの導入を意図的に避け、ウェブ開発
---
### Copilot Series
### Copilotシリーズ
[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)
<!-- CO-OP TRANSLATOR OTHER COURSES END -->
## ヘルプを得る
## ヘルプを得るには
AIアプリの構築で行き詰まったり質問がある場合は、MCPに関する学習者や経験豊富な開発者と一緒にディスカッションに参加してください。質問が歓迎され、知識が自由に共有されるサポートのあるコミュニティです。
AIアプリの構築で行き詰まったり質問がある場合は、MCPに関する議論に参加して、仲間の学習者や経験豊富な開発者と交流しましょう。質問歓迎で知識を自由に共有するサポートコミュニティです。
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
製品のフィードバックや構築中のエラーについては、以下へお越しください:
製品のフィードバックや構築中のエラーについては、こちらをご覧ください:
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)
@ -268,5 +274,5 @@ AIアプリの構築で行き詰まったり質問がある場合は、MCPに関
<!-- 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 -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "d45ddcc54eb9232a76d08328b09d792e",
"translation_date": "2026-01-06T15:45:22+00:00",
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:41:27+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "ko"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T16:34:37+00:00",
"translation_date": "2026-03-06T14:51:32+00:00",
"source_file": "AGENTS.md",
"language_code": "ko"
},
@ -516,8 +516,8 @@
"language_code": "ko"
},
"README.md": {
"original_hash": "6d6385fd098088cb2d690fb0a6cdaedc",
"translation_date": "2026-02-06T16:28:27+00:00",
"original_hash": "a2c9eed480687319517c08a6319e5536",
"translation_date": "2026-03-06T14:37:22+00:00",
"source_file": "README.md",
"language_code": "ko"
},

@ -2,36 +2,36 @@
## 프로젝트 개요
이 저장소는 초보자를 위한 웹 개발 기초 교육을 위한 교육 커리큘럼 저장소입니다. 커리큘럼은 Microsoft Cloud Advocates가 개발한 종합 12주 과정으로, JavaScript, CSS, HTML을 다루는 24개의 실습 수업으로 구성되어 있습니다.
이 저장소는 초보자에게 웹 개발 기본을 가르치기 위한 교육 커리큘럼 저장소입니다. 커리큘럼은 Microsoft Cloud Advocates가 개발한 12주 과정으로, JavaScript, CSS, HTML을 다루는 24개의 실습 중심 수업으로 구성되어 있습니다.
### 주요 구성 요소
- **교육 콘텐츠**: 프로젝트 기반 모듈로 구성된 24개의 체계적인 수업
- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 뱅킹 앱, 코드 에디터, AI 채팅 도우미
- **인터랙티브 퀴즈**: 각 3문항씩 48개의 퀴즈 (수업 전/후 평가)
- **다국어 지원**: GitHub Actions를 통한 50개 이상 언어 자동 번역
- **교육 콘텐츠**: 프로젝트 기반 모듈로 조직된 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
@ -56,7 +56,7 @@ npm run format # Prettier로 포맷팅
```bash
cd 5-browser-extension/solution
npm install
# 브라우저별 확장 프로그램 로딩 지침을 따르십시오
# 브라우저별 확장 프로그램 로딩 지침을 따르세요
```
### 우주 게임 프로젝트
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# index.html을 브라우저에서 열거나 라이브 서버를 사용하세요
# 브라우저에서 index.html을 열거나 Live Server를 사용하세요
```
### 채팅 프로젝트 (Python 백엔드)
@ -72,7 +72,7 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN 환경 변수를 설정하십시오
# GITHUB_TOKEN 환경 변수를 설정하세요
python api.py
```
@ -80,29 +80,29 @@ 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` 실행
- **프로젝트**: HTML 프로젝트는 VS Code Live Server 확장 사용
- **API 프로젝트**: API 디렉터리에서 `npm start` 실행
- **API 프로젝트**: 해당 API 디렉터리에서 `npm start` 실행
## 테스트 지침
@ -110,82 +110,82 @@ python api.py
```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` 실행
- 마크다운 링크가 유효한지 확인
- 브라우저 또는 Node.js에서 코드 예제 테스트
- 번역본이 구조를 유지하는지 확인
- 마크다운 링크 유효성 확인
- 브라우저 Node.js에서 코드 예제 테스트
- 번역 내용이 올바른 구조 유지하는지 점검
## 코드 스타일 가이드
## 코드 스타일 지침
### 자바스크립트
### JavaScript
- 최신 ES6+ 문법 사용
- 프로젝트에 제공된 표준 ESLint 설정 따름
- 교육 명확성을 위한 의미 있는 변수 및 함수명 사용
- 개념 설명을 위한 주석 추가
- 설정된 경우 Prettier로 포맷팅
- 프로젝트에 제공된 표준 ESLint 설정 준수
- 교육 명확성을 위한 의미 있는 변수 및 함수명 사용
- 학습자를 위한 개념 설명 주석 추가
- 구성된 경우 Prettier로 포맷팅
### HTML/CSS
- 의미 있는 HTML5 요소 사용
- 시맨틱 HTML5 요소 사용
- 반응형 디자인 원칙 적용
- 명확한 클래스 명명 규칙
- CSS 기술 설명 주석
- 학습자용 CSS 기술 설명 주석
### 파이썬
### Python
- PEP 8 스타일 가이드 준수
- 명확하고 교육적인 코드 예제
- 학습에 도움이 되는 경우 타입 힌트 사용
- 학습에 도움이 되는 타입 힌트 추가
### 마크다운 문서
### 마크다운 문서
- 명확한 제목 계층 구조
- 언어 지정 코드 블록
- 추가 자료로의 링크 포함
- 추가 자료 링크 제공
- `images/` 디렉터리 내 스크린샷 및 이미지
- 접근성 위한 이미지 대체 텍스트
- 접근성 위한 이미지 대체 텍스트 포함
### 파일 구성
- 수업은 순차적으로 번호 매김 (1-getting-started-lessons, 2-js-basics 등)
- 수업은 순차 번호 매김 (1-getting-started-lessons, 2-js-basics 등)
- 각 프로젝트는 `solution/`과 종종 `start/` 또는 `your-work/` 디렉터리 포함
- 이미지는 수업별 `images/` 폴더에 저장
- 번역은 `translations/{language-code}/` 구조
- 수업별 `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/ 폴더를 생성합니다
# main 브랜치에 푸시할 때 GitHub Actions 워크플로를 통해 배포합니다
# main 브랜치에 푸시할 때 GitHub Actions 워크플로를 통해 배포합니다
```
Azure Static Web Apps 구성:
@ -203,37 +203,37 @@ 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`로 프로덕션 번들 생성
- 정적 프로젝트: 빌드 단계 없이 직접 파일 제공
- 정적 프로젝트: 빌드 단계 없이 파일 직접 서빙
## 풀 리퀘스트 가이드라인
## 풀 리퀘스트 지침
### 제목 형식
변경 영역을 명확하고 서술적으로 표시:
- `[Quiz-app] 로운 퀴즈 추가 - 수업 X`
변경 영역을 명확히 나타내는 제목 사용:
- `[Quiz-app] 레슨 X용 새 퀴즈 추가`
- `[Lesson-3] 테라리움 프로젝트 오타 수정`
- `[Translation] 수업 5 스페인어 번역 추가`
- `[Translation] 레슨 5 스페인어 번역 추가`
- `[Docs] 설치 지침 업데이트`
### 필요한 점검 사항
### 필 점검 사항
PR 제출 전:
1. **코드 품질**:
- 관련 프로젝트 디렉터리에서 `npm run lint` 실행
- 모든 린트 오류 경고 수정
- 모든 린트 오류 경고 수정
2. **빌드 검증**:
- 적용 가능한 경우 `npm run build` 실행
- 빌드 오류 없는지 확인
2. **빌드 확인**:
- 해당 시 `npm run build` 실행
- 빌드 오류 없 확인
3. **링크 검증**:
- 마크다운 내 모든 링크 테스트
@ -241,22 +241,22 @@ PR 제출 전:
4. **콘텐츠 검토**:
- 맞춤법 및 문법 교정
- 코드 예제 정확하고 교육적임 확인
- 번역이 원문 의미 유지하는지 검증
- 코드 예제 정확하고 교육적임 확인
- 번역이 원문 의미 유지하는지 검증
### 기여
### 기여
- Microsoft CLA 동의 (첫 PR 자동 검사)
- Microsoft CLA 동의(첫 PR 자동 검사)
- [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수
- 자세한 가이드는 [CONTRIBUTING.md](./CONTRIBUTING.md) 참조
- PR 설명에 이슈 번호 포함 시 명기
- 상세 지침은 [CONTRIBUTING.md](./CONTRIBUTING.md) 참고
- 가능 시 PR 설명에 이슈 번호 참조
### 검토 프로세스
### 리뷰 프로세스
- PR은 유지 관리자 및 커뮤니티가 검토
- 교육적 명확성 우선시
- 코드 예제는 최신 모범 사례 따라야 함
- 번역은 정확성 및 문화 적합성 검토
- 코드 예제는 최신 베스트 프랙티스 준수 필요
- 번역은 정확성과 문화적 적합성 검토
## 번역 시스템
@ -264,19 +264,19 @@ PR 제출 전:
- co-op-translator 워크플로우가 포함된 GitHub Actions 사용
- 50개 이상의 언어로 자동 번역
- 소스 파일은 메인 디렉터리 내
- 번역 파일은 `translations/{language-code}/` 위치
- 원본 파일은 메인 디렉터리에 위치
- 번역 파일은 `translations/{language-code}/` 위치
### 수동 번역 개선 추가 방법
### 수동 번역 개선 추가
1. `translations/{language-code}/`에서 파일 위치 확인
2. 구조를 유지하며 개선 작업 수행
3. 코드 예제 기능 유지 확인
4. 현지화된 퀴즈 콘텐츠 테스트
1. `translations/{language-code}/`에서 파일 찾기
2. 구조를 유지하며 개선 작업
3. 코드 예제가 정상 작동 유지 확인
4. 지역화된 퀴즈 내용 테스트
### 번역 메타데이터
번역 파일은 다음과 같은 메타데이터 헤더 포함:
번역 파일에는 메타데이터 헤더 포함:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -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 버전(≥10) 확인
- 포트 사용 중인지 확인
**API 서버 실행 안 됨**:
- Node.js 버전 최소 요구사항 충족(node >=10) 확인
- 포트 사용 중인지 점검
- `npm install`로 모든 의존성 설치 여부 확인
**브라우저 확장 로드 실패**:
- manifest.json 형식 점검
- 브라우저 콘솔 오류 확인
**브라우저 확장 불러오기 실패**:
- manifest.json 형식 올바른지 확인
- 브라우저 콘솔에서 오류 점검
- 브라우저별 확장 설치 지침 준수
**파이썬 채팅 프로젝트 문제**:
**Python 채팅 프로젝트 문제**:
- OpenAI 패키지 설치 확인: `pip install openai`
- GITHUB_TOKEN 환경 변수 설정 확인
- GitHub Models 접근 권한 점검
**Docsify 문서 미서빙**:
- docsify-cli 전역 설치: `npm install -g docsify-cli`
- 저장소 루트 디렉터리에서 실행
**Docsify 문서 미제공**:
- 전역 docsify-cli 설치: `npm install -g docsify-cli`
- 저장소 루트에서 실행
- `docs/_sidebar.md` 파일 존재 확인
### 개발 환경 팁
- HTML 프로젝트에 VS Code Live Server 확장 사
- 일관된 포맷팅을 위해 ESLint 및 Prettier 확장 설치
- JavaScript 디버깅에 브라우저 개발자 도구
- HTML 프로젝트는 VS Code Live Server 확장 활
- 일관된 포맷을 위한 ESLint 및 Prettier 확장 설치
- JavaScript 디버깅에 브라우저 개발자 도구
- Vue 프로젝트는 Vue DevTools 브라우저 확장 설치
### 성능 고려사항
### 성능 고려 사항
- 번역 파일이 50여 개 이상이라 전체 클론 시 용량 큼
- 콘텐츠 작업만 할 경우 `git clone --depth 1` 등 얕은 클론 사용 권장
- 영어 콘텐츠 작업 시 번역 파일 검색 제외
- 초기 실행 시 빌드 및 설치 속도 느릴 수 있음
- 50개 이상 언어 번역 파일 다수로 전체 클론 시 용량 큼
- 콘텐츠 작업 시는 얕은 복제 사용 권장: `git clone --depth 1`
- 영어 콘텐츠 작업 시 번역 파일 검색 제외 권장
- 첫 빌드 시 (npm install, Vite 빌드) 속도 느릴 수 있음
## 보안 고려사항
### 환경 변수
- API 키는 절대 저장소에 커밋하지 말 것
- `.env` 파일 사용 (이미 `.gitignore`에 포함)
- API 키는 절대 저장소에 커밋 금지
- `.env` 파일 사용(이미 `.gitignore`에 포함)
- 프로젝트 README에 필요한 환경 변수 문서화
### 파이썬 프로젝트
### Python 프로젝트
- 가상 환경 사용: `python -m venv venv`
- 의존성 최신 상태 유지
- GitHub 토큰은 최소 권한 설정
- GitHub 토큰은 최소 권한 부여
### GitHub Models 접근
- 개인 액세스 토큰(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) 권장
- 추가 코스: 생성형 AI, 데이터 과학, 머신러닝, IoT 커리큘럼 제공
- [Student Hub 자료](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` - 인증 기능 있는 뱅킹 애플리케이션
- `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 -->

@ -10,70 +10,79 @@
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
# 웹 개발 초보자를 위한 커리큘럼
# 초보자를 위한 웹 개발 - 교육과정
Microsoft Cloud Advocates가 제공하는 12주간의 종합 과정을 통해 웹 개발의 기본을 배워보세요. 24개의 각 레슨은 테라리움, 브라우저 확장 기능, 우주 게임과 같은 실습 프로젝트를 통해 JavaScript, CSS, HTML을 심도 있게 다룹니다. 퀴즈, 토론, 실습 과제에 참여하세요. 효과적인 프로젝트 기반 교수법으로 실력을 향상시키고 지식 습득을 최적화할 수 있습니다. 지금 바로 코딩 여정을 시작하세요!
Microsoft Cloud Advocates가 제공하는 12주간의 종합 과정으로 웹 개발의 기본을 배우세요. 총 24개의 수업에서 테라리움, 브라우저 확장 프로그램, 우주 게임과 같은 실습 프로젝트를 통해 JavaScript, CSS, HTML을 깊이 있게 탐구합니다. 퀴즈, 토론, 실습 과제에도 참여하세요. 효과적인 프로젝트 기반 교육법으로 실력을 향상시키고 지식 유지력을 최적화하세요. 오늘부터 코딩 여정을 시작하세요!
Azure AI Foundry Discord 커뮤니티에 참여하세요
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
다음 단계를 따라 이 리소스를 사용하여 시작하세요:
1. **레포지토리 포크하기**: 클릭 [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)
2. **레포지토리 클론하기**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discord에 가입하여 전문가와 동료 개발자 만나기**](https://discord.com/invite/ByRwuEEgH4)
이 리소스를 사용하기 시작하려면 다음 단계를 따르세요:
1. **저장소 포크하기**: 클릭 [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork)
2. **저장소 클론하기**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
3. [**Azure AI Foundry Discord에 참여하여 전문가 및 동료 개발자를 만나세요**](https://discord.com/invite/ByRwuEEgH4)
### 🌐 다국어 지원
#### GitHub Action을 통한 지원 (자동화 및 항상 최신 상태 유지)
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](./README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md)
[아랍어](../ar/README.md) | [벵골어](../bn/README.md) | [불가리아어](../bg/README.md) | [버마어 (미얀마)](../my/README.md) | [중국어 (간체)](../zh-CN/README.md) | [중국어 (번체, 홍콩)](../zh-HK/README.md) | [중국어 (번체, 마카오)](../zh-MO/README.md) | [중국어 (번체, 대만)](../zh-TW/README.md) | [크로아티아어](../hr/README.md) | [체코어](../cs/README.md) | [덴마크어](../da/README.md) | [네덜란드어](../nl/README.md) | [에스토니아어](../et/README.md) | [핀란드어](../fi/README.md) | [프랑스어](../fr/README.md) | [독일어](../de/README.md) | [그리스어](../el/README.md) | [히브리어](../he/README.md) | [힌디어](../hi/README.md) | [헝가리어](../hu/README.md) | [인도네시아어](../id/README.md) | [이탈리아어](../it/README.md) | [일본어](../ja/README.md) | [칸나다어](../kn/README.md) | [한국어](./README.md) | [리투아니아어](../lt/README.md) | [말레이어](../ms/README.md) | [말라얄람어](../ml/README.md) | [마라티어](../mr/README.md) | [네팔어](../ne/README.md) | [나이지리아 피진어](../pcm/README.md) | [노르웨이어](../no/README.md) | [페르시아어 (파르시)](../fa/README.md) | [폴란드어](../pl/README.md) | [포르투갈어 (브라질)](../pt-BR/README.md) | [포르투갈어 (포르투갈)](../pt-PT/README.md) | [펀자브어 (구르무키)](../pa/README.md) | [루마니아어](../ro/README.md) | [러시아어](../ru/README.md) | [세르비아어 (키릴 문자)](../sr/README.md) | [슬로바키아어](../sk/README.md) | [슬로베니아어](../sl/README.md) | [스페인어](../es/README.md) | [스와힐리어](../sw/README.md) | [스웨덴어](../sv/README.md) | [타갈로그어 (필리피노)](../tl/README.md) | [타밀어](../ta/README.md) | [텔루구어](../te/README.md) | [태국어](../th/README.md) | [터키어](../tr/README.md) | [우크라이나어](../uk/README.md) | [우르두어](../ur/README.md) | [베트남어](../vi/README.md)
> **로컬 클론을 선호하나요?**
> 이 레포지토리는 50개 이상의 언어 번역본을 포함하여 다운로드 크기가 상당히 증가합니다. 번역 없이 클론하려면 스파스 체크아웃을 사용하세요:
> **로컬 클론을 선호하시나요?**
>
> 본 저장소에는 50개 이상의 언어 번역이 포함되어 있어 다운로드 크기가 상당히 증가합니다. 번역 없이 클론하려면 스파스 체크아웃(sparse checkout)을 사용하세요:
>
> **Bash / macOS / Linux:**
> ```bash
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
> ```
> 이렇게 하면 훨씬 빠른 다운로드로 코스 완료에 필요한 모든 것을 얻을 수 있습니다.
>
> **CMD (Windows):**
> ```cmd
> git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git
> cd Web-Dev-For-Beginners
> git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
> ```
>
> 이 방법으로 코스를 완료하는 데 필요한 모든 것을 훨씬 빠르게 다운로드할 수 있습니다.
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
**추가 지원 언어를 원하시면 [여기](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)에서 확인하세요**
**추가 번역 언어 지원을 원하시면 [여기](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)를 참조하세요**
[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners)
[![Visual Studio Code에서 열기](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners)
#### 🧑‍🎓 _학생이신가요?_
초보자 리소스, 학생 팩 및 무료 수료증 바우처 획득 방법도 제공하는 [**학생 허브 페이지**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon)를 방문하세요. 이 페이지는 매달 콘텐츠가 교체되므로 즐겨찾기에 추가하고 가끔 방문하는 것이 좋습니다.
[**학생 허브 페이지**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon)를 방문하세요. 여기에서 초보자용 리소스, 학생용 팩, 그리고 무료 자격증 바우처를 얻는 방법 등을 찾을 수 있습니다. 월별로 콘텐츠가 교체되므로 이 페이지를 즐겨찾기에 추가해 주기적으로 확인하세요.
### 📣 안내 - 완료해야 할 새로운 GitHub Copilot 에이전트 모드 챌린지!
### 📣 공지 - 완료할 수 있는 새로운 GitHub Copilot Agent 모드 챌린지!
새로운 챌린지가 업데이트 되어 대부분의 챕터에서 "GitHub Copilot Agent Challenge 🚀"를 확인하세요. 이 챌린지는 GitHub Copilot과 에이전트 모드를 사용해 완료할 수 있습니다. 에이전트 모드를 처음 사용하신다면, 텍스트 생성뿐 아니라 파일 생성, 편집, 명령 실행 등도 할 수 있습니다.
새로운 챌린지가 추가되었습니다. 대부분의 장에서 "GitHub Copilot Agent Challenge 🚀"를 찾아보세요. 이는 GitHub Copilot과 Agent 모드를 사용하여 완료하는 새로운 도전입니다. Agent 모드를 처음 사용한다면, 텍스트 생성뿐 아니라 파일 생성 및 편집, 명령 실행 등도 할 수 있습니다.
### 📣 안내 - _생성 AI를 활용한 새로운 프로젝트_
### 📣 공지 - _생성 AI를 사용하여 만들 수 있는 새 프로젝트_
새로운 AI 어시스턴트 프로젝트가 추가되었습니다, [프로젝트 확인](./9-chat-project/README.md)
새로운 AI Assistant 프로젝트가 추가되었습니다. 프로젝트를 확인하세요 [project](./9-chat-project/README.md)
### 📣 안내 - _JavaScript용 생성 AI_ 새로운 커리큘럼 출시
### 📣 공지 - _JavaScript를 위한 생성 AI 새 교육과정_ 출시
새로운 생성 AI 커리큘럼을 놓치지 마세요!
새로운 생성 AI 교육과정을 놓치지 마세요!
시작하려면 [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) 방문하세요!
![Background](../../translated_images/ko/background.148a8d43afde5730.webp)
- 기본부터 RAG까지 모든 내용을 다루는 레슨
- 생성 AI와 동반자 앱을 사용해 역사적 인물과 상호작용
- 재미있고 몰입감 있는 이야기, 시간 여행도 해봐요!
- 기본부터 RAG까지 모두 다루는 수업.
- GenAI 및 동반 앱을 이용해 역사적 인물들과 상호작용 가능.
- 재미있고 몰입감 있는 내러티브로 시간 여행 중!
![character](../../translated_images/ko/character.5c0dd8e067ffd693.webp)
각 레슨에는 과제, 지식 점검, 도전 과제가 포함되어 있어 다음과 같은 주제 학습을 안내합니다:
- 프롬프트 및 프롬프트 엔지니어링
각 수업에는 완료해야 할 과제, 지식 확인, 그리고 다음 주제를 학습하는 데 도움이 되는 챌린지가 포함되어 있습니다:
- 프롬프트 작성 및 프롬프트 엔지니어링
- 텍스트 및 이미지 앱 생성
- 검색 앱
@ -83,131 +92,130 @@ Azure AI Foundry Discord 커뮤니티에 참여하세요
## 🌱 시작하기
> **교사 여러분**, 이 커리큘럼 사용법에 대한 [제안](for-teachers.md)을 포함했습니다. 여러분의 피드백을 [토론 포럼](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)에서 기다립니다!
> **교사분들**, 이 교육과정을 활용하는 방법에 대해 [제안사항](for-teachers.md)을 포함했습니다. [토론 포럼](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)에서 여러분의 의견을 들려주세요!
**[학습자](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**는 각 레슨마다 사전 퀴즈로 시작하고 강의 자료를 읽고, 여러 활동을 완료한 후 사후 퀴즈로 이해도를 확인하세요.
**[학습자](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**는 각 수업마다 강의 전 퀴즈를 시작으로, 강의 자료를 읽고 다양한 활동을 완료하며, 강의 후 퀴즈로 이해도를 점검하세요.
학습 경험을 향상시키려면 동료들과 프로젝트를 함께 작업하며 교류하세요! 토론은 [토론 포럼](https://github.com/microsoft/Web-Dev-For-Beginners/discussions)에서 장려되며, 모더레이터 팀이 질문에 답변해 드립니다.
학습 경험을 향상시키기 위해 동료들과 협력하여 프로젝트를 진행하세요! 토론은 [토론 포럼](https://github.com/microsoft/Web-Dev-For-Beginners/discussions)에서 권장되며, 중재자 팀이 여러분의 질문에 답변할 준비가 되어 있습니다.
교육을 더욱 심화하려면 추가 학습 자료를 위해 [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) 강력히 추천합니다.
교육을 더 확장하고 싶다면, 추가 학습 자료를 위해 [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) 탐색을 강력히 추천합니다.
### 📋 개발 환경 설정하기
### 📋 환경 설정
커리큘럼에는 바로 사용할 수 있는 개발 환경이 준비되어 있습니다! 시작할 때 [Codespace](https://github.com/features/codespaces/) (브라우저 기반, 설치 불필요 환경)에서 실행하거나 로컬 컴퓨터에서 [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 같은 텍스트 편집기를 사용해 진행할 수 있습니다.
교육과정은 바로 사용할 수 있는 개발 환경을 제공합니다! 시작할 때 [Codespace](https://github.com/features/codespaces/) (브라우저 기반, 설치 불필요 환경)에서 교육과정을 실행하거나, 컴퓨터에서 텍스트 편집기인 [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)를 사용하여 로컬에서 실행할 수 있습니다.
#### 레포지토리 생성하기
작업 내용을 쉽게 저장하려면 이 레포지토리의 복사본을 만드는 것이 좋습니다. 페이지 상단의 **Use this template** 버튼을 클릭하여 GitHub 계정에 커리큘럼 복사본이 포함된 새 레포지토리를 생성하세요.
#### 저장소 생성하기
작업을 쉽게 저장하기 위해 본 저장소를 복사하는 것이 좋습니다. 페이지 상단에 있는 **Use this template** 버튼을 클릭하면 본 교육과정의 복사본이 내 GitHub 계정에 생성됩니다.
단계별 안내:
1. **레포지토리 포크하기**: 이 페이지 오른쪽 상단의 "Fork" 버튼을 클릭하세요.
2. **레포지토리 클론하기**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
단계별로 진행하세요:
1. **저장소 포크하기**: 페이지 우측 상단의 "Fork" 버튼을 클릭하세요.
2. **저장소 클론하기**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git`
#### Codespace에서 커리큘럼 실행하기
#### Codespace에서 교육과정 실행하기
생성한 레포지토리 복사본에서 **Code** 버튼을 클릭하고 **Open with Codespaces**를 선택하세요. 새로운 Codespace가 생성됩니다.
생성한 저장소 복사본에서 **Code** 버튼을 클릭하고 **Open with Codespaces**를 선택하세요. 새 Codespace가 생성됩니다.
![Codespace](../../translated_images/ko/createcodespace.0238bbf4d7a8d955.webp)
#### 로컬 컴퓨터에서 커리큘럼 실행하기
#### 컴퓨터에서 로컬로 교육과정 실행하기
커리큘럼을 로컬에서 실행하려면 텍스트 편집기, 브라우저, 명령줄 도구가 필요합니다. 첫 번째 레슨 [프로그래밍 언어와 도구 소개](../../1-getting-started-lessons/1-intro-to-programming-languages)에서는 각각의 도구 옵션을 안내해 드립니다.
컴퓨터에서 이 교육과정을 실행하려면 텍스트 편집기, 브라우저, 명령줄 도구가 필요합니다. 첫 번째 수업인 [프로그래밍 언어 및 도구 소개](../../1-getting-started-lessons/1-intro-to-programming-languages)에서는 각 도구의 다양한 옵션을 안내하여 자신에게 맞는 것을 선택할 수 있도록 도와줍니다.
추천하는 편집기는 [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)로, 내장 [터미널](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)도 포함되어 있습니다. Visual Studio Code는 [여기](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)에서 다운로드할 수 있습니다.
1. 레포지토리를 컴퓨터에 클론하세요. **Code** 버튼을 클릭해 URL을 복사하면 됩니다:
추천 편집기는 [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon)로, 내장된 [터미널](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)도 제공합니다. Visual Studio Code는 [여기서](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 다운로드할 수 있습니다.
1. 저장소를 컴퓨터에 복제하세요. 이는 **Code** 버튼을 클릭하고 URL을 복사하여 할 수 있습니다:
[CodeSpace](./images/createcodespace.png)
그런 다음, [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 내에서 [터미널](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)을 열고, `<your-repository-url>`을 방금 복사한 URL로 대체하여 다음 명령을 실행하세요:
그런 다음, [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) 내에서 [Terminal](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon)을 열고, 방금 복사한 URL을 `<your-repository-url>` 대신 사용하여 다음 명령어를 실행하세요:
```bash
git clone <your-repository-url>
```
2. Visual Studio Code에서 폴더를 엽니다. **파일** > **폴더 열기**를 클릭하고 방금 복제한 폴더를 선택하면 됩니다.
2. Visual Studio Code에서 폴더를 엽니다. **File** > **Open Folder**를 클릭한 후 방금 복제한 폴더를 선택하면 됩니다.
> 추천 Visual Studio Code 확장 기능:
> 권장 Visual Studio Code 확장 프로그램:
>
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code 내에서 HTML 페이지 미리보기
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - 코드를 더 빠르게 작성할 수 있도록 도움
> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - Visual Studio Code 내에서 HTML 페이지 미리보기
> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - 코드를 더 빠르게 작성하는 데 도움
## 📂 각 수업에는 다음이 포함됩니다:
- 선택적 스케치노트
- 선택적 보 동영상
- 수업 전 워밍업 퀴즈
- 서면 수업 내용
- 프로젝트 기반 수업의 경우, 프로젝트를 단계별로 만드는 안내서
- 선택적 보 동영상
- 수업 전 준비 퀴즈
- 작성된 수업 내용
- 프로젝트 기반 수업의 경우, 프로젝트를 구축하는 단계별 가이드
- 지식 점검
- 도전 과제
- 보조 읽기 자료
- 보충 독서 자료
- 과제
- [수업 후 퀴즈](https://ff-quizzes.netlify.app/web/)
> **퀴즈 관련 참고:** 모든 퀴즈는 Quiz-app 폴더에 들어 있으며, 각각 세 문제로 이루어진 총 48개의 퀴즈가 있습니다. [여기](https://ff-quizzes.netlify.app/web/)에서 이용 가능하며, 퀴즈 앱은 로컬에서 실행하거나 Azure에 배포할 수 있습니다; `quiz-app` 폴더의 지침을 따르세요.
> **퀴즈에 대한 안내**: 모든 퀴즈는 Quiz-app 폴더에 있으며, 총 48개의 퀴즈, 각 퀴즈는 3문제로 구성되어 있습니다. 퀴즈는 [여기](https://ff-quizzes.netlify.app/web/)에서 볼 수 있으며, 퀴즈 앱은 로컬에서 실행하거나 Azure에 배포할 수 있습니다. `quiz-app` 폴더의 지침을 따르세요.
## 🗃️ 수업 목록
| | 프로젝트 이름 | 학습 개념 | 학습 목표 | 연결된 수업 | 저자 |
| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: |
| 01 | 시작하기 | 프로그래밍 입문 및 개발 도구 소개 | 대부분의 프로그래밍 언어의 기본 토대와 전문 개발자들의 작업을 돕는 소프트웨어에 대해 학습 | [프로그래밍 언어 및 개발 도구 소개](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | 시작하기 | GitHub 기, 팀 작업 포함 | 프로젝트에서 GitHub 사용 방법 및 코드베이스 협업 방법 | [GitHub 소개](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | 시작하기 | 접근성 | 웹 접근성 기본 개념 학습 | [접근성 기초](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS 기본 | JavaScript 데이터 타입 | JavaScript 데이터 타입의 기초 | [데이터 타입](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS 기본 | 함수 및 메서드 | 애플리케이션의 로직 흐름 관리를 위한 함수와 메서드 학습 | [함수 및 메서드](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher |
| 06 | JS 기본 | JavaScript로 의사결정 하기 | 의사결정 방법을 사용하여 코드에 조건 만들기 학습 | [의사결정 만들기](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS 기본 | 배열과 반복문 | JavaScript에서 배열과 반복문을 사용하여 데이터 작업 | [배열과 반복문](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [테라리움](./3-terrarium/solution/README.md) | 실습용 HTML | 온라인 테라리움을 만들기 위한 HTML 구축, 레이아웃 구성에 중점 | [HTML 소개](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [테라리움](./3-terrarium/solution/README.md) | 실습용 CSS | 온라인 테라리움 스타일링을 위한 CSS 구축, 기본 CSS 및 반응형 페이지 만들기 포함 | [CSS 소개](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [테라리움](./3-terrarium/solution/README.md) | JavaScript 클로저, DOM 조작 | 테라리움을 드래그/드롭 인터페이스로 작동하게 만드는 JavaScript 작성, 클로저와 DOM 조작에 중점 | [JavaScript 클로저, DOM 조작](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [타이핑 게임](./4-typing-game/solution/README.md) | 타이핑 게임 만들기 | 키보드 이벤트를 활용하여 JavaScript 앱의 로직 구동 방법 학습 | [이벤트 기반 프로그래밍](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [Green Browser Extension](./5-browser-extension/solution/README.md) | 브라우저 작업 이해 | 브라우저 작동 원리, 역사 및 브라우저 확장 기능의 초기 구성 요소 설계 법 학습 | [브라우저에 대해](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [Green Browser Extension](./5-browser-extension/solution/README.md) | API 호출, 폼 구축 및 로컬 스토리지 변수 저장 | API를 호출하는 브라우저 확장 기능의 JavaScript 요소 빌드, 로컬 스토리지에 저장된 변수 사용 | [API, 폼, 로컬 스토리지](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [Green Browser Extension](./5-browser-extension/solution/README.md) | 브라우저 백그라운드 프로세스, 웹 성능 | 브라우저 백그라운드 프로세스로 확장 아이콘 관리; 웹 성능 및 최적화 학습 | [백그라운드 작업 및 성능](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [스페이스 게임](./6-space-game/solution/README.md) | 고급 게임 개발: 클래스, 구성, Pub/Sub 패턴 | 클래스와 구성, 퍼블리시/서브스크라이브 패턴을 통한 상속 개념 학습, 게임 만들기 준비 | [고급 게임 개발 소개](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [스페이스 게임](./6-space-game/solution/README.md) | 캔버스에 그리기 | 화면에 요소를 그리기 위한 Canvas API 학습 | [캔버스에 그리기](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [스페이스 게임](./6-space-game/solution/README.md) | 화면 요소 이동시키기 | Cartesian 좌표와 Canvas API를 사용해 요소에 동작 부여 | [요소 동시키기](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [스페이스 게임](./6-space-game/solution/README.md) | 충돌 감지 | 키 입력으로 서로 충돌하고 반응하는 요소 만들기, 게임 성능 확보를 위한 쿨다운 함수 제공 | [충돌 감지](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [스페이스 게임](./6-space-game/solution/README.md) | 점수 기록 | 게임 상태와 성과에 따른 수학 계산 수행 | [점수 기록](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [스페이스 게임](./6-space-game/solution/README.md) | 게임 종료 및 재시작 | 게임 종료 및 재시작 방법 학습, 자원 정리 및 변수 초기화 방법 | [종료 조건](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [뱅킹 앱](./7-bank-project/solution/README.md) | 웹 앱의 HTML 템플릿 및 라우팅 | 멀티페이지 웹사이트 아키텍처 스캐폴딩, 라우팅 및 HTML 템플릿 생성 방법 학습 | [HTML 템플릿 및 라우](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [뱅킹 앱](./7-bank-project/solution/README.md) | 로그인 및 회원가입 폼 만들기 | 폼 작성과 검증 처리 방법 학습 | [](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [뱅킹 앱](./7-bank-project/solution/README.md) | 데이터 가져오기 및 사용 방법 | 앱 내 데이터 흐름, 데이터 가져오기, 저장, 폐기 방법 학습 | [데이터](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [뱅킹 앱](./7-bank-project/solution/README.md) | 상태 관리 개념 | 앱 상태 유지 및 프로그래밍 방식 상태 관리 방법 학습 | [상태 관리](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [Browser/VScode 코드](../../8-code-editor) | VSCode 사용법 | 코드를 작성하는 방법 학습| [VSCode 코드 에디터 사용법](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [AI 어시스턴트](./9-chat-project/README.md) | AI 활용 | 나만의 AI 어시스턴트 만들기 학습 | [AI 어시스턴트 프로젝트](./9-chat-project/README.md) | Chris |
## 🏫 교육 철학
우리 교육과정은 두 가지 핵심 교육 원칙을 기반으로 설계되었습니다:
| | 프로젝트 이름 | 학습 개념 | 학습 목표 | 연결된 수업 | 저자 |
| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: |
| 01 | 시작하기 | 프로그래밍과 도구 소개 | 대부분 프로그래밍 언어의 기본 원리와 전문가 개발자가 사용하는 소프트웨어에 대해 학습 | [프로그래밍 언어 및 도구 소개](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine |
| 02 | 시작하기 | GitHub 기, 팀 작업 포함 | 프로젝트에서 GitHub 사용하는 방법 및 코드베이스 협업 방법 | [GitHub 소개](./1-getting-started-lessons/2-github-basics/README.md) | Floor |
| 03 | 시작하기 | 접근성 | 웹 접근성 기본 학습 | [접근성 기초](./1-getting-started-lessons/3-accessibility/README.md) | Christopher |
| 04 | JS 기본 | JavaScript 데이터 유형 | JavaScript 데이터 유형의 기본 | [데이터 유형](./2-js-basics/1-data-types/README.md) | Jasmine |
| 05 | JS 기본 | 함수와 메소드 | 애플리케이션의 로직 흐름 관리를 위한 함수와 메소드 학습 | [함수와 메소드](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher |
| 06 | JS 기본 | JS로 의사 결정 만들기 | 의사 결정 방법을 사용하여 코드 내 조건 만들기 학습 | [의사 결정](./2-js-basics/3-making-decisions/README.md) | Jasmine |
| 07 | JS 기본 | 배열과 반복문 | JavaScript에서 배열과 반복문을 사용하여 데이터 다루기 | [배열과 반복문](./2-js-basics/4-arrays-loops/README.md) | Jasmine |
| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML 실습 | 온라인 테라리움을 만들기 위한 HTML 빌드, 레이아웃 구성에 집중 | [HTML 소개](./3-terrarium/1-intro-to-html/README.md) | Jen |
| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS 실습 | 온라인 테라리움 스타일링용 CSS 빌드, 페이지 반응형 등 CSS 기본에 집중 | [CSS 소개](./3-terrarium/2-intro-to-css/README.md) | Jen |
| 10 | [Terrarium](./3-terrarium/solution/README.md) | JavaScript 클로저, DOM 조작 | 드래그/드롭 인터페이스 기능 구현용 JavaScript 빌드, 클로저 및 DOM 조작에 집중 | [JavaScript 클로저, DOM 조작](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen |
| 11 | [타이핑 게임](./4-typing-game/solution/README.md) | 타이핑 게임 만들기 | 키보드 이벤트를 사용해 JavaScript 앱 로직 제어하는 법 학습 | [이벤트 주도 프로그래밍](./4-typing-game/typing-game/README.md) | Christopher |
| 12 | [Green 브라우저 확장](./5-browser-extension/solution/README.md) | 브라우저 작동 원리 | 브라우저 작동원리, 역사, 그리고 브라우저 확장 첫 요소 구성 학습 | [브라우저에 대하여](./5-browser-extension/1-about-browsers/README.md) | Jen |
| 13 | [Green 브라우저 확장](./5-browser-extension/solution/README.md) | 폼 만들기, API 호출 및 로컬 저장소 변수 저장 | 브라우저 확장을 위한 JavaScript 구축, API 호출과 로컬 저장소 변수 사용 | [API, 폼, 로컬 저장소](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen |
| 14 | [Green 브라우저 확장](./5-browser-extension/solution/README.md) | 브라우저 백그라운드 프로세스 및 웹 성능 | 브라우저 백그라운드 프로세스를 이용해 확장 아이콘 관리하기; 웹 성능 및 최적화 학습 | [백그라운드 작업 및 성능](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen |
| 15 | [우주 게임](./6-space-game/solution/README.md) | JavaScript를 통한 고급 게임 개발 | 클래스와 컴포지션을 이용한 상속과 Pub/Sub 패턴 학습, 게임 개발 준비 | [고급 게임 개발 소개](./6-space-game/1-introduction/README.md) | Chris |
| 16 | [우주 게임](./6-space-game/solution/README.md) | 캔버스에 그리기 | 화면에 요소를 그리는 데 사용하는 Canvas API 학습 | [캔버스에 그리기](./6-space-game/2-drawing-to-canvas/README.md) | Chris |
| 17 | [우주 게임](./6-space-game/solution/README.md) | 요소를 화면에서 움직이기 | 데카르트 좌표와 Canvas API를 이용해 요소에 움직임 부여 방법 학습 | [요소 움직이기](./6-space-game/3-moving-elements-around/README.md) | Chris |
| 18 | [우주 게임](./6-space-game/solution/README.md) | 충돌 감지 | 키 입력을 이용해 요소가 충돌하고 반응하게 만들고, 게임 성능을 위한 쿨다운 함수 제공 | [충돌 감지](./6-space-game/4-collision-detection/README.md) | Chris |
| 19 | [우주 게임](./6-space-game/solution/README.md) | 점수 유지 | 게임 상태와 성능에 따라 수학적 계산 수행 | [점수 유지](./6-space-game/5-keeping-score/README.md) | Chris |
| 20 | [우주 게임](./6-space-game/solution/README.md) | 게임 종료 및 재시작 | 게임 종료 및 재시작 방법, 자산 정리 및 변수 초기화 학습 | [종료 조건](./6-space-game/6-end-condition/README.md) | Chris |
| 21 | [뱅킹 앱](./7-bank-project/solution/README.md) | 웹 앱의 HTML 템플릿 및 라우팅 | 라우팅 및 HTML 템플릿을 사용한 다중 페이지 웹사이트 스캐폴드 생성 방법 학습 | [HTML 템플릿 및 라우](./7-bank-project/1-template-route/README.md) | Yohan |
| 22 | [뱅킹 앱](./7-bank-project/solution/README.md) | 로그인 및 회원가입 폼 만들기 | 폼 빌드와 유효성 검사 처리 방법 학습 | [](./7-bank-project/2-forms/README.md) | Yohan |
| 23 | [뱅킹 앱](./7-bank-project/solution/README.md) | 데이터 가져오기 및 사용 방법 | 앱 내외부의 데이터 흐름 및 가져오기, 저장, 삭제 방법 학습 | [데이터](./7-bank-project/3-data/README.md) | Yohan |
| 24 | [뱅킹 앱](./7-bank-project/solution/README.md) | 상태 관리 개념 | 앱이 상태를 유지하는 방법과 프로그래밍 방식으로 이를 관리하는 법 학습 | [상태 관리](./7-bank-project/4-state-management/README.md) | Yohan |
| 25 | [Browser/VScode Code](../../8-code-editor) | VScode 사용법 | 코드 에디터 사용법 학습 | [VScode 코드 에디터 사용](./8-code-editor/1-using-a-code-editor/README.md) | Chris |
| 26 | [AI 어시스턴트](./9-chat-project/README.md) | AI 활용법 | 나만의 AI 어시스턴트 구축 방법 | [AI 어시스턴트 프로젝트](./9-chat-project/README.md) | Chris |
## 🏫 교수법
우리 커리큘럼은 두 가지 주요 교육 원칙을 기반으로 설계되었습니다:
* 프로젝트 기반 학습
* 자주 퀴즈 진행
* 빈번한 퀴즈
이 프로그램은 JavaScript, HTML, CSS의 기본 원리와 현대 웹 개발자가 사용하는 최신 도구 및 기법을 가르칩니다. 학생들은 타이핑 게임, 가상 테라리움, 친환경 브라우저 확장 기능, 스페이스 인베이더 스타일 게임, 그리고 비즈니스용 뱅킹 앱을 직접 만들어 보며 실무 경험을 쌓을 기회를 가집니다. 시리즈가 끝날 때쯤 학생들은 웹 개발에 대한 탄탄한 이해를 가지게 됩니다.
이 프로그램은 JavaScript, HTML, CSS의 기초뿐만 아니라 오늘날 웹 개발자들이 사용하는 최신 도구와 기법을 가르칩니다. 학생들은 타이핑 게임, 가상 테라리움, 친환경 브라우저 확장, 스페이스 인베이더 스타일 게임, 비즈니스용 뱅킹 앱을 만들며 실습 경험을 쌓습니다. 시리즈 마지막에는 웹 개발에 대한 탄탄한 이해를 갖추게 됩니다.
> 🎓 이 교육과정의 처음 몇 개 수업은 Microsoft Learn의 [학습 경로](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon)로 수강할 수 있습니다!
> 🎓 Microsoft Learn에서 이 커리큘럼 첫 수업들을 [학습 경로](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon)로 수강할 수 있습니다!
콘텐츠가 프로젝트와 일치하여 학생들이 과정에 더 몰입할 수 있으며 개념 유지력이 향상됩니다. JavaScript 기초 개념을 소개하는 여러 기초 수업과, 이 과정에 기여한 저자들이 참여한 "[JavaScript 초보자 시리즈](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)"의 비디오도 함께 제공합니다.
내용을 프로젝트와 연계함으로써 학생 참여를 높이고 개념 이해도를 향상시킵니다. 또한 JavaScript 기초 수업 몇 개는 개념 소개용으로 "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" 영상과 연계되어 있으며, 일부 저자가 본 커리큘럼에 기여했습니다.
또한, 수업 전에 간단한 퀴즈를 통해 학생이 주제 학습의 의지를 다지도록 하고, 수업 후 두 번째 퀴즈로 추가 학습 효과를 보장합니다. 이 교육과정은 융통성 있고 재미있도록 설계되었으며 전체 또는 일부만 수강할 수 있습니다. 프로젝트들은 작게 시작하여 12주 과정 마지막에는 점점 복잡해집니다.
수업 전 저위험 퀴즈로 학습 의도를 설정하고, 수업 후 두 번째 퀴즈로 이해도를 강화하도록 설계되었습니다. 본 커리큘럼은 유연하고 재미있게 진행할 수 있으며, 전체 또는 부분적으로 수강 가능하며, 프로젝트는 작게 시작해 12주 주기 말에는 점점 더 복잡해집니다.
기본 웹 개발 기술에 집중하기 위해 JavaScript 프레임워크 도입은 의도적으로 피했지만, 이 교육과정을 완료한 뒤 다음 단계로 "[Node.js 초보자 시리즈](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)"의 동영상을 통해 Node.js를 학습하는 것을 권장합니다.
프레임워크 채택 전에 웹 개발 기본기를 집중하고자 JavaScript 프레임워크 도입을 피했으나, 커리큘럼 완료 후 단계로 "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)" 영상을 통해 Node.js를 학습하는 것이 좋은 다음 단계가 될 것입니다.
> 우리의 [행동 강령](CODE_OF_CONDUCT.md) 및 [기여 가이드라인](CONTRIBUTING.md)을 참고하세요. 건설적인 피드백을 환영합니다!
> 우리의 [행동 강령](CODE_OF_CONDUCT.md)과 [기여 가이드](CONTRIBUTING.md)를 방문하세요. 건설적인 피드백을 환영합니다!
## 🧭 오프라인 접근
[Docsify](https://docsify.js.org/#/)를 이용해 이 문서를 오프라인에서 실행할 수 있습니다. 이 저장소를 포크하고, 로컬 머신에 [Docsify 설치](https://docsify.js.org/#/quickstart) 후, 이 저장소 루트 폴더에서 `docsify serve` 명령을 실행하세요. 웹사이트는 로컬호스트 3000번 포트에서 제공됩니다: `localhost:3000`.
[Docsify](https://docsify.js.org/#/)를 사용하면 이 문서를 오프라인으로도 실행할 수 있습니다. 이 저장소를 포크한 후, 로컬 머신에 [Docsify를 설치](https://docsify.js.org/#/quickstart)하고, 이 저장소 루트 폴더에서 `docsify serve` 명령을 입력하면 됩니다. 웹사이트는 localhost의 3000 포트(`localhost:3000`)에서 서비스됩니다.
## 📘 PDF
모든 강의의 PDF는 [여기](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf)에서 확인할 수 있습니다.
전체 수업 자료 PDF는 [여기](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf)에서 확인할 수 있습니다.
## 🎒 다른 강의
## 🎒 기타 강의
우리 팀은 다른 강좌도 제작합니다! 확인해 보세요:
우리 팀은 다른 강의도 제공합니다! 확인해 보세요:
<!-- CO-OP TRANSLATOR OTHER COURSES START -->
### LangChain
@ -224,7 +232,7 @@ Azure AI Foundry Discord 커뮤니티에 참여하세요
---
### Generative AI Series
### 생성 AI 시리즈
[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
@ -232,7 +240,7 @@ Azure AI Foundry Discord 커뮤니티에 참여하세요
---
### Core Learning
### 핵심 학습
[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
@ -243,29 +251,29 @@ Azure AI Foundry Discord 커뮤니티에 참여하세요
---
### Copilot Series
### Copilot 시리즈
[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)
<!-- CO-OP TRANSLATOR OTHER COURSES END -->
## 도움 받기
## 도움받기
AI 앱 개발에 막히거나 질문이 있을 경우 MCP에 대해 학습하는 동료 및 경험 많은 개발자들과 토론에 참여하세요. 질문이 환영받고 지식이 자유롭게 공유되는 지원 커뮤니티입니다.
AI 앱 개발 중에 막히거나 질문이 있으면 MCP 관련 토론에 참여하세요. 질문을 환영하고 지식을 자유롭게 공유하는 지원 커뮤니티입니다.
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
제품 피드백이나 빌드 중 오류가 있는 경우 다음을 방문하세요:
제품 피드백이나 오류가 있으면 다음을 방문하세요:
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)
## 라이선스
이 저장소는 MIT 라이선스 하에 있습니다. 자세한 내용은 [LICENSE](../../LICENSE) 파일을 참조하세요.
이 저장소는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 [LICENSE](../../LICENSE) 파일을 참조하세요.
---
<!-- 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