يتم تقاعد هذا الملحق لصالح ملحق فئات المستندات التجريبي. سنواصل دعم مستندات Discourse حتى لا يُعتبر الملحق الجديد تجريبيًا بعد الآن.
 |
ملخص | يوفر ملحق Discourse Docs إمكانية البحث في مواضيع قاعدة المعرفة وتصفيتها |
 |
رابط المستودع | https://github.com/discourse/discourse-docs |
 |
دليل التثبيت | كيفية تثبيت الملحقات في Discourse |
الميزات
يُعد ملحق مستندات Discourse أداة قوية تحول منتدى Discourse الخاص بك إلى قاعدة معرفة مدعومة من المجتمع. يوفر قسمًا مخصصًا للمستندات حيث يمكن للمستخدمين إنشاء وتحديث وتنظيم الوثائق. يتميز هذا الملحق بزر مستندات يتيح الوصول السهل إلى هذا القسم. إنها طريقة رائعة للاستفادة من المعرفة الجماعية لمجتمعك وتوفير مورد مركزي للمعلومات الهامة.
في جوهره، يسمح مستندات بظهور أسهل لمواضيع بأسلوب قاعدة المعرفة عبر مجموعة محددة من الفئات و/أو الوسوم.
قم بتصفية القائمة حسب الوسوم، ابحث عبر شريط البحث، وانقر على المواضيع لرؤية المنشور الأول — كل ذلك دون مغادرة سياق مستكشف المعرفة.
هل تحتاج إلى العثور على موضوع قاعدة معرفة من مكان آخر في Discourse؟ استخدم مساعد البحث الجديد: in:kb.
التكوين
-
قم بتفعيل الملحق بتفعيل إعداد
docs enabled. -
أضف الفئات والوسوم إلى إعدادات
docs categoriesوdocs tags. -
ابحث عن رابط مستندات في قائمة التنقل.
- استمتع بالوصول السهل إلى المعرفة!
الإعدادات
| الاسم | الوصف |
|---|---|
| docs enabled | تفعيل ملحق مستندات |
| docs categories | قائمة بأسماء الفئات (slugs) المراد تضمينها في المستندات |
| show tags by group | تنظيم الوسوم باستخدام مجموعات الوسوم. أنشئ مجموعات لتصنيف الوسوم ذات الصلة. |
| docs tag groups | مجموعات الوسوم المستخدمة لعرض الوسوم حسب المجموعة |
| docs tags | قائمة بالوسوم المراد تضمينها في المستندات |
| docs add solved filter | يضيف فلتر للمواضيع المحلولة — يتطلب تثبيت وتفعيل ملحق Discourse Solved |
| docs add to top menu | يضيف رابطًا إلى القائمة العلوية للتنقل إلى عرض المستندات |
| docs add search menu tip | يضيف النص الإرشادي “in:docs” إلى نصائح القائمة العشوائية للبحث |
شراكات مفيدة
إعادة تسمية مسار /docs
إذا كان لديك وصول إلى الخادم، يمكنك تغيير مسار رابط /docs الخاص بك عن طريق إضافة متغير بيئة DISCOURSE_DOCS_PATH: إلى ملف app.yml:
لكي يعم التغيير، يمكنك إما تشغيل ./launcher rebuild app، أو، نظرًا لأنه متغير بيئة، يمكنك تشغيل ./launcher destroy app && ./launcher start app لتقليل وقت التوقف. هناك المزيد من المعلومات حول ذلك هنا - Set Environmental Variables
قد ترغب أيضًا في تغيير نص عرض الموقع ليتوافق مع ذلك. يمكنك البحث عن جميع حالات كلمة ‘docs’ من صفحة /admin/customize/site_texts، لكن الأهم منها هي:
- js.docs.title
- js.sidebar.docs_link_text
هل تستضيفه معنا؟ إعادة تسمية مسار
/docsمتاحة فقط في خطتنا المؤسسية. يرجى الاتصال بنا إذا كنت ترغب في معرفة المزيد.
تاريخ التطوير
كان ملحق مستندات استمرارًا لـ مكون موضوع مستكشف المعرفة.