Discourse Footnote

:discourse2: Summary Discourse Footnote allows users to create markdown footnotes in posts.
:open_book: Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately.

Enabling Footnote

The Footnote plugin is default enabled but can be disabled/enabled from the admin/plugins page:

enable footnote

Features

Once enabled, you can add footnotes to your posts by typing them in like this:

A sentence that needs a footnote. ^[The footnote] 
Another sentence that needs a footnote. ^[The second footnote]

Or like this:

A sentence that needs a footnote. [^1] 
Another sentence that needs a footnote. [^2]

[^1]: The footnote
[^2]: The second footnote

You can mix and match both styles within a post, as well as use non-numbered anchors.

There are two ways to display the footnotes, controlled by the display footnotes inline admin setting:

Non-inline:

Inline:

A sentence that needs a footnote[1]
Another sentence that needs a footnote[2]

The inline versions are both Quote and mobile-friendly.

Settings

Name Description
enable markdown footnotes enable footnote markdown on this site
display footnotes inline enable inline expansion of footnotes

:discourse2: Hosted by us? This plugin is available on all of our hosting tiers Footnote | Discourse - Civilized Discussion

Development History

Discourse footnote re-packages the footnote markdown.it extension by @Vitaly as a Discourse plugin.


  1. The footnote ↩︎

  2. The second footnote ↩︎

Last edited by @tobiaseigen 2025-07-16T20:45:27Z

Check documentPerform check on document:
72 إعجابًا

مجرد تنبيه بأن الامتداد لا يبدو أنه يسمح بصيغة markdown العادية للحواشي السفلية باستخدام [^1]. لا أحصل على حواشي سفلية منسقة إلا إذا استخدمت التنسيق “المضمن”، هكذا:

يتيح تمكين الحواشي السفلية باستخدام تنسيق الحواشي السفلية المضمنة حواشي سفلية مرقمة تلقائيًا تظهر بعد ذلك أسفل المنشور معًا، بينما يتيح تمكين التوسيع المضمن أيضًا تجربة تشبه التلميح في النص مع عدم ظهور أي حواشي سفلية أسفل المنشور. إذا كان لديك خيار التوسيع المضمن ممكّنًا، فستبدو نافذة معاينة المنشور الخاصة بك كحواشي سفلية مرقمة تقليدية، ولكنك سترى التأثير الموسع المضمن بعد النشر.

أنا أقدر الحواشي السفلية المرقمة تلقائيًا باستخدام التنسيق المضمن، لقد استغرق الأمر مني بضع محاولات لمعرفة كيفية تنسيق markdown بالفعل وأي الخيارات ستجعلها تتصرف كما هو مرغوب فيه. آمل أن يساعد هذا التعليق شخصًا آخر على تجنب نفس الارتباك.

تعديل للإضافة: خيار التوسيع المضمن هو كيف ستظهر حواشيك السفلية على الهاتف المحمول، بغض النظر عما إذا كان هذا الخيار ممكّنًا (لأجهزة سطح المكتب أيضًا).

5 إعجابات

وصفة للسماح لمستخدميك بإنشاء محتوى منبثق مضمن باستخدام مكون Discourse Footnote الإضافي هذا:

اجمع بين هذا المكون الإضافي ومكون سمة زر الملاحظات في المحرر (Composer Footnote Button Theme Component) [1] (يوفر زرًا في المحرر لإنشاء ملاحظات)

يمكنك وضع أي شيء داخل النوافذ المنبثقة، بما في ذلك HTML.

أمثلة:

نص [2]


نص وتحميل صورة [3]


محتوى HTML [4]


  1. (قم بتثبيتهما كليهما) ↩︎

  2. نص عادي هنا. ↩︎

  3. نص وتحميل صورة

    ↩︎

  4. عندما تواجه مجموعة مفتوحة المصدر لأول مرة، قد تكون تجربة مربكة. سواء كنت تنشر على قائمة بريدية لأول مرة، أو تكتب مدونة عن المشروع الذي تتولاه، أو تتسكع في قناة IRC - فإن طريقة تفاعل الأشخاص، وما يتوقعونه من بعضهم البعض تختلف تمامًا عن الفصل الدراسي أو مع الأصدقاء والعائلة.


    الانفتاح والمشاركة

    يمكن أن يختلف التواصل مفتوح المصدر كثيرًا. قيمة أساسية مشتركة هي أن مشاركة الكود أمر جيد. بغض النظر عن الترخيص أو اللغة أو أسلوب المسافة البادئة، يقوم مطورو المصادر المفتوحة بإنشاء ومشاركة وتعديل الكود المصدري معًا.

    ↩︎

14 إعجابًا

هل تعمل إضافة الحاشية السفلية أيضًا على الصفحات العامة؟ في حالتي الخاصة، أريدها ألا تعمل على الصفحات العامة وأن تكون مرئية فقط في عرض الموضوع العادي (لاستخدامها للملاحظات الداخلية وما إلى ذلك)

