عن المشروع

يعد Academic Pages قالب GitHub Pages يعتمد على Jekyll ومخصصًا لمواقع الأعمال الشخصية والمهنية. يمكن للمستخدمين إنشاء مستودع من القالب، وتسميته باسم مستخدم GitHub الخاص بهم، وإعداد الموقع في `_config.yml`، وإضافة المحتوى باستخدام Markdown أو HTML. ويتم تقديم الملفات المرفوعة التي توضع في دليل `files/` عبر مسار الموقع المقابل لها. يتضمن القالب مجلد `markdown_generator` يحتوي على دفاتر Jupyter أو سكربتات Python يمكنها توليد صفحات Markdown للمنشورات والمحاضرات من بيانات TSV. والقالب مشتق من سمة Minimal Mistakes Jekyll ومتاح بموجب رخصة MIT. بالنسبة للتطوير المحلي، يستخدم الإعداد الموثق Ruby وBundler وNode.js. بعد تثبيت الاعتماديات باستخدام `bundle install`، يمكن معاينة الموقع عبر خادم Jekyll المحلي، وعادةً على `localhost:4000`؛ وتتم إعادة بناء تغييرات Markdown وHTML تلقائيًا، بينما قد تتطلب تغييرات الإعداد إعادة التشغيل. يوفر المستودع أيضًا ملف Dockerfile وسير عمل Docker Compose لتشغيل الموقع دون تثبيت كامل أدوات التطوير المحلية يدويًا، بالإضافة إلى إعداد VS Code Dev Container. يغطي دليل الصيانة مشكلات GitHub والمناقشات وطلبات السحب والتفرع واعتبارات المزامنة للمواقع المخصصة. وبما أنه مصمم كقالب بداية وليس خدمة مستضافة مستقلة، يدير المستخدمون المحتوى والإعداد ومستودع GitHub والنشر الخاص بهم عبر GitHub Pages.