@ -2,29 +2,29 @@
## परियोजना अवलोकन
यह शुरुआती लोगों को वेब विकास के मूलभूत सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम भंडार है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें जावास्क्रिप्ट, CSS, और HTML को कवर करते हुए 24 व्यावहारिक पाठ शामिल हैं।
यह शुरुआती लोगों को वेब विकास के मूल तत्व सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉजिटरी है। यह पाठ्यक्रम एक संपूर्ण 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ होते हैं।
### मुख्य घटक
### प्र मुख घटक
- ** शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ
- ** व्यावहारिक परियोजनाएँ**: टेरा रियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और एआई चैट सहायक
- ** इंटरैक्टिव क्विज़**: प्रत्येक में 3 प्रश्नों के साथ 48 क्विज़ (पाठ से पहले/बाद के मूल्यांकन)
- ** मल्टी -भाषा समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए स्वचालित अनुवाद
- ** व्यावहारिक परियोजनाएँ**: टेररियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और एआई चैट असिस्टेंट
- ** इंटरएक्टिव क्विज़**: 48 क्विज़, प्रत्येक में 3 प्रश्न (पाठ से पहले और बाद में मूल्यांकन)
- ** बहु -भाषा समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए स्वचालित अनुवाद
- ** प्रौद्योगिकियाँ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (एआई परियोजनाओं के लिए)
### वास्तुकला
- पाठ-आधारित संरचना वाला शैक्षिक भंडार
- प्रत्येक पाठ फ़ ोल्डर में README, कोड उदाहरण, और समाधान होते हैं
- स्वतंत्र परियोजनाएँ अलग-अलग निर्देशिकाओं में (quiz-app, विभिन्न पाठ परियोजनाएँ)
- GitHub Actions का उपयोग करते हुए अनुवाद प्रणाली (co-op-translator)
- Docsify के माध्यम से प्रलेखन सेवा प्रदा न और PDF के रूप में उपलब्ध
- शैक्षिक रिपॉजिटरी जो पाठ-आधारित संरचना पर आधारित है
- प्रत्येक पाठ फोल्डर में README, कोड उदाहरण, और समाधान हैं
- स्वायत्त परियोजनाएँ अलग-अलग निर्देशिकाओं में (quiz-app, विभिन्न पाठ परियोजनाएँ)
- GitHub Actions (co-op-translator) का उपयोग करते हुए अनुवाद प्रणाली
- डॉक्सिफाई के माध्यम से प्रलेखन और PDF के रूप में उपलब्ध
## सेटअप कमांड
यह भंडा र मुख्य रूप से शैक्षिक सामग्री उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
यह रिपॉजिटरी मुख्य रूप से शैक्षिक सामग्री उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
### मुख्य भंडा र सेटअप
### मुख्य रिपॉजिटरी सेटअप
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # विकास सर्वर शुरू करें
npm run build # उत्पाद न के लिए निर्माण करें
npm run build # प्रोडक्श न के लिए निर्माण करें
npm run lint # ESLint चलाएं
```
@ -48,7 +48,7 @@ cd 7-bank-project/api
npm install
npm start # एपीआई सर्वर शुरू करें
npm run lint # ESLint चलाएं
npm run format # Prettier के साथ स्वरूपित करें
npm run format # Prettier के साथ फॉर्मेट करें
```
### ब्राउज़र एक्सटेंशन परियोजनाएँ
@ -64,10 +64,10 @@ npm install
```bash
cd 6-space-game/solution
npm install
# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें
# index.html को ब्राउज़र में खोलें या लाइव सर्वर का उपयोग करें
```
### चैट परियोजना (Python बैकएंड )
### चैट प्रोजेक्ट (Python Backend )
```bash
cd 9-chat-project/solution/backend/python
@ -80,29 +80,29 @@ python api.py
### सामग्री योगदानकर्ताओं के लिए
1. ** ** भंडा र को फोर्क करें
2. ** ** स्थानीय रूप से क्लोन करें
3. ** ** एक नई शाखा बनाएं
1. अपने GitHub खाते में रिपॉजिटरी को ** ** करें
2. अपने फोर्क को स्थानीय रूप से ** ** करें
3. अपने परिवर्तनों के लिए एक नई शाखा बनाएं
4. पाठ सामग्री या कोड उदाहरणों में परिवर्तन करें
5. संबंधित परियोजना निर्देशिकाओं में कोड परिवर्तनों का परीक्षण करें
6. योगदान दिशानिर्देशों का पालन करते हुए पुल रिक्वेस्ट सबमिट करें
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` चलाएँ
- ** परियोजनाएँ**: HTML परियोजनाओं के लिए VS Code Live Server एक्सटेंशन का उपयोग करें
- **API परियोजनाएँ** : संबंधित API निर्देशिकाओं में `npm start` चलाएँ
- ** प्रलेखन**: रूट में `docsify serve` चलाएं (पोर्ट 3000)
- ** क्विज़ ऐप**: क्विज़-ऐप निर्देशिका में `npm run dev` चलाएं
- ** परियोजनाएँ**: HTML परियोजनाओं के लिए VS कोड लाइव सर्वर एक्सटेंशन का उपयोग करें
- **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` चलाएँ
- मार्कडाउन लिंक मान्य हो ं
- ` ` वाले निर्देशिकाओं में `npm run lint` चलाएं
- मार्कडाउन लिंक मान्य हैं यह पुष्टि करे ं
- ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें
- सुनिश्चित करें कि अनुवाद संरचना बनाए रखते हैं
- जांचें कि अनुवाद उचित संरचना बनाए रखते हैं
## कोड स्टाइल दिशानिर्देश
### JavaScript
### जावास्क्रिप्ट
- आधुनिक ES6+ सिंटैक्स का उपयोग करें
- परियोजनाओं में उपलब्ध मानक ESLint कंफ िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक वेरिएबल और फ़ंक्शन नाम चुन ें
- शिक्षार्थियों के लिए अवधारणाओं को समझाते हुए टिप्पणियाँ जोड़ें
- Prettier का उपयोग करें जहाँ कॉन्फ़िगर हो
- परियोजनाओं में दिए गए मानक ESLint कॉन्फ़ िगरेशन का पालन करें
- शिक्षार्थियों के लिए समझने योग्य वैरिएबल और फंक्शन नामों का उपयोग कर ें
- अवधारणाओं की व्याख्या करने वाले टिप्पणियाँ जोड़ें
- जहाँ कॉन्फ़िगर हो, Prettier का उपयोग कर स्वरूपित करें
### HTML/CSS
- सेमांटिक HTML5 तत्व
- उत्तरदायी डिज़ाइन सिद्धांत
- स्पष्ट कक्षा नामकरण सम्मेलन
- शिक्षार्थियों के लिए CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
- रिस्पॉन्सिव डिज़ाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंशंस
- CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
### Python
### पायथन
- PEP 8 शैली दिशानिर्देश
- स्पष्ट , शैक्षिक कोड उदाहरण
- जहाँ सहायक हो वहाँ टाइप हिंट्स
- साफ , शैक्षिक कोड उदाहरण
- सीखने में मदद करने के लिए प्रकार संकेत
### Markdown प्रलेखन
### मार्कडाउन दस्तावेज़ीकरण
- स्पष्ट शीर्षक पदानुक्रम
- भाषा निर्दिष्ट कोड ब्लॉक्स
- स्पष्ट हेडिंग पदानुक्रम
- भाषा निर्दिष्ट कोड ब्लॉक
- अतिरिक्त संसाधनों के लिंक
- `images/` निर्देशिकाओं में स्क्रीनशॉट और चित्र
- पहुँच के लिए छवियों हेतु A lt टेक्स्ट
- `images/` निर्देशिकाओं में स्क्रीनशॉट्स और चित्र
- पहुँच के लिए छवियों के लिए a lt टेक्स्ट
### फ़ाइल संगठन
- पाठ क्रमांकित (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` होती है
- पाठ-विशिष्ट `images/` फ़ोल्डर में चित्र संग्रहीत
- पाठ क्रम से क्रम ांकित (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिकाएँ होती हैं
- पाठ-विशिष्ट `images/` फ़ोल्डरों में चित्र संग्रहीत
- अनुवाद `translations/{language-code}/` संरचना में
## निर्माण और परिनियोजन
## निर्माण और तैनाती
### क्विज़ ऐप परिनियोजन (Azure Static Web Apps)
### क्विज़ ऐप तैनाती (Azure Static Web Apps)
क्विज़ ऐप Azure Static Web Apps परिनियोजन के लिए कॉन्फ़िगर है:
क्विज़-ऐप Azure Static Web Apps तैनाती के लिए कॉन्फ़िगर किया गया है:
```bash
cd quiz-app
npm run build # dist/ फ़ोल्डर बनाता है
# मुख्य शाखा में पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से डिप्लॉय करता है
# मुख्य पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से डिप्लॉय करता है
```
Azure Static Web Apps कॉन्फ़िगरेशन:
@ -196,30 +196,30 @@ Azure Static Web Apps कॉन्फ़िगरेशन:
### प्रलेखन PDF निर्माण
```bash
npm install # docsify-to-pdf इंस्टॉल करें
npm install # docsify-to-pdf स्थापित करें
npm run convert # docs से PDF उत्पन्न करें
```
### Docsify प्रलेखन
### डॉक्सिफाई प्रलेखन
```bash
npm install -g docsify-cli # Docsify को ग्लोबली इंस्टॉल करें
docsify serve # localhost:3000 पर सर्व कर ें
npm install -g docsify-cli # Docsify को वैश्विक रूप से स्थापित करें
docsify serve # localhost:3000 पर सेवा द ें
```
### परियोजना-विशिष्ट बिल्ड
### परियोजना-विशिष्ट निर्माण
प्रत्येक परियोजना निर्देशिका में स्वयं का बिल्ड प्रोसेस हो सकता है:
- Vue परियोजनाएं: `npm run build` उत्पाद न बंडल बनाता है
- स्थिर परियोजनाएं: बिल्ड स्टेप नहीं, सीधे फाइलें सर्व कर ें
प्रत्येक परियोजना निर्देशिका में अपना निर्माण प्रक्रिया हो सकती है:
- Vue परियोजनाएँ: `npm run build` प्रोडक्श न बंडल बनाता है
- स्थैतिक परियोजनाएँ: कोई निर्माण चरण नहीं, सीधे फ़ाइलें सेवा द ें
## पुल रिक्वेस्ट दिशानिर्देश
## पुल अनुरोध दिशानिर्देश
### शीर्षक प्रारूप
परिवर्तन क्षेत्र को स्पष्ट करने वाले शीर्षक का उपयोग करें:
स्पष्ट, वर्णनात्मक शीर्षक का उपयोग करें जो परिवर्तन क्षेत्र को दर्शाता हो :
- `[Quiz-app] पाठ X के लिए नया क्विज़ जोड़ें`
- `[Lesson-3] टेर ारियम परियोजना में टाइपो सुधारें`
- `[Lesson-3] टेर रियम परियोजना में वर्तनी सुधारें`
- `[Translation] पाठ 5 के लिए स्पेनिश अनुवाद जोड़ें`
- `[Docs] सेटअप निर्देश अपडेट करें`
@ -228,35 +228,35 @@ docsify serve # localhost:3000 पर सर्व करें
PR सबमिट करने से पहले:
1. ** कोड गुणवत्ता**:
- प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएँ
- सभी लिंटिंग त्रुटियाँ और वार्निंग्स ठीक करें
- प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएं
- सभी linting त्रुटियों और चेतावनियों को ठीक करें
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 विवरण में इश्यू नंबर संदर्भित कर ें
- विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md ](./CONTRIBUTING.md ) देखें
- यदि लागू हो, तो PR विवरण में मुद्दा संख्या का संदर्भ द ें
### समीक्षा प्रक्रिया
- PR मेंटेनर्स और समुदाय द्वारा समीक्षा की जाती है
- PRs मेंटेनर्स और समुदाय द्वारा समीक्षा किए जाते हैं
- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
- कोड उदाहरण नवीनतम सर्वोत्तम प्रथाओं का पालन करें
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा किए जाते हैं
- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए
- अनुवादों को सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा किया जाता है
## अनुवाद प्रणाली
@ -264,19 +264,19 @@ PR सबमिट करने से पहले:
- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग करता है
- 50+ भाषाओं में स्वचालित रूप से अनुवाद करता है
- मुख्य निर्देशिकाओं में स्रोत फ़ाइले ं
- `translations/{language-code}/` निर्देशिकाओं में अनूदित फाइले ं
- स्रोत फाइलें मुख्य निर्देशिकाओं में होती है ं
- अनुवादित फाइलें `translations/{language-code}/` निर्देशिकाओं में होती है ं
### मैनुअल अनुवाद सुधार जोड़ना
1. `translations/{language-code}/` में फ़ाइल खोजे ं
1. `translations/{language-code}/` में फ़ाइल का पता लगाए ं
2. संरचना बनाए रखते हुए सुधार करें
3. कोड उदाहरण कार्यक्षमता सुनिश्चित कर ें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील बने रह ें
4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
### अनुवाद मेटाडेटा
अनू दित फ़ाइलों में मेटाडेटा हेडर शामिल है:
अनुवा दित फ़ाइलों में मेटाडेटा हेडर शामिल होता है:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -295,114 +295,114 @@ CO_OP_TRANSLATOR_METADATA:
**क्विज़ ऐप शुरू नहीं होता**:
- Node.js संस्करण जांचें (v14+ अनुशंसित)
- `node_modules` और `package-lock.json` हटाएँ, फिर `npm install` चलाएँ
- `node_modules` और `package-lock.json` हटाएं, फिर `npm install` चलाएं
- पोर्ट संघर्ष जांचें (डिफ़ॉल्ट: 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 मॉडल्स एक्सेस अनुमतियाँ जांचें
**पायथन चैट प्रोजेक्ट समस्याएँ**:
- OpenAI पैकेज स्थापित है : `pip install openai`
- सुनिश्चित करें कि GITHUB_TOKEN पर्यावरण चर सेट है
- GitHub मॉडल पहुँच अनुमतियाँ जांचें
**Docsify प्रलेखन सर्व नहीं कर रह ा**:
- docsify-cli ग्लोबली इंस्टॉल करें: `npm install -g docsify-cli`
- रिपॉजिटरी रूट डायरेक्टरी से चलाएं
**डॉक्सिफाई दस्तावेज़ सेवा नहीं करत ा**:
- docsify-cli ग्लोबली स्थापित करें: `npm install -g docsify-cli`
- रिपॉजिटरी रूट निर्देशिका से चलाएं
- जांचें कि `docs/_sidebar.md` मौजूद है
### विकास वात ावरण सुझाव
### विकास पर्य ावरण सुझाव
- HTML परियोजनाओं के लिए VS Code में Live Server एक्सटेंशन का उपयोग करें
- consistent फॉर्मेटिंग के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
- जावास्क्रिप्ट डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- HTML परियोजनाओं के लिए VS Code में लाइव सर्वर एक्सटेंशन का उपयोग करें
- सुसंगत फॉर्मेटिंग के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
### प्रदर्शन विचार
- अनुवादित बड़ी संख्या वाली फाइलें (50+ भाषाएँ) क्लोन को बड़ा बनाती हैं
- केवल सामग्री पर काम करते समय शैलो क्लोन का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते हुए अनुवादों को खोज से बाहर रख ें
- बिल्ड प्रक्रिया पहले रन पर धीमी हो सकती है (npm install, Vite build)
- अनुवादित फ़ाइलों की बड़ी संख्या (50+ भाषाएँ) के कारण पूर्ण क्लोन बड़े होते हैं
- केवल सामग्री पर काम करने के लिए शैलो क्लोन का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवाद खोजों से बाहर कर ें
- बिल्ड प्रक्रियाएँ पहली बार धीमी हो सकती हैं (npm install, Vite build)
## सुरक्षा विचार
### पर्यावरण परिवर्तनशील
### पर्यावरण चर
- API कुंजी कभी भंडार में प्रतिबद्ध न करें
- `.env` फाइलों का उपयोग करें (पहले से `.gitignore` में शामिल )
- परियोजना README में आवश्यक पर्यावरण चर दस्तावेज़ि त करें
- API कुंजी को कभी रिपॉजिटरी में कमिट न करें
- `.env` फ़ाइलें उपयोग करें (पहले से `.gitignore` में हैं )
- आवश्यक पर्यावरण चर परियोजना READMEs में दस्तावेजीकृ त करें
### Python परियोजनाएँ
### पायथन परियोजनाएँ
- वर्चुअल वातावरण का उपयोग करें: `python -m venv venv`
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- निर्भरताओं को अपडेट रखें
- GitHub टोकन न्यूनतम आवश्यक अनुमतियों के साथ होने चाहिए
- GitHub टोकन के पास न्यूनतम आवश्यक अनुमतियाँ होनी चाहिए
### GitHub मॉडल्स एक्सेस
- GitHub मॉडल्स के लिए व्यक्तिगत एक्सेस टोकन (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 )
- अतिरिक्त पाठ्यक्रम: Generative AI, Data Science, ML, IoT पाठ्यक्रम उपलब्ध
- [Microsoft Learn मॉड्यूल ](https://docs.microsoft.com/learn/ )
- [स्टूडेंट हब संसाधन ](https://docs.microsoft.com/learn/student-hub/ )
- शिक्षार्थियों के लिए अनुशंसित: [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot )
- अतिरिक्त पाठ्यक्रम: जनरेटिव एआई, डेटा साइंस, एमएल, आईओटी पाठ्यक्रम उपलब्ध
### विशिष्ट परियोजनाओं के साथ काम करना
### विशिष्ट परियोजनाओं के साथ कार्य करना
व्यक्तिगत परियोजनाओं के विस्तृत निर्देशों के लिए संबंधित 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` - एआई चैट सहायक परियोजना
- `6-space-game/README.md` - कैनवास-आधारित गेम डेवलपमेंट
- `9-chat-project/README.md` - एआई चैट असिस्टेंट प्रोजेक्ट
### मोनोरिपो संरचना
### मोनोरिपॉ संरचना
यह पारंपरिक मोनोरिपो नहीं है, लेकिन यह भंडार कई स्वतंत्र परियोजनाएँ शामिल करता है:
- प्रत्येक पाठ स्व-निहित है
- परियोजनाएँ निर्भरताएं साझा नहीं करती ं
- व्यक्तिगत परियोजनाओं पर काम करें बिना दूसरों को प्रभावित किए
- पूर्ण पाठ्यक्रम अनुभव के लिए पूरा रिपॉजिटरी क्लोन करें
हालांकि यह पारंपरिक मोनोरिपॉ नहीं है, इस रिपॉजिटरी में कई स्वतंत्र परियोजनाएँ हैं :
- प्रत्येक पाठ स्वतंत्र है
- परियोजनाएँ निर्भरताओं को साझा नहीं करती है ं
- अन्य परियोजनाओं को प्रभावित किए बिना व्यक्तिगत परियोजनाओं पर काम करें
- पूर्ण पाठ्यक्रम अनुभव के लिए पूरी रिपॉजिटरी क्लोन करें
---
<!-- CO - OP TRANSLATOR DISCLAIMER START -->
**अस्वीकरण **:
इस दस्तावेज़ का अनुवाद AI अनुवाद सेवा [Co-op Translator ](https://github.com/Azure/co-op-translator ) का उपयोग करके किया गया है। जबकि हम सटीकता के लिए प्रयास करते हैं, कृपया ध्यान रखें कि स्वचालित अनुवादों में गलतियाँ या अस्पष्टताए ँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में प्राधिकृत स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं।
**अस्वीकृति **:
यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator ](https://github.com/Azure/co-op-translator ) का उपयोग करके अनूदित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वचालित अनुवादों में त्रुटियाँ या गलतिया ँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में प्राधिकृत स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम उत्तरदायी नहीं हैं।
<!-- CO - OP TRANSLATOR DISCLAIMER END -->
localizeflow[bot]
3 months ago