عُلِم هو مشروع تقني مفتوح المصدر يسعى لتأسيس مرجع أكاديمي مكتوب لعلوم الحاسب باللغة العربية. يرتكز المشروع على فلسفة "التعلّم عبر التوثيق المنظم"، توفيراً لبديل معرفي رصين يتجاوز عشوائية المحتوى المرئي، ويقلل من الاعتماد الكلي على المصادر الأجنبية في مراحل التأسيس.
تم بناء المنصة باستخدام إطار عمل "ديناصور المستندات" (Docusaurus) من شركة Meta لضمان السرعة، الكفاءة البرمجية، ومعايير أرشفة المحتوى المتطورة.
تعتمد المنصة منظومة تقنية متكاملة تضمن استدامة المحتوى وقابليته للتوسع:
- المحرك الأساسي: إطار عمل (Docusaurus v3) لتوليد المواقع الساكنة.
- بنية الواجهة: مكتبة (React.js) لدعم المكونات التفاعلية.
- تنسيق المحتوى: لغتي (MDX و MD) اللاتي تدمجن بين بساطة التحرير وقوة برمجيات React.
- نظام التنسيق: (CSS3 و TailwindCSS) مع دعم كامل لخصائص القراءة من اليمين إلى اليسار.
ينقسم المحتوى في منصة "عُلِم" إلى طبقات تضمن التدرج المعرفي:
- المبادئ العامة: تشمل مفاهيم علوم الحاسب الأساسية المستقلة عن اللغات البرمجية.
- المسارات التخصصية: توثيق معمق للغات برمجة محددة مثل (Python) و (JavaScript).
- التطبيق العملي: دروس متقدمة في هندسة الويب، تطوير النظم، وقواعد البيانات.
لتشغيل المنصة على جهازك الشخصي بغرض التطوير أو المعاينة، اتبع الخطوات التالية:
- تثبيت بيئة (Node.js) بإصدار حديث.
- مدير حزم مثل (npm) أو (yarn).
استنساخ المستودع من المنصة:
git clone https://github.com/binhunaish/olim.gitالانتقال إلى مجلد المشروع:
cd olimتثبيت الاعتمادات البرمجية اللازمة:
npm installتشغيل خادم التطوير المحلي للمعاينة الحية:
npm startسيكون الموقع متاحاً للمعاينة الفورية عبر الرابط المحلي: http://localhost:3000.
نرحب بكافة المساهمات التي ترفع من جودة المحتوى العربي. للمساهمة في المشروع، نرجو اتباع المعايير التالية:
- المساهمة المعرفية: كتابة توثيق جديد أو تنقيح الشروحات القائمة وفق الأسلوب الأكاديمي.
- المساهمة التقنية: تحسين شيفرة المصدر أو تطوير مكونات برمجية جديدة تعزز تجربة المستخدم.
- التدقيق الاصطلاحي: توحيد المصطلحات البرمجية العربية وضمان دقتها التقنية.
للمزيد من التفاصيل حول معايير الكتابة، يرجى مراجعة ملف دليل المساهمين.
هذا المشروع متاح للعموم بموجب رخصة MIT. نؤمن بأن المعرفة حق مشاع، وللمستخدم كامل الحرية في الاستخدام، التعديل، وإعادة التوزيع.
عُلِم: نحو تدوين برمجى عربي متين.