يحتوي هذا المستودع على منشئ الموقع الثابت ومحتوى https://qubyte.codes.
المولد موجود في الغالب في ملف Index.js. تتم معظم المهام الثقيلة من خلال نظام إنشاء رسم بياني مخصص ووضع علامة عليه، والذي يأخذ ملفات تخفيض السعر ويعالجها في محتوى HTML. إنها ليست مثالية، وكان من الضروري إجراء بعض الترقيعات على القرود. تقوم الوحدة lib/render.js بإجراء هذا التصحيح، وتضيف تمييزًا نحويًا وتنسيقًا للصيغ الرياضية.
serv.js هو خادم تطوير. عند تغيير الملفات، يتم إعادة تشغيل أجزاء من الرسم البياني للإنشاء للحصول على مخرجات محدثة.
الملفات المصدر موجودة في دليلي src وcontent. عند الإنشاء، يتم إنشاء دليل عام، ويتم نسخ بعض هذه الملفات المصدرية (تلك التي لا تحتاج إلى تجميع، مثل عامل الخدمة). يجب إنشاء ملفات أخرى ووضعها في الدليل العام عند إنشائها.
netlify.toml هو تكوين لـ Netlify، الذي يستضيف مدونتي (أوصي به بشدة). في وقت كتابة هذا الملف يحتوي فقط على تكوين الرؤوس. تم تحسينها للأمان والتخزين المؤقت للمتصفح لـ CSS. لقد قمت في الأصل باستضافة هذه المدونة على منصة DigitalOcean باستخدام NGINX. لا يزال التكوين الخاص بذلك جزءًا من هذا الريبو، nginx.conf.
أستخدم postcss لتجميع CSS. من حيث المبدأ، يمكن استخدام CSS بدونها. بالنسبة للجزء الأكبر، يتم استخدام postcss لتسلسل وتصغير CSS. تتم تجزئة مخرجات CSS، وتصبح التجزئة جزءًا من اسم ملف CSS. يؤدي هذا إلى تعطل ذاكرة التخزين المؤقت، حيث يتم منح CSS وقتًا طويلاً أو غير محدد للتخزين المؤقت لتجنب حظر تحميل الصفحة بعد تحميلها مرة واحدة.
باستثناء تمييز بناء الجملة، يتجنب هذا الموقع إلى حد كبير استخدام الفئات في HTML كخطافات لـ CSS، بدلاً من التأكيد على أن العلامات الدلالية توفر سياقًا كافيًا لـ CSS للالتزام به.
المدونة عبارة عن تطبيق ويب تقدمي (PWA)، وتحتوي على أيقونات بأحجام مختلفة وفقًا لذلك. واحدة من هذه هي أيضا المفضلة.
يحتوي هذا الدليل على مصادر تخفيض السعر للمشاركات المنشورة. تحتوي كل مشاركة على مقدمة JSON تحتوي على بيانات وصفية متنوعة:
اسم | وصف |
---|---|
التاريخ والوقت | الطابع الزمني لنشر المنشور. إذا كان هذا في المستقبل فلن يتم تقديم المنشور. |
عنوان | عنوان المنشور. |
وصف | وصف المنشور تتم إضافة هذا إلى رأس HTML كوصف تعريفي ووصف تعريفي للتويتر. يتم استخدام الأخير بواسطة تويتر لملء بطاقات تويتر. |
مسودة | إذا كان هذا صحيحا، فلن يتم تقديم هذا المنصب. |
العلامات | قائمة العلامات. يتم عرضها في أعلى كل إدخال، ويتم استخدامها أيضًا عند المشاركة على تويتر والماستودون عبر الروابط الموجودة أسفل كل مشاركة. |
إشارات الويب | قائمة إشارات الويب من مدونات أخرى. |
مخطوطات | قائمة الكائنات مع حقل href . ستتم إضافتها كبرامج نصية من نوع الوحدة النمطية إلى رأس المنشور. |
أستخدم قوالب المقاود لعرض المحتوى في الصفحات. بعضها يحتوي على صفحات، والبعض الآخر عبارة عن مكونات شائعة للصفحات. إنهم مدرسة قديمة جدًا، لكنهم يقومون بعمل جيد.
عامل الخدمة والبيان عبارة عن ملفات تمكن هذه المدونة من العمل كـ PWA. بالنسبة للجزء الأكبر، يوفر هذا التخزين المؤقت المخصص. كما يسمح أيضًا "بتثبيت" هذه المدونة على نظام Android (على الرغم من أنني لست مهتمًا حقًا بهذه الوظيفة).