@jrgong – لا…

ومع ذلك، هناك هذا النهج البديل والذي أقوم حاليًا بتطوير مكون سمة له… على Github.

إعجابَين (2)

يبدو أن هذا تم نقله إلى core قبل 17 ساعة.

سأترك شخصًا آخر يقوم بتحديث هذا بشكل مناسب.

Translation missing: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.
3 إعجابات

بعد الانتقال إلى core،

حذفت المكون الإضافي من app.yml وقمت بتشغيل ./launcher rebuild app،

لكن الإعدادات لا تزال موجودة في صفحة المكون الإضافي. هل من المقبول ترك الأمر هكذا؟

هذا هو الجديد. :+1: إليك لقطة لكليهما للمقارنة:

old one

new one

4 إعجابات

هذا صوت جميل حقًا! :+1: شكرًا لك على المشاركة. :smiling_face_with_three_hearts:

شكرًا على ذكر ذلك، لقد دفعت للتو إصلاحًا.

3 إعجابات

المسألة الأخرى هي أنك لم تعد بحاجة إلى تثبيت المكون الإضافي، وإذا قمت بتثبيته، فلن تحتاج إلى تضمين git clone في ملف yml الخاص بك.

إعجابَين (2)

كنت بطيئًا جدًا في تحديث الموضوع بالمعلومات الجديدة وسبقتني. :slight_smile:

سأضيف جزئي الآن على أي حال…


:information_source: تم الآن تجميع Discourse Footnote مع نواة Discourse، لذلك لن تحتاج هذه الإضافة إلى التثبيت بشكل منفصل. :partying_face:

إذا كنت تستضيف بنفسك، فيجب أن ترى بعض المعلومات على لوحة التحكم الخاصة بك حول إزالته من app.yml الخاص بك.

:discourse2: هل تستضيف بواسطة؟ لن يؤثر هذا التغيير عليك بأي شكل من الأشكال. :+1: يمكنك الاستمرار في الاستمتاع بهذه الإضافة وعدم القلق بشأن أي شيء.

4 إعجابات

نعم. أنا آسف لذلك.

هذا رائع! كنت أعرف أن لديك خطة. كان يجب أن أنتظر فقط، حيث أن الشيء الآخر الذي أشرت إليه كان في الواقع مشكلة تم التعامل معها بالفعل من قبل شخص آخر، وكان يجب أن أكون صبورًا فقط بما أنني كنت أعرف أنك ستتعامل معها. (وهي جميلة جدًا أيضًا!).

لم يمر سوى أقل من 24 ساعة، لذا، كما تعلم، هذا جيد جدًا أيضًا.

شكرًا.

4 إعجابات

تم تقسيم 3 مشاركات إلى موضوع جديد: خيار إضافة حاشية سفلية إلى قائمة تروس المنشئ

هل هناك طريقة لجعل التذييل السفلي ينسق بشكل طبيعي؟ بحيث لا يكون مضمنًا مع النقاط الثلاث، هكذا؟[1]

وبدلاً من ذلك، هل يبدو هكذا؟


  1. هذا يبدو غريبًا بالنسبة لي ↩︎

هل هذا هو الإعداد؟

إعجاب واحد (1)

نعم، لكنني كنت أعني ذلك كمستخدم عادي، وليس كمسؤول يغير إعدادًا.

لا، لا توجد إعدادات للمستخدم لهذا. فقط إعداد واحد عالمي.

إعجاب واحد (1)

ألاحظ أن التذييل لا يسمح باستخدام الكثير من صيغة ماركداون الشائعة داخل أقواس التذييل[1]

ليس أمرًا جللًا، ولكنه بالتأكيد يحد من وظائف ما يمكنك وضعه في التذييل!


  1. مثال: هذا داخل قوس تذييل، لكن التخطيط يتعطل كلما أدخلت فقرات أو رؤوسًا أو قوائم وما إلى ذلك.\n\nهنا فاصل فقرة. ↩︎

يمكنك القيام بذلك، تأكد من ترك مسافة بادئة بـ 4 مسافات على الأقل.

على سبيل المثال:


هنا مرجع لحاشية سفلية[^1]، وآخر[^longnote].

[^1]: هنا الحاشية السفلية.

[^longnote]: هذه واحدة بها عدة كتل.

    الفقرات اللاحقة تكون بمسافة بادئة لإظهار أنها
تنتمي إلى الحاشية السفلية السابقة.

    * عنصر1
    * عنصر 2

    **المزيد** من النص

    *مائل*

هنا مرجع لحاشية سفلية[1]، وآخر[2].

يتم عرضه كالتالي:


  1. هنا الحاشية السفلية. ↩︎

  2. هذه واحدة بها عدة كتل.

    الفقرات اللاحقة تكون بمسافة بادئة لإظهار أنها
    تنتمي إلى الحاشية السفلية السابقة.

    • عنصر1
    • عنصر 2

    المزيد من النص

    مائل ↩︎