diff --git a/translations/mr/.co-op-translator.json b/translations/mr/.co-op-translator.json index b2d279689..400db2076 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-06T08:18:05+00:00", + "translation_date": "2026-02-06T11:17:52+00:00", "source_file": "AGENTS.md", "language_code": "mr" }, diff --git a/translations/mr/AGENTS.md b/translations/mr/AGENTS.md index 87691e267..65df85ee4 100644 --- a/translations/mr/AGENTS.md +++ b/translations/mr/AGENTS.md @@ -2,42 +2,42 @@ ## प्रकल्पाचा आढावा -हा शिकण्याचा अभ्यासक्रम संचाहि आहे जो नवशिक्यांना वेब विकासाच्या मूलभूत गोष्टी शिकवण्यासाठी तयार करण्यात आला आहे. हा अभ्यासक्रम Microsoft Cloud Advocates यांनी विकसित केलेला १२ आठवड्यांचा सखोल अभ्यासक्रम आहे, ज्यामध्ये JavaScript, CSS आणि HTML या विषयांसाठी २४ हाताळणी आधारित धडे समाविष्ट आहेत. +हा नवीन लोकांना वेब विकासाच्या मूलतत्त्वांचे शिक्षण देण्यासाठी शैक्षणिक अभ्यासक्रम संचय आहे. हा अभ्यासक्रम Microsoft Cloud Advocates द्वारा विकसित केलेल्या सखोल १२ आठवड्यांच्या कोर्सचा भाग आहे, ज्यामध्ये JavaScript, CSS आणि HTML यांचा समावेश असलेल्या २४ हाताळणी-आधारित अधिवेशनांचा समावेश आहे. ### मुख्य घटक -- **शैक्षणिक सामग्री**: प्रकल्प-आधारित विभागांमध्ये संघटित २४ रचनेत धडे -- **प्रायोगिक प्रकल्प**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, आणि AI Chat Assistant -- **परस्परसंवादी क्विझ्ज**: प्रत्येकी ३ प्रश्नांसह ४८ क्विझ (पूर्व/नंतरच्या धड्यांसाठी मूल्यांकन) +- **शैक्षणिक सामग्री**: प्रकल्प-आधारित मॉड्यूलमध्ये आयोजित २४ संरचित अधिवेशन +- **व्यावहारिक प्रकल्प**: टेरारियम, टायपिंग गेम, ब्राउझर एक्सटेंशन, स्पेस गेम, बँकिंग अॅप, कोड एडिटर, आणि 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 cd Web-Dev-For-Beginners ``` -### क्विझ अ‍ॅप सेटअप (Vue 3 + Vite) +### क्विझ अॅप सेटअप (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # विकास सर्व्हर सुरू करा -npm run build # उत्पादनासाठी बांधा +npm run build # उत्पादनासाठी बिल्ड करा npm run lint # ESLint चालवा ``` @@ -46,17 +46,17 @@ npm run lint # ESLint चालवा ```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 वापरून स्वरूपित करा ``` -### ब्राउझर एक्सटेन्शन प्रकल्प +### ब्राउझर एक्सटेंशन प्रकल्प ```bash cd 5-browser-extension/solution npm install -# ब्राउझर-विशिष्ट एक्स्टेंशन लोड करण्याच्या सूचना अनुसरा +# ब्राउझर-विशिष्ट विस्तार लोड करण्याच्या सूचना पाळा ``` ### स्पेस गेम प्रकल्प @@ -64,10 +64,10 @@ npm install ```bash cd 6-space-game/solution npm install -# ब्राउझरमध्ये index.html उघडा किंवा Live Server वापरा +# index.html ब्राउझरमध्ये उघडा किंवा Live Server वापरा ``` -### चॅट प्रकल्प (Python Backend) +### चॅट प्रकल्प (Python बॅकएंड) ```bash cd 9-chat-project/solution/backend/python @@ -76,203 +76,203 @@ pip install openai python api.py ``` -## विकास कार्यप्रवाह +## विकास कार्यप्रणाली ### सामग्री योगदानकर्त्यांसाठी -1. आपला GitHub खातेवर हा संच फोर्क करा -2. फोर्क केलेला संच स्थानिकपणे क्लोन करा -3. बदलांसाठी नवीन शाखा तयार करा -4. धडा सामग्री किंवा कोड उदाहरण बदल करा -5. संबंधित प्रकल्प निर्देशिकांमध्ये कोड बदल तपासा -6. योगदान मार्गदर्शकानुसार पुल रिक्वेस्ट सबमिट करा +1. आपल्या GitHub खात्यात **संचय फोर्क करा** +2. **आपला फोर्क स्थानिक कॉपी करा** +3. **आपल्या बदलांसाठी नवीन शाखा तयार करा** +4. अधिवेशन सामग्री किंवा कोड उदाहरणांमध्ये बदल करा +5. संबंधित प्रकल्प फोल्डरमध्ये कोणतेही कोड बदल तपासा +6. योगदान मार्गदर्शक सूचनांनुसार पुल रिक्वेस्ट सबमिट करा ### शिकणाऱ्यांसाठी -1. संच फोर्क किंवा क्लोन करा -2. अनुक्रमे धडा निर्देशिक्यांमध्ये जा -3. प्रत्येक धड्यासाठी README फाइल वाचा -4. https://ff-quizzes.netlify.app/web/ येथे पूर्व-धडा क्विझ पूर्ण करा -5. धडा फोल्डरमधील कोड उदाहरणांवर काम करा -6. कामे आणि आव्हाने पूर्ण करा -7. नंतरच्या धडा क्विझ पूर्ण करा +1. संचय फोर्क किंवा क्लोन करा +2. अधिवेशन फोल्डरांमध्ये अनुक्रमे जा +3. प्रत्येक अधिवेशनासाठी README फाइल वाचा +4. पूर्व-अधिवेशन क्विझ https://ff-quizzes.netlify.app/web/ येथे पूर्ण करा +5. अधिवेशन फोल्डरमधील कोड उदाहरणांवर काम करा +6. असायनमेंट आणि आव्हाने पूर्ण करा +7. पश्च-अधिवेशन क्विझ द्या ### थेट विकास -- **दस्तऐवज**: `docsify serve` रूटमध्ये चालवा (पोर्ट 3000) -- **क्विझ अ‍ॅप**: quiz-app निर्देशिकेत `npm run dev` चालवा +- **दस्तऐवजीकरण**: रूट मध्ये `docsify serve` चालवा (पोर्ट 3000) +- **क्विझ अॅप**: quiz-app फोल्डरमध्ये `npm run dev` चालवा - **प्रकल्प**: HTML प्रकल्पांसाठी VS Code Live Server विस्तार वापरा -- **API प्रकल्प**: संबंधित API निर्देशिकांमध्ये `npm start` चालवा +- **API प्रकल्प**: संबंधित API फोल्डरमध्ये `npm start` चालवा ## चाचणी सूचना -### क्विझ अ‍ॅप परीक्षण +### क्विझ अॅप चाचणी ```bash cd quiz-app -npm run lint # कोड शैलीतील समस्या तपासा -npm run build # बिल्ड यशस्वी आहे की नाही याची पुष्टी करा +npm run lint # कोड शैलीच्या समस्यांसाठी तपासा +npm run build # बिल्ड यशस्वी होतो का ते सत्यापित करा ``` -### बँक API परीक्षण +### बँक API चाचणी ```bash cd 7-bank-project/api -npm run lint # कोड स्टाईल समस्यांसाठी तपासा -node server.js # सर्व्हर चुका न देता सुरू होतो का ते तपासा +npm run lint # कोड शैली समस्या तपासा +node server.js # त्रुटीशिवाय सर्व्हर सुरू होतो का ते तपासा ``` -### सर्वसाधारण चाचणी पद्धत +### सामान्य चाचणी पद्धत -- हा शैक्षणिक संच आहे ज्यामध्ये व्यापक स्वयंचलित चाचण्या नाहीत -- मॅन्युअल चाचणीवर लक्ष केंद्रीत: - - कोड उदाहरण त्रुटीशिवाय चालतील - - दस्तऐवजातील दुवे व्यवस्थित काम करतील - - प्रकल्प यशस्वीपणे तयार होतील - - उदाहरणे उत्तम पद्धतींचे पालन करतील +- हा शैक्षणिक संचय संपूर्ण स्वयंचलित चाचण्यांसह नाही +- मॅन्युअल चाचणीवर लक्ष केंद्रित: + - कोड उदाहरणे त्रुटीशिवाय चालणे + - दस्तऐवजीकरणातील दुवे योग्यरित्या काम करणे + - प्रकल्पांची यशस्वी बिल्ड होणे + - उदाहरणे उत्तम पद्धतींनुसार असल्याची खात्री -### पूर्व-प्रस्ताव तपासणी +### सादर करण्यापूर्वी तपासणी -- package.json असलेल्या निर्देशिक्यांमध्ये `npm run lint` चालवा -- markdown दुवे वैध आहेत का ते तपासा +- package.json असलेल्या फोल्डरमध्ये `npm run lint` चालवा +- मार्कडाउन दुवे वैध आहेत का तपासा - ब्राउझर किंवा Node.js मध्ये कोड उदाहरणे तपासा -- भाषांतरांनी योग्य रचना राखलेली आहे का ते तपासा +- भाषांतर संरचना योग्य आहे का तपासा ## कोड शैली मार्गदर्शक ### JavaScript -- आधुनिक ES6+ सिंटॅक्स वापरा -- प्रकल्पांमध्ये दिलेली मानक ESLint संरचना अनुसरण करा -- शैक्षणिक स्पष्टतेसाठी सार्थक चल आणि फंक्शन नावे वापरा -- शिकणाऱ्यांसाठी संकल्पना समजावणारे टिप्पणी जोडा -- Prettier वापरुन स्वरूपित करा ज्या ठिकाणी कॉन्फिगर आहे +- आधुनिक ES6+ वाक्यरचना वापरा +- प्रकल्पांमध्ये दिलेले मानक ESLint कॉन्फिगरेशन वापरा +- शैक्षणिक स्पष्टतेसाठी अर्थपूर्ण व्हेरिएबल आणि फंक्शन नावे वापरा +- शिकणाऱ्यांसाठी संकल्पना समजावणारे टिप्पण्या जोडा +- जिथे कॉन्फिगर केले आहे तिथे Prettier वापरून फॉरमॅट करा ### HTML/CSS -- सेमेंटिक HTML5 घटक वापर करा -- उत्तरदायी डिझाइन तत्त्वे वापरा -- स्पष्ट वर्ग नावे वापरा -- CSS तंत्राबाबत शिकणाऱ्यांसाठी टिप्पणी द्या +- सांकेतिक HTML5 घटकांचा वापर करा +- प्रत्युत्तरात्मक डिझाइन तत्त्वे वापरा +- स्वच्छ वर्ग नामकरण परंपरा +- शिकणाऱ्यांसाठी CSS तंत्र समजावणाऱ्या टिप्पण्या ### Python -- PEP 8 शैली मार्गदर्शकांचे पालन करा -- स्पष्ट, शैक्षणिक कोड उदाहरणे वापरा -- शिकण्यासाठी उपयुक्त ठिकाणी टाइप संकेत वापरा +- PEP 8 शैली मार्गदर्शक +- स्पष्ट, शैक्षणिक कोड उदाहरणे +- वापरासाठी उपयुक्त असलेले टाइप हिंट्स -### Markdown दस्तऐवज +### मार्कडाउन दस्तऐवजीकरण -- स्पष्ट अक्षरेवारी रचना -- भाषा निर्दिष्ट केलेले कोड ब्लॉक्स -- अतिरिक्त संसाधनांचे दुवे -- `images/` फोल्डरमधील स्क्रीनशॉट्स आणि प्रतिमा -- प्रतिमांसाठी प्रवेशयोग्यता विचारून alt टेक्स्ट +- स्पष्ट शीर्षक यादी +- भाषा निर्दिष्ट असलेले कोड ब्लॉक्स +- अतिरिक्त संसाधनांसाठी दुवे +- `images/` फोल्डरमधील स्क्रीनशॉट आणि प्रतिमा +- प्रतिमांसाठी प्रवेशयोग्यतेसाठी Alt मजकूर ### फाइल संघटना -- धडे अनुक्रमे क्रमांकित (1-getting-started-lessons, 2-js-basics, इत्यादी) -- प्रत्येक प्रकल्पासाठी `solution/` आणि अनेकदा `start/` किंवा `your-work/` निर्देशिका -- धडा-विशिष्ट `images/` फोल्डरमध्ये प्रतिमा संग्रहित -- `translations/{language-code}/` रचनेत भाषांतर +- अधिवेशन क्रमांकानुसार क्रमबद्ध (1-getting-started-lessons, 2-js-basics, इ.) +- प्रत्येक प्रकल्पाकडे `solution/` आणि बहुधा `start/` किंवा `your-work/` फोल्डर +- अधिवेशन-विशिष्ट `images/` फोल्डरमध्ये प्रतिमा संग्रहित +- भाषांतर `translations/{language-code}/` रचनेमध्ये -## बांधकाम आणि तैनात +## बिल्ड आणि वितरण -### क्विझ अ‍ॅप तैनात (Azure Static Web Apps) +### क्विझ अॅप वितरण (Azure Static Web Apps) -quiz-app Azure Static Web Apps तैनातीसाठी कॉन्फिगर केलेला आहे: +क्विझ-अॅप Azure Static Web Apps वितरणासाठी कॉन्फिगर केलेले आहे: ```bash cd quiz-app -npm run build # dist/ फोल्डर तयार करते -# मुख्य ब्रॅन्चवर पुश केल्यावर GitHub Actions कार्यप्रवाहाद्वारे तैनात करते +npm run build # dist/ फोल्डर तयार करतो +# मुख्य शाखेत push केल्यावर GitHub Actions workflow द्वारे तैनात करतो ``` 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 निर्मिती ```bash npm install # docsify-to-pdf स्थापित करा -npm run convert # docs कडून PDF तयार करा +npm run convert # डॉक्समधून 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] 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] अधिवेशन ५ साठी स्पॅनिश भाषांतर जोडा` +- `[Docs] सेटअप सूचना अद्यतनित करा` -### आवश्यक तपासण्या +### आवश्यक तपासणी -पुल रिक्वेस्ट सबमिट करण्यापूर्वी: +PR सादर करण्यापूर्वी: 1. **कोड गुणवत्ता**: - - प्रभावित प्रकल्प निर्देशिकांमध्ये `npm run lint` चालवा - - सर्व लिंटिंग त्रुटी आणि चेतावण्या सुधारा + - प्रभावित प्रकल्प फोल्डरमध्ये `npm run lint` चालवा + - सर्व लिंट त्रुटी व इशारे दुरुस्त करा -2. **बांधणी सत्यापन**: +2. **बिल्ड पडताळणी**: - लागू असल्यास `npm run build` चालवा - - कोणतीही बांधणी त्रुटी नाही याची खात्री करा + - कोणत्याही बिल्ड त्रुटी नसल्याची खात्री करा -3. **दुवा पडताळणी**: - - सर्व markdown दुवे तपासा - - प्रतिमा संदर्भ कार्यरत आहेत का ते पहा +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 मध्ये मेंटेनर आणि समुदायाचे पुनरावलोकन -- शैक्षणिक स्पष्टतेला प्राधान्य दिले जाते -- कोड उदाहरणांनी सध्याच्या उत्तम पद्धतींचे पालन करावे -- भाषांतर अचूकता आणि सांस्कृतिक सुसंगततेसाठी तपासले जातात +- PR मध्ये देखभाल करणारे आणि समुदाय सदस्य पुनरावलोकन करतात +- शैक्षणिक स्पष्टताकडे प्राधान्य दिले जाते +- कोड उदाहरणे वर्तमान सर्वोत्तम पद्धतींनुसार पाहणी करावीत +- भाषांतर अचूकता आणि सांस्कृतिक योग्यतेसाठी तपासले जातात ## भाषांतर प्रणाली ### स्वयंचलित भाषांतर -- GitHub Actions वापरून co-op-translator कार्यप्रवाह -- ५०+ भाषांमध्ये स्वयंचलित भाषांतर -- मुख्य निर्देशिकांमधील स्रोत फाइल्स -- `translations/{language-code}/` निर्देशिकांमधील भाषांतरित फाइल्स +- GitHub Actions सह co-op-translator वर्कफ्लो वापरतो +- ५०+ भाषांमध्ये स्वयंचलित भाषांतर करतो +- मुख्य फोल्डरमधील स्रोत फाइल्स +- भाषांतर फाइल्स `translations/{language-code}/` फोल्डरमध्ये -### मॅन्युअल भाषांतर सुधारणा जोडणे +### मॅन्युअल भाषांतर सुधारणा कशी करावी -1. `translations/{language-code}/` मधील फाइल शोधा -2. रचना राखत सुधारणा करा -3. कोड उदाहरण कार्यक्षम राहील याची खात्री करा -4. स्थानिकृत क्विझ सामग्री चाचणी करा +1. `translations/{language-code}/` मध्ये फाइल शोधा +2. संरचना टिकवून सुधारणा करा +3. कोड उदाहरणे कार्यक्षम राहतील याची खात्री करा +4. स्थानिकृत क्विझ सामग्री तपासा ### भाषांतर मेटाडेटा @@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA: ### सामान्य समस्या -**क्विझ अ‍ॅप सुरू होत नाही:** -- Node.js आवृत्ती तपासा (v14+ शिफारस) +**क्विझ अॅप सुरू होत नाही**: +- Node.js आवृत्ती तपासा (v14+ शिफारस केलेली) - `node_modules` आणि `package-lock.json` हटवा, नंतर `npm install` चालवा -- पोर्ट संघर्ष तपासा (डिफॉल्ट: Vite पोर्ट 5173 वापरतो) +- पोर्ट संघर्ष तपासा (पूर्वनिर्धारित: Vite पोर्ट 5173 वापरतो) -**API सर्व्हर सुरू होत नाही:** -- Node.js आवृत्ती तपासा (node >=10 आवश्यक) -- पोर्ट आधीच वापरात आहे का हे तपासा -- सर्व अवलंबित्वे `npm install` ने स्थापित आहेत का पहा +**API सर्व्हर सुरू होत नाही**: +- Node.js आवृत्ती किमान अटी तपासा (node >=10) +- पोर्ट आधीच वापरात आहे का तपासा +- सर्व अवलंबित्वे `npm install` द्वारे स्थापित आहेत का तपासा -**ब्राउझर एक्सटेन्शन लोड होत नाही:** -- manifest.json योग्य स्वरूपात आहे का तपासा -- ब्राउझर कन्सोलमध्ये त्रुटी तपासा -- ब्राउझर-विशिष्ट एक्सटेन्शन इन्स्टॉलेशन सूचना पाळा +**ब्राउझर एक्सटेंशन लोड होत नाही**: +- manifest.json योग्यरित्या फॉरमॅट आहे का तपासा +- ब्राउझर कन्सोलमधील त्रुटी तपासा +- ब्राउझर-विशिष्ट एक्सटेंशन स्थापित सूचना पाळा -**Python चॅट प्रकल्प समस्या:** -- OpenAI पॅकेज इन्स्टॉल करा: `pip install openai` -- GITHUB_TOKEN पर्यावरण चल सेट आहे का तपासा +**Python चॅट प्रकल्प समस्या**: +- OpenAI पॅकेज स्थापित आहे का तपासा: `pip install openai` +- GITHUB_TOKEN पर्यावरणीय चल सेट आहे का तपासा - GitHub मॉडेल्स प्रवेश परवानग्या तपासा -**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 विस्तार स्थापित करा सुसंगत स्वरूपासाठी +- सुसंगत स्वरूपासाठी ESLint आणि Prettier विस्तार इन्स्टॉल करा - JavaScript डीबगिंगसाठी ब्राउझर DevTools वापरा - Vue प्रकल्पांसाठी Vue DevTools ब्राउझर विस्तार इन्स्टॉल करा -### कार्यप्रदर्शन विचार +### कार्यक्षमतेच्या बाबतीत विचार -- भाषांतरित फाइल्स (५०+ भाषा) मोठ्या संख्या असल्यामुळे पूर्ण क्लोन मोठा -- फक्त सामग्रीवर काम करत असल्यास शॅलो क्लोन वापरा: `git clone --depth 1` -- इंग्रजी सामग्रीवर काम करताना शोधांमध्ये भाषांतर वगळा -- प्रथम वेळी बांधकाम प्रक्रिया हळू होऊ शकते (npm install, Vite build) +- भरपूर भाषांतर फाइल्स (५०+ भाषा) म्हणजे पूर्ण क्लोन मोठ्या प्रमाणात असतात +- फक्त सामग्रीवर काम करत असल्यास shallow clone वापरा: `git clone --depth 1` +- इंग्रजी सामग्रीवर काम करताना भाषांतर शोधात वगळा +- प्रथम रनवर (npm install, Vite build) बिल्ड प्रक्रिया मंद असू शकते -## सुरक्षा विचार +## सुरक्षा बाबतीत विचार -### पर्यावरण बदलणारे +### पर्यावरणीय चल -- API कीज कधीही संचामध्ये कमिट करू नयेत +- API की कधीही संचयात कमिट करू नका - `.env` फाइल्स वापरा (आधीच `.gitignore` मध्ये आहेत) -- प्रकल्प READMEs मध्ये आवश्यक पर्यावरण चलांचे दस्तऐवजीकरण करा +- प्रकल्पाच्या README मध्ये आवश्यक पर्यावरणीय चलं दस्तऐवजीकरण करा ### Python प्रकल्प -- वर्चुअल वातावरणे वापरा: `python -m venv venv` +- वर्च्युअल पर्यावरणांचा वापर करा: `python -m venv venv` - अवलंबित्वे अद्ययावत ठेवा -- GitHub टोकन्सला किमान आवश्यक परवानग्या द्या +- GitHub टोकन्सना कमीत कमी आवश्यक परवानगी द्या ### GitHub मॉडेल्स प्रवेश -- GitHub मॉडेलसाठी व्यक्तिगत प्रवेश टोकन्स (PAT) आवश्यक -- टोकन्स पर्यावरण चल म्हणून संग्रहित करा +- 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 अभ्यासक्रम उपलब्ध +- शिकणाऱ्यांसाठी [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) शिफारसीत +- अतिरिक्त कोर्सेस: जनरेटिव्ह AI, डेटा सायन्स, ML, IoT अभ्यासक्रम उपलब्ध ### विशिष्ट प्रकल्पांसह काम करणे -विवरणासाठी प्रकल्पांची README फाइल पहा: -- `quiz-app/README.md` - Vue 3 क्विझ अ‍ॅप्लिकेशन -- `7-bank-project/README.md` - प्रमाणपत्रांसह बँकिंग अ‍ॅप -- `5-browser-extension/README.md` - ब्राउझर एक्सटेन्शन विकास +व्यक्तिगत प्रकल्पांसाठी तपशीलवार सूचना पहा: +- `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 चॅट सहाय्यक प्रकल्प -### मोनोरेपो रचना +### मोनोरिपो संरचना -हा पारंपरिक मोनोरेपो नाही, पण हा संच अनेक स्वतंत्र प्रकल्पांचा समावेश करतो: -- प्रत्येक धडा स्वतंत्र -- प्रकल्पांमध्ये अवलंबित्वे शेअर होत नाहीत -- स्वतंत्र प्रकल्पांवर काम करा, एकमेकांवर परिणाम न करता -- पूर्ण अभ्यासक्रमासाठी संपूर्ण संच क्लोन करा +पारंपरिक मोनोरिपो नसले तरी, हा संच अनेक स्वतंत्र प्रकल्प समाविष्ट करतो: +- प्रत्येक अधिवेशन स्वतंत्र आहे +- प्रकल्पे अवलंबित्वे शेअर करत नाहीत +- एकत्र नोंदी न करता स्वतंत्र प्रकल्पांवर काम करा +- पूर्ण अभ्यासक्रम अनुभवासाठी संपूर्ण संच क्लोन करा --- -**सूचना**: -हा दस्तऐवज 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 81984f123..53dca9dfe 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-06T08:19:22+00:00", + "translation_date": "2026-02-06T11:19:06+00:00", "source_file": "AGENTS.md", "language_code": "ne" }, diff --git a/translations/ne/AGENTS.md b/translations/ne/AGENTS.md index 595708564..14cff1cf1 100644 --- a/translations/ne/AGENTS.md +++ b/translations/ne/AGENTS.md @@ -2,27 +2,27 @@ ## परियोजना अवलोकन -यसले वेब विकासको आधारभूत कुराहरू सिकाउने शैक्षिक पाठ्यक्रम भण्डार हो जुन शुरुवातीहरूको लागि तयार गरिएको छ। यस पाठ्यक्रमले Microsoft Cloud Advocates द्वारा विकास गरिएको १२ साताको पूर्ण पाठ्यक्रम समावेश गर्दछ, जसमा २४ व्यावहारिक पाठहरू छन् जुन JavaScript, CSS, र HTML समेट्छ। +यो शुरुवातकर्ताहरूलाई वेब विकासका आधारभूत कुरा सिकाउनका लागि शैक्षिक पाठ्यक्रम भण्डार हो। यो पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकास गरिएको १२ हप्ताको समग्र कोर्स हो, जसमा JavaScript, CSS, र HTML समेटिएका २४ व्यावहारिक पाठहरू समावेश छन्। -### मुख्य घटकहरू +### मुख्य अवयवहरू -- **शैक्षिक सामग्री**: परियोजना-आधारित मोड्युलहरूमा आयोजित २४ संरचित पाठहरू -- **व्यावहारिक परियोजनाहरू**: Terrarium, टाइपिङ खेल, ब्राउजर एक्सटेन्सन, स्पेस खेल, बैंकिङ एप, कोड सम्पादक, र AI चैट सहायक -- **इन्टरएक्टिभ क्विजहरू**: प्रत्येकमा ३ प्रश्न सहित ४८ quizzes (पाठ अघि/पछिको मूल्याङ्कन) -- **बहु-भाषा समर्थन**: 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, कोड उदाहरणहरू, र समाधानहरू समावेश +- पाठ-आधारित संरचनासहितको शैक्षिक भण्डार +- प्रत्येक पाठ फोल्डरमा README, कोड उदाहरणहरू, र समाधानहरू समावेश छन् - स्वतन्त्र परियोजनाहरू अलग निर्देशिकाहरूमा (quiz-app, विभिन्न पाठ परियोजनाहरू) -- GitHub Actions (co-op-translator) प्रयोग गर्दै अनुवाद प्रणाली -- Docsify मार्फत दस्तावेज सेवा र PDF स्वरूपमा उपलब्ध +- GitHub Actions प्रयोग गरेर अनुवाद प्रणाली (co-op-translator) +- Docsify मार्फत सेवा गरिएको दस्तावेज र PDF रूपमा उपलब्ध ## सेटअप आदेशहरू -यो भण्डार मुख्य रूपमा शैक्षिक सामग्रीको उपभोगका लागि हो। विशेष परियोजनाहरूसँग काम गर्नका लागि: +यो भण्डार मुख्य रूपमा शैक्षिक सामग्री उपभोगका लागि हो। विशेष परियोजनाहरूमा काम गर्न: ### मुख्य भण्डार सेटअप @@ -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,18 +56,18 @@ npm run format # Prettier सँग ढाँचा मिलाउनुह ```bash cd 5-browser-extension/solution npm install -# ब्राउजर-विशेष एक्सटेन्सन लोड गर्ने निर्देशनहरू पालना गर्नुहोस् +# ब्राउजर-विशिष्ट एक्सटेन्सन लोडिङ निर्देशहरू पालन गर्नुहोस् ``` -### स्पेस खेल परियोजनाहरू +### स्पेस गेम परियोजनाहरू ```bash cd 6-space-game/solution npm install -# index.html ब्राउजरमा खोलेर वा Live Server प्रयोग गर्नुहोस् +# ब्राउजरमा index.html खोल्नुहोस् वा Live Server प्रयोग गर्नुहोस् ``` -### चैट परियोजना (Python ब्याकएन्ड) +### च्याट परियोजना (Python Backend) ```bash cd 9-chat-project/solution/backend/python @@ -80,28 +80,28 @@ python api.py ### सामग्री योगदानकर्ताहरूका लागि -1. आफ्नो GitHub खातामा रिपोजिटरीलाई **Fork** गर्नुहोस् -2. आफ्नो Fork लाई स्थानीय रूपमा **Clone** गर्नुहोस् -3. परिवर्तनहरूका लागि नयाँ शाखा **Create** गर्नुहोस् +1. आफ्नो GitHub खातामा भण्डारको **फोर्क गर्नुहोस्** +2. आफ्नो फोर्कलाई **स्थानीय रूपमा क्लोन गर्नुहोस्** +3. आफ्ना परिवर्तनहरूका लागि **नयाँ शाखा बनाउनुस्** 4. पाठ सामग्री वा कोड उदाहरणहरूमा परिवर्तन गर्नुहोस् -5. सम्बन्धित परियोजना निर्देशिकाहरूमा कुनै पनि कोड परिवर्तनहरू परीक्षण गर्नुहोस् -6. योगदान दिशानिर्देशहरू अनुसरण गर्दै पुल रिक्वेस्टहरू पठाउनुहोस् +5. सम्बन्धित परियोजना निर्देशिकाहरूमा कोड परिवर्तनहरू परीक्षण गर्नुहोस् +6. योगदान दिशानिर्देशहरू अनुसार पुल अनुरोधहरू पठाउनुहोस् ### सिक्नेहरूका लागि -1. रिपोजिटरी Fork वा Clone गर्नुहोस् -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` आदेश चलाउनुहोस् (रुटमा, पोर्ट ३०००) +- **दस्तावेजहरू**: रुटमा `docsify serve` चलाउनुहोस् (पोर्ट ३०००) - **क्विज एप**: quiz-app निर्देशिकामा `npm run dev` चलाउनुहोस् -- **परियोजनाहरू**: HTML परियोजनाहरूको लागि VS Code Live Server विस्तार प्रयोग गर्नुहोस् +- **परियोजनाहरू**: HTML परियोजनाहरूका लागि VS Code Live Server एक्सटेन्सन प्रयोग गर्नुहोस् - **API परियोजनाहरू**: सम्बन्धित API निर्देशिकामा `npm start` चलाउनुहोस् ## परीक्षण निर्देशनहरू @@ -110,8 +110,8 @@ python api.py ```bash cd quiz-app -npm run lint # कोड शैली समस्याहरूको जाँच गर्नुहोस् -npm run build # निर्माण सफल हुन्छ कि भनि प्रमाणित गर्नुहोस् +npm run lint # कोड शैली समस्याहरू जाँच गर्नुहोस् +npm run build # निर्माण सफल हुन्छ कि छैन जाँच गर्नुहोस् ``` ### बैंक API परीक्षण @@ -119,73 +119,73 @@ npm run build # निर्माण सफल हुन्छ कि भ ```bash cd 7-bank-project/api npm run lint # कोड शैली समस्याहरू जाँच गर्नुहोस् -node server.js # सर्भर त्रुटि बिना सुरु हुन्छ कि होइन जाँच गर्नुहोस् +node server.js # सर्भर त्रुटि बिना सुरु हुन्छ भनेर जाँच गर्नुहोस् ``` ### सामान्य परीक्षण दृष्टिकोण -- यो शैक्षिक भण्डारमा व्यापक स्वचालित परीक्षण छैन -- म्यानुअल परीक्षणले निम्नजन्य कुराहरूमा केन्द्रित छ: - - कोड उदाहरणहरू त्रुटि बिना चल्ने - - दस्तावेजीकरणका लिङ्कहरू ठीक काम गर्ने - - परियोजना सफलतापूर्वक बिल्ड हुने +- यो शैक्षिक भण्डार पूर्ण स्वचालित परीक्षणविना हो +- म्यानुअल परीक्षणमा फोकस: + - कोड उदाहरणहरू त्रुटिरहित चल्ने + - दस्तावेजमा लिंकहरू सही काम गर्ने + - परियोजना निर्माण सफलतापूर्वक सम्पन्न हुने - उदाहरणहरूले उत्तम अभ्यासहरू पालना गर्ने -### पूर्व-प्रस्तुति जाँचहरू +### पूर्व-प्रस्तुतीकरण जाँचहरू -- package.json भएका निर्देशिकाहरूमा `npm run lint` चलाउनुहोस् -- Markdown लिङ्कहरू मान्य छन् कि छैनन् जाँच गर्नुहोस् -- ब्राउजर वा Node.js मा कोड उदाहरण परीक्षण गर्नुहोस् -- अनुवादहरूले सही संरचना बनाए राखेका छन् कि छैनन् जाँच गर्नुहोस् +- package.json भएका निर्देशिकामा `npm run lint` चलाउनुहोस् +- मार्कडाउन लिंकहरू मान्य छन् भनेर पुष्टि गर्नुहोस् +- कोड उदाहरणहरू ब्राउजर वा Node.js मा परीक्षण गर्नुहोस् +- अनुवादहरूले सही संरचना कायम राखेको जाँच गर्नुहोस् -## कोड शैली दिशानिर्देशहरू +## कोड शैली निर्देशनहरू ### JavaScript - आधुनिक ES6+ सिन्ट्याक्स प्रयोग गर्नुहोस् -- परियोजनाहरूमा दिइएका मानक ESLint कन्फिगरेसनहरू अनुसरण गर्नुहोस् +- परियोजनाहरूमा उपलब्ध मानक ESLint कन्फिगरेसनहरू पालना गर्नुहोस् - शैक्षिक स्पष्टताका लागि अर्थपूर्ण भेरिएबल र फंक्शन नामहरू प्रयोग गर्नुहोस् -- सिक्नेहरूका लागि अवधारणाहरू स्पष्ट पार्ने टिप्पणिहरू थप्नुहोस् -- Prettier ले कन्फिगर गरिएको ठाउँहरूमा फर्म्याट गर्नुहोस् +- सिक्नेहरूका लागि अवधारणाहरू व्याख्या गर्ने टिप्पणीहरू थप्नुहोस् +- जहाँ कन्फिगर गरिएको छ त्यहाँ Prettier द्वारा फर्म्याट गर्नुहोस् ### HTML/CSS -- Semantic HTML5 एलिमेन्टहरू -- प्रत्युत्तरकारी डिजाइन सिद्धान्तहरू -- स्पष्ट वर्ग नामाकरण -- सिक्नेहरूका लागि CSS प्रविधिहरू व्याख्या गर्ने टिप्पणिहरू +- अर्थपूर्ण HTML5 तत्वहरू +- उत्तरदायी डिजाइन सिद्धान्तहरू +- स्पष्ट क्लास नामकरण +- CSS प्राविधिहरू व्याख्या गर्ने टिप्पणीहरू ### Python -- PEP 8 शैली दिशानिर्देशहरू +- PEP 8 शैली निर्देशनहरू - स्पष्ट, शैक्षिक कोड उदाहरणहरू -- सिकाइमा सहयोगपूर्ण ठाउँमा प्रकार संकेतहरू +- सिकाइका लागि सहायता हुने ठाउँमा टाइप हिन्टहरू -### Markdown दस्तावेजीकरण +### मार्कडाउन दस्तावेजीकरण - स्पष्ट शीर्षक पदानुक्रम -- भाषा निर्दिष्ट सहित कोड ब्लकहरू -- थप स्रोतहरूमा लिङ्कहरू +- भाषा निर्दिष्ट गरिएको कोड ब्लकहरू +- थप स्रोतहरूको लिङ्कहरू - `images/` निर्देशिकामा स्क्रिनशट र छविहरू -- पहुँचयोग्यताको लागि छविहरूमा Alt टेक्स्ट +- पहुँचपात्रताको लागि छविहरूको alt टेक्स्ट -### फाइल संगठन +### फाइल आयोजन -- पाठहरू क्रमागत संख्या सहित (1-getting-started-lessons, 2-js-basics, आदि) -- प्रत्येक परियोजनामा `solution/` र प्राय: `start/` वा `your-work/` निर्देशिकाहरू -- पाठ-विशिष्ट `images/` फोल्डरहरूमा छविहरू संग्रहित +- पाठहरू क्रमशः नम्बर गरिएको (1-getting-started-lessons, 2-js-basics आदि) +- प्रत्येक परियोजनामा `solution/` र अक्सर `start/` वा `your-work/` निर्देशिकाहरू +- पाठ-विशिष्ट छवि फोल्डरहरूमा छविहरू - अनुवादहरू `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/ फोल्डर सिर्जना गर्दछ -# मुख्यमा पुश गर्दा GitHub Actions वर्कफ्लो मार्फत परिनियोजन गर्दछ +# मुख्यमा पुश गर्दा GitHub Actions workflow मार्फत परिनियोजन गर्दछ ``` Azure Static Web Apps कन्फिगरेसन: @@ -193,90 +193,90 @@ Azure Static Web Apps कन्फिगरेसन: - **आउटपुट स्थान**: `dist` - **वर्कफ्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### दस्तावेजीकरण PDF निर्माण +### दस्तावेज PDF उत्पादन ```bash npm install # docsify-to-pdf स्थापना गर्नुहोस् -npm run convert # docs बाट PDF बनाउनुहोस् +npm 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` ले उत्पादन बन्डलहरू सिर्जना गर्दछ -- स्ट्याटिक परियोजनाहरू: कुनै निर्माण चरण छैन, फाइलहरू सिधै सेवा दिने +प्रत्येक परियोजना निर्देशिकासँग आफ्नै निर्माण प्रक्रिया हुन सक्छ: +- Vue परियोजनाहरू: उत्पादन बन्डलहरू बनाउन `npm run build` +- स्थिर परियोजनाहरू: कुनै निर्माण चरण छैन, सिधै फाइलहरू सेवा गर्नुहोस् -## पुल रिक्वेस्ट दिशानिर्देशहरू +## पुल अनुरोध निर्देशनहरू ### शीर्षक ढाँचा परिवर्तन क्षेत्र स्पष्ट गर्ने शीर्षकहरू प्रयोग गर्नुहोस्: -- `[Quiz-app] पाठ X को लागि नयाँ क्विज थप्नुहोस्` -- `[Lesson-3] टेररियम परियोजनामा टाइपो सुधार गर्नुहोस्` -- `[Translation] पाठ 5 को लागि स्पेनिश अनुवाद थप्नुहोस्` +- `[Quiz-app] पाठ X का लागि नयाँ क्विज थप्नुहोस्` +- `[Lesson-3] टेरारियम परियोजनामा टाइपो सुधार` +- `[Translation] पाठ ५ को स्पेनिश अनुवाद थप्नुहोस्` - `[Docs] सेटअप निर्देशनहरू अद्यावधिक गर्नुहोस्` ### आवश्यक जाँचहरू -PR पेश गर्नु पूर्व: +PR पठाउनु अघि: 1. **कोड गुणस्तर**: - प्रभावित परियोजना निर्देशिकाहरूमा `npm run lint` चलाउनुहोस् - - सबै lint त्रुटि र चेतावनीहरू सच्याउनुहोस् + - सबै लिटिङ त्रुटि र चेतावनीहरू सुधार्नुहोस् -2. **बिल्ड प्रमाणीकरण**: +2. **निर्माण प्रमाणीकरण**: - लागू भएमा `npm run build` चलाउनुहोस् - - बिल्ड त्रुटि नभएको सुनिश्चित गर्नुहोस् + - कुनै निर्माण त्रुटि छैन भनेर सुनिश्चित गर्नुहोस् -3. **लिङ्क प्रमाणीकरण**: - - सबै Markdown लिङ्कहरू परीक्षण गर्नुहोस् - - छवि सन्दर्भहरू ठीक छन् कि छैनन् जाँच गर्नुहोस् +3. **लिंक प्रमाणीकरण**: + - सबै मार्कडाउन लिंकहरूको परीक्षण गर्नुहोस् + - छवि सन्दर्भहरू सत्यापित गर्नुहोस् 4. **सामग्री समीक्षा**: - - वर्तनी र व्याकरणका लागि प्रूफरीड गर्नुहोस् - - कोड उदाहरणहरू सही र शैक्षिक छन् कि छैनन् सुनिश्चित गर्नुहोस् - - अनुवादहरूले मूल अर्थ कायम राखेका छन् कि छैनन् जाँच गर्नुहोस् + - वर्तनी र व्याकरणका लागि प्रमाणपढ़ें गर्नुहोस् + - कोड उदाहरणहरू सही र शैक्षिक छन् सुनिश्चित गर्नुहोस् + - अनुवादहरूले मूल अर्थ कायम राखेको जाँच गर्नुहोस् ### योगदान आवश्यकताहरू -- Microsoft CLA (पहिलो PR मा स्वचालित जाँच) मा सहमति जनाउनुहोस् +- Microsoft CLA मा सहमति (पहिलो PR मा स्वचालित जाँच) - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) पालना गर्नुहोस् - विस्तृत दिशानिर्देशका लागि [CONTRIBUTING.md](./CONTRIBUTING.md) हेर्नुहोस् -- PR वर्णनमा मुद्दा नम्बरहरू उल्लेख गर्नुहोस् यदि लागू भएमा +- लागू भएमा PR विवरणमा मुद्दा नम्बर उल्लेख गर्नुहोस् ### समीक्षा प्रक्रिया -- PR को समीक्षा मर्मतकर्ता र समुदायद्वारा गरिन्छ -- शैक्षिक स्पष्टता प्राथमिकता दिइन्छ -- कोड उदाहरणहरूले वर्तमान उत्तम अभ्यासहरू पालना गर्ने -- अनुवादहरू सटीकता र सांस्कृतिक उपयुक्तताका लागि समीक्षा गरिने +- PR हरू मर्मतकर्ता र समुदाय द्वारा समीक्षा गरिन्छ +- शैक्षिक स्पष्टता प्राथमिकता हो +- कोड उदाहरणहरूले वर्तमान उत्तम अभ्यासहरू पालना गर्नुपर्छ +- अनुवादहरू सहीता र सांस्कृतिक उपयुक्तताका लागि समीक्षा गरिन्छ ## अनुवाद प्रणाली ### स्वचालित अनुवाद -- GitHub Actions प्रयोग गर्दै co-op-translator वर्कफ्लो -- स्वचालित रूपमा ५०+ भाषामा अनुवाद -- मुख्य निर्देशिकाहरूमा स्रोत फाइलहरू -- `translations/{language-code}/` निर्देशिकाहरूमा अनुवादित फाइलहरू +- GitHub Actions को co-op-translator वर्कफ्लो प्रयोग गर्दछ +- ५०+ भाषामा स्वचालित अनुवाद गर्छ +- मुख्य निर्देशिकाहरूमा श्रोत फाइलहरू +- `translations/{language-code}/` निर्देशिकामा अनुवादित फाइलहरू -### म्यानुअल अनुवाद सुधारहरू थप्ने +### म्यानुअल अनुवाद सुधारहरू थप्ने तरिका -1. `translations/{language-code}/` मा फाइल खोज्नुहोस् +1. `translations/{language-code}/` मा फाइल फेला पार्नुहोस् 2. संरचना कायम राख्दै सुधार गर्नुहोस् -3. कोड उदाहरणहरू कार्यशील रहनु पर्छ +3. कोड उदाहरणहरू कार्यशील राख्न सुनिश्चित गर्नुहोस् 4. स्थानीयकृत क्विज सामग्री परीक्षण गर्नुहोस् ### अनुवाद मेटाडाटा -अनुवादित फाइलहरूमा मेटाडाटा हेडर समावेश हुन्छ: +अ अनुवादित फाइलहरूमा मेटाडाटा हेडर समावेश छ: ```markdown **अस्वीकरण**: -यो दस्तावेज 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/pa/.co-op-translator.json b/translations/pa/.co-op-translator.json index 8a6f4af32..82792bb3b 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-06T08:21:01+00:00", + "translation_date": "2026-02-06T11:20:34+00:00", "source_file": "AGENTS.md", "language_code": "pa" }, diff --git a/translations/pa/AGENTS.md b/translations/pa/AGENTS.md index 284969c13..35b41b5c0 100644 --- a/translations/pa/AGENTS.md +++ b/translations/pa/AGENTS.md @@ -1,37 +1,37 @@ # AGENTS.md -## ਪ੍ਰੋਜੈਕਟ ਦਾ ਸਾਰਾਂਸ਼ +## Project Overview -ਇਹ ਸ਼ੁਰੂਆਤੀ ਲਈ ਵੈੱਬ ਵਿਖਾਸ ਮੂਲਭੂਤ ਤੱਤ ਸਿੱਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਿਆਤਮਕ ਪਾਠਕ੍ਰਮ ਰਿਪਾਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਪਾਠਕ੍ਰਮ Microsoft Cloud Advocates ਵਲੋਂ ਵਿਕਸਤ ਕੀਤਾ ਗਿਆ ਇੱਕ ਵਿਸਥਾਰਪੂਰਨ 12-ਹਫਤਿਆਂ ਵਾਲਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ 24 ਹੱਥ-ਅੰਦਾਜ਼ ਲੈਸਨ ਹਨ ਜਿਹਨਾਂ ਵਿੱਚ JavaScript, CSS, ਅਤੇ HTML ਫੀਚਰ ਸ਼ਾਮਿਲ ਹਨ। +ਇਹ ਬਿਗਿਨਰਜ਼ ਲਈ ਵੈੱਬ ਵਿਕਾਸ ਦੀਆਂ ਬੁਨਿਆਦਾਂ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਿਆਤਮਕ ਕਰੀਕੁਲਮ ਰੈਪੋਜ਼ਟਰੀ ਹੈ। ਕਰੀਕੁਲਮ ਮਾਇਕਰੋਸਾਫਟ ਕਲਾਉਡ ਐਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸਿਤ ਇੱਕ ਸਮਗ੍ਰ 12-ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS, ਅਤੇ HTML ਨੂੰ ਕਵਰ ਕਰਨ ਵਾਲੇ 24 ਹੈਂਡ-ਆਨ ਪਾਠ ਸ਼ਾਮਲ ਹਨ। -### ਮੁੱਖ ਅੰਸ਼ +### Key Components -- **ਸਿੱਖਿਆਤਮਕ ਸਮੱਗਰੀ**: 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 ਪ੍ਰੋਜੈਕਟ ਲਈ) +- **ਸਿੱਖਿਆਤਮਕ ਸਮੱਗਰੀ**: 24 ਸੰਰਚਿਤ ਪਾਠ ਪ੍ਰਾਜੈਕਟ-ਆਧਾਰਿਤ ਮੌਡਿਊਲਾਂ ਵਿੱਚ ਵੰਡੇ ਹੋਏ +- **ਵਿਆਵਹਾਰਿਕ ਪ੍ਰਾਜੈਕਟਸ**: ਟੈਰਾਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਨਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ ਏਆਈ ਚੈਟ ਸਹਾਇਕ +- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਪ੍ਰਸ਼ਨ (ਪ੍ਰੀ/ਪੋਸਟ-ਪਾਠ ਮੁਲਾਂਕਣ) +- **ਬਹੁ-ਭਾਸ਼ਾਈ ਸਹਾਇਤਾ**: GitHub ਐਕਸ਼ਨਜ਼ ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਲਈ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ +- **ਟੈਕਨੋਲੋਜੀਜ਼**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (ਏਆਈ ਪ੍ਰਾਜੈਕਟਸ ਲਈ) -### ਢਾਂਚਾ +### Architecture -- ਸਿੱਖਿਆਤਮਕ ਰਿਪਾਜ਼ਿਟਰੀ ਜੋ ਲੈਸਨ-ਆਧਾਰਿਤ ਸੰਰਚਨਾ ਵਾਲੀ ਹੈ -- ਹਰ ਲੈਸਨ ਫੋਲਡਰ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਨਾਂ ਅਤੇ ਹੱਲ ਸ਼ਾਮਿਲ ਹਨ -- ਅਲੱਗ-ਅਲੱਗ ਪ੍ਰੋਜੈਕਟ ਵੱਖਰੇ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ (quiz-app, ਵੱਖ-ਵੱਖ ਲੈਸਨ ਪ੍ਰੋਜੈਕਟ) -- GitHub Actions (co-op-translator) ਵਰਤ ਕੇ ਅਨੁਵਾਦ ਸਿਸਟਮ -- ਡੌਕਸਿਫਾਈ ਦੁਆਰਾ ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਅਤੇ 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 ਸੈਟਅੱਪ (Vue 3 + Vite) +### Quiz App Setup (Vue 3 + Vite) ```bash cd quiz-app @@ -41,7 +41,7 @@ npm run build # ਉਤਪਾਦਨ ਲਈ ਬਣਾਓ npm run lint # ESLint ਚਲਾਓ ``` -### ਬੈਂਕ ਪ੍ਰੋਜੈਕਟ API (Node.js + Express) +### Bank Project API (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,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 ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਕਰੋ ``` -### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਐਂਡ) +### Chat Project (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚੱਲਕ ਨੂੰ ਸੈੱਟ ਕਰੋ +# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ ਵਰ ਬਦਲੋ ਸੈੱਟ ਕਰੋ python api.py ``` -## ਵਿਕਾਸ ਪ੍ਰਕਿਰਿਆ +## Development Workflow -### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਰਤਾਵਾਂ ਲਈ +### For Content Contributors -1. ਆਪਣਾ GitHub ਖਾਤਾ ਖੋਲ੍ਹਕੇ ਰਿਪਾਜ਼ਿਟਰੀ ਫੋਰਕ ਕਰੋ -2. ਆਪਣਾ ਫੋਰਕ ਲੋਕਲੀ ਕਲੋਨ ਕਰੋ -3. ਆਪਣੇ ਬਦਲਾਵਾਂ ਲਈ ਨਵਾਂ ਬ੍ਰਾਂਚ ਬਣਾਓ -4. ਲੈਸਨ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਨਾਂ ਵਿੱਚ ਬਦਲਾਵ ਕਰੋ -5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਕੋਡ ਬਦਲਾਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ -6. ਯੋਗਦਾਨ ਦੇ ਨਿਯਮਾਂ ਦੇ ਅਨੁਸਾਰ ਪੁਲ ਰਿਕਵੈਸਟ ਸਬਮਿਟ ਕਰੋ +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**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ -- **ਪ੍ਰੋਜੈਕਟ**: HTML ਪ੍ਰੋਜੈਕਟ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ -- **API ਪ੍ਰੋਜੈਕਟ**: ਸਬੰਧਤ API ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm start` ਚਲਾਓ +- **ਡਾਕਯੂਮੇਂਟੇਸ਼ਨ**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000) +- **ਕਵਿਜ਼ ਐਪ**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ +- **ਪ੍ਰਾਜੈਕਟਸ**: HTML ਪ੍ਰਾਜੈਕਟਸ ਲਈ VS ਕੋਡ ਲਾਈਵ ਸਰਵਰ ਐਕਸਟੈਂਸ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰੋ +- **API ਪ੍ਰਾਜੈਕਟਸ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm start` ਚਲਾਓ -## ਟੈਸਟਿੰਗ ਸੂਚਨਾਵਾਂ +## Testing Instructions -### Quiz App ਟੈਸਟਿੰਗ +### Quiz App Testing ```bash cd quiz-app -npm run lint # ਕੋਡ ਸਟਾਈਲ ਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਲਈ ਚੈਕ ਕਰੋ -npm run build # ਬਣਾਉਣ ਸਫਲ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ +npm run lint # ਕੋਡ ਸਟਾਈਲ ਮਸਲਿਆਂ ਦੀ ਜਾਂਚ ਕਰੋ +npm run build # ਬਣਤਰ ਸਫਲ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ ``` -### ਬੈਂਕ API ਟੈਸਟਿੰਗ +### Bank API Testing ```bash cd 7-bank-project/api -npm run lint # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਲਈ ਚੈਕ ਕਰੋ -node server.js # ਸਰਵਰ ਨੂੰ ਬਿਨਾਂ ਕਿਸੇ ਗਲਤੀ ਦੇ ਚਾਲੂ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ +npm run lint # ਕੋਡ ਸਟਾਈਲ ਦੀਆਂ ਸਮੱਸਿਆਵਾਂ ਚੈਕ ਕਰੋ +node server.js # ਸਰਵਰ ਦੀ ਬਿਨਾਂ ਗਲਤੀਆਂ ਸ਼ੁਰੂਆਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ ``` -### ਆਮ ਟੈਸਟਿੰਗ ਤਰੀਕਾ +### General Testing Approach -- ਇਹ ਇਕ ਸਿੱਖਿਆਤਮਕ ਰਿਪਾਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਭਰਪੂਰ ਸਵੈਚਾਲਿਤ ਟੈਸਟ ਨਹੀਂ ਹਨ -- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ 'ਤੇ ਧਿਆਨ: - - ਕੋਡ ਉਦਾਹਰਨਾਂ ਤੋਂ ਬਿਨਾਂ ਗਲਤੀ ਚਲ ਰਹੀਆਂ ਹੋਣ - - ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰ ਰਹੇ ਹੋਣ - - ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲ ਹੋ ਰਹੇ ਹੋਣ - - ਉਦਾਹਰਨਾਂ ਵਧੀਆ ਅਮਲਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦੀਆਂ ਹੋਣ +- ਇਹ ਸਿੱਖਿਆਤਮਕ ਰੈਪੋਜ਼ਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੇਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ +- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ ਫੋਕਸ: + - ਕੋਡ ਉਦਾਹਰਨ ਬਿਨਾਂ ਗਲਤੀ ਚੱਲਣ + - ਡਾਕਯੂਮੈਂਟੇਸ਼ਨ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਨ + - ਪ੍ਰਾਜੈਕਟ ਦੀ ਸਫਲ ਬਣਾਵਟ + - ਉਦਾਹਰਨਾਂ ਵਧੀਆ ਅਮਲਾਂ ਦੇ ਅਨੁਸਾਰ ਹੋਣ -### ਪੇਸ਼ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਜਾਂਚ +### Pre-submission Checks -- ਜਿੱਥੇ package.json ਹੈ ਉਹਨਾਂ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ -- ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਮਾਨਯੋਗ ਹਨ ਇਹ ਪਰਖੋ -- ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਨਾਂ ਦੀ ਜਾਂਚ ਕਰੋ -- ਅਨੁਵਾਦ ਸਹੀ ਸੰਰਚਨਾ ਬਣਾਈ ਰੱਖਦੇ ਹਨ ਇਹ ਯਕੀਨੀ ਬਣਾਓ +- ਜਿੱਥੇ package.json ਹੈ, ਉਥੇ `npm run lint` ਚਲਾਓ +- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸਹੀਤਾ ਜਾਂਚੋ +- ਕੋਡ ਉਦਾਹਰਨ ਬ੍ਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ +- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਅਨੁਵਾਦ ਸਹੀ ਸੰਰਚਨਾ ਰੱਖਦੇ ਹਨ -## ਕੋਡ ਸਟਾਈਲ ਮਾਰਗਦਰਸ਼ਨ +## Code Style Guidelines ### JavaScript -- ਆਧੁਨਿਕ ES6+ ਸਿੰਟੈਕਸ ਵਰਤੋ -- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਕਨਫਿਗਰੇਸ਼ਨ ਦੀ ਪਾਲਣਾ ਕਰੋ -- ਸਿੱਖਿਆ ਲਈ ਮਾਯਨੇਦਾਰ ਵੈਰੀਏਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋ -- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਿਲ ਕਰੋ -- ਜਿੱਥੇ ਪ੍ਰੀਟੀਅਰ ਕਨਫਿਗਰ ਹੈ ਉਥੇ ਕੋਡ ਫਾਰਮੈਟਿੰਗ ਵਰਤੋਂ +- ਆਧੁਨਿਕ ES6+ ਸੰਟੈਕਸ ਦੀ ਵਰਤੋਂ ਕਰੋ +- ਪ੍ਰਾਜੈਕਟਸ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਸੈਟਿੰਗਜ਼ ਫਾਲੋ ਕਰੋ +- ਸਿੱਖਿਆ ਲਈ ਸਮਝਣਯੋਗ ਵੇਰੀਏਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋ +- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਾਤਮਕ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਲ ਕਰੋ +- ਜਿੱਥੇ ਸੰਰਚਿਤ, Prettier ਵਰਤ ਕੇ ਕੋਡ ਫਾਰਮੈਟ ਕਰੋ ### HTML/CSS -- ਸੈਂਟੈਕਟਿਕ HTML5 ਐਲੀਮੈਂਟ -- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਈਨ ਪ੍ਰਿੰਸੀਪਲ -- ਸੁੱਚੇ ਕਲਾਸ ਨਾਮਕਰਨ -- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ CSS ਤਕਨੀਕਾਂ ਦੀ ਟਿੱਪਣੀ +- ਸੈਮਾਂਟੀਕ HTML5 ਤੱਤ +- ਪ੍ਰਤਿਕ੍ਰਿਆਸ਼ੀਲ ਡਿਜ਼ਾਈਨ ਮੁਢਲੀ ਵਿਧੀ +- ਸਾਫ ਸਪਸ਼ਟ CSS ਕਲਾਸ ਨਾਮਕਰਨ +- CSS ਤਕਨੀਕਾਂ ਲਈ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ ### Python -- PEP 8 ਸਟਾਈਲ ਮਾਰਗਦਰਸ਼ਨ -- ਸਾਫ਼, ਸਿੱਖਿਆਤਮਕ ਕੋਡ ਉਦਾਹਰਨ -- ਸਿੱਖਣ ਲਈ ਲਾਭਕਾਰੀ ਟਾਈਪ ਹਿੰਟਸ +- PEP 8 ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ +- ਸਪਸ਼ਟ, ਸਿੱਖਿਆਤਮਕ ਕੋਡ ਉਦਾਹਰਨ +- ਜਿੱਥੇ ਸਹਾਇਕ, ਟਾਈਪ ਹਿੰਟਸ -### MarkDown ਡੌਕੂਮੈਂਟੇਸ਼ਨ +### Markdown Documentation -- ਸਾਫ਼ ਸਿਰਲੇਖ ਦਖਲ -- ਭਾਸ਼ਾ-ਵਿਸ਼ੇਸ਼ਿਤ ਕੋਡ ਬਲਾਕ -- ਵਾਧੂ ਸੋਧ ਸਾਧਨਾਂ ਲਈ ਲਿੰਕ -- `images/` ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਸਕਰੀਨਸ਼ਾਟ ਅਤੇ ਤਸਵੀਰਾਂ -- ਤਸਵੀਰਾਂ ਲਈ ਐਲਟ ਟੈਕਸਟ ਸਹਾਇਤਾ ਲਈ +- ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ +- ਭਾਸ਼ਾ-specification ਵਾਲੇ ਕੋਡ ਬਲਾਕ +- ਵਧੀਕ ਸਾਂਧਰਭ ਲਈ ਲਿੰਕ +- `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 ਡਿਪਲੋਇਮੈਂਟ (Azure Static Web Apps) +### Quiz App Deployment (Azure Static Web Apps) -quiz-app Azure Static Web Apps ਡਿਪਲੋਇਮੈਂਟ ਲਈ ਕਨਫਿਗਰ ਹੈ: +quiz-app ਅਜੂਰ ਸਟੈਟਿਕ ਵੈੱਬ ਐਪਸ ਡਿਪਲੋਇਮੈਂਟ ਲਈ ਕਨਫਿਗਰਡ ਹੈ: ```bash cd quiz-app npm run build # dist/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ -# ਮੱਖੀ ਸਥਿਤੀ ਵੱਲ ਧੱਕਣ 'ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਤਾਇਨਾਤ ਕਰਦਾ ਹੈ +# ਮukh push ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੋਏ ਕਰਦਾ ਹੈ ``` -Azure Static Web Apps ਕਨਫਿਗਰੇਸ਼ਨ: -- **ਐਪ ਸਥਾਨ**: `/quiz-app` -- **ਆਉਟਪੁੱਟ ਸਥਾਨ**: `dist` +ਅਜੂਰ ਸਟੈਟਿਕ ਵੈੱਬ ਐਪਸ ਕਨਫਿਗਰੇਸ਼ਨ: +- **ਐਪ locatie**: `/quiz-app` +- **ਆਉਟਪੁੱਟ locatie**: `dist` - **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ PDF ਬਣਾਉਣਾ +### Documentation PDF Generation ```bash -npm install # docsify-to-pdf ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ -npm run convert # ਡੌਕਸ ਤੋਂ PDF ਬਣਾਓ +npm install # docsify-to-pdf ਸਥਾਪਤ ਕਰੋ +npm run convert # docs ਤੋਂ PDF ਬਣਾਓ ``` -### Docsify ਡੌਕਯੂਮੈਂਟੇਸ਼ਨ +### Docsify Documentation ```bash -npm install -g docsify-cli # ਡਾਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ -docsify serve # ਲੋਕਲਹੋਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ +npm install -g docsify-cli # ਡੌਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ +docsify serve # ਲੋਕਲਹੋਸਟ:3000 ‘ਤੇ ਸਰਵ ਕਰੋ ``` -### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ +### Project-specific Builds -ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ: -- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ -- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਚਰਨ ਨਹੀਂ, ਫਾਈਲਾਂ ਸਿੱਧਾ ਸਰਵ ਕੀਤਾ ਜਾਂਦਾ ਹੈ +ਹਰ ਇੱਕ ਪ੍ਰਾਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ: +- Vue ਪ੍ਰਾਜੈਕਟ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ +- ਸਟੈਟਿਕ ਪ੍ਰਾਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਸਟੈਪ ਨਹੀਂ, ਸਿੱਧੇ ਫਾਈਲਾਂ ਸਰਵ ਕਰਨ -## ਪੁਲ ਰਿਕਵੈਸਟ ਮਾਰਗਦਰਸ਼ਨ +## Pull Request Guidelines -### ਸਿਰਲੇਖ ਫ਼ਾਰਮੈਟ +### Title Format -ਸਪਸ਼ਟ ਅਤੇ ਵੇਰਵਾ ਦਿੰਦੇ ਸਿਰਲੇਖ ਜੋ ਬਦਲਾਅ ਖੇਤਰ ਦੱਸਦੇ ਹਨ: -- `[Quiz-app] ਨਵਾਂ ਕਵੀਜ਼ ਲੈਸਨ X ਲਈ ਸ਼ਾਮਿਲ ਕਰੋ` -- `[Lesson-3] terrarium ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਟਾਈਪੋ ਠੀਕ ਕਰੋ` -- `[Translation] ਲੈਸਨ 5 ਲਈ ਸਪੇਨੀ ਅਨੁਵਾਦ ਸ਼ਾਮਿਲ ਕਰੋ` +ਸਪਸ਼ਟ ਅਤੇ ਵੇਰਵਾ ਵਾਲੇ ਸਿਰਲੇਖ ਵਰਤੋਂ ਜੋ ਬਦਲਾਅ ਅੰਤਰਗਤ ਖੇਤਰ ਦਰਸਾਉਂਦੇ ਹਨ: +- `[Quiz-app] ਲੈਸਨ X ਲਈ ਨਵਾਂ ਕਵਿਜ਼ ਸ਼ਾਮਲ ਕਰੋ` +- `[Lesson-3] ਟੈਰਾਰਿਯਮ ਪ੍ਰਾਜੈਕਟ ਵਿੱਚ ਟਾਇਪੋ ਠੀਕ ਕਰੋ` +- `[Translation] ਲੈਸਨ 5 ਲਈ ਸਪੈਨਿਸ਼ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰੋ` - `[Docs] ਸੈਟਅੱਪ ਨਿਰਦੇਸ਼ ਅੱਪਡੇਟ ਕਰੋ` -### ਜ਼ਰੂਰੀ ਜਾਂਚ +### Required Checks -ਪੁਲ ਰਿਕਵੈਸਟ ਸਬਮਿਟ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ: +ਪੂਲ ਰਿਕਵੇਸਟ ਵਿੱਚ ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ: -1. **ਕੋਡ ਗੁਣਵੱਤਾ**: - - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ +1. **ਕੋਡ ਕੁਆਲਿਟੀ**: + - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰਾਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run lint` ਚਲਾਓ - ਸਾਰੇ ਲਿੰਟਿੰਗ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀਆਂ ਠੀਕ ਕਰੋ -2. **ਬਿਲਡ ਜਾਂਚ**: +2. **ਬਿਲਡ ਵੈਰੀਫਿਕੇਸ਼ਨ**: - ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ - - ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਾ ਹੋਵੇ ਇਹ ਯਕੀਨੀ ਬਣਾਓ + - ਕੋਈ ਬਿਲਡ ਗਲਤੀਆਂ ਨਾ ਹੋਣ -3. **ਲਿੰਕ ਪਰਖ**: +3. **ਲਿੰਕ ਵੈਰੀਫਿਕੇਸ਼ਨ**: - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ - - ਤਸਵੀਰ ਰੇਫਰੰਸ ਕੰਮ ਕਰਦੇ ਹਨ ਇਹ ਵੇਰੋ + - ਚਿੱਤਰ ਸੰਦਰਭ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹਨ ਇਸ ਦੀ ਜਾਂਚ ਕਰੋ 4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**: - - ਟਾਈਪਿੰਗ ਅਤੇ ਵਿਅਾਕਰਨ ਲਈ ਪ੍ਰਮਾਣਿਤ ਕਰੋ - - ਕੋਡ ਉਦਾਹਰਨ ਸਹੀ ਅਤੇ ਸਿੱਖਣਯੋਗ ਹਨ ਇਹ ਵੇਰੋ - - ਅਨੁਵਾਦ ਮੂਲ ਅਰਥ ਬਣਾਈ ਰੱਖਦੇ ਹਨ + - ਸਪੈਲਿੰਗ ਅਤੇ ਗ੍ਰੈਮਰ ਦੀ ਜਾਂਚ ਕਰੋ + - ਕੋਡ ਉਦਾਹਰਨ ਸਹੀ ਅਤੇ ਸਿੱਖਣ ਯੋਗ ਹੋਣ + - ਅਨੁਵਾਦ ਮੁਢਲਾ ਅਰਥ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹੋਣ -### ਯੋਗਦਾਨ ਦੇ ਲੋੜਾਂ +### Contribution Requirements -- Microsoft CLA (ਪਹਿਲੀ PR 'ਤੇ ਸਵੈਚਾਲਿਤ ਜਾਂਚ) -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਨੂੰ ਮੰਨੋ -- ਵਿਸਥਾਰ ਵਿੱਚ ਨਿਰਦੇਸ਼ਾਂ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ -- PR ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਦੀ ਸੰਖਿਆ ਦਰਜ ਕਰੋ ਜੇ ਲਾਗੂ ਹੈ +- Microsoft CLA ਨਾਲ ਸਹਿਮਤ ਹੋਵੋ (ਪਹਿਲੀ PR 'ਤੇ ਆਟੋਮੈਟਿਕ ਚੈਕ) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ +- ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਦੇਖੋ +- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਸਮੱਸਿਆ ਨੰਬਰ ਦਰਜ ਕਰੋ -### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ +### Review Process -- PR Maintainers ਅਤੇ ਕਮਿਊਨਿਟੀ ਵਲੋਂ ਸਮੀਖਿਆ ਕੀਤੇ ਜਾਂਦੇ ਹਨ -- ਸਿੱਖਣ ਦੀ ਸਪਸ਼ਟਤਾ ਤਰਜੀਹੀ ਹੈ -- ਕੋਡ ਉਦਾਹਰਨ ਮੌਜੂਦਾ ਵਧੀਆ ਅਮਲਾਂ ਦਾ ਪਾਲਣ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ -- ਅਨੁਵਾਦ ਸਹੀਤਾ ਅਤੇ ਸੱਭਿਆਚਾਰਕ ਯੋਗਤਾ ਲਈ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ +- PR ਦੀ ਸਮੀਖਿਆ ਮੇਨਟੇਨੇਰ ਅਤੇ ਕਮਿਊਨਿਟੀ ਕਰਦੀ ਹੈ +- ਸਿੱਖਿਆਤਮਕ ਸਪਸ਼ਟਤਾ ਨੂੰ ਤਰਜੀਹ +- ਕੋਡ ਉਦਾਹਰਨ ਅੱਜ ਦੀਆਂ ਵਧੀਆਂ ਪ੍ਰਣਾਲੀਆਂ ਨੂੰ ਮੰਨਣਗੇ +- ਅਨੁਵਾਦ ਸਹੀਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਯੋਗਤਾ ਲਈ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ -## ਅਨੁਵਾਦ ਸਿਸਟਮ +## Translation System -### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ +### Automated Translation -- GitHub Actions ਨਾਲ 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. ਅਦਾਏਗੀ ਜ਼ਰੂਰੀ localized quiz ਸਮੱਗਰੀ ਜਾਂਚੋ +2. ਸਾਂਚਾ ਬਰਕਰਾਰ ਰੱਖਦਿਆਂ ਸੁਧਾਰ ਕਰੋ +3. ਕੋਡ ਉਦਾਹਰਨ ਸੰਚਾਲਿਤ ਰਹਿਣ ਤਾਂ ਕਿ ਕੋਡ ਕੰਮ ਕਰਦਾ ਰਹੇ +4. ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਦੀ ਜਾਂਚ ਕਰੋ -### ਅਨੁਵਾਦ Metadata +### Translation Metadata -ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਈਲਾਂ ਵਿੱਚ ਮੈਟਾਡੇਟਾ ਸਿਰਲੇਖ ਸ਼ਾਮਿਲ ਹੁੰਦਾ ਹੈ: +ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਈਲਾਂ ਵਿੱਚ ਮੈਟਾਡੇਟਾ ਹੈਡਰ ਸ਼ਾਮਲ ਹੈ: ```markdown ``` -## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆ ਦਾ ਹੱਲ +## Debugging and Troubleshooting -### ਆਮ ਸਮੱਸਿਆਵਾਂ +### Common Issues -**Quiz app ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**: -- 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` ਨਾਲ ਇੰਸਟਾਲ ਹੋਏ ਹਨ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ -**Browser Extension ਲੋਡ ਨਹੀਂ ਹੁੰਦਾ**: -- manifest.json ਸਹੀ ਫਾਰਮੈਟ ਵਾਲਾ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ ਜਾਂਚੋ -- ਬ੍ਰਾਊਜ਼ਰ ਕਨਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਵੇਖੋ -- ਬ੍ਰਾਊਜ਼ਰ ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਨਿਰਦੇਸ਼ ਪਾਲਣ ਕਰੋ +**ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਨਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**: +- manifest.json ਸਹੀ ਫਾਰਮੈਟ ਵਿੱਚ ਹੈ ਯਕੀਨ ਕਰੋ +- ਬ੍ਰਾਊਜ਼ਰ ਕੰਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਚੈੱਕ ਕਰੋ +- ਬ੍ਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ -**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**: +**ਪਾਇਥਨ ਚੈਟ ਪ੍ਰਾਜੈਕਟ ਦਿੱਕਤਾਂ**: - OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai` -- GITHUB_TOKEN’environnement variable ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ ਇਹ ਵੇਖੋ -- GitHub ਮਾਡਲਾਂ ਦੀ ਪਹੁੰਚ ਜਾਂਚੋ +- 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` ਮੌਜੂਦ ਹੈ -### ਵਿਕਾਸ ਮਾਹੌਲ ਲਈ ਸੁਝਾਅ +### Development Environment Tips -- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਵਿੱਚ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ -- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨ ਚੰਗੀ ਫਾਰਮੈਟਿੰਗ ਲਈ ਇੰਸਟਾਲ ਕਰੋ -- ਜਾਵਾਸਕ੍ਰਿਪਟ ਲਈ ਬ੍ਰਾਊਜ਼ਰ DevTools ਵਰਤੋਂ ਡੀਬੱਗਿੰਗ ਲਈ -- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ Vue DevTools ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ +- HTML ਪ੍ਰਾਜੈਕਟਸ ਲਈ VS ਕੋਡ ਲਾਈਵ ਸਰਵਰ ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ +- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ ਤਾਕਿ ਕੋਡ ਫਾਰਮੈਟ ਸਥਿਰ ਰਹੇ +- ਜਾਵਾਸਕ੍ਰਿਪਟ ਡਿਬੱਗਿੰਗ ਲਈ ਬ੍ਰਾਊਜ਼ਰ ਡਿਵਟੂਲਜ਼ ਦੀ ਵਰਤੋਂ ਕਰੋ +- Vue ਪ੍ਰਾਜੈਕਟਸ ਲਈ Vue DevTools ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ -### ਪ੍ਰਦਰਸ਼ਨ ਵਿਚਾਰ +### Performance Considerations -- ਬਹੁਤ ਸਾਰੀਆਂ ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਮੂਲ ਕਲੋਨ ਵੱਡਾ ਕਰਦੀਆਂ ਹਨ -- ਸਿਰਫ਼ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰਨ ਲਈ shallow clone ਵਰਤੋਂ: `git clone --depth 1` -- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਚ ਕੰਮ ਕਰਨ ਵੇਲੇ ਅਨੁਵਾਦ ਖੋਜ ਤੋਂ ਬਾਹਰ ਹੋਣ -- npm install, Vite build ਪਹਿਲੀ ਵਾਰੀ ਸਲੋ ਹੋ ਸਕਦੇ ਹਨ +- ਬਹੁਤ ਸਾਰੀਆਂ ਅਨੁਵਾਦੀਤ ਫਾਈਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਸੰਪੂਰਨ ਕਲੋਨ ਵੱਡਾ ਹੁੰਦਾ ਹੈ +- ਸਿਰਫ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰਨ ਲਈ shallow clone ਵਰਤੋ: `git clone --depth 1` +- ਅੰਗ੍ਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ +- ਪਹਿਲੀ ਵਾਰ ਚੱਲਾਉਂਦੇ ਸਮੇਂ npm install ਅਤੇ Vite build ਥੋੜ੍ਹਾ ਹੌਲੀ ਹੋ ਸਕਦੇ ਹਨ -## ਸੁਰੱਖਿਆ ਵਿਚਾਰ +## Security Considerations -### ماحول ਵੈਰੀਏਬਲ +### Environment Variables -- API keys ਕਦੇ ਵੀ ਰਿਪਾਜ਼ਿਟਰੀ ਵਿੱਚ ਨਾ ਜੋੜੋ -- `.env` ਫਾਈਲਾਂ ਵਰਤੋਂ (ਜੋ ਪਹਿਲਾਂ ਹੀ `.gitignore` ਵਿੱਚ ਹਨ) -- ਪ੍ਰੋਜੈਕਟਾਂ ਦੇ README ਵਿੱਚ ਲੋੜੀਂਦੇ environment variables ਦਰਜ ਕਰੋ +- API keys ਕਦੇ ਵੀ ਰੈਪੋਜ਼ਟਰੀ 'ਚ ਕਮਿਟ ਨਾ ਕਰੋ +- `.env` ਫਾਈਲਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ (ਜੋ `.gitignore` ਵਿੱਚ ਹਨ) +- ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਭੈਰੀਅਬਲ ਪ੍ਰਾਜੈਕਟ README ਵਿੱਚ ਦਸਤਾਵੇਜ਼ ਕਰੋ -### Python ਪ੍ਰੋਜੈਕਟ +### Python Projects -- ਵਰਚੁਅਲ ਐਨਵਾਇਰਨਮੈਂਟ ਬਣਾਓ: `python -m venv venv` -- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨੂੰ ਅੱਪਡੇਟ ਰੱਖੋ -- GitHub ਟੋਕਨ ਘੱਟ ਤੋਂ ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰਾਂ ਵਾਲੇ ਹੋਣ +- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਦੀ ਵਰਤੋਂ: `python -m venv venv` +- ਨਿਰਭਰਤਾ ਆਪਡੇਟ ਰੱਖੋ +- GitHub ਟੋਕਨਜ਼ 'ਚ ਘੱਟੋ-ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰ ਹੋਣ -### GitHub ਮਾਡਲ ਪਹੁੰਚ +### GitHub Models Access -- ਵਿਅਕਤੀਗਤ ਪਹੁੰਚ ਟੋਕਨ (PAT) ਲੋੜੀਦੇ ਹਨ -- ਟੋਕਨਾਂ ਨੂੰ environment ਵੈਰੀਏਬਲ ਵਜੋਂ ਸਟੋਰ ਕਰੋ -- ਕਦੇ ਵੀ ਟੋਕਨ ਜਾਂ ਸਰਟੀਫਿਕੇਟ ਸਬਮਿਟ ਨਾ ਕਰੋ +- GitHub ਮਾਡਲਜ਼ ਲਈ Personal Access Tokens (PAT) ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ +- ਟੋਕਨਜ਼ ਨੂੰ ਵਾਤਾਵਰਣ ਭੈਰੀਅਬਲ ਵਜੋਂ ਸਟੋਰ ਕਰੋ +- ਕਦੇ ਵੀ ਟੋਕਨ ਜਾਂ ਪਾਸਵਰਡ ਕਮਿਟ ਨਾ ਕਰੋ -## ਵਾਧੂ ਨੋਟਸ +## Additional Notes -### ਲਕੜੀ ਦਰਸ਼ਕ +### Target Audience -- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਨਾ ਜਾਣਦੇ ਨਵੇਂ ਸਿੱਖਣ ਵਾਲੇ -- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ-ਸਿੱਖਣ ਵਾਲੇ -- ਕਲਾਸਰੂਮਾਂ ਵਿੱਚ ਅਧਿਆਪਕ ਜੋ ਪਾਠਕ੍ਰਮ ਵਰਤਦੇ ਹਨ -- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਕਦਮ-ਬਦ-ਕਦਮ ਨਿਪੁੰਨਤਾ ਲਈ ਬਨਾਈ ਗਈ ਹੈ +- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਬਿਲਕੁਲ ਨਵੇਂ +- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ +- ਕਲਾਸਰੂਮ ਵਿੱਚ ਕਰੀਕੁਲਮ ਵਰਤਣ ਵਾਲੇ ਅਧਿਆਪਕ +- ਸਿਹਤਮੰਦ ਪਹੁੰਚ ਅਤੇ ਧੀਰੇ-ਧੀਰੇ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਬਣਾਇਆ ਗਿਆ ਸਮੱਗਰੀ -### ਸਿੱਖਿਆਤਮਕ ਦਾਰਸ਼ਨਿਕਤਾ +### Educational Philosophy -- ਪ੍ਰੋਜੈਕਟ ਆਧਾਰਿਤ ਸਿੱਖਣ ਦਾ ਤਰੀਕਾ -- ਬਾਰੰਬਾਰ ਗਿਆਨ ਜਾਂਚ (ਕਵੀਜ਼) -- ਹੱਥੋਂ-ਹੱਥ ਕોડਿੰਗ ਅਭਿਆਸ -- ਹਕੀਕਤੀ ਦੁਨੀਆਂ ਦੇ ਅਰਜ਼ੀ ਉਦਾਹਰਨ -- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਤੱਤਾਂ 'ਤੇ ਧਿਆਨ +- ਪ੍ਰਾਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣਾ +- ਨਿਯਮਤ ਗਿਆਨ ਸੰਭਾਲ (ਕਵਿਜ਼) +- ਹੈਂਡ-ਆਨ ਕੋਡਿੰਗ ਅਭਿਆਸ +- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦੇਸ਼ਾਂ ਦੇ ਉਦਾਹਰਨ +- ਫਰੇਮਵਰਕ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਗੱਲਾਂ ਉੱਤੇ ਧਿਆਨ -### ਰਿਪਾਜ਼ਿਟਰੀ ਸੰਭਾਲ +### Repository Maintenance -- ਕਮਿਊਨਿਟੀ ਦੀ ਸਰਗਰਮ ਸਦੱਸਤਾ -- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦਾ ਨਿਯਮਤ ਅੱਪਡੇਟ -- ਸਮੱਸਿਆਵਾਂ ਅਤੇ ਵਿਚਾਰ-ਵਟਾਂਦਰੇ ਦਾ ਮੋਨਿਟਰਿੰਗ -- ਅਨੁਵਾਦ ਅਪਡੇਟ GitHub Actions ਦੁਆਰਾ ਸਵੈਚਾਲਿਤ +- ਸਖਤ ਪਰਿਵਾਰ ਵਾਲੀ ਕਮਿਊਨਿਟੀ +- ਨਿਰਭਰਤਾ ਅਤੇ ਸਮੱਗਰੀ ਵਿੱਚ ਨਿਯਮਤ ਅੱਪਡੇਟ +- ਮੇਨਟੇਨੇਰਾਂ ਦੁਆਰਾ ਮੁੱਦੇ ਅਤੇ ਚਰਚਾਂ ਦੀ ਸੈਰ +- 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) ਦੀ ਸਿਫ਼ਾਰਸ਼ -- ਹੋਰ ਕੋਰਸ: Generative AI, Data Science, ML, IoT ਪਾਠਕ੍ਰਮ ਉਪਲਬਧ +- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਦੀ ਸਿਫਾਰਸ਼ +- ਵਾਧੂ ਕੋਰਸ: ਜਨਰੇਟਿਵ ਏਆਈ, ਡੇਟਾ ਸਾਇੰਸ, ਐਮਐਲ, ਆਈਓਟੀ ਕਰੀਕੁਲਮ ਉਪਲਬਧ -### ਖਾਸ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ ਕਰਨਾ +### Working with Specific Projects -ਵਿਅਕਤੀਗਤ ਪ੍ਰੋਜੈਕਟ ਲਈ ਵਿਸਥਾਰ ਵਿੱਚ ਨਿਰਦੇਸ਼ਾਂ ਵਾਸਤੇ README ਫਾਈਲਾਂ ਵਿੱਚ ਦੇਖੋ: -- `quiz-app/README.md` - Vue 3 ਕਵੀਜ਼ ਐਪ -- `7-bank-project/README.md` - ਬੈਂਕਿੰਗ ਐਪਲਿਕੇਸ਼ਨ ਅਥੈਂਟਿਕੇਸ਼ਨ ਸਮੇਤ +ਵਿਸ਼ੇਸ਼ ਪ੍ਰਾਜੈਕਟਸ 'ਤੇ ਵਿਸਥਾਰ ਲਈ README ਫਾਈਲਾਂ ਦਾ ਸੰਦਰਭ ਲਓ: +- `quiz-app/README.md` - Vue 3 ਕਵਿਜ਼ ਐਪਲੀਕੇਸ਼ਨ +- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪਲੀਕੇਸ਼ਨ - `5-browser-extension/README.md` - ਬ੍ਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ -- `6-space-game/README.md` - ਕੈਨਵਾਸ-ਆਧਾਰਿਤ ਗੇਮ ਵਿਕਾਸ -- `9-chat-project/README.md` - AI ਚੈਟ ਸਹਾਇਕ ਪ੍ਰੋਜੈਕਟ +- `6-space-game/README.md` - ਕੈਨਵਾਸ-ਅਧਾਰਿਤ ਗੇਮ ਵਿਕਾਸ +- `9-chat-project/README.md` - ਏਆਈ ਚੈਟ ਸਹਾਇਕ ਪ੍ਰਾਜੈਕਟ -### Monorepo ਸੰਰਚਨਾ +### Monorepo Structure -ਇਹ ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਤਾਂ ਨਹੀਂ ਹੈ, ਪਰ ਇੱਕੀ ਸੰਗ੍ਰਹਿ ਵਿੱਚ ਬਹੁਤ ਸਾਰੇ ਸਵਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ: -- ਹਰ ਲੈਸਨ ਖੁਦ-ਮੁਖਤਾਰ ਹੈ -- ਪ੍ਰੋਜੈਕਟ ਸਾਂਝੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨਹੀਂ ਰੱਖਦੇ -- ਵਿਅਕਤੀਗਤ ਪ੍ਰੋਜੈਕਟਾਂ 'ਤੇ ਅਸਰ ਨਾ ਪਾਏਂ ਬਿਨਾ ਕੰਮ ਕਰੋ -- ਪੂਰਾ ਪਾਠਕ੍ਰਮ ਅਨੁਭਵ ਲਈ ਪੂਰਾ ਰਿਪਾਜ਼ਿਟਰੀ ਕਲੋਨ ਕਰੋ +ਇਹ ਪ੍ਰੰਪਰਾ ਵਾਲਾ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ, ਪਰ ਇਸ ਰੈਪੋਜ਼ਟਰੀ ਵਿੱਚ ਕਈ ਸਵਤੰਤਰ ਪ੍ਰਾਜੈਕਟ ਹਨ: +- ਹਰ ਪਾਠ ਸਵਤੰਤਰ ਹੈ +- ਪ੍ਰਾਜੈਕਟਸ ਨਿਰਭਰਤਾਵਾਂ ਸਾਂਝੀਆਂ ਨਹੀਂ ਕਰਦੇ +- ਇਕੱਲੇ ਪ੍ਰਾਜੈਕਟਾਂ 'ਤੇ ਕੰਮ ਕਰੋ ਬਿਨਾ ਹੋਰਾਂ ਨੂੰ ਪ੍ਰਭਾਵਿਤ ਕੀਤੇ +- ਪੂਰਾ ਕਰੀਕੁਲਮ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰੈਪੋਜ਼ਟਰੀ ਕਲੋਨ ਕਰੋ --- **ਇਨਕਾਰ**: -ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ 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