يتم إيقاف هذا الإضافة لصالح إضافة فئات الوثائق التجريبية. سنواصل دعم Docs حتى لا تعد الإضافة الجديدة تجريبية بعد الآن.
 |
ملخص | توفر Discourse Docs إمكانية البحث عن مواضيع قاعدة المعرفة وتصفيتها |
 |
رابط المستودع | https://github.com/discourse/discourse-docs |
 |
دليل التثبيت | كيفية تثبيت الإضافات في Discourse |
الميزات
تُعد إضافة Discourse Docs أداة قوية تحول منتدى Discourse الخاص بك إلى قاعدة معرفة مدعومة من المجتمع. توفر قسمًا مخصصًا للوثائق حيث يمكن للمستخدمين إنشاء وتحديث وتنظيم الوثائق. تتميز هذه الإضافة بزر Docs يسهل الوصول إلى هذا القسم. إنها طريقة رائعة للاستفادة من المعرفة الجماعية لمجتمعك وتوفير مورد مركزي للمعلومات المهمة.
بشكل أساسي، تتيح Docs تسهيل ظهور مواضيع بأسلوب قاعدة المعرفة عبر مجموعة محددة من الفئات و/أو الوسوم.
قم بتصفية القائمة حسب الوسوم، وابحث عبر شريط البحث، وانقر على المواضيع لرؤية المنشور الأول – كل ذلك دون مغادرة سياق مستكشف المعرفة.
هل تحتاج إلى العثور على موضوع من قاعدة معرفة من مكان آخر في Discourse؟ استخدم مساعد البحث الجديد: in:kb.
التكوين
-
فعّل الإضافة بتفعيل إعداد
docs enabled. -
أضف الفئات والوسوم إلى إعدادات
docs categoriesوdocs tags. -
ابحث عن رابط Docs في قائمة التنقل.
- استمتع بوصول أسهل إلى المعرفة!
الإعدادات
| الاسم | الوصف |
|---|---|
| docs enabled | تفعيل إضافة Docs |
| docs categories | قائمة من أسماء الفئات (slugs) لتضمينها في الوثائق |
| show tags by group | تنظيم الوسوم باستخدام مجموعات الوسوم. قم بإنشاء مجموعات لتصنيف الوسوم ذات الصلة. |
| docs tag groups | مجموعات الوسوم المستخدمة لعرض الوسوم حسب المجموعة |
| docs tags | قائمة من الوسوم لتضمينها في الوثائق |
| docs add solved filter | يضيف فلتر للمواضيع المحلولة – يتطلب تثبيت وتفعيل إضافة Discourse Solved |
| docs add to top menu | يضيف رابطًا إلى القائمة العلوية للتنقل إلى عرض Docs |
| 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متاحة فقط في خطتنا المؤسسية. يرجى الاتصال بنا إذا كنت ترغب في معرفة المزيد.
تاريخ التطوير
كانت إضافة Docs استمرارًا لـ مكون موضوع مستكشف المعرفة.