From edc8d3f5e3ebf6881330737bd75903335d05a663 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 11:15:24 +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 | 460 ++++++++++++------------- translations/hi/.co-op-translator.json | 2 +- translations/hi/AGENTS.md | 340 +++++++++--------- translations/ko/.co-op-translator.json | 2 +- translations/ko/AGENTS.md | 298 ++++++++-------- 6 files changed, 552 insertions(+), 552 deletions(-) diff --git a/translations/bn/.co-op-translator.json b/translations/bn/.co-op-translator.json index 5b3db13d7..3548f55c0 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-02-06T08:08:31+00:00", + "translation_date": "2026-02-06T11:15:20+00:00", "source_file": "AGENTS.md", "language_code": "bn" }, diff --git a/translations/bn/AGENTS.md b/translations/bn/AGENTS.md index f34f632c2..4bd792332 100644 --- a/translations/bn/AGENTS.md +++ b/translations/bn/AGENTS.md @@ -1,37 +1,37 @@ # AGENTS.md -## প্রকল্প বিবরণ +## Project Overview -এটি শিক্ষানবিশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর জন্য একটি শিক্ষামূলক পাঠ্যক্রম সংরক্ষণাগার। এই পাঠ্যক্রম একটি ব্যাপক ১২-সপ্তাহের কোর্স যা Microsoft Cloud Advocates দ্বারা বিকাশ করা হয়েছে, যার মধ্যে ২৪টি হাতে-কলমের পাঠ রয়েছে যা JavaScript, CSS, এবং HTML কভার করে। +এটি শিক্ষানবিশদের জন্য ওয়েব ডেভেলপমেন্টের মৌলিক বিষয় শেখানোর একটি শিক্ষামূলক পাঠক্রম রেপোজিটরি। এই পাঠক্রমটি এক্সপ্রেসিভ ১২-সপ্তাহের একটি সম্পূর্ণ কোর্স যা মাইক্রোসফট ক্লাউড অ্যাডভোকেটদের দ্বারা বিকাশিত, যেখানে জাভাস্ক্রিপ্ট, সিএসএস এবং এইচটিএমএল সম্পর্কিত ২৪টি প্র্যাক্টিকাল পাঠ অন্তর্ভুক্ত। -### প্রধান উপাদানসমূহ +### Key Components -- **শিক্ষামূলক বিষয়বস্তু**: প্রকল্প ভিত্তিক মডিউল আকারে সংগঠিত ২৪টি কাঠামোবদ্ধ পাঠ -- **প্রায়োগিক প্রকল্পসমূহ**: 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 প্রকল্পের জন্য) +- **শিক্ষামূলক বিষয়বস্তু**: ২৪টি সুশৃঙ্খল পাঠ যা প্রজেক্ট-ভিত্তিক মডিউলগুলিতে সংগঠিত +- **প্রায়োগিক প্রকল্প**: টেরারিয়াম, টাইপিং গেম, ব্রাউজার এক্সটেনশন, স্পেস গেম, ব্যাংকিং অ্যাপ, কোড এডিটর, এবং এআই চ্যাট সহকারী +- **ইন্টারেক্টিভ কুইজ**: ৪৮টি কুইজ, প্রতিটিতে ৩টি প্রশ্ন (পাঠের পূর্বে/পরে মূল্যায়ন) +- **বহু ভাষা সমর্থন**: গিটহাব অ্যাকশনস এর মাধ্যমে ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ +- **প্রযুক্তি**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI প্রকল্পের জন্য) -### স্থাপত্য +### Architecture -- পাঠ ভিত্তিক কাঠামোর অধীন শিক্ষামূলক সংরক্ষণাগার -- প্রতিটি পাঠ ফোল্ডারে README, কোড উদাহরণ, এবং সমাধান থাকে -- স্বতন্ত্র প্রকল্পগুলি আলাদা ডিরেক্টরিতে রয়েছে (quiz-app, বিভিন্ন পাঠ প্রকল্প) -- GitHub Actions (co-op-translator) ব্যবহার করে অনুবাদ ব্যবস্থা -- Docsify দ্বারা ডকুমেন্টেশন পরিবেশন এবং PDF আকারে উপলব্ধ +- পাঠ-ভিত্তিক গঠন সহ শিক্ষামূলক রেপোজিটরি +- প্রতিটি পাঠ ফোল্ডারে README, কোড উদাহরণ এবং সমাধান রয়েছে +- আলাদা ডিরেক্টরিতে স্বতন্ত্র প্রকল্পসমূহ (quiz-app, বিভিন্ন পাঠ প্রকল্প) +- গিটহাব অ্যাকশনস ব্যবহার করে অনুবাদ ব্যবস্থা (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,15 +51,15 @@ 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 @@ -67,46 +67,46 @@ npm install # ব্রাউজারে 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. সহযোগিতা নির্দেশিকা অনুসরণ করে পুল রিকোয়েস্ট জমা দিন +১. আপনার গিটহাব অ্যাকাউন্টে **রেপোজিটরি ফর্ক করুন** +২. **লোকালি আপনার ফর্ক ক্লোন করুন** +৩. আপনার পরিবর্তনের জন্য একটি **নতুন ব্রাঞ্চ তৈরি করুন** +৪. পাঠের বিষয়বস্তু বা কোড উদাহরণ পরিবর্তন করুন +৫. প্রাসঙ্গিক প্রকল্প ডিরেক্টরিতে কোড পরিবর্তন পরীক্ষা করুন +৬. অবদান নির্দেশনাগুলি অনুসরণ করে পুল রিকোয়েস্ট সাবমিট করুন -### শিক্ষার্থীদের জন্য +### For Learners -1. রিপোজিটোরিটি ফর্ক বা ক্লোন করুন -2. ধারাবাহিকভাবে পাঠ ডিরেক্টরিতে যান -3. প্রতিটি পাঠের README ফাইল পড়ুন -4. https://ff-quizzes.netlify.app/web/ এ পূর্ব-পাঠ কুইজ সম্পন্ন করুন -5. পাঠের ফোল্ডারে কোড উদাহরণগুলি অনুসরণ করুন -6. অ্যাসাইনমেন্ট এবং চ্যালেঞ্জ সম্পন্ন করুন -7. পরবর্তী-পাঠ কুইজ দিন +১. রেপোজিটরি ফর্ক বা ক্লোন করুন +২. ক্রমবর্ধমান পাঠ ডিরেক্টরিতে নেভিগেট করুন +৩. প্রতিটি পাঠের README ফাইল পড়ুন +৪. https://ff-quizzes.netlify.app/web/ এ গিয়ে পূর্ব-পাঠ কুইজ সম্পন্ন করুন +৫. পাঠ ফোল্ডারে কোড উদাহরণগুলি অনুসরণ করুন +৬. অ্যাসাইনমেন্ট ও চ্যালেঞ্জ সম্পন্ন করুন +৭. পাঠের পরবর্তী কুইজ গ্রহণ করুন -### সরাসরি ডেভেলপমেন্ট +### Live Development -- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০) -- **Quiz App**: quiz-app ডিরেক্টরিতে `npm run dev` চালান -- **প্রকল্পসমূহ**: HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন -- **API প্রকল্পসমূহ**: সংশ্লিষ্ট API ডিরেক্টরিতে `npm start` চালান +- **ডকুমেন্টেশন**: রুটে `docsify serve` চালান (পোর্ট ৩০০০) +- **Quiz App**: quiz-app ডিরেক্টরিতে `npm run dev` চালান +- **প্রকল্পসমূহ**: এইচটিএমএল প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন +- **API প্রকল্পসমূহ**: সংশ্লিষ্ট API ডিরেক্টরিতে `npm start` চালান -## টেস্টিং নির্দেশাবলী +## Testing Instructions -### Quiz App টেস্টিং +### Quiz App Testing ```bash cd quiz-app @@ -114,169 +114,169 @@ 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+ সিনট্যাক্স ব্যবহার করুন -- প্রকল্পগুলিতে দেওয়া standaard ESLint কনফিগারেশন অনুসরণ করুন -- শিক্ষার্থীদের জন্য অর্থবহ ভেরিয়েবল এবং ফাংশন নাম ব্যবহার করুন -- ধারণাগুলো ব্যাখ্যা করার জন্য মন্তব্য যোগ করুন -- যেখানে কনফিগার করা আছে সেখানে Prettier দিয়ে ফরম্যাট করুন +- আধুনিক ES6+ সিনট্যাক্স ব্যবহার করুন +- প্রকল্পে দেয়া সাধারণ ESLint কনফিগারেশন অনুসরণ করুন +- শিক্ষামূলক স্পষ্টতার জন্য অর্থবহ ভেরিয়েবল ও ফাংশন নাম ব্যবহার করুন +- শিক্ষার্থীদের বোঝার জন্য মন্তব্য যোগ করুন +- যেখানে প্রয়োজন Prettier ব্যবহার করে ফরম্যাট করুন ### HTML/CSS -- সেমান্টিক HTML5 উপাদান ব্যবহার -- রেসপনসিভ ডিজাইন নীতিমালা -- স্পষ্ট ক্লাস নামকরণ নিয়ম -- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যা সহ মন্তব্য +- সেম্যান্টিক HTML5 উপাদান ব্যবহার করুন +- রেসপনসিভ ডিজাইন নীতিমালা অনুসরণ করুন +- স্পষ্ট ক্লাস নামকরণের নিয়ম মেনে চলুন +- শিক্ষার্থীদের জন্য CSS কৌশল ব্যাখ্যার মন্তব্য যোগ করুন ### Python -- PEP 8 স্টাইল গাইডলাইনস -- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ -- শিখতে সহায়ক হলে টাইপ হিন্ট ব্যবহার +- PEP 8 স্টাইল গাইড অনুসরণ করুন +- স্পষ্ট, শিক্ষামূলক কোড উদাহরণ দিন +- শেখার জন্য সুবিধাজনক হলে টাইপ হিন্ট ব্যবহার করুন -### Markdown ডকুমেন্টেশন +### Markdown Documentation -- স্পষ্ট শিরোনাম ধারা -- ভাষা নির্দিষ্ট কোড ব্লকসমূহ -- অতিরিক্ত সম্পদের লিঙ্ক -- `images/` ডিরেক্টরির স্ক্রীনশট ও ছবি -- সহায়তার জন্য ছবির Alt টেক্সট +- স্পষ্ট শিরোনাম কাঠামো বজায় রাখুন +- ভাষা নির্দিষ্ট কোড ব্লক ব্যবহার করুন +- অতিরিক্ত রিসোর্সের লিঙ্ক দিন +- `images/` ডিরেক্টরিতে স্ক্রিনশট ও ছবি রাখুন +- অ্যাক্সেসিবিলিটির জন্য ইমেজের জন্য Alt টেক্সট দিন -### ফাইল সংগঠন +### File Organization -- পাঠ নম্বর ক্রম অনুসারে (1-getting-started-lessons, 2-js-basics, ইত্যাদি) -- প্রতিটি প্রকল্পে `solution/` এবং প্রায়ই `start/` বা `your-work/` ডিরেক্টরি থাকে -- পাঠ নির্দিষ্ট `images/` ফোল্ডারে ছবি সংরক্ষণ -- অনুবাদ `translations/{language-code}/` কাঠামোতে +- পাঠগুলো ধারাবাহিক নম্বর অনুসারে (১-getting-started-lessons, ২-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 টি Azure Static Web Apps ডিপ্লয়মেন্টের জন্য কনফিগার করা হয়েছে: ```bash cd quiz-app npm run build # dist/ ফোল্ডার তৈরি করে -# main-এ push করার সময় GitHub Actions workflow এর মাধ্যমে ডিপ্লয় করে +# মেইন ব্রাঞ্চে পুশ করার মাধ্যমে GitHub Actions ওয়ার্কফ্লো দ্বারা ডিপ্লয় করে ``` -Azure Static Web Apps কনফিগারেশন: -- **অ্যাপ লোকেশন**: `/quiz-app` -- **আউটপুট লোকেশন**: `dist` -- **ওয়ার্কফ্লো**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Azure Static Web Apps কনফিগারেশন: +- **অ্যাপ অবস্থান**: `/quiz-app` +- **আউটপুট অবস্থান**: `dist` +- **ওয়ার্কফ্লো**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### ডকুমেন্টেশন PDF তৈরি +### Documentation PDF Generation ```bash npm install # docsify-to-pdf ইনস্টল করুন -npm run convert # ডকস থেকে পিডিএফ তৈরি করুন +npm run convert # ডকস থেকে PDF তৈরি করুন ``` -### Docsify ডকুমেন্টেশন +### Docsify Documentation ```bash -npm install -g docsify-cli # ডক্সিফাই গ্লোবালি ইনস্টল করুন -docsify serve # লোকালহোস্ট:৩০০০ এ সার্ভ করুন +npm install -g docsify-cli # গ্লোবালি Docsify ইনস্টল করুন +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 এর জন্য স্প্যানিশ অনুবাদ যোগ` -- `[Docs] সেটআপ নির্দেশাবলী আপডেট` +পরিবর্তনের ক্ষেত্রটি স্পষ্টভাবে বুঝিয়ে শিরোনাম দিন: +- `[Quiz-app] পাঠ X এর জন্য নতুন কুইজ যুক্ত করুন` +- `[Lesson-3] টেরারিয়াম প্রকল্পের টাইপো ঠিক করুন` +- `[Translation] পাঠ ৫ এর জন্য স্প্যানিশ অনুবাদ যোগ করুন` +- `[Docs] সেটআপ নির্দেশাবলী আপডেট করুন` -### প্রয়োজনীয় পরীক্ষাসমূহ +### Required Checks -পিআর জমা দেওয়ার আগে: +PR সাবমিট করার আগে: -1. **কোড মান**: - - প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান - - সব লিন্ট ত্রুটি ও সতর্কতা নিরসন করুন +১. **কোড মান**: +   - প্রভাবিত প্রকল্প ডিরেক্টরিতে `npm run lint` চালান +   - সব লিন্টিং ত্রুটি এবং সতর্কতা সংশোধন করুন -2. **বিল্ড যাচাই**: - - প্রযোজ্য হলে `npm run build` চালান - - কোন বিল্ড ত্রুটি নেই তা নিশ্চিত করুন +২. **বিল্ড যাচাই**: +   - প্রয়োজনে `npm run build` চালান +   - কোন বিল্ড ত্রুটি নেই কিনা নিশ্চিত করুন -3. **লিঙ্ক যাচাই**: - - সব মারকডাউন লিঙ্ক পরীক্ষা করুন - - ছবি রেফারেন্স সঠিক কাজ করছে কিনা দেখুন +৩. **লিঙ্ক যাচাই**: +   - সব মার্কডাউন লিঙ্ক পরীক্ষা করুন +   - ইমেজ রেফারেন্স ঠিক আছে কিনা নিশ্চিত করুন -4. **বিষয়বস্তু পর্যালোচনা**: - - বানান ও ব্যাকরণ পরীক্ষা করুন - - কোড উদাহরণ সঠিক এবং শিক্ষণীয় কিনা নিশ্চিত করুন - - অনুবাদগুলি মূল অর্থ বজায় রেখেছে কিনা যাচাই করুন +৪. **বিষয়বস্তু পর্যালোচনা**: +   - বানান ও ব্যাকরণ পরীক্ষা করুন +   - কোড উদাহরণ সঠিক ও শিক্ষামূলক কিনা নিশ্চিত করুন +   - অনুবাদ মূল মান অর্থ ঠিক রাখে কিনা যাচাই করুন -### অবদান শর্তাবলী +### Contribution Requirements -- Microsoft CLA এ সম্মতি (প্রথম PR এ স্বয়ংক্রিয় পরীক্ষা) -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) অনুসরণ করুন -- বিস্তারিত নির্দেশনার জন্য [CONTRIBUTING.md](./CONTRIBUTING.md) দেখুন -- প্রযোজ্য ক্ষেত্রে ইস্যু নম্বর পিআর বর্ণনায় উল্লেখ করুন +- Microsoft CLA অনুদানে সম্মত হন (প্রথম PR এ স্বয়ংক্রিয় চেক) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) অনুসরণ করুন +- বিস্তারিত নির্দেশনার জন্য [CONTRIBUTING.md](./CONTRIBUTING.md) দেখুন +- প্রয়োজন হলে PR বর্ণনায় ইস্যু নম্বর উল্লেখ করুন -### পর্যালোচনা প্রক্রিয়া +### Review Process -- পিআর গুলো রক্ষণাবেক্ষক এবং কমিউনিটির দ্বারা পর্যালোচনা করা হয় -- শিক্ষণীয় স্পষ্টতা অগ্রাধিকার পায় -- কোড উদাহরণ বর্তমান সেরা অনুশীলন অনুসরণ করা উচিত -- অনুবাদ সঠিকতা এবং সাংস্কৃতিক উপযোগিতা যাচাই করা হয় +- PR গুলো রক্ষণাবেক্ষক ও কমিউনিটির দ্বারা পর্যালোচনা হয় +- শিক্ষামূলক স্পষ্টতায় গুরুত্ব দেওয়া হয় +- কোড উদাহরণগুলি সর্বশেষ শ্রেষ্ঠ অনুশীলন অনুসরণ করবে +- অনুবাদ সঠিকতা ও সাংস্কৃতিক প্রাসঙ্গিকতা যাচাই করা হয় -## অনুবাদ ব্যবস্থা +## Translation System -### স্বয়ংক্রিয় অনুবাদ +### Automated Translation -- GitHub Actions এর co-op-translator ওয়ার্কফ্লো ব্যবহার করে -- ৫০+ ভাষায় স্বয়ংক্রিয় অনুবাদ -- মূল ফাইলসমূহ প্রধান ডিরেক্টরিতে থাকে -- অনূদিত ফাইল `translations/{language-code}/` ডিরেক্টরিতে থাকে +- GitHub Actions এর co-op-translator ওয়ার্কফ্লো ব্যবহার +- স্বয়ংক্রিয়ভাবে ৫০+ ভাষায় অনুবাদ +- মূল ফাইল প্রধান ডিরেক্টরিতে থাকে +- অনূদিত ফাইল `translations/{language-code}/` ডিরেক্টরিতে থাকে -### ম্যানুয়াল অনুবাদ উন্নতি যোগ করা +### Adding Manual Translation Improvements -1. `translations/{language-code}/` এ ফাইল খুঁজে বের করুন -2. কাঠামো বজায় রেখে উন্নতি করুন -3. কোড উদাহরণ কার্যকর থাকা নিশ্চিত করুন -4. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন +১. `translations/{language-code}/` ডিরেক্টরিতে ফাইলটি খুঁজুন +২. কাঠামো বজায় রেখে উন্নতি করুন +৩. কোড উদাহরণগুলোর কার্যকারিতা বজায় রাখুন +৪. স্থানীয়কৃত কুইজ বিষয়বস্তু পরীক্ষা করুন -### অনুবাদ মেটাডেটা +### Translation Metadata -অনূদিত ফাইলগুলিতে মেটাডেটা হেডার থাকে: +অনূদিত ফাইলগুলিতে মেটাডেটা হেডার থাকে: ```markdown ``` -## ডিবাগিং এবং সমস্যা সমাধান +## Debugging and Troubleshooting -### সাধারণ সমস্যা +### Common Issues -**Quiz app চালু হয় না**: -- Node.js সংস্করণ পরীক্ষা করুন (v14+ সুপারিশকৃত) -- `node_modules` এবং `package-lock.json` মুছে `npm install` পুনরায় চালান -- পোর্ট সংঘর্ষ পরীক্ষা করুন (ডিফল্ট: Vite পোর্ট ৫১৭৩ ব্যবহার করে) +**কুইজ অ্যাপ শুরু হয় না**: +- Node.js সংস্করণ পরীক্ষা করুন (v14+ প্রস্তাবিত) +- `node_modules` এবং `package-lock.json` মুছে পুনরায় `npm install` চালান +- পোর্ট সংঘর্ষ পরীক্ষা করুন (ডিফল্ট: Vite পোর্ট ৫১৭৩) -**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 পরিবেশ ভেরিয়েবল সেট আছে নিশ্চিত করুন -- GitHub Models অ্যাক্সেস অনুমতি যাচাই করুন +**পাইথন চ্যাট প্রকল্প সমস্যা**: +- নিশ্চিত করুন OpenAI প্যাকেজ ইনস্টল হয়েছে: `pip install openai` +- GITHUB_TOKEN পরিবেশ ভেরিয়েবল সেট করা আছে +- GitHub Models অ্যাক্সেস অনুমতি পরীক্ষা করুন -**Docsify ডকস পরিবেশন করে না**: -- গ্লোবাল docsify-cli ইনস্টল করুন: `npm install -g docsify-cli` -- রিপোজিটোরির রুট ডিরেক্টরি থেকে চালান -- `docs/_sidebar.md` ফাইল আছে নিশ্চিত করুন +**Docsify ডকুমেন্টেশন পরিবেশন করে না**: +- docsify-cli গ্লোবালি ইনস্টল করুন: `npm install -g docsify-cli` +- রেপোজিটরি রুট থেকে চালান +- `docs/_sidebar.md` ফাইল আছে কিনা যাচাই করুন -### ডেভেলপমেন্ট পরিবেশ টিপস +### Development Environment Tips -- HTML প্রকল্পের জন্য VS Code এর Live Server এক্সটেনশন ব্যবহার করুন -- ধারাবাহিক ফরম্যাটিং এর জন্য ESLint এবং Prettier এক্সটেনশন ইনস্টল করুন -- জাভাস্ক্রিপ্ট ডিবাগিং এর জন্য ব্রাউজার ডেভটুলস ব্যবহার করুন -- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন +- HTML প্রকল্পের জন্য VS Code Live Server এক্সটেনশন ব্যবহার করুন +- সামঞ্জস্যপূর্ণ ফরম্যাটের জন্য ESLint এবং Prettier এক্সটেনশন ইনস্টল করুন +- জাভাস্ক্রিপ্ট ডিবাগ করার জন্য ব্রাউজার DevTools ব্যবহার করুন +- Vue প্রকল্পের জন্য Vue DevTools ব্রাউজার এক্সটেনশন ইনস্টল করুন -### কর্মক্ষমতা বিবেচনা +### Performance Considerations -- ৫০+ ভাষার প্রচুর অনূদিত ফাইল থাকার কারণে সম্পূর্ণ ক্লোন বড় হতে পারে -- শুধুমাত্র বিষয়বস্তু নিয়ে কাজ করলে shallow clone ব্যবহার করুন: `git clone --depth 1` -- ইংরেজি বিষয়বস্তুতে কাজ করার সময় অনুবাদগুলি অনুসন্ধান থেকে বাদ দিন -- প্রথমবার রান করার সময় বিল্ড প্রক্রিয়া ধীর হতে পারে (npm install, Vite build) +- অনুবাদ ফাইলের সংখ্যা বেশি (৫০+ ভাষা) হওয়ায় ফুলো ক্লোন বড় হয় +- শুধুমাত্র বিষয়বস্তুতে কাজ করলে শ্যালো ক্লোন ব্যবহার করুন: `git clone --depth 1` +- ইংরেজি বিষয়বস্তুতে কাজ করার সময় অনুবাদ ফাইল অনুসন্ধান থেকে বাদ দিন +- প্রথম রান-এ বিল্ড প্রক্রিয়া ধীর হতে পারে (npm install, Vite build) -## নিরাপত্তা বিবেচনা +## Security Considerations -### পরিবেশ ভেরিয়েবলস +### Environment Variables -- API কী কখনো রিপোজিটোরিতে কমিট করবেন না -- `.env` ফাইল ব্যবহার করুন (যা `.gitignore` এ আছে) -- প্রকল্প README ফাইলে প্রয়োজনীয় পরিবেশ ভেরিয়েবলস ডকুমেন্ট করুন +- API কী গুলি কখনো রেপোজিটরিতে কমিট করবেন না +- `.env` ফাইল ব্যবহার করুন (যা `.gitignore` এ আছে) +- প্রকল্প README ফাইলে প্রয়োজনীয় পরিবেশ ভেরিয়েবল ডকুমেন্ট করুন -### Python প্রকল্পসমূহ +### Python Projects -- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv` -- নির্ভরশীলতা হালনাগাদ রাখুন -- GitHub টোকেনগুলিতে সর্বনিম্ন প্রয়োজনীয় অনুমতি থাকা উচিত +- ভার্চুয়াল এনভায়রনমেন্ট ব্যবহার করুন: `python -m venv venv` +- নির্ভরশীলতা আপ টু ডেট রাখুন +- GitHub টোকেনগুলির সর্বনিম্ন প্রয়োজনীয় অনুমতি থাকা উচিত -### GitHub Models অ্যাক্সেস +### GitHub Models Access -- GitHub Models ব্যবহারের জন্য Personal Access Tokens (PAT) প্রয়োজন -- টোকেনগুলি পরিবেশ ভেরিয়েবল হিসেবে সংরক্ষণ করুন -- কখনো টোকেন বা ক্রেডেনশিয়াল কমিট করবেন না +- GitHub Models-এ ব্যবহারের জন্য Personal Access Tokens (PAT) প্রয়োজন +- টোকেনগুলো পরিবেশ ভেরিয়েবল হিসাবে সংরক্ষণ করুন +- কখনো টোকেন বা ক্রিডেনশিয়ালস কমিট করবেন না -## অতিরিক্ত নোট +## Additional Notes -### লক্ষ্য শ্রোতা +### Target Audience -- ওয়েব ডেভেলপমেন্টে সম্পূর্ণ শিক্ষানবিশ -- ছাত্র ও স্বশিক্ষার্থীরা -- শ্রেণিকক্ষে পাঠ্যক্রম ব্যবহারকারী শিক্ষকগণ -- বিষয়বস্তু অ্যাক্সেসযোগ্যতা এবং ধাপে ধাপে দক্ষতা গঠনের জন্য ডিজাইন করা +- ওয়েব ডেভেলপমেন্টের সম্পূর্ণ শিক্ষানবিশ +- ছাত্র-ছাত্রী এবং স্বশিক্ষার্থীরা +- শ্রেণিকক্ষে এই পাঠক্রম ব্যবহারকারী শিক্ষক +- বিষয়বস্তু অ্যাক্সেসযোগ্য এবং ধীরে ধীরে দক্ষতা বৃদ্ধির জন্য ডিজাইন করা হয়েছে -### শিক্ষাগত দর্শন +### Educational Philosophy -- প্রকল্প ভিত্তিক শেখার পদ্ধতি -- নিয়মিত জ্ঞান পর্যালোচনা (কুইজ) -- হাতে-কলমে কোডিং অনুশীলন -- বাস্তব বিশ্বের প্রয়োগ উদাহরণ -- ফ্রেমওয়ার্কের আগে মৌলিক বিষয়ের উপর জোর +- প্রকল্প-ভিত্তিক শেখার পদ্ধতি +- নিয়মিত জ্ঞানের পরীক্ষা (কুইজ) +- হাতে-কলমে কোডিং অনুশীলন +- বাস্তব জীবনের উদাহরণ +- ফ্রেমওয়ার্কের আগে মৌলিক বিষয়গুলিতে জোর -### সংরক্ষণাগার রক্ষণাবেক্ষণ +### Repository Maintenance -- সক্রিয় শিক্ষার্থী ও অবদানকারীদের কমিউনিটি -- নির্ভরশীলতা ও বিষয়বস্তু নিয়মিত আপডেট -- রক্ষণাবেক্ষক দ্বারা ইস্যু এবং আলোচনা পর্যবেক্ষণ -- অনুবাদ আপডেট স্বয়ংক্রিয় via GitHub Actions +- শিখতে চাওয়া ও অবদানকারীদের সক্রিয় কমিউনিটি +- নির্ভরশীলতা ও বিষয়বস্তু নিয়মিত আপডেট হয় +- রক্ষণাবেক্ষক দ্বারা ইস্যু ও আলোচনা পর্যবেক্ষণ করা হয় +- অনুবাদ আপডেট গিটহাব অ্যাকশনস দ্বারা স্বয়ংক্রিয়ভাবে হয় -### সম্পর্কিত সম্পদসমূহ +### Related Resources -- [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 পাঠ্যক্রম উপলব্ধ +- [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 পাঠক্রম উপলব্ধ -### নির্দিষ্ট প্রকল্প নিয়ে কাজ +### Working with Specific Projects -ব্যক্তিগত প্রকল্পগুলোর বিস্তারিত নির্দেশনার জন্য, নিম্নলিখিত README ফাইল দেখুন: -- `quiz-app/README.md` - Vue 3 কুইজ অ্যাপ্লিকেশন -- `7-bank-project/README.md` - অথেন্টিকেশন সহ ব্যাংকিং অ্যাপ্লিকেশন -- `5-browser-extension/README.md` - ব্রাউজার এক্সটেনশন ডেভেলপমেন্ট -- `6-space-game/README.md` - ক্যানভাস-ভিত্তিক গেম ডেভেলপমেন্ট -- `9-chat-project/README.md` - AI চ্যাট সহকারী প্রকল্প +নির্দিষ্ট প্রকল্পের বিস্তারিত নির্দেশনা জন্য সংশ্লিষ্ট 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 চ্যাট সহকারী প্রকল্প -### মনোরিপো কাঠামো +### 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 diff --git a/translations/hi/.co-op-translator.json b/translations/hi/.co-op-translator.json index bd2210793..1919d9222 100644 --- a/translations/hi/.co-op-translator.json +++ b/translations/hi/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:07:14+00:00", + "translation_date": "2026-02-06T11:14:03+00:00", "source_file": "AGENTS.md", "language_code": "hi" }, diff --git a/translations/hi/AGENTS.md b/translations/hi/AGENTS.md index 6bb87ef6a..6715ff4b4 100644 --- a/translations/hi/AGENTS.md +++ b/translations/hi/AGENTS.md @@ -2,42 +2,42 @@ ## परियोजना अवलोकन -यह शुरुआती लोगों को वेब विकास के मूलभूत सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉज़िटरी है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ शामिल हैं। +यह शुरुआती लोगों को वेब विकास के मूल सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपोजिटरी है। यह पाठ्यक्रम एक व्यापक 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 हैंड्स-ऑन लेसन शामिल हैं। ### मुख्य घटक -- **शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ -- **व्यावहारिक प्रोजेक्ट्स**: टेरियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और AI चैट सहायक -- **इंटरैक्टिव क्विज़**: 48 क्विज़, हर एक में 3 प्रश्न (पाठ से पहले/बाद के आकलन) -- **मल्टी-भाषा समर्थन**: GitHub Actions द्वारा 50+ भाषाओं में स्वचालित अनुवाद -- **प्रौद्योगिकियां**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रोजेक्ट्स के लिए) +- **शैक्षिक सामग्री**: 24 संरचित लेसन जिन्हें प्रोजेक्ट-आधारित मॉड्यूल में व्यवस्थित किया गया है +- **प्रायोगिक प्रोजेक्ट्स**: टेरारियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड एडिटर, और AI चैट सहायक +- **इंटरैक्टिव क्विज़**: 48 क्विज़ हर एक में 3 प्रश्न (प्री/पोस्ट-लेसन आकलन) +- **बहुभाषी समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए ऑटोमैटिक अनुवाद +- **प्रौद्योगिकियाँ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI प्रोजेक्ट्स के लिए) ### वास्तुकला -- पाठ आधारित संरचना के साथ शैक्षिक रिपॉज़िटरी -- प्रत्येक पाठ फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं -- अलग-अलग निर्देशिकाओं में स्टैंडअलोन प्रोजेक्ट्स (quiz-app, विभिन्न पाठ प्रोजेक्ट्स) -- GitHub Actions (co-op-translator) का उपयोग करते हुए अनुवाद प्रणाली -- Docsify के माध्यम से दस्तावेज़ीकरण सेवा और PDF के रूप में उपलब्ध +- लेसन-आधारित संरचना वाला शैक्षिक रिपोजिटरी +- प्रत्येक लेसन फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं +- स्वतंत्र प्रोजेक्ट्स अलग-अलग डायरेक्टरीज़ में (quiz-app, विभिन्न लेसन प्रोजेक्ट्स) +- ट्रांसलेशन सिस्टम GitHub Actions (co-op-translator) का उपयोग करता है +- डॉक्यूमेंटेशन Docsify के माध्यम से प्रदान किया जाता है और PDF के रूप में भी उपलब्ध है ## सेटअप कमांड्स -यह रिपॉज़िटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए: +यह रिपोजिटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट प्रोजेक्ट्स पर काम करने के लिए: -### मुख्य रिपॉज़िटरी सेटअप +### मुख्य रिपोजिटरी सेटअप ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git 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,9 +46,9 @@ npm run lint # ESLint चलाएं ```bash cd 7-bank-project/api npm install -npm start # एपीआई सर्वर शुरू करें +npm start # API सर्वर शुरू करें npm run lint # ESLint चलाएं -npm run format # Prettier के साथ स्वरूपित करें +npm run format # Prettier के साथ फॉर्मेट करें ``` ### ब्राउज़र एक्सटेंशन प्रोजेक्ट्स @@ -64,10 +64,10 @@ npm install ```bash cd 6-space-game/solution npm install -# index.html ब्राउज़र में खोलें या Live Server का उपयोग करें +# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें ``` -### चैट प्रोजेक्ट (Python Backend) +### चैट प्रोजेक्ट (Python बैकएंड) ```bash cd 9-chat-project/solution/backend/python @@ -80,112 +80,112 @@ 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 परीक्षण ```bash cd 7-bank-project/api -npm run lint # कोड स्टाइल समस्याओं की जांच करें -node server.js # सुनिश्चित करें कि सर्वर बिना त्रुटियों के शुरू हो रहा है +npm run lint # कोड शैली की समस्याओं की जांच करें +node server.js # सत्यापित करें कि सर्वर बिना त्रुटियों के शुरू होता है ``` ### सामान्य परीक्षण दृष्टिकोण -- यह एक शैक्षिक रिपॉज़िटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं -- मैनुअल परीक्षण पर फोकस है: - - कोड उदाहरण बिना त्रुटि के चलें - - दस्तावेज़ में लिंक ठीक से काम करें - - प्रोजेक्ट बिल्ड सफलतापूर्वक पूरी हों - - उदाहरण सर्वोत्तम प्रथाओं का पालन करें +- यह एक शैक्षिक रिपोजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं +- मैनुअल परीक्षण मुख्य रूप से निम्न पर केंद्रित है: + - कोड उदाहरण त्रुटि के बिना चलते हैं + - डॉक्यूमेंटेशन में लिंक सही ढंग से काम करते हैं + - प्रोजेक्ट बिल्ड सफलतापूर्वक पूरा होते हैं + - उदाहरण सर्वोत्तम प्रथाओं का पालन करते हैं -### पूर्व-प्रस्तुति जांच +### पूर्व-प्रस्तुति चेक्स -- package.json के साथ निर्देशिकाओं में `npm run lint` चलाएं -- मार्कडाउन लिंक की वैधता सत्यापित करें +- पैकेज.json वाली डायरेक्ट्रीज़ में `npm run lint` चलाएं +- मार्कडाउन लिंक वैध हैं यह सत्यापित करें - ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें -- जांचें कि अनुवाद संरचना सही बनाए रखें +- जांचें कि अनुवाद संरचना बनाए रखते हैं ## कोड स्टाइल दिशानिर्देश ### JavaScript -- आधुनिक ES6+ सिंटैक्स का उपयोग करें +- आधुनिक ES6+ वाक्य रचना का उपयोग करें - प्रोजेक्ट्स में उपलब्ध मानक ESLint कॉन्फ़िगरेशन का पालन करें -- शैक्षिक स्पष्टता के लिए सार्थक चर और फ़ंक्शन नाम उपयोग करें -- शिक्षार्थियों के लिए अवधारणाओं की व्याख्या करते हुए टिप्पणियां जोड़ें -- जहां कॉन्फ़िगर किया गया हो Prettier का उपयोग करें +- शैक्षिक स्पष्टता के लिए अर्थपूर्ण वेरिएबल और फंक्शन नामों का उपयोग करें +- शिक्षार्थियों के लिए अवधारणाओं को समझाने वाले कमेंट्स जोड़ें +- जहां आवश्यक हो Prettier से फॉर्मेट करें ### HTML/CSS -- सेमान्टिक HTML5 तत्व -- उत्तरदायी डिजाइन सिद्धांत -- स्पष्ट क्लास नामकरण कन्वेंशन्स -- CSS तकनीकों को समझाते हुए टिप्पणियां शिक्षार्थियों के लिए +- सेमांटिक HTML5 तत्वों का उपयोग +- रिस्पॉन्सिव डिजाइन सिद्धांतों का पालन +- स्पष्ट क्लास नामकरण सम्मेलन +- शिक्षार्थियों के लिए CSS तकनीकों को समझाने वाले कमेंट्स ### Python -- PEP 8 स्टाइल दिशानिर्देश +- PEP 8 शैली दिशानिर्देशों का पालन करें - स्पष्ट, शैक्षिक कोड उदाहरण -- जहां उपयोगी हो, टाइप हिंट्स +- सीखने में मदद के लिए जहां सहायक हो टाइप हिंट्स -### Markdown दस्तावेज़ीकरण +### मार्कडाउन डॉक्यूमेंटेशन -- स्पष्ट शीर्षक संरचना -- भाषा विनिर्देशन के साथ कोड ब्लॉक +- स्पष्ट हेडिंग संरचना +- भाषा विनिर्देशन के साथ कोड ब्लॉक्स - अतिरिक्त संसाधनों के लिंक -- `images/` निर्देशिकाओं में स्क्रीनशॉट और चित्र -- छवियों के लिए वैकल्पिक पाठ (alt text) पहुंच योग्यता के लिए +- `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) -क्विज ऐप Azure Static Web Apps तैनाती के लिए कॉन्फ़िगर किया गया है: +क्विज-ऐप Azure Static Web Apps परिनियोजन के लिए कॉन्फ़िगर है: ```bash cd quiz-app npm run build # dist/ फ़ोल्डर बनाता है -# मुख्य ब्रांच पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है +# मुख्य शाखा पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है ``` 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 install # docsify-to-pdf इंस्टॉल करें +npm run convert # docs से PDF बनाएं ``` -### Docsify दस्तावेज़ीकरण +### Docsify डॉक्यूमेंटेशन ```bash -npm install -g docsify-cli # Docsify को वैश्विक रूप से इंस्टॉल करें +npm install -g docsify-cli # Docisfy को वैश्विक रूप से इंस्टॉल करें 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] लेसन 5 के लिए स्पैनिश अनुवाद जोड़ें` - `[Docs] सेटअप निर्देश अपडेट करें` -### आवश्यक जांच +### आवश्यक जांचें PR सबमिट करने से पहले: 1. **कोड गुणवत्ता**: - - प्रभावित प्रोजेक्ट निर्देशिकाओं में `npm run lint` चलाएं - - सभी लिंट त्रुटियों और चेतावनियों को ठीक करें + - प्रभावित प्रोजेक्ट डायरेक्टरीज में `npm run lint` चलाएं + - सभी लिंटिंग त्रुटि और वार्निंग्स को ठीक करें -2. **निर्माण सत्यापन**: +2. **बिल्ड सत्यापन**: - उपयुक्त होने पर `npm run build` चलाएं - - सुनिश्चित करें कि बिल्ड त्रुटि नहीं है + - सुनिश्चित करें कि बिल्ड त्रुटियां न हों -3. **लिंक सत्यापन**: - - सभी मार्कडाउन लिंक जांचें - - चित्र संदर्भ ठीक काम करें +3. **लिंक मान्यता**: + - सभी मार्कडाउन लिंक का परीक्षण करें + - छवि संदर्भों की जांच करें 4. **सामग्री समीक्षा**: - - वर्तनी और व्याकरण जांचें - - कोड उदाहरण सही और शैक्षिक हों - - अनुवाद मूल अर्थ को कायम रखें + - वर्तनी और व्याकरण की जांच करें + - सुनिश्चित करें कि कोड उदाहरण सही और शैक्षिक हैं + - अनुवाद मूल अर्थ बनाए रखें -### योगदान आवश्यकताएँ +### योगदान आवश्यकताएं -- Microsoft CLA (पहली PR पर स्वचालित जांच) से सहमति -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) का पालन -- विस्तृत दिशानिर्देश के लिए [CONTRIBUTING.md](./CONTRIBUTING.md) देखें -- जहां लागू हो, PR विवरण में मुद्दा संख्या का संदर्भ दें +- Microsoft CLA से सहमति दें (पहले PR पर स्वचालित जांच) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) का पालन करें +- विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](./CONTRIBUTING.md) देखें +- यदि लागू हो तो PR विवरण में इश्यू नंबर का संदर्भ दें ### समीक्षा प्रक्रिया -- PR का संयोजकों और समुदाय द्वारा समीक्षा +- PR की समीक्षा मेंटेनर्स और समुदाय द्वारा की जाएगी - शैक्षिक स्पष्टता को प्राथमिकता दी जाती है -- कोड उदाहरण वर्तमान सर्वोत्तम प्रथाओं का पालन करें -- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा की जाती है +- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए +- अनुवादों की सटीकता और सांस्कृतिक उपयुक्तता की समीक्षा की जाती है ## अनुवाद प्रणाली ### स्वचालित अनुवाद -- GitHub Actions के साथ co-op-translator वर्कफ़्लो उपयोग करता है -- 50+ भाषाओं में स्वचालित अनुवाद करता है -- मुख्य निर्देशिकाओं में स्रोत फ़ाइलें -- `translations/{language-code}/` निर्देशिकाओं में अनुवादित फ़ाइलें +- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग करता है +- 50+ भाषाओं के लिए स्वचालित अनुवाद करता है +- स्रोत फाइलें मुख्य डायरेक्टरीज़ में हैं +- अनूदित फाइलें `translations/{language-code}/` डायरेक्टरीज़ में ### मैनुअल अनुवाद सुधार जोड़ना -1. `translations/{language-code}/` में फ़ाइल ढूंढें +1. फाइल को `translations/{language-code}/` में खोजें 2. संरचना बनाए रखते हुए सुधार करें -3. सुनिश्चित करें कि कोड उदाहरण कार्यशील रहें -4. किसी भी स्थानीयकृत क्विज़ सामग्री का परीक्षण करें +3. सुनिश्चित करें कि कोड उदाहरण कार्यशील बने रहें +4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें ### अनुवाद मेटाडेटा -अनुवादित फ़ाइलों में मेटाडेटा हेडर शामिल होता है: +अनूदित फाइलों में मेटाडेटा हेडर शामिल होता है: ```markdown **अस्वीकरण**: -यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनुवादित किया गया है। हम सटीकता के लिए प्रयासरत हैं, लेकिन कृपया ध्यान दें कि स्वचालित अनुवाद में त्रुटियाँ या असत्यताएँ हो सकती हैं। मूल भाषा में दस्तावेज़ को अधिकारिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम जिम्मेदार नहीं हैं। +यह दस्तावेज़ एआई अनुवादन सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) का उपयोग करके अनूदित किया गया है। हम सटीकता का प्रयास करते हैं, लेकिन कृपया ध्यान दें कि स्वचालित अनुवादों में त्रुटियां या असत्यताएं हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में प्राधिकारी स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए पेशेवर मानव अनुवाद की सलाह दी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या व्याख्या के लिए हम उत्तरदायी नहीं हैं। \ No newline at end of file diff --git a/translations/ko/.co-op-translator.json b/translations/ko/.co-op-translator.json index 54a4c5800..a96d73faf 100644 --- a/translations/ko/.co-op-translator.json +++ b/translations/ko/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:06:05+00:00", + "translation_date": "2026-02-06T11:12:54+00:00", "source_file": "AGENTS.md", "language_code": "ko" }, diff --git a/translations/ko/AGENTS.md b/translations/ko/AGENTS.md index 91ac434f0..df383f9a6 100644 --- a/translations/ko/AGENTS.md +++ b/translations/ko/AGENTS.md @@ -2,27 +2,27 @@ ## 프로젝트 개요 -이 저장소는 초보자에게 웹 개발 기초를 가르치기 위한 교육 커리큘럼 저장소입니다. 이 커리큘럼은 Microsoft Cloud Advocates가 개발한 종합적인 12주 과정으로, JavaScript, CSS, HTML을 다루는 24개의 실습 수업으로 구성되어 있습니다. +이 저장소는 초보자를 위한 웹 개발 기본 교육 커리큘럼 저장소입니다. 이 커리큘럼은 Microsoft Cloud Advocates가 개발한 12주 과정의 종합 교육 과정으로, JavaScript, CSS, HTML을 다루는 24개의 실습 중심 수업으로 구성되어 있습니다. ### 주요 구성 요소 -- **교육 콘텐츠**: 프로젝트 기반 모듈로 조직된 24개의 구조화된 수업 -- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 뱅킹 앱, 코드 편집기, AI 채팅 도우미 -- **인터랙티브 퀴즈**: 각 3문항씩 48개의 퀴즈 (수업 전/후 평가) +- **교육 콘텐츠**: 프로젝트 기반 모듈로 구성된 24개의 체계적인 수업 +- **실습 프로젝트**: 테라리움, 타이핑 게임, 브라우저 확장, 우주 게임, 은행 앱, 코드 편집기 및 AI 채팅 어시스턴트 +- **인터랙티브 퀴즈**: 각 3문항씩 포함된 48개의 퀴즈 (수업 전/후 평가) - **다국어 지원**: GitHub Actions를 통한 50개 이상의 언어 자동 번역 - **기술 스택**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI 프로젝트용) ### 아키텍처 - 수업 기반 구조의 교육용 저장소 -- 각 수업 폴더에는 README, 코드 예제, 솔루션 포함 -- quiz-app, 여러 수업 프로젝트와 같이 독립 프로젝트 별도 디렉터리 +- 각 수업 폴더에 README, 코드 예제 및 솔루션 포함 +- 독립형 프로젝트들은 별도의 디렉토리에 위치 (quiz-app, 다양한 수업 프로젝트) - GitHub Actions (co-op-translator)를 이용한 번역 시스템 -- Docsify로 제공되는 문서 및 PDF 형태로 이용 가능 +- 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 실행 ``` @@ -56,7 +56,7 @@ npm run format # Prettier로 포맷팅 ```bash cd 5-browser-extension/solution npm install -# 브라우저 별 확장 프로그램 로딩 지침을 따르세요 +# 브라우저별 확장 프로그램 로딩 지침을 따르십시오 ``` ### 우주 게임 프로젝트 @@ -78,31 +78,31 @@ python api.py ## 개발 워크플로우 -### 콘텐츠 기여자를 위해 +### 콘텐츠 기여자용 -1. 저장소를 GitHub 계정으로 **포크**합니다. -2. 포크한 저장소를 로컬에 **클론**합니다. -3. 변경사항용으로 **새 브랜치**를 생성합니다. -4. 수업 콘텐츠 또는 코드 예제를 수정합니다. -5. 관련 프로젝트 디렉터리에서 코드 변경사항을 테스트합니다. +1. 저장소를 GitHub 계정으로 **포크(fork)** 합니다. +2. 포크한 저장소를 **로컬에 클론(clone)** 합니다. +3. 변경 사항을 위한 새로운 **브랜치 생성** 합니다. +4. 수업 콘텐츠나 코드 예제를 수정합니다. +5. 관련 프로젝트 디렉토리에서 코드 변경 사항을 테스트합니다. 6. 기여 가이드라인에 따라 풀 리퀘스트를 제출합니다. -### 학습자를 위해 +### 학습자용 1. 저장소를 포크하거나 클론합니다. -2. 수업 디렉터리를 순차적으로 이동합니다. +2. 수업 디렉토리를 순서대로 이동합니다. 3. 각 수업의 README 파일을 읽습니다. 4. https://ff-quizzes.netlify.app/web/ 에서 수업 전 퀴즈를 완료합니다. -5. 수업 폴더 내 코드 예제를 실행해 봅니다. -6. 과제 및 챌린지를 완료합니다. -7. 수업 후 퀴즈를 응시합니다. +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` 실행 ## 테스트 지침 @@ -118,77 +118,77 @@ npm run build # 빌드 성공 여부 확인 ```bash cd 7-bank-project/api -npm run lint # 코드 스타일 문제를 확인합니다 -node server.js # 서버가 오류 없이 시작되는지 확인합니다 +npm run lint # 코드 스타일 문제 확인 +node server.js # 오류 없이 서버가 시작되는지 확인 ``` ### 일반 테스트 접근법 -- 이 저장소는 교육용으로 포괄적인 자동화 테스트는 포함하지 않음 -- 수동 테스트는 다음에 중점: +- 본 저장소는 포괄적인 자동화 테스트는 없습니다. +- 수동 테스트는 다음에 중점 둡니다: - 코드 예제가 오류 없이 실행되는지 - - 문서 내 링크가 정상 작동하는지 - - 프로젝트 빌드가 성공적으로 완료되는지 - - 예제가 모범 사례를 따르는지 + - 문서 내 링크 작동 여부 + - 프로젝트 빌드가 정상 완료되는지 + - 예제가 최선의 실무 관행을 따르는지 -### 제출 전 점검 +### 사전 제출 체크 -- package.json이 있는 디렉터리에서 `npm run lint` 실행 -- 마크다운 링크가 유효한지 검증 -- 브라우저나 Node.js에서 코드 예제 테스트 -- 번역이 올바른 구조를 유지하는지 확인 +- package.json 있는 디렉토리에서 `npm run lint` 실행 +- 마크다운 링크 유효성 확인 +- 브라우저 또는 Node.js에서 코드 예제 테스트 +- 번역물의 구조 유지 확인 -## 코드 스타일 가이드라인 +## 코드 스타일 지침 ### JavaScript -- 최신 ES6+ 구문 사용 -- 프로젝트에 제공된 표준 ESLint 설정 준수 -- 교육적 명확성을 위해 의미 있는 변수 및 함수명 사용 -- 학습자를 위한 개념 설명 주석 추가 -- 설정된 경우 Prettier로 포맷팅 +- 최신 ES6+ 문법 사용 +- 프로젝트에서 제공하는 표준 ESLint 설정 준수 +- 교육 목적에 맞는 의미 있는 변수 및 함수명 사용 +- 학습자 이해를 돕는 주석 추가 +- 설정된 곳에서는 Prettier로 포맷팅 ### HTML/CSS -- 시멘틱 HTML5 요소 사용 +- 의미론적 HTML5 요소 사용 - 반응형 디자인 원칙 적용 - 명확한 클래스 명명 규칙 -- 학습자를 위한 CSS 기술 설명 주석 포함 +- CSS 기법에 관한 설명 주석 추가 ### Python - PEP 8 스타일 가이드 준수 -- 명확하고 교육적인 코드 예제 +- 교육용 명확한 코드 예제 제공 - 학습에 도움이 되는 타입 힌트 사용 ### 마크다운 문서화 -- 명확한 헤딩 계층 구조 -- 언어 지정 코드 블록 사용 -- 추가 자료에 대한 링크 포함 -- `images/` 폴더의 스크린샷 및 이미지 -- 접근성을 위한 이미지 대체 텍스트 +- 명확한 제목 계층 구조 +- 언어 명시가 있는 코드 블록 +- 추가 자료 링크 제공 +- `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/ 폴더를 생성합니다 +npm run build # dist/ 폴더를 만듭니다 # main 브랜치에 푸시할 때 GitHub Actions 워크플로를 통해 배포합니다 ``` -Azure Static Web Apps 구성: +Azure Static Web Apps 설정: - **앱 위치**: `/quiz-app` - **출력 위치**: `dist` - **워크플로우**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` @@ -203,80 +203,80 @@ npm run convert # docs에서 PDF 생성 ### Docsify 문서화 ```bash -npm install -g docsify-cli # Docsify를 전역에 설치 -docsify serve # localhost:3000에서 서비스 제공 +npm install -g docsify-cli # Docsify를 전역으로 설치합니다 +docsify serve # localhost:3000에서 서비스합니다 ``` ### 프로젝트별 빌드 -각 프로젝트 디렉터리는 자체 빌드 프로세스를 가질 수 있음: -- Vue 프로젝트: `npm run build`로 프로덕션 번들 생성 -- 정적 프로젝트: 빌드 단계 없음, 파일 직접 제공 +각 프로젝트 디렉토리는 자체 빌드 프로세스가 있을 수 있음: +- Vue 프로젝트: `npm run build` 로 배포용 번들 생성 +- 정적 프로젝트: 빌드 단계 없음, 파일 직접 서빙 ## 풀 리퀘스트 가이드라인 ### 제목 형식 -변경 영역을 명확히 나타내는 제목 사용: -- `[Quiz-app] 수업 X에 새 퀴즈 추가` -- `[Lesson-3] 테라리움 프로젝트 오타 수정` -- `[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 제출 전에: +PR 제출 전: 1. **코드 품질**: - - 관련 프로젝트 디렉터리에서 `npm run lint` 실행 + - 관련 프로젝트 디렉토리에서 `npm run lint` 실행 - 모든 린트 오류 및 경고 수정 -2. **빌드 검증**: - - 가능한 경우 `npm run build` 실행 +2. **빌드 확인**: + - 해당 시 `npm run build` 실행 - 빌드 오류 없음 확인 3. **링크 검증**: - 모든 마크다운 링크 테스트 - - 이미지 참조 정상 작동 확인 + - 이미지 참조 작동 확인 4. **내용 검토**: - - 맞춤법과 문법 교정 - - 코드 예제의 정확성 및 교육적 적합성 확인 - - 번역이 원래 의미를 유지하는지 검증 + - 맞춤법 및 문법 교정 + - 코드 예제의 정확성과 교육적 가치 확인 + - 번역물의 원 뜻 유지 여부 확인 -### 기여 조건 +### 기여 요건 -- Microsoft CLA 동의 (첫 PR에서 자동 검사) -- [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수 -- 자세한 가이드는 [CONTRIBUTING.md](./CONTRIBUTING.md) 참조 -- PR 설명에 관련 이슈 번호 참조 가능 +- Microsoft CLA 동의 (첫 PR 시 자동 검사) +- [Microsoft 오픈소스 행동 강령](https://opensource.microsoft.com/codeofconduct/) 준수 +- 자세한 지침은 [CONTRIBUTING.md](./CONTRIBUTING.md) 참고 +- PR 설명에 이슈 번호 참조 가능 시 명시 -### 검토 과정 +### 리뷰 프로세스 -- PR은 유지관리자 및 커뮤니티가 검토 -- 교육적 명확성 우선 -- 코드 예제는 최신 모범 사례 준수 필요 -- 번역은 정확성과 문화적 적합성 검토 +- PR은 메인테이너와 커뮤니티 리뷰 +- 교육적 명확성 최우선 +- 코드 예제는 최신 최선 관행 준수 필요 +- 번역 정확성과 문화적 적합성 검토 ## 번역 시스템 ### 자동 번역 -- GitHub Actions와 co-op-translator 워크플로우 사용 -- 50개 이상 언어로 자동 번역 지원 -- 소스 파일은 메인 디렉터리에 위치 -- 번역 파일은 `translations/{language-code}/`에 위치 +- GitHub Actions의 co-op-translator 워크플로우 사용 +- 50개 이상의 언어로 자동 번역 +- 소스 파일은 메인 디렉토리에 위치 +- 번역 파일은 `translations/{language-code}/` 에 저장 -### 수동 번역 개선 추가 방법 +### 수동 번역 개선 추가 -1. `translations/{language-code}/` 내 파일 위치 찾기 -2. 구조를 유지하며 개선 작업 수행 +1. `translations/{language-code}/` 내 파일 위치 확인 +2. 구조를 유지하며 개선 진행 3. 코드 예제가 정상 작동하는지 확인 -4. 현지화된 퀴즈 내용 테스트 +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