هناك العديد من الحلول مفتوحة المصدر التي تدعم إنشاء مدونات تعتمد على Markdown ووظيفة التعليقات. من الأمثلة البارزة على ذلك منصة مدونات قائمة على GitHub تُدعى fastpages، والتي تتيح لك إنشاء منشورات مدونة مكتوبة بلغة Markdown وتتم إدارة وظيفة التعليقات من خلال نظام مفتوح المصدر يُدعى Utterances1.
المنصات الرئيسية ونظام التعليقات #
| العنصر | الوصف |
|---|---|
| محرك المدونة | يمكن استخدام أدوات إنشاء المواقع الثابتة المتنوعة مثل Jekyll وEleventy وfastpages لإنشاء مدونات تعتمد على Markdown. |
| نظام التعليقات | - Utterances: يدير التعليقات باستخدام قضايا GitHub، ويمكن دمجه بسهولة مثل fastpages. - Isso: نظام تعليقات خفيف يعتمد على Python، ويركز على متطلبات خادم منخفضة وحماية الخصوصية. - Remark42: نظام تعليقات قائم على Go، يوفر واجهة نظيفة مع تسجيل دخول اجتماعي وميزات متنوعة لمكافحة الرسائل غير المرغوب فيها. - Talkyard: منصة نقاش شاملة تقدم وظيفة التعليقات بالإضافة إلى ميزات المنتديات والدردشات. |
تُقدم هذه الحلول جميعها كمصدر مفتوح، مما يسمح للمستخدمين باستضافة أنفسهم أو بناءها بسهولة عبر طرق مثل حاويات Docker234. إلى جانب ذلك، من السهل دمج fastpages مع GitHub Pages للحصول على وظيفة تعليقات أساسية بشكل سريع1. في المقابل، إذا كنت تستخدم مدونة قائمة على Eleventy أو Jekyll، يمكنك اختيار أحد أنظمة التعليقات المذكورة أعلاه ودمجه، مما يتيح لك تخصيصها وفقاً لاحتياجاتك.
ملخص #
إذا كنت ترغب في إضافة وظيفة التعليقات إلى مدونة مكتوبة بلغة Markdown، يمكنك استخدام منصة مثل fastpages التي تقدم وظيفة التعليقات المدمجة (على سبيل المثال Utterances)، أو يمكنك دمج أنظمة تعليقات منفصلة مثل Isso وRemark42 وTalkyard مع أدوات إنشاء المواقع الثابتة مثل Jekyll أو Eleventy. تختلف الحلول من حيث صعوبة التثبيت ومتطلبات الخادم وحماية الخصوصية، لذا يمكنك اختيار ما يناسب بيئة التشغيل واحتياجاتك.
بهذه الطريقة، يمكن الجمع بين مشاريع مفتوحة المصدر وأنظمة التعليقات لتنفيذ وظيفة التعليقات بسهولة في المدونات المعتمدة على Markdown.
إذا كان ما تحتاجه هو ميزة الحواشي السفلية #
إذا كنت تريد تنفيذ وظيفة الحواشي السفلية في مستند Markdown، يمكنك اختيار الخيار الأنسب من بين عدة حلول مفتوحة المصدر لمشروعك. على سبيل المثال، إذا كنت تستخدم مُفسر Markdown القائم على JavaScript المُسمى markdown-it، يمكنك بسهولة تطبيق ملحق markdown-it-footnote الذي تم تقديمه في5. يدعم هذا الملحق الحواشي السفلية العادية والحواشي السفلية المُضمنة، ويتبع بناء الجملة المحدد من قبل Pandoc5.
الخيارات الرئيسية #
| الخيار | الخصائص | الوصف |
|---|---|---|
| markdown-it-footnote | ملحق markdown-it، قائم على JavaScript | يمكن دمجه بسهولة كملحق لمفسر Markdown، ويدعم بناء الجملة العادي والحواشي السفلية المُضمنة5 |
| Jekyll (Kramdown) | منشئ مواقع ثابتة قائم على Ruby، يأتي مع Kramdown مدمج | يدعم محرك Kramdown وظيفة الحواشي السفلية بدون الحاجة لملحقات إضافية67 |
| Hugo (Goldmark) | منشئ مواقع ثابتة قائم على Go، يدعم الحواشي السفلية في أحدث إصدار | يوفر محرك Goldmark دعمًا مدمجًا للحواشي السفلية، مما يتيح التنفيذ بسهولة باستخدام بناء جملة بسيط6 |
| Eleventy (11ty) | منشئ مواقع ثابتة قائم على JavaScript، قابل للتخصيص من قبل المستخدم | يمكنك استخدام Markdown-it مع إضافة ملحق الحواشي السفلية (مثل markdown-it-footnote) للاستفادة منها5 |
مثال على استخدام markdown-it-footnote #
إليك مثال بسيط على الشيفرة التي تستخدم markdown-it وmarkdown-it-footnote معًا:
const MarkdownIt = require('markdown-it');
const markdownItFootnote = require('markdown-it-footnote');
const md = new MarkdownIt().use(markdownItFootnote);
const result = md.render('هنا مرجع لحاشية,[^1]\n\n[^1]: هنا هي الحاشية.');
console.log(result);
تقوم هذه الشيفرة بتحويل إدخالات الحواشي السفلية في مستند Markdown إلى HTML، مع إنشاء قسم الإحالات والمنطقة الخاصة بالحاشية تلقائيًا5.
ملخص #
إذا كنت ترغب في إضافة وظيفة الحواشي السفلية إلى مدونة Markdown، يمكنك اختيار الحل المناسب اعتمادًا على بيئة الاستخدام لمشروعك. يعد ملحق markdown-it-footnote مفيدًا جدًا في المشاريع القائمة على JavaScript، بينما يمكن النظر إلى Jekyll (Kramdown) أو Hugo (Goldmark) إذا كنت تستخدم أدوات إنشاء مواقع ثابتة قائمة على Ruby أو Go567. جميع هذه الأدوات مفتوحة المصدر، مما يسمح لك بتخصيصها بسهولة لتحقيق الوظائف المطلوبة.