From 42b3f1dc20cc403803fafa24b4709e107b09d489 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 12:31:23 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes) --- translations/ur/.co-op-translator.json | 2 +- translations/ur/AGENTS.md | 440 +++++++++++----------- translations/zh-CN/.co-op-translator.json | 2 +- translations/zh-CN/AGENTS.md | 378 +++++++++---------- translations/zh-MO/.co-op-translator.json | 2 +- translations/zh-MO/AGENTS.md | 350 ++++++++--------- 6 files changed, 587 insertions(+), 587 deletions(-) diff --git a/translations/ur/.co-op-translator.json b/translations/ur/.co-op-translator.json index f0967886f..93fe3216f 100644 --- a/translations/ur/.co-op-translator.json +++ b/translations/ur/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:03:27+00:00", + "translation_date": "2026-02-06T12:29:19+00:00", "source_file": "AGENTS.md", "language_code": "ur" }, diff --git a/translations/ur/AGENTS.md b/translations/ur/AGENTS.md index 9ca386925..8d7f8d4cf 100644 --- a/translations/ur/AGENTS.md +++ b/translations/ur/AGENTS.md @@ -2,27 +2,27 @@ ## پروجیکٹ کا جائزہ -یہ ویب ڈیولپمنٹ کے بنیادی اصول نوجوانوں کو سکھانے کے لیے تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع 12 ہفتوں کا کورس ہے جسے Microsoft Cloud Advocates نے تیار کیا ہے، جس میں JavaScript، CSS، اور HTML پر مشتمل 24 عملی اسباق شامل ہیں۔ +یہ ابتدائیوں کے لیے ویب ڈویلپمنٹ کے بنیادی اصول سکھانے کے لیے ایک تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع 12 ہفتوں کا کورس ہے جو Microsoft Cloud Advocates نے تیار کیا ہے، جس میں 24 عملی اسباق شامل ہیں جو JavaScript، CSS، اور HTML کا احاطہ کرتے ہیں۔ -### کلیدی اجزاء +### اہم اجزاء -- **تعلیمی مواد**: 24 منظم اسباق جو پروجیکٹ کی بنیاد پر ماڈیولز میں ترتیب دیے گئے ہیں -- **عملی پروجیکٹس**: Terrarium، Typing Game، Browser Extension، Space Game، Banking App، Code Editor، اور AI Chat Assistant -- **انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے اور بعد کے جائزے) -- **کئی زبانوں کی حمایت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترجمے -- **ٹیکنالوجیز**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI پروجیکٹس کے لیے) +- **تعلیمی مواد**: 24 منظم اسباق جو پراجیکٹ پر مبنی ماڈیولز میں ترتیب دیے گئے ہیں +- **عملی پراجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بینکنگ ایپ، کوڈ ایڈیٹر، اور 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 کے طور پر دستیاب ## سیٹ اپ کمانڈز -یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پروجیکٹس پر کام کرنے کے لیے: +یہ ذخیرہ بنیادی طور پر تعلیمی مواد کے استعمال کے لیے ہے۔ مخصوص پراجیکٹس کے ساتھ کام کرنے کے لیے: ### مرکزی ذخیرہ سیٹ اپ @@ -31,35 +31,35 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Quiz App سیٹ اپ (Vue 3 + Vite) +### کوئز ایپ سیٹ اپ (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # سرور ترقی شروع کریں -npm run build # پیداوار کے لیے بنائیں +npm run dev # سرور کی ترقی شروع کریں +npm run build # پیداوار کے لئے تیار کریں npm run lint # ESLint چلائیں ``` -### Bank پروجیکٹ API (Node.js + Express) +### بینک پراجیکٹ API (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # اے پی آئی سرور شروع کریں -npm run lint # ای ایس لنٹ چلائیں -npm run format # پریٹیئر سے فارمیٹ کریں +npm start # API سرور شروع کریں +npm run lint # ESLint چلائیں +npm run format # Prettier کے ساتھ فارمیٹ کریں ``` -### Browser Extension پروجیکٹس +### براؤزر ایکسٹینشن پراجیکٹس ```bash cd 5-browser-extension/solution npm install -# براؤزر-مخصوص ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں +# براؤزر-مخصوص توسیع لوڈ کرنے کی ہدایات پر عمل کریں ``` -### Space Game پروجیکٹس +### اسپیس گیم پراجیکٹس ```bash cd 6-space-game/solution @@ -67,216 +67,216 @@ npm install # index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں ``` -### Chat پروجیکٹ (Python Backend) +### چیٹ پراجیکٹ (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. **ریپوزیٹری کو فورک کریں** اپنے 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**: quiz-app فولڈر میں `npm run dev` چلائیں -- **پروجیکٹس**: HTML پروجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں -- **API پروجیکٹس**: متعلقہ API فولڈرز میں `npm start` چلائیں +- **دستاویزی مواد**: روٹ پر `docsify serve` چلائیں (پورٹ 3000) +- **کوئز ایپ**: quiz-app ڈائریکٹری میں `npm run dev` چلائیں +- **پراجیکٹس**: HTML پراجیکٹس کے لیے VS Code Live Server ایکسٹینشن استعمال کریں +- **API پراجیکٹس**: متعلقہ API ڈائریکٹریز میں `npm start` چلائیں -## ٹیسٹنگ ہدایات +## ٹیسٹ کرنے کی ہدایات -### Quiz App کی ٹیسٹنگ +### کوئز ایپ ٹیسٹنگ ```bash cd quiz-app -npm run lint # کوڈ کے طرز کے مسائل چیک کریں -npm run build # تعمیر کی کامیابی کی تصدیق کریں +npm run lint # کوڈ اسٹائل کے مسائل کی جانچ کریں +npm run build # تصدیق کریں کہ بلڈ کامیاب ہو گیا ہے ``` -### Bank API کی ٹیسٹنگ +### بینک API ٹیسٹنگ ```bash cd 7-bank-project/api npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں -node server.js # تصدیق کریں کہ سرور بغیر غلطیوں کے شروع ہوتا ہے +node server.js # سرور کے بغیر غلطیوں کے شروع ہونے کی تصدیق کریں ``` ### عمومی ٹیسٹنگ طریقہ کار -- یہ ایک تعلیمی ذخیرہ ہے اور جامع خودکار ٹیسٹ نہیں رکھتا -- دستی ٹیسٹنگ پر توجہ دی جاتی ہے: - - کوڈ کی مثالیں بغیر غلطی چلیں - - دستاویزات کی لنکس صحیح کام کریں - - پروجیکٹ کی تعمیر کامیابی سے مکمل ہو - - مثالیں بہترین طریقوں پر عمل کریں +- یہ ایک تعلیمی ذخیرہ ہے جس میں مکمل خودکار ٹیسٹ شامل نہیں ہیں +- دستی ٹیسٹنگ پر توجہ دیتا ہے: + - کوڈ مثالیں بغیر غلطی کے چلتی ہیں + - دستاویزات میں موجود لنکس کام کرتے ہیں + - پراجیکٹ بیلڈ کامیابی سے مکمل ہوتا ہے + - مثالیں بہترین طریقہ کار کی پیروی کرتی ہیں -### جمع کروانے سے پہلے چیکس +### جمع کروانے سے پہلے چیک -- جہاں package.json موجود ہو، `npm run lint` چلائیں -- مارکڈاؤن کے لنکس کی تصدیق کریں -- مثالیں براؤزر یا Node.js میں ٹیسٹ کریں -- ترجمے مناسب ساخت کو برقرار رکھیں +- `npm run lint` چلائیں جہاں package.json ہو +- مارک ڈاؤن لنکس کی جانچ پڑتال کریں +- کوڈ مثالیں براؤزر یا Node.js میں چیک کریں +- تصدیق کریں کہ ترجمے صحیح ڈھانچہ رکھتے ہیں -## کوڈ اسٹائل گائیڈ لائنز +## کوڈ اسٹائل کی رہنما خطوط ### JavaScript -- جدید ES6+ نحو استعمال کریں -- پروجیکٹس میں فراہم کردہ ESLint کنفیگریشنز پر عمل کریں -- تعلیمی وضاحت کے لیے معنی خیز متغیر اور فنکشن کے نام استعمال کریں -- سیکھنے والوں کے لیے تصورات کی وضاحت والے تبصرے شامل کریں -- جہاں Prettier مرتب ہو، اس سے فارمیٹ کریں +- جدید ES6+ نحو استعمال کریں +- پراجیکٹس میں دی گئی معیاری ESLint کنفیگریشن پر عمل کریں +- تعلیمی وضاحت کے لیے معنی خیز متغیر اور فنکشن نام استعمال کریں +- سیکھنے والوں کے لیے تصفیہ تشریحات شامل کریں +- جہاں پریٹیئر کنفیگر ہو وہاں فارمیٹ کریں ### HTML/CSS -- معنوی HTML5 عناصر -- جوابدہ (Responsive) ڈیزائن اصول -- صاف ستھری کلاس نام کاری -- CSS تکنیکس کی وضاحت کرنے والے تبصرے سیکھنے والوں کے لیے +- معنوی HTML5 عناصر +- رد عمل دکھانے والے ڈیزائن کے اصول +- واضح کلاس نام رکھنے کے قواعد +- CSS تکنیک کو سیکھنے والوں کے لیے تبصرے ### Python -- PEP 8 اسٹائل گائیڈ لائنز -- واضح، تعلیمی کوڈ مثالیں -- جہاں مفید ہو ٹائپ ہنٹس +- PEP 8 اسٹائل گائیڈ لائنز +- واضح، تعلیمی کوڈ مثالیں +- جہاں مفید ہو، ٹائپ ہنٹس -### مارکڈاؤن دستاویزات +### مارک ڈاؤن دستاویزات -- صاف سرخیوں کی ترتیب -- زبان کی وضاحت کے ساتھ کوڈ بلاکس -- اضافی وسائل کے لنکس -- `images/` فولڈرز میں اسکرین شاٹس اور تصاویر -- تصاویر کے لیے Alt متن برائے آسان رسائی +- واضح ہیڈنگ کی ترتیب +- زبان کی وضاحت کے ساتھ کوڈ بلاکس +- اضافی وسائل کے لیے لنکس +- `images/` فولڈرز میں اسکرین شاٹس اور تصاویر +- تصاویر کے لیے متبادل متن برائے رسائی ### فائل آرگنائزیشن -- اسباق متسلسل نمبر کے ساتھ (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}/` ڈھانچے میں -## تعمیر اور تعیناتی +## بلڈ اور تعیناتی -### Quiz App کی تعیناتی (Azure Static Web Apps) +### کوئز ایپ تعیناتی (Azure Static Web Apps) -quiz-app Azure Static Web Apps کے لیے ترتیب دیا گیا ہے: +کوئز ایپ Azure Static Web Apps تعیناتی کے لیے ترتیب دی گئی ہے: ```bash cd quiz-app npm run build # فولڈر dist/ بناتا ہے -# مین پر پوش کرنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے +# مین پر پش کرنے پر 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 تیار کرنا +### دستاویزات PDF جنریشن ```bash -npm install # انسٹال کریں docsify-to-pdf -npm run convert # docs سے PDF بنائیں +npm install # ڈاکسفائی ٹو پی ڈی ایف انسٹال کریں +npm run convert # ڈاکس سے پی ڈی ایف تیار کریں ``` ### Docsify دستاویزات ```bash -npm install -g docsify-cli # ڈاکسفائی کو عالمی طور پر انسٹال کریں -docsify serve # لوکل ہوسٹ:3000 پر سروس فراہم کریں +npm install -g docsify-cli # ڈاکسفائی کو عالمی سطح پر انسٹال کریں +docsify serve # لوکل ہوسٹ:3000 پر خدمت کریں ``` -### پروجیکٹ مخصوص تعمیر +### پراجیکٹ مخصوص بلڈز -ہر پروجیکٹ فولڈر کا اپنا تعمیر عمل ہو سکتا ہے: -- Vue پروجیکٹس: `npm run build` سے پروڈکشن بنڈلز بنتے ہیں -- سٹیٹک پروجیکٹس: کوئی تعمیر مرحلہ نہیں، فائلز براہ راست سرو کریں +ہر پراجیکٹ ڈائریکٹری کا اپنا بلڈ عمل ہو سکتا ہے: +- Vue پراجیکٹس: `npm run build` پروڈکشن بنڈلز تیار کرتا ہے +- جامد پراجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلز کو براہ راست سرو کریں -## پل ریکویسٹ گائیڈ لائنز +## پل ریکویسٹ کی رہنما خطوط ### عنوان کا فارمیٹ -صاف اور وضاحتی عنوانات استعمال کریں جو تبدیلی کے علاقے کو ظاہر کریں: -- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں` -- `[Lesson-3] terrarium پروجیکٹ میں ٹائپو درست کریں` -- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں` -- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں` +صاف، وضاحتی عنوان استعمال کریں جو تبدیلی کے علاقے کی نشاندہی کرے: +- `[Quiz-app] سبق X کے لیے نئی کوئز شامل کریں` +- `[Lesson-3] ٹیریریم پراجیکٹ میں ٹائپو درست کریں` +- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں` +- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں` -### درکار چیکس +### ضروری چیکز PR جمع کروانے سے پہلے: -1. **کوڈ کی معیار**: - - متاثرہ پروجیکٹ فولڈرز میں `npm run lint` چلائیں - - تمام lint کی غلطیاں اور وارننگز ٹھیک کریں +1. **کوڈ معیار**: + - متاثرہ پراجیکٹ ڈائریکٹریز میں `npm run lint` چلائیں + - تمام لِنٹنگ کی غلطیاں اور وارننگز درست کریں -2. **تعمیر کی تصدیق**: - - جہاں لاگو ہو `npm run build` چلائیں - - یقینی بنائیں کہ کوئی تعمیر کی غلطی نہ ہو +2. **بلڈ ویریفیکیشن**: + - اگر قابل اطلاق ہو تو `npm run build` چلائیں + - بلڈ میں کوئی غلطی نہ ہو -3. **لنک کی توثیق**: - - تمام مارکڈاؤن لنکس کا ٹیسٹ کریں - - تصویری حوالہ جات کام کر رہے ہیں کی تصدیق کریں +3. **لنک ویریفیکیشن**: + - تمام مارک ڈاؤن لنکس کی جانچ کریں + - تصویری حوالہ جات کو چیک کریں -4. **مواد کا جائزہ**: - - املا اور گرامر کی جانچ کریں - - کوڈ مثالیں درست اور تعلیمی ہوں - - ترجمے اصل معنی کو برقرار رکھیں +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 تفصیل میں ایشو نمبرز شامل کریں -### جائزہ لینے کا عمل +### جائزہ کا عمل -- PRs مینٹینرز اور کمیونٹی کے ذریعے جائزہ لیے جاتے ہیں -- تعلیمی وضاحت کو ترجیح دی جاتی ہے -- کوڈ مثالیں موجودہ بہترین طریقوں کی پیروی کریں -- ترجمے درستگی اور ثقافتی مناسبت کی جانچ پڑتال سے گزریں +- PRs کو مینٹینرز اور کمیونٹی جائزہ لیتی ہے +- تعلیمی وضاحت کو ترجیح دی جاتی ہے +- کوڈ مثالیں موجودہ بہترین طریقوں کی پیروی کریں +- ترجمے درستگی اور ثقافتی مطابقت کے لیے جائزہ لیے جاتے ہیں -## ترجمہ نظام +## ترجمہ کا نظام ### خودکار ترجمہ -- GitHub Actions کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے -- 50+ زبانوں میں خود بخود ترجمہ کرتا ہے -- ماخذ فائلیں مرکزی ڈائریکٹریز میں -- ترجمہ شدہ فائلیں `translations/{language-code}/` فولڈرز میں +- co-op-translator ورک فلو کے ساتھ GitHub Actions استعمال کرتا ہے +- 50+ زبانوں میں خودکار ترجمہ کرتا ہے +- ذریعہ فائلیں مرکزی ڈائریکٹریز میں +- ترجمہ شدہ فائلیں `translations/{language-code}/` میں -### دستی ترجمہ کی بہتری شامل کرنا +### دستی ترجمہ میں بہتری شامل کرنا -1. `translations/{language-code}/` فولڈر میں فائل تلاش کریں -2. ساخت کو برقرار رکھتے ہوئے بہتری کریں -3. یقینی بنائیں کہ کوڈ مثالیں کام کرتی رہیں -4. کسی بھی لوکلائزڈ کوئز مواد کو ٹیسٹ کریں +1. `translations/{language-code}/` میں فائل تلاش کریں +2. ڈھانچہ برقرار رکھتے ہوئے بہتری کریں +3. کوڈ مثالوں کو فعال رکھیں +4. کسی بھی مقامی کوئز مواد کی جانچ کریں -### ترجمہ کے میٹاڈیٹا +### ترجمہ میٹاڈیٹا -ترجمہ شدہ فائلوں میں میٹاڈیٹا ہیڈر شامل ہوتا ہے: +ترجمہ شدہ فائلوں میں میٹاڈیٹا ہیڈر شامل ہے: ```markdown ``` -## ڈی بگنگ اور مسئلہ حل کرنا +## غلطی کا پتہ لگانا اور مسئلے حل کرنا ### عام مسائل -**Quiz app شروع نہیں ہو رہا**: -- Node.js کا ورژن چیک کریں (v14+ تجویز شدہ) -- `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں -- پورٹ کی ٹکراؤ کو چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے) +**کوئز ایپ شروع نہیں ہو رہی**: +- Node.js کا ورژن چیک کریں (v14+ سفارش کی جاتی ہے) +- `node_modules` اور `package-lock.json` کو حذف کریں، پھر `npm install` چلائیں +- پورٹ کے تصادمات چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے) -**API سرور شروع نہیں ہو رہا**: -- کم از کم Node.js ورژن کا یقین دہانی کریں (node >=10) -- چیک کریں کہ پورٹ پہلے سے استعمال میں تو نہیں -- تمام dependencies `npm install` سے انسٹال ہوں +**API سرور شروع نہیں ہوتا**: +- Node.js کا ورژن کم از کم (node >=10) ہو +- چیک کریں کہ پورٹ پہلے استعمال میں نہیں +- تمام انحصار `npm install` کے ساتھ انسٹال کیے گئے ہوں -**Browser extension لوڈ نہیں ہو رہا**: -- manifest.json کے درست فارمیٹ کی تصدیق کریں -- براؤزر کنسول میں غلطیوں کی جانچ کریں -- براؤزر مخصوص ایکسٹینشن انسٹالیشن ہدایات پر عمل کریں +**براؤزر ایکسٹینشن لوڈ نہیں ہو رہی**: +- manifest.json کی صحیح فارمیٹنگ کی تصدیق کریں +- براؤزر کنسول میں غلطیاں چیک کریں +- براؤزر مخصوص ایکسٹینشن انسٹالیشن کی ہدایات پر عمل کریں -**Python chat پروجیکٹ مسائل**: -- OpenAI پیکیج انسٹال کریں: `pip install openai` -- GITHUB_TOKEN ماحول متغیر سیٹ ہے کی جانچ کریں -- GitHub Models کے رسائی حقوق چیک کریں +**Python چیٹ پراجیکٹ کے مسائل**: +- 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` موجود ہو -### ترقی کے ماحول کے نکات +### ترقیاتی ماحول کی تجاویز -- HTML پروجیکٹس کے لیے VS Code کے ساتھ Live Server ایکسٹینشن استعمال کریں -- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشنز انسٹال کریں -- JavaScript کی ڈی بگنگ کے لیے براؤزر DevTools کا استعمال کریں -- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں +- HTML پراجیکٹس کے لیے VS Code میں Live Server ایکسٹینشن استعمال کریں +- برقراری کے لیے ESLint اور Prettier ایکسٹینشن انسٹال کریں +- JavaScript کی خرابی نکالنے کے لیے براؤزر DevTools استعمال کریں +- Vue پراجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں -### کارکردگی کے لیے توجہ +### کارکردگی کے پہلو -- بڑی تعداد میں ترجمہ شدہ فائلیں (50+ زبانیں) کلون کو بڑا بناتی ہیں -- صرف مواد پر کام کر رہے ہوں تو shallow clone استعمال کریں: `git clone --depth 1` -- انگلش مواد پر کام کرتے وقت ترجمے کو تلاش سے خارج کریں -- پہلی بار چلانے پر تعمیراتی عمل سست ہو سکتے ہیں (npm install، Vite build) +- ترجمہ شدہ فائلوں کی بڑی تعداد (50+ زبانیں) کی وجہ سے مکمل کلون بڑے ہوتے ہیں +- صرف مواد پر کام کی صورت میں shallow clone استعمال کریں: `git clone --depth 1` +- انگلش مواد پر کام کرتے ہوئے ترجموں کو سرچ سے خارج کریں +- بلڈ پروسیس پہلی بار سست ہو سکتا ہے (npm install، Vite build) -## سیکیورٹی کے امور +## سیکیورٹی کے پہلو -### ماحول کے متغیرات +### ماحول متغیرات -- API کلیدیں کبھی بھی ذخیرہ میں شامل نہ کریں -- `.env` فائلز استعمال کریں (جو پہلے سے `.gitignore` میں ہیں) -- ماحول متغیرات کی ضرورت پروجیکٹ کے README میں دستاویز کریں +- API کیز کبھی بھی ذخیرہ میں شامل نہ کریں +- `.env` فائلوں کا استعمال کریں (جو پہلے سے `.gitignore` میں ہیں) +- پراجیکٹ کی README میں ضروری ماحول متغیرات دستاویزی کریں -### Python پروجیکٹس +### Python پراجیکٹس -- ورچوئل ماحول استعمال کریں: `python -m venv venv` -- dependencies کو اپ ٹو ڈیٹ رکھیں -- GitHub کے ٹوکنز کم از کم ضروری اجازتوں کے ساتھ ہوں +- ورچوئل انوائرمنٹ کا استعمال کریں: `python -m venv venv` +- انحصار کو اپ ڈیٹ رکھیں +- GitHub ٹوکنز کے لیے کم از کم مطلوبہ اجازتیں رکھیں -### GitHub Models تک رسائی +### GitHub Models کی رسائی -- GitHub Models کے لیے Personal Access Tokens (PAT) مطلوب ہیں -- ٹوکنز کو ماحول کے متغیرات کے طور پر محفوظ کریں -- ٹوکنز یا اسناد کو کبھی ذخیرہ میں کمٹ نہ کریں +- شخصی رسائی کے ٹوکنز (PAT) GitHub Models کے لیے ضروری ہیں +- ٹوکنز کو ماحول متغیرات کے طور پر ذخیرہ کریں +- ٹوکنز یا اسناد کبھی بھی شامل نہ کریں ## اضافی نوٹس ### ہدف سامعین -- ویب ڈیولپمنٹ کے مکمل نو آموز -- طلباء اور خود سیکھنے والے -- کلاس رومز میں نصاب استعمال کرنے والے اساتذہ -- مواد آسان رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے +- ویب ڈویلپمنٹ کے مکمل نو آموز +- طلبا اور خود سیکھنے والے +- اساتذہ جو نصاب کلاس روم میں استعمال کرتے ہیں +- مواد رسائی اور تدریجی مہارت کی ترقی کے لیے ڈیزائن کیا گیا ہے ### تعلیمی فلسفہ -- پروجیکٹ پر مبنی سیکھنے کا طریقہ -- کثرت سے علمی چیکز (کوئزز) -- عملی کوڈنگ کی مشقیں -- حقیقی دنیا کی مثالیں -- فریم ورکس سے پہلے بنیادی اصولوں پر توجہ +- پراجیکٹ پر مبنی سیکھنے کا طریقہ +- کثرت سے علم کا جائزہ (کوئزز) +- عملی کوڈنگ مشقیں +- حقیقی دنیا کی درخواست کی مثالیں +- فریم ورکس سے پہلے بنیادی اصولوں پر توجہ -### ذخیرہ کی دیکھ بھال +### ذخیرہ دیکھ بھال -- سیکھنے والوں اور کنٹری بیوٹرز کی فعال کمیونٹی -- dependencies اور مواد کی باقاعدہ اپ ڈیٹس -- مسائل اور مباحثے مینٹینرز کی نگرانی میں -- ترجمہ کی اپ ڈیٹس خودکار طور پر GitHub Actions کے ذریعے +- سیکھنے والوں اور تعاون کرنے والوں کی فعال کمیونٹی +- انحصار اور مواد کی باقاعدہ اپڈیٹس +- ایشوز اور مباحثے مینٹینرز کی نگرانی میں +- ترجمہ اپڈیٹس GitHub Actions کے ذریعے خودکار ### متعلقہ وسائل -- [Microsoft Learn modules](https://docs.microsoft.com/learn/) -- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) سیکھنے والوں کے لیے تجویز کردہ -- اضافی کورسز: Generative AI, Data Science, ML, IoT نصاب دستیاب +- [Microsoft Learn ماڈیولز](https://docs.microsoft.com/learn/) +- [Student Hub وسائل](https://docs.microsoft.com/learn/student-hub/) +- سیکھنے والوں کے لیے [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) کی سفارش کی گئی +- اضافی کورسز: جنریٹو AI، ڈیٹا سائنس، ML، IoT نصاب دستیاب -### مخصوص پروجیکٹس کے ساتھ کام کرنا +### مخصوص پراجیکٹس کے ساتھ کام کرنا -انفرادی پروجیکٹس کے تفصیلی ہدایات کے لیے متعلقہ README فائلوں کو دیکھیں: -- `quiz-app/README.md` - Vue 3 کوئز ایپلیکیشن -- `7-bank-project/README.md` - بینکنگ ایپلیکیشن جس میں توثیق شامل ہے -- `5-browser-extension/README.md` - براؤزر ایکسٹینشن کی ترقی -- `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 چیٹ اسسٹنٹ پراجیکٹ -### مونو ریپوزٹری کا ڈھانچہ +### مونو ریپوز کا ڈھانچہ -اگرچہ یہ روایتی مونو ریپوزٹری نہیں، اس میں متعدد آزاد پروجیکٹس شامل ہیں: -- ہر سبق خود مختار ہے -- پروجیکٹس dependencies شیئر نہیں کرتے -- بغیر ایک دوسرے کو متاثر کیے انفرادی پروجیکٹس پر کام کریں -- مکمل نصاب کے لیے پورے ریپوزٹری کو کلون کریں +اگرچہ یہ روایتی مونو ریپو نہیں ہے، بلکہ اس ذخیرے میں کئی آزاد پراجیکٹس شامل ہیں: +- ہر سبق خود مختار ہے +- پراجیکٹس انحصار شیئر نہیں کرتے +- الگ الگ پراجیکٹس پر بغیر مداخلت کام کریں +- مکمل نصاب کے تجربے کے لیے پورا ریپوزیٹری کلون کریں --- -**دستخطی رہنمائی**: -اس دستاویز کا ترجمہ مصنوعی ذہانت کی ترجمہ سہولت [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/zh-CN/.co-op-translator.json b/translations/zh-CN/.co-op-translator.json index 2cef7415c..796d4a900 100644 --- a/translations/zh-CN/.co-op-translator.json +++ b/translations/zh-CN/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:04:25+00:00", + "translation_date": "2026-02-06T12:30:15+00:00", "source_file": "AGENTS.md", "language_code": "zh-CN" }, diff --git a/translations/zh-CN/AGENTS.md b/translations/zh-CN/AGENTS.md index 8fa90005e..75beb5850 100644 --- a/translations/zh-CN/AGENTS.md +++ b/translations/zh-CN/AGENTS.md @@ -2,27 +2,27 @@ ## 项目概述 -这是一个面向初学者教授网页开发基础的教育课程仓库。课程由微软云倡导者开发，是一个为期12周的综合课程，包含24个涵盖JavaScript、CSS和HTML的动手课程。 +这是一个面向初学者教授网页开发基础的教育课程仓库。该课程是由微软云倡导者开发的为期12周的综合课程，包含24个实践性课程，涵盖JavaScript、CSS和HTML。 -### 主要组件 +### 关键组成部分 -- **教育内容**：24个结构化课程，组织为基于项目的模块 -- **实用项目**：养殖箱、打字游戏、浏览器扩展、太空游戏、银行应用、代码编辑器和AI聊天助理 +- **教育内容**：24个结构化课程，组织成基于项目的模块 +- **实践项目**：生态瓶、打字游戏、浏览器扩展、太空游戏、银行应用、代码编辑器和AI聊天助手 - **互动测验**：48个测验，每个包含3个问题（课前/课后评估） -- **多语言支持**：通过GitHub Actions自动翻译成50多种语言 +- **多语言支持**：通过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格式 ## 设置命令 -该仓库主要用于教育内容的学习。针对具体项目的操作如下： +本仓库主要用于教育内容的学习。若要使用具体项目： ### 主仓库设置 @@ -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 ``` @@ -46,9 +46,9 @@ npm run lint # 运行 ESLint ```bash cd 7-bank-project/api npm install -npm start # 启动API服务器 -npm run lint # 运行ESLint -npm run format # 使用Prettier格式化 +npm start # 启动 API 服务器 +npm run lint # 运行 ESLint +npm run format # 使用 Prettier 格式化 ``` ### 浏览器扩展项目 @@ -56,7 +56,7 @@ npm run format # 使用Prettier格式化 ```bash cd 5-browser-extension/solution npm install -# 遵循针对浏览器的特定扩展加载说明 +# 遵循特定浏览器的扩展加载说明 ``` ### 太空游戏项目 @@ -64,7 +64,7 @@ npm install ```bash cd 6-space-game/solution npm install -# 在浏览器中打开 index.html 或使用实时服务器 +# 在浏览器中打开 index.html 或使用 Live Server ``` ### 聊天项目（Python后端） @@ -76,33 +76,33 @@ pip install openai python api.py ``` -## 开发工作流 +## 开发工作流程 -### 对内容贡献者 +### 内容贡献者 -1. **Fork该仓库** 到你的GitHub账号 -2. **克隆你的Fork** 到本地 -3. **创建新的分支** 用于修改 -4. 修改课程内容或代码示例 -5. 在相关项目目录测试代码修改 -6. 遵守贡献指南提交拉取请求（PR） +1. **Fork仓库**到您的GitHub账户 +2. **克隆您的Fork**到本地 +3. **创建新分支**进行更改 +4. 修改课程内容或代码示例 +5. 在相关项目目录测试代码更改 +6. 按贡献指南提交拉取请求 -### 对学习者 +### 学习者 -1. Fork或克隆该仓库 -2. 按顺序访问课程目录 -3. 阅读每课的README文件 -4. 完成 https://ff-quizzes.netlify.app/web/ 上的课前测验 -5. 使用课程文件夹中的代码示例学习 -6. 完成作业和挑战 -7. 参加课后测验 +1. Fork或克隆仓库 +2. 顺序进入课程目录 +3. 阅读每课的README文件 +4. 在 https://ff-quizzes.netlify.app/web/ 完成课前测验 +5. 学习课程文件夹中的代码示例 +6. 完成作业和挑战 +7. 参加课后测验 ### 实时开发 -- **文档服务**：在根目录运行 `docsify serve` （默认端口3000） -- **测验应用**：在quiz-app目录中运行 `npm run dev` -- **项目**：HTML项目用VS Code Live Server扩展 -- **API项目**：在对应API目录运行 `npm start` +- **文档服务**：在根目录运行 `docsify serve`（端口3000） +- **测验应用**：在quiz-app目录运行 `npm run dev` +- **项目**：HTML项目使用VS Code Live Server扩展 +- **API项目**：在对应API目录运行 `npm start` ## 测试说明 @@ -111,7 +111,7 @@ python api.py ```bash cd quiz-app npm run lint # 检查代码风格问题 -npm run build # 验证构建是否成功 +npm run build # 验证构建成功 ``` ### 银行API测试 @@ -119,79 +119,79 @@ npm run build # 验证构建是否成功 ```bash cd 7-bank-project/api npm run lint # 检查代码风格问题 -node server.js # 验证服务器是否无错误启动 +node server.js # 验证服务器启动无错误 ``` ### 常规测试方法 -- 本仓库为教育仓库，无全面自动测试 -- 手动测试重点： - - 代码示例无错误运行 - - 文档中的链接有效 - - 项目构建成功 - - 示例符合最佳实践 +- 这是一个以教育为主的仓库，没有全面自动化测试 +- 手动测试重点： + - 代码示例无错误运行 + - 文档中的链接正确有效 + - 项目构建成功完成 + - 示例遵循最佳实践 ### 提交前检查 -- 在带有package.json的目录运行 `npm run lint` -- 验证markdown链接有效 -- 在浏览器或Node.js中测试代码示例 -- 确保翻译文件结构正确 +- 在含package.json的目录运行 `npm run lint` +- 验证Markdown链接有效 +- 在浏览器或Node.js中测试代码示例 +- 确认翻译结构正确无误 ## 代码风格指南 ### JavaScript -- 使用现代ES6+语法 -- 遵守各项目内的标准ESLint配置 -- 使用有意义的变量和函数名以便教学 -- 添加注释解释概念 -- 配置了Prettier的地方使用其格式化 +- 使用现代ES6+语法 +- 遵循项目中提供的标准ESLint配置 +- 使用有意义的变量和函数名，便于教学理解 +- 添加注释解释概念 +- 使用配置的Prettier格式化代码 ### HTML/CSS -- 语义化HTML5元素 -- 响应式设计原则 -- 清晰的类命名规范 -- 注释说明CSS技巧以供学习 +- 采用语义化HTML5元素 +- 响应式设计原则 +- 清晰的类命名规范 +- 添加解释CSS技术的注释，利于教学 ### Python -- 遵守PEP 8风格指南 -- 清晰、教学性的代码示例 -- 适当使用类型提示辅助学习 +- 遵循PEP 8编码规范 +- 清晰且教育性的代码示例 +- 在适用处添加类型提示，方便学习 ### Markdown文档 -- 清晰的标题层次结构 -- 语言标记的代码块 -- 链接到额外资源 -- `images/`目录中的截图和图片 -- 图片用alt文本提升无障碍 +- 清晰的标题层级 +- 带语言标注的代码块 +- 链接至额外资源 +- 在`images/`目录中存放截图和图片 +- 为图片添加alt文本，确保无障碍 ### 文件组织 -- 课程依序编号（1-getting-started-lessons, 2-js-basics等） -- 每个项目有`solution/`，常常还有`start/`或`your-work/`目录 -- 图片存放在课程特定的`images/`文件夹 -- 翻译存储在`translations/{language-code}/`目录结构 +- 课程按顺序编号（1-getting-started-lessons, 2-js-basics等） +- 每个项目有`solution/`，通常还有`start/`或`your-work/`目录 +- 图片存放在对应课程的`images/`文件夹 +- 翻译文件位于 `translations/{language-code}/` 结构 ## 构建与部署 -### 测验应用部署（Azure Static Web Apps） +### 测验应用部署（Azure静态网页应用） -quiz-app配置用于Azure Static Web Apps部署： +quiz-app配置为Azure静态网页应用部署： ```bash cd quiz-app npm run build # 创建 dist/ 文件夹 -# 在推送到 main 时通过 GitHub Actions 工作流进行部署 +# 在推送到 main 时通过 GitHub Actions 工作流部署 ``` -Azure Static Web Apps 配置： -- **应用位置**：`/quiz-app` -- **输出位置**：`dist` -- **工作流**：`.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Azure静态网页应用配置： +- **应用位置**: `/quiz-app` +- **输出位置**: `dist` +- **工作流**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### 文档PDF生成 @@ -204,79 +204,79 @@ npm run convert # 从 docs 生成 PDF ```bash npm install -g docsify-cli # 全局安装 Docsify -docsify serve # 在 localhost:3000 上提供服务 +docsify serve # 在 localhost:3000 上服务 ``` ### 项目特定构建 -各项目目录可能有自己的构建流程： -- Vue项目：`npm run build` 生成生产包 -- 静态项目：无构建步骤，直接提供文件 +各项目目录可能有自己的构建过程： +- Vue项目：`npm run build`生成生产包 +- 静态项目：无需构建步骤，直接提供文件 ## 拉取请求指南 ### 标题格式 -使用清晰描述改动范围的标题： -- `[Quiz-app] 添加课程X的新测验` -- `[Lesson-3] 修正养殖箱项目中的拼写错误` -- `[Translation] 添加课程5的西班牙语翻译` -- `[Docs] 更新设置说明` +使用清晰描述更改领域的标题： +- `[Quiz-app] 为第X课添加新测验` +- `[Lesson-3] 修复生态瓶项目拼写错误` +- `[Translation] 为第5课添加西班牙语翻译` +- `[Docs] 更新设置说明` -### 必需检查 +### 必需检查项 -提交PR前： +提交PR前： -1. **代码质量**： - - 在受影响项目目录运行 `npm run lint` - - 解决所有lint错误和警告 +1. **代码质量**： + - 运行受影响项目目录中的 `npm run lint` + - 修正所有lint错误和警告 -2. **构建验证**： - - 运行 `npm run build`（如果适用） - - 确保无构建错误 +2. **构建验证**： + - 如适用，运行 `npm run build` + - 确保无构建错误 -3. **链接校验**： - - 测试所有markdown链接 - - 验证图片引用有效 +3. **链接验证**： + - 测试所有Markdown链接 + - 验证图片引用有效 -4. **内容审核**： - - 校对拼写和语法 - - 确保代码示例正确且具有教学意义 - - 核对翻译准确无误 +4. **内容审核**： + - 校对拼写和语法 + - 确认代码示例正确且具教学性 + - 验证翻译保持原意 ### 贡献要求 -- 同意微软CLA（首次PR自动检查） -- 遵守 [微软开源行为准则](https://opensource.microsoft.com/codeofconduct/) -- 见 [CONTRIBUTING.md](./CONTRIBUTING.md) 获取详细指导 -- PR描述中引用相关issue编号（如适用） +- 同意微软CLA（首次PR自动检查） +- 遵守[微软开源行为守则](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. 保持结构的同时进行改进 -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使用端口5173） -**API服务器无法启动**： -- 确保Node.js版本符合最低要求（node >=10） -- 检查端口是否已被占用 -- 保证所有依赖已通过 `npm install` 安装 +**API服务器无法启动**： +- 确认Node.js版本满足最低要求（node >=10） +- 检查端口是否被占用 +- 确保所有依赖已通过 `npm install` 安装 -**浏览器扩展无法加载**： -- 确认manifest.json格式正确 -- 检查浏览器控制台错误 -- 按浏览器特定扩展安装说明操作 +**浏览器扩展无法加载**： +- 确认manifest.json格式正确 +- 浏览器控制台查看错误 +- 按浏览器特定扩展安装说明操作 -**Python聊天项目问题**： -- 确保已安装OpenAI包：`pip install openai` -- 验证GITHUB_TOKEN环境变量是否设置 -- 检查GitHub模型访问权限 +**Python聊天项目问题**： +- 确保安装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 -- Vue项目安装Vue DevTools浏览器扩展 +- 对HTML项目使用VS Code和Live Server扩展 +- 安装ESLint和Prettier扩展，保持格式统一 +- 使用浏览器开发者工具调试JavaScript +- Vue项目安装Vue DevTools浏览器扩展 ### 性能考虑 -- 50多种语言的翻译文件众多，完整克隆体积较大 -- 仅处理内容时使用浅克隆：`git clone --depth 1` -- 处理英文内容时排除翻译搜索 -- 第一次运行构建较慢（npm install、Vite构建） +- 50多种语言的翻译文件数量庞大，完整克隆体积较大 +- 若仅处理内容，使用浅克隆：`git clone --depth 1` +- 编辑英文内容时排除翻译目录搜索 +- 首次运行构建过程可能较慢（npm install，Vite构建） ## 安全注意事项 ### 环境变量 -- API密钥绝不可提交到仓库 -- 使用 `.env` 文件（已在 `.gitignore` 中） -- 项目README中记录所需环境变量 +- API密钥绝不能提交到仓库 +- 使用 `.env` 文件（已加入 `.gitignore`） +- 必要环境变量在项目README中注明 ### Python项目 -- 使用虚拟环境：`python -m venv venv` -- 保持依赖更新 -- GitHub令牌权限应最小化 +- 使用虚拟环境：`python -m venv venv` +- 保持依赖更新 +- GitHub Token应具有最小必要权限 ### GitHub模型访问 -- 需要个人访问令牌（PAT） -- 令牌存储为环境变量 -- 绝不可提交令牌或凭证 +- 需要个人访问令牌（PAT） +- 令牌应作为环境变量存储 +- 绝不提交令牌或凭据 -## 其他说明 +## 附加说明 -### 目标受众 +### 目标用户 -- 完全的网页开发初学者 -- 学生及自学者 -- 教师在课堂使用此课程 -- 内容注重无障碍和逐步技能提升 +- 完全的网页开发初学者 +- 学生和自学者 +- 课堂内使用此课程的教师 +- 内容设计注重可访问性和渐进式技能培养 -### 教学理念 +### 教育理念 -- 基于项目的学习方式 -- 频繁的知识检测（测验） -- 动手编码练习 -- 真实案例应用 -- 先注重基础，再涉及框架 +- 基于项目的学习方法 +- 频繁的知识检测（测验） +- 动手编码练习 +- 真实世界的应用示例 +- 重基础，先掌握基础再学框架 ### 仓库维护 -- 活跃的学习者和贡献者社区 -- 定期更新依赖和内容 -- 维护者监控Issue和讨论 -- 翻译更新自动化通过GitHub Actions +- 活跃的学习者与贡献者社区 +- 定期更新依赖与内容 +- 问题和讨论由维护者监控 +- 翻译更新自动化通过GitHub Actions完成 ### 相关资源 -- [微软学习模块](https://docs.microsoft.com/learn/) -- [学生中心资源](https://docs.microsoft.com/learn/student-hub/) -- 推荐学习者使用 [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) -- 额外课程：生成式AI、数据科学、机器学习、物联网课程可用 +- [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、数据科学、机器学习、物联网等课程 -### 具体项目说明 +### 具体项目使用 -详细项目说明请参见各自README： -- `quiz-app/README.md` — Vue 3测验应用 -- `7-bank-project/README.md` — 具认证的银行应用 -- `5-browser-extension/README.md` — 浏览器扩展开发 -- `6-space-game/README.md` — 基于Canvas的游戏开发 -- `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` - 基于Canvas的游戏开发 +- `9-chat-project/README.md` - AI聊天助手项目 ### 单仓库结构 -虽非传统monorepo，但此仓库包含多个独立项目： -- 每个课程独立 -- 项目间无共享依赖 -- 可单独开发项目，不影响其他 -- 克隆完整仓库体验整个课程体系 +虽非传统monorepo，但本仓库包含多个独立项目： +- 每堂课自成体系 +- 项目间无依赖共享 +- 可独立开发各项目，不影响其他 +- 克隆完整仓库可获得完整课程体验 --- **免责声明**： -本文件使用 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/zh-MO/.co-op-translator.json b/translations/zh-MO/.co-op-translator.json index 8df5a35dc..024c0bef6 100644 --- a/translations/zh-MO/.co-op-translator.json +++ b/translations/zh-MO/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T11:05:38+00:00", + "translation_date": "2026-02-06T12:31:18+00:00", "source_file": "AGENTS.md", "language_code": "zh-MO" }, diff --git a/translations/zh-MO/AGENTS.md b/translations/zh-MO/AGENTS.md index 2f4a49ec5..0046d5fb4 100644 --- a/translations/zh-MO/AGENTS.md +++ b/translations/zh-MO/AGENTS.md @@ -1,47 +1,47 @@ # AGENTS.md -## 專案概述 +## 專案概覽 -這是一個用於教導初學者網頁開發基礎的教育課程儲存庫。課程為一套完整的12週課程，由 Microsoft Cloud Advocates 開發，包含24堂涵蓋 JavaScript、CSS 與 HTML 的實作課程。 +這是一個用於教導初學者網頁開發基礎的教育課程倉庫。課程是一個由 Microsoft Cloud Advocates 開發的完整12週課程，包含24個涵蓋 JavaScript、CSS 和 HTML 的實作課程。 -### 主要組成部分 +### 主要組件 -- **教育內容**：24堂有結構性的課程，分為以專案為基礎的模組 -- **實作專案**：溫室生態箱、打字遊戲、瀏覽器擴充功能、太空遊戲、銀行應用、程式碼編輯器與 AI 聊天助理 -- **互動測驗**：48個測驗，每個有3題（課前/課後評估） +- **教育內容**：24個結構化課程，組織成專案模組 +- **實作專案**：Terrarium、打字遊戲、瀏覽器擴充功能、太空遊戲、銀行應用程式、程式碼編輯器與 AI 聊天助理 +- **互動測驗**：48個測驗，每個包含3個問題（課前/課後評估） - **多語言支援**：透過 GitHub Actions 自動翻譯超過50種語言 -- **技術堆疊**：HTML、CSS、JavaScript、Vue.js 3、Vite、Node.js、Express、Python（用於 AI 專案） +- **技術**：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 ``` -### 銀行專案 API (Node.js + Express) +### 銀行專案 API（Node.js + Express） ```bash cd 7-bank-project/api @@ -56,7 +56,7 @@ npm run format # 使用 Prettier 格式化 ```bash cd 5-browser-extension/solution npm install -# 遵循瀏覽器特定的擴充功能載入指示 +# 遵循瀏覽器特定擴展載入指示 ``` ### 太空遊戲專案 @@ -64,54 +64,54 @@ 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 pip install openai -# 設置 GITHUB_TOKEN 環境變量 +# 設定 GITHUB_TOKEN 環境變數 python api.py ``` -## 開發工作流程 +## 開發流程 ### 內容貢獻者 -1. **將儲存庫 fork** 到你的 GitHub 帳號 -2. **在本地端 clone 你的 fork** -3. **建立新分支** 進行變更 -4. 修改課程內容或程式範例 +1. **將倉庫 fork 到您的 GitHub 帳戶** +2. **在本地 clone 您的 fork** +3. **建立新的分支**以進行變更 +4. 修改課程內容或程式碼範例 5. 在相關專案目錄測試程式碼變更 -6. 提交 pull request 並遵循貢獻指南 +6. 提交 pull requests，遵循貢獻指南 -### 學習者流程 +### 學習者 -1. Fork 或 clone 該儲存庫 -2. 按順序前往各課程目錄 -3. 閱讀每堂課的 README 檔案 -4. 完成 https://ff-quizzes.netlify.app/web/ 的課前測驗 -5. 進行課堂程式範例練習 +1. fork 或 clone 倉庫 +2. 按順序瀏覽課程目錄 +3. 閱讀每課的 README 文件 +4. 在 https://ff-quizzes.netlify.app/web/ 完成課前測驗 +5. 練習課程資料夾中的程式碼範例 6. 完成作業與挑戰 -7. 進行課後測驗 +7. 參加課後測驗 -### 即時開發 +### 實時開發 -- **文件服務**：在根目錄執行 `docsify serve` （預設使用埠號 3000） -- **測驗應用**：在 quiz-app 目錄執行 `npm run dev` -- **專案**：HTML 專案使用 VS Code Live Server 擴充功能 -- **API 專案**：分別於對應 API 目錄執行 `npm start` +- **文件**：在根目錄執行 `docsify serve`（預設連接埠3000） +- **測驗應用程式**：在 quiz-app 目錄執行 `npm run dev` +- **專案**：使用 VS Code Live Server 延伸功能打開 HTML 專案 +- **API 專案**：在相應 API 目錄執行 `npm start` ## 測試說明 -### 測驗應用測試 +### 測驗應用程式測試 ```bash cd quiz-app -npm run lint # 檢查程式碼風格問題 -npm run build # 驗證建置是否成功 +npm run lint # 檢查代碼風格問題 +npm run build # 驗證構建是否成功 ``` ### 銀行 API 測試 @@ -124,159 +124,159 @@ node server.js # 驗證伺服器啟動時無錯誤 ### 一般測試方法 -- 本教育儲存庫無完整自動化測試 -- 手動測試重點： - - 程式範例執行無誤 - - 文件內連結皆可正常使用 - - 專案可成功建置 - - 範例符合最佳實務 +- 這是教育性倉庫，無全面自動測試 +- 主要手動測試項目： + - 程式碼範例可正常執行無誤 + - 文件中的連結均正確運作 + - 專案可成功編譯 + - 範例符合最佳實踐 ### 提交前檢查 - 在有 package.json 的目錄執行 `npm run lint` -- 驗證 markdown 連結有效性 -- 在瀏覽器或 Node.js 中測試程式範例 -- 確認翻譯檔保持正確結構 +- 驗證 markdown 連結有效 +- 在瀏覽器或 Node.js 測試程式碼範例 +- 確認翻譯結構維持一致 -## 程式碼風格指南 +## 程式碼風格指引 ### JavaScript - 使用現代 ES6+ 語法 -- 遵循專案中 ESLint 預設規範 -- 變數與函式名稱具教育意義 -- 加入註解解釋概念供學習者理解 -- 使用 Prettier 進行格式化（若已設定） +- 遵循專案中標準 ESLint 配置 +- 使用有意義的變數與函式名稱，便於教學 +- 添加註解說明概念 +- 使用 Prettier 格式化（有配置的地方） ### HTML/CSS -- 使用語意化 HTML5 標籤 +- 使用語意化 HTML5 元素 - 採用響應式設計原則 -- 清楚的 class 命名慣例 -- CSS 內加入教學性註解 +- 清晰的類別命名規範 +- 以註解解釋 CSS 技巧給學習者 ### Python - 遵循 PEP 8 風格指南 -- 提供清晰且具教育意義的程式碼範例 -- 在有助於學習的地方加入類型提示 +- 清晰且具教育意義的程式碼範例 +- 有助學習的型別註記 ### Markdown 文件 -- 清楚的標題層級結構 -- 標示語言的程式碼區塊 -- 引用額外資源連結 -- `images/` 目錄中的截圖與圖片 -- 圖片提供替代文字以提升可及性 +- 清晰標題層級 +- 帶語言標示的程式碼區塊 +- 連結至額外資源 +- 在 `images/` 目錄中附有截圖與圖片 +- 圖片附帶替代文字以利輔助使用 ### 檔案組織 -- 課程目錄依序號命名（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 靜態網站服務） +### 測驗應用程式部署（Azure Static Web Apps） -quiz-app 已設定用於 Azure 靜態網站部署： +quiz-app 配置為 Azure Static Web Apps 部署： ```bash cd quiz-app npm run build # 建立 dist/ 資料夾 -# 在推送至 main 時，透過 GitHub Actions 工作流程進行部署 +# 在 push 到 main 時透過 GitHub Actions 工作流程部署 ``` -Azure 靜態網站服務設定： -- **應用位置**：`/quiz-app` -- **輸出位置**：`dist` +Azure Static Web Apps 配置： +- **應用程式路徑**：`/quiz-app` +- **輸出路徑**：`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 docsify serve # 在 localhost:3000 提供服務 ``` -### 專案個別建置 +### 專案專屬建置 -每個專案目錄可能有自己的建置流程： -- Vue 專案：執行 `npm run build` 產生正式版套件 +各專案目錄可能有其建置程序： +- Vue 專案：執行 `npm run build` 建置生產版本 - 靜態專案：無建置步驟，直接提供檔案 ## Pull Request 指引 ### 標題格式 -使用清楚且描述變更範圍的標題： +使用清楚、描述變更範圍的標題： - `[Quiz-app] 新增第X課測驗` -- `[Lesson-3] 修正溫室專案錯字` -- `[Translation] 第5課西班牙語翻譯` -- `[Docs] 更新安裝指引` +- `[Lesson-3] 修正 terrarium 專案錯字` +- `[Translation] 新增第5課西班牙語翻譯` +- `[Docs] 更新安裝說明` -### 必要檢查 +### 必須檢查項目 提交 PR 前： 1. **程式碼品質**： - - 在相關專案目錄執行 `npm run lint` + - 在影響專案目錄執行 `npm run lint` - 修正所有 lint 錯誤與警告 2. **建置驗證**： - - 如適用執行 `npm run build` - - 確保無建置錯誤 + - 如適用，執行 `npm run build` + - 確認無建置錯誤 -3. **連結驗證**： +3. **連結檢查**： - 測試所有 markdown 連結 - - 確認圖片引用正常 + - 確認圖片參考可用 -4. **內容檢查**： +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 描述中附相關 issue 編號（如適用） -### 審查流程 +### 審查程序 -- 由維護者與社群共同審查 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. 在保持結構的前提下進行改進 -3. 確保程式範例仍可正常運作 -4. 測試本地化的測驗內容 +1. 定位於 `translations/{language-code}/` 內的檔案 +2. 在保留結構前提下進行改進 +3. 確保程式碼範例仍舊可用 +4. 測試在地化的測驗內容 -### 翻譯檔元資料 +### 翻譯元資料 -譯文檔包含元資料標頭： +翻譯檔含有元資料標頭： ```markdown ``` -## 疑難解答與除錯 +## 除錯與疑難排解 ### 常見問題 -**測驗應用無法啟動**： +**測驗應用程式無法啟動**： - 檢查 Node.js 版本（建議 v14+） -- 刪除 `node_modules` 與 `package-lock.json`，重新執行 `npm install` -- 注意埠號衝突（預設 Vite 使用 5173 埠） +- 刪除 `node_modules` 與 `package-lock.json` ，重新執行 `npm install` +- 注意連接埠衝突（預設 Vite 使用 5173 埠） **API 伺服器無法啟動**： -- 確認 Node.js 版本符合最低需求（node >=10） -- 檢查埠號是否已被佔用 -- 確保所有依賴皆已安裝（執行 `npm install`） +- 檢視 Node.js 版本是否符合最低需求（node >=10） +- 確認連接埠是否已被佔用 +- 確保使用 `npm install` 安裝所有依賴 **瀏覽器擴充功能無法載入**： - 確認 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` 存在 ### 開發環境建議 -- 使用 VS Code 搭配 Live Server 擴充功能開發 HTML 專案 -- 安裝 ESLint 與 Prettier 擴充功能，保持格式統一 -- 使用瀏覽器 DevTools 偵錯 JavaScript -- Vue 專案安裝 Vue DevTools 瀏覽器擴充功能 +- 使用帶有 Live Server 延伸功能的 VS Code 開發 HTML 專案 +- 安裝 ESLint 與 Prettier 扩展以保持格式一致 +- 使用瀏覽器開發者工具偵錯 JavaScript +- Vue 專案安裝 Vue DevTools 瀏覽器擴展 ### 性能考量 -- 由於超過 50 種語言翻譯，完整 clone 資料龐大 -- 若僅處理內容，可用淺層 clone：`git clone --depth 1` -- 英文內容工作時，排除翻譯資料夾搜尋 -- 第一次執行建置流程時較慢（npm install、Vite 建置） +- 多達50+語言的翻譯檔案，完整 clone 容量較大 +- 若只操作內容，建議用淺 clone：`git clone --depth 1` +- 英文內容工作時可排除翻譯檔案搜尋 +- 第一次執行建置程序較慢（npm install，Vite 建置） ## 安全考量 ### 環境變數 -- API 金鑰絕不可提交至儲存庫 -- 使用 `.env` 檔案（已列入 `.gitignore`） -- 於專案 README 文件中說明所需環境變數 +- API 金鑰絕不可提交入版本庫 +- 使用 `.env` 檔案（已加入 `.gitignore`） +- 在專案 README 中文件化必要環境變數 ### Python 專案 - 使用虛擬環境：`python -m venv venv` -- 依賴需定期更新 -- GitHub 代幣應有最小必要權限 +- 依賴庫保持更新 +- GitHub 令牌授權應最小化 -### GitHub Models 存取 +### GitHub 模型存取 -- 需使用個人存取代幣（PAT）存取 GitHub Models -- 代幣應儲存為環境變數 -- 嚴禁將代幣或憑證提交至儲存庫 +- 需個人存取令牌 (PAT) +- 將令牌存為環境變數 +- 切勿提交令牌或敏感資料 -## 附註 +## 額外說明 ### 目標受眾 -- 完全沒有網頁開發經驗的初學者 +- 網頁開發完全初學者 - 學生與自學者 -- 使用此課程於教室教學的教師 -- 內容設計有可及性且著重於循序漸進的技能建立 +- 教師用於課堂教學 +- 內容設計注重無障礙與逐步累積技能 -### 教學理念 +### 教育理念 -- 以專案為基礎的學習法 -- 常態性知識檢測（測驗） -- 實作演練 -- 具真實世界應用範例 -- 先掌握基礎後學習框架 +- 專案導向學習方式 +- 頻繁的知識檢測（測驗） +- 動手編碼練習 +- 真實世界應用範例 +- 重點在基礎而非框架 -### 儲存庫維護 +### 倉庫維護 -- 活躍的學習者與貢獻社群 -- 定期更新依賴與內容 -- 維護者監控問題與討論 -- 翻譯更新由 GitHub Actions 自動化 +- 活躍的學習者與貢獻者社群 +- 定期更新依賴及內容 +- 由維護者監控 issues 與討論 +- 使用 GitHub Actions 自動更新翻譯 ### 相關資源 - [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、資料科學、機器學習、物聯網課程皆有提供 +- 其他課程：生成式 AI、資料科學、機器學習、物聯網課程 -### 個別專案操作說明 +### 使用特定專案說明 -詳細說明見各專案資料夾的 README： -- `quiz-app/README.md` - Vue 3 測驗應用 -- `7-bank-project/README.md` - 帶驗證銀行應用 -- `5-browser-extension/README.md` - 瀏覽器擴充功能開發 -- `6-space-game/README.md` - 基於 Canvas 的遊戲開發 +詳細操作請參考 README 檔： +- `quiz-app/README.md` - Vue 3 測驗應用程式 +- `7-bank-project/README.md` - 含身份驗證的銀行應用程式 +- `5-browser-extension/README.md` - 瀏覽器擴充開發 +- `6-space-game/README.md` - Canvas 遊戲開發 - `9-chat-project/README.md` - AI 聊天助理專案 ### Monorepo 結構 -雖非傳統monorepo，本儲存庫包含多個獨立專案： -- 每堂課為自成一格單元 -- 專案間不共用依賴 -- 專注於個別專案，不會互相影響 -- 若需完整課程體驗，請完整 clone 儲存庫 +雖非傳統 Monorepo，但本倉庫包含多獨立專案： +- 每課程獨立封裝 +- 專案無相依共享 +- 可獨立作業不影響其他專案 +- 若需整套課程，請完整 clone 倉庫 --- **免責聲明**： -本文件係使用人工智能翻譯服務 [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