diff --git a/translations/ar/.co-op-translator.json b/translations/ar/.co-op-translator.json index d4e4bba9b..45534e001 100644 --- a/translations/ar/.co-op-translator.json +++ b/translations/ar/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:14:41+00:00", + "translation_date": "2026-02-06T15:58:39+00:00", "source_file": "AGENTS.md", "language_code": "ar" }, @@ -516,11 +516,17 @@ "language_code": "ar" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T17:38:01+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T15:53:16+00:00", "source_file": "README.md", "language_code": "ar" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T15:55:59+00:00", + "source_file": "Roadmap.md", + "language_code": "ar" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-25T20:59:59+00:00", diff --git a/translations/ar/AGENTS.md b/translations/ar/AGENTS.md index 1665c8be5..244b7cd08 100644 --- a/translations/ar/AGENTS.md +++ b/translations/ar/AGENTS.md @@ -2,27 +2,27 @@ ## نظرة عامة على المشروع -هذا مستودع منهجي تعليمي لتعليم أساسيات تطوير الويب للمبتدئين. المنهج عبارة عن دورة شاملة لمدة 12 أسبوعًا تم تطويرها بواسطة Microsoft Cloud Advocates، ويشمل 24 درسًا عمليًا يغطي JavaScript وCSS وHTML. +هذا مستودع منهج تعليمي لتدريس أساسيات تطوير الويب للمبتدئين. المنهج هو دورة شاملة لمدة 12 أسبوعًا تم تطويرها بواسطة Microsoft Cloud Advocates، ويحتوي على 24 درسًا عمليًا تغطي JavaScript وCSS وHTML. ### المكونات الرئيسية -- **المحتوى التعليمي**: 24 درسًا منظمًا في وحدات قائمة على المشاريع -- **المشاريع العملية**: Terrarium، لعبة الكتابة، إضافة المتصفح، لعبة الفضاء، تطبيق البنك، محرر الأكواد، ومساعد الدردشة بالذكاء الاصطناعي -- **الاختبارات التفاعلية**: 48 اختبارًا يحتوي كل منها على 3 أسئلة (تقييمات قبل وبعد الدرس) -- **دعم متعدد اللغات**: ترجمات تلقائية لأكثر من 50 لغة عبر GitHub Actions -- **التقنيات**: HTML، CSS، JavaScript، Vue.js 3، Vite، Node.js، Express، Python (للمشاريع المتعلقة بالذكاء الاصطناعي) +- **المحتوى التعليمي**: 24 درسًا منظمين في وحدات تعتمد على المشاريع +- **مشاريع عملية**: تيراريوم، لعبة الكتابة، امتداد المتصفح، لعبة الفضاء، تطبيق البنك، محرر الشيفرة، ومساعد الدردشة بالذكاء الاصطناعي +- **اختبارات تفاعلية**: 48 اختبارًا يحتوي كل منها على 3 أسئلة (تقييمات قبل/بعد الدرس) +- **دعم متعدد اللغات**: ترجمات مؤتمتة لأكثر من 50 لغة عبر GitHub Actions +- **التقنيات**: HTML، CSS، JavaScript، Vue.js 3، Vite، Node.js، Express، Python (لمشاريع الذكاء الاصطناعي) -### الهيكلية +### البنية -- مستودع تعليمي مع هيكلية قائمة على الدروس -- يحتوي كل مجلد درس على README، أمثلة أكواد، وحلول -- مشاريع مستقلة في أدلة منفصلة (quiz-app، مشاريع الدروس المختلفة) -- نظام ترجمة باستخدام GitHub Actions (co-op-translator) -- الوثائق تُعرض عبر Docsify ومتاحة كملف PDF +- مستودع تعليمي به هيكلية تعتمد على الدروس +- كل مجلد درس يحتوي على ملف README، أمثلة شيفرة، وحلول +- مشاريع مستقلة في مجلدات منفصلة (quiz-app، مشاريع دروس متنوعة) +- نظام الترجمة يستخدم GitHub Actions (co-op-translator) +- التوثيق يُقدم عبر Docsify ومتوفر كملف PDF ## أوامر الإعداد -هذا المستودع مخصص بشكل أساسي لاستهلاك المحتوى التعليمي. للعمل مع مشاريع محددة: +هذا المستودع مخصص في المقام الأول لاستهلاك المحتوى التعليمي. للعمل على مشاريع محددة: ### إعداد المستودع الرئيسي @@ -36,27 +36,27 @@ cd Web-Dev-For-Beginners ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # بدء خادم التطوير +npm run build # البناء للإنتاج +npm run lint # تشغيل ESLint ``` -### إعداد واجهة برمجة تطبيقات البنك (Node.js + Express) +### API مشروع البنك (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # بدء خادم API +npm run lint # تشغيل ESLint +npm run format # التنسيق باستخدام Prettier ``` -### مشاريع إضافات المتصفح +### مشاريع امتداد المتصفح ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# اتبع تعليمات تحميل الامتدادات الخاصة بالمتصفح ``` ### مشاريع لعبة الفضاء @@ -64,45 +64,45 @@ npm install ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# افتح index.html في المتصفح أو استخدم الخادم المباشر ``` -### مشروع الدردشة (Python Backend) +### مشروع الدردشة (خلفية Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# تعيين متغير بيئة GITHUB_TOKEN python api.py ``` -## سير العمل التطويري +## سير عمل التطوير -### للمساهمين في المحتوى +### للمساهمين بالمحتوى -1. **قم بعمل Fork للمستودع** إلى حساب GitHub الخاص بك -2. **قم باستنساخ النسخة الخاصة بك** محليًا -3. **أنشئ فرعًا جديدًا** للتعديلات الخاصة بك -4. قم بإجراء تغييرات على محتوى الدروس أو أمثلة الأكواد -5. اختبر أي تغييرات في الأكواد في أدلة المشاريع ذات الصلة -6. قدم طلبات السحب وفقًا لإرشادات المساهمة +1. **انسخ المستودع إلى حساب GitHub الخاص بك (Fork)** +2. **استنسخ نسخة فورك محليًا** +3. **أنشئ فرعًا جديدًا** لإجراء التغييرات +4. اجري تغييرات على محتوى الدروس أو أمثلة الشيفرة +5. اختبر أي تغييرات في مجلدات المشاريع ذات الصلة +6. قدم طلبات سحب (Pull Requests) وفقًا لإرشادات المساهمة ### للمتعلمين -1. قم بعمل Fork أو استنساخ المستودع -2. انتقل إلى أدلة الدروس بالتسلسل +1. انسخ أو استنسخ المستودع +2. انتقل إلى مجلدات الدروس بترتيبها 3. اقرأ ملفات README لكل درس -4. أكمل اختبارات ما قبل الدرس على https://ff-quizzes.netlify.app/web/ -5. اعمل على أمثلة الأكواد في مجلدات الدروس -6. أكمل المهام والتحديات -7. قم بأداء اختبارات ما بعد الدرس +4. أكمل اختبارات قبل الدرس على https://ff-quizzes.netlify.app/web/ +5. اعمل على أمثلة الشيفرة في مجلدات الدروس +6. أكمل الواجبات والتحديات +7. خذ اختبارات ما بعد الدرس -### التطوير المباشر +### التطوير الحي -- **الوثائق**: قم بتشغيل `docsify serve` في الجذر (المنفذ 3000) -- **تطبيق الاختبارات**: قم بتشغيل `npm run dev` في دليل quiz-app -- **المشاريع**: استخدم إضافة Live Server في VS Code لمشاريع HTML -- **مشاريع واجهة برمجة التطبيقات**: قم بتشغيل `npm start` في أدلة واجهة برمجة التطبيقات ذات الصلة +- **التوثيق**: شغل `docsify serve` من جذر المشروع (المنفذ 3000) +- **تطبيق الاختبار**: شغل `npm run dev` في مجلد quiz-app +- **المشاريع**: استخدم امتداد VS Code Live Server لمشاريع HTML +- **مشاريع API**: شغل `npm start` في مجلدات API المعنية ## تعليمات الاختبار @@ -110,129 +110,129 @@ python api.py ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # التحقق من وجود مشاكل في نمط الكود +npm run build # التحقق من نجاح البناء ``` -### اختبار واجهة برمجة تطبيقات البنك +### اختبار API البنك ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # تحقق من مشكلات نمط الكود +node server.js # تحقق من بدء الخادم بدون أخطاء ``` -### نهج الاختبار العام +### منهجية الاختبار العامة -- هذا مستودع تعليمي بدون اختبارات آلية شاملة -- يركز الاختبار اليدوي على: - - تشغيل أمثلة الأكواد بدون أخطاء - - عمل الروابط في الوثائق بشكل صحيح +- هذا مستودع تعليمي بدون اختبارات مؤتمتة شاملة +- الاختبارات اليدوية تركز على: + - تشغيل أمثلة الشيفرة بدون أخطاء + - عمل الروابط في التوثيق بشكل صحيح - اكتمال بناء المشاريع بنجاح - اتباع الأمثلة لأفضل الممارسات -### الفحوصات قبل التقديم +### فحوصات ما قبل الإرسال -- قم بتشغيل `npm run lint` في الأدلة التي تحتوي على package.json -- تحقق من صحة روابط Markdown -- اختبر أمثلة الأكواد في المتصفح أو Node.js -- تأكد من أن الترجمات تحافظ على الهيكل الصحيح +- شغل `npm run lint` في المجلدات التي تحتوي package.json +- تحقق من صلاحية روابط Markdown +- اختبر أمثلة الشيفرة في المتصفح أو Node.js +- تأكد أن الترجمات تحافظ على البنية الصحيحة -## إرشادات نمط الأكواد +## إرشادات نمط الشيفرة -### JavaScript +### جافا سكريبت -- استخدم صيغة ES6+ الحديثة -- اتبع تكوينات ESLint القياسية المقدمة في المشاريع -- استخدم أسماء متغيرات ووظائف ذات معنى لتوضيح التعليم -- أضف تعليقات تشرح المفاهيم للمتعلمين -- قم بالتنسيق باستخدام Prettier حيث تم تكوينه +- استخدم بناء جملة ES6+ الحديثة +- اتبع إعدادات ESLint القياسية المقدمة في المشاريع +- استخدم أسماء متغيرات ودوال ذات معنى للتعليم +- أضف تعليقات توضح المفاهيم للمتعلمين +- نسق الشيفرة باستخدام Prettier حيثما كان مفعلاً -### HTML/CSS +### HTML / CSS -- عناصر HTML5 دلالية -- مبادئ التصميم المتجاوب -- اتفاقيات تسمية واضحة للفئات -- تعليقات تشرح تقنيات CSS للمتعلمين +- عناصر HTML5 الدلالية +- مبادئ التصميم المستجيب +- قواعد واضحة لتسمية الأصناف (الكلاسات) +- تعليقات تفصيلية لتقنيات CSS للمتعلمين -### Python +### بايثون - إرشادات نمط PEP 8 -- أمثلة أكواد واضحة وتعليمية -- تلميحات النوع حيث تكون مفيدة للتعلم +- أمثلة شيفرة واضحة وتعليمية +- تعليمات النوع حيث تفيد في التعلم -### وثائق Markdown +### توثيق 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 Static Web Apps) -تم تكوين quiz-app للنشر عبر Azure Static Web Apps: +تم تكوين تطبيق الاختبارات للنشر على Azure Static Web Apps: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # ينشئ مجلد dist/ +# ينشر عبر سير عمل GitHub Actions عند الدفع إلى الفرع الرئيسي ``` تكوين Azure Static Web Apps: - **موقع التطبيق**: `/quiz-app` -- **موقع الإخراج**: `dist` +- **موقع المخرجات**: `dist` - **سير العمل**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### إنشاء وثائق PDF +### إنشاء ملف PDF للتوثيق ```bash -npm install # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # تثبيت docsify-to-pdf +npm run convert # إنشاء ملف PDF من مستندات.docs ``` -### وثائق Docsify +### توثيق Docsify ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # تثبيت Docsify على مستوى النظام +docsify serve # الخادم على localhost:3000 ``` -### عمليات بناء المشاريع المحددة +### بناء خاص بالمشروع -قد يحتوي كل دليل مشروع على عملية بناء خاصة به: -- مشاريع Vue: `npm run build` لإنشاء حزم الإنتاج -- المشاريع الثابتة: لا توجد خطوة بناء، قم بخدمة الملفات مباشرة +قد يحتوي كل مجلد مشروع على عملية بناء خاصة به: +- مشاريع Vue: `npm run build` لإنشاء الحزم الإنتاجية +- مشاريع ثابتة: بدون خطوة بناء، قدّم الملفات مباشرة ## إرشادات طلب السحب -### تنسيق العنوان +### صيغة العنوان -استخدم عناوين واضحة وواصفة تشير إلى منطقة التغيير: +استخدم عناوين واضحة وواصفة توضح مجال التغيير: - `[Quiz-app] إضافة اختبار جديد للدرس X` -- `[Lesson-3] إصلاح خطأ في مشروع terrarium` -- `[Translation] إضافة ترجمة إسبانية للدرس 5` +- `[Lesson-3] إصلاح خطأ مطبعي في مشروع التيراريوم` +- `[Translation] إضافة الترجمة الإسبانية للدرس 5` - `[Docs] تحديث تعليمات الإعداد` ### الفحوصات المطلوبة قبل تقديم طلب السحب: -1. **جودة الأكواد**: - - قم بتشغيل `npm run lint` في أدلة المشاريع المتأثرة - - أصلح جميع أخطاء وتحذيرات التحقق +1. **جودة الشيفرة**: + - شغل `npm run lint` في مجلدات المشاريع المتأثرة + - أصلح كافة الأخطاء والتحذيرات 2. **التحقق من البناء**: - - قم بتشغيل `npm run build` إذا كان ذلك ممكنًا + - شغل `npm run build` إذا كان ذلك ممكنًا - تأكد من عدم وجود أخطاء في البناء 3. **التحقق من الروابط**: @@ -240,43 +240,43 @@ docsify serve # Serve on localhost:3000 - تحقق من عمل مراجع الصور 4. **مراجعة المحتوى**: - - قم بمراجعة الأخطاء الإملائية والنحوية - - تأكد من صحة أمثلة الأكواد وتعليمها + - تدقيق تهجئة ونحو + - تأكد من صحة الأمثلة التعليمية للكود - تحقق من أن الترجمات تحافظ على المعنى الأصلي ### متطلبات المساهمة -- الموافقة على Microsoft CLA (التحقق الآلي عند أول طلب سحب) -- اتباع [مدونة قواعد السلوك المفتوحة المصدر من Microsoft](https://opensource.microsoft.com/codeofconduct/) -- راجع [CONTRIBUTING.md](./CONTRIBUTING.md) للحصول على إرشادات مفصلة -- أشر إلى أرقام القضايا في وصف طلب السحب إذا كان ذلك ممكنًا +- الموافقة على اتفاقية ترخيص المساهمة من Microsoft (التحقق آليًا في أول طلب سحب) +- اتباع [مدونة السلوك لمصدر Microsoft المفتوح](https://opensource.microsoft.com/codeofconduct/) +- اطلع على [CONTRIBUTING.md](./CONTRIBUTING.md) للإرشادات المفصلة +- إرفاق أرقام القضايا في وصف طلب السحب إن وجدت ### عملية المراجعة -- يتم مراجعة طلبات السحب بواسطة المشرفين والمجتمع -- يتم إعطاء الأولوية للوضوح التعليمي -- يجب أن تتبع أمثلة الأكواد أفضل الممارسات الحالية -- يتم مراجعة الترجمات للتأكد من دقتها وملاءمتها الثقافية +- يتم مراجعة طلبات السحب من قبل القائمين على الصيانة والمجتمع +- تُعطى الأولوية لوضوح المحتوى التعليمي +- يجب أن تتبع أمثلة الشيفرة أفضل الممارسات الحالية +- تُراجع الترجمات للدقة والملاءمة الثقافية ## نظام الترجمة -### الترجمة التلقائية +### الترجمة المؤتمتة -- يستخدم 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 +**إخلاء مسؤولية**: +تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). وعلى الرغم من سعينا لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق. بالنسبة للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تأويل ناتج عن استخدام هذه الترجمة. + \ No newline at end of file diff --git a/translations/ar/README.md b/translations/ar/README.md index 8840e98e1..8b207284e 100644 --- a/translations/ar/README.md +++ b/translations/ar/README.md @@ -2,7 +2,7 @@ [![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) [![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) @@ -12,27 +12,27 @@ # تطوير الويب للمبتدئين - منهج دراسي -تعلّم أساسيات تطوير الويب من خلال دورتنا الشاملة التي تستمر 12 أسبوعًا من قبل دعاة السحابة في مايكروسوفت. تغوص كل من دروس الـ24 في جافاسكريبت وCSS وHTML عبر مشاريع عملية مثل التيراريوم، امتدادات المتصفح، وألعاب الفضاء. شارك مع الاختبارات، النقاشات، والواجبات العملية. حسّن مهاراتك وزد من احتفاظك بالمعرفة من خلال منهجنا التعليمي القائم على المشاريع الفعالة. ابدأ رحلتك في الترميز اليوم! +تعلم أساسيات تطوير الويب من خلال دورتنا الشاملة التي تستمر 12 أسبوعًا من قبل دعاة مايكروسوفت السحابيين. كل واحدة من الدروس الـ 24 تغوص في JavaScript و CSS و HTML عبر مشاريع عملية مثل التيراريوم، إضافات المتصفح، وألعاب الفضاء. شارك في الاختبارات والنقاشات والتكليفات العملية. حسّن مهاراتك وفعّل استيعابك للمعرفة باستخدام طريقتنا التعليمية القائمة على المشاريع. ابدأ رحلة الترميز الخاصة بك اليوم! -انضم إلى مجتمع Azure AI Foundry على ديسكورد +انضم إلى مجتمع Azure AI Foundry على Discord [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) اتبع هذه الخطوات للبدء باستخدام هذه الموارد: -1. **انشئ نسخة من الريبو (Fork)**: انقر على [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) -2. **انسخ الريبو محليًا (Clone)**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**انضم إلى Azure AI Foundry على ديسكورد والتق بخبراء ومطورين زملاء**](https://discord.com/invite/ByRwuEEgH4) +1. **افعل فورك للمستودع**: اضغط [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) +2. **انسخ المستودع**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**انضم إلى Azure AI Foundry على Discord والتقِ بالخبراء والمطورين الآخرين**](https://discord.com/invite/ByRwuEEgH4) ### 🌐 دعم متعدد اللغات -#### مدعوم عن طريق GitHub Action (آلي ودائمًا محدث) +#### مدعوم عبر GitHub Action (مؤتمت ومُحدث دائمًا) -[العربية](./README.md) | [البنغالية](../bn/README.md) | [البلغارية](../bg/README.md) | [البورمية (ميانمار)](../my/README.md) | [الصينية (المبسطة)](../zh-CN/README.md) | [الصينية (التقليدية، هونغ كونغ)](../zh-HK/README.md) | [الصينية (التقليدية، ماكاو)](../zh-MO/README.md) | [الصينية (التقليدية، تايوان)](../zh-TW/README.md) | [الكرواتية](../hr/README.md) | [التشيكية](../cs/README.md) | [الدانماركية](../da/README.md) | [الهولندية](../nl/README.md) | [الإستونية](../et/README.md) | [الفنلندية](../fi/README.md) | [الفرنسية](../fr/README.md) | [الألمانية](../de/README.md) | [اليونانية](../el/README.md) | [العبرية](../he/README.md) | [الهندية](../hi/README.md) | [الهنغارية](../hu/README.md) | [الإندونيسية](../id/README.md) | [الإيطالية](../it/README.md) | [اليابانية](../ja/README.md) | [الكانادا](../kn/README.md) | [الكورية](../ko/README.md) | [الليتوانية](../lt/README.md) | [الماليزية](../ms/README.md) | [المالايالامية](../ml/README.md) | [الماراثية](../mr/README.md) | [النيبالية](../ne/README.md) | [نيجيري بيدجن](../pcm/README.md) | [النرويجية](../no/README.md) | [الفارسية (اللغة)](../fa/README.md) | [البولندية](../pl/README.md) | [البرتغالية (البرازيل)](../pt-BR/README.md) | [البرتغالية (البرتغال)](../pt-PT/README.md) | [اللبنغالية (غورموخي)](../pa/README.md) | [الرومانية](../ro/README.md) | [الروسية](../ru/README.md) | [الصربية (السيريلية)](../sr/README.md) | [السلوفاكية](../sk/README.md) | [السلوفينية](../sl/README.md) | [الإسبانية](../es/README.md) | [السواحيلية](../sw/README.md) | [السويدية](../sv/README.md) | [التاغالوغ (الفلبينية)](../tl/README.md) | [التاميلية](../ta/README.md) | [التلغو](../te/README.md) | [التايلاندية](../th/README.md) | [التركية](../tr/README.md) | [الأوكرانية](../uk/README.md) | [الأردية](../ur/README.md) | [الفيتنامية](../vi/README.md) +[Arabic](./README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **تفضل النسخ محليًا؟** +> **تفضل الاستنساخ محليًا؟** -> يحتوي هذا الريبو على أكثر من 50 ترجمة لغة مما يزيد بشكل كبير من حجم التنزيل. للنسخ بدون الترجمات، استخدم sparse checkout: +> يحتوي هذا المستودع على أكثر من 50 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. لاستنساخ بدون الترجمات، استخدم sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners @@ -41,197 +41,197 @@ > هذا يمنحك كل ما تحتاجه لإكمال الدورة مع تنزيل أسرع بكثير. -**إذا كنت ترغب في دعم لغات ترجمة إضافية، فهي مدرجة [هنا](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** +**إذا كنت ترغب في دعم لغات ترجمة إضافية فهي مدرجة [هنا](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** -[![افتح في Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) +[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) #### 🧑‍🎓 _هل أنت طالب؟_ -زر صفحة [**مركز الطلاب**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) حيث ستجد موارد للمبتدئين، حزم طلاب، وحتى طرق للحصول على قسيمة شهادة مجانية. هذه هي الصفحة التي تريد وضع إشارة مرجعية عليها والتفقّد من وقت لآخر حيث نقوم بتحديث المحتوى شهريًا. +زر [**صفحة مركز الطلاب**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) حيث ستجد الموارد للمبتدئين، حزم الطلاب وحتى طرق للحصول على قسيمة شهادة مجانية. هذه هي الصفحة التي تود حفظها ضمن المفضلة والعودة إليها من حين لآخر مع تغير المحتوى شهريًا. -### 📣 إعلان - تحديات جديدة لوضع GitHub Copilot Agent لإكمالها! +### 📣 إعلان - تحديات وضع GitHub Copilot Agent الجديدة لإكمالها! -تمت إضافة تحدي جديد، ابحث عن "تحدي GitHub Copilot Agent 🚀" في معظم الفصول. هذا تحدي جديد لإكماله باستخدام GitHub Copilot ووضع Agent. إذا لم تستخدم وضع Agent من قبل، فهو قادر ليس فقط على توليد النصوص ولكن أيضًا على إنشاء وتعديل الملفات، تشغيل الأوامر والمزيد. +تم إضافة تحدي جديد، ابحث عن "GitHub Copilot Agent Challenge 🚀" في معظم الفصول. هذا تحدي جديد لك لإكماله باستخدام GitHub Copilot ووضع Agent. إذا لم تستخدم وضع Agent من قبل فهو قادر ليس فقط على توليد النص بل يمكنه أيضًا إنشاء وتحرير الملفات، تشغيل الأوامر والمزيد. ### 📣 إعلان - _مشروع جديد للبناء باستخدام الذكاء الاصطناعي التوليدي_ -تمت إضافة مشروع جديد لمساعد الذكاء الاصطناعي، اطلع عليه [المشروع](./9-chat-project/README.md) +تم إضافة مشروع مساعد الذكاء الاصطناعي الجديد، تفقده [المشروع](./9-chat-project/README.md) -### 📣 إعلان - _منهج جديد_ حول الذكاء الاصطناعي التوليدي لجافاسكريبت تم إصداره للتو +### 📣 إعلان - _منهج جديد_ حول الذكاء الاصطناعي التوليدي لـ JavaScript تم إصداره للتو -لا تفوت منهجنا الجديد في الذكاء الاصطناعي التوليدي! +لا تفوت منهج الذكاء الاصطناعي التوليدي الجديد! -زر [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) للبدء! +زر [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) لتبدأ! ![Background](../../translated_images/ar/background.148a8d43afde5730.webp) - دروس تغطي كل شيء من الأساسيات إلى RAG. -- تفاعل مع شخصيات تاريخية باستخدام GenAI وتطبيق الرفيق الخاص بنا. -- سرد قصصي ممتع وجذاب، ستسافر عبر الزمن! +- تفاعل مع شخصيات تاريخية باستخدام GenAI وتطبيقنا المصاحب. +- سرد ممتع وجذاب، ستسافر عبر الزمن! ![character](../../translated_images/ar/character.5c0dd8e067ffd693.webp) -تحتوي كل درس على مهمة لإكمالها، اختبار معرفة وتحدي لتوجيهك في تعلم موضوعات مثل: -- التوجيه وتصميم التوجيه -- تطوير تطبيقات النصوص والصور +كل درس يتضمن مهمة لإكمالها، اختبار معرفة وتحدي لتوجيهك في تعلم موضوعات مثل: +- التهيئة والهندسة للتهيئة +- توليد تطبيقات نصوص وصور - تطبيقات البحث -زر [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course) للبدء! +زر [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) لتبدأ! ## 🌱 البدء -> **أيّها المعلمون**، لقد قمنا [بإدراج بعض الاقتراحات](for-teachers.md) حول كيفية استخدام هذا المنهج الدراسي. نود أن نحصل على ملاحظاتكم [في منتدى النقاش الخاص بنا](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! +> **يا مدرسين**، لقد [أضفنا بعض الاقتراحات](for-teachers.md) حول كيفية استخدام هذا المنهج. نود ملاحظاتكم [في منتدى النقاش الخاص بنا](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! -**[المتعلمون](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**، لكل درس، ابدأ باختبار ما قبل المحاضرة واتبع قراءة مادة المحاضرة، وأكمل الأنشطة المختلفة وتحقق من فهمك باستخدام اختبار ما بعد المحاضرة. +**[الطلاب](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**، لكل درس ابدأ باختبار تمهيدي ثم تابع بقراءة مواد المحاضرة، إكمال الأنشطة المختلفة وفحص فهمك مع اختبار ما بعد المحاضرة. -لتحسين تجربتك التعليمية، تواصل مع زملائك للعمل على المشاريع معًا! يتم التشجيع على النقاشات في [منتدى النقاش الخاص بنا](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) حيث يتوفر فريق المشرفين للإجابة على أسئلتك. +لتعزيز تجربتك التعليمية، تواصل مع زملائك للعمل على المشاريع معًا! التشجيع على النقاشات موجود في [منتدى النقاش](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) حيث سيكون فريق المشرفين متاحًا للرد على أسئلتك. لتعميق تعليمك، نوصي بشدة باستكشاف [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) لمواد دراسية إضافية. -### 📋 إعداد بيئتك +### 📋 إعداد بيئتك التطويرية -يحتوي هذا المنهج الدراسي على بيئة تطوير جاهزة للعمل! عندما تبدأ، يمكنك اختيار تشغيل المنهج الدراسي في [Codespace](https://github.com/features/codespaces/) (_بيئة قائمة على المتصفح، لا يحتاج تثبيت_)، أو محليًا على جهاز الكمبيوتر باستخدام محرر نصوص مثل [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +هذا المنهج يحتوي على بيئة تطوير جاهزة! أثناء بدءك يمكنك اختيار تشغيل المنهج في [Codespace](https://github.com/features/codespaces/) (_بيئة مستعرضية لا تحتاج تثبيت برمجيات_)، أو محليًا على جهازك باستخدام محرر نصوص مثل [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -#### أنشئ مستودعك الخاص -لكي تتمكن من حفظ عملك بسهولة، يُنصح بإنشاء نسخة خاصة بك من هذا المستودع. يمكنك فعل ذلك بالنقر على زر **Use this template** في أعلى الصفحة. سيؤدي ذلك إلى إنشاء مستودع جديد في حساب GitHub الخاص بك مع نسخة من المنهج الدراسي. +#### إنشاء المستودع الخاص بك +للسهولة في حفظ عملك، يُنصح بإنشاء نسخة خاصة بك من هذا المستودع. يمكنك فعل ذلك بالنقر على زر **Use this template** في أعلى الصفحة. سيؤدي ذلك إلى إنشاء مستودع جديد في حساب GitHub الخاص بك مع نسخة من المنهج. اتبع هذه الخطوات: -1. **انشئ نسخة من المستودع (Fork)**: انقر على زر "Fork" في أعلى يمين هذه الصفحة. -2. **انسخ المستودع محليًا (Clone)**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +1. **افعل فورك للمستودع**: انقر على زر "Fork" في الزاوية العلوية اليمنى من هذه الصفحة. +2. **انسخ المستودع**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### تشغيل المنهج الدراسي في Codespace +#### تشغيل المنهج في Codespace -في نسخة المستودع الخاصة بك التي أنشأتها، انقر على زر **Code** واختر **Open with Codespaces**. سيؤدي ذلك إلى إنشاء Codespace جديد للعمل فيه. +ضمن نسختك من هذا المستودع التي أنشأتها، انقر على زر **Code** واختر **Open with Codespaces**. سينشئ هذا Codespace جديد لتعمل فيه. ![Codespace](../../translated_images/ar/createcodespace.0238bbf4d7a8d955.webp) -#### تشغيل المنهج الدراسي محليًا على جهاز الكمبيوتر +#### تشغيل المنهج محليًا على جهازك -لتشغيل هذا المنهج محليًا على جهاز الكمبيوتر الخاص بك، ستحتاج إلى محرر نصوص، متصفح وأداة سطر أوامر. ستكون الدرس الأول، [مقدمة في لغات البرمجة وأدوات التجارة](../../1-getting-started-lessons/1-intro-to-programming-languages)، دليلك عبر خيارات مختلفة لكل من هذه الأدوات لتختار الأنسب لك. +لتشغيل هذا المنهج محليًا على جهازك، ستحتاج إلى محرر نصوص، متصفح وأداة سطر أوامر. دروسنا الأولى، [مقدمة للغات البرمجة وأدوات المجال](../../1-getting-started-lessons/1-intro-to-programming-languages)، ستأخذك عبر خيارات مختلفة لكل من هذه الأدوات لتختار الأفضل لك. -توصيتنا هي استخدام [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) كمحرر لديك، والذي يتضمن أيضًا [طرفية مدمجة](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon). يمكنك تنزيل Visual Studio Code [من هنا](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +توصيتنا هو استخدام [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) كمحرر نصوص، والذي يحتوي أيضًا على [طرفية (Terminal)](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) مدمجة. يمكنك تنزيل Visual Studio Code [من هنا](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -1. انسخ المستودع الخاص بك إلى جهاز الكمبيوتر الخاص بك. يمكنك فعل ذلك بالنقر على زر **Code** ونسخ عنوان URL: +1. انسخ المستودع إلى جهازك. يمكنك فعل ذلك بالنقر على زر **Code** ونسخ الرابط: [CodeSpace](./images/createcodespace.png) -ثم، افتح [الطرفية](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) داخل [فيجوال ستوديو كود](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) وشغّل الأمر التالي، مع استبدال `` بالرابط الذي نسخته للتو: +ثم، افتح [الطرفية](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) داخل [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) وقم بتشغيل الأمر التالي، مع استبدال `` بالرابط الذي نسخته للتو: ```bash git clone ``` -2. افتح المجلد في فيجوال ستوديو كود. يمكنك فعل ذلك بالنقر على **File** > **Open Folder** واختيار المجلد الذي قمت باستنساخه. +2. افتح المجلد في Visual Studio Code. يمكنك القيام بذلك بالنقر على **ملف** > **فتح مجلد** واختيار المجلد الذي قمت باستنساخه. -> ملحقات فيجوال ستوديو كود الموصى بها: +> الإضافات الموصى بها لـ Visual Studio Code: > -> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - لمعاينة صفحات HTML داخل فيجوال ستوديو كود -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - لمساعدتك على كتابة الكود بشكل أسرع +> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - لمعاينة صفحات HTML داخل Visual Studio Code +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - لمساعدتك في كتابة الكود بسرعة أكبر -## 📂 كل درس يشمل: +## 📂 تشمل كل درس: -- ملاحظات توضيحية اختيارية -- فيديو تفاعلي اختياري -- اختبار تمهيدي قبل الدرس +- ملاحظة رسمية اختيارية +- فيديو تكميلي اختياري +- اختبار دافئ قبل الدرس - درس مكتوب -- لدروس المشاريع، إرشادات خطوة بخطوة لكيفية بناء المشروع -- اختبارات للتحقق من المعرفة +- للدروس القائمة على المشاريع، أدلة خطوة بخطوة حول كيفية بناء المشروع +- فحوصات معرفية - تحدي -- قراءة إضافية +- قراءة تكميلية - واجب -- [اختبار بعد الدرس](https://ff-quizzes.netlify.app/web/) +- [اختبار ما بعد الدرس](https://ff-quizzes.netlify.app/web/) -> **ملاحظة حول الاختبارات**: جميع الاختبارات موجودة في مجلد Quiz-app، يوجد 48 اختبارًا بمجموع ثلاث أسئلة لكل اختبار. متوفرة [هنا](https://ff-quizzes.netlify.app/web/) يمكن تشغيل تطبيق الاختبار محليًا أو نشره على Azure؛ اتبع التعليمات في مجلد `quiz-app`. +> **ملاحظة حول الاختبارات:** جميع الاختبارات موجودة في مجلد Quiz-app، 48 اختبارًا إجماليًا يحتوي كل منها على ثلاثة أسئلة. وهي متاحة [هنا](https://ff-quizzes.netlify.app/web/) يمكن تشغيل تطبيق الاختبار محليًا أو نشره على Azure؛ اتبع التعليمات في مجلد `quiz-app`. ## 🗃️ الدروس -| | اسم المشروع | المفاهيم التي يُدرّسها | أهداف التعلم | الدرس المرتبط | المؤلف | -| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | -| 01 | البدء | مقدمة في البرمجة وأدوات العمل | تعلّم أساسيات معظم لغات البرمجة والبرمجيات التي تساعد المطورين المحترفين في أداء عملهم | [مقدمة في لغات البرمجة وأدوات العمل](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | -| 02 | البدء | أساسيات GitHub، يتضمن العمل الجماعي | كيفية استخدام GitHub في مشروعك، وكيفية التعاون مع الآخرين على قاعدة كود | [مقدمة في GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | -| 03 | البدء | إمكانية الوصول | تعلّم أساسيات إمكانية الوصول على الويب | [أساسيات إمكانية الوصول](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | -| 04 | أساسيات JS | أنواع بيانات جافاسكريبت | أساسيات أنواع البيانات في جافاسكريبت | [أنواع البيانات](./2-js-basics/1-data-types/README.md) | Jasmine | -| 05 | أساسيات JS | الدوال والأساليب | تعلّم حول الدوال والأساليب لإدارة تدفق منطق التطبيق | [الدوال والأساليب](./2-js-basics/2-functions-methods/README.md) | Jasmine و Christopher | -| 06 | أساسيات JS | اتخاذ القرارات باستخدام جافاسكريبت | تعلّم كيفية إنشاء شروط في الكود باستخدام طرق اتخاذ القرار | [اتخاذ القرارات](./2-js-basics/3-making-decisions/README.md) | Jasmine | -| 07 | أساسيات JS | المصفوفات والحلقات | العمل مع البيانات باستخدام المصفوفات والحلقات في جافاسكريبت | [المصفوفات والحلقات](./2-js-basics/4-arrays-loops/README.md) | Jasmine | -| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML في التطبيق | بناء HTML لإنشاء ترباريوم إلكتروني مع التركيز على بناء التخطيط | [مقدمة في HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | -| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS في التطبيق | بناء CSS لتصميم الترباريوم الإلكتروني مع التركيز على أساسيات CSS بما في ذلك جعل الصفحة متجاوبة | [مقدمة في CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | -| 10 | [Terrarium](./3-terrarium/solution/README.md) | إغلاق جافاسكريبت، التلاعب بـ DOM | بناء جافاسكريبت لجعل الترباريوم يعمل كواجهة سحب وإفلات، مع التركيز على الإغلاق والتلاعب بـ DOM | [إغلاق جافاسكريبت والتلاعب بـ DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | -| 11 | [لعبة الطباعة](./4-typing-game/solution/README.md) | بناء لعبة طباعة | تعلّم كيفية استخدام أحداث لوحة المفاتيح لتشغيل منطق تطبيق جافاسكريبت | [البرمجة الحدثية](./4-typing-game/typing-game/README.md) | Christopher | -| 12 | [إضافة المتصفح الخضراء](./5-browser-extension/solution/README.md) | العمل مع المتصفحات | تعلّم كيف تعمل المتصفحات، تاريخها، وكيفية إعداد أول عناصر إضافة لمتصفح | [حول المتصفحات](./5-browser-extension/1-about-browsers/README.md) | Jen | -| 13 | [إضافة المتصفح الخضراء](./5-browser-extension/solution/README.md) | بناء نموذج، الاستدعاء API وتخزين المتغيرات في التخزين المحلي | بناء عناصر جافاسكريبت لإضافة المتصفح لاستدعاء API باستخدام المتغيرات المخزنة محليًا | [APIs، النماذج والتخزين المحلي](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | -| 14 | [إضافة المتصفح الخضراء](./5-browser-extension/solution/README.md) | العمليات الخلفية في المتصفح، أداء الويب | استخدام العمليات الخلفية للمتصفح لإدارة أيقونة الإضافة؛ تعلم حول أداء الويب وبعض التحسينات لرفع الكفاءة | [المهام الخلفية والأداء](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | -| 15 | [لعبة الفضاء](./6-space-game/solution/README.md) | تطوير ألعاب متقدم مع جافاسكريبت | تعلّم حول الوراثة باستخدام الكلاسات والتكوين ونمط النشر/الاشتراك، تمهيدًا لبناء لعبة | [مقدمة في تطوير الألعاب المتقدم](./6-space-game/1-introduction/README.md) | Chris | -| 16 | [لعبة الفضاء](./6-space-game/solution/README.md) | الرسم على اللوحة | تعلّم حول API اللوحة (Canvas API)، المستخدم للرسم على الشاشة | [الرسم على اللوحة](./6-space-game/2-drawing-to-canvas/README.md) | Chris | -| 17 | [لعبة الفضاء](./6-space-game/solution/README.md) | تحريك العناصر حول الشاشة | اكتشف كيف يمكنك تحريك العناصر باستخدام الإحداثيات الديكارتية وواجهة برمجة تطبيقات اللوحة | [تحريك العناصر](./6-space-game/3-moving-elements-around/README.md) | Chris | -| 18 | [لعبة الفضاء](./6-space-game/solution/README.md) | كشف التصادم | جعل العناصر تتصادم وتتفاعل مع بعضها باستخدام ضغطات المفاتيح وتوفير دالة تبريد لضمان أداء اللعبة | [كشف التصادم](./6-space-game/4-collision-detection/README.md) | Chris | -| 19 | [لعبة الفضاء](./6-space-game/solution/README.md) | حفظ النقاط | إجراء حسابات رياضية بناءً على حالة اللعبة وأدائها | [حفظ النقاط](./6-space-game/5-keeping-score/README.md) | Chris | -| 20 | [لعبة الفضاء](./6-space-game/solution/README.md) | إنهاء وإعادة بدء اللعبة | تعلّم حول إنهاء وإعادة تشغيل اللعبة، بما في ذلك تنظيف الموارد وإعادة تعيين المتغيرات | [شرط النهاية](./6-space-game/6-end-condition/README.md) | Chris | -| 21 | [تطبيق البنك](./7-bank-project/solution/README.md) | قوالب HTML والمسارات في تطبيق ويب | تعلّم كيفية إنشاء الهيكل الأساسي لموقع ويب متعدد الصفحات باستخدام التوجيه والقوالب في HTML | [قوالب HTML والمسارات](./7-bank-project/1-template-route/README.md) | Yohan | -| 22 | [تطبيق البنك](./7-bank-project/solution/README.md) | بناء نموذج تسجيل دخول وتسجيل | تعلّم حول بناء النماذج والتعامل مع إجراءات التحقق من صحة البيانات | [النماذج](./7-bank-project/2-forms/README.md) | Yohan | -| 23 | [تطبيق البنك](./7-bank-project/solution/README.md) | طرق جلب واستخدام البيانات | كيف تتدفق البيانات داخل وخارج التطبيق، كيفية جلبها وتخزينها والتخلص منها | [البيانات](./7-bank-project/3-data/README.md) | Yohan | -| 24 | [تطبيق البنك](./7-bank-project/solution/README.md) | مفاهيم إدارة الحالة | تعلّم كيف يحتفظ تطبيقك بالحالة وكيفية إدارتها برمجيًا | [إدارة الحالة](./7-bank-project/4-state-management/README.md) | Yohan | -| 25 | [كود المتصفح/في سكود](../../8-code-editor) | العمل مع في سكود | تعلم كيفية استخدام محرر الكود | [استخدام محرر كود في سكود](./8-code-editor/1-using-a-code-editor/README.md) | Chris | -| 26 | [مساعدات الذكاء الاصطناعي](./9-chat-project/README.md) | العمل مع الذكاء الاصطناعي | تعلم كيفية بناء مساعد ذكي خاص بك | [مشروع مساعد الذكاء الاصطناعي](./9-chat-project/README.md) | Chris | - -## 🏫 البيداغوجيا - -تم تصميم منهجنا التعليمي مع مبدئين بيداغوجيين رئيسيين في الاعتبار: +| | اسم المشروع | المفاهيم المطروحة | أهداف التعلم | الدرس المرتبط | المؤلف | +| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | +| 01 | البداية | مقدمة في البرمجة وأدوات العمل | تعلم الأساسيات التي تقوم عليها معظم لغات البرمجة وعن البرامج التي تساعد المطورين المحترفين على أداء مهامهم | [مقدمة في لغات البرمجة وأدوات العمل](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | البداية | أساسيات GitHub، بما في ذلك العمل مع فريق | كيفية استخدام GitHub في مشروعك، وكيفية التعاون مع الآخرين على قاعدة الشيفرة | [مقدمة إلى GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | البداية | إمكانية الوصول | تعلم أساسيات إمكانية الوصول على الويب | [أساسيات إمكانية الوصول](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | أساسيات JavaScript | أنواع بيانات JavaScript | أساسيات أنواع بيانات JavaScript | [أنواع البيانات](./2-js-basics/1-data-types/README.md) | Jasmine | +| 05 | أساسيات JavaScript | الدوال والطرق | تعلم عن الدوال والطرق لإدارة منطق التطبيق | [الدوال والطرق](./2-js-basics/2-functions-methods/README.md) | Jasmine و Christopher | +| 06 | أساسيات JavaScript | اتخاذ القرارات باستخدام JS | تعلم كيفية إنشاء شروط في الكود باستخدام طرق اتخاذ القرارات | [اتخاذ القرارات](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | أساسيات JavaScript | المصفوفات والحلقات | العمل مع البيانات باستخدام المصفوفات والحلقات في JavaScript | [المصفوفات والحلقات](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Terrarium](./3-terrarium/solution/README.md) | HTML في التطبيق | بناء الـ HTML لإنشاء تيراريوم عبر الإنترنت، مع التركيز على بناء التخطيط | [مقدمة إلى HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Terrarium](./3-terrarium/solution/README.md) | CSS في التطبيق | بناء CSS لتصميم التيراريوم عبر الإنترنت، مع التركيز على أساسيات CSS بما في ذلك جعل الصفحة متجاوبة | [مقدمة إلى CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Terrarium](./3-terrarium/solution/README.md) | إغلاق JavaScript، التلاعب بـ DOM | بناء JavaScript لجعل التيراريوم يعمل كواجهة سحب وإفلات، مع التركيز على الإغلاق والتلاعب بـ DOM | [إغلاق JavaScript، التلاعب بـ DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [لعبة الطباعة](./4-typing-game/solution/README.md) | بناء لعبة الطباعة | تعلم كيفية استخدام أحداث لوحة المفاتيح لتحريك منطق تطبيق JavaScript | [البرمجة المعتمدة على الأحداث](./4-typing-game/typing-game/README.md) | Christopher | +| 12 | [امتداد المتصفح الأخضر](./5-browser-extension/solution/README.md) | العمل مع المتصفحات | تعلم كيفية عمل المتصفحات، تاريخها، وكيفية إنشاء أول عناصر لامتداد المتصفح | [حول المتصفحات](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [امتداد المتصفح الأخضر](./5-browser-extension/solution/README.md) | بناء نموذج، استدعاء API وتخزين المتغيرات في التخزين المحلي | بناء عناصر JavaScript لامتداد المتصفح لاستدعاء API باستخدام متغيرات مخزنة في التخزين المحلي | [واجهات برمجة التطبيقات، النماذج، والتخزين المحلي](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| 14 | [امتداد المتصفح الأخضر](./5-browser-extension/solution/README.md) | عمليات الخلفية في المتصفح، أداء الويب | استخدام عمليات الخلفية في المتصفح لإدارة أيقونة الامتداد؛ تعلم عن أداء الويب وبعض التحسينات لتحقيق الأداء الأفضل | [مهام الخلفية والأداء](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [لعبة الفضاء](./6-space-game/solution/README.md) | تطوير ألعاب متقدم باستخدام JavaScript | تعلم عن الوراثة باستخدام كل من الفئات والتكوين ونمط النشر/الاشتراك، تحضيرًا لبناء لعبة | [مقدمة لتطوير الألعاب المتقدمة](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [لعبة الفضاء](./6-space-game/solution/README.md) | الرسم على اللوحة | تعلم عن واجهة برمجة تطبيقات Canvas، المستخدمة لرسم العناصر على الشاشة | [الرسم على اللوحة](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [لعبة الفضاء](./6-space-game/solution/README.md) | تحريك العناصر على الشاشة | اكتشف كيف يمكن للعناصر أن تتحرك باستخدام الإحداثيات الكارتيزية وواجهة برمجة تطبيقات Canvas | [تحريك العناصر](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [لعبة الفضاء](./6-space-game/solution/README.md) | كشف التصادم | جعل العناصر تصطدم وتتفاعل مع بعضها باستخدام ضغطات المفاتيح وتوفير دالة تبريد لضمان أداء اللعبة | [كشف التصادم](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [لعبة الفضاء](./6-space-game/solution/README.md) | تتبع النقاط | إجراء حسابات رياضية بناءً على حالة وأداء اللعبة | [تتبع النقاط](./6-space-game/5-keeping-score/README.md) | Chris | +| 20 | [لعبة الفضاء](./6-space-game/solution/README.md) | إنهاء وإعادة تشغيل اللعبة | تعلم عن إنهاء وإعادة تشغيل اللعبة، بما في ذلك تنظيف الموارد وإعادة تعيين قيم المتغيرات | [شروط الانتهاء](./6-space-game/6-end-condition/README.md) | Chris | +| 21 | [تطبيق المصرف](./7-bank-project/solution/README.md) | قوالب HTML والمسارات في تطبيق ويب | تعلم كيفية إنشاء هيكل موقع متعدد الصفحات باستخدام التوجيه وقوالب HTML | [قوالب HTML والمسارات](./7-bank-project/1-template-route/README.md) | Yohan | +| 22 | [تطبيق المصرف](./7-bank-project/solution/README.md) | بناء نموذج للدخول والتسجيل | تعلم كيفية بناء النماذج والتعامل مع روتين التحقق | [النماذج](./7-bank-project/2-forms/README.md) | Yohan | +| 23 | [تطبيق المصرف](./7-bank-project/solution/README.md) | طرق جلب واستخدام البيانات | كيف تتدفق البيانات في تطبيقك وخارجه، كيفية جلبها وتخزينها والتخلص منها | [البيانات](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [تطبيق المصرف](./7-bank-project/solution/README.md) | مفاهيم إدارة الحالة | تعلم كيفية احتفاظ تطبيقك بالحالة وكيفية إدارتها برمجيًا | [إدارة الحالة](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [كود المتصفح/VSCode](../../8-code-editor) | العمل مع VScode | تعلم كيفية استخدام محرر الكود | [استخدام محرر VSCode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| 26 | [المساعدون الذكيون](./9-chat-project/README.md) | العمل مع الذكاء الاصطناعي | تعلم كيفية بناء مساعدك الذكي الخاص | [مشروع المساعد الذكي](./9-chat-project/README.md) | Chris | + +## 🏫 المنهجية التعليمية + +تم تصميم منهجنا مع مبادئ تعليمية رئيسية: * التعلم القائم على المشاريع * الاختبارات المتكررة -البرنامج يُعلّم أساسيات جافاسكريبت، HTML، وCSS، بالإضافة إلى أحدث الأدوات والتقنيات المستخدمة من قبل مطوري الويب في الوقت الحالي. سيحصل الطلاب على فرصة لاكتساب خبرة عملية من خلال بناء لعبة الطباعة، ترباريوم افتراضي، إضافة متصفح صديقة للبيئة، لعبة على نمط غزو الفضاء، وتطبيق بنكي للأعمال. بنهاية السلسلة، سيكون لدى الطلاب فهم قوي لتطوير الويب. +البرنامج يعلم أساسيات JavaScript و HTML و CSS، بالإضافة إلى أحدث الأدوات والتقنيات التي يستخدمها مطورو الويب اليوم. سيتمكن الطلاب من اكتساب خبرة عملية من خلال بناء لعبة طباعة، تيراريوم افتراضي، امتداد متصفح صديق للبيئة، لعبة بأسلوب غزاة الفضاء، وتطبيق مصرفي للأعمال. بحلول نهاية السلسلة، سيكون لدى الطلاب فهم قوي لتطوير الويب. -> 🎓 يمكنك أخذ الدروس الأولى في هذا المنهج كـ [مسار تعلم](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) على Microsoft Learn! +> 🎓 يمكنك أخذ الدروس الأولى في هذا المنهج كـ [مسار تعلّم](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) على Microsoft Learn! -بضمان توافق المحتوى مع المشاريع، أصبح التعلم أكثر تشويقًا للطلاب وسيتم تعزيز ترسيخ المفاهيم. كتبنا أيضًا العديد من الدروس التمهيدية في أساسيات جافاسكريبت لتعريف المفاهيم، بالإضافة إلى فيديو من مجموعة فيديوهات "[سلسلة المبتدئين إلى: جافاسكريبت](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)"، بعض مؤلفيها ساهموا في هذا المنهج. +من خلال ضمان تطابق المحتوى مع المشاريع، يصبح التعلم أكثر متعة للطلاب ويزداد تثبيت المفاهيم. كما كتبنا عدة دروس تمهيدية في أساسيات JavaScript لتقديم المفاهيم، مع فيديو من مجموعة "[سلسلة المبتدئين إلى: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" لتعليم الفيديو، بعض مؤلفيها ساهموا في هذا المنهج. -بالإضافة لذلك، اختبار منخفض الضغط قبل الدرس يُحدد نية الطالب في تعلم الموضوع، في حين يضمن اختبار ثانٍ بعد الدرس المزيد من الترسيخ. صُمّم هذا المنهج ليكون مرنًا وممتعًا ويمكن أخذه ككل أو أجزاء. تبدأ المشاريع صغيرة وتزداد تعقيدًا بحلول نهاية دورة 12 أسبوعًا. +بالإضافة إلى ذلك، اختبار منخفض المخاطر قبل الدرس يهيئ نية الطالب لتعلم موضوع معين، في حين يضمن اختبار ثاني بعد الدرس مزيدًا من التثبيت. تم تصميم هذا المنهج ليكون مرنًا وممتعًا ويمكن أخذه كاملاً أو جزئيًا. تبدأ المشاريع صغيرة وتزداد تعقيدًا بنهاية دورة الـ 12 أسبوعًا. -بينما تجنبنا عمدًا تقديم أُطر عمل جافاسكريبت للتركيز على المهارات الأساسية المطلوبة كمطور ويب قبل تبني إطار عمل، فإن الخطوة التالية الجيدة لإكمال هذا المنهج ستكون تعلم Node.js عبر مجموعة أخرى من الفيديوهات: "[سلسلة المبتدئين إلى: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +على الرغم من أننا تجنبنا عمدًا تقديم أُطُر JavaScript للتركيز على المهارات الأساسية اللازمة كمطور ويب قبل تبني أُطر، فإن الخطوة التالية الجيدة لإكمال هذا المنهج هي تعلم Node.js عبر مجموعة أخرى من الفيديوهات: "[سلسلة المبتدئين إلى: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> قم بزيارة [مدونة قواعد السلوك](CODE_OF_CONDUCT.md) و[المساهمة](CONTRIBUTING.md). نرحب بتعليقاتك البناءة! +> قم بزيارة [مدونة السلوك](CODE_OF_CONDUCT.md) و[إرشادات المساهمة](CONTRIBUTING.md). نرحب بملاحظاتك البناءة! -## 🧭 الوصول دون اتصال +## 🧭 الوصول بدون اتصال -يمكنك تشغيل هذه الوثائق دون اتصال باستخدام [Docsify](https://docsify.js.org/#/). انسخ هذا المستودع، [ثبت Docsify](https://docsify.js.org/#/quickstart) على جهازك المحلي، ثم في المجلد الجذر لهذا المستودع، اكتب `docsify serve`. سيتم تقديم الموقع على المنفذ 3000 على جهازك المحلي: `localhost:3000`. +يمكنك تشغيل هذه الوثائق بدون اتصال باستخدام [Docsify](https://docsify.js.org/#/). قم بتفريع هذا المستودع، [تثبيت Docsify](https://docsify.js.org/#/quickstart) على جهازك المحلي، ثم في المجلد الجذر لهذا المستودع، اكتب `docsify serve`. سيتم تقديم الموقع على المنفذ 3000 على الوجهة المحلية الخاصة بك: `localhost:3000`. -## 📘 ملف PDF +## 📘 PDF -يمكن العثور على ملف PDF لكل الدروس [هنا](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). +يمكن العثور على ملف PDF لجميع الدروس [هنا](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). ## 🎒 دورات أخرى -فريقنا يُنتج دورات أخرى! اطلع على: +فريقنا ينتج دورات أخرى! تحقق من: -### لانغتشين +### LangChain [![LangChain4j للمبتدئين](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js للمبتدئين](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain للمبتدئين](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### أزور / إيدج / MCP / الوكلاء +### Azure / Edge / MCP / Agents [![AZD للمبتدئين](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) [![Edge AI للمبتدئين](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) [![MCP للمبتدئين](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI Agents للمبتدئين](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +[![وكلاء الذكاء الاصطناعي للمبتدئين](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### سلسلة الذكاء الاصطناعي التوليدي [![الذكاء الاصطناعي التوليدي للمبتدئين](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![الذكاء الاصطناعي التوليدي (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![الذكاء الاصطناعي التوليدي (جافا)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![الذكاء الاصطناعي التوليدي (جافا سكريبت)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +[![الذكاء الاصطناعي التوليدي (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![الذكاء الاصطناعي التوليدي (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- ### التعلم الأساسي [![تعلم الآلة للمبتدئين](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![علوم البيانات للمبتدئين](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![علم البيانات للمبتدئين](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![الذكاء الاصطناعي للمبتدئين](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) [![الأمن السيبراني للمبتدئين](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) [![تطوير الويب للمبتدئين](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) @@ -248,21 +248,21 @@ ## الحصول على المساعدة -إذا علقت أو كان لديك أي أسئلة حول بناء تطبيقات الذكاء الاصطناعي. انضم إلى المتعلمين الآخرين والمطورين ذوي الخبرة في مناقشات حول MCP. إنها مجتمع داعم حيث الأسئلة مرحب بها والمعرفة تُشارك بحرية. +إذا واجهت صعوبة أو كان لديك أي أسئلة حول بناء تطبيقات الذكاء الاصطناعي. انضم إلى المتعلمين الآخرين والمطورين ذوي الخبرة في مناقشات حول MCP. إنها مجتمع داعم حيث تُرحب بالأسئلة ويُشارك المعرفة بحرية. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -إذا كان لديك ملاحظات عن المنتج أو أخطاء أثناء البناء قم بزيارة: +إذا كان لديك ملاحظات على المنتج أو أخطاء أثناء البناء قم بزيارة: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ## الترخيص -هذا المستودع مرخص تحت رخصة MIT. راجع ملف [LICENSE](../../LICENSE) لمزيد من المعلومات. +هذا المستودع مرخص برخصة MIT. راجع ملف [LICENSE](../../LICENSE) لمزيد من المعلومات. --- -**إخلاء المسؤولية**: -تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [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/ar/Roadmap.md b/translations/ar/Roadmap.md new file mode 100644 index 000000000..3c0044f7b --- /dev/null +++ b/translations/ar/Roadmap.md @@ -0,0 +1,53 @@ +# خارطة طريق لمستودع Web-Dev-For-Beginners الخاص بـ Microsoft + +**يوفر هذا المستودع خارطة طريق لتعلم أساسيات تطوير الويب مع التركيز على JavaScript و HTML و CSS. المنهج مرن ويمكن أخذه ككل أو جزئياً، مع 24 درساً موزعة على 12 أسبوعاً.** + +## الإنجازات الرئيسية + +* **الأسبوع 1-3:** + * مقدمة عن لغات البرمجة وأدوات المجال + * أساسيات GitHub + * إمكانية الوصول + * أساسيات JS: أنواع البيانات، الدوال والطرق + * اتخاذ القرارات باستخدام JS +* **الأسبوع 4-6:** + * المصفوفات والحلقات + * Terrarium: HTML في الممارسة + * CSS في الممارسة + * الإغلاقات في جافا سكريبت + * التلاعب بـ DOM +* **الأسبوع 7-9:** + * لعبة الطباعة: البرمجة المدفوعة بالأحداث + * إضافة المتصفح الخضراء: العمل مع المتصفحات + * بناء نموذج، استدعاء API وتخزين المتغيرات في التخزين المحلي + * العمليات الخلفية في المتصفح + * أداء الويب +* **الأسبوع 10-12:** + * لعبة الفضاء: تطوير ألعاب أكثر تقدمًا باستخدام جافا سكريبت + * الرسم على اللوحة + * تحريك العناصر حول الشاشة + * كشف التصادمات + * حفظ النقاط، إنهاء وإعادة تشغيل اللعبة + * تطبيق مصرفي: قوالب HTML والمسارات في تطبيق ويب + * بناء نموذج تسجيل الدخول والتسجيل + * طرق جلب واستخدام البيانات + * مفاهيم إدارة الحالة + +## النتائج التعليمية + +**بتنفيذ هذه الخريطة، سيكتسب الطلاب خبرة عملية في بناء لعبة الطباعة، التراريوم الافتراضي، إضافة متصفح صديقة للبيئة، لعبة غزاة الفضاء، وتطبيق مصرفي للأعمال. كما سيطورون فهماً قوياً لأساسيات تطوير الويب.** + +## الموارد الإضافية + +* يوفر هذا المستودع ثروة من الموارد للتعلم المستمر، بما في ذلك الدروس، أمثلة الكود، والتحديات. +* تقدم منصة Microsoft Learn مجموعة من دورات تطوير الويب ومسارات التعلم. +* المجتمعات الإلكترونية مثل Stack Overflow و MDN Web Docs توفر دعمًا وموارد قيمة لمطوري الويب. + +**آمل أن تساعدك هذه الخريطة في رحلتك لتطوير الويب!** + +--- + + +**إخلاء المسؤولية**: +تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لضمان الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الحساسة أو الهامة، يُوصى بالترجمة المهنية من قبل مترجمين محترفين. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة. + \ No newline at end of file diff --git a/translations/fa/.co-op-translator.json b/translations/fa/.co-op-translator.json index 3919ee7c4..299351889 100644 --- a/translations/fa/.co-op-translator.json +++ b/translations/fa/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:15:19+00:00", + "translation_date": "2026-02-06T15:59:48+00:00", "source_file": "AGENTS.md", "language_code": "fa" }, @@ -516,11 +516,17 @@ "language_code": "fa" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T17:40:06+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T15:55:30+00:00", "source_file": "README.md", "language_code": "fa" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T15:56:13+00:00", + "source_file": "Roadmap.md", + "language_code": "fa" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-24T11:57:04+00:00", diff --git a/translations/fa/AGENTS.md b/translations/fa/AGENTS.md index ac4c6172e..b0bdc9f6f 100644 --- a/translations/fa/AGENTS.md +++ b/translations/fa/AGENTS.md @@ -1,24 +1,24 @@ # AGENTS.md -## نمای کلی پروژه +## مروری بر پروژه -این مخزن یک برنامه آموزشی برای آموزش اصول توسعه وب به مبتدیان است. این برنامه آموزشی یک دوره جامع ۱۲ هفته‌ای است که توسط Microsoft Cloud Advocates توسعه داده شده و شامل ۲۴ درس عملی در زمینه جاوااسکریپت، CSS و HTML می‌باشد. +این یک مخزن محتوای آموزشی برای آموزش اصول توسعه وب به مبتدیان است. این دوره آموزشی جامع، یک دوره 12 هفته‌ای است که توسط مایکروسافت کلود ادوکیتس توسعه یافته و شامل 24 درس عملی در زمینه جاوااسکریپت، CSS و HTML می‌باشد. -### اجزای کلیدی +### اجزای اصلی -- **محتوای آموزشی**: ۲۴ درس ساختارمند که به صورت ماژول‌های مبتنی بر پروژه سازماندهی شده‌اند -- **پروژه‌های عملی**: Terrarium، بازی تایپ، افزونه مرورگر، بازی فضایی، اپلیکیشن بانکی، ویرایشگر کد، و دستیار چت هوش مصنوعی -- **آزمون‌های تعاملی**: ۴۸ آزمون با ۳ سوال در هر آزمون (ارزیابی‌های قبل و بعد از درس) -- **پشتیبانی چندزبانه**: ترجمه‌های خودکار به بیش از ۵۰ زبان از طریق GitHub Actions -- **فناوری‌ها**: HTML، CSS، جاوااسکریپت، Vue.js 3، Vite، Node.js، Express، Python (برای پروژه‌های هوش مصنوعی) +- **محتوای آموزشی**: 24 درس ساختاریافته سازمان‌یافته در ماژول‌های مبتنی بر پروژه +- **پروژه‌های عملی**: تری‌ریم، بازی تایپینگ، افزونه مرورگر، بازی فضایی، برنامه بانکداری، ویرایشگر کد و دستیار چت هوش مصنوعی +- **آزمون‌های تعاملی**: 48 آزمون با 3 سوال هر کدام (ارزیابی قبل/بعد از درس) +- **پشتیبانی چندزبانه**: ترجمه خودکار برای بیش از 50 زبان از طریق اکشن‌های گیت‌هاب +- **فناوری‌ها**: HTML، CSS، جاوااسکریپت، Vue.js 3، Vite، Node.js، Express، پایتون (برای پروژه‌های AI) ### معماری -- مخزن آموزشی با ساختار مبتنی بر درس -- هر پوشه درس شامل README، مثال‌های کد و راه‌حل‌ها است -- پروژه‌های مستقل در دایرکتوری‌های جداگانه (quiz-app، پروژه‌های مختلف درس) +- مخزن آموزشی با ساختار مبتنی بر درس‌ها +- هر پوشه درس شامل README، نمونه کدها و راه‌حل‌ها است +- پروژه‌های مستقل در دایرکتوری‌های جداگانه (quiz-app، پروژه‌های مختلف درس‌ها) - سیستم ترجمه با استفاده از GitHub Actions (co-op-translator) -- مستندات از طریق Docsify ارائه شده و به صورت PDF در دسترس است +- مستندات ارائه شده با Docsify و در قالب PDF دردسترس ## دستورات راه‌اندازی @@ -36,19 +36,19 @@ cd Web-Dev-For-Beginners ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # شروع سرور توسعه +npm run build # ساخت برای تولید +npm run lint # اجرای ESLint ``` -### API پروژه بانکی (Node.js + Express) +### API پروژه بانک (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # راه‌اندازی سرور API +npm run lint # اجرای ESLint +npm run format # قالب‌بندی با Prettier ``` ### پروژه‌های افزونه مرورگر @@ -56,7 +56,7 @@ npm run format # Format with Prettier ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# دستورالعمل‌های بارگذاری افزونه مخصوص مرورگر را دنبال کنید ``` ### پروژه‌های بازی فضایی @@ -64,219 +64,217 @@ npm install ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# فایل index.html را در مرورگر باز کنید یا از Live Server استفاده کنید ``` -### پروژه چت (پشتیبان Python) +### پروژه چت (بک‌اند پایتون) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# تنظیم متغیر محیطی GITHUB_TOKEN python api.py ``` -## جریان کاری توسعه +## روند توسعه ### برای مشارکت‌کنندگان محتوا -1. **مخزن را فورک کنید** به حساب GitHub خود -2. **فورک خود را به صورت محلی کلون کنید** -3. **یک شاخه جدید ایجاد کنید** برای تغییرات خود -4. تغییرات را در محتوای درس یا مثال‌های کد اعمال کنید -5. تغییرات کد را در دایرکتوری‌های پروژه مربوطه آزمایش کنید -6. درخواست‌های pull را مطابق با دستورالعمل‌های مشارکت ارسال کنید +1. **شاخه مخزن را فورک کنید** به حساب گیت‌هاب خود +2. **شاخه فورک شده را کلون کنید** به صورت محلی +3. **یک شاخه جدید بسازید** برای تغییراتتان +4. تغییرات در محتوای درس یا نمونه کدها ایجاد کنید +5. هر تغییر کد را در دایرکتوری‌های مرتبط پروژه تست کنید +6. درخواست‌های پول (pull requests) را طبق دستورالعمل‌های مشارکت ارسال کنید ### برای یادگیرندگان 1. مخزن را فورک یا کلون کنید -2. به ترتیب به دایرکتوری‌های درس بروید -3. فایل‌های README هر درس را بخوانید +2. مستقیماً به دایرکتوری‌های درس به ترتیب مراجعه کنید +3. فایل‌های README هر درس را مطالعه کنید 4. آزمون‌های قبل از درس را در https://ff-quizzes.netlify.app/web/ تکمیل کنید -5. مثال‌های کد را در پوشه‌های درس انجام دهید -6. تکالیف و چالش‌ها را کامل کنید +5. روی نمونه کدها در پوشه‌های درس کار کنید +6. تمرینات و چالش‌ها را انجام دهید 7. آزمون‌های بعد از درس را انجام دهید ### توسعه زنده -- **مستندات**: دستور `docsify serve` را در ریشه اجرا کنید (پورت ۳۰۰۰) +- **مستندات**: با دستور `docsify serve` در ریشه اجرا کنید (پورت 3000) - **اپلیکیشن آزمون**: دستور `npm run dev` را در دایرکتوری quiz-app اجرا کنید - **پروژه‌ها**: از افزونه Live Server در VS Code برای پروژه‌های HTML استفاده کنید - **پروژه‌های API**: دستور `npm start` را در دایرکتوری‌های API مربوطه اجرا کنید -## دستورالعمل‌های آزمایش +## دستورالعمل‌های تست -### آزمایش اپلیکیشن آزمون +### تست اپلیکیشن آزمون ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # بررسی مشکلات سبک کد +npm run build # تأیید موفقیت ساخت ``` -### آزمایش API بانکی +### تست API بانک ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # بررسی مشکلات سبک کد +node server.js # بررسی راه‌اندازی سرور بدون خطاها ``` -### رویکرد کلی آزمایش +### رویکرد کلی تست -- این مخزن آموزشی فاقد آزمایش‌های خودکار جامع است -- آزمایش دستی بر موارد زیر تمرکز دارد: - - اجرای مثال‌های کد بدون خطا - - کارکرد صحیح لینک‌های مستندات - - تکمیل موفقیت‌آمیز ساخت پروژه‌ها - - رعایت بهترین شیوه‌ها در مثال‌ها +- این یک مخزن آموزشی بدون تست‌های خودکار جامع است +- تست دستی روی موارد زیر تمرکز دارد: + - نمونه کدها بدون خطا اجرا شوند + - لینک‌های مستندات به درستی کار کنند + - ساخت پروژه‌ها موفقیت‌آمیز باشد + - نمونه‌ها طبق بهترین شیوه‌ها باشند ### بررسی‌های قبل از ارسال -- دستور `npm run lint` را در دایرکتوری‌هایی که package.json دارند اجرا کنید -- اعتبار لینک‌های markdown را بررسی کنید -- مثال‌های کد را در مرورگر یا Node.js آزمایش کنید -- اطمینان حاصل کنید که ترجمه‌ها ساختار مناسب را حفظ کرده‌اند +- اجرای `npm run lint` در دایرکتوری‌های حاوی package.json +- اطمینان از صحت لینک‌های مارک‌داون +- تست نمونه کدها در مرورگر یا Node.js +- بررسی حفظ ساختار ترجمه‌ها -## دستورالعمل‌های سبک کدنویسی +## راهنمای سبک کد ### جاوااسکریپت -- استفاده از سینتکس مدرن ES6+ -- پیروی از تنظیمات استاندارد ESLint ارائه شده در پروژه‌ها +- استفاده از نگارش مدرن ES6+ +- پیروی از تنظیمات معتبر ESLint ارائه شده در پروژه‌ها - استفاده از نام‌های متغیر و تابع معنادار برای وضوح آموزشی -- افزودن توضیحات برای توضیح مفاهیم به یادگیرندگان -- قالب‌بندی با استفاده از Prettier در صورت پیکربندی +- افزودن کامنت برای توضیح مفاهیم برای یادگیرندگان +- فرمت کردن با Prettier در صورت پیکربندی ### HTML/CSS - استفاده از عناصر معنایی HTML5 - اصول طراحی واکنش‌گرا -- کنوانسیون‌های نام‌گذاری کلاس واضح -- توضیحات برای توضیح تکنیک‌های CSS به یادگیرندگان +- قراردادهای نامگذاری کلاس‌های واضح +- کامنت‌های توضیح تکنیک‌های CSS برای یادگیرندگان -### Python +### پایتون -- دستورالعمل‌های سبک PEP 8 -- مثال‌های کد واضح و آموزشی -- استفاده از نوع‌دهی در صورت مفید بودن برای یادگیری +- رعایت دستورالعمل‌های استایل PEP 8 +- نمونه کدهای واضح و آموزشی +- استفاده از Type hints در صورت مفید بودن برای یادگیری -### مستندات 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 Static Web Apps) -اپلیکیشن آزمون برای استقرار در Azure Static Web Apps پیکربندی شده است: +quiz-app برای استقرار در Azure Static Web Apps پیکربندی شده است: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # پوشه dist/ را ایجاد می‌کند +# هنگام push به شاخه main با استفاده از گردش کار GitHub Actions انتشار می‌دهد ``` پیکربندی Azure Static Web Apps: -- **محل اپلیکیشن**: `/quiz-app` -- **محل خروجی**: `dist` -- **جریان کاری**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +- **مکان اپلیکیشن**: `/quiz-app` +- **مکان خروجی**: `dist` +- **روند کاری**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### تولید PDF مستندات ```bash -npm install # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # نصب docsify-to-pdf +npm run convert # تولید PDF از docs ``` ### مستندات Docsify ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # نصب Docsify به صورت سراسری +docsify serve # سرویس‌دهی در localhost:3000 ``` ### ساخت‌های خاص پروژه -هر دایرکتوری پروژه ممکن است فرآیند ساخت خود را داشته باشد: -- پروژه‌های Vue: دستور `npm run build` بسته‌های تولیدی ایجاد می‌کند -- پروژه‌های استاتیک: مرحله ساخت ندارند، فایل‌ها را مستقیماً ارائه دهید +هر دایرکتوری پروژه ممکن است روند ساخت خاص خود را داشته باشد: +- پروژه‌های Vue: `npm run build` برای ایجاد بسته‌های تولیدی +- پروژه‌های استاتیک: بدون مرحله ساخت، فایل‌ها مستقیماً سرو می‌شوند -## دستورالعمل‌های درخواست Pull +## دستورالعمل‌های درخواست Pull Request -### قالب عنوان +### فرمت عنوان -از عناوین واضح و توصیفی که ناحیه تغییر را نشان می‌دهند استفاده کنید: +از عناوین واضح و توصیفی استفاده کنید که حوزه تغییر را نشان می‌دهند: - `[Quiz-app] افزودن آزمون جدید برای درس X` -- `[Lesson-3] اصلاح اشتباه تایپی در پروژه terrarium` -- `[Translation] افزودن ترجمه اسپانیایی برای درس ۵` +- `[Lesson-3] اصلاح تایپو در پروژه تری‌ریم` +- `[Translation] افزودن ترجمه اسپانیایی برای درس 5` - `[Docs] به‌روزرسانی دستورالعمل‌های راه‌اندازی` -### بررسی‌های مورد نیاز - -قبل از ارسال PR: +### چک‌های مورد نیاز قبل از ارسال PR 1. **کیفیت کد**: - - دستور `npm run lint` را در دایرکتوری‌های پروژه‌های تحت تأثیر اجرا کنید - - تمام خطاها و هشدارهای linting را اصلاح کنید + - اجرای `npm run lint` در دایرکتوری پروژه‌های مربوط + - رفع تمام خطاها و هشدارهای lint -2. **تأیید ساخت**: - - دستور `npm run build` را در صورت لزوم اجرا کنید - - اطمینان حاصل کنید که هیچ خطای ساخت وجود ندارد +2. **تایید ساخت**: + - اجرای `npm run build` در صورت نیاز + - اطمینان از عدم وجود خطای ساخت 3. **اعتبارسنجی لینک‌ها**: - - تمام لینک‌های markdown را آزمایش کنید - - اطمینان حاصل کنید که ارجاعات تصاویر کار می‌کنند + - تست تمام لینک‌های مارک‌داون + - اطمینان از کارکرد ارجاعات به تصاویر -4. **بررسی محتوا**: - - از نظر املایی و گرامری بازخوانی کنید - - اطمینان حاصل کنید که مثال‌های کد صحیح و آموزشی هستند - - بررسی کنید که ترجمه‌ها معنای اصلی را حفظ کرده‌اند +4. **بازبینی محتوا**: + - اصلاح املایی و گرامری + - اطمینان از درستی و آموزشی بودن نمونه‌های کد + - بررسی حفظ معنی در ترجمه‌ها ### الزامات مشارکت -- موافقت با Microsoft CLA (بررسی خودکار در اولین PR) -- پیروی از [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- دستورالعمل‌های دقیق را در [CONTRIBUTING.md](./CONTRIBUTING.md) مشاهده کنید -- در صورت لزوم شماره‌های مسئله را در توضیحات PR ذکر کنید +- تایید قرارداد مجوز مایکروسافت (چک خودکار در PR اول) +- پیروی از [کد رفتاری منبع باز مایکروسافت](https://opensource.microsoft.com/codeofconduct/) +- مشاهده [CONTRIBUTING.md](./CONTRIBUTING.md) برای راهنمایی‌های دقیق‌تر +- ارجاع شماره‌های Issue در توضیحات PR در صورت وجود -### فرآیند بررسی +### روند بازبینی -- PR‌ها توسط نگهدارندگان و جامعه بررسی می‌شوند -- وضوح آموزشی در اولویت است -- مثال‌های کد باید از بهترین شیوه‌های فعلی پیروی کنند -- ترجمه‌ها از نظر دقت و مناسب بودن فرهنگی بررسی می‌شوند +- PRها توسط نگه‌دارندگان و جامعه بررسی می‌شوند +- اولویت بر وضوح آموزشی است +- نمونه‌های کد باید بهترین شیوه‌های کنونی را دنبال کنند +- ترجمه‌ها برای دقت و تناسب فرهنگی بررسی می‌شوند ## سیستم ترجمه ### ترجمه خودکار -- از GitHub Actions با جریان کاری co-op-translator استفاده می‌کند -- به طور خودکار به بیش از ۵۰ زبان ترجمه می‌شود +- استفاده از GitHub Actions با روند کاری co-op-translator +- ترجمه به بیش از 50 زبان به صورت خودکار - فایل‌های منبع در دایرکتوری‌های اصلی -- فایل‌های ترجمه شده در دایرکتوری‌های `translations/{language-code}/` +- فایل‌های ترجمه شده در ساختار `translations/{language-code}/` ### افزودن بهبودهای ترجمه دستی 1. فایل را در `translations/{language-code}/` پیدا کنید -2. بهبودها را در حالی که ساختار را حفظ می‌کنید اعمال کنید -3. اطمینان حاصل کنید که مثال‌های کد همچنان کار می‌کنند -4. هر محتوای آزمون محلی‌سازی شده را آزمایش کنید +2. بهبودها را با حفظ ساختار اعمال کنید +3. اطمینان از عملکرد صحیح نمونه کدها +4. تست محتوای آزمون محلی‌شده در صورت وجود -### متادیتای ترجمه +### فراداده ترجمه -فایل‌های ترجمه شده شامل سربرگ متادیتا هستند: +فایل‌های ترجمه شامل هدر فراداده هستند: ```markdown +**سلب مسؤولیت**: +این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما برای دقت تلاش می‌کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌هایی باشند. سند اصلی به زبان بومی خود باید به‌عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئول هیچگونه سوءتفاهم یا برداشت نادرستی که از استفاده این ترجمه ناشی شود، نمی‌باشیم. + \ No newline at end of file diff --git a/translations/fa/README.md b/translations/fa/README.md index 83b3f1beb..8a82c7418 100644 --- a/translations/fa/README.md +++ b/translations/fa/README.md @@ -2,7 +2,7 @@ [![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) [![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) @@ -10,72 +10,72 @@ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -# توسعه وب برای مبتدی‌ها - یک دوره آموزشی +# توسعه وب برای مبتدیان - یک برنامه درسی -اصول بنیادی توسعه وب را با دوره جامع ۱۲ هفته‌ای ما توسط مدافعان مایکروسافت کلود بیاموزید. هر یک از ۲۴ درس به صورت عملی به جاوااسکریپت، CSS و HTML می‌پردازد با پروژه‌هایی مانند تراریوم‌ها، افزونه‌های مرورگر و بازی‌های فضایی. در کوییزها، گفتگوها و تمرین‌های عملی شرکت کنید. مهارت‌های خود را ارتقا دهید و با روش آموزش مبتنی بر پروژه ما، دانش خود را بهینه کنید. سفر کدنویسی خود را امروز آغاز کنید! +اصول توسعه وب را با دوره جامع ۱۲ هفته‌ای ما توسط مایکروسافت کلود ادوکیتس بیاموزید. هر یک از ۲۴ درس به صورت عملی به جاوااسکریپت، CSS و HTML می‌پردازد از طریق پروژه‌های عملی مانند تراریوم‌ها، افزونه‌های مرورگر و بازی‌های فضایی. با آزمون‌ها، بحث‌ها و تکالیف عملی درگیر شوید. مهارت‌های خود را تقویت کنید و با روش آموزش مبتنی بر پروژه مؤثر، دانش خود را بهینه کنید. سفر برنامه‌نویسی خود را امروز آغاز کنید! -به انجمن دیسکورد Azure AI Foundry ملحق شوید +به انجمن دیسکورد Azure AI Foundry بپیوندید [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -برای شروع استفاده از این منابع، مراحل زیر را دنبال کنید: -1. **انشعاب (فورک) مخزن**: روی [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) کلیک کنید -2. **کلون کردن مخزن**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**به دیسکورد Azure AI Foundry بپیوندید و با کارشناسان و توسعه‌دهندگان هم‌تراز ملاقات کنید**](https://discord.com/invite/ByRwuEEgH4) +برای شروع استفاده از این منابع، این مراحل را دنبال کنید: +1. **فورک کردن مخزن**: کلیک کنید بر روی [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) +2. **کلون کردن مخزن**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**به دیسکورد Azure AI Foundry بپیوندید و با متخصصان و توسعه‌دهندگان دیگر دیدار کنید**](https://discord.com/invite/ByRwuEEgH4) -### 🌐 پشتیبانی چندزبان +### 🌐 پشتیبانی چندزبانه -#### پشتیبانی توسط GitHub Action (خودکار و همیشه به‌روز) +#### پشتیبانی شده از طریق GitHub Action (خودکار و همیشه به‌روز) -[عربی](../ar/README.md) | [بنگالی](../bn/README.md) | [بلغاری](../bg/README.md) | [برمه‌ای (میانمار)](../my/README.md) | [چینی (ساده‌شده)](../zh-CN/README.md) | [چینی (سنتی، هنگ‌کنگ)](../zh-HK/README.md) | [چینی (سنتی، ماکائو)](../zh-MO/README.md) | [چینی (سنتی، تایوان)](../zh-TW/README.md) | [کرواتی](../hr/README.md) | [چک](../cs/README.md) | [دانمارکی](../da/README.md) | [هلندی](../nl/README.md) | [استونیایی](../et/README.md) | [فنلاندی](../fi/README.md) | [فرانسوی](../fr/README.md) | [آلمانی](../de/README.md) | [یونانی](../el/README.md) | [عبری](../he/README.md) | [هندی](../hi/README.md) | [مجارستانی](../hu/README.md) | [اندونزیایی](../id/README.md) | [ایتالیایی](../it/README.md) | [ژاپنی](../ja/README.md) | [کانارا](../kn/README.md) | [کره‌ای](../ko/README.md) | [لیتوانیایی](../lt/README.md) | [مالایی](../ms/README.md) | [مالایالام](../ml/README.md) | [مراتی](../mr/README.md) | [نپالی](../ne/README.md) | [پیدجین نیجریه‌ای](../pcm/README.md) | [نروژی](../no/README.md) | [فارسی](./README.md) | [لهستانی](../pl/README.md) | [پرتغالی (برزیل)](../pt-BR/README.md) | [پرتغالی (پرتغال)](../pt-PT/README.md) | [پنجابی (گورموخی)](../pa/README.md) | [رومانیایی](../ro/README.md) | [روسی](../ru/README.md) | [صربی (سیریلیک)](../sr/README.md) | [اسلواکی](../sk/README.md) | [اسلوونیایی](../sl/README.md) | [اسپانیایی](../es/README.md) | [سواحیلی](../sw/README.md) | [سوئدی](../sv/README.md) | [تاگالوگ (فیلیپینی)](../tl/README.md) | [تامیل](../ta/README.md) | [تلوگو](../te/README.md) | [تایلندی](../th/README.md) | [ترکی](../tr/README.md) | [اوکراینی](../uk/README.md) | [اردو](../ur/README.md) | [ویتنامی](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](./README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) -> **مایلید به کلون کردن محلی هستید؟** +> **ترجیح می‌دهید به صورت محلی کلون کنید؟** -> این مخزن شامل بیش از ۵۰ ترجمه زبان است که اندازه دانلود را به طور قابل توجهی افزایش می‌دهد. برای کلون بدون ترجمه‌ها، از sparse checkout استفاده کنید: +> این مخزن شامل بیش از ۵۰ ترجمه زبان است که به‌طور قابل توجهی حجم دانلود را افزایش می‌دهد. برای کلون بدون ترجمه‌ها از چک‌اوت جزئی استفاده کنید: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> این به شما همه چیز لازم برای تکمیل دوره را با دانلود بسیار سریع‌تر می‌دهد. +> این به شما همه چیز لازم برای کامل کردن دوره را با دانلود بسیار سریعتر می‌دهد. -**اگر تمایل به پشتیبانی ترجمه زبان‌های بیشتر دارید، زبان‌های پشتیبانی شده در [اینجا](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md) آمده است** +**اگر مایل هستید زبان‌های ترجمه اضافی پشتیبانی شوند، این زبان‌ها در [اینجا](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md) فهرست شده‌اند** -[![باز کردن در Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) +[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) #### 🧑‍🎓 _آیا دانشجو هستید؟_ -از صفحه [**Student Hub**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) دیدن کنید که منابع مبتدی، پکیج‌های دانشجویی و حتی راه‌هایی برای دریافت کوپن رایگان گواهینامه را خواهید یافت. این صفحه‌ای است که باید نشانک کنید و گاه به گاه بررسی کنید چون محتوای آن ماهانه به‌روزرسانی می‌شود. +از [**صفحه مرکز دانشجویی**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon) دیدن کنید، جایی که منابع مبتدی، بسته‌های دانشجویی و حتی راه‌هایی برای دریافت رایگان کد تخفیف گواهی را پیدا خواهید کرد. این صفحه‌ای است که باید ذخیره کنید و هر از گاهی بررسی کنید چون محتوای آن ماهانه به روز می‌شود. -### 📣 اطلاعیه - چالش‌های حالت GitHub Copilot Agent جدید برای تکمیل! +### 📣 اعلامیه - چالش‌های جدید حالت GitHub Copilot Agent برای تکمیل! -چالش جدید اضافه شده، به دنبال "GitHub Copilot Agent Challenge 🚀" در اکثر فصل‌ها باشید. این چالش جدیدی است برای شما که با استفاده از GitHub Copilot و حالت Agent کامل کنید. اگر پیش‌تر حالت Agent را استفاده نکرده‌اید، این حالت قادر است نه فقط متن تولید کند بلکه فایل‌ها را بسازد و ویرایش کند، فرمان‌ها را اجرا کند و بیشتر. +چالش جدید اضافه شده است، در اکثر فصل‌ها دنبال "چالش GitHub Copilot Agent 🚀" باشید. این چالش جدیدی است برای شما که با استفاده از GitHub Copilot و حالت Agent تکمیل کنید. اگر قبلاً از حالت Agent استفاده نکرده‌اید، این حالت نه تنها قادر به تولید متن است بلکه می‌تواند فایل بسازد و ویرایش کند، دستورات اجرا کند و بیشتر. -### 📣 اطلاعیه - _پروژه جدیدی برای ساخت با هوش مصنوعی مولد_ +### 📣 اعلامیه - _پروژه جدید برای ساخت با استفاده از هوش مصنوعی مولد_ -پروژه دستیار هوش مصنوعی جدید همین‌تازگی اضافه شده، آن را بررسی کنید [project](./9-chat-project/README.md) +پروژه دستیار هوش مصنوعی جدید همین الان اضافه شده است، آن را بررسی کنید [پروژه](./9-chat-project/README.md) -### 📣 اطلاعیه - _دوره جدید_ درباره هوش مصنوعی مولد برای جاوااسکریپت همین‌تازگی منتشر شده +### 📣 اعلامیه - _برنامه درسی جدید_ درباره هوش مصنوعی مولد برای جاوااسکریپت به تازگی منتشر شده است -دوره جدید هوش مصنوعی مولد ما را از دست ندهید! +برنامه درسی جدید هوش مصنوعی مولد ما را از دست ندهید! برای شروع به [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) مراجعه کنید! -![پس‌زمینه](../../translated_images/fa/background.148a8d43afde5730.webp) +![Background](../../translated_images/fa/background.148a8d43afde5730.webp) -- درس‌ها شامل همه چیز از مقدمات تا RAG. -- تعامل با شخصیت‌های تاریخی با استفاده از GenAI و اپ همراه ما. -- روایت جذاب و سرگرم‌کننده، شما را به سفر در زمان می‌برد! +- دروس شامل همه چیز از اصول تا RAG. +- تعامل با شخصیت‌های تاریخی با استفاده از GenAI و اپلیکیشن همراه ما. +- روایت سرگرم‌کننده و جذاب، شما سفر در زمان خواهید داشت! -![شخصیت](../../translated_images/fa/character.5c0dd8e067ffd693.webp) +![character](../../translated_images/fa/character.5c0dd8e067ffd693.webp) -هر درس شامل یک تمرین برای تکمیل، یک آزمون دانش و یک چالش برای راهنمایی شما در یادگیری موضوعاتی مانند: -- پرامپت‌نویسی و مهندسی پرامپت +هر درس شامل یک تکلیف برای کامل کردن، یک آزمون دانش و یک چالش برای راهنمایی شما در یادگیری موضوعاتی مانند: +- درخواست و مهندسی درخواست‌ها - تولید اپلیکیشن‌های متنی و تصویری -- اپ‌های جستجو +- اپلیکیشن‌های جستجو برای شروع به [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) مراجعه کنید! @@ -83,134 +83,134 @@ ## 🌱 شروع به کار -> **معلمان**، ما [برخی پیشنهادات](for-teachers.md) درباره نحوه استفاده از این دوره را درج کرده‌ایم. خوشحال می‌شویم بازخورد شما را [در انجمن بحث ما](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner) دریافت کنیم! +> **معلمان**، ما [چند پیشنهاد](for-teachers.md) برای استفاده از این برنامه درسی تهیه کرده‌ایم. ما مشتاق دریافت بازخورد شما [در انجمن بحث و گفتگو](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner) هستیم! -**[یادگیرندگان](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**، برای هر درس، با یک کوییز پیش‌سخنرانی شروع کنید و سپس با خواندن متون درس، تکمیل فعالیت‌های مختلف و ارزیابی درک خود با کوییز پساسخنرانی ادامه دهید. +**[دانش‌آموزان](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**، برای هر درس، با یک آزمون قبل از کلاس شروع کنید و سپس مطالب درس را مطالعه کنید، فعالیت‌های مختلف را انجام دهید و درک خود را با آزمون پس از کلاس بسنجید. -برای بهبود تجربه یادگیری خود، با همکلاسی‌هایتان ارتباط برقرار کنید و پروژه‌ها را با هم انجام دهید! بحث و گفتگو در [انجمن بحث ما](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) تشویق می‌شود و تیم ناظران ما برای پاسخگویی به سوالات شما در دسترس خواهند بود. +برای ارتقای تجربه یادگیری خود، با همکلاسی‌هایتان برای انجام پروژه‌ها همکاری کنید! مشارکت در بحث‌ها در [انجمن بحث و گفتگو](https://github.com/microsoft/Web-Dev-For-Beginners/discussions) تشویق می‌شود و تیم ناظران ما آماده پاسخگویی به سوالات شما خواهند بود. -برای ارتقای آموزش خود، شدیداً پیشنهاد می‌کنیم که [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) را برای منابع مطالعه اضافی بررسی کنید. +برای ادامه تحصیل، به شدت پیشنهاد می‌کنیم مواد آموزشی بیشتر را در [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) کاوش کنید. ### 📋 راه‌اندازی محیط کاری شما -این دوره دارای محیط توسعه آماده است! هنگام شروع، می‌توانید انتخاب کنید که دوره را در [Codespace](https://github.com/features/codespaces/) (_یک محیط مبتنی بر مرورگر بدون نیاز به نصب_) یا محلی روی کامپیوتر خود با یک ویرایشگر متن مانند [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) اجرا کنید. +این برنامه درسی یک محیط توسعه آماده دارد! هنگام شروع می‌توانید انتخاب کنید که دوره را در یک [Codespace](https://github.com/features/codespaces/) (_یک محیط مبتنی بر مرورگر و بدون نیاز به نصب_) یا به صورت محلی روی کامپیوتر خود با استفاده از یک ویرایشگر متن مانند [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) اجرا کنید. #### ایجاد مخزن خود -برای اینکه بتوانید به‌راحتی کارهای خود را ذخیره کنید، توصیه می‌شود یک کپی از این مخزن ایجاد کنید. برای این کار روی دکمه **Use this template** در بالای صفحه کلیک کنید. این کار یک مخزن جدید در حساب GitHub شما با کپی دوره ایجاد می‌کند. +برای اینکه به راحتی بتوانید کار خود را ذخیره کنید، توصیه می‌شود یک نسخه از این مخزن را ایجاد کنید. می‌توانید این کار را با کلیک روی دکمه **Use this template** در بالای صفحه انجام دهید. این یک مخزن جدید در حساب گیت‌هاب شما با کپی برنامه درسی ایجاد می‌کند. مراحل زیر را دنبال کنید: -1. **انشعاب مخزن**: روی دکمه "Fork" در گوشه بالا سمت راست این صفحه کلیک کنید. -2. **کلون کردن مخزن**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +1. **فورک کردن مخزن**: روی دکمه "Fork" در گوشه بالای سمت راست این صفحه کلیک کنید. +2. **کلون کردن مخزن**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### اجرای دوره در Codespace +#### اجرای برنامه درسی در یک Codespace -در نسخه خود از این مخزن که ایجاد کرده‌اید، روی دکمه **Code** کلیک کرده و گزینه **Open with Codespaces** را انتخاب کنید. این کار یک Codespace جدید برای کار شما ایجاد می‌کند. +در نسخه کپی شده مخزن که ایجاد کرده‌اید، دکمه **Code** را کلیک کرده و **Open with Codespaces** را انتخاب کنید. این یک Codespace جدید برای کار ایجاد خواهد کرد. ![Codespace](../../translated_images/fa/createcodespace.0238bbf4d7a8d955.webp) -#### اجرای دوره به صورت محلی روی کامپیوتر شما +#### اجرای برنامه به صورت محلی روی کامپیوتر خود -برای اجرای این دوره به‌صورت محلی نیاز به یک ویرایشگر متن، یک مرورگر و یک ابزار خط فرمان دارید. اولین درس ما، [معرفی زبان‌های برنامه‌نویسی و ابزارهای کار](../../1-getting-started-lessons/1-intro-to-programming-languages)، گزینه‌های مختلف هر یک از این ابزارها را به شما معرفی می‌کند تا بهترین گزینه را برای خود انتخاب کنید. +برای اجرای این برنامه روی کامپیوترتان به یک ویرایشگر متن، یک مرورگر و یک ابزار خط فرمان نیاز دارید. اولین درس ما، [مقدمه‌ای بر زبان‌های برنامه‌نویسی و ابزارهای کار](../../1-getting-started-lessons/1-intro-to-programming-languages)، شما را از طریق گزینه‌های مختلف برای هر یک از این ابزارها راهنمایی می‌کند تا بهترین گزینه برای خود را انتخاب کنید. -توصیه ما استفاده از [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) به عنوان ویرایشگر است که همچنین دارای یک [ترمینال داخلی](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) است. می‌توانید Visual Studio Code را از [اینجا](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) دانلود کنید. +توصیه ما استفاده از [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) به عنوان ویرایشگر است که دارای [ترمینال](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) داخلی نیز می‌باشد. می‌توانید Visual Studio Code را از [اینجا](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) دانلود کنید. -1. مخزن خود را به کامپیوترتان کلون کنید. برای این کار روی دکمه **Code** کلیک کرده و URL را کپی کنید: +1. مخزن خود را به کامپیوترتان کلون کنید. می‌توانید این کار را با کلیک روی دکمه **Code** و کپی کردن URL انجام دهید: [CodeSpace](./images/createcodespace.png) -سپس، یک [ترمینال](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) در داخل [ویژوال استودیو کد](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) باز کنید و دستور زیر را اجرا کنید، به‌جای ``، آدرسی را که کپی کرده‌اید جایگزین کنید: +سپس، درون [ترمینال](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) در [ویژوال استودیو کد](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) باز کنید و دستور زیر را اجرا کنید، جایگزین `` با آدرسی که همین حالا کپی کردید: ```bash git clone ``` + +۲. پوشه را در ویژوال استودیو کد باز کنید. می‌توانید این کار را با کلیک روی **File** > **Open Folder** و انتخاب پوشه‌ای که همین حالا کلون کرده‌اید، انجام دهید. -۲. پوشه را در ویژوال استودیو کد باز کنید. این کار را با کلیک روی **File** > **Open Folder** و انتخاب پوشه‌ای که تازه کلون کرده‌اید انجام دهید. - -> افزونه‌های پیشنهاد شده ویژوال استودیو کد: -> -> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - برای پیش‌نمایش صفحات HTML در داخل ویژوال استودیو کد -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - برای کمک به نوشتن سریع‌تر کد +> افزونه‌های پیشنهادی ویژوال استودیو کد: +> +> * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) - برای پیش‌نمایش صفحات HTML در ویژوال استودیو کد +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) - برای کمک به شما در نوشتن سریع‌تر کد ## 📂 هر درس شامل: -- نقشه‌کشی اختیاری -- ویدیوی تکمیلی اختیاری -- آزمون گرم‌کننده پیش‌درس -- درس نوشتاری -- برای درس‌های مبتنی بر پروژه، راهنماهای گام‌به‌گام نحوه ساخت پروژه -- بررسی دانش -- یک چالش -- مطالعه تکمیلی -- تمرین +- یادداشت اختیاری +- ویدئوی مکمل اختیاری +- آزمون گرم‌کننده پیش از درس +- درس کتبی +- برای درس‌های مبتنی بر پروژه، راهنمای گام‌به‌گام برای ساخت پروژه +- بررسی دانش +- یک چالش +- مطالعه مکمل +- تمرین - [آزمون پس از درس](https://ff-quizzes.netlify.app/web/) -> **تذکر درباره آزمون‌ها**: تمام آزمون‌ها در پوشه Quiz-app قرار دارند، مجموعاً ۴۸ آزمون با هر کدام شامل سه سوال. آن‌ها [اینجا](https://ff-quizzes.netlify.app/web/) در دسترس‌اند، اپلیکیشن آزمون می‌تواند به صورت محلی اجرا شود یا روی Azure منتشر گردد؛ دستورالعمل اجرای آن در پوشه `quiz-app` موجود است. - -## 🗃️ دروس - -| | نام پروژه | مفاهیم آموزش داده شده | اهداف آموزشی | درس مرتبط | نویسنده | -| :-: | :------------------------------------------------------: | :--------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | :---------------------: | -| ۰۱ | شروع کار | مقدمه‌ای بر برنامه‌نویسی و ابزارهای کار | یادگیری اصول پایه در پشت بیشتر زبان‌های برنامه‌نویسی و همچنین نرم‌افزارهایی که به توسعه‌دهندگان حرفه‌ای برای انجام کارشان کمک می‌کنند | [مقدمه‌ای بر زبان‌های برنامه‌نویسی و ابزارهای کار](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | جاسمن | -| ۰۲ | شروع کار | مبانی گیت‌هاب، شامل همکاری تیمی | چگونگی استفاده از گیت‌هاب در پروژه، و نحوه همکاری با دیگران روی کد | [مقدمه‌ای بر گیت‌هاب](./1-getting-started-lessons/2-github-basics/README.md) | فلور | -| ۰۳ | شروع کار | دسترسی (Accessibility) | یادگیری اصول پایه درباره دسترسی وب | [مبانی دسترسی](./1-getting-started-lessons/3-accessibility/README.md) | کریستوفر | -| ۰۴ | پایه‌های JS | انواع داده‌ها در جاوااسکریپت | مفاهیم پایه انواع داده‌ها در جاوااسکریپت | [انواع داده‌ها](./2-js-basics/1-data-types/README.md) | جاسمن | -| ۰۵ | پایه‌های JS | توابع و متدها | یادگیری توابع و متدها برای مدیریت جریان منطق برنامه | [توابع و متدها](./2-js-basics/2-functions-methods/README.md) | جاسمن و کریستوفر | -| ۰۶ | پایه‌های JS | تصمیم‌گیری با جاوااسکریپت | نحوه ایجاد شرط‌ها در کد با استفاده از روش‌های تصمیم‌گیری | [تصمیم‌گیری](./2-js-basics/3-making-decisions/README.md) | جاسمن | -| ۰۷ | پایه‌های JS | آرایه‌ها و حلقه‌ها | کار با داده‌ها با استفاده از آرایه‌ها و حلقه‌ها در جاوااسکریپت | [آرایه‌ها و حلقه‌ها](./2-js-basics/4-arrays-loops/README.md) | جاسمن | -| ۰۸ | [Terrarium](./3-terrarium/solution/README.md) | HTML در عمل | ساخت HTML برای ایجاد یک تراریوم آنلاین، با تمرکز روی ساختار صفحه | [مقدمه‌ای بر HTML](./3-terrarium/1-intro-to-html/README.md) | جن | -| ۰۹ | [Terrarium](./3-terrarium/solution/README.md) | CSS در عمل | ساخت CSS برای طراحی تراریوم آنلاین، تمرکز بر اصول CSS از جمله ریسپانسیو کردن صفحه | [مقدمه‌ای بر CSS](./3-terrarium/2-intro-to-css/README.md) | جن | -| ۱۰ | [Terrarium](./3-terrarium/solution/README.md) | کلوژرهای جاوااسکریپت، دستکاری DOM | ساخت جاوااسکریپت برای عملکرد تراریوم به صورت واسط کشیدن و رها کردن، با تمرکز بر کلوژرها و دستکاری DOM | [کلوژرهای جاوااسکریپت، دستکاری DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | جن | -| ۱۱ | [Typing Game](./4-typing-game/solution/README.md) | ساخت بازی تایپینگ | یادگیری استفاده از رویدادهای صفحه‌کلید برای هدایت منطق اپلیکیشن جاوااسکریپت | [برنامه‌نویسی رویدادمحور](./4-typing-game/typing-game/README.md) | کریستوفر | -| ۱۲ | [Green Browser Extension](./5-browser-extension/solution/README.md) | کار با مرورگرها | یادگیری نحوه کار مرورگرها، تاریخچه آن‌ها، و ساخت المان‌های اولیه افزونه مرورگر | [درباره مرورگرها](./5-browser-extension/1-about-browsers/README.md) | جن | -| ۱۳ | [Green Browser Extension](./5-browser-extension/solution/README.md) | ساخت فرم، فراخوانی API و ذخیره متغیرها در فضای محلی | ساخت المان‌های جاوااسکریپت افزونه مرورگر برای فراخوانی API با استفاده از متغیرهای ذخیره‌شده در فضای محلی | [APIها، فرم‌ها و فضای ذخیره محلی](./5-browser-extension/2-forms-browsers-local-storage/README.md) | جن | -| ۱۴ | [Green Browser Extension](./5-browser-extension/solution/README.md) | فرایندهای پس‌زمینه مرورگر، عملکرد وب | استفاده از فرایندهای پس‌زمینه مرورگر برای مدیریت آیکون افزونه؛ یادگیری درباره عملکرد وب و بهینه‌سازی‌های مرتبط | [کارهای پس‌زمینه و عملکرد](./5-browser-extension/3-background-tasks-and-performance/README.md) | جن | -| ۱۵ | [Space Game](./6-space-game/solution/README.md) | توسعه پیشرفته‌تر بازی با جاوااسکریپت | یادگیری وراثت با استفاده از هر دو کلاس‌ها و ترکیب و الگوی Pub/Sub، آماده‌سازی برای ساخت بازی | [مقدمه‌ای بر توسعه پیشرفته بازی](./6-space-game/1-introduction/README.md) | کریس | -| ۱۶ | [Space Game](./6-space-game/solution/README.md) | نقاشی روی بوم | یادگیری API بوم (Canvas) برای ترسیم المان‌ها روی صفحه | [نقاشی روی بوم](./6-space-game/2-drawing-to-canvas/README.md) | کریس | -| ۱۷ | [Space Game](./6-space-game/solution/README.md) | حرکت دادن المان‌ها در اطراف صفحه | کشف نحوه حرکت المان‌ها با استفاده از مختصات کارتزین و API بوم | [حرکت دادن المان‌ها](./6-space-game/3-moving-elements-around/README.md) | کریس | -| ۱۸ | [Space Game](./6-space-game/solution/README.md) | تشخیص برخورد | ایجاد برخورد بین المان‌ها و واکنش به همدیگر با استفاده از کلیدها و ارائه تابع خنک‌کننده برای تضمین عملکرد بازی | [تشخیص برخورد](./6-space-game/4-collision-detection/README.md) | کریس | -| ۱۹ | [Space Game](./6-space-game/solution/README.md) | ثبت امتیاز | انجام محاسبات ریاضی بر اساس وضعیت و عملکرد بازی | [ثبت امتیاز](./6-space-game/5-keeping-score/README.md) | کریس | -| ۲۰ | [Space Game](./6-space-game/solution/README.md) | پایان و راه‌اندازی مجدد بازی | یادگیری درباره خاتمه دادن به بازی و راه‌اندازی مجدد آن، شامل پاکسازی منابع و تنظیم مجدد مقادیر متغیر | [شرط پایان](./6-space-game/6-end-condition/README.md) | کریس | -| ۲۱ | [Banking App](./7-bank-project/solution/README.md) | قالب‌ها و مسیرها (Routes) در یک وب اپ | یادگیری چگونگی ایجاد ساختار سایت چند صفحه‌ای با استفاده از مسیرها و قالب‌های HTML | [قالب‌ها و مسیرها](./7-bank-project/1-template-route/README.md) | یوهان | -| ۲۲ | [Banking App](./7-bank-project/solution/README.md) | ساخت فرم ورود و ثبت‌نام | یادگیری ساخت فرم‌ها و مدیریت روال‌های اعتبارسنجی | [فرم‌ها](./7-bank-project/2-forms/README.md) | یوهان | -| ۲۳ | [Banking App](./7-bank-project/solution/README.md) | روش‌های دریافت و استفاده از داده‌ها | جریان داده‌ها در برنامه شما، نحوه دریافت، ذخیره و دفع آن‌ها | [داده‌ها](./7-bank-project/3-data/README.md) | یوهان | -| ۲۴ | [Banking App](./7-bank-project/solution/README.md) | مفاهیم مدیریت وضعیت (State) | یادگیری اینکه برنامه چگونه وضعیت خود را حفظ می‌کند و نحوه مدیریت آن به صورت برنامه‌نویسی | [مدیریت وضعیت](./7-bank-project/4-state-management/README.md) | یوهان | -| ۲۵ | [کد مرورگر/وی اس کد](../../8-code-editor) | کار با وی اس کد | یادگیری نحوه استفاده از یک ویرایشگر کد | [استفاده از ویرایشگر کد وی اس کد](./8-code-editor/1-using-a-code-editor/README.md) | کریس | -| ۲۶ | [دستیاران هوش مصنوعی](./9-chat-project/README.md) | کار با هوش مصنوعی | یادگیری ساخت دستیار هوش مصنوعی خود | [پروژه دستیار هوش مصنوعی](./9-chat-project/README.md) | کریس | +> **یادداشتی درباره آزمون‌ها**: تمام آزمون‌ها در پوشه Quiz-app قرار دارند، مجموعاً ۴۸ آزمون هر کدام شامل سه سوال. آنها در [اینجا](https://ff-quizzes.netlify.app/web/) قابل دسترسی هستند؛ برنامه آزمون را می‌توان به صورت محلی اجرا کرد یا در Azure مستقر نمود؛ دستورالعمل‌ها را در پوشه `quiz-app` دنبال کنید. + +## 🗃️ درس‌ها + +| | نام پروژه | مفاهیم آموزش داده شده | اهداف یادگیری | درس مرتبط | نویسنده | +| :-: | :----------------------------------------------------: | :------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------: | :---------------------: | +| ۰۱ | شروع به کار | مقدمه‌ای بر برنامه‌نویسی و ابزارهای مرتبط | یادگیری اصول پایه اکثر زبان‌های برنامه‌نویسی و نرم‌افزاری که به توسعه‌دهندگان حرفه‌ای کمک می‌کند وظایف خود را انجام دهند | [مقدمه بر زبان‌های برنامه‌نویسی و ابزارها](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| ۰۲ | شروع به کار | اصول گیت‌هاب، شامل کار تیمی | نحوه استفاده از گیت‌هاب در پروژه خود، نحوه همکاری با دیگران روی یک کد | [مقدمه بر گیت‌هاب](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| ۰۳ | شروع به کار | دسترسی‌پذیری | یادگیری اصول دسترسی‌پذیری وب | [مبانی دسترسی‌پذیری](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| ۰۴ | مفاهیم پایه JS | انواع داده در جاوااسکریپت | اصول انواع داده در جاوااسکریپت | [انواع داده](./2-js-basics/1-data-types/README.md) | Jasmine | +| ۰۵ | مفاهیم پایه JS | توابع و متدها | آموزش توابع و متدها برای مدیریت جریان منطق برنامه | [توابع و متدها](./2-js-basics/2-functions-methods/README.md) | Jasmine and Christopher | +| ۰۶ | مفاهیم پایه JS | گرفتن تصمیم با JS | یادگیری ایجاد شرایط در کد با استفاده از روش‌های تصمیم‌گیری | [گرفتن تصمیم](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| ۰۷ | مفاهیم پایه JS | آرایه‌ها و حلقه‌ها | کار با داده‌ها با استفاده از آرایه‌ها و حلقه‌ها در جاوااسکریپت | [آرایه‌ها و حلقه‌ها](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| ۰۸ | [تراریوم](./3-terrarium/solution/README.md) | HTML در عمل | ساخت HTML برای ایجاد یک تراریوم آنلاین، تمرکز بر ساختار صفحه | [مقدمه‌ای بر HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| ۰۹ | [تراریوم](./3-terrarium/solution/README.md) | CSS در عمل | ساخت CSS برای استایل دهی تراریوم آنلاین، تمرکز بر اصول CSS و ساخت صفحه واکنش‌گرا | [مقدمه‌ای بر CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| ۱۰ | [تراریوم](./3-terrarium/solution/README.md) | کلوزرهای جاوااسکریپت، دستکاری DOM | ساخت جاوااسکریپت برای ایجاد رابط کشیدن و رها کردن در تراریوم، تمرکز بر کلوزرها و دستکاری DOM | [کلوزرهای جاوااسکریپت، دستکاری DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| ۱۱ | [بازی تایپ](./4-typing-game/solution/README.md) | ساخت بازی تایپ | یادگیری استفاده از رویدادهای کیبورد برای مدیریت منطق برنامه جاوااسکریپت | [برنامه‌نویسی رویداد محور](./4-typing-game/typing-game/README.md) | Christopher | +| ۱۲ | [افزونه مرورگر سبز](./5-browser-extension/solution/README.md) | کار با مرورگرها | یادگیری طرز کار مرورگرها، تاریخچه آنها و ساختار اولیه افزونه مرورگر | [درباره مرورگرها](./5-browser-extension/1-about-browsers/README.md) | Jen | +| ۱۳ | [افزونه مرورگر سبز](./5-browser-extension/solution/README.md) | ساخت فرم، فراخوانی API و ذخیره متغیرها در ذخیره محلی | ساخت المان‌های جاوااسکریپت در افزونه مرورگر برای فراخوانی API با استفاده از متغیرهای ذخیره شده در ذخیره محلی | [APIها، فرم‌ها و ذخیره محلی](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| ۱۴ | [افزونه مرورگر سبز](./5-browser-extension/solution/README.md) | فرایندهای پس‌زمینه در مرورگر، بهینه‌سازی وب | استفاده از فرایندهای پس‌زمینه مرورگر برای مدیریت آیکون افزونه؛ یادگیری درباره عملکرد وب و بهینه‌سازی‌های مربوطه | [فرایندهای پس‌زمینه و عملکرد](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| ۱۵ | [بازی فضایی](./6-space-game/solution/README.md) | توسعه پیشرفته بازی با جاوااسکریپت | یادگیری وراثت با استفاده از کلاس‌ها و ترکیب و الگوی Pub/Sub، برای آمادگی ساخت بازی | [مقدمه‌ای بر توسعه پیشرفته بازی](./6-space-game/1-introduction/README.md) | Chris | +| ۱۶ | [بازی فضایی](./6-space-game/solution/README.md) | رسم روی بوم | آشنایی با API بوم که برای رسم اجزا روی صفحه استفاده می‌شود | [رسم روی بوم](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| ۱۷ | [بازی فضایی](./6-space-game/solution/README.md) | حرکت دادن اجزا روی صفحه | کشف نحوه حرکت اجزا با استفاده از مختصات کارتزین و API بوم | [حرکت دادن اجزا](./6-space-game/3-moving-elements-around/README.md) | Chris | +| ۱۸ | [بازی فضایی](./6-space-game/solution/README.md) | تشخیص برخورد | ایجاد برخورد بین اجزا و واکنش به هم با کلیدهای فشرده شده و فراهم‌سازی عملکرد خنک‌کننده برای تضمین اجرای صحیح بازی | [تشخیص برخورد](./6-space-game/4-collision-detection/README.md) | Chris | +| ۱۹ | [بازی فضایی](./6-space-game/solution/README.md) | نگهداری امتیاز | انجام محاسبات ریاضی براساس وضعیت و عملکرد بازی | [نگهداری امتیاز](./6-space-game/5-keeping-score/README.md) | Chris | +| ۲۰ | [بازی فضایی](./6-space-game/solution/README.md) | پایان و راه‌اندازی مجدد بازی | آشنایی با پایان و راه‌اندازی مجدد بازی، شامل پاک‌سازی منابع و بازنشانی متغیرها | [شرط پایان](./6-space-game/6-end-condition/README.md) | Chris | +| ۲۱ | [اپ بانکداری](./7-bank-project/solution/README.md) | قالب‌ها و مسیرها در اپ وب | یادگیری ایجاد چارچوب معماری یک وب‌سایت چند صفحه‌ای با استفاده از مسیرها و قالب‌های HTML | [قالب‌ها و مسیرهای HTML](./7-bank-project/1-template-route/README.md) | Yohan | +| ۲۲ | [اپ بانکداری](./7-bank-project/solution/README.md) | ساخت فرم ورود و ثبت نام | یادگیری ساخت فرم‌ها و مدیریت اعتبارسنجی | [فرم‌ها](./7-bank-project/2-forms/README.md) | Yohan | +| ۲۳ | [اپ بانکداری](./7-bank-project/solution/README.md) | روش‌های واکشی و استفاده از داده | نحوه جریان داده‌ها در اپلیکیشن، نحوه واکشی، ذخیره‌سازی و حذف آنها | [داده‌ها](./7-bank-project/3-data/README.md) | Yohan | +| ۲۴ | [اپ بانکداری](./7-bank-project/solution/README.md) | مفاهیم مدیریت وضعیت | یادگیری اینکه اپ چگونه وضعیت را حفظ می‌کند و چطور می‌توان آن را به صورت برنامه‌ای مدیریت کرد | [مدیریت وضعیت](./7-bank-project/4-state-management/README.md) | Yohan | +| ۲۵ | [کد مرورگر/وی‌اس‌کد](../../8-code-editor) | کار با وی‌اس‌کد | یادگیری استفاده از ویرایشگر کد | [استفاده از ویرایشگر کد وی‌اس‌کد](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| ۲۶ | [دستیارهای هوش مصنوعی](./9-chat-project/README.md) | کار با هوش مصنوعی | یادگیری ساخت دستیار هوش مصنوعی خود | [پروژه دستیار هوش مصنوعی](./9-chat-project/README.md) | Chris | ## 🏫 روش تدریس -برنامه درسی ما با در نظر گرفتن دو اصل کلیدی آموزشی طراحی شده است: -* یادگیری مبتنی بر پروژه +برنامه آموزشی ما بر اساس دو اصل کلیدی آموزشی طراحی شده است: +* یادگیری مبتنی بر پروژه * آزمون‌های مکرر -این برنامه اصول جاوااسکریپت، HTML و CSS را به همراه جدیدترین ابزارها و تکنیک‌های مورد استفاده توسعه‌دهندگان وب امروز آموزش می‌دهد. دانش‌آموزان فرصت خواهند داشت با ساخت بازی تایپینگ، تراریوم مجازی، افزونه مرورگر سازگار با محیط زیست، بازی سبک مهاجم فضایی و اپلیکیشن بانکی برای کسب‌وکارها، تجربه عملی کسب کنند. تا پایان این مجموعه، دانش‌آموزان درک محکمی از توسعه وب به‌دست خواهند آورد. +این برنامه اصول جاوااسکریپت، HTML و CSS و همچنین جدیدترین ابزارها و تکنیک‌های مورد استفاده توسعه‌دهندگان وب امروزی را آموزش می‌دهد. دانش‌آموزان فرصت خواهند داشت با ساختن بازی تایپ، تراریوم مجازی، افزونه مرورگر دوستدار محیط‌زیست، بازی سبک مهاجم فضایی و اپ بانکداری برای کسب‌وکارها، تجربه عملی کسب کنند. تا پایان این مجموعه، دانش‌آموزان درک خوبی از توسعه وب پیدا خواهند کرد. -> 🎓 شما می‌توانید چند درس اول این برنامه درسی را به‌عنوان [مسیر یادگیری](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) در مایکروسافت لرن دنبال کنید! +> 🎓 می‌توانید چند درس اول این برنامه آموزشی را به عنوان یک [مسیر یادگیری](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) در مایکروسافت لرن دنبال کنید! -با اطمینان از همسویی محتوا با پروژه‌ها، فرایند برای دانش‌آموزان جذاب‌تر شده و یادگیری مفاهیم بهتر حفظ می‌شود. همچنین، چند درس شروع‌کننده در پایه‌های جاوااسکریپت نوشته‌ایم تا مفاهیم را معرفی کنیم، به همراه ویدیویی از مجموعه آموزشی "[سری مبتدیان به: جاوااسکریپت](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)" برخی نویسندگان آن در این برنامه مشارکت داشته‌اند. +با اطمینان از تطابق محتوا با پروژه‌ها، فرآیند یادگیری برای دانش‌آموزان جذاب‌تر می‌شود و حفظ مفاهیم افزایش می‌یابد. همچنین چند درس ابتدایی در مبانی جاوااسکریپت برای معرفی مفاهیم همراه با ویدیویی از مجموعه "[سری مقدماتی به: جاوااسکریپت](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)"، که برخی نویسندگان آن در این برنامه همکاری کرده‌اند، نوشته شده است. -علاوه بر این، یک آزمون کم‌فشار پیش از کلاس، هدف‌گذاری دانش‌آموزان را برای یادگیری موضوع تنظیم می‌کند و آزمون دوم پس از کلاس باعث حفظ بیشتر مطلب می‌شود. این برنامه درسی به گونه‌ای طراحی شده که انعطاف‌پذیر و سرگرم‌کننده باشد و می‌توان آن را به‌طور کامل یا بخشی از آن را گذراند. پروژه‌ها از سطح ساده آغاز شده و در انتهای دوره ۱۲ هفته‌ای به مرور پیچیده‌تر می‌شوند. +علاوه بر این، آزمون کم‌فشار پیش از کلاس هدف دانش‌آموز را به سمت یادگیری موضوع مشخص می‌کند و آزمون دوم پس از کلاس تضمین‌کننده حفظ بیشتر است. این برنامه آموزشی طراحی شده تا انعطاف‌پذیر و سرگرم‌کننده باشد و می‌توان آن را به طور کامل یا جزئی گذراند. پروژه‌ها کوچک شروع شده و تا پایان سیکل ۱۲ هفته‌ای پیچیده‌تر می‌شوند. -در حالی که آگاهانه از معرفی فریمورک‌های جاوااسکریپت اجتناب کرده‌ایم تا بر مهارت‌های پایه‌ای لازم برای توسعه‌دهنده وب تمرکز کنیم قبل از پذیرش یک فریمورک، گام بعدی مناسب برای تکمیل این برنامه یادگیری Node.js از طریق مجموعه ویدیوهای دیگر است: "[سری مبتدیان به: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +در حالی که عمداً از معرفی چارچوب‌های جاوااسکریپت خودداری کرده‌ایم تا بر مهارت‌های پایه لازم برای توسعه‌دهنده وب قبل از استفاده از چارچوب تمرکز کنیم، قدم بعدی مناسب پس از تکمیل این دوره می‌تواند یادگیری Node.js از طریق مجموعه دیگری از ویدیوها باشد: "[سری مقدماتی به: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> از [کد رفتار](CODE_OF_CONDUCT.md) و [راهنمای مشارکت](CONTRIBUTING.md) ما دیدن کنید. بازخورد سازنده شما را خوشامد می‌گوییم! +> راهنمای [رفتار حرفه‌ای](CODE_OF_CONDUCT.md) و [همکاری](CONTRIBUTING.md) ما را ببینید. بازخورد سازنده شما را خوش‌آمد می‌گوییم! ## 🧭 دسترسی آفلاین -شما می‌توانید این مستندات را به صورت آفلاین با استفاده از [Docsify](https://docsify.js.org/#/) اجرا کنید. این مخزن را فورک کنید، [Docsify را نصب کنید](https://docsify.js.org/#/quickstart) روی دستگاه محلی خود، و سپس در پوشه ریشه این مخزن دستور `docsify serve` را وارد نمایید. وب‌سایت روی پورت ۳۰۰۰ در لوکال‌هاست شما قابل دسترس خواهد بود: `localhost:3000`. +می‌توانید این مستندات را به صورت آفلاین با استفاده از [Docsify](https://docsify.js.org/#/) اجرا کنید. این مخزن را فورک کنید، [Docsify را نصب کنید](https://docsify.js.org/#/quickstart) روی دستگاه خود، سپس در پوشه اصلی این مخزن فرمان `docsify serve` را وارد کنید. وب‌سایت روی پورت ۳۰۰۰ در لوکال‌هاست شما ارائه می‌شود: `localhost:3000`. ## 📘 PDF -یک فایل PDF از تمام دروس را می‌توانید [در اینجا](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf) بیابید. +نسخه PDF همه دروس را می‌توانید [از اینجا](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf) بیابید. ## 🎒 دوره‌های دیگر -تیم ما دوره‌های دیگری هم تولید می‌کند! نگاهی بیندازید به: +تیم ما دوره‌های دیگری هم تولید می‌کند! مشاهده کنید: ### LangChain [![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) [![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain for Beginners](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- ### Azure / Edge / MCP / Agents @@ -221,7 +221,7 @@ --- -### سری هوش مصنوعی مولد +### Generative AI Series [![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) [![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) [![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) @@ -229,7 +229,7 @@ --- -### آموزش پایه‌ای +### Core Learning [![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) [![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) [![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) @@ -240,7 +240,7 @@ --- -### سری کوپایلوت +### Copilot Series [![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) [![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) [![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) @@ -248,21 +248,21 @@ ## دریافت کمک -اگر گیر کردید یا سوالی درباره ساخت برنامه‌های هوش مصنوعی داشتید، به دیگر یادگیرندگان و توسعه‌دهندگان باتجربه در بحث‌های مربوط به MCP بپیوندید. این یک جامعه حمایتی است که در آن سوالات پذیرفته شده و دانش به صورت آزاد به اشتراک گذاشته می‌شود. +اگر گیر افتادید یا سوالی درباره ساخت برنامه‌های هوش مصنوعی دارید، به بحث‌ها در مورد MCP با یادگیرندگان و توسعه‌دهندگان با تجربه بپیوندید. این یک جامعه حمایتی است که سوالات استقبال می‌شود و دانش به صورت آزادانه به اشتراک گذاشته می‌شود. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -اگر بازخورد محصول یا خطایی هنگام ساخت دارید، مراجعه کنید به: +اگر بازخورد محصول دارید یا هنگام ساخت با خطا مواجه شدید به آدرس زیر مراجعه کنید: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ## مجوز -این مخزن تحت مجوز MIT است. برای اطلاعات بیشتر به فایل [LICENSE](../../LICENSE) مراجعه کنید. +این مخزن تحت مجوز MIT منتشر شده است. برای اطلاعات بیشتر به فایل [LICENSE](../../LICENSE) مراجعه کنید. --- -**توضیح مهم**: -این سند با استفاده از خدمات ترجمه هوش مصنوعی [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/fa/Roadmap.md b/translations/fa/Roadmap.md new file mode 100644 index 000000000..76a3c3baf --- /dev/null +++ b/translations/fa/Roadmap.md @@ -0,0 +1,53 @@ +# نقشه راه مخزن Web-Dev-For-Beginners مایکروسافت + +**این مخزن نقشه راهی برای یادگیری اصول توسعه وب با تمرکز بر جاوااسکریپت، HTML و CSS فراهم می‌کند. برنامه درسی انعطاف‌پذیر است و می‌توان آن را به صورت کامل یا بخشی از آن را طی کرد، با ۲۴ درس که در طول ۱۲ هفته پراکنده شده‌اند.** + +## نقاط عطف کلیدی + +* **هفته‌های ۱-۳:** + * مقدمه‌ای بر زبان‌های برنامه‌نویسی و ابزارهای کار + * اصول اولیه GitHub + * قابلیت دسترسی + * مبانی JS: انواع داده، توابع و متدها + * گرفتن تصمیمات با JS +* **هفته‌های ۴-۶:** + * آرایه‌ها و حلقه‌ها + * تراریوم: HTML در عمل + * CSS در عمل + * کلوژرهای جاوااسکریپت + * کار با DOM +* **هفته‌های ۷-۹:** + * بازی تایپ کردن: برنامه‌نویسی مبتنی بر رویداد + * افزونه مرورگر سبز: کار با مرورگرها + * ساخت فرم، فراخوانی API و ذخیره متغیرها در فضای محلی + * فرآیندهای پس‌زمینه در مرورگر + * عملکرد وب +* **هفته‌های ۱۰-۱۲:** + * بازی فضایی: توسعه بازی پیشرفته‌تر با جاوااسکریپت + * ترسیم روی بوم + * حرکت دادن عناصر در صفحه + * تشخیص برخورد + * نگه داشتن امتیاز، پایان و راه‌اندازی مجدد بازی + * اپلیکیشن بانکی: قالب‌های HTML و مسیرها در یک اپ وب + * ساخت فرم ورود و ثبت‌نام + * روش‌های واکشی و استفاده از داده‌ها + * مفاهیم مدیریت وضعیت + +## نتایج یادگیری + +**با پایان این نقشه راه، دانشجویان تجربه عملی در ساخت بازی تایپ کردن، تراریوم مجازی، افزونه مرورگر دوستدار محیط زیست، بازی سبک space-invader و اپلیکیشن بانکی برای کسب‌وکارها کسب خواهند کرد. همچنین درک محکمی از اصول توسعه وب به دست خواهند آورد.** + +## منابع اضافی + +* این مخزن منبع غنی‌ای برای یادگیری بیشتر فراهم می‌کند، شامل آموزش‌ها، مثال‌های کدنویسی و چالش‌ها. +* پلتفرم Microsoft Learn دوره‌ها و مسیرهای مختلفی برای توسعه وب ارائه می‌دهد. +* جوامع آنلاین مانند Stack Overflow و MDN Web Docs پشتیبانی و منابع ارزشمندی برای توسعه‌دهندگان وب فراهم می‌کنند. + +**امیدوارم این نقشه راه به شما در مسیر توسعه وب کمک کند!** + +--- + + +**سلب مسئولیت**: +این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما برای دقت تلاش می‌کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است حاوی خطاها یا نادرستی‌هایی باشند. سند اصلی در زبان بومی خود به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، توصیه می‌شود از ترجمه حرفه‌ای انسانی استفاده کنید. ما مسئول هیچ گونه سوءتفاهم یا تفسیر نادرست ناشی از استفاده از این ترجمه نیستیم. + \ No newline at end of file diff --git a/translations/ru/.co-op-translator.json b/translations/ru/.co-op-translator.json index a52d64b44..8b04da455 100644 --- a/translations/ru/.co-op-translator.json +++ b/translations/ru/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2025-10-03T11:14:06+00:00", + "translation_date": "2026-02-06T15:57:30+00:00", "source_file": "AGENTS.md", "language_code": "ru" }, @@ -516,11 +516,17 @@ "language_code": "ru" }, "README.md": { - "original_hash": "490c83786552d7fab6390991517bef09", - "translation_date": "2026-01-29T17:36:01+00:00", + "original_hash": "6d6385fd098088cb2d690fb0a6cdaedc", + "translation_date": "2026-02-06T15:50:50+00:00", "source_file": "README.md", "language_code": "ru" }, + "Roadmap.md": { + "original_hash": "28bf6185fd7f27b62ddc210514366192", + "translation_date": "2026-02-06T15:55:48+00:00", + "source_file": "Roadmap.md", + "language_code": "ru" + }, "SECURITY.md": { "original_hash": "4ecc3bf2e27983d4c780be6f26ee6228", "translation_date": "2025-08-25T20:59:48+00:00", diff --git a/translations/ru/AGENTS.md b/translations/ru/AGENTS.md index 2d2b5a47c..b90184e53 100644 --- a/translations/ru/AGENTS.md +++ b/translations/ru/AGENTS.md @@ -2,27 +2,27 @@ ## Обзор проекта -Это репозиторий образовательной программы для обучения основам веб-разработки для начинающих. Программа представляет собой комплексный 12-недельный курс, разработанный Microsoft Cloud Advocates, и включает 24 практических урока, охватывающих JavaScript, CSS и HTML. +Это репозиторий учебной программы для обучения основам веб-разработки для начинающих. Учебная программа представляет собой всесторонний 12-недельный курс, разработанный командой Microsoft Cloud Advocates, включающий 24 практических урока, охватывающих JavaScript, CSS и HTML. -### Основные компоненты +### Ключевые компоненты -- **Образовательный контент**: 24 структурированных урока, организованных в проектные модули -- **Практические проекты**: Террариум, Игра на скорость набора текста, Расширение для браузера, Космическая игра, Банковское приложение, Редактор кода и AI-чат-ассистент -- **Интерактивные викторины**: 48 викторин по 3 вопроса каждая (оценка до и после урока) -- **Поддержка нескольких языков**: Автоматический перевод на более чем 50 языков с помощью GitHub Actions -- **Технологии**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI-проектов) +- **Образовательный контент**: 24 структурированных урока, организованных в модули на основе проектов +- **Практические проекты**: Террариум, Игра на скорость печати, Расширение для браузера, Космическая игра, Банковское приложение, Редактор кода и AI чат-ассистент +- **Интерактивные викторины**: 48 викторин с 3 вопросами каждая (оценка до и после урока) +- **Многоязычная поддержка**: Автоматические переводы на 50+ языков с помощью GitHub Actions +- **Технологии**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI проектов) ### Архитектура -- Образовательный репозиторий с уроками, организованными по структуре +- Образовательный репозиторий с уроковой структурой - Каждая папка урока содержит README, примеры кода и решения - Отдельные проекты в отдельных директориях (quiz-app, различные проекты уроков) - Система перевода с использованием GitHub Actions (co-op-translator) -- Документация предоставляется через Docsify и доступна в формате PDF +- Документация подается через Docsify и доступна в формате PDF ## Команды для настройки -Этот репозиторий предназначен в первую очередь для потребления образовательного контента. Для работы с конкретными проектами: +Этот репозиторий предназначен в основном для изучения образовательного контента. Для работы с конкретными проектами: ### Настройка основного репозитория @@ -31,24 +31,24 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Настройка приложения викторин (Vue 3 + Vite) +### Настройка Quiz App (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Start development server -npm run build # Build for production -npm run lint # Run ESLint +npm run dev # Запустить сервер разработки +npm run build # Сборка для продакшена +npm run lint # Запустить ESLint ``` -### API для банковского проекта (Node.js + Express) +### Bank Project API (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Start API server -npm run lint # Run ESLint -npm run format # Format with Prettier +npm start # Запустить сервер API +npm run lint # Запустить ESLint +npm run format # Отформатировать с помощью Prettier ``` ### Проекты расширений для браузера @@ -56,7 +56,7 @@ npm run format # Format with Prettier ```bash cd 5-browser-extension/solution npm install -# Follow browser-specific extension loading instructions +# Следуйте инструкциям по загрузке расширений для конкретного браузера ``` ### Проекты космической игры @@ -64,163 +64,163 @@ npm install ```bash cd 6-space-game/solution npm install -# Open index.html in browser or use Live Server +# Откройте index.html в браузере или используйте Live Server ``` -### Проект чата (Python Backend) +### Чат-проект (бэкенд на Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable +# Установите переменную окружения GITHUB_TOKEN python api.py ``` ## Рабочий процесс разработки -### Для контрибьюторов контента +### Для авторов контента -1. **Сделайте форк репозитория** в свой аккаунт GitHub -2. **Клонируйте свой форк** локально +1. **Сделайте fork репозитория** в свой аккаунт GitHub +2. **Клонируйте ваш fork** локально 3. **Создайте новую ветку** для ваших изменений -4. Внесите изменения в контент уроков или примеры кода -5. Протестируйте изменения кода в соответствующих директориях проектов -6. Отправьте pull request, следуя руководству по внесению изменений +4. Внесите изменения в учебный контент или примеры кода +5. Тестируйте любые изменения кода в соответствующих каталогах проектов +6. Отправляйте pull request согласно правилам вклада -### Для учащихся +### Для обучающихся -1. Сделайте форк или клонируйте репозиторий -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) -- **Приложение викторин**: Запустите `npm run dev` в директории quiz-app -- **Проекты**: Используйте расширение Live Server в VS Code для HTML-проектов -- **API-проекты**: Запустите `npm start` в соответствующих директориях API +- **Документация**: Запустите `docsify serve` в корне (порт 3000) +- **Quiz App**: Запустите `npm run dev` в директории quiz-app +- **Проекты**: Используйте расширение Live Server в VS Code для HTML проектов +- **API проекты**: Запустите `npm start` в соответствующих API директориях ## Инструкции по тестированию -### Тестирование приложения викторин +### Тестирование Quiz App ```bash cd quiz-app -npm run lint # Check for code style issues -npm run build # Verify build succeeds +npm run lint # Проверить проблемы со стилем кода +npm run build # Проверить успешность сборки ``` -### Тестирование API для банка +### Тестирование Bank API ```bash cd 7-bank-project/api -npm run lint # Check for code style issues -node server.js # Verify server starts without errors +npm run lint # Проверить наличие проблем со стилем кода +node server.js # Проверить, что сервер запускается без ошибок ``` ### Общий подход к тестированию -- Это образовательный репозиторий без полного набора автоматических тестов -- Ручное тестирование включает: - - Проверку выполнения примеров кода без ошибок - - Проверку работы ссылок в документации - - Успешную сборку проектов - - Соответствие примеров лучшим практикам +- Это образовательный репозиторий без комплексных автоматизированных тестов +- Ручное тестирование сосредоточено на: + - Запуске примеров кода без ошибок + - Работе ссылок в документации + - Успешном завершении сборки проектов + - Следовании примеров лучшим практикам ### Проверки перед отправкой -- Запустите `npm run lint` в директориях с package.json -- Убедитесь, что ссылки в markdown корректны -- Протестируйте примеры кода в браузере или Node.js -- Проверьте, что структура переводов сохранена +- Запустите `npm run lint` в папках с package.json +- Проверьте валидность ссылок в markdown +- Тестируйте примеры кода в браузере или Node.js +- Убедитесь, что переводы сохраняют правильную структуру ## Руководство по стилю кода ### JavaScript - Используйте современный синтаксис ES6+ -- Следуйте стандартным конфигурациям ESLint, предоставленным в проектах +- Следуйте стандартным конфигурациям ESLint в проектах - Используйте осмысленные имена переменных и функций для образовательной ясности -- Добавляйте комментарии для объяснения концепций учащимся -- Форматируйте код с помощью Prettier, если он настроен +- Добавляйте комментарии, объясняющие концепции для учеников +- Форматируйте с помощью Prettier, где настроено ### HTML/CSS - Семантические элементы HTML5 - Принципы адаптивного дизайна -- Понятные соглашения по именованию классов -- Комментарии для объяснения CSS-техник учащимся +- Чёткие соглашения по именованию классов +- Комментарии, объясняющие CSS техники для обучения ### Python - Руководство по стилю PEP 8 -- Понятные, образовательные примеры кода -- Подсказки типов, где это полезно для обучения +- Чистые, образовательные примеры кода +- Подсказки типов там, где помогают обучению -### Документация в Markdown +### Документация Markdown -- Четкая иерархия заголовков +- Чёткая иерархия заголовков - Блоки кода с указанием языка - Ссылки на дополнительные ресурсы -- Скриншоты и изображения в директориях `images/` -- Альтернативный текст для изображений для доступности +- Скриншоты и изображения в каталогах `images/` +- Alt-текст для изображений для доступности ### Организация файлов - Уроки пронумерованы последовательно (1-getting-started-lessons, 2-js-basics и т.д.) -- Каждый проект имеет директории `solution/` и часто `start/` или `your-work/` -- Изображения хранятся в папках `images/`, относящихся к конкретным урокам -- Переводы находятся в структуре `translations/{language-code}/` +- Каждый проект имеет папки `solution/` и часто `start/` или `your-work/` +- Изображения хранятся в папках `images/` конкретных уроков +- Переводы в структуре `translations/{language-code}/` ## Сборка и развертывание -### Развертывание приложения викторин (Azure Static Web Apps) +### Развертывание Quiz App (Azure Static Web Apps) Приложение quiz-app настроено для развертывания в Azure Static Web Apps: ```bash cd quiz-app -npm run build # Creates dist/ folder -# Deploys via GitHub Actions workflow on push to main +npm run build # Создает папку dist/ +# Выполняет развертывание через рабочий процесс GitHub Actions при пуше в main ``` Конфигурация Azure Static Web Apps: - **Расположение приложения**: `/quiz-app` -- **Расположение выходных данных**: `dist` +- **Расположение вывода**: `dist` - **Рабочий процесс**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Генерация документации в формате PDF +### Генерация PDF документации ```bash -npm install # Install docsify-to-pdf -npm run convert # Generate PDF from docs +npm install # Установить docsify-to-pdf +npm run convert # Сгенерировать PDF из docs ``` ### Документация Docsify ```bash -npm install -g docsify-cli # Install Docsify globally -docsify serve # Serve on localhost:3000 +npm install -g docsify-cli # Установите Docsify глобально +docsify serve # Запустить на localhost:3000 ``` -### Сборка для конкретных проектов +### Сборки по проектам Каждая директория проекта может иметь собственный процесс сборки: -- Проекты на Vue: `npm run build` создает производственные сборки -- Статические проекты: Сборка не требуется, файлы можно использовать напрямую +- Vue проекты: `npm run build` создаёт production сборки +- Статические проекты: Без шага сборки, файлы подаются напрямую -## Руководство по Pull Request +## Правила Pull Request -### Формат заголовков +### Формат заголовка -Используйте четкие, описательные заголовки, указывающие область изменений: +Используйте ясные, описательные заголовки, указывающие область изменений: - `[Quiz-app] Добавить новую викторину для урока X` - `[Lesson-3] Исправить опечатку в проекте террариума` -- `[Translation] Добавить перевод на испанский для урока 5` +- `[Translation] Добавить испанский перевод для урока 5` - `[Docs] Обновить инструкции по настройке` ### Обязательные проверки @@ -228,55 +228,55 @@ docsify serve # Serve on localhost:3000 Перед отправкой PR: 1. **Качество кода**: - - Запустите `npm run lint` в затронутых директориях проекта - - Исправьте все ошибки и предупреждения линтинга + - Запустите `npm run lint` в затронутых директориях проектов + - Исправьте все ошибки и предупреждения линтера 2. **Проверка сборки**: - - Запустите `npm run build`, если применимо - - Убедитесь в отсутствии ошибок сборки + - Запустите `npm run build` если применимо + - Убедитесь, что нет ошибок сборки 3. **Проверка ссылок**: - - Проверьте все ссылки в markdown + - Проверьте все markdown ссылки - Убедитесь, что ссылки на изображения работают -4. **Рецензия контента**: - - Проверьте орфографию и грамматику +4. **Проверка контента**: + - Вычитайте орфографию и грамматику - Убедитесь, что примеры кода корректны и образовательны - - Проверьте, что переводы сохраняют исходный смысл + - Проверьте, что переводы сохраняют оригинальный смысл -### Требования к контрибьюторам +### Требования к вкладу - Согласие с Microsoft CLA (автоматическая проверка при первом PR) -- Следование [Кодексу поведения Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/) -- См. [CONTRIBUTING.md](./CONTRIBUTING.md) для подробных инструкций -- Укажите номера задач в описании PR, если применимо +- Следование [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Смотрите подробные инструкции в [CONTRIBUTING.md](./CONTRIBUTING.md) +- Укажите номера issues в описании PR, если применимо -### Процесс рецензии +### Процесс ревью -- PR рецензируются мейнтейнерами и сообществом -- Приоритет отдается образовательной ясности -- Примеры кода должны соответствовать современным лучшим практикам -- Переводы проверяются на точность и культурную уместность +- PR проверяются ответственными и сообществом +- Приоритет — образовательная ясность +- Примеры кода должны соответствовать действующим лучшим практикам +- Переводы проверяются на точность и культурную адекватность ## Система перевода ### Автоматический перевод -- Использует GitHub Actions с рабочим процессом co-op-translator -- Автоматически переводит на более чем 50 языков -- Исходные файлы находятся в основных директориях -- Переведенные файлы находятся в директориях `translations/{language-code}/` +- Использует GitHub Actions с workflow co-op-translator +- Автоматический перевод на 50+ языков +- Исходные файлы в главных каталогах +- Переведённые файлы в каталогах `translations/{language-code}/` -### Добавление улучшений в переводы вручную +### Добавление ручных улучшений перевода 1. Найдите файл в `translations/{language-code}/` 2. Внесите улучшения, сохраняя структуру -3. Убедитесь, что примеры кода остаются функциональными -4. Протестируйте локализованный контент викторин +3. Убедитесь, что примеры кода остаются работоспособными +4. Проверьте любой локализованный викторинный контент ### Метаданные перевода -Переведенные файлы включают заголовок метаданных: +Переведённые файлы включают заголовок с метаданными: ```markdown **Отказ от ответственности**: -Этот документ был переведен с использованием сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия обеспечить точность, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода. \ No newline at end of file +Этот документ был переведён с помощью сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия по обеспечению точности, просим учитывать, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для критически важной информации рекомендуется использовать профессиональный человеческий перевод. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода. + \ No newline at end of file diff --git a/translations/ru/README.md b/translations/ru/README.md index 6bc2d839e..f89a07076 100644 --- a/translations/ru/README.md +++ b/translations/ru/README.md @@ -2,7 +2,7 @@ [![GitHub contributors](https://img.shields.io/github/contributors/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/graphs/contributors/) [![GitHub issues](https://img.shields.io/github/issues/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/issues/) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/Web-Dev-For-Beginners.svg)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/pulls/) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![GitHub watchers](https://img.shields.io/github/watchers/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Watch&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/watchers/) [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-Beginners.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/network/) @@ -10,112 +10,112 @@ [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -# Веб-разработка для начинающих — учебный курс +# Веб-разработка для начинающих — Учебная программа -Изучите основы веб-разработки с помощью нашего 12-недельного всестороннего курса от Microsoft Cloud Advocates. Каждое из 24 занятий посвящено JavaScript, CSS и HTML через практические проекты, такие как террариумы, расширения браузера и космические игры. Участвуйте в викторинах, обсуждениях и практических заданиях. Повышайте свои навыки и оптимизируйте усвоение знаний с помощью нашей эффективной методики обучения на основе проектов. Начните свое путешествие в программировании уже сегодня! +Освойте основы веб-разработки с нашим 12-недельным комплексным курсом от Microsoft Cloud Advocates. Каждое из 24 занятий подробно изучает JavaScript, CSS и HTML через практические проекты, такие как террариумы, расширения для браузера и космические игры. Участвуйте в викторинах, обсуждениях и выполняйте практические задания. Повышайте свои навыки и оптимизируйте запоминание с помощью нашей эффективной проектно-ориентированной методики. Начните свой путь в программировании уже сегодня! Присоединяйтесь к сообществу Azure AI Foundry в Discord [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Следуйте этим шагам, чтобы начать использовать эти ресурсы: -1. **Форкните репозиторий**: нажмите [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) -2. **Клонируйте репозиторий**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -3. [**Присоединяйтесь к Azure AI Foundry Discord и встречайте экспертов и коллег-разработчиков**](https://discord.com/invite/ByRwuEEgH4) +Выполните следующие шаги, чтобы начать использовать эти ресурсы: +1. **Сделайте форк репозитория**: Нажмите [![GitHub forks](https://img.shields.io/github/forks/microsoft/Web-Dev-For-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/Web-Dev-For-Beginners/fork) +2. **Склонируйте репозиторий**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +3. [**Присоединяйтесь к Azure AI Foundry Discord и встречайтесь с экспертами и другими разработчиками**](https://discord.com/invite/ByRwuEEgH4) -### 🌐 Поддержка нескольких языков +### 🌐 Многоязычная поддержка #### Поддерживается через GitHub Action (автоматически и всегда актуально) -[Арабский](../ar/README.md) | [Бенгальский](../bn/README.md) | [Болгарский](../bg/README.md) | [Бирманский (Мьянма)](../my/README.md) | [Китайский (упрощённый)](../zh-CN/README.md) | [Китайский (традиционный, Гонконг)](../zh-HK/README.md) | [Китайский (традиционный, Макао)](../zh-MO/README.md) | [Китайский (традиционный, Тайвань)](../zh-TW/README.md) | [Хорватский](../hr/README.md) | [Чешский](../cs/README.md) | [Датский](../da/README.md) | [Нидерландский](../nl/README.md) | [Эстонский](../et/README.md) | [Финский](../fi/README.md) | [Французский](../fr/README.md) | [Немецкий](../de/README.md) | [Греческий](../el/README.md) | [Иврит](../he/README.md) | [Хинди](../hi/README.md) | [Венгерский](../hu/README.md) | [Индонезийский](../id/README.md) | [Итальянский](../it/README.md) | [Японский](../ja/README.md) | [Каннада](../kn/README.md) | [Корейский](../ko/README.md) | [Литовский](../lt/README.md) | [Малайский](../ms/README.md) | [Малаялам](../ml/README.md) | [Маратхи](../mr/README.md) | [Непальский](../ne/README.md) | [Нигерийский пиджин](../pcm/README.md) | [Норвежский](../no/README.md) | [Персидский (Фарси)](../fa/README.md) | [Польский](../pl/README.md) | [Португальский (Бразилия)](../pt-BR/README.md) | [Португальский (Португалия)](../pt-PT/README.md) | [Пенджаби (Гурмукхи)](../pa/README.md) | [Румынский](../ro/README.md) | [Русский](./README.md) | [Сербский (кириллица)](../sr/README.md) | [Словацкий](../sk/README.md) | [Словенский](../sl/README.md) | [Испанский](../es/README.md) | [Суахили](../sw/README.md) | [Шведский](../sv/README.md) | [Тагалог (филиппинский)](../tl/README.md) | [Тамильский](../ta/README.md) | [Телугу](../te/README.md) | [Тайский](../th/README.md) | [Турецкий](../tr/README.md) | [Украинский](../uk/README.md) | [Урду](../ur/README.md) | [Вьетнамский](../vi/README.md) +[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](./README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](../ta/README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md) > **Предпочитаете клонировать локально?** -> Этот репозиторий включает более 50 языковых переводов, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: +> Этот репозиторий включает более 50 переводов на разные языки, что значительно увеличивает размер загрузки. Чтобы клонировать без переводов, используйте sparse checkout: > ```bash > git clone --filter=blob:none --sparse https://github.com/microsoft/Web-Dev-For-Beginners.git > cd Web-Dev-For-Beginners > git sparse-checkout set --no-cone '/*' '!translations' '!translated_images' > ``` -> Это предоставит вам всё необходимое для прохождения курса с гораздо более быстрой загрузкой. +> Это даст вам всё необходимое для прохождения курса с гораздо более быстрой загрузкой. -**Если вы хотите добавить поддержку дополнительных языков, они перечислены [здесь](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** +**Если вы хотите, чтобы были добавлены дополнительные языки перевода, они перечислены [здесь](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)** [![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/microsoft/Web-Dev-For-Beginners) #### 🧑‍🎓 _Вы студент?_ -Посетите [**страницу Student Hub**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon), где вы найдете ресурсы для начинающих, студенческие пакеты и даже способы получения бесплатного ваучера на сертификат. Это страница, которую стоит добавить в закладки и периодически проверять, так как мы ежемесячно обновляем контент. +Посетите страницу [**Student Hub**](https://docs.microsoft.com/learn/student-hub/?WT.mc_id=academic-77807-sagibbon), где вы найдёте ресурсы для начинающих, студенческие наборы и даже способы получить бесплатный сертификат. Это страница, которую стоит добавить в закладки и периодически проверять, так как мы ежемесячно обновляем контент. -### 📣 Объявление — Новые задания в режиме GitHub Copilot Agent! +### 📣 Объявление — Новые задания GitHub Copilot Agent для выполнения! -Добавлено новое задание — найдите "GitHub Copilot Agent Challenge 🚀" в большинстве глав. Это новое задание, которое вы можете выполнить с использованием GitHub Copilot и режима Agent. Если вы еще не использовали режим Agent, он позволяет не только генерировать текст, но и создавать и редактировать файлы, выполнять команды и многое другое. +Добавлено новое задание, ищите «GitHub Copilot Agent Challenge 🚀» в большинстве разделов. Это новое задание для вас, используя GitHub Copilot и режим Agent. Если вы ранее не пользовались режимом Agent, он не только генерирует текст, но и может создавать и редактировать файлы, выполнять команды и многое другое. ### 📣 Объявление — _Новый проект с использованием генеративного ИИ_ -Добавлен новый проект AI Assistant, посмотрите [проект](./9-chat-project/README.md) +Недавно добавлен новый проект AI Assistant, посмотрите его [проект](./9-chat-project/README.md) -### 📣 Объявление — _Новый учебный курс_ по генеративному ИИ для JavaScript только что выпущен +### 📣 Объявление — _Новая учебная программа_ по генеративному ИИ для JavaScript только что выпущена -Не пропустите наш новый курс по генеративному ИИ! +Не пропустите нашу новую программу по генеративному ИИ! -Начать можно по ссылке: [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) +Начните по ссылке: [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course)! -![Background](../../translated_images/ru/background.148a8d43afde5730.webp) +![Фон](../../translated_images/ru/background.148a8d43afde5730.webp) -- Уроки, охватывающие всё от основ до RAG. -- Взаимодействуйте с историческими персонажами с помощью GenAI и нашего сопутствующего приложения. -- Весёлый и захватывающий нарратив, вы будете путешествовать во времени! +- Уроки от основ до RAG. +- Взаимодействуйте с историческими персонажами, используя GenAI и наше сопутствующее приложение. +- Веселый и увлекательный сюжет, вы будете путешествовать во времени! -![character](../../translated_images/ru/character.5c0dd8e067ffd693.webp) +![персонаж](../../translated_images/ru/character.5c0dd8e067ffd693.webp) -Каждый урок включает задание, проверку знаний и вызов, которые помогут вам освоить темы, такие как: -- Формулировка запросов и их оптимизация -- Создание текстовых и визуальных приложений +Каждый урок включает задание, проверку знаний и вызов, чтобы помочь вам изучать такие темы, как: +- Промптинг и инженерия промптов +- Создание приложений с текстом и изображениями - Поисковые приложения -Начать можно по ссылке: [https://aka.ms/genai-js-course](../../[https:/aka.ms/genai-js-course)! +Начните по ссылке: [https://aka.ms/genai-js-course](https://aka.ms/genai-js-course) ## 🌱 Начало работы -> **Учителя**, мы подготовили [рекомендации](for-teachers.md) по использованию этого учебного курса. Мы будем рады вашим отзывам [в нашем форуме обсуждений](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! +> **Учителя**, мы включили [некоторые предложения](for-teachers.md) по использованию этой учебной программы. Нам будет приятно получить ваши отзывы [в нашем форуме обсуждений](https://github.com/microsoft/Web-Dev-For-Beginners/discussions/categories/teacher-corner)! -**[Студенты](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, для каждого урока начните с предварительной викторины, затем читайте учебный материал, выполняйте различные задания и проверяйте свои знания с помощью итоговой викторины. +**[Студенты](https://aka.ms/student-page/?WT.mc_id=academic-77807-sagibbon)**, для каждого занятия начните с предварительной викторины, затем изучите учебный материал, выполните различные задания и проверьте свои знания после занятий с помощью пост-лекционной викторины. -Для улучшения вашего учебного опыта подключайтесь к вашим сокурсникам для совместной работы над проектами! Обсуждения приветствуются в нашем [форуме обсуждений](https://github.com/microsoft/Web-Dev-For-Beginners/discussions), где команда модераторов будет доступна для ответов на ваши вопросы. +Для улучшения опыта обучения подключайтесь к своим товарищам, чтобы работать над проектами вместе! Обсуждения приветствуются в нашем [форуме обсуждений](https://github.com/microsoft/Web-Dev-For-Beginners/discussions), где команда модераторов будет готова ответить на ваши вопросы. -Для дальнейшего обучения настоятельно рекомендуем изучить [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon) для получения дополнительных учебных материалов. +Для расширения знаний мы настоятельно рекомендуем изучать материалы на [Microsoft Learn](https://learn.microsoft.com/users/wirelesslife/collections/p1ddcy5jwy0jkm?WT.mc_id=academic-77807-sagibbon). ### 📋 Настройка вашей среды -В этом учебном курсе уже есть готовая среда разработки! На начальном этапе вы можете выбрать работу с курсом в [Codespace](https://github.com/features/codespaces/) (_браузерная среда без необходимости установки_), или локально на вашем компьютере с помощью текстового редактора, например, [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Эта учебная программа имеет готовую среду разработки! Начав, вы можете выбрать запуск курса в [Codespace](https://github.com/features/codespaces/) (_среда в браузере без необходимости установки_), или локально на вашем компьютере с использованием текстового редактора, например [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -#### Создайте ваш репозиторий -Чтобы легко сохранять свою работу, рекомендуем создать собственную копию этого репозитория. Вы можете сделать это, нажав кнопку **Use this template** вверху страницы. Это создаст новый репозиторий в вашем аккаунте GitHub с копией курса. +#### Создайте свой репозиторий +Для удобства сохранения своей работы рекомендуется создать собственную копию этого репозитория. Вы можете сделать это, нажав кнопку **Use this template** в верхней части страницы. Это создаст новый репозиторий в вашем аккаунте GitHub с копией учебной программы. Выполните следующие шаги: -1. **Форкните репозиторий**: нажмите кнопку "Fork" в правом верхнем углу этой страницы. -2. **Клонируйте репозиторий**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` +1. **Сделайте форк репозитория**: Нажмите кнопку "Fork" в правом верхнем углу этой страницы. +2. **Склонируйте репозиторий**: `git clone https://github.com/microsoft/Web-Dev-For-Beginners.git` -#### Запуск курса в Codespace +#### Запуск учебной программы в Codespace -В вашей копии этого репозитория, которую вы создали, нажмите кнопку **Code** и выберите **Open with Codespaces**. Это создаст для вас новый Codespace для работы. +В вашей копии этого репозитория нажмите кнопку **Code** и выберите **Open with Codespaces**. Это создаст новый Codespace для работы. ![Codespace](../../translated_images/ru/createcodespace.0238bbf4d7a8d955.webp) -#### Запуск курса локально на вашем компьютере +#### Запуск учебной программы локально на вашем компьютере -Для запуска этого курса локально вам потребуется текстовый редактор, браузер и инструмент командной строки. Наш первый урок, [Введение в языки программирования и инструменты разработки](../../1-getting-started-lessons/1-intro-to-programming-languages), расскажет вам о различных вариантах каждого из этих инструментов, чтобы вы могли выбрать наиболее подходящий. +Чтобы запустить учебную программу локально, вам понадобится текстовый редактор, браузер и инструмент командной строки. Наш первый урок, [Введение в языки программирования и инструменты](../../1-getting-started-lessons/1-intro-to-programming-languages), проведет вас по разным вариантам этих инструментов, чтобы вы выбрали наиболее подходящие. -Мы рекомендуем использовать [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) в качестве редактора, который также имеет встроенный [терминал](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon). Скачать Visual Studio Code можно [здесь](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). +Мы рекомендуем использовать [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) как редактор, который также имеет встроенный [терминал](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon). Вы можете скачать Visual Studio Code [здесь](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon). -1. Клонируйте свой репозиторий на компьютер. Сделать это можно, нажав кнопку **Code** и скопировав URL: +1. Склонируйте свой репозиторий на ваш компьютер. Для этого нажмите кнопку **Code** и скопируйте URL: [CodeSpace](./images/createcodespace.png) Затем откройте [Терминал](https://code.visualstudio.com/docs/terminal/basics/?WT.mc_id=academic-77807-sagibbon) в [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-77807-sagibbon) и выполните следующую команду, заменив `` на URL, который вы только что скопировали: @@ -124,146 +124,148 @@ git clone ``` -2. Откройте папку в Visual Studio Code. Для этого кликните **Файл** > **Открыть папку** и выберите папку, которую вы только что склонировали. +2. Откройте папку в Visual Studio Code. Вы можете сделать это, кликнув **Файл** > **Открыть папку** и выбрав только что клонированную папку. > Рекомендуемые расширения Visual Studio Code: > > * [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer&WT.mc_id=academic-77807-sagibbon) — для предварительного просмотра HTML-страниц в Visual Studio Code -> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) — для помощи в написании кода быстрее +> * [Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot&WT.mc_id=academic-77807-sagibbon) — для более быстрого написания кода -## 📂 В каждом уроке есть: +## 📂 Каждый урок включает: -- необязательная скетчноут +- необязательные скетчноуты - необязательное дополнительное видео -- разминка-квиз перед уроком +- разогревающий квиз перед уроком - письменный урок -- для проектных уроков — пошаговые инструкции по созданию проекта +- для уроков с проектами — пошаговые руководства по созданию проекта - проверки знаний -- задание +- челлендж - дополнительное чтение +- задание - [квиз после урока](https://ff-quizzes.netlify.app/web/) -> **Примечание о квизах**: Все квизы находятся в папке Quiz-app, всего 48 квизов по три вопроса каждый. Они доступны [здесь](https://ff-quizzes.netlify.app/web/), приложение для квизов можно запускать локально или деплоить в Azure; следуйте инструкциям в папке `quiz-app`. +> **Примечание о квизах**: Все квизы находятся в папке Quiz-app, всего 48 квизов по три вопроса в каждом. Они доступны [здесь](https://ff-quizzes.netlify.app/web/), приложение квизов можно запускать локально или развёртывать в Azure; следуйте инструкциям в папке `quiz-app`. ## 🗃️ Уроки -| | Название проекта | Изучаемые концепции | Цели обучения | Связанный урок | Автор | -| :-: | :----------------------------------------------------------: | :---------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------: | :------------------: | -| 01 | Начало работы | Введение в программирование и инструменты профессии | Узнать основы большинства языков программирования и о программном обеспечении, которое помогает профессиональным разработчикам | [Введение в языки программирования и инструменты](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | -| 02 | Начало работы | Основы GitHub, работа в команде | Как использовать GitHub в вашем проекте, как сотрудничать с другими в кодовой базе | [Введение в GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | -| 03 | Начало работы | Доступность | Узнать основы веб-доступности | [Основы доступности](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | -| 04 | Основы JS | Типы данных в JavaScript | Основы типов данных в JavaScript | [Типы данных](./2-js-basics/1-data-types/README.md) | Jasmine | -| 05 | Основы JS | Функции и методы | Узнать о функциях и методах управления логикой приложения | [Функции и методы](./2-js-basics/2-functions-methods/README.md) | Jasmine и Christopher | -| 06 | Основы JS | Создание условий в JS | Научиться создавать условия в коде с помощью методов принятия решений | [Создание условий](./2-js-basics/3-making-decisions/README.md) | Jasmine | -| 07 | Основы JS | Массивы и циклы | Работа с данными, используя массивы и циклы в JavaScript | [Массивы и циклы](./2-js-basics/4-arrays-loops/README.md) | Jasmine | -| 08 | [Террариум](./3-terrarium/solution/README.md) | HTML на практике | Создание HTML для онлайн-террариума, с акцентом на построение макета | [Введение в HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | -| 09 | [Террариум](./3-terrarium/solution/README.md) | CSS на практике | Создание CSS для стилизации онлайн-террариума, основы в том числе адаптивности | [Введение в CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | -| 10 | [Террариум](./3-terrarium/solution/README.md) | Замыкания JS, манипуляции с DOM | Создание JavaScript для функционала террариума с drag/drop, с упором на замыкания и работу с DOM | [Замыкания JS, работа с DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | -| 11 | [Игра на набор текста](./4-typing-game/solution/README.md) | Создание игры для печати | Учимся использовать события клавиатуры для управления логикой приложения на JavaScript | [Событийное программирование](./4-typing-game/typing-game/README.md) | Christopher | -| 12 | [Расширение для браузера Green](./5-browser-extension/solution/README.md) | Работа с браузерами | Узнать, как работают браузеры, их историю и создание начальных элементов расширения браузера | [О браузерах](./5-browser-extension/1-about-browsers/README.md) | Jen | -| 13 | [Расширение для браузера Green](./5-browser-extension/solution/README.md) | Создание формы, вызов API и хранение переменных в local storage | Создать JavaScript элементы расширения для вызова API с использованием переменных, хранящихся в local storage | [API, формы и local storage](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | -| 14 | [Расширение для браузера Green](./5-browser-extension/solution/README.md) | Фоновые процессы в браузере, производительность веба | Использовать фоновые процессы браузера для управления иконкой расширения; узнать о веб-производительности и оптимизациях | [Фоновые задачи и производительность](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | -| 15 | [Космическая игра](./6-space-game/solution/README.md) | Продвинутая разработка игр на JavaScript | Изучить наследование через классы и композицию, паттерн Pub/Sub, подготовка к созданию игры | [Введение в продвинутую разработку игр](./6-space-game/1-introduction/README.md) | Chris | -| 16 | [Космическая игра](./6-space-game/solution/README.md) | Рисование на canvas | Изучение Canvas API для отрисовки элементов на экране | [Рисование на Canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | -| 17 | [Космическая игра](./6-space-game/solution/README.md) | Перемещение элементов по экрану | Познакомиться с движением элементов с использованием декартовых координат и Canvas API | [Перемещение элементов](./6-space-game/3-moving-elements-around/README.md) | Chris | -| 18 | [Космическая игра](./6-space-game/solution/README.md) | Обнаружение столкновений | Сделать так, чтобы элементы сталкивались и реагировали друг на друга с помощью нажатий клавиш, добавить функцию паузы для производительности | [Обнаружение столкновений](./6-space-game/4-collision-detection/README.md) | Chris | -| 19 | [Космическая игра](./6-space-game/solution/README.md) | Ведение счета | Выполнять математические вычисления на основе состояния игры и производительности | [Ведение счета](./6-space-game/5-keeping-score/README.md) | Chris | -| 20 | [Космическая игра](./6-space-game/solution/README.md) | Завершение и перезапуск игры | Узнать о завершении и перезапуске игры, включая очистку ресурсов и сброс значений переменных | [Условие завершения](./6-space-game/6-end-condition/README.md) | Chris | -| 21 | [Банковское приложение](./7-bank-project/solution/README.md) | HTML-шаблоны и маршруты веб-приложения | Научиться создавать структуру многополосного сайта с маршрутизацией и HTML-шаблонами | [HTML-шаблоны и маршруты](./7-bank-project/1-template-route/README.md) | Yohan | -| 22 | [Банковское приложение](./7-bank-project/solution/README.md) | Создание формы входа и регистрации | Изучить создание форм и обработку валидации | [Формы](./7-bank-project/2-forms/README.md) | Yohan | -| 23 | [Банковское приложение](./7-bank-project/solution/README.md) | Методы получения и использования данных | Как данные поступают в приложение и выходят из него, как их получать, хранить и удалять | [Данные](./7-bank-project/3-data/README.md) | Yohan | -| 24 | [Банковское приложение](./7-bank-project/solution/README.md) | Концепции управления состоянием | Узнать, как приложение сохраняет состояние и как управлять им программно | [Управление состоянием](./7-bank-project/4-state-management/README.md) | Yohan | -| 25 | [Код браузера/VScode](../../8-code-editor) | Работа с VScode | Научиться использовать редактор кода | [Использование редактора кода VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | -| 26 | [AI помощники](./9-chat-project/README.md) | Работа с ИИ | Научиться создавать собственного AI помощника | [Проект AI помощника](./9-chat-project/README.md) | Chris | +| | Название проекта | Осваиваемые концепции | Цели обучения | Связанный урок | Автор | +| :-: | :---------------------------------------------------------: | :------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------: | :---------------------: | +| 01 | Начинаем работу | Введение в программирование и инструменты профессии | Ознакомиться с базовыми понятиями большинства языков программирования и программным обеспечением, помогающим профессионалам | [Введение в языки программирования и инструменты](./1-getting-started-lessons/1-intro-to-programming-languages/README.md) | Jasmine | +| 02 | Начинаем работу | Основы GitHub, работа в команде | Узнать, как использовать GitHub в проекте, как сотрудничать с другими над кодом | [Введение в GitHub](./1-getting-started-lessons/2-github-basics/README.md) | Floor | +| 03 | Начинаем работу | Доступность | Изучить основы веб-доступности | [Основы доступности](./1-getting-started-lessons/3-accessibility/README.md) | Christopher | +| 04 | Основы JS | Типы данных JavaScript | Основы работы с типами данных в JavaScript | [Типы данных](./2-js-basics/1-data-types/README.md) | Jasmine | +| 05 | Основы JS | Функции и методы | Узнать о функциях и методах для управления логикой приложения | [Функции и методы](./2-js-basics/2-functions-methods/README.md) | Jasmine и Christopher | +| 06 | Основы JS | Принятие решений в JS | Научиться создавать условия в коде с помощью конструкций принятия решений | [Принятие решений](./2-js-basics/3-making-decisions/README.md) | Jasmine | +| 07 | Основы JS | Массивы и циклы | Работа с данными используя массивы и циклы в JavaScript | [Массивы и циклы](./2-js-basics/4-arrays-loops/README.md) | Jasmine | +| 08 | [Террариум](./3-terrarium/solution/README.md) | Практика HTML | Создать HTML для онлайн-террариума, сосредоточившись на создании разметки | [Введение в HTML](./3-terrarium/1-intro-to-html/README.md) | Jen | +| 09 | [Террариум](./3-terrarium/solution/README.md) | Практика CSS | Создать CSS для стилизации онлайн-террариума, акцент на основах CSS и адаптивности страницы | [Введение в CSS](./3-terrarium/2-intro-to-css/README.md) | Jen | +| 10 | [Террариум](./3-terrarium/solution/README.md) | Замыкания JavaScript, работа с DOM | Написать JavaScript для реализации функционала перетаскивания в террариуме, акцент на замыкания и манипуляции DOM | [Замыкания JS и работа с DOM](./3-terrarium/3-intro-to-DOM-and-closures/README.md) | Jen | +| 11 | [Игра на скорость набора](./4-typing-game/solution/README.md) | Создание игры для набора текста | Научиться использовать события клавиатуры для управления логикой JS приложения | [Событийно-ориентированное программирование](./4-typing-game/typing-game/README.md) | Christopher | +| 12 | [Расширение зеленого браузера](./5-browser-extension/solution/README.md) | Работа с браузерами | Узнать, как работают браузеры, их историю и как построить первые элементы расширения | [О браузерах](./5-browser-extension/1-about-browsers/README.md) | Jen | +| 13 | [Расширение зеленого браузера](./5-browser-extension/solution/README.md) | Создание формы, вызов API и хранение переменных в localStorage | Написать JavaScript для расширения браузера для вызова API с использованием переменных из локального хранилища | [API, формы и локальное хранилище](./5-browser-extension/2-forms-browsers-local-storage/README.md) | Jen | +| 14 | [Расширение зеленого браузера](./5-browser-extension/solution/README.md) | Фоновые процессы в браузере, производительность веба | Использовать фоновые процессы браузера для управления иконкой расширения; изучить веб-производительность и оптимизации | [Фоновые задачи и производительность](./5-browser-extension/3-background-tasks-and-performance/README.md) | Jen | +| 15 | [Космическая игра](./6-space-game/solution/README.md) | Продвинутая разработка игр на JavaScript | Изучить наследование с помощью классов и композиции, а также паттерн Pub/Sub перед созданием игры | [Введение в продвинутую разработку игр](./6-space-game/1-introduction/README.md) | Chris | +| 16 | [Космическая игра](./6-space-game/solution/README.md) | Рисование на canvas | Познакомиться с Canvas API, используемым для рисования на экране | [Рисование на canvas](./6-space-game/2-drawing-to-canvas/README.md) | Chris | +| 17 | [Космическая игра](./6-space-game/solution/README.md) | Перемещение элементов по экрану | Узнать, как элементы могут двигаться с использованием декартовых координат и Canvas API | [Перемещение элементов](./6-space-game/3-moving-elements-around/README.md) | Chris | +| 18 | [Космическая игра](./6-space-game/solution/README.md) | Обнаружение столкновений | Сделать чтобы элементы сталкивались и реагировали друг на друга при нажатии клавиш, добавить функцию охлаждения для производительности | [Обнаружение столкновений](./6-space-game/4-collision-detection/README.md) | Chris | +| 19 | [Космическая игра](./6-space-game/solution/README.md) | Ведение счета | Выполнять математические вычисления, основываясь на статусе и производительности игры | [Ведение счета](./6-space-game/5-keeping-score/README.md) | Chris | +| 20 | [Космическая игра](./6-space-game/solution/README.md) | Завершение и перезапуск игры | Узнать, как завершить и перезапустить игру, включая очистку ресурсов и сброс переменных | [Условие завершения](./6-space-game/6-end-condition/README.md) | Chris | +| 21 | [Банковское приложение](./7-bank-project/solution/README.md) | HTML-шаблоны и маршрутизация в веб-приложении | Научиться создавать основу архитектуры многостраничного сайта с использованием маршрутизации и HTML-шаблонов | [HTML-шаблоны и маршруты](./7-bank-project/1-template-route/README.md) | Yohan | +| 22 | [Банковское приложение](./7-bank-project/solution/README.md) | Создание форм входа и регистрации | Изучить построение форм и обработку процедур валидации | [Формы](./7-bank-project/2-forms/README.md) | Yohan | +| 23 | [Банковское приложение](./7-bank-project/solution/README.md) | Методы получения и использования данных | Понять, как данные поступают в приложение и как их получать, хранить и удалять | [Данные](./7-bank-project/3-data/README.md) | Yohan | +| 24 | [Банковское приложение](./7-bank-project/solution/README.md) | Концепции управления состоянием | Узнать, как приложение хранит состояние и как управлять им программно | [Управление состоянием](./7-bank-project/4-state-management/README.md) | Yohan | +| 25 | [Код браузера/VSCode](../../8-code-editor) | Работа с VScode | Научиться использовать редактор кода | [Использование редактора VScode](./8-code-editor/1-using-a-code-editor/README.md) | Chris | +| 26 | [AI Ассистенты](./9-chat-project/README.md) | Работа с ИИ | Научиться создавать собственного ИИ-ассистента | [Проект AI Ассистент](./9-chat-project/README.md) | Chris | ## 🏫 Педагогика -Наша учебная программа основана на двух ключевых педагогических принципах: -* обучение на основе проектов +Наша учебная программа разработана с учётом двух ключевых педагогических принципов: +* обучение через проекты * частые квизы -Программа обучает основам JavaScript, HTML и CSS, а также последним инструментам и техникам, используемым современными веб-разработчиками. Студенты получат возможность приобрести практический опыт, создавая игру для печати, виртуальный террариум, экологичное расширение для браузера, игру в стиле космических захватчиков и банковское приложение для бизнеса. К концу серии студенты будут иметь твердое понимание веб-разработки. +Программа обучает основам JavaScript, HTML и CSS, а также современным инструментам и методам, используемым современными веб-разработчиками. Студенты получат возможность получить практический опыт, создавая игру на набор текста, виртуальный террариум, экологичное расширение для браузера, игру в стиле космических захватчиков и банковское приложение для бизнеса. К концу серии студенты приобретут прочное понимание веб-разработки. -> 🎓 Первые несколько уроков этой программы вы можете пройти как [Учебный путь](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) на Microsoft Learn! +> 🎓 Вы можете пройти первые несколько уроков этой программы как [Обучающий путь](https://docs.microsoft.com/learn/paths/web-development-101/?WT.mc_id=academic-77807-sagibbon) на Microsoft Learn! -Обеспечивая соответствие содержания проектам, процесс обучения становится более увлекательным для студентов, а запоминание концепций лучше. Мы также разработали несколько стартовых уроков по основам JavaScript для введения в концепции, дополненных видео из серии "[Для начинающих: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", где авторы видеокурсов внесли вклад в эту учебную программу. +Обеспечение соответствия содержания проектам делает процесс более увлекательным для студентов и способствует лучшему усвоению концепций. Мы также написали несколько вводных уроков по основам JavaScript с видео из серии "[Beginners Series to: JavaScript](https://channel9.msdn.com/Series/Beginners-Series-to-JavaScript/?WT.mc_id=academic-77807-sagibbon)", авторы которых внесли вклад в эту программу. -Кроме того, небольшой предварительный квиз перед занятием настраивает студента на изучение темы, а второй квиз после занятия укрепляет знания. Эта программа разработана быть гибкой и интересной, её можно проходить полностью или частично. Проекты начинаются с простого и становятся всё более сложными к концу 12-недельного цикла. +Кроме того, небольшой квиз перед занятием задаёт настрой учащегося на изучение темы, а второй квиз после класса обеспечивает лучшее закрепление материала. Эта учебная программа разработана быть гибкой и интересной, её можно пройти полностью или частично. Проекты начинаются с простых и усложняются к концу 12-недельного цикла. -Хотя мы намеренно избегали введения JavaScript-фреймворков, чтобы сосредоточиться на базовых навыках веб-разработчика, хорошим следующим шагом после этой программы будет изучение Node.js через другую серию видео: "[Для начинающих: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". +Хотя мы сознательно избегали внедрения JavaScript-фреймворков, чтобы сосредоточиться на базовых навыках веб-разработчика перед изучением фреймворков, хорошим следующим шагом после этой программы будет изучение Node.js через другую видеосерию: "[Beginner Series to: Node.js](https://channel9.msdn.com/Series/Beginners-Series-to-Nodejs/?WT.mc_id=academic-77807-sagibbon)". -> Ознакомьтесь с нашими [Правилами поведения](CODE_OF_CONDUCT.md) и [Правилами вклада](CONTRIBUTING.md). Мы приветствуем ваши конструктивные отзывы! +> Посетите наши руководства [Кодекс поведения](CODE_OF_CONDUCT.md) и [Как внести вклад](CONTRIBUTING.md). Мы рады вашим конструктивным отзывам! -## 🧭 Оффлайн-доступ -Вы можете использовать эту документацию офлайн при помощи [Docsify](https://docsify.js.org/#/). Форкните этот репозиторий, [установите Docsify](https://docsify.js.org/#/quickstart) на свой локальный компьютер, а затем в корневой папке репозитория введите `docsify serve`. Веб-сайт будет доступен по адресу `localhost:3000` на вашем локальном хосте. +## 🧭 Офлайн-доступ + +Вы можете просматривать эту документацию офлайн, используя [Docsify](https://docsify.js.org/#/). Форкните этот репозиторий, [установите Docsify](https://docsify.js.org/#/quickstart) на своём компьютере, а затем в корневой папке репозитория введите `docsify serve`. Веб-сайт будет доступен на порту 3000 по адресу `localhost:3000`. ## 📘 PDF -PDF со всеми уроками можно найти [здесь](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). +PDF со всеми уроками доступен [здесь](https://microsoft.github.io/Web-Dev-For-Beginners/pdf/readme.pdf). ## 🎒 Другие курсы -Наша команда создает и другие курсы! Ознакомьтесь: +Наша команда выпускает и другие курсы! Посмотрите: ### LangChain -[![LangChain4j для начинающих](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) -[![LangChain.js для начинающих](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) - +[![LangChain4j for Beginners](https://img.shields.io/badge/LangChain4j%20for%20Beginners-22C55E?style=for-the-badge&&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchain4j-for-beginners) +[![LangChain.js for Beginners](https://img.shields.io/badge/LangChain.js%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin) +[![LangChain for Beginners](https://img.shields.io/badge/LangChain%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=0553D6)](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin) --- -### Azure / Edge / MCP / Агенты -[![AZD для начинающих](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Edge AI для начинающих](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![MCP для начинающих](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) -[![AI агенты для начинающих](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) +### Azure / Edge / MCP / Agents +[![AZD for Beginners](https://img.shields.io/badge/AZD%20for%20Beginners-0078D4?style=for-the-badge&labelColor=E5E7EB&color=0078D4)](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Edge AI for Beginners](https://img.shields.io/badge/Edge%20AI%20for%20Beginners-00B8E4?style=for-the-badge&labelColor=E5E7EB&color=00B8E4)](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![MCP for Beginners](https://img.shields.io/badge/MCP%20for%20Beginners-009688?style=for-the-badge&labelColor=E5E7EB&color=009688)](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst) +[![AI Agents for Beginners](https://img.shields.io/badge/AI%20Agents%20for%20Beginners-00C49A?style=for-the-badge&labelColor=E5E7EB&color=00C49A)](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Серия по генеративному ИИ -[![Генеративный ИИ для начинающих](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) -[![Генеративный ИИ (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) -[![Генеративный ИИ (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) -[![Генеративный ИИ (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) +[![Generative AI for Beginners](https://img.shields.io/badge/Generative%20AI%20for%20Beginners-8B5CF6?style=for-the-badge&labelColor=E5E7EB&color=8B5CF6)](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst) +[![Generative AI (.NET)](https://img.shields.io/badge/Generative%20AI%20(.NET)-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst) +[![Generative AI (Java)](https://img.shields.io/badge/Generative%20AI%20(Java)-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst) +[![Generative AI (JavaScript)](https://img.shields.io/badge/Generative%20AI%20(JavaScript)-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst) --- -### Основное обучение -[![Машинное обучение для начинающих](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) -[![Наука о данных для начинающих](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) -[![ИИ для начинающих](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) -[![Кибербезопасность для начинающих](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) -[![Веб-разработка для начинающих](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) -[![IoT для начинающих](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) -[![Разработка XR для начинающих](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) +### Основы обучения +[![ML for Beginners](https://img.shields.io/badge/ML%20for%20Beginners-22C55E?style=for-the-badge&labelColor=E5E7EB&color=22C55E)](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst) +[![Data Science for Beginners](https://img.shields.io/badge/Data%20Science%20for%20Beginners-84CC16?style=for-the-badge&labelColor=E5E7EB&color=84CC16)](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst) +[![AI for Beginners](https://img.shields.io/badge/AI%20for%20Beginners-A3E635?style=for-the-badge&labelColor=E5E7EB&color=A3E635)](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst) +[![Cybersecurity for Beginners](https://img.shields.io/badge/Cybersecurity%20for%20Beginners-F97316?style=for-the-badge&labelColor=E5E7EB&color=F97316)](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung) +[![Web Dev for Beginners](https://img.shields.io/badge/Web%20Dev%20for%20Beginners-EC4899?style=for-the-badge&labelColor=E5E7EB&color=EC4899)](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst) +[![IoT for Beginners](https://img.shields.io/badge/IoT%20for%20Beginners-14B8A6?style=for-the-badge&labelColor=E5E7EB&color=14B8A6)](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst) +[![XR Development for Beginners](https://img.shields.io/badge/XR%20Development%20for%20Beginners-38BDF8?style=for-the-badge&labelColor=E5E7EB&color=38BDF8)](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst) --- ### Серия Copilot -[![Copilot для парного программирования с ИИ](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) -[![Copilot для C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) -[![Приключения Copilot](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) +[![Copilot for AI Paired Programming](https://img.shields.io/badge/Copilot%20for%20AI%20Paired%20Programming-FACC15?style=for-the-badge&labelColor=E5E7EB&color=FACC15)](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst) +[![Copilot for C#/.NET](https://img.shields.io/badge/Copilot%20for%20C%23/.NET-FBBF24?style=for-the-badge&labelColor=E5E7EB&color=FBBF24)](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst) +[![Copilot Adventure](https://img.shields.io/badge/Copilot%20Adventure-FDE68A?style=for-the-badge&labelColor=E5E7EB&color=FDE68A)](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst) ## Получение помощи -Если вы застряли или у вас есть вопросы по созданию приложений с ИИ. Присоединяйтесь к другим учащимся и опытным разработчикам в обсуждениях MCP. Это поддерживающее сообщество, где вопросы приветствуются, а знания свободно делятся. +Если вы застряли или у вас есть вопросы по созданию ИИ-приложений, присоединяйтесь к другим учащимся и опытным разработчикам в обсуждениях на тему MCP. Это поддерживающее сообщество, где вопросы приветствуются, а знания свободно распространяются. [![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG) -Если у вас есть отзывы о продукте или ошибки при разработке, посетите: +Если у вас есть отзывы о продукте или ошибки во время разработки, посетите: [![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum) ## Лицензия -Этот репозиторий лицензирован по лицензии MIT. Подробнее смотрите в файле [LICENSE](../../LICENSE). +Этот репозиторий лицензирован по лицензии MIT. Дополнительную информацию смотрите в файле [LICENSE](../../LICENSE). --- **Отказ от ответственности**: -Этот документ был переведен с помощью сервиса машинного перевода [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/ru/Roadmap.md b/translations/ru/Roadmap.md new file mode 100644 index 000000000..a40c1142b --- /dev/null +++ b/translations/ru/Roadmap.md @@ -0,0 +1,53 @@ +# Дорожная карта для репозитория Microsoft Web-Dev-For-Beginners + +**Этот репозиторий предоставляет дорожную карту для изучения основ веб-разработки с упором на JavaScript, HTML и CSS. Учебная программа гибкая и может быть пройдена полностью или частично, включает 24 урока, распределённых на 12 недель.** + +## Ключевые этапы + +* **Недели 1-3:** + * Введение в языки программирования и основные инструменты + * Основы GitHub + * Доступность + * Основы JS: типы данных, функции и методы + * Принятие решений с помощью JS +* **Недели 4-6:** + * Массивы и циклы + * Террариум: HTML на практике + * CSS на практике + * Замыкания в JavaScript + * Манипуляция DOM +* **Недели 7-9:** + * Игра на набор текста: программирование с обработкой событий + * Расширение Green Browser: работа с браузерами + * Создание формы, вызов API и хранение переменных в локальном хранилище + * Фоновые процессы в браузере + * Веб-производительность +* **Недели 10-12:** + * Космическая игра: более продвинутая разработка игр на JavaScript + * Рисование на canvas + * Перемещение элементов по экрану + * Обнаружение столкновений + * Подсчёт очков, окончание и перезапуск игры + * Банковское приложение: HTML шаблоны и маршруты в веб-приложении + * Создание формы регистрации и входа + * Методы получения и использования данных + * Концепции управления состоянием + +## Результаты обучения + +**Завершив эту дорожную карту, студенты получат практический опыт создания игры на набор текста, виртуального террариума, экологичного расширения для браузера, игры в стиле космических захватчиков и банковского приложения для бизнеса. Они также разовьют прочное понимание основ веб-разработки.** + +## Дополнительные ресурсы + +* Этот репозиторий содержит множество ресурсов для дальнейшего обучения, включая руководства, примеры кода и задания. +* Платформа Microsoft Learn предлагает разнообразные курсы и учебные пути по веб-разработке. +* Онлайн-сообщества, такие как Stack Overflow и MDN Web Docs, предоставляют ценную поддержку и ресурсы для веб-разработчиков. + +**Надеюсь, эта дорожная карта поможет вам в вашем путешествии по веб-разработке!** + +--- + + +**Отказ от ответственности**: +Этот документ был переведен с помощью сервиса автоматического перевода [Co-op Translator](https://github.com/Azure/co-op-translator). Несмотря на наши усилия обеспечить точность, имейте в виду, что автоматический перевод может содержать ошибки или неточности. Оригинальный документ на его исходном языке следует считать авторитетным источником. Для критически важной информации рекомендуется профессиональный перевод специалистом. Мы не несем ответственности за любые недоразумения или неправильные толкования, возникшие в результате использования данного перевода. + \ No newline at end of file