 |
الملخص | تحويل جدول في موضوع إلى عناصر قابلة للبحث يمكن للأعضاء ذكرها باستخدام +، مع روابط ومعاينات onebox. |
 |
المستودع | Discourse Mentionables |
 |
دليل التثبيت | تثبيت الإضافات على موقع Discourse المستضاف ذاتياً |
 |
الرعاية المالية | يرجى النظر في رعاية التطوير المستمر للمساعدة في الحفاظ على هذه الإضافات صالحة للعمل ومتوافقة مع إصدارات Discourse الحالية. |
امنح مجتمعك مفردات مشتركة للأمور التي يتحدثون عنها: كتب،
منتجات، مشاريع، أماكن، موارد دعم، أو أي شيء آخر له عنوان URL.
يكتب الأعضاء + وجزءاً من الاسم، يختارون اقتراحاً، ويحصلون على رابط مقروء دون الحاجة إلى تذكر العنوان.
الميزات
- ابدأ بالروابط فقط. يستورد أداة الاستيراد الأسماء وينشئ المعرفات (slugs)؛ أضف
أسماءً ومعرفات خاصة بك كتجاوزات اختيارية. - ابحث أثناء الكتابة. اكتب
+أو استخدم زر شريط أدوات المحرر للبحث
في فهرسك. يعمل في كلا محرري Markdown والنص الغني. - روابط مضمونة مقروءة. تظهر الإشارات كحبوب (pills) مضغوطة باستخدام اسم العرض
للعنصر، مع معرف ثابت في نص Markdown للمنشور. - مربعات onebox أصلية. ضع إشارة في سطر مستقل لعرض مربع onebox باستخدام
تخطيطات Discourse الموجودة والوجهات المدعومة. - معاينات سطح المكتب. مرر المؤشر فوق حبة مضمنة أو ركّز عليها لفتح معاينة عائمة
مع رابط فتح الصفحة الأصلية. النقرات العادية تفتح الوجهة. - فهرس يمكن للمشرفين تعديله في Discourse. استورد من جدول Markdown
في منشور افتتاحية الموضوع. لا حاجة لحساب Google أو بيانات اعتماد API. - زر جدول للمشرفين. إدراج جدول mentionables فارغ من
شريط أدوات المحرر، ثم املأ عناصرك.
يعتمد مظهر مربع onebox على الوجهة ودعم Discourse العادي لمربعات onebox.
تبقى الوجهات غير المدعومة كروابط. تتطلب البطاقات العائمة تسجيل الدخول؛
لا يزال بإمكان الضيوف اتباع رابط الوجهة. تُترك الإشارات داخل الأكواد كما هي،
وتبقى الإشارات داخل القوائم والاقتباسات مضمنة.
Mentionables الأساسية وإضافة Pro
Mentionables الأساسية هي الإضافة الأساسية. Pro هي إضافة مرافقة اختيارية
تُثبَّت بجانبها؛ تتضمن Pro الميزات الأساسية من خلال تلك الاعتمادية.
| الميزة | Mentionables الأساسية | مع إضافة Pro |
|---|---|---|
| استيراد جدول Markdown من منشور افتتاحية الموضوع | نعم | نعم |
| إبقاء موضوع المصدر في فئة مقيدة | نعم | نعم |
| زر محدد للمشرفين لإدراج هيكل جدول | نعم | نعم، بما في ذلك أعمدة الأيقونات |
البحث بـ + في محررات Markdown والنص الغني |
نعم | نعم |
| حبوب الإشارات المضمنة ومربعات onebox الأصلية المستقلة | نعم | نعم |
| معاينات عائمة عند مرور الفأرة أو التركيز بلوحة المفاتيح | نعم | نعم، في وضع التمرير الافتراضي |
| الاستيراد من جداول Google Sheets باستخدام حساب خدمة | — | نعم |
| الاختيار بين جداول المواضيع وجداول Google Sheets | جداول المواضيع فقط | نعم |
| مزامنة تلقائية كل 12 ساعة | — | اختياري، معطّل افتراضياً |
| استيراد أسماء أيقونات وألوان HTML اختيارية | — | نعم، من أي مصدر |
| فتح المعاينات العائمة بالنقر أو اللمس، بما في ذلك أجهزة اللمس | — | اختياري |
تضيف أعمدة icon وicon_colour في Pro أيقونة ملونة قبل اسم الإشارة.
على سبيل المثال، استخدم book و#2563eb لدليل المستخدم. مع تفعيل
mentionables_pro_click_to_preview، يفتح النقر أو اللمس على الحبة معاينتها؛
رابط فتح الصفحة الأصلية في المعاينة يأخذك إلى الهدف.
الإعداد السريع
-
ثبّت الإضافة الأساسية باستخدام دليل التثبيت أعلاه. أعد بناء Discourse
بعد التثبيت. -
أنشئ موضوعاً لفهرسك. بصفتك مشرفاً، استخدم إدراج جدول mentionables
في شريط أدوات المحرر أو الصق هذا الجدول في منشور الافتتاحية:| name | url | slug | image_url | | ------------------ | ----------------------------------- | ------------------ | --------- | | Getting started | https://example.com/getting-started | getting-started | | | Community handbook | https://example.com/handbook | community-handbook | | | Events calendar | https://example.com/events | events-calendar | | -
استبدل عناوين URL التجريبية بعناوينك الخاصة، احفظ المنشور، وقم بتعيين
mentionables_topic_idإلى الرقم التعريفي الرقمي لذلك الموضوع. حافظ على تفعيل
mentionables_enabled. يجب أن تختبر تركيبات Pro خيارtopic_tableفيmentionables_source
لهذا الإعداد. -
افتح الإدارة → الإضافات → Mentionables، انقر على بدء الاستيراد، ثم
تحديث لفحص التقرير. يجب أن يكون عامل مهمة الخلفية قيد التشغيل. -
أعد تحميل متصفحك، افتح محرراً، واكتب
+لتجربة عناصرك.
استخدم أسماء أعمدة بحروف صغيرة. عمود url هو المطلوب فقط، ويجب أن يبدأ بـ http://
أو https://. تسترجع الصفوف التي تحتوي على URL فقط اسماً من الوجهة وتولد
معرفاً (slug). يمكنك تقديم name أو slug أو كليهما لتجاوز تلك القيم الافتراضية، مع خلط
هذه الخيارات ضمن جدول واحد. إذا لم يتوفر عنوان، يصبح عنوان URL هو
اسم العرض. تحتفظ عناوين URL الموجودة بمعرفاتها عندما يحذف المصدر تلك المعلومات.
عمودا image_url وdescription اختياريان.
تقرأ أداة الاستيراد أول جدول غير مغلوم يحتوي على عمود url في منشور
الافتتاحية. يتم تجاهل الردود والجداول المقتبسة والعينات البرمجية المسوّرة. يجب أن تكون مواضيع المصدر
مواضيع عادية وغير محذوفة، وليس رسائل شخصية.
خصوصية المصدر وتحديث فهرسك
يمكنك إبقاء موضوع المصدر في فئة الموظفين (Staff) أو فئة مقيدة أخرى بحيث يتمكن
الأشخاص الموثوقون فقط من صيانته. الأسماء وعناوين URL والصور المستوردة
متاحة للمستخدمين الذين يستخدمون mentionables. تقييد الموضوع لا يجعل
الفهرس المستورد خاصاً. أبعد المعلومات السرية عن الجدول.
تقوم كل عملية استيراد بالمزامنة عبر عنوان URL: يتم تحديث عناوين URL المطابقة، وتُنشئ عناوين URL الجديدة سجلات،
وتحذف عناوين URL المُزالة من المصدر السجلات. يجب أن يكون المصدر كاملاً
صالحاً؛ عناوين URL المكررة أو المعرفات، الصفوف غير الصالحة، إخفاقات الاسترجاع، والمجموعات الفارغة
تترك الفهرس دون تغيير. استخدم حذف الكل للمسح المتعمد.
لا يتم تعديل مواضيع المصدر والجداول الإلكترونية أبداً. تعمل إعداد
mentionables_pro_sync_enabled الاختياري في Pro نفس الاستيراد كل 12 ساعة.
أعد تحميل المتصفح بعد الاستيراد. لا يتم إعادة خبز المنشورات المطبوخة الموجودة تلقائياً،
والتغيير الصريح للمعرف (slug) قد يكسر مراجع +slug السابقة.
الإعدادات ومعلومات إضافية
| الإعداد | الغرض |
|---|---|
mentionables_enabled |
تمكين أو تعطيل Mentionables. |
mentionables_topic_id |
الموضوع الذي يحتوي على جدول المصدر في منشور افتتاحيته. |
mentionables_autocomplete_limit |
الحد الأقصى لعدد الاقتراحات؛ القيمة الافتراضية خمسة. |
mentionables_onebox_fallback |
استرجاع الصور/الأوصاف المفقودة أيضاً عند توفير اسم؛ معطّل افتراضياً. |
راجع README لدليل الإعداد الكامل، وسلوك الاستيراد، واستكشاف الأخطاء.
تستخدم لقطات الشاشة بيانات تجريبية من حزم اختبار الإضافة.
