diff --git a/translations/mr/.co-op-translator.json b/translations/mr/.co-op-translator.json index 400db2076..e9e7de025 100644 --- a/translations/mr/.co-op-translator.json +++ b/translations/mr/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:17:52+00:00", + "translation_date": "2026-02-06T12:43:06+00:00", "source_file": "AGENTS.md", "language_code": "mr" }, diff --git a/translations/mr/AGENTS.md b/translations/mr/AGENTS.md index 65df85ee4..595763da1 100644 --- a/translations/mr/AGENTS.md +++ b/translations/mr/AGENTS.md @@ -2,56 +2,56 @@ ## प्रकल्पाचा आढावा -हा नवीन लोकांना वेब विकासाच्या मूलतत्त्वांचे शिक्षण देण्यासाठी शैक्षणिक अभ्यासक्रम संचय आहे. हा अभ्यासक्रम Microsoft Cloud Advocates द्वारा विकसित केलेल्या सखोल १२ आठवड्यांच्या कोर्सचा भाग आहे, ज्यामध्ये JavaScript, CSS आणि HTML यांचा समावेश असलेल्या २४ हाताळणी-आधारित अधिवेशनांचा समावेश आहे. +हे सुरुवातीच्या लोकांसाठी वेब विकास मुलभूत तत्त्वे शिकवण्यासाठी शैक्षणिक अभ्यासक्रम संकलन आहे. हा अभ्यासक्रम Microsoft Cloud Advocates यांनी विकसित केलेला 12 आठवड्यांचा सखोल कोर्स आहे, ज्यात JavaScript, CSS आणि HTML यावर 24 व्यावहारिक धडे आहेत. ### मुख्य घटक -- **शैक्षणिक सामग्री**: प्रकल्प-आधारित मॉड्यूलमध्ये आयोजित २४ संरचित अधिवेशन -- **व्यावहारिक प्रकल्प**: टेरारियम, टायपिंग गेम, ब्राउझर एक्सटेंशन, स्पेस गेम, बँकिंग अॅप, कोड एडिटर, आणि AI चॅट सहाय्यक -- **परस्पर क्रियात्मक क्विझ**: ४८ क्विझ, प्रत्येकी ३ प्रश्नांसह (पूर्व/उत्तर अधिवेशन मूल्यमापन) -- **बहुभाषिक समर्थन**: GitHub Actions द्वारे ५०+ भाषांसाठी स्वयंचलित भाषांतर +- **शैक्षणिक सामग्री**: प्रकल्पाधारित विभागांमध्ये आयोजित 24 संरचित धडे +- **व्यावहारिक प्रकल्प**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, आणि AI Chat Assistant +- **परस्परसंवादी प्रश्नमंजुषा**: 48 प्रश्नमंजुषा, प्रत्येकात 3 प्रश्न (धड्यांपूर्वी/नंतर मूल्यांकनासाठी) +- **बहुभाषिक समर्थन**: GitHub Actions च्या माध्यमातून 50+ भाषांमध्ये स्वयंचलित अनुवाद - **तंत्रज्ञान**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रकल्पांसाठी) ### आर्किटेक्चर -- अधिवेशन-आधारित रचनेसह शैक्षणिक संचय -- प्रत्येक अधिवेशन फोल्डरमध्ये 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) +### Quiz App सेटअप (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # विकास सर्व्हर सुरू करा +npm run dev # विकास सर्व्हर चालू करा npm run build # उत्पादनासाठी बिल्ड करा npm run lint # ESLint चालवा ``` -### बँक प्रकल्प API (Node.js + Express) +### Bank प्रकल्प API (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # API सर्व्हर सुरु करा +npm start # API सर्व्हर सुरू करा npm run lint # ESLint चालवा -npm run format # Prettier वापरून स्वरूपित करा +npm run format # Prettier सह स्वरूपित करा ``` -### ब्राउझर एक्सटेंशन प्रकल्प +### Browser Extension प्रकल्प ```bash cd 5-browser-extension/solution @@ -59,15 +59,15 @@ npm install # ब्राउझर-विशिष्ट विस्तार लोड करण्याच्या सूचना पाळा ``` -### स्पेस गेम प्रकल्प +### Space Game प्रकल्प ```bash cd 6-space-game/solution npm install -# index.html ब्राउझरमध्ये उघडा किंवा Live Server वापरा +# ब्राउझरमध्ये index.html उघडा किंवा Live Server वापरा ``` -### चॅट प्रकल्प (Python बॅकएंड) +### Chat प्रकल्प (Python Backend) ```bash cd 9-chat-project/solution/backend/python @@ -76,207 +76,207 @@ pip install openai python api.py ``` -## विकास कार्यप्रणाली +## विकास कार्यप्रवाह -### सामग्री योगदानकर्त्यांसाठी +### सामग्री योगदान देणाऱ्यांसाठी -1. आपल्या GitHub खात्यात **संचय फोर्क करा** -2. **आपला फोर्क स्थानिक कॉपी करा** -3. **आपल्या बदलांसाठी नवीन शाखा तयार करा** -4. अधिवेशन सामग्री किंवा कोड उदाहरणांमध्ये बदल करा -5. संबंधित प्रकल्प फोल्डरमध्ये कोणतेही कोड बदल तपासा -6. योगदान मार्गदर्शक सूचनांनुसार पुल रिक्वेस्ट सबमिट करा +1. **तुमच्या GitHub खात्यावर रेपॉजिटरी Fork करा** +2. **तुमचा fork स्थानिक क्लोन करा** +3. **तुमच्या बदलांसाठी नवीन शाखा तयार करा** +4. धडा सामग्री किंवा कोड उदाहरणांमध्ये बदल करा +5. संबंधित प्रकल्प निर्देशिकांमध्ये कोड बदलांचे चाचणी करा +6. योगदान मार्गदर्शक सूचनांनुसार pull requests सादर करा ### शिकणाऱ्यांसाठी -1. संचय फोर्क किंवा क्लोन करा -2. अधिवेशन फोल्डरांमध्ये अनुक्रमे जा -3. प्रत्येक अधिवेशनासाठी README फाइल वाचा -4. पूर्व-अधिवेशन क्विझ https://ff-quizzes.netlify.app/web/ येथे पूर्ण करा -5. अधिवेशन फोल्डरमधील कोड उदाहरणांवर काम करा -6. असायनमेंट आणि आव्हाने पूर्ण करा -7. पश्च-अधिवेशन क्विझ द्या +1. रेपॉजिटरी fork किंवा clone करा +2. धडा निर्देशिकांमध्ये अनुक्रमे पुढे जा +3. प्रत्येक धड्याच्या README फाइल वाचा +4. https://ff-quizzes.netlify.app/web/ येथे धड्यापूर्वीचे प्रश्नमंजुषा पूर्ण करा +5. धडा फोल्डरमधील कोड उदाहरणांवर काम करा +6. असाइनमेंट्स आणि आव्हाने पूर्ण करा +7. धड्यानंतर प्रश्नमंजुषा द्या ### थेट विकास -- **दस्तऐवजीकरण**: रूट मध्ये `docsify serve` चालवा (पोर्ट 3000) -- **क्विझ अॅप**: quiz-app फोल्डरमध्ये `npm run dev` चालवा +- **दस्तऐवजीकरण**: मूळ फोल्डरमध्ये `docsify serve` चालवा (पोर्ट 3000) +- **Quiz App**: quiz-app निर्देशिकेत `npm run dev` चालवा - **प्रकल्प**: HTML प्रकल्पांसाठी VS Code Live Server विस्तार वापरा -- **API प्रकल्प**: संबंधित API फोल्डरमध्ये `npm start` चालवा +- **API प्रकल्प**: संबंधित API निर्देशिकांमध्ये `npm start` चालवा ## चाचणी सूचना -### क्विझ अॅप चाचणी +### Quiz App चाचणी ```bash cd quiz-app -npm run lint # कोड शैलीच्या समस्यांसाठी तपासा -npm run build # बिल्ड यशस्वी होतो का ते सत्यापित करा +npm run lint # कोड शैली संबंधित समस्या तपासा +npm run build # बिल्ड यशस्वी होते का त्याची पडताळणी करा ``` -### बँक API चाचणी +### Bank API चाचणी ```bash cd 7-bank-project/api -npm run lint # कोड शैली समस्या तपासा +npm run lint # कोड शैलीच्या समस्यांसाठी तपासा node server.js # त्रुटीशिवाय सर्व्हर सुरू होतो का ते तपासा ``` -### सामान्य चाचणी पद्धत +### सामान्य चाचणी दृष्टिकोन -- हा शैक्षणिक संचय संपूर्ण स्वयंचलित चाचण्यांसह नाही -- मॅन्युअल चाचणीवर लक्ष केंद्रित: - - कोड उदाहरणे त्रुटीशिवाय चालणे - - दस्तऐवजीकरणातील दुवे योग्यरित्या काम करणे - - प्रकल्पांची यशस्वी बिल्ड होणे - - उदाहरणे उत्तम पद्धतींनुसार असल्याची खात्री +- हा एक शैक्षणिक संच आहे ज्यात पूर्णपणे स्वयंचलित चाचण्या नाहीत +- मॅन्युअल चाचणी यावर लक्ष केंद्रित करते: + - कोड उदाहरणे त्रुटीशिवाय चालवली जातात + - दस्तऐवजीकरणातील दुवे योग्य प्रकारे कार्यान्वित होतात + - प्रकल्प यशस्वीपणे तयार होतात + - उदाहरणे सर्वोत्तम पद्धतींचे अनुसरण करतात -### सादर करण्यापूर्वी तपासणी +### प्री-सबमिशन तपासणी -- package.json असलेल्या फोल्डरमध्ये `npm run lint` चालवा -- मार्कडाउन दुवे वैध आहेत का तपासा +- package.json असलेल्या निर्देशिकांमध्ये `npm run lint` चालवा +- मार्कडाउन दुव्यांची चाचणी करा - ब्राउझर किंवा Node.js मध्ये कोड उदाहरणे तपासा -- भाषांतर संरचना योग्य आहे का तपासा +- अनुवाद योग्य रचना राखतो याची खात्री करा ## कोड शैली मार्गदर्शक ### JavaScript -- आधुनिक ES6+ वाक्यरचना वापरा -- प्रकल्पांमध्ये दिलेले मानक ESLint कॉन्फिगरेशन वापरा +- आधुनिक ES6+ सिंटॅक्स वापरा +- प्रकल्पांमध्ये दिलेले मानक ESLint कॉन्फिगरेशन अनुसरा - शैक्षणिक स्पष्टतेसाठी अर्थपूर्ण व्हेरिएबल आणि फंक्शन नावे वापरा -- शिकणाऱ्यांसाठी संकल्पना समजावणारे टिप्पण्या जोडा +- शिकणाऱ्यांसाठी संकल्पना स्पष्ट करणारे टिप्पण्या जोडा - जिथे कॉन्फिगर केले आहे तिथे Prettier वापरून फॉरमॅट करा ### HTML/CSS -- सांकेतिक HTML5 घटकांचा वापर करा -- प्रत्युत्तरात्मक डिझाइन तत्त्वे वापरा -- स्वच्छ वर्ग नामकरण परंपरा -- शिकणाऱ्यांसाठी CSS तंत्र समजावणाऱ्या टिप्पण्या +- Semantic HTML5 घटक वापरा +- प्रतिसादक्षम डिझाइन तत्त्वे +- स्पष्ट वर्ग नावे वापरा +- CSS तंत्र समजावणाऱ्या टिप्पण्यांसाठी ### Python - PEP 8 शैली मार्गदर्शक - स्पष्ट, शैक्षणिक कोड उदाहरणे -- वापरासाठी उपयुक्त असलेले टाइप हिंट्स +- शिकण्यास उपयुक्त असलेल्या ठिकाणी Type hints वापरा -### मार्कडाउन दस्तऐवजीकरण +### Markdown दस्तऐवजीकरण -- स्पष्ट शीर्षक यादी -- भाषा निर्दिष्ट असलेले कोड ब्लॉक्स +- स्पष्ट शीर्षक विहंगावलोकन +- भाषा निर्दिष्ट असलेल्या कोड ब्लॉक्स - अतिरिक्त संसाधनांसाठी दुवे -- `images/` फोल्डरमधील स्क्रीनशॉट आणि प्रतिमा -- प्रतिमांसाठी प्रवेशयोग्यतेसाठी Alt मजकूर +- `images/` निर्देशिकांमधील स्क्रीनशॉट्स आणि प्रतिमा +- प्रवेशयोग्यतेसाठी प्रतिमांसाठी Alt मजकूर -### फाइल संघटना +### फाइल संस्थापन -- अधिवेशन क्रमांकानुसार क्रमबद्ध (1-getting-started-lessons, 2-js-basics, इ.) -- प्रत्येक प्रकल्पाकडे `solution/` आणि बहुधा `start/` किंवा `your-work/` फोल्डर -- अधिवेशन-विशिष्ट `images/` फोल्डरमध्ये प्रतिमा संग्रहित -- भाषांतर `translations/{language-code}/` रचनेमध्ये +- धडे अनुक्रमे क्रमांकित (1-getting-started-lessons, 2-js-basics, इत्यादि) +- प्रत्येक प्रकल्पाकडे `solution/` आणि बऱ्याचदा `start/` किंवा `your-work/` निर्देशिका +- धड्यांसाठी विशिष्ट `images/` फोल्डर्समध्ये प्रतिमा साठविल्या जातात +- `translations/{language-code}/` रचनेत अनुवाद ## बिल्ड आणि वितरण -### क्विझ अॅप वितरण (Azure Static Web Apps) +### Quiz App वितरण (Azure Static Web Apps) -क्विझ-अॅप Azure Static Web Apps वितरणासाठी कॉन्फिगर केलेले आहे: +quiz-app Azure Static Web Apps वितरणासाठी कॉन्फिगर केलेले आहे: ```bash cd quiz-app -npm run build # dist/ फोल्डर तयार करतो -# मुख्य शाखेत push केल्यावर GitHub Actions workflow द्वारे तैनात करतो +npm run build # dist/ फोल्डर तयार करते +# मुख्य शाखेत पुश केल्यावर GitHub Actions वर्कफ्लोद्वारे तैनात करते ``` Azure Static Web Apps कॉन्फिगरेशन: - **अॅप स्थान**: `/quiz-app` - **आउटपुट स्थान**: `dist` -- **वर्कफ्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +- **कार्यप्रवाह**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### दस्तऐवज PDF निर्मिती ```bash npm install # docsify-to-pdf स्थापित करा -npm run convert # डॉक्समधून PDF तयार करा +npm run convert # docs मधून PDF तयार करा ``` ### Docsify दस्तऐवजीकरण ```bash -npm install -g docsify-cli # Docsify जागतिकरित्या इंस्टॉल करा +npm install -g docsify-cli # Docsify जगभर इंस्टॉल करा docsify serve # localhost:3000 वर सेवा द्या ``` -### प्रकल्प-विशिष्ट बिल्ड्स +### प्रकल्प-विशिष्ट बिल्ड -प्रत्येक प्रकल्प फोल्डरमध्ये स्वतःचा बिल्ड प्रक्रिया असू शकते: +प्रत्येक प्रकल्प निर्देशिकेचा स्वतःचा बिल्ड प्रक्रिया असू शकते: - Vue प्रकल्प: `npm run build` उत्पादन बंडल तयार करतो -- स्थिर प्रकल्प: बिल्ड स्टेप नाही, फाइल थेट सेवा करा +- स्थिर प्रकल्प: बिल्ड स्टेप नाही, थेट फायली सर्व्ह करा ## पुल विनंती मार्गदर्शक ### शीर्षक स्वरूप -बदलाच्या भागाचे स्पष्ट, वर्णनात्मक शीर्षक वापरा: -- `[Quiz-app] नवीन क्विझ अधिवेशन X साठी जोडा` -- `[Lesson-3] टेरारियम प्रकल्पातील टायपो दुरुस्त करा` -- `[Translation] अधिवेशन ५ साठी स्पॅनिश भाषांतर जोडा` -- `[Docs] सेटअप सूचना अद्यतनित करा` +बदलाच्या क्षेत्राचे स्पष्ट, वर्णनात्मक शीर्षके वापरा: +- `[Quiz-app] नवीन क्विझ जोडा धडा X साठी` +- `[Lesson-3] Terrarium प्रकल्पातील टायपो सुधारा` +- `[Translation] धडा 5 साठी स्पॅनिश अनुवाद जोडा` +- `[Docs] सेटअप सूचना अद्ययावत करा` -### आवश्यक तपासणी +### आवश्यक तपासण्या -PR सादर करण्यापूर्वी: +PR सादर करण्याआधी: 1. **कोड गुणवत्ता**: - - प्रभावित प्रकल्प फोल्डरमध्ये `npm run lint` चालवा - - सर्व लिंट त्रुटी व इशारे दुरुस्त करा + - बाधित प्रकल्प निर्देशिकांमध्ये `npm run lint` चालवा + - सर्व लिंटिंग त्रुटी आणि इशारे दुरुस्त करा 2. **बिल्ड पडताळणी**: - लागू असल्यास `npm run build` चालवा - - कोणत्याही बिल्ड त्रुटी नसल्याची खात्री करा + - कोणतीही बिल्ड त्रुटी नाही याची खात्री करा -3. **दुवा प्रमाणीकरण**: +3. **दुवा सत्यापन**: - सर्व मार्कडाउन दुवे तपासा - - प्रतिमा संदर्भ तपासा + - प्रतिमा संदर्भ कार्यरत आहेत का ते तपासा 4. **सामग्री पुनरावलोकन**: - - स्पेलिंग आणि व्याकरण तपासा - - कोड उदाहरणे योग्य व शैक्षणिक आहेत याची खात्री करा - - भाषांतर मूळ अर्थ टिकवते याची तपासणी करा + - स्पेलिंग आणि व्याकरणासाठी प्रूफरीड करा + - कोड उदाहरणे बरोबर आणि शैक्षणिक आहेत याची खात्री करा + - अनुवाद मूळ अर्थ राखतात याची तपासणी करा ### योगदान आवश्यकता -- Microsoft CLA ला सहमती द्या (पहिल्या PR वर स्वयंचलित तपासणी) -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) चे पालन करा -- सविस्तर मार्गदर्शकासाठी [CONTRIBUTING.md](./CONTRIBUTING.md) पहा -- लागू स्थानिक इश्यू क्रमांक PR वर्णनात द्या +- Microsoft CLA सह सहमती द्या (पहिल्या PR वर स्वयंचलित तपासणी) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)चे पालन करा +- तपशीलवार मार्गदर्शकासाठी [CONTRIBUTING.md](./CONTRIBUTING.md) पहा +- PR वर्णनात आवश्यक असल्यास त्रुटी क्रमांकांचा संदर्भ द्या ### पुनरावलोकन प्रक्रिया -- PR मध्ये देखभाल करणारे आणि समुदाय सदस्य पुनरावलोकन करतात -- शैक्षणिक स्पष्टताकडे प्राधान्य दिले जाते -- कोड उदाहरणे वर्तमान सर्वोत्तम पद्धतींनुसार पाहणी करावीत -- भाषांतर अचूकता आणि सांस्कृतिक योग्यतेसाठी तपासले जातात +- PR ची देखरेख करणारे आणि समुदायाद्वारे पुनरावलोकन केले जाते +- शैक्षणिक स्पष्टता हा प्राधान्याने लक्षात घेतला जातो +- कोड उदाहरणांनी सद्याच्या सर्वोत्तम पद्धतींचे अनुसरण करावे +- अनुवाद अचूकता आणि सांस्कृतिक सुसंगतीसाठी तपासले जातात -## भाषांतर प्रणाली +## अनुवाद प्रणाली -### स्वयंचलित भाषांतर +### स्वयंचलित अनुवाद -- GitHub Actions सह co-op-translator वर्कफ्लो वापरतो -- ५०+ भाषांमध्ये स्वयंचलित भाषांतर करतो -- मुख्य फोल्डरमधील स्रोत फाइल्स -- भाषांतर फाइल्स `translations/{language-code}/` फोल्डरमध्ये +- GitHub Actions सह co-op-translator कार्यप्रवाह वापरतो +- 50+ भाषांमध्ये स्वयंचलितपणे अनुवादित करतो +- मुख्य निर्देशिकांमध्ये स्रोत फाइल्स +- `translations/{language-code}/` निर्देशिकांमध्ये अनुवादित फाइल्स -### मॅन्युअल भाषांतर सुधारणा कशी करावी +### मॅन्युअल अनुवाद सुधारणा जोडणे 1. `translations/{language-code}/` मध्ये फाइल शोधा -2. संरचना टिकवून सुधारणा करा +2. रचना जपत सुधारणा करा 3. कोड उदाहरणे कार्यक्षम राहतील याची खात्री करा -4. स्थानिकृत क्विझ सामग्री तपासा +4. स्थानिकृत प्रश्नमंजुषा कोणतीही असल्यास त्याची चाचणी करा -### भाषांतर मेटाडेटा +### अनुवाद मेटाडेटा -भाषांतरित फाइल्समध्ये मेटाडेटा हेडर असतो: +अनुवादित फाइल्समध्ये मेटाडेटा हेडर असतो: ```markdown ``` -## डीबगिंग आणि समस्या निवारण +## त्रुटी निराकरण आणि समस्या सोडवणे ### सामान्य समस्या -**क्विझ अॅप सुरू होत नाही**: -- Node.js आवृत्ती तपासा (v14+ शिफारस केलेली) -- `node_modules` आणि `package-lock.json` हटवा, नंतर `npm install` चालवा -- पोर्ट संघर्ष तपासा (पूर्वनिर्धारित: Vite पोर्ट 5173 वापरतो) +**Quiz app सुरू होत नाही**: +- Node.js आवृत्ती तपासा (v14+ शिफारसीय) +- `node_modules` आणि `package-lock.json` हटवून पुन्हा `npm install` चालवा +- पोर्ट संघर्ष तपासा (डिफॉल्ट: Vite पोर्ट 5173 वापरतो) **API सर्व्हर सुरू होत नाही**: -- Node.js आवृत्ती किमान अटी तपासा (node >=10) +- Node.js आवृत्ती पूर्णपणे तपासा (node >=10) - पोर्ट आधीच वापरात आहे का तपासा -- सर्व अवलंबित्वे `npm install` द्वारे स्थापित आहेत का तपासा +- सर्व dependency `npm install` ने स्थापित आहेत का तपासा **ब्राउझर एक्सटेंशन लोड होत नाही**: -- manifest.json योग्यरित्या फॉरमॅट आहे का तपासा -- ब्राउझर कन्सोलमधील त्रुटी तपासा -- ब्राउझर-विशिष्ट एक्सटेंशन स्थापित सूचना पाळा +- manifest.json योग्य प्रकारे स्वरूपित आहे का तपासा +- ब्राउझर कन्सोलमध्ये त्रुटी तपासा +- ब्राउझर-विशिष्ट एक्सटेंशन स्थापनेच्या सूचनांचे पालन करा **Python चॅट प्रकल्प समस्या**: -- OpenAI पॅकेज स्थापित आहे का तपासा: `pip install openai` -- GITHUB_TOKEN पर्यावरणीय चल सेट आहे का तपासा +- OpenAI पॅकेज स्थापित करा: `pip install openai` +- GITHUB_TOKEN पर्यावरण व्हेरिएबल सेट आहे का तपासा - GitHub मॉडेल्स प्रवेश परवानग्या तपासा -**Docsify दस्तऐवज सेवा करत नाही**: -- docsify-cli जागतिकरित्या स्थापित करा: `npm install -g docsify-cli` -- संचय रूट फोल्डरमधून चालवा -- `docs/_sidebar.md` अस्तित्वात आहे का तपासा +**Docsify दस्तऐवज सेवा देत नाही**: +- docsify-cli ग्लोबली स्थापित करा: `npm install -g docsify-cli` +- रेपॉजिटरी मूळ निर्देशिकेतून चालवा +- `docs/_sidebar.md` अस्तित्वात आहे याची खात्री करा -### विकास पर्यावरण टीपा +### विकास पर्यावरण टिप्स - HTML प्रकल्पांसाठी VS Code Live Server विस्तार वापरा -- सुसंगत स्वरूपासाठी ESLint आणि Prettier विस्तार इन्स्टॉल करा -- JavaScript डीबगिंगसाठी ब्राउझर DevTools वापरा -- Vue प्रकल्पांसाठी Vue DevTools ब्राउझर विस्तार इन्स्टॉल करा +- एकसारखे स्वरूपन करण्यासाठी ESLint आणि Prettier विस्तार स्थापित करा +- JavaScript डिबगसाठी ब्राउझर DevTools वापरा +- Vue प्रकल्पांसाठी Vue DevTools ब्राउझर एक्सटेंशन स्थापित करा -### कार्यक्षमतेच्या बाबतीत विचार +### कार्यप्रदर्शन विचार -- भरपूर भाषांतर फाइल्स (५०+ भाषा) म्हणजे पूर्ण क्लोन मोठ्या प्रमाणात असतात +- अनुवादित फाइल्सची मोठी संख्या (50+ भाषा) असल्यामुळे पूर्ण क्लोन मोठे होतात - फक्त सामग्रीवर काम करत असल्यास shallow clone वापरा: `git clone --depth 1` -- इंग्रजी सामग्रीवर काम करताना भाषांतर शोधात वगळा -- प्रथम रनवर (npm install, Vite build) बिल्ड प्रक्रिया मंद असू शकते +- इंग्रजी सामग्रीवर काम करताना अनुवादना शोधांमधून वगळा +- प्रथम रनवर बिल्ड प्रक्रिया (npm install, Vite build) हळू असू शकते -## सुरक्षा बाबतीत विचार +## सुरक्षा विचार -### पर्यावरणीय चल +### पर्यावरण व्हेरिएबल्स -- API की कधीही संचयात कमिट करू नका -- `.env` फाइल्स वापरा (आधीच `.gitignore` मध्ये आहेत) -- प्रकल्पाच्या README मध्ये आवश्यक पर्यावरणीय चलं दस्तऐवजीकरण करा +- API कीज कधीही रेपॉजिटरीमध्ये कमिट करू नका +- `.env` फाइल्स वापरा (जी `.gitignore` मध्ये आहेत) +- प्रकल्प README मध्ये आवश्यक पर्यावरण व्हेरिएबल्स दस्तऐवजीकरण करा ### Python प्रकल्प -- वर्च्युअल पर्यावरणांचा वापर करा: `python -m venv venv` -- अवलंबित्वे अद्ययावत ठेवा -- GitHub टोकन्सना कमीत कमी आवश्यक परवानगी द्या +- आभासी वातावरण वापरा: `python -m venv venv` +- dependencies अद्ययावत ठेवा +- GitHub टोकन्स किमान आवश्यक परवानग्यांसह ठेवा ### GitHub मॉडेल्स प्रवेश -- GitHub मॉडेल्ससाठी वैयक्तिक प्रवेश टोकन्स (PAT) आवश्यक -- टोकन्स पर्यावरणीय चल म्हणून साठवा -- कधीही टोकन्स किंवा प्रमाणपत्रे कमिट करू नका +- GitHub मॉडेल्ससाठी वैयक्तिक प्रवेश टोकन्स (PAT) आवश्यक आहेत +- टोकन्स पर्यावरण व्हेरिएबल्स म्हणून संग्रहित करा +- कधीही टोकन्स किंवा प्रमाणीकरण माहिती कमिट करू नका -## अतिरिक्त नोंदी +## अतिरिक्त नोट्स ### लक्ष्य प्रेक्षक -- वेब विकासातील अगदी नवीन शिकणारे -- विद्यार्थी आणि स्वअध्ययन करणारे -- वर्गांत अभ्यासक्रम वापरणारे शिक्षक -- सामग्री प्रवेशयोग्य आणि हळुवार कौशल्य विकासासाठी डिझाइन केली आहे +- वेब विकासासाठी पूर्ण नवशिके लोक +- विद्यार्थी आणि स्व-अभ्यासक +- वर्गात अभ्यासक्रम वापरणारे शिक्षक +- सामग्री प्रवेशयोग्यता आणि हळूहळू कौशल्य वाढीवर लक्ष केंद्रित ### शैक्षणिक तत्त्वज्ञान -- प्रकल्प-आधारित शिक्षण पद्धत -- वारंवार ज्ञान तपासणी (क्विझेस) -- हाताळणी-आधारित कोडिंग सराव -- वास्तविक उदाहरणे वापरून अनुप्रयोग -- फ्रेमवर्कपूर्वी मूलतत्त्वांवर लक्ष केंद्रीत +- प्रकल्पाधारित शिक्षण पद्धत +- वारंवार ज्ञान तपासणी (प्रश्नमंजुषा) +- व्यावहारिक कोडिंग सराव +- वास्तविक जगातील अनुप्रयोग उदाहरणे +- फ्रेमवर्क आधी मुलभूत गोष्टींवर लक्ष केंद्रित -### संचय देखभाल +### संचयिका देखभाल -- शिकणाऱ्यां आणि योगदानकर्त्यांच्या सक्रिय समुदाय -- नियमित अवलंबित्वे आणि सामग्री अद्यतन -- इश्यू आणि चर्चा देखरेख -- भाषांतर अपडेट्स GitHub Actions द्वारा स्वयंचलित +- सक्रिय शिकणाऱ्यांचे आणि योगदान देणाऱ्यांचे समुदाय +- dependency आणि सामग्री नियमित अद्यतने +- व्यवस्थापकांकडून मुद्दे आणि चर्चा मॉनिटरिंग +- GitHub Actions द्वारे अनुवाद अपडेट स्वयंचलित ### संबंधित संसाधने - [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- शिकणाऱ्यांसाठी [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) शिफारसीत -- अतिरिक्त कोर्सेस: जनरेटिव्ह AI, डेटा सायन्स, ML, IoT अभ्यासक्रम उपलब्ध +- शिकणाऱ्यांसाठी [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) शिफारसीय +- अतिरिक्त कोर्सेस: Generative AI, Data Science, ML, IoT अभ्यासक्रम उपलब्ध -### विशिष्ट प्रकल्पांसह काम करणे +### विशिष्ट प्रकल्पांवर काम करताना -व्यक्तिगत प्रकल्पांसाठी तपशीलवार सूचना पहा: +वैयक्तिक प्रकल्पांसाठी तपशीलवार सूचना पाहण्यासाठी README फाइल्स पहा: - `quiz-app/README.md` - Vue 3 क्विझ अॅप्लिकेशन - `7-bank-project/README.md` - प्रमाणीकरणासह बँकिंग अॅप्लिकेशन - `5-browser-extension/README.md` - ब्राउझर एक्सटेंशन विकास - `6-space-game/README.md` - कॅनव्हास-आधारित गेम विकास -- `9-chat-project/README.md` - AI चॅट सहाय्यक प्रकल्प +- `9-chat-project/README.md` - AI चॅट सहायक प्रकल्प -### मोनोरिपो संरचना +### मोनोरपो संरचना -पारंपरिक मोनोरिपो नसले तरी, हा संच अनेक स्वतंत्र प्रकल्प समाविष्ट करतो: -- प्रत्येक अधिवेशन स्वतंत्र आहे -- प्रकल्पे अवलंबित्वे शेअर करत नाहीत -- एकत्र नोंदी न करता स्वतंत्र प्रकल्पांवर काम करा +हा पारंपारिक मोनोरपो नाही, परंतु हा संच अनेक स्वतंत्र प्रकल्पांचा समावेश करतो: +- प्रत्येक धडा स्वतंत्र आहे +- प्रकल्पांमध्ये dependency शेयर करत नाहीत +- अन्य प्रकल्पांवर परिणाम न करता व्यक्तिगत प्रकल्पांवर काम करा - पूर्ण अभ्यासक्रम अनुभवासाठी संपूर्ण संच क्लोन करा --- -**अस्वीकरण**: -हे दस्तऐवज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) चा वापर करून अनुवादित केलेले आहे. आम्ही अचूकतेसाठी प्रयत्न करतो, तरी कृपया लक्षात ठेवा की स्वयंचलित अनुवादांमध्ये त्रुटी किंवा चुकीच्या माहिती असू शकते. मूळ दस्तऐवज त्याच्या स्थानिक भाषेत अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी अनुवाद करण्याची शिफारस केली जाते. या अनुवादामुळे होणाऱ्या कोणत्याही गैरसमजुती किंवा चुकीच्या अर्थ लागण्याबद्दल आम्ही जबाबदार नाही. +**सर्वसाधारण सूचना**: +हा दस्तावेज AI भाषांतर सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपया लक्षात ठेवा की स्वयंचलित भाषांतरांमध्ये चुका किंवा अपूर्णता असू शकते. मूळ दस्तावेज त्याच्या मूळ भाषेत अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी व्यावसायिक मानवी भाषांतर करण्याची शिफारस केली जाते. या भाषांतराच्या वापरामुळे उद्भवणाऱ्या कोणत्याही गैरसमज अथवा चुकीच्या अर्थ लागण्याची जबाबदारी आम्ही स्वीकारत नाही. \ No newline at end of file diff --git a/translations/ne/.co-op-translator.json b/translations/ne/.co-op-translator.json index 53dca9dfe..87246200a 100644 --- a/translations/ne/.co-op-translator.json +++ b/translations/ne/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:19:06+00:00", + "translation_date": "2026-02-06T12:44:19+00:00", "source_file": "AGENTS.md", "language_code": "ne" }, diff --git a/translations/ne/AGENTS.md b/translations/ne/AGENTS.md index 14cff1cf1..b0bd9aea8 100644 --- a/translations/ne/AGENTS.md +++ b/translations/ne/AGENTS.md @@ -2,29 +2,29 @@ ## परियोजना अवलोकन -यो शुरुवातकर्ताहरूलाई वेब विकासका आधारभूत कुरा सिकाउनका लागि शैक्षिक पाठ्यक्रम भण्डार हो। यो पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकास गरिएको १२ हप्ताको समग्र कोर्स हो, जसमा JavaScript, CSS, र HTML समेटिएका २४ व्यावहारिक पाठहरू समावेश छन्। +यो वेब विकासका आधारभूत कुरा सिकाउनका लागि बनाइएको शैक्षिक पाठ्यक्रम रिपोजिटरी हो। यो पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकास गरिएको एक विस्तृत १२ हप्ते कोर्स हो, जसमा JavaScript, CSS, र HTML समेटिएका २४ वटा व्यावहारिक सिकाइका पाठहरू छन्। -### मुख्य अवयवहरू +### मुख्य अंशहरू -- **शैक्षिक सामग्री**: परियोजना-आधारित मोड्युलहरूमा व्यवस्थित २४ संरचित पाठहरू -- **व्यावहारिक परियोजनाहरू**: टेरारियम, टाइपिंग गेम, ब्राउजर एक्सटेन्सन, स्पेस गेम, बैंकिङ एप, कोड सम्पादक, र AI च्याट सहायक -- **इन्टरएक्टिभ क्विजहरू**: प्रत्येकमा ३ प्रश्न सहित ४८ क्विजहरू (पाठ अघि/पछि मूल्यांकन) -- **बहुभाषिक समर्थन**: GitHub Actions मार्फत ५०+ भाषाहरूमा स्वचालित अनुवाद -- **प्रविधिहरू**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI परियोजनाहरूका लागि) +- **शैक्षिक सामग्री**: परियोजना-आधारित मोड्युलहरूमा विभाजित २४ संरचित पाठहरू +- **व्यावहारिक परियोजनाहरू**: टेरियम, टाइपिङ खेल, ब्राउजर एक्सटेन्सन, स्पेस खेल, बैंकिङ एप, कोड सम्पादक, र AI च्याट सहायक +- **इंटरएक्टिभ क्विजहरू**: प्रत्येकमा ३ प्रश्नहरू सहित ४८ क्विजहरू (पाठपुर्व/पाठपश्चात मूल्याङ्कन) +- **बहुभाषिक समर्थन**: GitHub Actions द्वारा ५०+ भाषाहरूको स्वचालित अनुवाद +- **प्रविधिहरू**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, 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 @@ -48,7 +48,7 @@ cd 7-bank-project/api npm install npm start # API सर्भर सुरु गर्नुहोस् npm run lint # ESLint चलाउनुहोस् -npm run format # Prettier सँग स्वरूप मिलाउनुहोस् +npm run format # Prettier सँग फर्म्याट गर्नुहोस् ``` ### ब्राउजर एक्सटेन्सन परियोजनाहरू @@ -56,10 +56,10 @@ npm run format # Prettier सँग स्वरूप मिलाउनु ```bash cd 5-browser-extension/solution npm install -# ब्राउजर-विशिष्ट एक्सटेन्सन लोडिङ निर्देशहरू पालन गर्नुहोस् +# ब्राउजर-विशिष्ट एक्सटेन्शन लोडिङ निर्देशनहरू पालना गर्नुहोस् ``` -### स्पेस गेम परियोजनाहरू +### स्पेस खेल परियोजनाहरू ```bash cd 6-space-game/solution @@ -80,29 +80,29 @@ python api.py ### सामग्री योगदानकर्ताहरूका लागि -1. आफ्नो GitHub खातामा भण्डारको **फोर्क गर्नुहोस्** -2. आफ्नो फोर्कलाई **स्थानीय रूपमा क्लोन गर्नुहोस्** -3. आफ्ना परिवर्तनहरूका लागि **नयाँ शाखा बनाउनुस्** +1. आफ्नो GitHub खातामा यो रिपोजिटरी Fork गर्नुहोस् +2. आफ्नो Fork लाई स्थानीय रूपमा Clone गर्नुहोस् +3. आफ्नो परिवर्तनहरूको लागि नयाँ शाखा सिर्जना गर्नुहोस् 4. पाठ सामग्री वा कोड उदाहरणहरूमा परिवर्तन गर्नुहोस् -5. सम्बन्धित परियोजना निर्देशिकाहरूमा कोड परिवर्तनहरू परीक्षण गर्नुहोस् -6. योगदान दिशानिर्देशहरू अनुसार पुल अनुरोधहरू पठाउनुहोस् +5. सम्बद्ध परियोजना डाइरेक्टरीहरूमा कोड परिवर्तनहरू परीक्षण गर्नुहोस् +6. योगदान दिशानिर्देशहरू अनुसार पुल अनुरोधहरू (pull requests) पठाउनुहोस् -### सिक्नेहरूका लागि +### सिक्नेहरूको लागि -1. भण्डार फोर्क वा क्लोन गर्नुहोस् -2. पाठ निर्देशिकाहरूलाई क्रमिक रूपमा जानुहोस् -3. प्रत्येक पाठका README फाइलहरू पढ्नुहोस् -4. https://ff-quizzes.netlify.app/web/ मा पूर्व-पाठ क्विजहरू पूरा गर्नुहोस् -5. पाठ फोल्डरहरूमा कोड उदाहरणहरूमा काम गर्नुहोस् +1. रिपोजिटरी Fork वा Clone गर्नुहोस् +2. क्रमबद्ध रूपमा पाठ फोल्डरहरूमा जानुहोस् +3. प्रत्येक पाठको README फाइलहरू पढ्नुहोस् +4. https://ff-quizzes.netlify.app/web/ मा पाठपुर्व क्विजहरू पूरा गर्नुहोस् +5. पाठ फोल्डरमा रहेका कोड उदाहरणहरूमा काम गर्नुहोस् 6. असाइनमेन्ट र चुनौतीहरू पूरा गर्नुहोस् -7. पोस्ट-पाठ क्विज लिनुहोस् +7. पाठपश्चात क्विजहरू लिनुहोस् ### प्रत्यक्ष विकास -- **दस्तावेजहरू**: रुटमा `docsify serve` चलाउनुहोस् (पोर्ट ३०००) -- **क्विज एप**: quiz-app निर्देशिकामा `npm run dev` चलाउनुहोस् -- **परियोजनाहरू**: HTML परियोजनाहरूका लागि VS Code Live Server एक्सटेन्सन प्रयोग गर्नुहोस् -- **API परियोजनाहरू**: सम्बन्धित API निर्देशिकामा `npm start` चलाउनुहोस् +- **डकुमेन्टेशन**: मूल फोल्डरमा `docsify serve` चलाउनुहोस् (पोर्ट ३०००) +- **क्विज एप**: quiz-app डाइरेक्टरीमा `npm run dev` चलाउनुहोस् +- **परियोजनाहरू**: HTML परियोजनाहरूको लागि VS Code Live Server एक्सटेन्सन प्रयोग गर्नुहोस् +- **API परियोजनाहरू**: सम्बन्धित API डाइरेक्टरीहरूमा `npm start` चलाउनुहोस् ## परीक्षण निर्देशनहरू @@ -110,173 +110,173 @@ 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 मा परीक्षण गर्नुहोस् -- अनुवादहरूले सही संरचना कायम राखेको जाँच गर्नुहोस् +- package.json भएका डाइरेक्टरीहरूमा `npm run lint` चलाउनुहोस् +- markdown लिंकहरूको वैधता सुनिश्चित गर्नुहोस् +- ब्राउजर वा Node.js मा कोड उदाहरणहरू परीक्षण गर्नुहोस् +- अनुवादहरूले उचित संरचना कायम राखेको छ कि छैन जाँच गर्नुहोस् -## कोड शैली निर्देशनहरू +## कोड शैली मार्गदर्शन ### JavaScript - आधुनिक ES6+ सिन्ट्याक्स प्रयोग गर्नुहोस् -- परियोजनाहरूमा उपलब्ध मानक ESLint कन्फिगरेसनहरू पालना गर्नुहोस् -- शैक्षिक स्पष्टताका लागि अर्थपूर्ण भेरिएबल र फंक्शन नामहरू प्रयोग गर्नुहोस् +- परियोजनामा दिइएका मानक ESLint कन्फिगरेसनहरू पालना गर्नुहोस् +- शैक्षिक स्पष्टताका लागि अर्थपूर्ण भेरिएबल र फङ्सन नामहरू प्रयोग गर्नुहोस् - सिक्नेहरूका लागि अवधारणाहरू व्याख्या गर्ने टिप्पणीहरू थप्नुहोस् -- जहाँ कन्फिगर गरिएको छ त्यहाँ Prettier द्वारा फर्म्याट गर्नुहोस् +- जहाँ कन्फिगर गरिएको छ त्यहाँ Prettier प्रयोग गरी फर्म्याट गर्नुहोस् ### HTML/CSS -- अर्थपूर्ण HTML5 तत्वहरू -- उत्तरदायी डिजाइन सिद्धान्तहरू -- स्पष्ट क्लास नामकरण -- CSS प्राविधिहरू व्याख्या गर्ने टिप्पणीहरू +- Semantic HTML5 एलिमेन्टहरू प्रयोग गर्नुहोस् +- प्रतिक्रियाशील डिजाइन सिद्धान्तहरू अपनाउनुहोस् +- स्पष्ट कक्षा नामकरण सम्मेलनहरू प्रयोग गर्नुहोस् +- CSS प्राविधिहरू सिक्नेहरूले बुझ्नेगरी टिप्पणीहरू राख्नुहोस् ### Python -- PEP 8 शैली निर्देशनहरू -- स्पष्ट, शैक्षिक कोड उदाहरणहरू -- सिकाइका लागि सहायता हुने ठाउँमा टाइप हिन्टहरू +- PEP 8 शैली मार्गदर्शनहरू पालना गर्नुहोस् +- स्पष्ट, शैक्षिक कोड उदाहरणहरू प्रस्तुत गर्नुहोस् +- सिकाइमा सहायता पुर्‍याउन टाइप संकेतहरू जहाँ आवश्यक हो प्रयोग गर्नुहोस् -### मार्कडाउन दस्तावेजीकरण +### Markdown डकुमेन्टेशन -- स्पष्ट शीर्षक पदानुक्रम -- भाषा निर्दिष्ट गरिएको कोड ब्लकहरू -- थप स्रोतहरूको लिङ्कहरू -- `images/` निर्देशिकामा स्क्रिनशट र छविहरू -- पहुँचपात्रताको लागि छविहरूको alt टेक्स्ट +- स्पष्ट शीर्षक संरचना +- भाषा विशिष्टता सहित कोड ब्लकहरू +- थप स्रोतहरूमा लिंकहरू +- `images/` फोल्डरहरूमा स्क्रीनशट र छविहरू +- पहुँचयोग्यता लागि तस्बिरहरूको लागि वैकल्पिक पाठ -### फाइल आयोजन +### फाइल संगठन -- पाठहरू क्रमशः नम्बर गरिएको (1-getting-started-lessons, 2-js-basics आदि) -- प्रत्येक परियोजनामा `solution/` र अक्सर `start/` वा `your-work/` निर्देशिकाहरू -- पाठ-विशिष्ट छवि फोल्डरहरूमा छविहरू +- पाठहरू क्रमसङ्ख्यामा (1-getting-started-lessons, 2-js-basics, आदि) +- प्रत्येक परियोजनामा `solution/` र प्रायः `start/` वा `your-work/` फोल्डरहरू +- पाठ-विशेष `images/` फोल्डरहरूमा तस्बिरहरू भण्डारण - अनुवादहरू `translations/{language-code}/` संरचनामा ## निर्माण र परिनियोजन ### क्विज एप परिनियोजन (Azure Static Web Apps) -क्विज एप Azure Static Web Apps परिनियोजनको लागि कन्फिगर गरिएको छ: +क्विज एप Azure Static Web Apps को लागि कन्फिगर गरिएको छ: ```bash cd quiz-app npm run build # dist/ फोल्डर सिर्जना गर्दछ -# मुख्यमा पुश गर्दा GitHub Actions workflow मार्फत परिनियोजन गर्दछ +# मुख्य शाखामा धकेल्दा GitHub Actions workflow मार्फत तैनाथ गर्दछ ``` Azure Static Web Apps कन्फिगरेसन: - **एप स्थान**: `/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 स्थापना गर्नुहोस् npm run convert # docs बाट PDF सिर्जना गर्नुहोस् ``` -### Docsify दस्तावेजीकरण +### Docsify डकुमेन्टेशन ```bash -npm install -g docsify-cli # Docsify लाई विश्वव्यापी रूपमा स्थापना गर्नुहोस् +npm install -g docsify-cli # Docsify लाई वैश्विक रूपमा स्थापना गर्नुहोस् docsify serve # localhost:3000 मा सेवा गर्नुहोस् ``` -### परियोजना-विशिष्ट निर्माणहरू +### परियोजना-विशिष्ट बिल्डहरू -प्रत्येक परियोजना निर्देशिकासँग आफ्नै निर्माण प्रक्रिया हुन सक्छ: -- Vue परियोजनाहरू: उत्पादन बन्डलहरू बनाउन `npm run build` -- स्थिर परियोजनाहरू: कुनै निर्माण चरण छैन, सिधै फाइलहरू सेवा गर्नुहोस् +प्रत्येक परियोजना डाइरेक्टरीसँग आफ्नै बिल्ड प्रक्रिया हुन सक्छ: +- Vue परियोजनाहरू: `npm run build` उत्पादन बन्डलहरू बनाउँछ +- सेटिक परियोजनाहरू: बिल्ड चरण हुँदैन, फाइलहरू सिधै सेवा गर्न -## पुल अनुरोध निर्देशनहरू +## पुल अनुरोध मार्गदर्शन ### शीर्षक ढाँचा -परिवर्तन क्षेत्र स्पष्ट गर्ने शीर्षकहरू प्रयोग गर्नुहोस्: -- `[Quiz-app] पाठ X का लागि नयाँ क्विज थप्नुहोस्` -- `[Lesson-3] टेरारियम परियोजनामा टाइपो सुधार` -- `[Translation] पाठ ५ को स्पेनिश अनुवाद थप्नुहोस्` -- `[Docs] सेटअप निर्देशनहरू अद्यावधिक गर्नुहोस्` +परिवर्तन क्षेत्र स्पष्ट जनाउने शीर्षकहरू प्रयोग गर्नुहोस्: +- `[Quiz-app] पाठ X को लागि नयाँ क्विज थप्नुहोस्` +- `[Lesson-3] टेरियम परियोजनामा टाइपो सुधार` +- `[Translation] पाठ 5 को लागि स्पेनी अनुवाद थप्नुहोस्` +- `[Docs] सेटअप निर्देशनहरू अपडेट गर्नुहोस्` ### आवश्यक जाँचहरू PR पठाउनु अघि: 1. **कोड गुणस्तर**: - - प्रभावित परियोजना निर्देशिकाहरूमा `npm run lint` चलाउनुहोस् - - सबै लिटिङ त्रुटि र चेतावनीहरू सुधार्नुहोस् + - प्रभावकारी परियोजना डाइरेक्टरीहरूमा `npm run lint` चलाउनुहोस् + - सबै लिन्टिंग त्रुटि र चेतावनीहरू सुधार्नुहोस् 2. **निर्माण प्रमाणीकरण**: - लागू भएमा `npm run build` चलाउनुहोस् - - कुनै निर्माण त्रुटि छैन भनेर सुनिश्चित गर्नुहोस् + - कुनै निर्माण त्रुटि छैन भन्ने सुनिश्चित गर्नुहोस् -3. **लिंक प्रमाणीकरण**: - - सबै मार्कडाउन लिंकहरूको परीक्षण गर्नुहोस् - - छवि सन्दर्भहरू सत्यापित गर्नुहोस् +3. **लिंक वैधता**: + - सबै markdown लिंकहरू परीक्षण गर्नुहोस् + - तस्बिर सन्दर्भहरू काम गर्छन् सुनिश्चित गर्नुहोस् 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 हरू मर्मतकर्ता र समुदाय द्वारा समीक्षा गरिन्छ -- शैक्षिक स्पष्टता प्राथमिकता हो -- कोड उदाहरणहरूले वर्तमान उत्तम अभ्यासहरू पालना गर्नुपर्छ -- अनुवादहरू सहीता र सांस्कृतिक उपयुक्तताका लागि समीक्षा गरिन्छ +- PR हरू मर्मतकर्ताहरू र समुदायद्वारा समीक्षा गरिन्छ +- शैक्षिक स्पष्टतालाई प्राथमिकता दिइन्छ +- कोड उदाहरणहरूले हालको उत्कृष्ट अभ्यासहरू पालना गर्नुपर्छ +- अनुवादहरू समीक्षा गरिन्छ सटीकता र सांस्कृतिक उपयुक्तताको लागि ## अनुवाद प्रणाली ### स्वचालित अनुवाद -- GitHub Actions को co-op-translator वर्कफ्लो प्रयोग गर्दछ -- ५०+ भाषामा स्वचालित अनुवाद गर्छ -- मुख्य निर्देशिकाहरूमा श्रोत फाइलहरू -- `translations/{language-code}/` निर्देशिकामा अनुवादित फाइलहरू +- GitHub Actions सँग co-op-translator कार्यप्रवाह प्रयोग गर्दछ +- ५०+ भाषाहरूमा स्वचालित अनुवाद +- मुख्य डाइरेक्टरीहरूमा स्रोत फाइलहरू +- अनुवादित फाइलहरू `translations/{language-code}/` मा -### म्यानुअल अनुवाद सुधारहरू थप्ने तरिका +### म्यानुअल अनुवाद सुधार थप्ने तरिका -1. `translations/{language-code}/` मा फाइल फेला पार्नुहोस् -2. संरचना कायम राख्दै सुधार गर्नुहोस् -3. कोड उदाहरणहरू कार्यशील राख्न सुनिश्चित गर्नुहोस् +1. `translations/{language-code}/` मा फाइल भेट्टाउनुहोस् +2. संरचना कायम राखेर सुधार गर्नुहोस् +3. कोड उदाहरणहरू कार्यशील रहोस् सुनिश्चित गर्नुहोस् 4. स्थानीयकृत क्विज सामग्री परीक्षण गर्नुहोस् ### अनुवाद मेटाडाटा -अ अनुवादित फाइलहरूमा मेटाडाटा हेडर समावेश छ: +अनुवादित फाइलहरूमा मेटाडाटा हैडर हुन्छ: ```markdown **अस्वीकरण**: -यस कागजातलाई AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरी अनुवाद गरिएको हो। हामी शुद्धताका लागि प्रयासरत छौं भने पनि, कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छन्। मूल कागजात यसको आफ्नै भाषामा नै अधिकारिक स्रोत मानिनु पर्छ। महत्वपूर्ण जानकारीको लागि व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न कुनै पनि गलतफहमी वा गलत व्याख्याका लागि हामी जिम्मेवार हुनेछैनौं। +यो दस्तावेज एआई अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरेर अनुवाद गरिएको हो। हामी शुद्धताका लागि प्रयासरत छौं, तर कृपया जानकार हुनुहोस् कि स्वचालित अनुवादमा त्रुटि वा अशुद्धता हुन सक्छ। मूल दस्तावेज यसको मातृ भाषामा नै अधिकारिक स्रोत मानिनु पर्छ। महत्वपूर्ण जानकारीको लागि पेशेवर मानिस अनुवादको सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलत बुझाइ वा गलत व्याख्याको लागि हामी जिम्मेवार छैनौं। \ No newline at end of file diff --git a/translations/pa/.co-op-translator.json b/translations/pa/.co-op-translator.json index 82792bb3b..b52879ce2 100644 --- a/translations/pa/.co-op-translator.json +++ b/translations/pa/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:20:34+00:00", + "translation_date": "2026-02-06T12:46:58+00:00", "source_file": "AGENTS.md", "language_code": "pa" }, diff --git a/translations/pa/AGENTS.md b/translations/pa/AGENTS.md index 35b41b5c0..be42ef599 100644 --- a/translations/pa/AGENTS.md +++ b/translations/pa/AGENTS.md @@ -1,37 +1,37 @@ # AGENTS.md -## Project Overview +## ਪ੍ਰੋਜੈਕਟ ਦਾ ਝਲਕ -ਇਹ ਬਿਗਿਨਰਜ਼ ਲਈ ਵੈੱਬ ਵਿਕਾਸ ਦੀਆਂ ਬੁਨਿਆਦਾਂ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਿਆਤਮਕ ਕਰੀਕੁਲਮ ਰੈਪੋਜ਼ਟਰੀ ਹੈ। ਕਰੀਕੁਲਮ ਮਾਇਕਰੋਸਾਫਟ ਕਲਾਉਡ ਐਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸਿਤ ਇੱਕ ਸਮਗ੍ਰ 12-ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS, ਅਤੇ HTML ਨੂੰ ਕਵਰ ਕਰਨ ਵਾਲੇ 24 ਹੈਂਡ-ਆਨ ਪਾਠ ਸ਼ਾਮਲ ਹਨ। +ਇਹ ਨਵੇਂ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਵੈੱਬ ਵਿਕਾਸ ਦੀਆਂ ਮੂਲ ਗੱਲਾਂ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸ਼ਿਖਿਆਮੂਲਕ ਕੋਰਸ ਰੀਪੋਜ਼ਟਰੀ ਹੈ। ਇਹ ਕੋਰਸ ਮਾਈਕ੍ਰੋਸੌਫਟ ਕਲਾਉਡ ਐਡਵੋਕੇਟਸ ਵਲੋਂ ਵਿਕਸਿਤ ਇੱਕ ਵਿਸ਼ਤ੍ਰਿਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿਚ 24 ਹੱਥ-ਵਰਗੇ ਪਾਠਾਂ ਹਨ ਜੋ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS ਅਤੇ HTML ਨੂੰ ਕਵਰ ਕਰਦੇ ਹਨ। -### Key Components +### ਮੁੱਖ ਘਟਕ -- **ਸਿੱਖਿਆਤਮਕ ਸਮੱਗਰੀ**: 24 ਸੰਰਚਿਤ ਪਾਠ ਪ੍ਰਾਜੈਕਟ-ਆਧਾਰਿਤ ਮੌਡਿਊਲਾਂ ਵਿੱਚ ਵੰਡੇ ਹੋਏ -- **ਵਿਆਵਹਾਰਿਕ ਪ੍ਰਾਜੈਕਟਸ**: ਟੈਰਾਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਨਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ ਏਆਈ ਚੈਟ ਸਹਾਇਕ -- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਪ੍ਰਸ਼ਨ (ਪ੍ਰੀ/ਪੋਸਟ-ਪਾਠ ਮੁਲਾਂਕਣ) -- **ਬਹੁ-ਭਾਸ਼ਾਈ ਸਹਾਇਤਾ**: GitHub ਐਕਸ਼ਨਜ਼ ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਲਈ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ -- **ਟੈਕਨੋਲੋਜੀਜ਼**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (ਏਆਈ ਪ੍ਰਾਜੈਕਟਸ ਲਈ) +- **ਸ਼ਿਖਿਆਮੂਲਕ ਸਮੱਗਰੀ**: 24 ਸੰਗਠਿਤ ਪਾਠ ਜੋ ਪ੍ਰੋਜੈਕਟ-ਅਧਾਰਿਤ ਮੋਡੀਊਲਾਂ ਵਿੱਚ ਵੰਡੇ ਗਏ ਹਨ +- **ਵੈਹਾਰਿਕ ਪ੍ਰੋਜੈਕਟ**: ਟੇਰਾਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ ਏਆਈ ਚੈਟ ਸਹਾਇਕ +- **ਇੰਟਰਐਕਟਿਵ ਕੁਇਜ਼**: 48 ਕੁਇਜ਼ ਹਰ ਇੱਕ ਵਿੱਚ 3 ਸਵਾਲ (ਪਹਿਲਾਂ/ਬਾਅਦ ਪਾਠ ਦੇ ਮੁਲਾਂਕਣ) +- **ਬਹੁ-ਭਾਸ਼ਾਈ ਸਹਾਇਤਾ**: GitHub ਐਕਸ਼ਨ ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਲਈ ਸਵੈ-ਚਾਲਿਤ ਅਨੁਵਾਦ +- **ਟੈਕਨੋਲੋਜੀਆਂ**: HTML, CSS, ਜਾਵਾਸਕ੍ਰਿਪਟ, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟ ਲਈ) -### Architecture +### ਢਾਂਚਾ -- ਪਾਠ-ਆਧਾਰਿਤ ਸੰਰਚਨਾ ਨਾਲ ਸਿੱਖਿਆਤਮਕ ਰੈਪੋਜ਼ਟਰੀ -- ਹਰੇਕ ਪਾਠ ਫੋਲਡਰ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਨਾਂ, ਅਤੇ ਹੱਲ ਹੋਂਦੇ ਹਨ -- ਅਲੱਗ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਸਵਤੰਤਰ ਪ੍ਰਾਜੈਕਟ (quiz-app, ਵੱਖ-ਵੱਖ ਪਾਠ ਪ੍ਰਾਜੈਕਟ) -- GitHub ਐਕਸ਼ਨਜ਼ ਦੀ ਵਰਤੋਂ ਨਾਲ ਅਨੁਵਾਦ ਪদ্ধਤੀ (co-op-translator) -- ਡਾਕਯੂਮੇਂਟੇਸ਼ਨ Docsify ਰਾਹੀਂ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ ਅਤੇ PDF ਰੂਪ ਵਿੱਚ ਉਪਲਬਧ +- ਪਾਠ-ਅਧਾਰਿਤ ਸ਼ਿਖਿਆਮੂਲਕ ਰੀਪੋਜ਼ਟਰੀ +- ਹਰ ਪਾਠ ਫੋਲਡਰ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਨਾਂ ਅਤੇ ਹੱਲ ਹੁੰਦੇ ਹਨ +- ਵੱਖ-ਵੱਖ ਡਿਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਖੁਦਮੁਖਤਿਆਰ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਵੱਖ-ਵੱਖ ਪਾਠ ਪ੍ਰੋਜੈਕਟ) +- GitHub ਐਕਸ਼ਨਸ ਦੇ ਜਰੀਏ ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ (co-op-translator) +- ਡੌਕਯੂਮੇਨਟੇਸ਼ਨ Docsify ਰਾਹੀਂ ਮੁਹੱਈਆ ਅਤੇ PDF ਰੂਪ ਵਿੱਚ ਉਪਲਬਧ -## Setup Commands +## ਸੈਟਅਪ ਕਮਾਂਡਜ਼ -ਇਹ ਰੈਪੋਜ਼ਟਰੀ ਮੁੱਖ ਤੌਰ 'ਤੇ ਸਿੱਖਣ ਵਾਲੀ ਸਮੱਗਰੀ ਲਈ ਹੈ। ਵਿਸ਼ੇਸ਼ ਪ੍ਰਾਜੈਕਟਸ ਲਈ ਕੰਮ ਕਰਨ ਲਈ: +ਇਹ ਰੀਪੋਜ਼ਟਰੀ ਮੁੱਖ ਤੌਰ ਤੇ ਸ਼ਿਖਿਆਮੂਲਕ ਸਮੱਗਰੀ ਖਪਤ ਲਈ ਹੈ। ਖ਼ਾਸ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਕੰਮ ਕਰਨ ਲਈ: -### Main Repository Setup +### ਮੁੱਖ ਰੀਪੋਜ਼ਟਰੀ ਸੈਟਅਪ ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Quiz App Setup (Vue 3 + Vite) +### ਕੁਇਜ਼ ਐਪ ਸੈਟਅਪ (Vue 3 + Vite) ```bash cd quiz-app @@ -41,7 +41,7 @@ npm run build # ਉਤਪਾਦਨ ਲਈ ਬਣਾਓ npm run lint # ESLint ਚਲਾਓ ``` -### Bank Project API (Node.js + Express) +### ਬੈਂਕ ਪ੍ਰੋਜੈਕਟ API (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,232 +51,232 @@ npm run lint # ESLint ਚਲਾਓ npm run format # Prettier ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ ``` -### Browser Extension Projects +### ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਪ੍ਰੋਜੈਕਟ ```bash cd 5-browser-extension/solution npm install -# ਬ੍ਰਾਊਜ਼ਰ-ਖਾਸ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਨਾ ਕਰੋ +# ਬਰਾਊਜ਼ਰ-ਖਾਸ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦਾ ਅਨੁਸਰਣ ਕਰੋ ``` -### Space Game Projects +### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ ```bash cd 6-space-game/solution npm install -# ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ index.html ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਕਰੋ +# index.html ਨੂੰ ਬ੍ਰਾਉਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ Live Server ਦਾ ਪ੍ਰਯੋਗ ਕਰੋ ``` -### Chat Project (Python Backend) +### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਐਂਡ) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ ਵਰ ਬਦਲੋ ਸੈੱਟ ਕਰੋ +# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਲਾਕ 변수 ਸੈੱਟ ਕਰੋ python api.py ``` -## Development Workflow +## ਵਿਕਾਸ ਕਾਰਜ ਪ੍ਰਣਾਲੀ -### For Content Contributors +### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਾਰਾਂ ਲਈ -1. **ਰੈਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ** ਆਪਣੇ GitHub ਖਾਤੇ ਵਿੱਚ -2. **ਆਪਣੇ ਫੋਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ** ਸਥਾਨਕ ਤੌਰ 'ਤੇ -3. **ਤਬਦੀਲੀਆਂ ਲਈ ਨਵੀਂ ਬ੍ਰਾਂਚ ਬਣਾਓ** -4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਨਾਂ ਵਿੱਚ ਤਬਦੀਲੀ ਕਰੋ -5. ਸੰਬੰਧਿਤ ਪ੍ਰਾਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਕੋਈ ਵੀ ਕੋਡ ਤਬਦੀਲੀਆਂ ਟੈਸਟ ਕਰੋ -6. ਯੋਗਦਾਨ ਦੇ ਨਿਯਮਾਂ ਅਨੁਸਾਰ ਪੁਲ ਰਿਕਵੇਸਟ ਸਬਮਿਟ ਕਰੋ +1. ਆਪਣੀ GitHub ਖਾਤੇ 'ਤੇ ਰੀਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ +2. ਆਪਣਾ ਫੋਰਕ ਲੋਕਲੀ ਕਲੋਨ ਕਰੋ +3. ਆਪਣੀਆਂ ਬਦਲਾਵਾਂ ਲਈ ਨਵਾਂ ਬ੍ਰਾਂਚ ਬਣਾਓ +4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਨਾਂ ਵਿੱਚ ਬਦਲਾਵ ਕਰੋਂ +5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ +6. ਯੋਗਦਾਨ ਦੀਆਂ ਰਾਹਨੁਮਾਈਆਂ ਅਨੁਸਾਰ ਪੁਲ ਰਿਕਵੈਸਟ ਪੇਸ਼ ਕਰੋ -### For Learners +### ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ -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. ਪੋਸਟ-ਪਾਠ ਕੁਇਜ਼ਜ਼ ਲਵੋ -### Live Development +### ਲਾਈਵ ਡਿਵੈਲਪਮੈਂਟ -- **ਡਾਕਯੂਮੇਂਟੇਸ਼ਨ**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000) -- **ਕਵਿਜ਼ ਐਪ**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ -- **ਪ੍ਰਾਜੈਕਟਸ**: HTML ਪ੍ਰਾਜੈਕਟਸ ਲਈ VS ਕੋਡ ਲਾਈਵ ਸਰਵਰ ਐਕਸਟੈਂਸ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰੋ -- **API ਪ੍ਰਾਜੈਕਟਸ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm start` ਚਲਾਓ +- **ਡੌਕਯੂਮੇਨਟੇਸ਼ਨ**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000) +- **ਕੁਇਜ਼ ਐਪ**: quiz-app ਡਿਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ +- **ਪ੍ਰੋਜੈਕਟਸ**: HTML ਪ੍ਰੋਜੈਕਟ ਲਈ VS ਕੋਡ ਲਾਈਵ ਸਰਵਰ ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ +- **API ਪ੍ਰੋਜੈਕਟਸ**: ਸੰਬੰਧਿਤ API ਡਿਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm start` ਚਲਾਓ -## Testing Instructions +## ਟੈਸਟਿੰਗ ਦੇ ਨਿਰਦੇਸ਼ -### Quiz App Testing +### ਕੁਇਜ਼ ਐਪ ਟੈਸਟਿੰਗ ```bash cd quiz-app -npm run lint # ਕੋਡ ਸਟਾਈਲ ਮਸਲਿਆਂ ਦੀ ਜਾਂਚ ਕਰੋ -npm run build # ਬਣਤਰ ਸਫਲ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ +npm run lint # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਲਈ ਚੈੱਕ ਕਰੋ +npm run build # ਚੈੱਕ ਕਰੋ ਕਿ ਬਿਲਡ ਸਫਲ ਹੋ ਜਾਵੇ ``` -### Bank API Testing +### ਬੈਂਕ API ਟੈਸਟਿੰਗ ```bash cd 7-bank-project/api -npm run lint # ਕੋਡ ਸਟਾਈਲ ਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਚੈਕ ਕਰੋ -node server.js # ਸਰਵਰ ਦੀ ਬਿਨਾਂ ਗਲਤੀਆਂ ਸ਼ੁਰੂਆਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ +npm run lint # ਕੋਡ ਸਟਾਈਲ ਮੁੱਦਿਆਂ ਦੀ ਜਾਂਚ ਕਰੋ +node server.js # ਯਕੀਨ ਕਰੋ ਕਿ ਸਰਵਰ ਬਿਨਾਂ ਕਿਸੇ ਗਲਤੀ ਦੇ ਚਲਦਾ ਹੈ ``` -### General Testing Approach +### ਆਮ ਟੈਸਟਿੰਗ ਦ੍ਰਿਸ਼ਟੀਕੋਣ -- ਇਹ ਸਿੱਖਿਆਤਮਕ ਰੈਪੋਜ਼ਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੇਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ -- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ ਫੋਕਸ: - - ਕੋਡ ਉਦਾਹਰਨ ਬਿਨਾਂ ਗਲਤੀ ਚੱਲਣ - - ਡਾਕਯੂਮੈਂਟੇਸ਼ਨ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਨ - - ਪ੍ਰਾਜੈਕਟ ਦੀ ਸਫਲ ਬਣਾਵਟ - - ਉਦਾਹਰਨਾਂ ਵਧੀਆ ਅਮਲਾਂ ਦੇ ਅਨੁਸਾਰ ਹੋਣ +- ਇਹ ਸਿੱਖਿਆਮੂਲਕ ਰੀਪੋਜ਼ਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਵਿਸਤ੍ਰਿਤ ਸਵੈਚਾਲਿਤ ਟੈਸਟ ਸ਼ਾਮਲ ਨਹੀਂ ਹਨ +- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ ਤ੍ਰਿਫੋਕਸ ਉੱਤੇ ਕੇਂਦਰਿਤ ਹੈ: + - ਕੋਡ ਉਦਾਹਰਨਾਂ ਗਲਤੀ ਰਹਿਤ ਚੱਲਦੇ ਹਨ + - ਦਸਤਾਵੇਜ਼ਿਕਰਨ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ + - ਪ੍ਰੋਜੈਕਟ ਸਫਲਤਾਪੂਰਵਕ ਬਣਦੇ ਹਨ + - ਉਦਾਹਰਨਾਂ ਵਧੀਆ ਅਮਲ ਦੀ ਪਾਲਣਾ ਕਰਦੀਆਂ ਹਨ -### Pre-submission Checks +### ਪਹਿਲਾਂ-ਸਬਮਿਸ਼ਨ ਚੈੱਕ -- ਜਿੱਥੇ package.json ਹੈ, ਉਥੇ `npm run lint` ਚਲਾਓ -- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸਹੀਤਾ ਜਾਂਚੋ -- ਕੋਡ ਉਦਾਹਰਨ ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ -- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਨੁਵਾਦ ਸਹੀ ਸੰਰਚਨਾ ਰੱਖਦੇ ਹਨ +- ਪੈਕੇਜ.json ਵਾਲੀਆਂ ਡਿ੍ਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ +- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸਮੀਖਿਆ ਕਰੋ +- ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਨਾਂ ਦੀ ਜਾਂਚ ਕਰੋ +- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਨੁਵਾਦ ਸਥਿਰ ਢਾਂਚਾ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹਨ -## Code Style Guidelines +## ਕੋਡ ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ -### JavaScript +### ਜਾਵਾਸਕ੍ਰਿਪਟ -- ਆਧੁਨਿਕ ES6+ ਸੰਟੈਕਸ ਦੀ ਵਰਤੋਂ ਕਰੋ -- ਪ੍ਰਾਜੈਕਟਸ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਸੈਟਿੰਗਜ਼ ਫਾਲੋ ਕਰੋ -- ਸਿੱਖਿਆ ਲਈ ਸਮਝਣਯੋਗ ਵੇਰੀਏਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋ -- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਾਤਮਕ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਲ ਕਰੋ -- ਜਿੱਥੇ ਸੰਰਚਿਤ, Prettier ਵਰਤ ਕੇ ਕੋਡ ਫਾਰਮੈਟ ਕਰੋ +- ਆਧੁਨਿਕ ES6+ ਸਿੰਟੈਕਸ ਦੀ ਵਰਤੋਂ ਕਰੋ +- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਨੀਤੀਆਂ ਦੀ ਪਾਲਣਾ ਕਰੋ +- ਸਿੱਖਣ ਲਈ ਅਰਥਪੂਰਨ ਵੈਰੀਏਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਰੱਖੋ +- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਕੌਂਸੈਪਟ ਸਮਝਾਉਂਦੇ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਲ ਕਰੋ +- ਜਿੱਥੇ ਸੁਵਿਧਾਜਨਕ ਹੋ, Prettier ਨਾਲ ਫਾਰਮੇਟਿੰਗ ਕਰੋ ### HTML/CSS -- ਸੈਮਾਂਟੀਕ HTML5 ਤੱਤ -- ਪ੍ਰਤਿਕ੍ਰਿਆਸ਼ੀਲ ਡਿਜ਼ਾਈਨ ਮੁਢਲੀ ਵਿਧੀ -- ਸਾਫ ਸਪਸ਼ਟ CSS ਕਲਾਸ ਨਾਮਕਰਨ -- CSS ਤਕਨੀਕਾਂ ਲਈ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ +- ਸੰਵੇਦਨਸ਼ੀਲ HTML5 ਤੱਤਾਂ ਦੀ ਵਰਤੋਂ +- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਈਨ ਦੀ ਪਾਲਣਾ +- ਸਾਫ਼ ਸਪਸ਼ਟ ਕਲਾਸ ਨਾਂਮਕਰਨ ਪ੍ਰਣਾਲੀ +- CSS ਤਕਨੀਕਾਂ ਬਾਰੇ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ ### Python -- PEP 8 ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ -- ਸਪਸ਼ਟ, ਸਿੱਖਿਆਤਮਕ ਕੋਡ ਉਦਾਹਰਨ -- ਜਿੱਥੇ ਸਹਾਇਕ, ਟਾਈਪ ਹਿੰਟਸ +- PEP 8 ਦੇ ਸਟਾਈਲ ਹਦਾਇਤਾਂ +- ਸਾਫ਼, ਸਿੱਖਿਆਮੂਲਕ ਕੋਡ ਉਦਾਹਰਨ +- ਸਿੱਖਣ ਲਈ ਜਿੱਥੇ ਲੋੜ ਹੋਵੇ ਟਾਈਪ ਹਿੰਟਸ -### Markdown Documentation +### ਮਾਰਕਡਾਊਨ ਡੌਕਯੂਮੇਨਟੇਸ਼ਨ -- ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ -- ਭਾਸ਼ਾ-specification ਵਾਲੇ ਕੋਡ ਬਲਾਕ -- ਵਧੀਕ ਸਾਂਧਰਭ ਲਈ ਲਿੰਕ -- `images/` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ -- ਪਹੁੰਚਯੋਗਤਾ ਲਈ ਚਿੱਤਰਾਂ ਦਾ Alt ਟੈਕਸਟ +- ਸਪਸ਼ਟ ਸਿਰਲੇਖ ਧਾਂਚਾ +- ਭਾਸ਼ਾ ਵਿਸ਼ੇਸ਼ਤਾਕਰਨ ਸਹਿਤ ਕੋਡ ਬਲਾਕ +- ਅਤਿਰਿਕਤ ਸਰੋਤਾਂ ਲਈ ਲਿੰਕ +- ਸਕਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ `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 ਡਿਪਲੌਇਮੈਂਟ ਲਈ ਸੰਰਚਿਤ ਹੈ: ```bash cd quiz-app npm run build # dist/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ -# ਮukh push ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੋਏ ਕਰਦਾ ਹੈ +# ਮੁੱਖ ਵਿੱਚ push ਕਰਨ 'ਤੇ GitHub Actions ਵਰਕਫ਼ਲੋ ਰਾਹੀਂ ਤੈਨਾਤ ਕਰਦਾ ਹੈ ``` -ਅਜੂਰ ਸਟੈਟਿਕ ਵੈੱਬ ਐਪਸ ਕਨਫਿਗਰੇਸ਼ਨ: -- **ਐਪ locatie**: `/quiz-app` -- **ਆਉਟਪੁੱਟ locatie**: `dist` -- **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Azure Static Web Apps ਸੰਰਚਨਾ: +- **ਐਪ ਦਾ ਸਥਾਨ**: `/quiz-app` +- **ਆਉਟਪੁੱਟ ਸਥਾਨ**: `dist` +- **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Documentation PDF Generation +### ਡੌਕਯੂਮੇਨਟੇਸ਼ਨ PDF ਜਨਰੇਸ਼ਨ ```bash -npm install # docsify-to-pdf ਸਥਾਪਤ ਕਰੋ -npm run convert # docs ਤੋਂ PDF ਬਣਾਓ +npm install # docsify-to-pdf ਇੰਸਟਾਲ ਕਰੋ +npm run convert # ਡੌਕ ਤੋਂ PDF ਬਣਾਓ ``` -### Docsify Documentation +### Docsify ਡੌਕਯੂਮੇਨਟੇਸ਼ਨ ```bash -npm install -g docsify-cli # ਡੌਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ -docsify serve # ਲੋਕਲਹੋਸਟ:3000 ‘ਤੇ ਸਰਵ ਕਰੋ +npm install -g docsify-cli # ਡੋਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ +docsify serve # localhost:3000 'ਤੇ ਸਰਵ ਕਰੋ ``` -### Project-specific Builds +### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡਜ਼ -ਹਰ ਇੱਕ ਪ੍ਰਾਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ: -- Vue ਪ੍ਰਾਜੈਕਟ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ -- ਸਟੈਟਿਕ ਪ੍ਰਾਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਸਟੈਪ ਨਹੀਂ, ਸਿੱਧੇ ਫਾਈਲਾਂ ਸਰਵ ਕਰਨ +ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਿਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ: +- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ +- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਸਟੀਪ ਨਹੀਂ, ਫਾਇਲਾਂ ਸਿੱਧਾ ਸਰਵ ਕੀਤਾ ਜਾਂਦਾ ਹੈ -## Pull Request Guidelines +## ਪੁਲ ਰਿਕਵੈਸਟ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ -### Title Format +### ਸਿਰਲੇਖ ਫਾਰਮੈਟ -ਸਪਸ਼ਟ ਅਤੇ ਵੇਰਵਾ ਵਾਲੇ ਸਿਰਲੇਖ ਵਰਤੋਂ ਜੋ ਬਦਲਾਅ ਅੰਤਰਗਤ ਖੇਤਰ ਦਰਸਾਉਂਦੇ ਹਨ: -- `[Quiz-app] ਲੈਸਨ X ਲਈ ਨਵਾਂ ਕਵਿਜ਼ ਸ਼ਾਮਲ ਕਰੋ` -- `[Lesson-3] ਟੈਰਾਰਿਯਮ ਪ੍ਰਾਜੈਕਟ ਵਿੱਚ ਟਾਇਪੋ ਠੀਕ ਕਰੋ` -- `[Translation] ਲੈਸਨ 5 ਲਈ ਸਪੈਨਿਸ਼ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰੋ` -- `[Docs] ਸੈਟਅੱਪ ਨਿਰਦੇਸ਼ ਅੱਪਡੇਟ ਕਰੋ` +ਸਪਸ਼ਟ, ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਵਰਤੋ ਜੋ ਬਦਲਾਵ ਦੇ ਖੇਤਰ ਨੂੰ ਦਰਸਾਉਂਦੇ ਹਨ: +- `[Quiz-app] ਪਾਠ X ਲਈ ਨਵਾਂ ਕੁਇਜ਼ ਜੋੜੋ` +- `[Lesson-3] ਟੇਰਾਰਿਯਮ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਟਾਈਪੋ ਠੀਕ ਕਰੋ` +- `[Translation] ਪਾਠ 5 ਲਈ ਸਪੇਨੀ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰੋ` +- `[Docs] ਸੈਟਅਪ ਨਿਰਦੇਸ਼ ਅੱਪਡੇਟ ਕਰੋ` -### Required Checks +### ਜਰੂਰੀ ਜਾਂਚਾਂ -ਪੂਲ ਰਿਕਵੇਸਟ ਵਿੱਚ ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ: +PR ਪੇਸ਼ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ: -1. **ਕੋਡ ਕੁਆਲਿਟੀ**: - - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰਾਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run lint` ਚਲਾਓ - - ਸਾਰੇ ਲਿੰਟਿੰਗ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀਆਂ ਠੀਕ ਕਰੋ +1. **ਕੋਡ ਗੁਣਵੱਤਾ**: + - ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਿਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ + - ਸਾਰੇ ਲਿੰਟਿੰਗ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀਆਂ ਫਿਕਸ ਕਰੋ -2. **ਬਿਲਡ ਵੈਰੀਫਿਕੇਸ਼ਨ**: - - ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ - - ਕੋਈ ਬਿਲਡ ਗਲਤੀਆਂ ਨਾ ਹੋਣ +2. **ਬਿਲਡ ਚੈਕ**: + - ਜੇ ਲਾਗੂ ਹੁੰਦਾ ਹੈ ਤਾਂ `npm run build` ਚਲਾਓ + - ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਾ ਹੋਵੇ -3. **ਲਿੰਕ ਵੈਰੀਫਿਕੇਸ਼ਨ**: - - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ - - ਚਿੱਤਰ ਸੰਦਰਭ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ ਇਸ ਦੀ ਜਾਂਚ ਕਰੋ +3. **ਲਿੰਕ ਪੁਸ਼ਟੀਕਰਨ**: + - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ + - ਚਿੱਤਰ ਸੰਬੰਧ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ -4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**: - - ਸਪੈਲਿੰਗ ਅਤੇ ਗ੍ਰੈਮਰ ਦੀ ਜਾਂਚ ਕਰੋ - - ਕੋਡ ਉਦਾਹਰਨ ਸਹੀ ਅਤੇ ਸਿੱਖਣ ਯੋਗ ਹੋਣ - - ਅਨੁਵਾਦ ਮੁਢਲਾ ਅਰਥ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹੋਣ +4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**: + - ਸਪੀਲਿੰਗ ਅਤੇ ਗ੍ਰੈਮਰ ਦੀ ਜਾਂਚ ਕਰੋ + - ਕੋਡ ਉਦਾਹਰਨਾਂ ਸਹੀ ਅਤੇ ਸਿੱਖਿਆਮੂਲਕ ਹਨ + - ਅਨੁਵਾਦ ਮੂਲ ਅਰਥ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹਨ -### Contribution Requirements +### ਯੋਗਦਾਨ ਲਾਉਣ ਦੇ ਨਿਯਮ -- Microsoft CLA ਨਾਲ ਸਹਿਮਤ ਹੋਵੋ (ਪਹਿਲੀ PR 'ਤੇ ਆਟੋਮੈਟਿਕ ਚੈਕ) -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ -- ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਦੇਖੋ -- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਸਮੱਸਿਆ ਨੰਬਰ ਦਰਜ ਕਰੋ +- Microsoft CLA ਦੇ ਕਰਾਰ ਕਰਨਾ (ਪਹਿਲੀ PR 'ਤੇ ਆਪਮਾਟਿਕ ਚੈੱਕ) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ +- ਤਫਸੀਲ ਵਾਲੇ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ +- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਇਸ਼ੂ ਨੰਬਰ ਬਾਰੇ ਜਾਣਕਾਰੀ ਦਿਓ -### Review Process +### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ -- PR ਦੀ ਸਮੀਖਿਆ ਮੇਨਟੇਨੇਰ ਅਤੇ ਕਮਿਊਨਿਟੀ ਕਰਦੀ ਹੈ -- ਸਿੱਖਿਆਤਮਕ ਸਪਸ਼ਟਤਾ ਨੂੰ ਤਰਜੀਹ -- ਕੋਡ ਉਦਾਹਰਨ ਅੱਜ ਦੀਆਂ ਵਧੀਆਂ ਪ੍ਰਣਾਲੀਆਂ ਨੂੰ ਮੰਨਣਗੇ -- ਅਨੁਵਾਦ ਸਹੀਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਯੋਗਤਾ ਲਈ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ +- PRs ਨੂੰ ਮੇਨੇਜਰ ਅਤੇ ਸਮੁਦਾਇ ਵੱਲੋਂ ਸਮੀਖਿਆ ਕਰਿਆ ਜਾਦਾ ਹੈ +- ਸਿੱਖਿਆਮੂਲਕ ਸਪਸ਼ਟਤਾ ਨੂੰ ਪਹਿਲ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ +- ਕੋਡ ਉਦਾਹਰਨਾਂ ਮੌਜੂਦਾ ਵਧੀਆ ਅਮਲ ਦੇ ਅਨੁਕੂਲ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ +- ਅਨੁਵਾਦਾਂ ਨੂੰ ਸੁਚੱਜੇ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਤੌਰ 'ਤੇ ਯੋਗਤਾ ਲਈ ਸਮੀਖਿਆ ਕੀਤਾ ਜਾਂਦਾ ਹੈ -## Translation System +## ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ -### Automated Translation +### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ -- GitHub ਐਕਸ਼ਨਜ਼ ਦੇ ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ -- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸਵਚਾਲਿਤ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ -- ਸੋਰਸ ਫਾਈਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ -- ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ `translations/{language-code}/` ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ +- GitHub ਐਕਸ਼ਨਸ ਦੇ ਨਾਲ 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 ``` -## Debugging and Troubleshooting +## ਡਿਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆ-ਹੱਲ -### Common Issues +### ਆਮ ਸਮੱਸਿਆਵਾਂ -**ਕਵਿਜ਼ ਐਪ ਸਟਾਰਟ ਨਹੀਂ ਹੁੰਦਾ**: -- Node.js ਦਾ ਵਰਜਨ ਚੈੱਕ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀਦਾ) -- `node_modules` ਅਤੇ `package-lock.json` ਡਿਲੀਟ ਕਰਕੇ `npm install` ਚਲਾਓ -- ਪੋਰਟ ਟਕਰਾਅ ਦੀ ਜਾਂਚ ਕਰੋ (ਡਿਫੌਲਟ: Vite ਪੋਰਟ 5173 ਵਰਤਦਾ ਹੈ) +**ਕੁਇਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**: +- Node.js ਵਰਜਨ ਦੀ ਜਾਂਚ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀ) +- `node_modules` ਅਤੇ `package-lock.json` ਮਿਟਾ ਕੇ `npm install` ਦੁਬਾਰਾ ਚਲਾਓ +- ਪੋਰਟ ਟਕਰਾਅ ਦੀ ਜਾਂਚ ਕਰੋ (ਡਿਫੌਲਟ: Vite ਜਨਾਨਾ 5173 ਪਰ ਵਰਤਦਾ ਹੈ) -**API ਸਰਵਰ ਸਟਾਰਟ ਨਹੀਂ ਹੁੰਦਾ**: -- Node.js ਵਰਜਨ (node >=10) ਯਕੀਨੀ ਬਣਾਓ -- ਪੋਰਟ ਪਹਿਲਾਂ ਤੋਂ ਵਰਤੀ ਜਾ ਰਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ -- ਸਾਰੇ ਨਿਰਭਰਤਾ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਏ ਹਨ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ +**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**: +- ਯਕੀਨ ਕਰੋ ਕਿ Node.js ਵਰਜਨ ਘੱਟੋ-ਘੱਟ ਹੈ (node >=10) +- ਜਾਂਚੋ ਕਿ ਪੋਰਟ ਪਹਿਲਾਂ ਵਰਤੋਂ ਵਿੱਚ ਨਾ ਹੋਵੇ +- ਸਾਰੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਕੀਤੇ ਗਏ ਹੋਣ -**ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਨਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**: -- manifest.json ਸਹੀ ਫਾਰਮੈਟ ਵਿੱਚ ਹੈ ਯਕੀਨ ਕਰੋ -- ਬ੍ਰਾਊਜ਼ਰ ਕੰਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਚੈੱਕ ਕਰੋ -- ਬ੍ਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ +**ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**: +- manifest.json ਨੂੰ ਠੀਕ ਫਾਰਮੈਟ ਵਿੱਚ ਹੈ ਕਿਵੇਂ ਦਿਖਾਓ +- ਬ੍ਰਾਊਜ਼ਰ ਕੰਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੇਖੋ +- ਬ੍ਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ -**ਪਾਇਥਨ ਚੈਟ ਪ੍ਰਾਜੈਕਟ ਦਿੱਕਤਾਂ**: -- OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai` -- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਭੈਰੀਅਬਲ ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ -- GitHub ਮਾਡਲਜ਼ ਦੀ ਐਕਸੇਸ ਅਧਿਕਾਰ ਜਾਂਚੋ +**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**: +- OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai` +- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ (env) ਸੈਟ ਹੈ ਜਾਂ ਨਹੀਂ ਸਹੀ ਚੈੱਕ ਕਰੋ +- 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 ਕੋਡ ਲਾਈਵ ਸਰਵਰ ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ -- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ ਤਾਕਿ ਕੋਡ ਫਾਰਮੈਟ ਸਥਿਰ ਰਹੇ -- ਜਾਵਾਸਕ੍ਰਿਪਟ ਡਿਬੱਗਿੰਗ ਲਈ ਬ੍ਰਾਊਜ਼ਰ ਡਿਵਟੂਲਜ਼ ਦੀ ਵਰਤੋਂ ਕਰੋ -- Vue ਪ੍ਰਾਜੈਕਟਸ ਲਈ Vue DevTools ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ +- HTML ਪ੍ਰੋਜੈਕਟ ਲਈ VS ਕੋਡ ਨਾਲ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ +- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ ਸਥਿਰ ਫਾਰਮੇਟਿੰਗ ਲਈ +- JavaScript ਨੂੰ ਡਿਬੱਗ ਕਰਨ ਲਈ ਬ੍ਰਾਊਜ਼ਰ ਡਿਵਟੂਲਜ਼ ਵਰਤੋਂ +- Vue ਪ੍ਰੋਜੈਕਟ ਲਈ Vue DevTools ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ -### Performance Considerations +### ਕਾਰਗੁਜ਼ਾਰੀ ਦੀਆਂ ਗੱਲਾਂ -- ਬਹੁਤ ਸਾਰੀਆਂ ਅਨੁਵਾਦੀਤ ਫਾਈਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਸੰਪੂਰਨ ਕਲੋਨ ਵੱਡਾ ਹੁੰਦਾ ਹੈ -- ਸਿਰਫ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰਨ ਲਈ shallow clone ਵਰਤੋ: `git clone --depth 1` -- ਅੰਗ੍ਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ -- ਪਹਿਲੀ ਵਾਰ ਚੱਲਾਉਂਦੇ ਸਮੇਂ npm install ਅਤੇ Vite build ਥੋੜ੍ਹਾ ਹੌਲੀ ਹੋ ਸਕਦੇ ਹਨ +- ਵੱਡੀ ਸੰਖਿਆ ਵਿੱਚ ਅਨੁਵਾਦਤ ਫਾਈਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਮਤਲਬ ਪੂਰੇ ਕਲੋਨ ਵੱਡੇ ਹਨ +- ਕੇਵਲ ਸਮੱਗਰੀ ਲਈ ਕੰਮ ਕਰਦੇ ਹੋ ਤਾਂ ਥੱਲਾ ਕਲੋਨ ਵਰਤੋਂ: `git clone --depth 1` +- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ ਉੱਤੇ ਕੰਮ ਕਰਦੇ ਹੋਏ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਵਿੱਚੋਂ ਬਾਹਰ ਰੱਖੋ +- ਪਹਿਲੇ ਚੱਲਣ 'ਤੇ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਲੰਮੀ ਹੋ ਸਕਦੀ ਹੈ (npm install, Vite build) -## Security Considerations +## ਸੁਰੱਖਿਆ ਦੇ ਨੁਕਤੇ -### Environment Variables +### ਵਾਤਾਵਰਣ ਚਰ (Env Variables) -- API keys ਕਦੇ ਵੀ ਰੈਪੋਜ਼ਟਰੀ 'ਚ ਕਮਿਟ ਨਾ ਕਰੋ -- `.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 ਮਾਡਲਜ਼ ਲਈ Personal Access Tokens (PAT) ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ -- ਟੋਕਨਜ਼ ਨੂੰ ਵਾਤਾਵਰਣ ਭੈਰੀਅਬਲ ਵਜੋਂ ਸਟੋਰ ਕਰੋ -- ਕਦੇ ਵੀ ਟੋਕਨ ਜਾਂ ਪਾਸਵਰਡ ਕਮਿਟ ਨਾ ਕਰੋ +- GitHub Models ਲਈ Personal Access Tokens (PAT) ਦੀ ਲੋੜ ਹੈ +- ਟੋਕਨ ਵਾਤਾਵਰਣ ਚਰ ਵਜੋਂ ਸੰਭਾਲ ਕੇ ਰੱਖੋ +- ਕਦੇ ਵੀ ਟੋਕਨ ਜਾਂ ਪ੍ਰਮਾਣਪੱਤਰ ਕਮਿੱਟ ਨਾ ਕਰੋ -## Additional Notes +## ਵਾਧੂ ਨੋਟਸ -### Target Audience +### ਟਾਰਗੇਟ ਦਰਸ਼ਕ -- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਬਿਲਕੁਲ ਨਵੇਂ -- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ -- ਕਲਾਸਰੂਮ ਵਿੱਚ ਕਰੀਕੁਲਮ ਵਰਤਣ ਵਾਲੇ ਅਧਿਆਪਕ -- ਸਿਹਤਮੰਦ ਪਹੁੰਚ ਅਤੇ ਧੀਰੇ-ਧੀਰੇ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਬਣਾਇਆ ਗਿਆ ਸਮੱਗਰੀ +- ਵੈੱਬ ਵਿਕਾਸ ਦੇ ਨਵੇਂ ਸਿੱਖਣ ਵਾਲੇ +- ਵਿਦਿਆਰਥੀ ਅਤੇ ਸੁਤੰਤਰ ਸਿੱਖਿਆਰਥੀ +- ਕਲਾਸਰੂਮ ਵਿੱਚ ਕੋਰਸ ਵਰਤੋਂ ਕਰ ਰਹੇ ਅਧਿਆਪਕ +- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਸਲਲਤਾ ਨਾਲ ਕਸੂਰ ਮਿਟਾਉਣ ਲਈ ਬਣਾਈ ਗਈ -### Educational Philosophy +### ਸ਼ਿਖਿਆਣੁ ਦਰਸ਼ਨ -- ਪ੍ਰਾਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣਾ -- ਨਿਯਮਤ ਗਿਆਨ ਸੰਭਾਲ (ਕਵਿਜ਼) -- ਹੈਂਡ-ਆਨ ਕੋਡਿੰਗ ਅਭਿਆਸ -- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦੇਸ਼ਾਂ ਦੇ ਉਦਾਹਰਨ -- ਫਰੇਮਵਰਕ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਗੱਲਾਂ ਉੱਤੇ ਧਿਆਨ +- ਪ੍ਰੋਜੈਕਟ-ਅਧਾਰਿਤ ਸਿੱਖਿਆ +- ਹਰ ਵੇਲੇ ਜਾਣਕਾਰੀ ਜ਼ਾਂਚ (ਕੁਇਜ਼) +- ਹੱਥ ਨਾਲ ਕੋਡਿੰਗ ਅਭਿਆਸ +- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦਾਹਰਨ +- ਫਰੇਮਵਰਕ ਤੋਂ ਪਹਿਲਾਂ ਮੂਲ ਗੱਲਾਂ ’ਤੇ ਧਿਆਨ -### Repository Maintenance +### ਰੀਪੋਜ਼ਟਰੀ ਰੱਖ-ਰਖਾਵ -- ਸਖਤ ਪਰਿਵਾਰ ਵਾਲੀ ਕਮਿਊਨਿਟੀ -- ਨਿਰਭਰਤਾ ਅਤੇ ਸਮੱਗਰੀ ਵਿੱਚ ਨਿਯਮਤ ਅੱਪਡੇਟ -- ਮੇਨਟੇਨੇਰਾਂ ਦੁਆਰਾ ਮੁੱਦੇ ਅਤੇ ਚਰਚਾਂ ਦੀ ਸੈਰ -- GitHub ਐਕਸ਼ਨਜ਼ ਦੁਆਰਾ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ ਅੱਪਡੇਟ +- ਸਿੱਖਣ ਅਤੇ ਯੋਗਦਾਨਕਾਰਾਂ ਦਾ ਸਮਰੱਥਕ ਸਮੁਦਾਇ +- ਕੀਤੀ ਗਈਆਂ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦੀ ਨਿਯਮਿਤ ਅੱਪਡੇਟ +- ਸਮੱਸਿਆਵਾਂ ਅਤੇ ਗੱਲ-ਬਾਤ ਮੈਨੇਜਰਾਂ ਦੁਆਰਾ ਨਜ਼ਰ ਰੱਖੀ ਜਾਂਦੀ ਹੈ +- ਅਨੁਵਾਦ ਅੱਪਡੇਟ GitHub ਐਕਸ਼ਨਸ ਨਾਲ ਸਵੈਚਾਲਿਤ -### 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) ਦੀ ਸਿਫਾਰਸ਼ -- ਵਾਧੂ ਕੋਰਸ: ਜਨਰੇਟਿਵ ਏਆਈ, ਡੇਟਾ ਸਾਇੰਸ, ਐਮਐਲ, ਆਈਓਟੀ ਕਰੀਕੁਲਮ ਉਪਲਬਧ +- [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) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸਿਫਾਰਸ਼ੀ +- ਵਾਧੂ ਕੋਰਸ: ਜੇਨਰੇਟਿਵ ਏਆਈ, ਡਾਟਾ ਸਾਇੰਸ, ML, IoT ਕੋਰਸ ਉਪਲਬਧ -### Working with Specific Projects +### ਖਾਸ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ -ਵਿਸ਼ੇਸ਼ ਪ੍ਰਾਜੈਕਟਸ 'ਤੇ ਵਿਸਥਾਰ ਲਈ README ਫਾਈਲਾਂ ਦਾ ਸੰਦਰਭ ਲਓ: -- `quiz-app/README.md` - Vue 3 ਕਵਿਜ਼ ਐਪਲੀਕੇਸ਼ਨ -- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪਲੀਕੇਸ਼ਨ -- `5-browser-extension/README.md` - ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ -- `6-space-game/README.md` - ਕੈਨਵਾਸ-ਅਧਾਰਿਤ ਗੇਮ ਵਿਕਾਸ -- `9-chat-project/README.md` - ਏਆਈ ਚੈਟ ਸਹਾਇਕ ਪ੍ਰਾਜੈਕਟ +ਹਰ ਇੱਕ ਪ੍ਰੋਜੈਕਟ ਲਈ ਵਧੇਰੇ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ਾਂ ਲਈ 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` - ਏਆਈ ਚੈਟ ਸਹਾਇਕ ਪ੍ਰੋਜੈਕਟ -### Monorepo Structure +### ਮੋਨੋਰੀਪੋ ਢਾਂਚਾ -ਇਹ ਪ੍ਰੰਪਰਾ ਵਾਲਾ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ, ਪਰ ਇਸ ਰੈਪੋਜ਼ਟਰੀ ਵਿੱਚ ਕਈ ਸਵਤੰਤਰ ਪ੍ਰਾਜੈਕਟ ਹਨ: -- ਹਰ ਪਾਠ ਸਵਤੰਤਰ ਹੈ -- ਪ੍ਰਾਜੈਕਟਸ ਨਿਰਭਰਤਾਵਾਂ ਸਾਂਝੀਆਂ ਨਹੀਂ ਕਰਦੇ -- ਇਕੱਲੇ ਪ੍ਰਾਜੈਕਟਾਂ 'ਤੇ ਕੰਮ ਕਰੋ ਬਿਨਾ ਹੋਰਾਂ ਨੂੰ ਪ੍ਰਭਾਵਿਤ ਕੀਤੇ -- ਪੂਰਾ ਕਰੀਕੁਲਮ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰੈਪੋਜ਼ਟਰੀ ਕਲੋਨ ਕਰੋ +ਇਹ ਰੀਪੋਜ਼ਟਰੀ ਪਰੰਪਰਾਈ ਮੋਨੋਰੀਪੋ ਨਹੀਂ ਹੈ, ਪਰ ਇਸ ਵਿੱਚ ਕਈ ਸੁਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ: +- ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ +- ਪ੍ਰੋਜੈਕਟ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਸਾਂਝੀਆਂ ਨਹੀਂ ਕਰਦੇ +- ਵੱਖ-ਵੱਖ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਬਿਨਾਂ ਪ੍ਰਭਾਵ ਪਾਏ ਕੰਮ ਕਰੋ +- ਪੂਰੀ ਕੋਰਸ ਦਾ ਅਨੁਭਵ ਲਈ ਪੂਰਾ ਰੀਪੋ ਕਲੋਨ ਕਰੋ --- -**ਇਨਕਾਰ**: -ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਵਿੱਚ ਰੱਖੋ ਕਿ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੂਚਿਤਤਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਅਧਿਕਾਰਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਜਰੂਰੀ ਜਾਣਕਾਰੀ ਲਈ ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਪੈਦਾ ਹੋਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀਆਂ ਜਾਂ ਭ੍ਰਮਾਂ ਲਈ ਅਸੀਂ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ। +**ਅਸਵੀਕਾਰਾਂ**: +ਇਹ ਦਸਤਾਵੇਜ਼ ਏਆਈ ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦਿਤ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਆਟੋਮੇਟਿਕ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਪષ્ટਤਾਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਹੀ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ سمجھਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਣ ਜਾਣਕਾਰੀ ਲਈ, ਪ੍ਰੋਫੈਸ਼ਨਲ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫਾਰਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਤਪੰਨ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀ ਜਾਂ ਭ੍ਰਮ ਲਈ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ। \ No newline at end of file