From c2abd5d5282fd4d0ef2bb4378c15c515ce8386f0 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Mon, 20 Apr 2026 16:37:03 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes) --- translations/bn/.co-op-translator.json | 2 +- translations/bn/AGENTS.md | 350 ++++++++++++------------- translations/mr/.co-op-translator.json | 2 +- translations/mr/AGENTS.md | 326 +++++++++++------------ translations/ne/.co-op-translator.json | 2 +- translations/ne/AGENTS.md | 336 ++++++++++++------------ 6 files changed, 509 insertions(+), 509 deletions(-) diff --git a/translations/bn/.co-op-translator.json b/translations/bn/.co-op-translator.json index c5f063a08..0c23a092f 100644 --- a/translations/bn/.co-op-translator.json +++ b/translations/bn/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-04-06T16:27:20+00:00", + "translation_date": "2026-04-20T16:34:34+00:00", "source_file": "AGENTS.md", "language_code": "bn" }, diff --git a/translations/bn/AGENTS.md b/translations/bn/AGENTS.md index f5986c4a9..8ed0e1a37 100644 --- a/translations/bn/AGENTS.md +++ b/translations/bn/AGENTS.md @@ -1,30 +1,30 @@ # AGENTS.md -## প্রকল্প পরিচিতি +## প্রকল্পের সারসংক্ষেপ -এটি শিক্ষামূলক কারিকুলাম রিপোজিটরি যা নবীনদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয়াবলী শেখানোর জন্য। কারিকুলামটি মাইক্রোসফট ক্লাউড অ্যাডভোকেটদের দ্বারা উন্নত একটি সমগ্র ১২-সপ্তাহের কোর্স, যাতে জাভাস্ক্রিপ্ট, CSS, এবং HTML সম্পর্কিত ২৪টি হ্যান্ডস-অন লেসন রয়েছে। +এটি শিক্ষানবীশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর জন্য একটি শিক্ষামূলক পাঠক্রম রেপোসিটরি। এই পাঠক্রমটি মাইক্রোসফট ক্লাউড অ্যাডভোকেটদের দ্বারা উন্নত একটি ব্যাপক ১২-সপ্তাহের কোর্স, যা জাভাস্ক্রিপ্ট, CSS এবং HTML-এ ২৪টি হাতেকলমে পাঠ নিয়ে গঠিত। ### মূল উপাদানসমূহ -- **শিক্ষামূলক বিষয়বস্তু**: প্রকল্প-ভিত্তিক মডিউলে সংগঠিত ২৪টি কাঠামোবদ্ধ লেসন -- **প্রায়োগিক প্রকল্পসমূহ**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাংকিং অ্যাপ, কোড এডিটর, এবং AI চ্যাট সহকারী -- **ইন্টারেক্টিভ কুইজ**: ৪৮টি কুইজ, প্রতিটির মধ্যে ৩টি প্রশ্ন (পূর্ব/পরে লেসন মূল্যায়ন) -- **বহুভাষিক সমর্থন**: GitHub Actions এর মাধ্যমে ৫০+ ভাষার স্বয়ংক্রিয় অনুবাদ -- **প্রযুক্তিসমূহ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI প্রকল্পের জন্য) +- **শিক্ষামূলক বিষয়বস্তু**: প্রকল্পভিত্তিক মডিউল আকারে সংগঠিত ২৪টি কাঠামোবদ্ধ পাঠ +- **বাস্তব প্রকল্পসমূহ**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাংকিং অ্যাপ, কোড এডিটর, এবং AI চ্যাট সহকারী +- **ইন্টারেক্টিভ কুইজ**: প্রতিটি কুইজে ৩টি প্রশ্নসহ ৪৮টি কুইজ (পাঠের আগে/পরবর্তী মূল্যায়ন) +- **বহুভাষী সমর্থন**: গিটহাব অ্যাকশনের মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ +- **প্রযুক্তি**: HTML, CSS, জাভাস্ক্রিপ্ট, Vue.js 3, Vite, Node.js, Express, পাইথন (AI প্রকল্পের জন্য) -### আর্কিটেকচার +### স্থাপত্য -- লেসন-ভিত্তিক কাঠামো সহ শিক্ষামূলক রিপোজিটরি -- প্রতিটি লেসন ফোল্ডারে README, কোড উদাহরণ, এবং সমাধান থাকে -- আলাদা ডিরেক্টরিগুলিতে স্বতন্ত্র প্রকল্প (quiz-app, বিভিন্ন লেসন প্রকল্প) -- GitHub Actions (co-op-translator) ব্যবহার করে অনুবাদ ব্যবস্থা -- ডকুমেন্টেশন Docsify দ্বারা সরবরাহিত এবং PDF আকারে উপলব্ধ +- পাঠভিত্তিক কাঠামো সহ শিক্ষামূলক রেপোসিটরি +- প্রতিটি পাঠের ফোল্ডারে README, কোড উদাহরণ এবং সমাধান রয়েছে +- স্বতন্ত্র প্রকল্পসমূহ আলাদা ডিরেক্টরিতে (quiz-app, বিভিন্ন পাঠ প্রকল্প) +- গিটহাব অ্যাকশনের মাধ্যমে অনুবাদকরণ ব্যবস্থা (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 # এপিআই সার্ভার শুরু করুন npm run lint # ESLint চালান -npm run format # Prettier দিয়ে ফরম্যাট করুন +npm run format # Prettier দিয়ে ফরম্যাট করুন ``` ### ব্রাউজার এক্সটেনশন প্রকল্পসমূহ @@ -67,51 +67,51 @@ npm install # ব্রাউজারে index.html খুলুন অথবা Live Server ব্যবহার করুন ``` -### চ্যাট প্রকল্প (Python ব্যাকএন্ড) +### চ্যাট প্রকল্প (পাইথন ব্যাকএন্ড) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN পরিবেশ ভেরিয়েবল সেট করুন +# GITHUB_TOKEN পরিবেশ পরিবর্তনশীল সেট করুন python api.py ``` -## ডেভেলপমেন্ট ওয়ার্কফ্লো +## উন্নয়ন কার্যপ্রবাহ -### কনটেন্ট কন্ট্রিবিউটরদের জন্য +### বিষয়বস্তু অবদানকারীদের জন্য -1. **রিপোজিটরি ফর্ক করুন** আপনার GitHub একাউন্টে -2. **আপনার ফর্ক ক্লোন করুন** স্থানীয়ভাবে -3. **নতুন ব্রাঞ্চ তৈরি করুন** আপনার পরিবর্তনগুলোর জন্য -4. লেসন বিষয়বস্তু বা কোড উদাহরণে পরিবর্তন আনুন -5. প্রাসঙ্গিক প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষা করুন -6. অবদান নির্দেশিকা অনুসারে পুল রিকোয়েস্ট সাবমিট করুন +1. **রেপোসিটরি ফর্ক করুন** আপনার গিটহাব অ্যাকাউন্টে +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` রান করুন রুটে (পোর্ট ৩০০০) -- **কুইজ অ্যাপ**: `npm run dev` রান করুন quiz-app ডিরেক্টরিতে +- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০) +- **কুইজ অ্যাপ**: 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 পরীক্ষা @@ -119,81 +119,81 @@ npm run build # বিল্ড সফল হয় কিনা নিশ ```bash cd 7-bank-project/api npm run lint # কোড স্টাইল সমস্যা পরীক্ষা করুন -node server.js # নিরীক্ষণ করুন সার্ভার ত্রুটি ছাড়াই শুরু হয় কিনা +node server.js # সার্ভার ভুল ছাড়া শুরু হয় কিনা যাচাই করুন ``` ### সাধারণ পরীক্ষার পদ্ধতি -- এটি একটি শিক্ষামূলক রিপোজিটরি, বিস্তৃত স্বয়ংক্রিয় পরীক্ষা নেই -- ম্যানুয়াল পরীক্ষায় ফোকাস থাকে: - - কোড উদাহরণগুলো ত্রুটিহীনভাবে চালানো - - ডকুমেন্টেশনের লিঙ্ক সঠিকভাবে কাজ করা +- এটি একটি শিক্ষামূলক রেপোসিটরি যাতে সম্পূর্ণ স্বয়ংক্রিয় পরীক্ষার ব্যবস্থা নেই +- ম্যানুয়াল পরীক্ষা ফোকাস করে: + - কোড উদাহরণগুলি ত্রুটিহীন চালানো + - ডকুমেন্টেশনে লিঙ্কগুলো সঠিক কাজ করা - প্রকল্প বিল্ড সফলভাবে সম্পন্ন হওয়া - - উদাহরণগুলো সেরা প্র্যাকটিস মেনে চলা + - উদাহরণগুলো সর্বোত্তম অনুশীলন অনুসরণ করে -### সাবমিশনের পূর্বে চেকসমূহ +### সাবমিশনের পূর্বে যাচাই -- package.json সহ ডিরেক্টরিতে `npm run lint` চালান -- মার্কডাউন লিঙ্কগুলো বৈধ আছে কিনা যাচাই করুন +- প্যাকেজ.json সহ ডিরেক্টরিতে `npm run lint` চালান +- মার্কডাউন লিঙ্কগুলো বৈধ কিনা পরীক্ষা করুন - ব্রাউজার বা Node.js এ কোড উদাহরণ পরীক্ষা করুন -- অনুবাদগুলো কাঠামো বজায় রেখেছে কিনা দেখুন +- অনুবাদগুলো সঠিক কাঠামো বজায় রাখে কিনা নিশ্চিত করুন -## কোড স্টাইল নির্দেশিকা +## কোড স্টাইল গাইডলাইন -### JavaScript +### জাভাস্ক্রিপ্ট - আধুনিক ES6+ সিনট্যাক্স ব্যবহার করুন -- প্রকল্পের প্রদত্ত মানক ESLint কনফিগারেশন অনুসরণ করুন -- শিক্ষার্থীদের জন্য অর্থপূর্ণ ভেরিয়েবল এবং ফাংশন নাম ব্যবহার করুন -- ধারণা বোঝাতে মন্তব্য যোগ করুন -- Prettier এর মাধ্যমে ফরম্যাটিং করুন, যেখানে কনফিগার করা আছে +- প্রকল্পে প্রদত্ত মানক ESLint কনফিগারেশন অনুসরণ করুন +- শিক্ষার্থীদের জন্য অর্থবহ ভেরিয়েবল এবং ফাংশন নাম ব্যবহার করুন +- ধারণাগুলো ব্যাখ্যা করতে মন্তব্য যোগ করুন +- যেখানে কনফিগার করা আছে Prettier দিয়ে ফরম্যাট করুন ### HTML/CSS - সেমান্টিক HTML5 উপাদান ব্যবহার করুন - প্রতিক্রিয়াশীল ডিজাইন নীতি অনুসরণ করুন -- স্পষ্ট ক্লাস নামকরণ পদ্ধতি ব্যবহার করুন -- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যাকারী মন্তব্য যোগ করুন +- স্পষ্ট ক্লাস নামকরণ পদ্ধতি +- শিক্ষার্থীদের জন্য 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 ডিপ্লয়মেন্টের জন্য কনফিগার করা: +কুইজ-অ্যাপ Azure Static Web Apps ডিপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে: ```bash cd quiz-app npm run build # dist/ ফোল্ডার তৈরি করে -# মূল ব্রাঞ্চে পুশ করার সময় GitHub Actions ওয়ার্কফ্লোর মাধ্যমে ডিপ্লয় করে +# main ব্রাঞ্চে push করার সময় GitHub Actions ওয়ার্কফ্লোর মাধ্যমে ডিপ্লয় করে ``` Azure Static Web Apps কনফিগারেশন: -- **অ্যাপ অবস্থান**: `/quiz-app` -- **আউটপুট অবস্থান**: `dist` +- **অ্যাপ লোকেশন**: `/quiz-app` +- **আউটপুট লোকেশন**: `dist` - **ওয়ার্কফ্লো**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### ডকুমেন্টেশন PDF জেনারেশন +### ডকুমেন্টেশন PDF উৎপাদন ```bash npm install # docsify-to-pdf ইনস্টল করুন @@ -203,80 +203,80 @@ npm run convert # ডক্স থেকে পিডিএফ ত ### Docsify ডকুমেন্টেশন ```bash -npm install -g docsify-cli # গ্লোবালি Docsify ইনস্টল করুন -docsify serve # লোকালহোস্ট:3000 এ পরিষেবা দিন +npm install -g docsify-cli # ডকসিফাই গ্লোবালি ইনস্টল করুন +docsify serve # লোকালহোস্ট:৩০০০ এ সার্ভ করুন ``` ### প্রকল্প-নির্দিষ্ট বিল্ড -প্রত্যেক প্রকল্পের আলাদা বিল্ড প্রক্রিয়া থাকতে পারে: -- Vue প্রকল্প: `npm run build` দিয়ে প্রোডাকশন বান্ডেল তৈরি করা হয় -- স্ট্যাটিক প্রকল্প: বিল্ড স্টেপ নেই, সরাসরি ফাইল পরিবেশন +প্রতিটি প্রকল্প ডিরেক্টরির নিজস্ব বিল্ড প্রক্রিয়া থাকতে পারে: +- Vue প্রকল্প: `npm run build` প্রোডাকশন বান্ডেল তৈরি করে +- স্ট্যাটিক প্রকল্প: কোনো বিল্ড ধাপ নেই, সরাসরি ফাইল পরিবেশন ## পুল রিকোয়েস্ট নির্দেশিকা ### শিরোনামের ফরম্যাট -পরিবর্তনের ক্ষেত্র নির্দেশ করে স্পষ্ট, বর্ণনামূলক শিরোনাম ব্যবহার করুন: -- `[Quiz-app] লেসন X এর জন্য নতুন কুইজ যোগ করুন` -- `[Lesson-3] টেরারিয়াম প্রকল্পের টাইপো ঠিক করুন` -- `[Translation] লেসন ৫ এর স্প্যানিশ অনুবাদ যোগ করুন` +পরিবর্তনের ক্ষেত্র নির্দেশ করে পরিষ্কার, বর্ণনামূলক শিরোনাম ব্যবহার করুন: +- `[Quiz-app] নতুন কুইজ যোগ করুন পাঠ X এর জন্য` +- `[Lesson-3] টেরারিয়াম প্রকল্পে টাইপো সংশোধন` +- `[Translation] পাঠ ৫ এর জন্য স্প্যানিশ অনুবাদ যোগ করুন` - `[Docs] সেটআপ নির্দেশাবলী আপডেট করুন` -### প্রয়োজনীয় চেক +### প্রয়োজনীয় যাচাই -PR সাবমিট করার আগে: +PR জমা দেওয়ার আগে: -1. **কোড কোয়ালিটি**: +1. **কোড মান**: - প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান - - সব লিন্টিং এরর এবং ওয়ার্নিং ঠিক করুন + - সমস্ত লিন্টিং এরর ও সতর্কতা ঠিক করুন 2. **বিল্ড যাচাই**: - প্রযোজ্য হলে `npm run build` চালান - - কোন বিল্ড এরর নেই নিশ্চিত করুন + - কোনো বিল্ড ত্রুটি নেই নিশ্চিত করুন 3. **লিঙ্ক যাচাই**: - - সব মার্কডাউন লিঙ্ক পরীক্ষা করুন - - ছবি রেফারেন্স কাজ করছে কিনা দেখুন + - সকল মার্কডাউন লিঙ্ক পরীক্ষা করুন + - ছবি রেফারেন্স কাজ করছে কিনা নিশ্চিত করুন 4. **বিষয়বস্তু পর্যালোচনা**: - বানান ও ব্যাকরণ যাচাই করুন - - কোড উদাহরণ সঠিক ও শিক্ষামূলক কিনা দেখুন - - অনুবাদ মূল অর্থ বজায় রেখেছে নিশ্চিত করুন + - কোড উদাহরণ সঠিক এবং শিক্ষামূলক কিনা নিশ্চিত করুন + - অনুবাদমূলক অর্থ সঠিক আছে কিনা দেখুন -### অবদানের শর্তাবলী +### অবদানদানের শর্তাবলী - 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 ওয়ার্কফ্লো -- ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ করে +- গিটহাব অ্যাকশনের co-op-translator ওয়ার্কফ্লো ব্যবহার করে +- ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ - মূল ফাইলগুলো প্রধান ডিরেক্টরিতে থাকে -- অনূদিত ফাইল `translations/{language-code}/` ডিরেক্টরিতে থাকে +- অনূদিত ফাইল থাকে `translations/{language-code}/` ডিরেক্টরিতে -### ম্যানুয়াল অনুবাদ উন্নতি যুক্ত করা +### ম্যানুয়াল অনুবাদ উন্নয়ন যোগ করা -1. `translations/{language-code}/` ডিরেক্টরিতে ফাইলটি খুঁজুন -2. কাঠামো বজায় রেখে উন্নতি করুন -3. কোড উদাহরণ কার্যকর থাকবে নিশ্চিত করুন -4. লোকালাইজড কুইজ বিষয়বস্তু পরীক্ষা করুন +1. `translations/{language-code}/` ফোল্ডারে ফাইলটি খুঁজুন +2. কাঠামো বজায় রেখে উন্নয়ন করুন +3. কোড উদাহরণ কার্যকর থাকে কিনা নিশ্চিত করুন +4. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন -### অনুবাদের মেটাডাটা +### অনুবাদ মেটাডেটা -অনূদিত ফাইলগুলিতে মেটাডাটা হেডার থাকে: +অনূদিত ফাইলগুলোতে মেটাডেটা হেডার থাকে: ```markdown ``` -## ডিবাগিং এবং সমস্যার সমাধান +## ডিবাগিং এবং সমস্যা নিরসন ### সাধারণ সমস্যা **কুইজ অ্যাপ শুরু হয় না**: -- Node.js ভার্সন চেক করুন (v14+ সুপারিশকৃত) -- `node_modules` এবং `package-lock.json` মুছে ছাড়ুন, পুনরায় `npm install` চালান -- পোর্ট সংঘর্ষ আছে কিনা দেখুন (ডিফল্ট: Vite 5173 পোর্ট ব্যবহার করে) +- Node.js সংস্করণ পরীক্ষা করুন (v14+ সুপারিশ) +- `node_modules` এবং `package-lock.json` মুছে `npm install` আবার চালান +- পোর্ট সংঘর্ষ আছে কিনা যাচাই করুন (ডিফল্ট: Vite পোর্ট ৫১৭৩ ব্যবহার করে) **API সার্ভার চালু হয় না**: -- Node.js সর্বনিম্ন সংস্করণ (node >=10) নিশ্চিত করুন -- পোর্ট ইতিমধ্যে ব্যবহৃত না হচ্ছে তা যাচাই করুন -- সব নির্ভরশীলতা ইনস্টল হয়েছে কিনা দেখুন (`npm install`) +- Node.js সংস্করণ ন্যূনতম (node >=10) আছে কিনা পরীক্ষা করুন +- পোর্ট ইতিমধ্যে ব্যবহৃত হচ্ছে কিনা দেখুন +- সমস্ত ডিপেনডেন্সি `npm install` দিয়ে ইনস্টল করা আছে কিনা নিশ্চিত করুন **ব্রাউজার এক্সটেনশন লোড হয় না**: -- manifest.json সঠিক ফরম্যাটে আছে কিনা দেখুন -- ব্রাউজার কনসোলের ত্রুটি পরীক্ষা করুন +- manifest.json সঠিক ফরম্যাটে আছে কিনা যাচাই করুন +- ব্রাউজার কনসোলে এরর দেখুন - ব্রাউজার-নির্দিষ্ট এক্সটেনশন ইনস্টলেশন নির্দেশনা অনুসরণ করুন -**Python চ্যাট প্রকল্প সমস্যা**: -- OpenAI প্যাকেজ ইনস্টল আছে কিনা নিশ্চিত করুন: `pip install openai` -- GITHUB_TOKEN পরিবেশ পরিবর্তনশীল সেট আছে কিনা দেখুন -- GitHub Models অ্যাক্সেস পারমিশন যাচাই করুন +**পাইথন চ্যাট প্রকল্প সমস্যা**: +- OpenAI প্যাকেজ ইনস্টল আছে কিনা: `pip install openai` +- GITHUB_TOKEN পরিবেশ ভেরিয়েবল সেট আছে কিনা যাচাই করুন +- গিটহাব মডেল অ্যাক্সেস অনুমতি যাচাই করুন -**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 এক্সটেনশন ইনস্টল করুন -- জাভাস্ক্রিপ্ট ডিবাগিং এর জন্য ব্রাউজার DevTools ব্যবহার করুন +- জাভাস্ক্রিপ্ট ডিবাগিংয়ের জন্য ব্রাউজারের ডেভটুলস ব্যবহার করুন - Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন ### পারফরমেন্স বিবেচনা -- অনূদিত ফাইলের বড় পরিমাণ (৫০+ ভাষা) থাকার কারণে ফোল্ডার ক্লোন বড় হয় -- শুধুমাত্র বিষয়বস্তু নিয়ে কাজ করলে শ্যালো ক্লোন ব্যবহার করুন: `git clone --depth 1` -- ইংরেজি বিষয়বস্তুর ক্ষেত্রে অনুসন্ধান থেকে অনুবাদ বাদ দিন -- প্রথম চালনার সময় বিল্ড ধীর হতে পারে (npm install, Vite build) +- অনুবাদের সংখ্যা বেশি (৫০+ ভাষা) হওয়ায় পুরো ক্লোন বড় হয় +- কেবল বিষয়বস্তুতে কাজ করলে `git clone --depth 1` দিয়ে শ্যালো ক্লোন ব্যবহার করুন +- ইংরেজি বিষয়বস্তু কাজের সময় অনুবাদ ফাইল অনুসন্ধান থেকে বাদ দিন +- প্রথম রান-এ বিল্ড প্রক্রিয়া ধীর হতে পারে (npm install, Vite build) -## সুরক্ষা বিবেচনা +## নিরাপত্তা বিবেচনা -### পরিবেশ পরিবর্তনশীল +### পরিবেশ ভেরিয়েবলসমূহ -- API কী কখনো রিপোজিটরিতে কমিট করবেন না +- API কী কখনো রেপোসিটরিতে কমিট করবেন না - `.env` ফাইল ব্যবহার করুন (যা `.gitignore` এ আছে) -- প্রকল্প README গুলোতে প্রয়োজনীয় পরিবেশ পরিবর্তনশীল ডকুমেন্ট করুন +- প্রকল্প README এ প্রয়োজনীয় পরিবেশ ভেরিয়েবল নথিবদ্ধ করুন -### Python প্রকল্পসমূহ +### পাইথন প্রকল্পসমূহ - ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv` -- নির্ভরশীলতাগুলো আপডেটেড রাখুন -- GitHub টোকেন খুবই সীমিত পারমিশনে রাখা উচিত +- ডিপেনডেন্সিগুলো আপডেট রাখুন +- গিটহাব টোকেনের আধুনিক এবং সর্বনিম্ন প্রয়োজনীয় অনুমতি দিন -### GitHub Models অ্যাক্সেস +### গিটহাব মডেলস অ্যাক্সেস -- GitHub Models এর জন্য Personal Access Tokens (PAT) প্রয়োজন -- টোকেনগুলো পরিবেশ পরিবর্তনশীল হিসেবে সংরক্ষণ করুন -- টোকেন বা ক্রেডেনশিয়াল কখনো কমিট করবেন না +- গিটহাব মডেলসের জন্য ব্যক্তিগত অ্যাক্সেস টোকেন (PAT) প্রয়োজন +- টোকেন পরিবেশ ভেরিয়েবল হিসেবে সংরক্ষণ করুন +- টোকেন বা শংসাপত্র কখনো কমিট করবেন না ## অতিরিক্ত নোট ### লক্ষ্য শ্রোতা -- সম্পূর্ণ নবীনরা যারা ওয়েব ডেভেলপমেন্ট শিখতে চায় -- ছাত্র ও স্বশিক্ষার্থী -- শিক্ষক যারা শ্রেণিকক্ষে কারিকুলাম ব্যবহার করেন -- বিষয়বস্তু এক্সেসিবিলিটি এবং ধাপে ধাপে দক্ষতা গড়ার জন্য ডিজাইন করা হয়েছে +- ওয়েব ডেভেলপমেন্টে সম্পূর্ণ শিক্ষানবীশ +- শিক্ষার্থী এবং স্বশিক্ষণপ্রাপ্ত +- শ্রেণিকক্ষে পাঠক্রম ব্যবহৃত শিক্ষকগণ +- বিষয়বস্তু অ্যাক্সেসিবিলিটি এবং ধাপে ধাপে দক্ষতা বৃদ্ধির জন্য ডিজাইন করা -### শিক্ষাগত দার্শনিকতা +### শিক্ষামূলক দর্শন - প্রকল্পভিত্তিক শেখার পদ্ধতি - নিয়মিত জ্ঞান যাচাই (কুইজ) -- হ্যান্ডস-অন কোডিং অনুশীলন -- বাস্তব জীবনের আবেদন উদাহরণ -- ফ্রেমওয়ার্ক প্রথমে না, মৌলিক বিষয় আগে শেখা +- হাতেকলমে কোডিং অনুশীলন +- বাস্তব জীবনের উদাহরণ +- ফ্রেমওয়ার্কের আগে মৌলিক বিষয়গুলোতে গুরুত্ব -### রিপোজিটরি রক্ষণাবেক্ষণ +### রেপোসিটরি রক্ষণাবেক্ষণ -- সক্রিয় শিক্ষার্থী ও অবদানকারীদের কমিউনিটি -- নির্ভরশীলতা ও বিষয়বস্তু নিয়মিত আপডেট -- রক্ষণাবেক্ষক দ্বারা ইস্যু ও আলোচনা মনিটর করা হয় -- অনুবাদ আপডেট স্বয়ংক্রিয়ভাবে 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 কারিকুলাম উপলব্ধ +- [Microsoft Learn মডিউল](https://docs.microsoft.com/learn/) +- [Student Hub রিসোর্স](https://docs.microsoft.com/learn/student-hub/) +- শিক্ষার্থীদের জন্য সুপারিশকৃত [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) +- অতিরিক্ত কোর্স: Generative AI, Data Science, ML, IoT পাঠক্রম উপলব্ধ -### নির্দিষ্ট প্রকল্পগুলোর জন্য কাজ +### নির্দিষ্ট প্রকল্পসমূহের কাজ -বিস্তারিত নির্দেশনার জন্য প্রকল্পের README ফাইল দেখুন: +ব্যক্তিগত প্রকল্পগুলির বিস্তারিত নির্দেশনার জন্য README ফাইলগুলো দেখুন: - `quiz-app/README.md` - Vue 3 কুইজ অ্যাপ্লিকেশন -- `7-bank-project/README.md` - অথেনটিকেশন সহ ব্যাংকিং অ্যাপ্লিকেশন -- `5-browser-extension/README.md` - ব্রাউজার এক্সটেনশন ডেভেলপমেন্ট -- `6-space-game/README.md` - ক্যানভাস-ভিত্তিক গেম ডেভেলপমেন্ট +- `7-bank-project/README.md` - প্রমাণীকরণসহ ব্যাংকিং অ্যাপ্লিকেশন +- `5-browser-extension/README.md` - ব্রাউজার এক্সটেনশন উন্নয়ন +- `6-space-game/README.md` - ক্যানভাস-ভিত্তিক গেম উন্নয়ন - `9-chat-project/README.md` - AI চ্যাট সহকারী প্রকল্প -### মনোরেপো স্ট্রাকচার +### মনোরেপো কাঠামো -যদিও এটি প্রচলিত মনোরেপো নয়, তবে এই রিপোজিটরিতে একাধিক স্বাধীন প্রকল্প রয়েছে: -- প্রতিটি লেসন স্বয়ংসম্পূর্ণ -- প্রকল্পসমূহে নির্ভরশীলতা শেয়ার হয় না -- একত্রে প্রভাব নেই, আলাদাভাবে প্রকল্পে কাজ করতে পারবেন -- পুরো কারিকুলামের অভিজ্ঞতা নিতে পুরো রিপোজিটরি ক্লোন করুন +পরম্পরাগত মনোরেপো না হলেও, এই রেপোসিটরিতে একাধিক স্বাধীন প্রকল্প রয়েছে: +- প্রতিটি পাঠ স্ব-সম্পূর্ণ +- প্রকল্পগুলো ডিপেনডেন্সি শেয়ার করে না +- অন্যদের প্রভাবিত না করে পৃথক প্রকল্পে কাজ করুন +- পূর্ণ পাঠক্রম অভিজ্ঞতার জন্য পুরো রেপো ক্লোন করুন --- -**ডিসক্লেইমার**: -এই ডকুমেন্টটি 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/mr/.co-op-translator.json b/translations/mr/.co-op-translator.json index ccd1cd8a2..67cb1c9c0 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-04-06T16:28:19+00:00", + "translation_date": "2026-04-20T16:35:45+00:00", "source_file": "AGENTS.md", "language_code": "mr" }, diff --git a/translations/mr/AGENTS.md b/translations/mr/AGENTS.md index 853822538..25165a56d 100644 --- a/translations/mr/AGENTS.md +++ b/translations/mr/AGENTS.md @@ -2,27 +2,27 @@ ## प्रकल्पाचा आढावा -हा नवीन शिका-वेब विकास मूलभूत तत्त्वे शिकवण्यासाठी शैक्षणिक कोर्सचे संग्रह आहे. हा अभ्यासक्रम 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 -- **परस्पर क्रियाशील प्रश्नमंजुषा**: प्रत्येकी ३ प्रश्नांसह ४८ प्रश्नमंजुषा (प्री/पोस्ट-शिका मूल्यमापनासाठी) -- **अनेक भाषांमध्ये समर्थन**: GitHub Actions द्वारे ५०+ भाषांसाठी स्वयंचलित भाषांतर +- **शैक्षणिक सामग्री**: प्रकल्प-आधारित मॉड्यूलमध्ये आयोजित २४ संरचित धडे +- **प्रायोगिक प्रकल्प**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, आणि AI Chat Assistant +- **परस्पर संवादात्मक प्रश्नमंजुषा**: प्रत्येकी ३ प्रश्नांसह ४८ प्रश्नमंजुषा (धडा आधी/नंतरचे मूल्यमापन) +- **बहुभाषिक समर्थन**: GitHub Actions द्वारे ५०+ भाषा स्वयंचलित भाषांतर - **तंत्रज्ञान**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रकल्पांसाठी) -### आर्किटेक्चर +### वास्तुकला -- शैक्षणिक संग्राहक ज्यात धडा-आधारित रचना आहे -- प्रत्येक धडा फोल्डरमध्ये README, कोड उदाहरणे, आणि समाधान आहेत -- स्वतंत्र प्रकल्प वेगळ्या निर्देशिकांमध्ये (quiz-app, विविध धडा प्रकल्प) -- भाषांतर प्रणाली GitHub Actions वापरून (co-op-translator) -- Docsify द्वारे दस्तऐवज प्रस्तुत आणि PDF रूपात उपलब्ध +- धड्यावर आधारित संरचनेसह शैक्षणिक संग्रहालय +- प्रत्येक धडा फोल्डरमध्ये README, कोड उदाहरणे आणि उपाय असतात +- स्वतंत्र प्रकल्प वेगळ्या डिरेक्टरीजमध्ये (quiz-app, विविध धडा प्रकल्प) +- GitHub Actions वापरून भाषांतर प्रणाली (co-op-translator) +- Docsify वापरून दस्तऐवजीकरण सेवा आणि PDF स्वरूपात उपलब्ध -## सेटअप कमांड्स +## सेटअप कमांड -हा संग्रह मुख्यतः शैक्षणिक सामग्री वापरासाठी आहे. विशिष्ट प्रकल्पांसाठी काम करताना: +हा संग्रह मुख्यतः शैक्षणिक सामग्री वापरासाठी आहे. विशिष्ट प्रकल्पांसाठी काम करण्यासाठी: ### मुख्य संग्रह सेटअप @@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners cd quiz-app npm install npm run dev # विकास सर्व्हर सुरू करा -npm run build # उत्पादनासाठी तयार करा +npm run build # उत्पादनासाठी बांधा npm run lint # ESLint चालवा ``` @@ -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,7 +56,7 @@ 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 बॅकएंड) +### चॅट प्रकल्प (Python Backend) ```bash cd 9-chat-project/solution/backend/python @@ -80,29 +80,29 @@ python api.py ### सामग्री योगदानकर्त्यांसाठी -1. **संग्रह फोर्क करा** तुमच्या GitHub खात्यावर -2. **फोर्कची क्लोन करा** स्थानिकपणे -3. **तुमच्या बदलांसाठी नवीन शाखा तयार करा** -4. धडा सामग्री किंवा कोड उदाहरणे बदला -5. संबंधित प्रकल्प निर्देशिकांमध्ये कोड बदल चाचणी करा -6. योगदान मार्गदर्शकानुसार पुल विनंत्या सादर करा +1. आपल्या GitHub खात्यावर संग्रह फोर्क करा +2. आपल्या फोर्कची स्थानिक क्लोन करा +3. बदलांसाठी नवीन शाखा तयार करा +4. धडा सामग्री किंवा कोड उदाहरणांमध्ये बदल करा +5. संबंधित प्रकल्प डिरेक्टरीजमध्ये कोणतेही कोड बदल चाचणी करा +6. योगदान मार्गदर्शक सूचनांनुसार पुल विनंत्या सादर करा ### शिकणाऱ्यांसाठी 1. संग्रह फोर्क किंवा क्लोन करा -2. धडा निर्देशिकांमध्ये अनुक्रमे जा -3. प्रत्येक धड्याचा README वाचा -4. https://ff-quizzes.netlify.app/web/ येथे प्री-धडा प्रश्नमंजुषा पूर्ण करा -5. धडा फोल्डरमधील कोड उदाहरणे पूर्ण करा +2. धडा डिरेक्टरीज क्रमवार प्रवेश करा +3. प्रत्येक धड्याचा README फायली वाचा +4. पूर्व-धडा प्रश्नमंजुषा https://ff-quizzes.netlify.app/web/ येथे पूर्ण करा +5. धडा फोल्डर्समधील कोड उदाहरणे काम करा 6. असाइनमेंट्स आणि आव्हाने पूर्ण करा -7. पोस्ट-धडा प्रश्नमंजुषा घ्या +7. पश्चात धडा प्रश्नमंजुषा द्या ### लाइव्ह विकास -- **दस्तऐवज**: मुळ निर्देशिकेत `docsify serve` चालवा (पोर्ट ३०००) -- **प्रश्नमंजुषा अ‍ॅप**: quiz-app निर्देशिकेत `npm run dev` चालवा +- **दस्तऐवजीकरण**: `docsify serve` कमांड रूटमध्ये चालवा (पोर्ट 3000) +- **प्रश्नमंजुषा अ‍ॅप**: `npm run dev` quiz-app डिरेक्टरीमध्ये चालवा - **प्रकल्प**: HTML प्रकल्पांसाठी VS Code Live Server विस्तार वापरा -- **API प्रकल्प**: संबंधित API निर्देशिकेत `npm start` चालवा +- **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,164 +119,164 @@ npm run build # बिल्ड यशस्वी आहे का तप ```bash cd 7-bank-project/api npm run lint # कोड शैलीच्या समस्यांसाठी तपासा -node server.js # त्रुटीशिवाय सर्व्हर सुरू होतो का हे तपासा +node server.js # त्रुटीशिवाय सर्व्हर सुरू होतो का ते तपासा ``` ### सामान्य चाचणी पद्धत -- हा शैक्षणिक संग्रह व्यापक स्वयंचलित चाचण्या नसलेला आहे -- मॅन्युअल चाचणी यावर लक्ष केंद्रित करते: - - कोड उदाहरणे त्रुटीशिवाय चालतात - - दस्तऐवजातील दुवे बरोबर काम करतात - - प्रकल्प यशस्वीपणे तयार होतात - - उदाहरणे सर्वोत्तम पद्धतींचे पालन करतात +- हा एक शैक्षणिक संग्रह आहे ज्यामध्ये संपूर्ण स्वयंचलित चाचण्या नाहीत +- मॅन्युअल चाचणीवर लक्ष केंद्रित: + - कोड उदाहरणे चुका न करता चालतील + - दस्तऐवजीकरणातील दुवे योग्यरित्या काम करतील + - प्रकल्प यशस्वीरित्या बिल्ड होतील + - उदाहरणे सर्वोत्तम सराव पाळतील -### सादरीकरणपूर्व तपासणी +### आधी-सबमिशन तपासणी -- package.json असलेल्या निर्देशिकांमध्ये `npm run lint` चालवा -- मार्कडाउन दुवे वैध आहेत का तपासा +- package.json असलेल्या डिरेक्टरीजमध्ये `npm run lint` चालवा +- Markdown लिंक वैध आहेत का तपासा - ब्राउझर किंवा Node.js मध्ये कोड उदाहरणे तपासा -- भाषांतर योग्य रचनेसह आहे का तपासा +- भाषांतरातील संरचना व्यवस्थित आहे का निश्चित करा ## कोड शैली मार्गदर्शक ### JavaScript - आधुनिक ES6+ सिंटॅक्स वापरा -- प्रकल्पांतील मानक ESLint संरचना पाळा +- प्रकल्पांत दिलेल्या मानक ESLint कॉन्फिगरेशनचे पालन करा - शैक्षणिक स्पष्टतेसाठी अर्थपूर्ण व्हेरिएबल व फंक्शन नावे वापरा -- विद्यार्थ्यांसाठी संकल्पना समजावणारे टिपण्णी जोडा -- जिथे कॉन्फिगर आहे तिथे Prettier वापरून फॉर्मॅट करा +- शिकणाऱ्यांसाठी संकल्पना समजाविणारे टिप्पणी जोडा +- जेथे प्रीटियर कॉन्फिगर आहे तिथे फॉरमॅट करा ### HTML/CSS -- सेमॅंटिक HTML5 घटक वापरा -- प्रतिसादी रचना तत्त्वे पाळा -- स्पष्ट क्लास नावे वापरा -- CSS तंत्र समजावणाऱ्या टिपण्णी जोडा +- सांकेतिक HTML5 घटक वापरा +- प्रतिसादात्मक डिज़ाइन तत्त्वे पाळा +- स्पष्ट वर्ग नावकरण परंपरा वापरा +- शिकणाऱ्यांसाठी CSS तंत्र आत्मसात करण्यासाठी टिप्पणी द्या ### Python -- PEP 8 शैली मार्गदर्शक पाळा +- PEP 8 शैली मार्गदर्शक - स्पष्ट, शैक्षणिक कोड उदाहरणे -- शिक्षणासाठी मदत करणारे टाइप हिन्ट्स वापरा +- शिकण्यासाठी मदत करणाऱ्या ठिकाणी टाइप संकेत जोडा -### Markdown दस्तऐवज +### 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 तैनात करण्यासाठी कॉन्फिगर केले आहे: ```bash cd quiz-app npm run build # dist/ फोल्डर तयार करतो -# मुख्य शाखेवर पुश केल्यावर GitHub Actions वर्कफ्लोद्वारे प्रक्षेपित करतो +# मुख्य ब्रांचवर push झाल्यावर GitHub Actions वर्कफ्लोद्वारे तैनात करतो ``` Azure Static Web Apps कॉन्फिगरेशन: -- **अॅप स्थान**: `/quiz-app` +- **अ‍ॅप स्थान**: `/quiz-app` - **आउटपुट स्थान**: `dist` -- **वर्कफ्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +- **कार्यप्रवाह**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### दस्तऐवज PDF निर्मिती +### दस्तऐवजीकरण PDF निर्मिती ```bash -npm install # docsify-to-pdf इन्स्टॉल करा -npm run convert # docs पासून PDF तयार करा +npm install # docsify-to-pdf स्थापित करा +npm run convert # docs मधून PDF तयार करा ``` -### Docsify दस्तऐवज +### Docsify दस्तऐवजीकरण ```bash npm install -g docsify-cli # Docsify जागतिक पातळीवर स्थापित करा docsify serve # localhost:3000 वर सेवा द्या ``` -### प्रकल्प-विशिष्ट तयार करणे +### प्रकल्प-विशिष्ट बिल्ड -प्रत्येक प्रकल्प निर्देशिकेचा स्वतःचा तयार करण्याचा प्रक्रिया असू शकतो: +प्रत्येक प्रकल्प डिरेक्टरीची स्वतःची बिल्ड प्रक्रिया असू शकते: - Vue प्रकल्प: `npm run build` उत्पादन बंडल तयार करतो -- स्थिर प्रकल्प: तयार करण्याचा टप्पा नाही, फाइल्स थेट सर्व्ह करा +- स्थिर प्रकल्प: बिल्ड टप्पा नाही, फायली थेट सेवा करा ## पुल विनंती मार्गदर्शक ### शीर्षक स्वरूप -बदल क्षेत्र स्पष्ट करणारे वर्णनात्मक शीर्षक वापरा: -- `[Quiz-app] धडा X साठी नवीन प्रश्नमंजुषा जोडा` -- `[Lesson-3] Terrarium प्रकल्पातील टायपो दुरुस्त करा` -- `[Translation] धडा 5 साठी स्पॅनिश भाषांतर जोडा` -- `[Docs] सेटअप सूचना अद्ययावत करा` +बदल क्षेत्र दर्शविणारी स्पष्ट, वर्णनात्मक शीर्षके वापरा: +- `[Quiz-app] Add new quiz for lesson X` +- `[Lesson-3] Fix typo in terrarium project` +- `[Translation] Add Spanish translation for lesson 5` +- `[Docs] Update setup instructions` -### आवश्यक तपासणी +### आवश्यक तपासण्या -पुल विनंती पाठवण्यापूर्वी: +PR सादर करण्यापूर्वी: 1. **कोड गुणवत्ता**: - - प्रभावित प्रकल्प निर्देशिकांत `npm run lint` चालवा - - सर्व लिंट त्रुटी व इशारे दुरुस्त करा + - प्रभावित प्रकल्प डिरेक्टरीजमध्ये `npm run lint` चालवा + - सर्व लिंटिंग त्रुटी व चेतावण्या दुरुस्त करा -2. **तयारपण पडताळणी**: +2. **बिल्ड तपासणी**: - लागू असल्यास `npm run build` चालवा - - कोणतीही तयार करताना त्रुटी नसल्याचे सुनिश्चित करा + - बिल्ड त्रुटी नाही याची खात्री करा -3. **दुवा प्रमाणीकरण**: - - सर्व मार्कडाउन दुवे तपासा - - प्रतिमा संदर्भ योग्य आहेत का तपासा +3. **लिंक पुष्टीकरण**: + - सर्व markdown लिंक तपासा + - प्रतिमा संदर्भ कार्यरत आहेत का तपासा 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 कोड ऑफ कंडक्ट](https://opensource.microsoft.com/codeofconduct/) चे पालन करा +- तपशीलवार मार्गदर्शकांसाठी [CONTRIBUTING.md](./CONTRIBUTING.md) पहा +- PR वर्णनामध्ये संदर्भ असलेल्या मुद्दा क्रमांकांचा उल्लेख करा ### पुनरावलोकन प्रक्रिया -- PRs मेन्टेनर्स आणि समुदायाकडून तपासले जातात -- शैक्षणिक स्पष्टता प्राधान्य दिले जाते -- कोड उदाहरणे सद्याच्या सर्वोत्तम पद्धतींचे पालन करावी -- भाषांतर अचूकता आणि सांस्कृतिक योग्यता तपासली जाते +- PR प्रशासक आणि समुदायाकडून पुनरावलोकन +- शैक्षणिक स्पष्टतेला प्राधान्य +- कोड उदाहरणे विद्यमान सर्वोत्तम सरावांचे पालन करतात +- भाषांतर अचूकता आणि सांस्कृतिक सुसंगततेसाठी पुनरावलोकन केली जातात ## भाषांतर प्रणाली ### स्वयंचलित भाषांतर -- GitHub Actions सह co-op-translator वर्कफ्लो वापरते +- co-op-translator workflow सह GitHub Actions वापरतो - ५०+ भाषांमध्ये स्वयंचलित भाषांतर करते -- मुख्य निर्देशिकांत मूळ फाइल्स -- भाषांतरित फाइल्स `translations/{language-code}/` निर्देशिकांत +- मुख्य डिरेक्टरीजमधील स्रोत फाइल्स +- `translations/{language-code}/` डिरेक्टरीजमध्ये भाषांतरित फाइल्स ### मॅन्युअल भाषांतर सुधारणा जोडणे 1. `translations/{language-code}/` मध्ये फाइल शोधा -2. रचना जपून सुधारणा करा -3. कोड उदाहरणे कार्यरत ठेवण्याची काळजी घ्या -4. स्थानिकृत प्रश्नमंजुषा सामग्रीची चाचणी करा +2. संरचना जपत सुधारणा करा +3. कोड उदाहरणे कार्यरत ठेवावे +4. स्थानिकृत प्रश्नमंजुषा सामग्री तपासा ### भाषांतर मेटाडेटा -भाषांतरित फाइल्समध्ये मेटा माहिती शीर्षलेख असते: +भाषांतरित फाइल्समध्ये मेटाडेटा हेडर असतो: ```markdown ``` -## डीबगिंग आणि त्रुटी निवारण +## डीबगिंग आणि त्रुटी निराकरण ### सामान्य समस्या **प्रश्नमंजुषा अ‍ॅप सुरू होत नाही**: - Node.js आवृत्ती तपासा (v14+ शिफारसीय) - `node_modules` आणि `package-lock.json` हटवा, नंतर `npm install` चालवा -- पोर्ट संघर्ष तपासा (डिफॉल्ट: Vite पोर्ट 5173 वापरते) +- पोर्ट संघर्ष तपासा (डिफॉल्ट: Vite पोर्ट 5173 वापरतो) **API सर्व्हर सुरू होत नाही**: -- Node.js आवृत्ती किमान node >=10 असल्याची खात्री करा -- पोर्ट आधीच वापरात आहे का तपासा -- सर्व अवलंबित्वे `npm install` द्वारे स्थापित आहेत का तपासा +- Node.js किमान आवृत्ती पूर्ण होते का तपासा (node >=10) +- पोर्ट आधीपासून वापरात आहे का तपासा +- सर्व अवलंबित्वे `npm install` ने इन्स्टॉल आहेत याची खात्री करा **ब्राउझर विस्तार लोड होत नाही**: -- manifest.json योग्य स्वरूपात आहे का तपासा -- ब्राउझर कन्सोल त्रुटी तपासा -- ब्राउझर-विशिष्ट विस्तार स्थापना सूचना पाळा +- manifest.json योग्यरित्या स्वरूपित आहे का तपासा +- ब्राउझर कन्सोल त्रुटी पाहा +- ब्राउझर-विशिष्ट विस्तार स्थापना सूचना पालन करा **Python चॅट प्रकल्प समस्या**: -- OpenAI पॅकेज इंस्टॉल करा: `pip install openai` -- GITHUB_TOKEN पर्यावरण चल सेट आहे का तपासा -- GitHub Models प्रवेश परवानग्या तपासा +- 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 विस्तार इंस्टॉल करा -- JavaScript डीबगिंगकरिता ब्राउझर DevTools वापरा -- Vue प्रकल्पांसाठी Vue DevTools ब्राउझर विस्तार इंस्टॉल करा +- सतत फॉरमॅटिंगसाठी ESLint आणि Prettier विस्तार इन्स्टॉल करा +- JavaScript डीबगिंगसाठी ब्राउझर DevTools वापरा +- Vue प्रकल्पांसाठी Vue DevTools ब्राउझर विस्तार इन्स्टॉल करा ### कार्यक्षमता विचार -- अनेक भाषांतराच्या फाइल्स (५०+ भाषा) असल्यामुळे पूर्ण क्लोन मोठे असू शकतात -- फक्त सामग्रीसाठी काम करत असल्यास `git clone --depth 1` वापरा -- इंग्रजी सामग्रीवर काम करताना शोधांमध्ये भाषांतर वगळा -- प्रथम चालवताना (npm install, Vite build) तयार करणे मंदगती असू शकते +- ५०+ भाषांमध्ये अनुवाद असल्यामुळे संपूर्ण क्लोन मोठा होतो +- फक्त सामग्रीवर काम करत असल्यास शालो क्लोन वापरा: `git clone --depth 1` +- इंग्रजी सामग्रीसाठी काम करताना भाषांतर शोधांमध्ये वगळा +- पहिल्या वेळी बिल्ड प्रक्रिया (npm install, Vite build) हळू असू शकते ## सुरक्षा विचार -### पर्यावरण चल +### पर्यावरणीय चल -- API की संग्रहात कधीही कमिट करू नका -- `.env` फाइल्स वापरा (ज्याचं `.gitignore` मध्ये उल्लेख आहे) -- प्रकल्प README मध्ये आवश्यक पर्यावरण चल दस्तऐवज करा +- API की संग्रहात कधीही कमिट करू नयेत +- `.env` फायली वापरा (आधीपासून `.gitignore` मध्ये आहेत) +- प्रकल्प README मध्ये आवश्यक पर्यावरणीय चलांचे दस्तऐवजीकरण करा ### Python प्रकल्प -- व्हर्च्युअल एन्व्हायर्नमेंट वापरा: `python -m venv venv` +- वर्च्युअल वातावरण वापराः `python -m venv venv` - अवलंबित्वे अद्ययावत ठेवा -- GitHub टोकनला आवश्यक किमान परवानग्या द्या +- GitHub टोकन्सना किमान आवश्यक परवानग्या द्या ### GitHub Models प्रवेश -- GitHub Models साठी वैयक्तिक प्रवेश टोकन (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) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) शिकणाऱ्यांसाठी शिफारस - अतिरिक्त कोर्सेस: Generative AI, Data Science, ML, IoT अभ्यासक्रम उपलब्ध -### विशिष्ट प्रकल्पांसोबत काम करणे +### विशिष्ट प्रकल्पांसह काम -वैयक्तिक प्रकल्पांसाठी तपशीलवार सूचना पाहण्यासाठी README फायली पहा: +सूक्ष्म सूचना साठी खालील README फायली पहा: - `quiz-app/README.md` - Vue 3 प्रश्नमंजुषा अ‍ॅप्लिकेशन -- `7-bank-project/README.md` - प्रमाणीकरणासह बँकिंग अॅप्लिकेशन +- `7-bank-project/README.md` - प्रमाणीकरणासह बँकिंग अ‍ॅप्लिकेशन - `5-browser-extension/README.md` - ब्राउझर विस्तार विकास - `6-space-game/README.md` - कॅनव्हास-आधारित गेम विकास - `9-chat-project/README.md` - AI चॅट सहाय्यक प्रकल्प -### मोनोरिपॉ स्ट्रक्चर +### मोनोरिपो संरचना -हा पारंपरिक मोनोरिपॉ नसला तरी, हा संग्रह अनेक स्वतंत्र प्रकल्पांचा समावेश करतो: +पारंपरिक मोनोरिपो नसले तरी, या संग्रहात अनेक स्वतंत्र प्रकल्प आहेत: - प्रत्येक धडा स्वतंत्र आहे -- प्रकल्प एकमेकांशी अवलंबित्व शेअर करत नाहीत -- वेगवेगळ्या प्रकल्पांवर स्वतंत्रपणे काम करा -- पूर्ण अभ्यासक्रम अनुभवासाठी संपूर्ण रिपॉ क्लोन करा +- प्रकल्प एकमेकांशी अवलंबून नाहीत +- स्वतंत्र प्रकल्पांवर काम करा ज्याचा इतरांवर परिणाम होणार नाही +- पूर्ण अभ्यासक्रम अनुभवासाठी संपूर्ण संग्रह क्लोन करा --- **अस्वीकरण**: -हा दस्तऐवज 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 4e15b0edb..c853cab0c 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-04-06T16:29:31+00:00", + "translation_date": "2026-04-20T16:36:59+00:00", "source_file": "AGENTS.md", "language_code": "ne" }, diff --git a/translations/ne/AGENTS.md b/translations/ne/AGENTS.md index a08ff856e..3909feac9 100644 --- a/translations/ne/AGENTS.md +++ b/translations/ne/AGENTS.md @@ -2,27 +2,27 @@ ## परियोजना अवलोकन -यो शुरुआतीहरूको लागि वेब विकासका आधारहरू सिकाउनको लागि शैक्षिक पाठ्यक्रम भण्डार हो। यो पाठ्यक्रम Microsoft क्लाउड एडभोकेटहरूले विकास गरेको व्यापक १२-सप्ताहको कोर्स हो, जसमा JavaScript, CSS, र HTML समेटिएका २४ व्यवहारिक पाठहरू छन्। +यो शुरुआतीहरूलाई वेब विकासका आधारहरू सिकाउन बनाइएको शैक्षिक पाठ्यक्रम भण्डार हो। यो पाठ्यक्रम माइक्रोसफ्ट क्लाउड एड्भोकेटहरूले विकास गरेको १२ हप्ताको व्याप्त छ, जसमा २४ अभ्यासात्मक पाठहरू छन् जसले 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 उपलव्ध -## सेटअप आदेशहरू +## सेटअप कमाण्डहरू -यो भण्डार मुख्य रूपमा शैक्षिक सामग्री उपभोगको लागि हो। विशेष परियोजनाहरूमा काम गर्न: +यो भण्डार मुख्य रूपमा शैक्षिक सामग्री उपभोगका लागि हो। विशेष परियोजनाहरूमा काम गर्नका लागि: ### मुख्य भण्डार सेटअप @@ -48,26 +48,26 @@ cd 7-bank-project/api npm install npm start # API सर्भर सुरु गर्नुहोस् npm run lint # ESLint चलाउनुहोस् -npm run format # Prettier सँग ढाँचा मिलाउनुहोस् +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 खोल्नुहोस् वा लाइभ सर्भर प्रयोग गर्नुहोस् ``` -### च्याट परियोजना (Python ब्याकएन्ड) +### च्याट परियोजना (Python ब्याकएण्ड) ```bash cd 9-chat-project/solution/backend/python @@ -80,29 +80,29 @@ python api.py ### सामग्री योगदानकर्ताहरूका लागि -1. **भण्डारलाई फोर्क गर्नुहोस्** आफ्नो GitHub खातामा -2. **फोर्क क्लोन गर्नुहोस्** स्थानीय रूपमा -3. **तपाईंको परिवर्तनका लागि नयाँ शाखा बनाउनुहोस्** +1. **भगवानलाई आफ्नो GitHub खातामा फोर्क गर्नुहोस्** +2. **फोर्क लोकली क्लोन गर्नुहोस्** +3. **आफ्ना परिवर्तनहरूको लागि नयाँ ब्रान्च बनाउनुहोस्** 4. पाठ सामग्री वा कोड उदाहरणहरूमा परिवर्तन गर्नुहोस् 5. सम्बन्धित परियोजना निर्देशिकाहरूमा कोड परिवर्तनहरू परीक्षण गर्नुहोस् -6. योगदान दिशानिर्देशहरू अनुसार पुल अनुरोधहरू पठाउनुहोस् +6. योगदान दिशा-निर्देश अनुसार पुल अनुरोधहरू पठाउनुहोस् -### सिक्नेलाई लागि +### सिक्नेहरूका लागि 1. भण्डार फोर्क वा क्लोन गर्नुहोस् -2. पाठ निर्देशिकाहरूमा अनुक्रमिक रूपमा जानुहोस् +2. पाठ निर्देशिकाहरू अनुसन्धान गर्दै जानुहोस् 3. प्रत्येक पाठको README फाइल पढ्नुहोस् 4. https://ff-quizzes.netlify.app/web/ मा पूर्व-पाठ क्विजहरू पूरा गर्नुहोस् -5. पाठ फोल्डरमा कोड उदाहरणहरू काम गर्नुहोस् +5. पाठ फोल्डरहरूमा कोड उदाहरणहरूमा काम गर्नुहोस् 6. असाइनमेन्ट र चुनौतीहरू पूरा गर्नुहोस् -7. पाठ पछि क्विजहरू लिनुहोस् +7. पाठपछि क्विजहरू लिनुहोस् ### प्रत्यक्ष विकास -- **डकुमेन्टेसन**: मूल फोल्डरमा `docsify serve` चलाउनुहोस् (पोर्ट 3000) +- **दस्तावेजीकरण**: मूल फोल्डरमा `docsify serve` चलाउनुहोस् (पोर्ट ३०००) - **क्विज एप**: quiz-app निर्देशिकामा `npm run dev` चलाउनुहोस् -- **परियोजनाहरू**: HTML परियोजनाहरूका लागि VS Code Live Server विस्तार प्रयोग गर्नुहोस् -- **API परियोजनाहरू**: सम्बन्धित API निर्देशिकाहरूमा `npm start` चलाउनुहोस् +- **परियोजनाहरू**: HTML परियोजनाहरू लागि VS Code Live Server एक्सटेन्सन प्रयोग गर्नुहोस् +- **API परियोजनाहरू**: संबंधित API निर्देशिकामा `npm start` चलाउनुहोस् ## परीक्षण निर्देशनहरू @@ -110,82 +110,82 @@ python api.py ```bash cd quiz-app -npm run lint # कोड शैलीका समस्या जाँच गर्नुहोस् -npm run build # बिल्ड सफल हुन्छ कि छैन जाँच गर्नुहोस् +npm run lint # कोड शैली समस्याहरू जाँच गर्नुहोस् +npm run build # सुनिश्चित गर्नुहोस् कि बिल्ड सफल हुन्छ ``` ### बैंक API परीक्षण ```bash cd 7-bank-project/api -npm run lint # कोड शैली समस्याहरू जाँच गर्नुहोस् -node server.js # सर्वर त्रुटिहरू बिना सुरू हुन्छ कि छैन जाँच्नुहोस् +npm run lint # कोड शैलीका समस्याहरू जाँच गर्नुहोस् +node server.js # सर्भर त्रुटी बिना सुरु हुन्छ कि भनी प्रमाणित गर्नुहोस् ``` -### सामान्य परीक्षण विधि +### सामान्य परीक्षण दृष्टिकोण -- यो शैक्षिक भण्डारमा व्यापक स्वचालित परीक्षणहरू छैनन् -- म्यानुअल परीक्षणमा ध्यान: - - कोड उदाहरणहरू त्रुटि बिना चल्ने - - डकुमेन्टेसनका लिङ्कहरू सही काम गर्ने +- यो शैक्षिक भण्डार हो जसमा व्यापक स्वचालित परीक्षणहरू छैनन् +- म्यानुअल परीक्षण मुख्य रूपमा: + - कोड उदाहरणहरू बिना त्रुटि चल्ने + - दस्तावेजीकरणका लिंकहरू काम गर्ने - परियोजना सफलतापूर्वक बिल्ड हुने - - उदाहरणहरू सर्वोत्तम अभ्यास अनुसार हुने + - उदाहरणहरू राम्रा अभ्यासहरू अनुसार हुने -### पूर्व-प्रस्तुती जाँच +### पूर्व-पेशगी जाँचहरू -- package.json भएका निर्देशिकाहरूमा `npm run lint` चलाउनुहोस् -- मार्कडाउन लिङ्कहरू मान्य छन् कि छैनन् जाँच गर्नुहोस् +- जसमा 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 शैली निर्देशनहरू - स्पष्ट, शैक्षिक कोड उदाहरणहरू -- सिक्न सहयोगी स्थानहरूमा प्रकार संकेतहरू +- सिकाइको लागि जहाँ उपयोगी हो टाइप हिंटहरू -### मार्कडाउन डकुमेन्टेसन +### मार्कडाउन दस्तावेजीकरण - स्पष्ट शीर्षक पदानुक्रम -- भाषा निर्दिष्ट गरिएको कोड ब्लकहरू -- अतिरिक्त स्रोतहरूका लागि लिङ्कहरू -- `images/` निर्देशिकामा स्क्रिनशट र छविहरू -- पहुँचयोग्यताको लागि छविहरूमा Alt टेक्स्ट +- भाषा निर्दिष्ट गरेर कोड ब्लकहरू +- अतिरिक्त स्रोतहरूमा लिंकहरू +- `images/` निर्देशिकामा स्क्रिनसट र तस्बिरहरू +- पहुँचयोग्यताको लागि तस्बिरहरूमा Alt टेक्स्ट -### फाइल व्यवस्थापन +### फाइल संगठन -- पाठहरू क्रमागत सङ्ख्यामा नामाकरण (1-getting-started-lessons, 2-js-basics आदि) -- प्रत्येक परियोजनामा `solution/` र प्राय: `start/` वा `your-work/` निर्देशिकाहरू -- पाठ-विशेष `images/` फोल्डरमा छविहरू भण्डारण +- पाठहरू लगातार नम्बर गरिएको (1-getting-started-lessons, 2-js-basics, आदि) +- प्रत्येक परियोजनामा `solution/` र प्रायः `start/` वा `your-work/` निर्देशिकाहरू हुन्छन् +- पाठ-विशिष्ट `images/` फोल्डरहरूमा तस्बिरहरू संग्रहित - अनुवादहरू `translations/{language-code}/` संरचनामा -## निर्माण र वितरण +## निर्माण र परिनियोजन -### क्विज एप वितरण (Azure Static Web Apps) +### क्विज एप परिनियोजन (Azure Static Web Apps) -quizz-app Azure Static Web Apps वितरणको लागि कन्फिगर गरिएको छ: +क्विज एप Azure Static Web Apps परिनियोजनका लागि कन्फिगर गरिएको छ: ```bash cd quiz-app -npm run build # dist/ फोल्डर सिर्जना गर्छ -# मुख्य शाखामा पुश गर्दा GitHub Actions workflow मार्फत डिप्लोय गर्छ +npm run build # dist/ फोल्डर सिर्जना गर्दछ +# main मा पुश गर्दा GitHub Actions workflow मार्फत डिप्लोय गर्दछ ``` Azure Static Web Apps कन्फिगरेसन: @@ -193,85 +193,85 @@ 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 डकुमेन्टेसन +### 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] टेरारियम परियोजनामा टाइपो फिक्स गर्नुहोस्` +- `[Translation] पाठ ५ का लागि स्पेनिश अनुवाद थप्नुहोस्` +- `[Docs] सेटअप निर्देशनहरू अपडेट गर्नुहोस्` ### आवश्यक जाँचहरू -पिआर पेश गर्नु अघि: +PR पठाउनु अघि: 1. **कोड गुणस्तर**: - - प्रभावित परियोजना निर्देशिकाहरूमा `npm run lint` चलाउनुहोस् - - सबै लिन्ट त्रुटि र चेतावनीहरू सच्याउनुहोस् + - प्रभावित परियोजना निर्देशिकामा `npm run lint` चलाउनुहोस् + - सबै लिंटिंग त्रुटि र चेतावनीहरू फिक्स गर्नुहोस् 2. **निर्माण प्रमाणीकरण**: - - लागू भएमा `npm run build` चलाउनुहोस् - - कुनै निर्माण त्रुटि हुँदैन भनेर सुनिश्चित गर्नुहोस् + - जहाँ लागू हुन्छ `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 को सहकार्य अनुवादक वर्कफ्लो प्रयोग गर्छ +- GitHub Actions र co-op-translator वर्कफ्लो प्रयोग गर्दछ - ५०+ भाषाहरूमा स्वतः अनुवाद गर्छ -- स्रोत फाइलहरू मुख्य निर्देशिकामा हुन्छन् -- अनुवादित फाइलहरू `translations/{language-code}/` निर्देशिकामा हुन्छन् +- मुख्य निर्देशिकाहरूमा स्रोत फाइलहरू +- अनुवादित फाइलहरू `translations/{language-code}/` निर्देशिकामा राखिएको ### म्यानुअल अनुवाद सुधारहरू थप्ने -1. `translations/{language-code}/` मा फाइल पत्ता लगाउनुहोस् -2. संरचना कायम राख्दै सुधारहरू गर्नुहोस् -3. कोड उदाहरणहरू कार्यशील रहन्छन् सुनिश्चित गर्नुहोस् +1. `translations/{language-code}/` मा फाइल खोज्नुहोस् +2. संरचना जोगाउँदै सुधारहरू गर्नुहोस् +3. कोड उदाहरणहरू कार्यशील अवस्थामा राख्नुहोस् 4. स्थानीयकृत क्विज सामग्री परीक्षण गर्नुहोस् ### अनुवाद मेटाडाटा @@ -294,115 +294,115 @@ CO_OP_TRANSLATOR_METADATA: ### सामान्य समस्याहरू **क्विज एप सुरु हुँदैन**: -- 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`) +- Node.js संस्करण न्यूनतम (node >=10) पूरा गर्दछ भनि सुनिश्चित गर्नुहोस् +- पोर्ट पहिले नै प्रयोगमा छ कि छैन जाँच गर्नुहोस् +- सबै निर्भरताहरू `npm install` द्वारा स्थापना भइसकेको हुनुपर्छ -**ब्राउजर एक्सटेन्शन लोड हुँदैन**: -- manifest.json उचित रूपमा ढाँचागत छ कि छैन जाँच्नुहोस् -- ब्राउजर कन्सोलमा त्रुटिहरू जाँच्नुहोस् -- ब्राउजर-विशिष्ट एक्सटेन्शन स्थापना निर्देशनहरू पालना गर्नुहोस् +**ब्राउजर एक्सटेन्सन लोड हुँदैन**: +- manifest.json ठिकसँग फर्म्याट गरिएको छ कि छैन जाँच गर्नुहोस् +- ब्राउजर कन्सोलमा त्रुटिहरू हेर्नुहोस् +- ब्राउजर-विशिष्ट एक्सटेन्सन स्थापना निर्देशनहरू पालना गर्नुहोस् **Python च्याट परियोजना समस्याहरू**: -- OpenAI प्याकेज स्थापना छ : `pip install openai` -- GITHUB_TOKEN पर्यावरण चर सेट गरिएको छ कि छैन जाँच्नुहोस् -- GitHub मोडेल पहुँच अनुमति जाँच्नुहोस् +- OpenAI प्याकेज स्थापना गरिएको छ: `pip install openai` +- GITHUB_TOKEN वातावरण चर सेट गरिएको छ +- GitHub मोडेल पहुँच अनुमति जाँच गर्नुहोस् -**Docsify डकुमेन्टेसन सेवा गर्दैन**: -- docsify-cli विश्वव्यापी स्थापना गर्नुहोस्: `npm install -g docsify-cli` -- भण्डारको मूलबाट चलाउनुहोस् -- `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 ब्राउजर विस्तार स्थापना गर्नुहोस् +- HTML परियोजनाहरूका लागि VS Code Live Server एक्सटेन्सन प्रयोग गर्नुहोस् +- ESLint र Prettier एक्सटेन्सनहरू स्थापना गरेर एकरूप फर्म्याटिंग सुनिश्चित गर्नुहोस् +- JavaScript डिबगिङका लागि ब्राउजर DevTools प्रयोग गर्नुहोस् +- Vue परियोजनाहरूका लागि Vue DevTools ब्राउजर एक्सटेन्सन स्थापना गर्नुहोस् -### प्रदर्शनका विचारहरू +### प्रदर्शन विचारहरू -- धेरै अनुवाद फाइलहरू (५०+ भाषा) हुनुको कारण पूर्ण क्लोनहरू ठूलो हुन्छन् -- मात्र सामग्रीमा काम गर्दा `git clone --depth 1` प्रयोग गर्नुहोस् +- ठूलो संख्यामा अनुवादित फाइलहरू (५०+ भाषाहरू) हुँदा पूर्ण क्लोनहरू ठूला हुन्छन् +- केवल सामग्रीमा काम गर्दा shallow clone प्रयोग गर्नुहोस्: `git clone --depth 1` - अंग्रेजी सामग्रीमा काम गर्दा अनुवादहरू खोजीबाट बाहिर राख्नुहोस् -- पहिलो पटक रन गर्दा बिल्ड प्रक्रियाहरू धिमा हुन सक्छन् (`npm install`, Vite build) +- पहिलो पटक रन गर्दा निर्माण प्रक्रिया सुस्त हुन सक्छ (npm install, Vite build) ## सुरक्षा विचारहरू -### वातावरणीय चरहरू +### वातावरण चरहरू - API कुञ्जीहरू कहिल्यै भण्डारमा कमिट नगर्नुहोस् -- `.env` फाइलहरू प्रयोग गर्नुहोस् (पहिल्यै `.gitignore` मा छन्) -- परियोजनाका README मा आवश्यक वातावरण चरहरू डकुमेन्ट गर्नुहोस् +- `.env` फाइलहरू प्रयोग गर्नुहोस् (पहिले नै `.gitignore` मा छन्) +- परियोजनाका README हरूमा आवश्यक वातावरण चरहरू दस्तावेज गर्नुहोस् ### Python परियोजनाहरू - भर्चुअल वातावरणहरू प्रयोग गर्नुहोस्: `python -m venv venv` - निर्भरताहरू अपडेट राख्नुहोस् -- GitHub टोकनहरू न्यूनतम आवश्यक अनुमतिसहित हुनु आवश्यक +- GitHub टोकनहरू न्यूनतम आवश्यक अनुमति राख्नुहोस् ### GitHub मोडेल पहुँच -- GitHub मोडेलका लागि व्यक्तिगत पहुँच टोकनहरू (PAT) आवश्यक -- टोकनहरू वातावरण चरको रूपमा सङ्ग्रह गर्नुहोस् -- टोकन वा प्रमाणपत्रहरू कहिल्यै कमिट नगर्नुहोस् +- GitHub मोडेलहरूका लागि व्यक्तिगत पहुँच टोकनहरू (PAT) आवश्यक हुन्छन् +- टोकनहरू वातावरण चरको रूपमा भण्डारण गर्नुहोस् +- टोकन वा प्रमाणपत्र कहिल्यै कमिट नगर्नुहोस् ## अतिरिक्त नोटहरू -### लक्ष्य समूह +### लक्षित दर्शक -- वेब विकासमा पूर्ण शुरुआतीहरू -- विद्यार्थीहरू र स्वयं-सिक्नेहरू -- कक्षा कक्षाहरूमा पाठ्यक्रम प्रयोग गर्ने शिक्षकहरू -- सामग्री पहुँचयोग्य र क्रमिक सीप विकासका लागि डिजाइन गरिएको +- वेब विकासका लागि पूर्ण शुरुआतीहरू +- विद्यार्थी र स्व-सिक्नेहरू +- कक्षाकोठामा पाठ्यक्रम प्रयोग गर्ने शिक्षकहरू +- समावेशी र चरणबद्ध सीप विकासका लागि डिजाइन गरिएको सामग्री ### शैक्षिक दर्शन - परियोजना-आधारित सिकाइ दृष्टिकोण - बारम्बार ज्ञान जाँच (क्विजहरू) -- व्यवहारिक कोडिङ अभ्यासहरू -- वास्तविक संसारका अनुप्रयोग उदाहरणहरू -- फ्रेमवर्क भन्दा पहिले आधारहरूमा केन्द्रित +- अभ्यासात्मक कोडिङ अभ्यासहरू +- वास्तविक-विश्व अनुप्रयोग उदाहरणहरू +- फ्रेमवर्कहरू अगाडि आधारहरूमा ध्यान केन्द्रित -### भण्डार मर्मत +### भण्डार मर्मतसम्भार -- सक्रिय सिक्ने र योगदानकर्ता समुदाय -- निर्भरता र सामग्रीमा नियमित अद्यावधिकहरू -- मर्मतकर्ताहरूले समस्या र छलफलहरू अनुगमन -- अनुवाद अद्यावधिकहरू GitHub Actions द्वारा स्वचालित +- सिक्नेहरू र योगदानकर्ताहरूको सक्रिय समुदाय +- निर्भरता र सामग्रीमा नियमित अपडेटहरू +- मुद्दाहरू र छलफलहरू संरक्षकहरूले अनुगमन गर्छन् +- अनुवाद अपडेटहरू GitHub Actions द्वारा स्वचालित ### सम्बन्धित स्रोतहरू -- [Microsoft Learn मोड्युलहरू](https://docs.microsoft.com/learn/) -- [Student Hub स्रोतहरू](https://docs.microsoft.com/learn/student-hub/) -- सिक्नेलाई सिफारिस: [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) -- थप पाठ्यक्रमहरू: जनरेटिभ AI, डेटा विज्ञान, ML, IoT पाठ्यक्रमहरू उपलब्ध +- [Microsoft Learn मोड्युल](https://docs.microsoft.com/learn/) +- [विद्यार्थी हब स्रोतहरू](https://docs.microsoft.com/learn/student-hub/) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) सिक्नेहरूका लागि सिफारिस +- अतिरिक्त कोर्सहरू: जेनेरेटिभ AI, डेटा साइन्स, ML, IoT पाठ्यक्रमहरू उपलब्ध -### विशेष परियोजनाहरू सँग काम गर्ने +### विशेष परियोजनाहरूमा काम गर्ने -व्यक्तिगत परियोजनाहरूका लागि विस्तृत निर्देशनहरू हेर्नुहोस्: -- `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