From fae448befbccfaa8fd066d0f5fd3876ea66cac5a Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 11:05:42 +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 | 408 +++++++++++----------- translations/zh-CN/.co-op-translator.json | 2 +- translations/zh-CN/AGENTS.md | 386 ++++++++++---------- translations/zh-MO/.co-op-translator.json | 2 +- translations/zh-MO/AGENTS.md | 406 ++++++++++----------- 6 files changed, 603 insertions(+), 603 deletions(-) diff --git a/translations/ur/.co-op-translator.json b/translations/ur/.co-op-translator.json index 230dc443f..f0967886f 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-06T07:42:30+00:00", + "translation_date": "2026-02-06T11:03:27+00:00", "source_file": "AGENTS.md", "language_code": "ur" }, diff --git a/translations/ur/AGENTS.md b/translations/ur/AGENTS.md index 7b1f093c5..9ca386925 100644 --- a/translations/ur/AGENTS.md +++ b/translations/ur/AGENTS.md @@ -2,281 +2,281 @@ ## پروجیکٹ کا جائزہ -یہ ابتدائیوں کو ویب ترقی کے بنیادی اصول سکھانے کے لیے تعلیمی نصاب کا مخزن ہے۔ یہ نصاب مائیکروسافٹ کلاؤڈ ایڈووکیٹس کے تیار کردہ 12 ہفتوں پر مشتمل جامع کورس ہے، جس میں 24 عملی اسباق شامل ہیں جو جاوا اسکرپٹ، سی ایس ایس، اور ایچ ٹی ایم ایل کی تعلیم دیتے ہیں۔ +یہ ویب ڈیولپمنٹ کے بنیادی اصول نوجوانوں کو سکھانے کے لیے تعلیمی نصاب کا ذخیرہ ہے۔ نصاب ایک جامع 12 ہفتوں کا کورس ہے جسے Microsoft Cloud Advocates نے تیار کیا ہے، جس میں JavaScript، CSS، اور HTML پر مشتمل 24 عملی اسباق شامل ہیں۔ -### اہم اجزاء +### کلیدی اجزاء -- **تعلیمی مواد**: 24 منظم اسباق پروجیکٹ بیسڈ ماڈیولز میں ترتیب دیے گئے ہیں -- **عملی پروجیکٹس**: ٹیریریم، ٹائپنگ گیم، براؤزر ایکسٹینشن، اسپیس گیم، بینکنگ ایپ، کوڈ ایڈیٹر، اور اے آئی چیٹ اسسٹنٹ -- **انٹرایکٹو کوئزز**: 48 کوئزز ہر ایک میں 3 سوالات (سبق سے پہلے اور بعد میں تشخیص) -- **کئی زبانوں کی معاونت**: گٹ ہب ایکشنز کے ذریعے 50+ زبانوں میں خودکار ترجمہ -- **ٹیکنالوجیز**: ایچ ٹی ایم ایل، سی ایس ایس، جاوا اسکرپٹ، ویو۔جے ایس 3، وائٹ، نوڈ۔جے ایس، ایکسپریس، پائتھون (AI پروجیکٹس کے لیے) +- **تعلیمی مواد**: 24 منظم اسباق جو پروجیکٹ کی بنیاد پر ماڈیولز میں ترتیب دیے گئے ہیں +- **عملی پروجیکٹس**: Terrarium، Typing Game، Browser Extension، Space Game، Banking App، Code Editor، اور AI Chat Assistant +- **انٹرایکٹو کوئزز**: 48 کوئزز، ہر ایک میں 3 سوالات (سبق سے پہلے اور بعد کے جائزے) +- **کئی زبانوں کی حمایت**: GitHub Actions کے ذریعے 50+ زبانوں میں خودکار ترجمے +- **ٹیکنالوجیز**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI پروجیکٹس کے لیے) -### ساخت +### فن تعمیر -- سبق پر مبنی تعلیمی مخزن -- ہر سبق کا فولڈر README، کوڈ مثالیں، اور حل رکھتا ہے -- الگ الگ ڈائریکٹریز میں اسٹینڈ الون پروجیکٹس (quiz-app، مختلف سبق کے پروجیکٹس) -- گٹ ہب ایکشنز سے ترجمہ کا نظام (co-op-translator) -- ڈاکسفائی کے ذریعے دستاویزات کی فراہمی اور 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 ``` -### کوئز ایپ سیٹ اپ (ویو 3 + وائٹ) +### Quiz App سیٹ اپ (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 چلائیں ``` -### بینک پروجیکٹ API (نوڈ۔جے ایس + ایکسپریس) +### Bank پروجیکٹ API (Node.js + Express) ```bash cd 7-bank-project/api npm install npm start # اے پی آئی سرور شروع کریں -npm run lint # ESLint چلائیں -npm run format # Prettier کے ساتھ فارمیٹ کریں +npm run lint # ای ایس لنٹ چلائیں +npm run format # پریٹیئر سے فارمیٹ کریں ``` -### براؤزر ایکسٹینشن پروجیکٹس +### Browser Extension پروجیکٹس ```bash cd 5-browser-extension/solution npm install -# مخصوص براؤزر کے ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں +# براؤزر-مخصوص ایکسٹینشن لوڈ کرنے کی ہدایات پر عمل کریں ``` -### اسپیس گیم پروجیکٹس +### Space Game پروجیکٹس ```bash cd 6-space-game/solution npm install -# فائل index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں +# index.html کو براؤزر میں کھولیں یا Live Server استعمال کریں ``` -### چیٹ پروجیکٹ (پائتھون بیک اینڈ) +### Chat پروجیکٹ (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN ماحولیاتی متغیر کو سیٹ کریں +# GITHUB_TOKEN ماحولیاتی متغیر مقرر کریں python api.py ``` -## ترقیاتی ورک فلو +## ڈیولپمنٹ ورک فلو -### مواد کے تعاون کنندگان کے لیے +### مواد کے کنٹری بیوٹرز کے لیے -1. اپنی گٹ ہب اکاؤنٹ میں مخزن کی فورک کریں -2. اپنی فورک کو مقامی طور پر کلون کریں -3. تبدیلیوں کے لیے نئی برانچ بنائیں -4. سبق کے مواد یا کوڈ کی مثالوں میں تبدیلی کریں -5. متعلقہ پروجیکٹ ڈائریکٹریز میں کوڈ کی تبدیلیوں کی جانچ کریں -6. تعاون کے رہنما اصولوں کی پیروی کرتے ہوئے پل ریکویسٹ جمع کرائیں +1. **ریپوزٹری کو اپنے GitHub اکاؤنٹ پر فورک کریں** +2. **اپنے فورک کو مقامی طور پر کلون کریں** +3. **اپنے تبدیلیوں کے لیے نئی برانچ بنائیں** +4. سبق کے مواد یا کوڈ مثالوں میں تبدیلی کریں +5. متعلقہ پروجیکٹ فولڈرز میں کوڈ کی تبدیلیاں ٹیسٹ کریں +6. تعاون کی ہدایات کے مطابق پل ریکویسٹ جمع کروائیں ### سیکھنے والوں کے لیے -1. مخزن کو فورک یا کلون کریں -2. سبق کی ڈائریکٹریز میں ترتیب سے جائیں +1. ریپوزٹری کو فورک یا کلون کریں +2. سبق کی ڈائریکٹریز میں تسلسل کے ساتھ جائیں 3. ہر سبق کے README فائلیں پڑھیں -4. سبق سے پہلے کی کوئزز مکمل کریں https://ff-quizzes.netlify.app/web/ -5. سبق کے فولڈرز میں کوڈ مثالوں پر کام کریں +4. سبق سے پہلے کوئزز مکمل کریں https://ff-quizzes.netlify.app/web/ +5. سبق کے فولڈرز میں کوڈ کی مثالوں پر کام کریں 6. اسائنمنٹس اور چیلنجز مکمل کریں -7. سبق کے بعد کی کوئزز لیں +7. سبق کے بعد کوئزز لیں -### لائیو ڈیویلپمنٹ +### براہ راست ترقی - **دستاویزات**: روٹ میں `docsify serve` چلائیں (پورٹ 3000) -- **کوئز ایپ**: `quiz-app` ڈائریکٹری میں `npm run dev` چلائیں -- **پروجیکٹس**: ایچ ٹی ایم ایل پروجیکٹس کے لیے VS کوڈ لائیو سرور ایکسٹینشن استعمال کریں -- **API پروجیکٹس**: متعلقہ API ڈائریکٹریز میں `npm start` چلائیں +- **Quiz App**: 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 # تعمیر کی کامیابی کی تصدیق کریں ``` -### بینک API کی ٹیسٹنگ +### Bank API کی ٹیسٹنگ ```bash cd 7-bank-project/api npm run lint # کوڈ کے انداز کے مسائل کی جانچ کریں -node server.js # سرور کے بغیر غلطیوں کے شروع ہونے کی تصدیق کریں +node server.js # تصدیق کریں کہ سرور بغیر غلطیوں کے شروع ہوتا ہے ``` -### عمومی ٹیسٹنگ کا طریقہ کار +### عمومی ٹیسٹنگ طریقہ کار -- یہ تعلیمی مخزن جامع خودکار ٹیسٹس نہیں رکھتا -- دستی ٹیسٹنگ پر توجہ مرکوز ہے: - - کوڈ کی مثالیں بغیر کسی ایرر کے چلیں - - دستاویزات میں لنکس درست کام کریں - - پروجیکٹ کامیابی سے بنیں - - مثالیں بہترین طریقہ کار کی پیروی کریں +- یہ ایک تعلیمی ذخیرہ ہے اور جامع خودکار ٹیسٹ نہیں رکھتا +- دستی ٹیسٹنگ پر توجہ دی جاتی ہے: + - کوڈ کی مثالیں بغیر غلطی چلیں + - دستاویزات کی لنکس صحیح کام کریں + - پروجیکٹ کی تعمیر کامیابی سے مکمل ہو + - مثالیں بہترین طریقوں پر عمل کریں -### قبل از جمع کرانے چیکس +### جمع کروانے سے پہلے چیکس -- `npm run lint` چلائیں جہاں `package.json` ہو -- مارک ڈاؤن لنکس کی درستگی کی تصدیق کریں -- کوڈ کی مثالوں کی براؤزر یا نوڈ۔جے ایس میں جانچ کریں -- ترجمہ شدہ مواد کی ساخت کی درستگی چیک کریں +- جہاں package.json موجود ہو، `npm run lint` چلائیں +- مارکڈاؤن کے لنکس کی تصدیق کریں +- مثالیں براؤزر یا Node.js میں ٹیسٹ کریں +- ترجمے مناسب ساخت کو برقرار رکھیں -## کوڈ اسٹائل کے رہنما اصول +## کوڈ اسٹائل گائیڈ لائنز -### جاوا اسکرپٹ +### JavaScript - جدید ES6+ نحو استعمال کریں -- پروجیکٹس میں فراہم کردہ ESLint کنفیگریشنز کا استعمال کریں -- تعلیمی وضاحت کے لیے بامعنی متغیر اور فنکشن کے نام رکھیں -- سیکھنے والوں کے لیے تصریحات شامل کریں -- جہاں ممکن ہو پریٹیئر سے فارمیٹنگ کریں +- پروجیکٹس میں فراہم کردہ ESLint کنفیگریشنز پر عمل کریں +- تعلیمی وضاحت کے لیے معنی خیز متغیر اور فنکشن کے نام استعمال کریں +- سیکھنے والوں کے لیے تصورات کی وضاحت والے تبصرے شامل کریں +- جہاں Prettier مرتب ہو، اس سے فارمیٹ کریں ### HTML/CSS -- سمانٹک HTML5 عناصر -- ریسپانسیو ڈیزائن کے اصول -- واضح کلاس ناموں کے کنونشن -- CSS تکنیکوں کی وضاحت کے لیے تبصرے +- معنوی HTML5 عناصر +- جوابدہ (Responsive) ڈیزائن اصول +- صاف ستھری کلاس نام کاری +- CSS تکنیکس کی وضاحت کرنے والے تبصرے سیکھنے والوں کے لیے -### پائتھون +### Python - PEP 8 اسٹائل گائیڈ لائنز - واضح، تعلیمی کوڈ مثالیں -- سیکھنے میں مدد کے لیے ٹائپ ہنٹس +- جہاں مفید ہو ٹائپ ہنٹس -### مارک ڈاؤن دستاویزات +### مارکڈاؤن دستاویزات -- واضح سرخیوں کی ترتیب +- صاف سرخیوں کی ترتیب - زبان کی وضاحت کے ساتھ کوڈ بلاکس - اضافی وسائل کے لنکس - `images/` فولڈرز میں اسکرین شاٹس اور تصاویر -- تصاویر کے لیے متبادل متن برائے رسائی +- تصاویر کے لیے Alt متن برائے آسان رسائی ### فائل آرگنائزیشن -- اسباق کو ترتیب وار نمبر دیے گئے (1-getting-started-lessons، 2-js-basics، وغیرہ) -- ہر پروجیکٹ میں `solution/` اور اکثر `start/` یا `your-work/` ڈائریکٹریز -- سبق کی مخصوص `images/` فولڈرز میں تصاویر محفوظ -- ترجمے `translations/{language-code}/` ڈھانچے میں +- اسباق متسلسل نمبر کے ساتھ (1-getting-started-lessons, 2-js-basics, وغیرہ) +- ہر پروجیکٹ میں `solution/` اور اکثر `start/` یا `your-work/` فولڈر +- سبق خصوصی `images/` فولڈر میں تصاویر محفوظ کی گئی ہیں +- ترجمے `translations/{language-code}/` ساخت میں -## تعمیری اور نفاذی عمل +## تعمیر اور تعیناتی -### کوئز ایپ نفاذ (Azure Static Web Apps) +### Quiz App کی تعیناتی (Azure Static Web Apps) -کوئز-ایپ کو Azure Static Web Apps کے لیے ترتیب دیا گیا ہے: +quiz-app Azure Static Web Apps کے لیے ترتیب دیا گیا ہے: ```bash cd quiz-app npm run build # فولڈر dist/ بناتا ہے -# مین پر دھکیلنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے +# مین پر پوش کرنے پر GitHub Actions ورک فلو کے ذریعے تعینات کرتا ہے ``` Azure Static Web Apps کی ترتیب: -- **ایپ کا مقام**: `/quiz-app` -- **آؤٹ پٹ مقام**: `dist` +- **ایپ لوکیشن**: `/quiz-app` +- **آؤٹ پٹ لوکیشن**: `dist` - **ورک فلو**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### دستاویزات کا PDF جنریشن +### دستاویزات کا PDF تیار کرنا ```bash -npm install # دستاویزات کو پی ڈی ایف میں تبدیل کرنے والی داکسیفائی انسٹال کریں -npm run convert # داکس سے پی ڈی ایف تیار کریں +npm install # انسٹال کریں docsify-to-pdf +npm run convert # docs سے PDF بنائیں ``` ### Docsify دستاویزات ```bash -npm install -g docsify-cli # ڈوکسفی کو عالمی طور پر انسٹال کریں -docsify serve # localhost:3000 پر سروس فراہم کریں +npm install -g docsify-cli # ڈاکسفائی کو عالمی طور پر انسٹال کریں +docsify serve # لوکل ہوسٹ:3000 پر سروس فراہم کریں ``` -### پروجیکٹ مخصوص بلڈز +### پروجیکٹ مخصوص تعمیر -ہر پروجیکٹ ڈائریکٹری کا اپنا بلڈ عمل ہو سکتا ہے: -- ویو پروجیکٹس: `npm run build` سے پروڈکشن بنڈلز بنتے ہیں -- سٹیٹک پروجیکٹس: کوئی بلڈ مرحلہ نہیں، فائلز براہِ راست سرور کی جاتی ہیں +ہر پروجیکٹ فولڈر کا اپنا تعمیر عمل ہو سکتا ہے: +- Vue پروجیکٹس: `npm run build` سے پروڈکشن بنڈلز بنتے ہیں +- سٹیٹک پروجیکٹس: کوئی تعمیر مرحلہ نہیں، فائلز براہ راست سرو کریں -## پل ریکوسٹ گائیڈ لائنز +## پل ریکویسٹ گائیڈ لائنز -### عنوانی فارمیٹ +### عنوان کا فارمیٹ -تبدیلی کے حصے کی واضح اور وضاحتی عنوانات استعمال کریں: -- `[Quiz-app] Add new quiz for lesson X` -- `[Lesson-3] Fix typo in terrarium project` -- `[Translation] Add Spanish translation for lesson 5` -- `[Docs] Update setup instructions` +صاف اور وضاحتی عنوانات استعمال کریں جو تبدیلی کے علاقے کو ظاہر کریں: +- `[Quiz-app] سبق X کے لیے نیا کوئز شامل کریں` +- `[Lesson-3] terrarium پروجیکٹ میں ٹائپو درست کریں` +- `[Translation] سبق 5 کے لیے ہسپانوی ترجمہ شامل کریں` +- `[Docs] سیٹ اپ ہدایات کو اپ ڈیٹ کریں` -### مطلوبہ چیکس +### درکار چیکس -PR جمع کرانے سے پہلے: +PR جمع کروانے سے پہلے: -1. **کوڈ کی کوالٹی**: - - متاثرہ پروجیکٹ ڈائریکٹریز میں `npm run lint` چلائیں - - تمام لینٹنگ ایررز اور وارننگز درست کریں +1. **کوڈ کی معیار**: + - متاثرہ پروجیکٹ فولڈرز میں `npm run lint` چلائیں + - تمام lint کی غلطیاں اور وارننگز ٹھیک کریں -2. **بلڈ کی تصدیق**: - - اگر قابل اطلاق ہے تو `npm run build` چلائیں - - یقینی بنائیں کہ کوئی بلڈ ایرر نہیں ہے +2. **تعمیر کی تصدیق**: + - جہاں لاگو ہو `npm run build` چلائیں + - یقینی بنائیں کہ کوئی تعمیر کی غلطی نہ ہو -3. **لنک ویلیڈیشن**: - - تمام مارک ڈاؤن لنکس کی جانچ کریں - - امیج ریفرنسز کام کر رہے ہیں +3. **لنک کی توثیق**: + - تمام مارکڈاؤن لنکس کا ٹیسٹ کریں + - تصویری حوالہ جات کام کر رہے ہیں کی تصدیق کریں 4. **مواد کا جائزہ**: - - ہجے اور گرامر کی جانچ کریں - - کوڈ کی مثالیں درست اور تعلیمی ہوں - - ترجمے اصل معنی برقرار رکھیں + - املا اور گرامر کی جانچ کریں + - کوڈ مثالیں درست اور تعلیمی ہوں + - ترجمے اصل معنی کو برقرار رکھیں -### شراکت کے تقاضے +### تعاون کی ضروریات -- مائیکروسافٹ 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 مینٹینرز اور کمیونٹی کے ذریعے جائزہ لیے جاتے ہیں - تعلیمی وضاحت کو ترجیح دی جاتی ہے -- کوڈ مثالیں موجودہ بہترین طریقہ کار کی پیروی کریں -- ترجمے درستگی اور ثقافتی مناسبت کے لیے جائزہ لیے جاتے ہیں +- کوڈ مثالیں موجودہ بہترین طریقوں کی پیروی کریں +- ترجمے درستگی اور ثقافتی مناسبت کی جانچ پڑتال سے گزریں -## ترجمہ کا نظام +## ترجمہ نظام ### خودکار ترجمہ -- گٹ ہب ایکشنز کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے -- 50+ زبانوں میں خودکار ترجمہ +- GitHub Actions کے ساتھ co-op-translator ورک فلو استعمال کرتا ہے +- 50+ زبانوں میں خود بخود ترجمہ کرتا ہے - ماخذ فائلیں مرکزی ڈائریکٹریز میں -- ترجمہ شدہ فائلیں `translations/{language-code}/` میں +- ترجمہ شدہ فائلیں `translations/{language-code}/` فولڈرز میں -### دستی ترجمہ بہتری کے اضافے +### دستی ترجمہ کی بہتری شامل کرنا -1. `translations/{language-code}/` میں فائل تلاش کریں -2. ساخت برقرار رکھتے ہوئے بہتری کریں -3. کوڈ کی مثالیں کام کرنے والی رکھیں -4. لوکلائزڈ کوئز مواد کی جانچ کریں +1. `translations/{language-code}/` فولڈر میں فائل تلاش کریں +2. ساخت کو برقرار رکھتے ہوئے بہتری کریں +3. یقینی بنائیں کہ کوڈ مثالیں کام کرتی رہیں +4. کسی بھی لوکلائزڈ کوئز مواد کو ٹیسٹ کریں -### ترجمے کا میٹا ڈیٹا +### ترجمہ کے میٹاڈیٹا -ترجمہ شدہ فائلوں میں میٹا ڈیٹا ہیڈر شامل ہوتا ہے: +ترجمہ شدہ فائلوں میں میٹاڈیٹا ہیڈر شامل ہوتا ہے: ```markdown ``` -## ڈیبگنگ اور مسئلہ حل کرنا +## ڈی بگنگ اور مسئلہ حل کرنا ### عام مسائل -**کوئز ایپ شروع نہیں ہوتی**: -- نوڈ۔جے ایس کا ورژن چیک کریں (v14+ سفارش کی جاتی ہے) +**Quiz app شروع نہیں ہو رہا**: +- Node.js کا ورژن چیک کریں (v14+ تجویز شدہ) - `node_modules` اور `package-lock.json` حذف کریں، پھر `npm install` چلائیں -- پورٹ کے تصادمات کی جانچ کریں (ڈیفالٹ: وائٹ 5173 پورٹ استعمال کرتا ہے) +- پورٹ کی ٹکراؤ کو چیک کریں (ڈیفالٹ: Vite پورٹ 5173 استعمال کرتا ہے) -**API سرور شروع نہیں ہوتا**: -- نوڈ۔جے ایس کا ورژن کم از کم 10 ہو -- چیک کریں کہ پورٹ پہلے سے استعمال میں نہ ہو -- تمام dependencies `npm install` سے انسٹال کریں +**API سرور شروع نہیں ہو رہا**: +- کم از کم Node.js ورژن کا یقین دہانی کریں (node >=10) +- چیک کریں کہ پورٹ پہلے سے استعمال میں تو نہیں +- تمام dependencies `npm install` سے انسٹال ہوں -**براؤزر ایکسٹینشن لوڈ نہیں ہوتی**: -- `manifest.json` کی صحیح فارمیٹنگ یقینی بنائیں -- براؤزر کنسول میں ایررز چیک کریں -- براؤزر مخصوص انسٹالیشن ہدایات پر عمل کریں +**Browser extension لوڈ نہیں ہو رہا**: +- manifest.json کے درست فارمیٹ کی تصدیق کریں +- براؤزر کنسول میں غلطیوں کی جانچ کریں +- براؤزر مخصوص ایکسٹینشن انسٹالیشن ہدایات پر عمل کریں -**پائتھون چیٹ پروجیکٹ کے مسائل**: +**Python chat پروجیکٹ مسائل**: - OpenAI پیکیج انسٹال کریں: `pip install openai` -- GITHUB_TOKEN ماحول متغیر سیٹ ہے -- GitHub Models کی رسائی کی اجازتیں چیک کریں +- GITHUB_TOKEN ماحول متغیر سیٹ ہے کی جانچ کریں +- GitHub Models کے رسائی حقوق چیک کریں -**Docsify دستاویزات ظاہر نہیں کرتا**: +**Docsify دستاویزات سرور نہیں کر رہا**: - docsify-cli عالمی طور پر انسٹال کریں: `npm install -g docsify-cli` -- مخزن کی روٹ ڈائریکٹری سے چلائیں -- `docs/_sidebar.md` موجود ہے +- ذخیرہ کی روٹ ڈائریکٹری سے چلائیں +- یقینی بنائیں کہ `docs/_sidebar.md` موجود ہے -### ترقیاتی ماحول کے ٹپس +### ترقی کے ماحول کے نکات -- HTML پروجیکٹس کے لیے VS کوڈ میں لائیو سرور ایکسٹینشن استعمال کریں -- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشن نصب کریں -- جاوا اسکرپٹ کے لیے براؤزر کے ڈویلپر ٹولز استعمال کریں -- ویو پروجیکٹس کے لیے، Vue DevTools براؤزر ایکسٹینشن انسٹال کریں +- HTML پروجیکٹس کے لیے VS Code کے ساتھ Live Server ایکسٹینشن استعمال کریں +- مستقل فارمیٹنگ کے لیے ESLint اور Prettier ایکسٹینشنز انسٹال کریں +- JavaScript کی ڈی بگنگ کے لیے براؤزر DevTools کا استعمال کریں +- Vue پروجیکٹس کے لیے Vue DevTools براؤزر ایکسٹینشن انسٹال کریں -### کارکردگی کے ملاحظات +### کارکردگی کے لیے توجہ -- ترجمہ شدہ فائلوں کی بڑی تعداد (50+ زبانیں) مکمل کلون کو بڑا بناتی ہے -- صرف مواد پر کام کے لیے شالو کلون استعمال کریں: `git clone --depth 1` -- انگریزی مواد پر کام کرتے وقت ترجموں کو تلاش سے خارج کریں -- پہلی بار چلانے پر بلڈ عمل سست ہو سکتا ہے (npm install، وائٹ بلڈ) +- بڑی تعداد میں ترجمہ شدہ فائلیں (50+ زبانیں) کلون کو بڑا بناتی ہیں +- صرف مواد پر کام کر رہے ہوں تو shallow clone استعمال کریں: `git clone --depth 1` +- انگلش مواد پر کام کرتے وقت ترجمے کو تلاش سے خارج کریں +- پہلی بار چلانے پر تعمیراتی عمل سست ہو سکتے ہیں (npm install، Vite build) -## سیکیورٹی کے ملاحظات +## سیکیورٹی کے امور -### ماحول متغیرات +### ماحول کے متغیرات -- API کیز کبھی بھی مخزن میں جمع نہ کریں -- `.env` فائلوں کا استعمال کریں (جو `.gitignore` میں ہیں) -- پروجیکٹ README میں مطلوبہ ماحول متغیرات دستاویزی شکل میں شامل کریں +- API کلیدیں کبھی بھی ذخیرہ میں شامل نہ کریں +- `.env` فائلز استعمال کریں (جو پہلے سے `.gitignore` میں ہیں) +- ماحول متغیرات کی ضرورت پروجیکٹ کے README میں دستاویز کریں -### پائتھون پروجیکٹس +### Python پروجیکٹس - ورچوئل ماحول استعمال کریں: `python -m venv venv` -- dependencies کو اپ ڈیٹ رکھیں -- GitHub ٹوکنز کو کم سے کم ضروری اجازت دی جائے +- dependencies کو اپ ٹو ڈیٹ رکھیں +- GitHub کے ٹوکنز کم از کم ضروری اجازتوں کے ساتھ ہوں -### GitHub Models کی رسائی +### GitHub Models تک رسائی -- ذاتی رسائی ٹوکنز (PAT) GitHub Models کے لیے ضروری ہیں -- ٹوکنز کو ماحول متغیرات کے طور پر محفوظ کریں -- ٹوکنز یا اسناد کبھی جمع نہ کریں +- GitHub Models کے لیے Personal Access Tokens (PAT) مطلوب ہیں +- ٹوکنز کو ماحول کے متغیرات کے طور پر محفوظ کریں +- ٹوکنز یا اسناد کو کبھی ذخیرہ میں کمٹ نہ کریں ## اضافی نوٹس -### ہدف مخاطب +### ہدف سامعین -- ویب ترقی میں مکمل نئے شروعات کرنے والے +- ویب ڈیولپمنٹ کے مکمل نو آموز - طلباء اور خود سیکھنے والے -- اساتذہ جو نصاب کو کلاس رومز میں استعمال کرتے ہیں -- مواد رسائی کے لیے ڈیزائن کیا گیا ہے اور ہنر کی تدریجی تعمیر کے لیے +- کلاس رومز میں نصاب استعمال کرنے والے اساتذہ +- مواد آسان رسائی اور تدریجی مہارت سازی کے لیے ڈیزائن کیا گیا ہے ### تعلیمی فلسفہ -- پروجیکٹ بیسڈ سیکھنے کا طریقہ -- کثرت سے علم کی جانچ (کوئزز) -- عملی کوڈنگ مشقیں +- پروجیکٹ پر مبنی سیکھنے کا طریقہ +- کثرت سے علمی چیکز (کوئزز) +- عملی کوڈنگ کی مشقیں - حقیقی دنیا کی مثالیں -- فریم ورکس سے پہلے بنیادی باتوں پر توجہ +- فریم ورکس سے پہلے بنیادی اصولوں پر توجہ -### مخزن کی دیکھ بھال +### ذخیرہ کی دیکھ بھال -- متحرک سیکھنے والوں اور تعاون کنندگان کی کمیونٹی -- dependencies اور مواد کو باقاعدگی سے اپ ڈیٹ کیا جاتا ہے -- ایشوز اور مباحثوں کی نگرانی مینٹینرز کرتے ہیں -- ترجمہ کی اپ ڈیٹس گٹ ہب ایکشنز سے خودکار ہیں +- سیکھنے والوں اور کنٹری بیوٹرز کی فعال کمیونٹی +- dependencies اور مواد کی باقاعدہ اپ ڈیٹس +- مسائل اور مباحثے مینٹینرز کی نگرانی میں +- ترجمہ کی اپ ڈیٹس خودکار طور پر GitHub Actions کے ذریعے ### متعلقہ وسائل - [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) کو سیکھنے والوں کے لیے تجویز کیا گیا -- اضافی کورسز: جنریٹیو AI، ڈیٹا سائنس، ML، IoT نصابات دستیاب ہیں +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) سیکھنے والوں کے لیے تجویز کردہ +- اضافی کورسز: Generative AI, Data Science, ML, IoT نصاب دستیاب ### مخصوص پروجیکٹس کے ساتھ کام کرنا -مخصوص پروجیکٹس کے تفصیلی ہدایات کے لیے درج ذیل README فائلز دیکھیں: -- `quiz-app/README.md` - ویو 3 کوئز ایپلیکیشن -- `7-bank-project/README.md` - بینکنگ ایپلیکیشن تصدیق کے ساتھ -- `5-browser-extension/README.md` - براؤزر ایکسٹینشن ڈیویلپمنٹ -- `6-space-game/README.md` - کینواس پر مبنی گیم ڈیویلپمنٹ +انفرادی پروجیکٹس کے تفصیلی ہدایات کے لیے متعلقہ README فائلوں کو دیکھیں: +- `quiz-app/README.md` - Vue 3 کوئز ایپلیکیشن +- `7-bank-project/README.md` - بینکنگ ایپلیکیشن جس میں توثیق شامل ہے +- `5-browser-extension/README.md` - براؤزر ایکسٹینشن کی ترقی +- `6-space-game/README.md` - کینوس پر مبنی گیم ترقی - `9-chat-project/README.md` - AI چیٹ اسسٹنٹ پروجیکٹ -### مونو ریپو ساخت +### مونو ریپوزٹری کا ڈھانچہ -یہ کلاسیکل مونو ریپو نہیں ہے، بلکہ اس میں کئی آزاد پروجیکٹس شامل ہیں: +اگرچہ یہ روایتی مونو ریپوزٹری نہیں، اس میں متعدد آزاد پروجیکٹس شامل ہیں: - ہر سبق خود مختار ہے -- پروجیکٹس کی dependencies مشترک نہیں -- ایک پروجیکٹ پر کام کریں بغیر دوسرے متاثر کیے -- مکمل نصاب کا تجربہ کرنے کے لیے پورے مخزن کو کلون کریں +- پروجیکٹس dependencies شیئر نہیں کرتے +- بغیر ایک دوسرے کو متاثر کیے انفرادی پروجیکٹس پر کام کریں +- مکمل نصاب کے لیے پورے ریپوزٹری کو کلون کریں --- -**دستخطی نوٹس**: -یہ دستاویز 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/zh-CN/.co-op-translator.json b/translations/zh-CN/.co-op-translator.json index 1090ae68b..2cef7415c 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-06T07:43:26+00:00", + "translation_date": "2026-02-06T11:04:25+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 710efdb2a..8fa90005e 100644 --- a/translations/zh-CN/AGENTS.md +++ b/translations/zh-CN/AGENTS.md @@ -2,42 +2,42 @@ ## 项目概述 -这是一个面向初学者的网页开发基础教学课程仓库。该课程由微软云推广者开发，是一个为期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格式 -## 安装命令 +## 设置命令 -本仓库主要用于学习内容浏览。针对具体项目操作： +该仓库主要用于教育内容的学习。针对具体项目的操作如下： -### 主仓库安装 +### 主仓库设置 ```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 # 启动 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 -# 遵循浏览器特定的扩展加载说明 +# 遵循针对浏览器的特定扩展加载说明 ``` ### 太空游戏项目 @@ -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. 遵守贡献指南提交拉取请求（PR） -### 学习者指导 +### 对学习者 -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` -- **项目**：使用VS Code Live Server扩展启动HTML项目 -- **API项目**：运行各自API目录中的 `npm start` +- **文档服务**：在根目录运行 `docsify serve` （默认端口3000） +- **测验应用**：在quiz-app目录中运行 `npm run dev` +- **项目**：HTML项目用VS Code Live Server扩展 +- **API项目**：在对应API目录运行 `npm start` ## 测试说明 @@ -119,78 +119,78 @@ 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 静态网页应用） +### 测验应用部署（Azure Static Web Apps） -quiz-app 配置用于 Azure 静态网页应用部署： +quiz-app配置用于Azure Static Web Apps部署： ```bash cd quiz-app npm run build # 创建 dist/ 文件夹 -# 在推送到 main 时通过 GitHub Actions 工作流程进行部署 +# 在推送到 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生成 @@ -207,76 +207,76 @@ 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] 更新安装说明` +使用清晰描述改动范围的标题： +- `[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描述中引用相关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.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 Models访问权限 +**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` -### 开发环境建议 +### 开发环境提示 -- 使用VS Code配合Live Server扩展进行HTML项目开发 -- 安装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令牌权限应最小化 -### GitHub Models访问 +### GitHub模型访问 -- 需要个人访问令牌（PAT） -- 令牌需存储为环境变量 -- 切勿提交令牌或凭据 +- 需要个人访问令牌（PAT） +- 令牌存储为环境变量 +- 绝不可提交令牌或凭证 -## 附加说明 +## 其他说明 ### 目标受众 -- 完全的网页开发初学者 -- 学生和自学者 -- 在课堂使用该课程的教师 -- 内容设计注重无障碍和循序渐进 +- 完全的网页开发初学者 +- 学生及自学者 +- 教师在课堂使用此课程 +- 内容注重无障碍和逐步技能提升 -### 教育理念 +### 教学理念 -- 项目驱动学习 -- 经常性知识检测（测验） -- 动手编码练习 -- 真实世界应用案例 -- 强调基础知识先于框架 +- 基于项目的学习方式 +- 频繁的知识检测（测验） +- 动手编码练习 +- 真实案例应用 +- 先注重基础，再涉及框架 ### 仓库维护 -- 活跃的学习者与贡献者社区 -- 定期更新依赖和内容 -- 维护者监控问题和讨论 -- 通过GitHub Actions自动更新翻译 +- 活跃的学习者和贡献者社区 +- 定期更新依赖和内容 +- 维护者监控Issue和讨论 +- 翻译更新自动化通过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、数据科学、机器学习、物联网课程 +- [微软学习模块](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，但包含多个独立项目： -- 每个课程独立完整 -- 项目依赖不共享 -- 可单独开发，不影响其他项目 -- 克隆整个仓库可体验完整课程体系 +虽非传统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 f386b9610..8df5a35dc 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-06T07:44:29+00:00", + "translation_date": "2026-02-06T11:05:38+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 625a5b4c7..2f4a49ec5 100644 --- a/translations/zh-MO/AGENTS.md +++ b/translations/zh-MO/AGENTS.md @@ -1,47 +1,47 @@ # AGENTS.md -## Project Overview +## 專案概述 -這是一個為初學者教授網頁開發基礎的教育課程庫。該課程是由 Microsoft Cloud Advocates 開發的全面 12 週課程，包含 24 個涵蓋 JavaScript、CSS 及 HTML 的實作課程。 +這是一個用於教導初學者網頁開發基礎的教育課程儲存庫。課程為一套完整的12週課程，由 Microsoft Cloud Advocates 開發，包含24堂涵蓋 JavaScript、CSS 與 HTML 的實作課程。 -### Key Components +### 主要組成部分 -- **教育內容**：24 個有結構的課程，組織成以專案為基礎的模組 -- **實作專案**：Terrarium、生字打字遊戲、瀏覽器擴充功能、太空遊戲、銀行應用程式、程式碼編輯器及 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 專案） -### Architecture +### 架構 -- 以課程為基礎架構的教育代碼庫 -- 每個課程資料夾包含 README、程式碼範例及解答 -- 獨立專案位於不同目錄（quiz-app，各種課程專案） -- 使用 GitHub Actions （co-op-translator）進行翻譯系統 -- 文件以 Docsify 提供服務，並可下載 PDF +- 以課程單元為結構的教育儲存庫 +- 每堂課資料夾包含 README、程式範例及解答 +- 獨立專案放在不同目錄（quiz-app，各種課程專案） +- 使用 GitHub Actions（co-op-translator）執行翻譯系統 +- 文件透過 Docsify 提供，並可匯出為 PDF -## Setup Commands +## 設置指令 -此代碼庫主要用於教育內容學習。若需使用特定專案： +此儲存庫主要是用來使用教育內容。若要操作特定專案： -### Main Repository Setup +### 主要儲存庫設置 ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Quiz App Setup (Vue 3 + Vite) +### 測驗應用設置 (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # 啟動開發伺服器 -npm run build # 建立生產版本 +npm run build # 生產環境構建 npm run lint # 執行 ESLint ``` -### Bank Project API (Node.js + Express) +### 銀行專案 API (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,23 +51,23 @@ npm run lint # 執行 ESLint npm run format # 使用 Prettier 格式化 ``` -### Browser Extension Projects +### 瀏覽器擴充功能專案 ```bash cd 5-browser-extension/solution npm install -# 遵從瀏覽器特定的擴展載入指示 +# 遵循瀏覽器特定的擴充功能載入指示 ``` -### Space Game Projects +### 太空遊戲專案 ```bash cd 6-space-game/solution npm install -# 於瀏覽器中開啟 index.html 或使用 Live Server +# 在瀏覽器中打開 index.html 或使用 Live Server ``` -### Chat Project (Python Backend) +### 聊天專案 (Python 後端) ```bash cd 9-chat-project/solution/backend/python @@ -76,207 +76,207 @@ pip install openai python api.py ``` -## Development Workflow +## 開發工作流程 -### For Content Contributors +### 內容貢獻者 -1. **Fork 該代碼庫** 至您的 GitHub 帳戶 -2. **在本地 Clone 您的 Fork** -3. **為您的修改建立新分支** -4. 修改課程內容或程式碼範例 -5. 測試相關專案目錄中的程式碼更動 -6. 根據貢獻指南提交 Pull Request +1. **將儲存庫 fork** 到你的 GitHub 帳號 +2. **在本地端 clone 你的 fork** +3. **建立新分支** 進行變更 +4. 修改課程內容或程式範例 +5. 在相關專案目錄測試程式碼變更 +6. 提交 pull request 並遵循貢獻指南 -### For Learners +### 學習者流程 -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. 進行課後測驗 -### Live Development +### 即時開發 -- **文件**：在根目錄執行 `docsify serve`（預設埠 3000） -- **Quiz App**：在 quiz-app 目錄執行 `npm run dev` -- **專案**：對 HTML 專案使用 VS Code Live Server 擴充功能 -- **API 專案**：在相應的 API 目錄執行 `npm start` +- **文件服務**：在根目錄執行 `docsify serve` （預設使用埠號 3000） +- **測驗應用**：在 quiz-app 目錄執行 `npm run dev` +- **專案**：HTML 專案使用 VS Code Live Server 擴充功能 +- **API 專案**：分別於對應 API 目錄執行 `npm start` -## Testing Instructions +## 測試說明 -### Quiz App Testing +### 測驗應用測試 ```bash cd quiz-app -npm run lint # 檢查代碼風格問題 -npm run build # 確認建構成功 +npm run lint # 檢查程式碼風格問題 +npm run build # 驗證建置是否成功 ``` -### Bank API Testing +### 銀行 API 測試 ```bash cd 7-bank-project/api npm run lint # 檢查代碼風格問題 -node server.js # 驗證伺服器啟動是否無錯誤 +node server.js # 驗證伺服器啟動時無錯誤 ``` -### General Testing Approach +### 一般測試方法 -- 此為教育用代碼庫，無全面自動化測試 +- 本教育儲存庫無完整自動化測試 - 手動測試重點： - - 程式碼範例執行無錯誤 - - 文件中的連結正確可用 - - 專案成功建置 - - 範例遵守最佳實務 + - 程式範例執行無誤 + - 文件內連結皆可正常使用 + - 專案可成功建置 + - 範例符合最佳實務 -### Pre-submission Checks +### 提交前檢查 -- 在含 package.json 的目錄執行 `npm run lint` -- 驗證 markdown 連結有效 -- 在瀏覽器或 Node.js 中測試程式碼範例 -- 確保翻譯結構保持正確 +- 在有 package.json 的目錄執行 `npm run lint` +- 驗證 markdown 連結有效性 +- 在瀏覽器或 Node.js 中測試程式範例 +- 確認翻譯檔保持正確結構 -## Code Style Guidelines +## 程式碼風格指南 ### JavaScript - 使用現代 ES6+ 語法 -- 遵循專案指定的標準 ESLint 配置 -- 變量與函數命名具教育意義 -- 加入註解說明概念方便學習 -- 使用 Prettier 格式化（有設定的情況下） +- 遵循專案中 ESLint 預設規範 +- 變數與函式名稱具教育意義 +- 加入註解解釋概念供學習者理解 +- 使用 Prettier 進行格式化（若已設定） ### HTML/CSS -- 使用語意化 HTML5 元素 -- 響應式設計原則 -- 清晰的類別命名規範 -- CSS 技巧附註解說以利學習 +- 使用語意化 HTML5 標籤 +- 採用響應式設計原則 +- 清楚的 class 命名慣例 +- CSS 內加入教學性註解 ### Python -- 遵守 PEP 8 風格指引 -- 清楚、具教育意義的程式碼範例 -- 需要時使用型別提示幫助理解 +- 遵循 PEP 8 風格指南 +- 提供清晰且具教育意義的程式碼範例 +- 在有助於學習的地方加入類型提示 -### Markdown Documentation +### Markdown 文件 -- 清晰的標題階層 -- 指定語言的程式碼區塊 -- 指向額外資源的連結 -- `images/` 目錄內的截圖及圖片 -- 圖片皆具備替代文字 (alt text) 以利存取性 +- 清楚的標題層級結構 +- 標示語言的程式碼區塊 +- 引用額外資源連結 +- `images/` 目錄中的截圖與圖片 +- 圖片提供替代文字以提升可及性 -### File Organization +### 檔案組織 -- 課程依序編號（1-getting-started-lessons, 2-js-basics 等） -- 每個專案擁有 `solution/`，且常見有 `start/` 或 `your-work/` 目錄 -- 圖片儲存在課程專用的 `images/` 資料夾 -- 翻譯存放於 `translations/{language-code}/` 結構內 +- 課程目錄依序號命名（1-getting-started-lessons，2-js-basics 等） +- 每專案都包含 `solution/` 常見有 `start/` 或 `your-work/` +- 圖片置於每堂課專用的 `images/` 資料夾中 +- 翻譯檔案存於 `translations/{language-code}/` 結構 -## Build and Deployment +## 建置與部署 -### Quiz App Deployment (Azure Static Web Apps) +### 測驗應用部署（Azure 靜態網站服務） -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` +Azure 靜態網站服務設定： +- **應用位置**：`/quiz-app` - **輸出位置**：`dist` - **工作流程**：`.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Documentation PDF Generation +### 文件 PDF 產生 ```bash npm install # 安裝 docsify-to-pdf -npm run convert # 從 docs 生成 PDF +npm run convert # 由 docs 產生 PDF ``` -### Docsify Documentation +### Docsify 文件服務 ```bash -npm install -g docsify-cli # 全局安裝 Docsify +npm install -g docsify-cli # 全域安裝 Docsify docsify serve # 在 localhost:3000 提供服務 ``` -### Project-specific Builds +### 專案個別建置 -各專案目錄可能有獨立建置過程： -- Vue 專案：`npm run build` 建立生產版本包 -- 靜態專案：無需建置，直接提供檔案服務 +每個專案目錄可能有自己的建置流程： +- Vue 專案：執行 `npm run build` 產生正式版套件 +- 靜態專案：無建置步驟，直接提供檔案 -## Pull Request Guidelines +## Pull Request 指引 -### Title Format +### 標題格式 -使用清楚描述改動範圍的標題： -- `[Quiz-app] 新增第 X 課測驗` -- `[Lesson-3] 修改 terrarium 專案的拼寫錯誤` -- `[Translation] 新增第 5 課西班牙語翻譯` -- `[Docs] 更新設定指南` +使用清楚且描述變更範圍的標題： +- `[Quiz-app] 新增第X課測驗` +- `[Lesson-3] 修正溫室專案錯字` +- `[Translation] 第5課西班牙語翻譯` +- `[Docs] 更新安裝指引` -### Required Checks +### 必要檢查 提交 PR 前： 1. **程式碼品質**： - 在相關專案目錄執行 `npm run lint` - - 修正所有錯誤與警告 + - 修正所有 lint 錯誤與警告 2. **建置驗證**： - - 如果適用，執行 `npm run build` + - 如適用執行 `npm run build` - 確保無建置錯誤 3. **連結驗證**： - 測試所有 markdown 連結 - - 確認圖片參考正常 + - 確認圖片引用正常 -4. **內容檢閱**： +4. **內容檢查**： - 校對拼字與文法 - - 確保程式碼範例正確及具教育意味 - - 核對翻譯保持原意 + - 確保程式範例正確且具教學價值 + - 確認翻譯符合原意 -### Contribution Requirements +### 貢獻要求 -- 同意 Microsoft CLA（第一次 PR 自動檢查） -- 遵守 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- 詳情請見 [CONTRIBUTING.md](./CONTRIBUTING.md) -- 若適用，於 PR 描述中參考相關 issue 編號 +- 同意 Microsoft CLA（首次 PR 時自動檢查） +- 遵守 [Microsoft 開源行為守則](https://opensource.microsoft.com/codeofconduct/) +- 詳細指南請見 [CONTRIBUTING.md](./CONTRIBUTING.md) +- 若適用，於 PR 說明中引用議題編號 -### Review Process +### 審查流程 -- 由維護者與社群審閱 PR -- 優先教育內容的清晰性 -- 程式碼範例應符合當前最佳實務 -- 翻譯審核準確度及文化適應性 +- 由維護者與社群共同審查 PR +- 優先考量教育的清晰度 +- 程式範例遵循目前最佳實務 +- 翻譯經過準確性與文化適切性審核 -## Translation System +## 翻譯系統 -### Automated Translation +### 自動翻譯 -- 使用 GitHub Actions 與 co-op-translator 工作流程 -- 自動將內容翻譯為 50 多種語言 -- 原始檔案保存在主目錄 -- 翻譯檔案存放於 `translations/{language-code}/` 目錄 +- 透過 GitHub Actions 及 co-op-translator 工作流程運作 +- 自動翻譯超過 50 種語言 +- 原始檔位於主目錄 +- 翻譯檔位於 `translations/{language-code}/` 目錄 -### Adding Manual Translation Improvements +### 手動翻譯改進 -1. 找到 `translations/{language-code}/` 內相關檔案 -2. 在保留結構前提下進行優化 -3. 確保程式碼範例仍可正常運作 -4. 測試本地化測驗內容 +1. 找到 `translations/{language-code}/` 中的檔案 +2. 在保持結構的前提下進行改進 +3. 確保程式範例仍可正常運作 +4. 測試本地化的測驗內容 -### Translation Metadata +### 翻譯檔元資料 -翻譯檔案含頭部元資料： +譯文檔包含元資料標頭： ```markdown ``` -## Debugging and Troubleshooting +## 疑難解答與除錯 -### Common Issues +### 常見問題 -**Quiz app 啟動失敗**： +**測驗應用無法啟動**： - 檢查 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 Models 權限正確 -**Docsify 文件無法啟動**： +**Docsify 不提供服務**： - 全局安裝 docsify-cli：`npm install -g docsify-cli` -- 從代碼庫根目錄執行 +- 於儲存庫根目錄執行 - 確認 `docs/_sidebar.md` 存在 -### Development Environment Tips +### 開發環境建議 -- HTML 專案使用 VS Code 及 Live Server 擴充功能 -- 安裝 ESLint 與 Prettier 擴充，保持格式一致 -- 使用瀏覽器開發工具調試 JavaScript +- 使用 VS Code 搭配 Live Server 擴充功能開發 HTML 專案 +- 安裝 ESLint 與 Prettier 擴充功能，保持格式統一 +- 使用瀏覽器 DevTools 偵錯 JavaScript - Vue 專案安裝 Vue DevTools 瀏覽器擴充功能 -### Performance Considerations +### 性能考量 -- 多語言翻譯檔案眾多（50+ 種語言），完整 Clone 會很大 -- 如只需處理內容，使用淺層 Clone：`git clone --depth 1` -- 在處理英文內容時排除翻譯結果以加快搜尋 -- 建置流程初次執行時（npm install、Vite build）較慢 +- 由於超過 50 種語言翻譯，完整 clone 資料龐大 +- 若僅處理內容，可用淺層 clone：`git clone --depth 1` +- 英文內容工作時，排除翻譯資料夾搜尋 +- 第一次執行建置流程時較慢（npm install、Vite 建置） -## Security Considerations +## 安全考量 -### Environment Variables +### 環境變數 -- API 金鑰絕不可提交到代碼庫 -- 使用 `.env` 檔案（已加入 `.gitignore`） -- README 文件說明所需環境變數 +- API 金鑰絕不可提交至儲存庫 +- 使用 `.env` 檔案（已列入 `.gitignore`） +- 於專案 README 文件中說明所需環境變數 -### Python Projects +### Python 專案 - 使用虛擬環境：`python -m venv venv` -- 維持依賴套件更新 -- GitHub Token 限制在最小必要權限 +- 依賴需定期更新 +- GitHub 代幣應有最小必要權限 -### GitHub Models Access +### GitHub Models 存取 -- 使用個人訪問 Token（PAT）存取 GitHub Models -- Token 透過環境變數儲存 -- 避免提交 Token 或憑證 +- 需使用個人存取代幣（PAT）存取 GitHub Models +- 代幣應儲存為環境變數 +- 嚴禁將代幣或憑證提交至儲存庫 -## Additional Notes +## 附註 -### Target Audience +### 目標受眾 -- 完全初學者的網頁開發學生 -- 自學者 -- 使用課程於教室的教師 -- 內容設計兼顧無障礙及循序漸進能力建構 +- 完全沒有網頁開發經驗的初學者 +- 學生與自學者 +- 使用此課程於教室教學的教師 +- 內容設計有可及性且著重於循序漸進的技能建立 -### Educational Philosophy +### 教學理念 -- 專案導向學習方法 -- 經常性知識檢核（問答測驗） -- 實作程式碼練習 -- 真實世界應用範例 -- 先重基礎再談框架 +- 以專案為基礎的學習法 +- 常態性知識檢測（測驗） +- 實作演練 +- 具真實世界應用範例 +- 先掌握基礎後學習框架 -### Repository Maintenance +### 儲存庫維護 -- 活躍的學習者與貢獻者社群 -- 依賴套件及內容定期更新 -- 維護者監控 issue 與討論 -- 翻譯系統自動化透過 GitHub Actions +- 活躍的學習者與貢獻社群 +- 定期更新依賴與內容 +- 維護者監控問題與討論 +- 翻譯更新由 GitHub Actions 自動化 -### Related Resources +### 相關資源 - [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、資料科學、機器學習、物聯網課程可用 +- 推薦學習者使用 [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) +- 其他課程：生成式 AI、資料科學、機器學習、物聯網課程皆有提供 -### Working with Specific Projects +### 個別專案操作說明 -詳細個別專案說明，請參閱： +詳細說明見各專案資料夾的 README： - `quiz-app/README.md` - Vue 3 測驗應用 -- `7-bank-project/README.md` - 具驗證功能銀行應用 +- `7-bank-project/README.md` - 帶驗證銀行應用 - `5-browser-extension/README.md` - 瀏覽器擴充功能開發 -- `6-space-game/README.md` - Canvas 遊戲開發 +- `6-space-game/README.md` - 基於 Canvas 的遊戲開發 - `9-chat-project/README.md` - AI 聊天助理專案 -### Monorepo Structure +### 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