إزاي تستخدم الموسوعة
Usage, offline, mobile and limitations
الموسوعة كلها HTML ثابت: فك الضغط وافتح index.html في أي متصفح حديث. مفيش server ولا إنترنت مطلوب للقراءة — الـ CSS والـ JavaScript والخط اللاتيني (Inter) كلهم جوه الفولدر.
الفتح والتنقل
index.html— لوحة التعلّم: تقدّمك، الدرس المقترح، آخر الدروس، وكل المجالات.- الفهرس الجانبي فيه الـ 15 مجال (آخرهم مشروع التخرج) وكل دروسهم، مع علامة ✓ على المكتمل وتظليل الدرس الحالي.
- البحث: دوس Ctrl + K أو / — بيدوّر في عناوين الدروس والأقسام بالعربي والإنجليزي.
- كل درس فيه محتويات على الجنب، شريط تقدّم قراءة، وأزرار السابق/التالي.
على الموبايل
- أسهل طريقة: انقل ملف
MOBILE-OFFLINE.htmlلوحده للموبايل وافتحه بالمتصفح. ده ملف واحد فيه كل الدروس والتصميم، ومش محتاج باقي الفولدر. - أو انقل الفولدر كله وافتح
index.htmlمن تطبيق ملفات بيدعم فتح HTML بروابط نسبية (ده بيشتغل على أغلب أندرويد؛ على iPhone استخدم الملف الواحد). - أو شغّل server محلي على الكمبيوتر وافتحه من الموبايل على نفس الشبكة (شوف القسم 04).
التقدّم والإعدادات
التقدّم، آخر الدروس، الثيم، حجم الخط، وعرض القراءة بيتحفظوا في localStorage بتاع المتصفح على جهازك فقط. مفيش حساب ولا مزامنة.
- من زر Aa فوق: حجم الخط، عرض العمود، لوحة الألوان (Amber / Slate)، وتصدير/استيراد التقدّم كملف JSON عشان تنقله بين الأجهزة أو المتصفحات.
- لو مسحت بيانات المتصفح التقدّم بيتمسح — صدّره الأول.
MOBILE-OFFLINE.htmlوالنسخة العادية بيتشاركوا نفس التقدّم لو مفتوحين من نفس المصدر (نفس الـ origin).
حدود file:// والبديل
الموسوعة مصممة تشتغل من file:// مباشرة (مفيش fetch ولا service worker). الحدود المعروفة:
- بعض المتصفحات بتعزل
localStorageلكل ملف علىfile://أو بتمنعه في الوضع الخاص؛ ساعتها التقدّم مش هيتشارك بين الصفحات. - زر النسخ بيستخدم fallback على
file://لأن Clipboard API محتاج secure context.
الحل المضمون: شغّل server محلي من جوه الفولدر وافتح http://localhost:8000:
python3 -m http.server 8000
# أو
npx serve .الخطوط
الخط اللاتيني Inter مرفق في assets/fonts. الخط العربي بيستخدم أفضل خط موجود على جهازك بالترتيب: IBM Plex Sans Arabic → Noto Sans Arabic → SF Arabic → Segoe UI → Tahoma. لو عايز شكل موحّد على كل الأجهزة، ثبّت IBM Plex Sans Arabic على النظام. الكود بيستخدم JetBrains Mono / IBM Plex Mono لو متثبتين، وإلا خط الـ monospace بتاع النظام.
نسخ التقنيات وحالة التحقق من الأكواد
- .NET 10 (LTS) / C# 14 / ASP.NET Core 10 / EF Core 10
- Angular + TypeScript
- Python 3.12+
مش كل الأكواد اتشغّلت. أمثلة Python الجديدة اتنفذت فعلًا، وأمثلة JS/TS/YAML/JSON اتفحصت syntax، لكن أمثلة C# لم يتم عمل compile لها لأن الـ .NET SDK مش متاح في بيئة التوليد. التفاصيل الكاملة في _reports/CODE_VALIDATION_REPORT.md.
إعادة البناء
مصادر الدروس في _build/src. بعد أي تعديل:
python3 _build/build.py # يبني كل الصفحات + فهرس البحث + التقارير
python3 _build/build_mobile.py # يبني MOBILE-OFFLINE.htmlمحتاج Python 3 ومكتبة pygments بس.