تُعد إضافة Discourse Docs أداة قوية تحول منتدى Discourse الخاص بك إلى قاعدة معرفة مدعومة من المجتمع. توفر قسمًا مخصصًا للوثائق حيث يمكن للمستخدمين إنشاء وتحديث وتنظيم الوثائق. تتميز هذه الإضافة بزر Docs يسهل الوصول إلى هذا القسم. إنها طريقة رائعة للاستفادة من المعرفة الجماعية لمجتمعك وتوفير مورد مركزي للمعلومات المهمة.
بشكل أساسي، تتيح Docs تسهيل ظهور مواضيع بأسلوب قاعدة المعرفة عبر مجموعة محددة من الفئات و/أو الوسوم.
لكي ي生效 التغيير، يمكنك إما تشغيل ./launcher rebuild app، أو، نظرًا لأنه متغير بيئة، يمكنك تشغيل ./launcher destroy app && ./launcher start app لتقليل وقت التوقف. هناك المزيد من المعلومات حول ذلك هنا - Set Environmental Variables
قد ترغب أيضًا في تغيير نص عرض الموقع ليتناسب مع التغيير. يمكنك البحث عن جميع حالات كلمة ‘docs’ من صفحة /admin/customize/site_texts، ولكن أهمها هي:
لقد واجهت الخطأ التالي عند تنفيذ المواصفات. لم أقم بتغيير أي ملفات. هل يمكنني تجاهل هذا الخطأ؟
➜ discourse git:(main) ✗ LOAD_PLUGINS=1 bundle exec rspec plugins/discourse-docs/spec
Randomized with seed 57815
...................................F
Failures:
1) Discourse Docs | Index topic excerpts when the theme modifier serialize_topic_excerpts is true shows the excerpts
Failure/Error: expect(page).to have_css(".topic-excerpt", text: topic_1.excerpt)
expected to find css ".topic-excerpt" but there were no matches
[Screenshot Image]: /xxxx/discourse/discourse/tmp/capybara/failures_r_spec_example_groups_discourse_docs_index_topic_excerpts_when_the_theme_modifier_serialize_topic_excerpts_is_true_shows_the_excerpts_460.png
~~~~~~~ JS LOGS ~~~~~~~
~~~~~ END JS LOGS ~~~~
# ./plugins/discourse-docs/spec/system/docs_index_spec.rb:52:in `block (4 levels) in <main>'
# ./spec/rails_helper.rb:469:in `block (2 levels) in <top (required)>'
Finished in 13.16 seconds (files took 2.79 seconds to load)
36 examples, 1 failure
Failed examples:
rspec ./plugins/discourse-docs/spec/system/docs_index_spec.rb:50 # Discourse Docs | Index topic excerpts when the theme modifier serialize_topic_excerpts is true shows the excerpts
Randomized with seed 57815
عذرًا @JammyDodger لم أحصل على فرصة لتشغيل المواصفات هذه الأيام. لا أركز على العمل المتعلق بوثائق Discourse ولكن على أمور أخرى هذه الأيام. لكن سأعلمك عندما أحصل على أي فرصة.
هذا المكون الإضافي رائع لوجود جميع فئات مستنداتنا في مكان واحد - مما يزيل الحاجة إلى إدراجها أيضًا في قائمة الفئات (شكرًا لـ Discourse Category Hider). ومع ذلك، لاحظنا مشكلة:
ضمن المكون الإضافي/شاشة المستندات، لا يمكنك تعديل المستندات الموجودة أو إنشاء مستندات جديدة - مما يعني أنه يتعين عليك الانتقال إلى الفئة الأصلية للعثور على الموضوع/المستند لتعديله… مما يعني أنه يتعين عليك إتاحة المستند في أكثر من مكان واحد.
هل هناك طريقة لتمكين تعديل الموضوع/المستند (إذا كان المستخدم في مجموعة المستخدمين الصحيحة) ضمن المكون الإضافي للمستندات؟
عندما أقوم بإنشاء مستند، فإنه ينتقل إلى منطقة المستندات ويعمل كما هو مفترض، ولكن إذا تم تعديل المستند بأي شكل من الأشكال، فإن تخطيط مستند قائمة المستندات يعود إلى تخطيط موضوع المناقشة الافتراضي عند النقر عليه ولا يُظهر تخطيط المستند الفعلي.
لاحظت أنه بعد بضع دقائق يعود إلى تخطيط مستند المناقشة ويبدو كما هو مفترض، هل هناك أي شيء يمكن أن يسبب هذا؟
ملاحظة: أستخدم أيضًا مكون السمة “مصغرات المناقشة” وتم تعيينه على وضع مصغرات المستندات “قائمة”.
تم العثور على المشكلة، يبدو أنه إذا استخدمت مكون السمة Topic List Excerpts أو Topic lists Thumbnails فإن الرابط القابل للنقر يكون لصفحة موضوع discourse وليس لـ docs?topic=xxx، لذلك يتم إعادة توجيهي إلى مواضيع discourse.
هل هناك طريقة للحفاظ على مسار عنوان URL الخاص بالمستندات إلى المستندات @sam أو يجب أن أتواصل مع @david؟
أتساءل عما إذا كان من الأفضل إغلاق الشريط الجانبي تلقائيًا، إذا كان عرض الشاشة أقل من المثالي؛ ومع ذلك، حتى لو أغلقت الشريط الجانبي، فإن المحتوى سيظل يتجاوز الحدود.
شكراً على الإضافة الرائعة. سؤال واحد رغم ذلك: هل هناك خيار لإزالة الرابط من قائمة الهامبرغر السياقية؟ لقد أضفته يدوياً في القسم المرئي دائماً (حيث نريد استخدام هذه الوظيفة لعرض محتوى طويل ينشئه المستخدمون مثل المقالات وما إلى ذلك) وانتهى بي الأمر بظهوره مرتين:
لقد قمت بزيارة نفس الرابط مرة أخرى على جهاز بنفس عرض منفذ العرض. بينما كان لا يزال هناك فيضان قبل طي الشريط الجانبي، وجدت أنه بعد طيه، لا يوجد فيضان، والعرض طبيعي وجذاب بصريًا.
اليوم قمت بنشر بعض المواضيع في فئة المستندات، ولكن هذه المواضيع لم تظهر في صفحة المستندات. لقد قمت بإيقاف تشغيل إضافة المستندات وتشغيل السمة مرة أخرى، ولكن هذه المواضيع لا تزال غير معروضة.
شكرا لك!
يتم إيقاف هذا الإضافة لصالح إضافة فئات الوثائق التجريبية. سنواصل دعم Docs حتى لا تعد الإضافة الجديدة تجريبية بعد الآن.
هل تستضيفه معنا؟ إعادة تسمية مسار
