يقدم هذا الدليل نظرة عامة شاملة على إمكانيات البحث في Discourse، بما في ذلك المرشحات (الفلاتر) والخيارات والتقنيات المتقدمة.
مستوى المستخدم المطلوب: جميع المستخدمين
يوفر Discourse وظيفة بحث قوية مع العديد من المرشحات والمعايير. عند استخدام نموذج البحث المتقدم، فإنه يضيف تلقائيًا بناء الجملة (syntax) ذي الصلة إلى استعلامك. على سبيل المثال، سيؤدي تحديد \[x\] في رسائلي إلى إضافة
in:personalإلى استعلام البحث الخاص بك.يغطي هذا الدليل جميع خيارات وميزات البحث المتاحة في Discourse، ويقدم نصائح وحيلًا مفيدة لاستخدام وظيفة البحث.
المرشحات (Filters)
يوفر Discourse مجموعة واسعة من المرشحات لمساعدتك في تضييق نتائج البحث. إليك قائمة شاملة بالمرشحات المتاحة:
| بناء الجملة (Syntax) | الوصف |
|—|—|
|in:personal-direct| يُرجع المشاركات في الرسائل الشخصية بين مستخدمين فقط |
|in:all-pms|للمسؤولين فقط
يُرجع المشاركات من جميع الرسائل الشخصية، بما في ذلك تلك التي لست جزءًا منها |
|in:all| يُرجع المشاركات من المواضيع العامة والرسائل الشخصية |
|in:replies| يُرجع فقط المشاركات التي هي ردود، ويستثني منشئي المواضيع الأصليين (OPs) |
|in:all-posts| يُرجع كل مشاركة تطابق الاستعلام، حتى عند تطابق مشاركات متعددة ضمن نفس الموضوع |
|in:tagged| يُرجع المشاركات من المواضيع التي تحتوي على وسم (tag) واحد على الأقل |
|in:untagged| يُرجع المشاركات من المواضيع التي ليس لها وسوم |
|in:seen| يُرجع المشاركات التي رأيتها (للمستخدمين المسجلين الدخول) |
|in:unseen| يُرجع المشاركات التي لم ترها (للمستخدمين المسجلين الدخول) |
|in:wiki| يُرجع مشاركات الويكي |
|in:watching| يُرجع المشاركات من المواضيع التي تتابعها |
|in:tracking| يُرجع المشاركات من المواضيع التي تتتبعها |
|posts_count:X| يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة بالضبط |
|min_posts:X| يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة على الأقل |
|max_posts:X| يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة كحد أقصى |
|min_views:X| يُرجع المشاركات من المواضيع التي تحتوي على X مشاهدة على الأقل |
|max_views:X| يُرجع المشاركات من المواضيع التي تحتوي على X مشاهدة كحد أقصى |
|badge:name_or_id| يُرجع المشاركات المرتبطة بمنح وسام معين |
|created:@username| يُرجع المشاركات من المواضيع التي أنشأهاusername|
|group:group_name| يُرجع المشاركات من المستخدمين داخل المجموعةgroup_name|
|group_messages:group_name| يُرجع المشاركات من الرسائل الشخصية المرسلة إلى المجموعةgroup_name|
|personal_messages:username|للمسؤولين فقط
يُرجع المشاركات من الرسائل الشخصية للمستخدم المحدد |
|-tags:tag1,tag2,tag3| يُرجع المشاركات التي لا تحمل الوسومtag1أوtag2أوtag3|
|filetypes:ext1,ext2,ext3| يُرجع المشاركات التي تحتوي على مرفقات بالامتداداتext1أوext2أوext3|
|categories:category1,category2| يُرجع المشاركات من الفئاتcategory1وcategory2|
|status:open| يُرجع المشاركات من المواضيع غير المغلقة أو المؤرشفة |
|status:closed| يُرجع المشاركات من المواضيع المغلقة |
|status:archived| يُرجع المشاركات من المواضيع المؤرشفة |
|status:noreplies| يُرجع المشاركات من المواضيع التي ليس لها ردود |
|status:single_user| يُرجع المشاركات من المواضيع التي تحتوي على مشاركات من مستخدم واحد فقط |
|status:public| يُرجع المشاركات من المواضيع الموجودة في فئات عامة |
|before:YYYY-MM-DD| يُرجع المشاركات التي تم إنشاؤها قبل التاريخ المحدد |
|after:YYYY-MM-DD| يُرجع المشاركات التي تم إنشاؤها بعد التاريخ المحدد |
|with:images| يُرجع المشاركات التي تحتوي على صور |الترتيب (Order)
يمكنك فرز نتائج البحث الخاصة بك باستخدام خيارات الترتيب التالية:
| بناء الجملة (Syntax) | الوصف |
|----|----|
|order:latest| يفرز النتائج من الأحدث إلى الأقدم (اختصار: l) |
|order:oldest| يفرز النتائج من الأقدم إلى الأحدث |
|order:latest_topic| يفرز النتائج حسب تاريخ الموضوع، من الأحدث إلى الأقدم |
|order:oldest_topic| يفرز النتائج حسب تاريخ الموضوع، من الأقدم إلى الأحدث |
|order:views| يفرز النتائج حسب عدد المشاهدات |
|order:likes| يفرز النتائج حسب عدد الإعجابات | |
|order:read| (للمسجلين فقط) يفرز حسب تاريخ آخر زيارة للموضوع (اختصار: r) | |الأسماء المستعارة (Aliases)
يوفر Discourse العديد من الأسماء المستعارة لتسهيل البحث:
| بناء الجملة (Syntax) | المكافئ |
|----|----|
|l|order:latest|
|in:personal|in:messages|
|min_post_count:|min_post:|
|in:mine|in:created|
|category:|categories:|
|#| يمكن استخدامه لكل من الفئات والوسوم، حسب السياق |
|user:|@|
|@me|@your_own_username|
|f|in:first|
|t|in:title|البحث عن كلمات مطابقة تمامًا
يستخدم Discourse تقنية تسمى التجذيع (Stemming) للعثور على الكلمات ذات الصلة. في حين أن هذا مفيد غالبًا، قد تكون هناك أوقات تريد فيها البحث عن كلمة مطابقة تمامًا. يمكنك القيام بذلك عن طريق إحاطة كلمتك بمسافات وعلامات اقتباس مزدوجة، هكذا:
\" term \".يضمن هذا أنه سيبحث فقط عن كلمة “term” ويستبعد الكلمات الأخرى ذات الصلة.
لاحظ أنه نظرًا لاعتبار المسافات جزءًا من مصطلح البحث، فلن يتم إرجاع “term” إذا كانت الكلمة الأولى أو الأخيرة في المشاركة لأنه لن يسبقها أو يتبعها مسافة.
مثال: البحث عن الإشارات (@mentions)
حاليًا، البحث عن الإشارات (@mentions) غير مدعوم مباشرة. ومع ذلك، يمكنك تحقيق ذلك باستخدام طريقة البحث عن الكلمات المطابقة تمامًا:
\u003chttps://meta.discourse.org/search?q=“%20%40username%20”\u003e
يعمل هذا لأن
%20هو كيفية ترميز المسافات في عناوين URL و%40هو كيفية ترميز رمز@.سيقوم هذا الاستعلام بالبحث تحديدًا عن
@username(محاطًا بمسافات).دمج خيارات البحث
يمكنك دمج خيارات بحث متعددة لإنشاء استعلامات أكثر تحديدًا. على سبيل المثال:
status:open category:support tag:urgent after:2023-01-01 order:latest
سيبحث هذا عن مواضيع الدعم المفتوحة الموسومة بأنها عاجلة، والتي تم إنشاؤها بعد 1 يناير 2023، ويفرز النتائج حسب أحدث مشاركة.
@jane_doe in:watching min_posts:5 with:images
سيبحث هذا عن مشاركات بواسطة Jane Doe في المواضيع التي تتابعها، والتي تحتوي على 5 مشاركات على الأقل، وتحتوي على صور.الأذونات والقيود
قد تتطلب بعض خيارات البحث المتقدمة أذونات مستخدم معينة أو قد تقتصر على أدوار مستخدم محددة. على سبيل المثال:
in:all-pmsمتاح فقط للمسؤولين، وليس للمستخدمين العاديين أو المشرفين.personal_messages:usernameمتاح فقط للمسؤولين.ضع دائمًا في اعتبارك دورك وصلاحياتك عند استخدام خيارات البحث المتقدمة.
بديل البحث: مرشح قائمة المواضيع (Topic List Filter)
تتوفر ميزة تجريبية /filter تدعم العديد من أنواع المرشحات. يمكنك معرفة المزيد على الموضوع الرسمي: Experimental topics list filter feature
ملفات المصدر (Source Files)
للحصول على نظرة أكثر تقنية على هذه الخيارات، يمكن العثور على جميع مرشحات ومعلمات البحث في
search.rb- ابحث عن طرقadvanced_filter.نصائح إضافية
يمكنك أيضًا البحث عن إشارات للوسوم مثل Bug \u003chttps://meta.discourse.org/search?q=“%20%23bug”\u003e
قد تتم إضافة بعض المرشحات بواسطة الإضافات (plugins). على سبيل المثال، تضيف إضافة Solved ما يلي:
status:solved: يُرجع المشاركات من المواضيع التي تم حلهاstatus:unsolved: يُرجع المشاركات من المواضيع التي لم يتم حلها في الفئات التي تسمح بوضع علامة “تم الحل”تضيف إضافة Topic Voting خيار ترتيب إضافي:
order:votes: يفرز النتائج حسب عدد الأصوات على الموضوع الذي يحتوي على المشاركة
خذ بعض الوقت لتجربة مجموعات مختلفة من المرشحات والخيارات للعثور على استراتيجية البحث الأكثر فعالية لاحتياجاتك.
نظرًا لعدم وجود بعض الفلاتر، مثل in:pinned أو in:bookmarks وتلك التي لها اسم مستعار غير مشروحة، حاولت إضافة المعلومات المفقودة. بعد ذلك، أصبحت القائمة معقدة للغاية، ولهذا السبب حاولت فصلها إلى قوائم أصغر. هذا شيء فعله الروبوت أيضًا هنا. لست متأكدًا من أن الشروحات كلها صحيحة. الأوصاف في الموضوع وتلك الموجودة في محادثة @sam مع الروبوت تختلف. بالنسبة للبعض، سألت الروبوت مرة أخرى وحصلت على نتيجة مختلفة (هذه هي المظللة). ربما يمكن لشخص ما المساعدة في تصحيح الأوصاف. أنا أيضًا لست سعيدًا تمامًا بالمظهر العام. أعمدة القائمة لها عرض مختلف.
الفلاتر
فلاتر البحث
| الصيغة | الوصف |
|---|---|
topic:topic_id |
يُرجع المشاركات في موضوع معين |
in:titlet |
يُرجع المواضيع التي تحتوي على المصطلح في العنوان |
in:first f |
يُرجع المشاركات الأولى فقط في المواضيع |
in:replies |
يُرجع المشاركات التي هي ردود فقط، ويستثني المشاركات الأولى في المواضيع (OPs) |
in:regular |
يستثني مشاركات الإجراءات الصغيرة، والهمسات، والمشاركات التي تم تطبيق لون الموظفين عليها |
in:whispers in:whisper |
يُرجع مشاركات الهمس |
include:unlisted include:invisible |
يُرجع المشاركات، بما في ذلك تلك الموجودة في المواضيع غير المدرجة |
in:all |
يُرجع المشاركات من المواضيع العامة والرسائل الخاصة/mark> |
in:all-posts |
يُرجع كل مشاركة تطابق الاستعلام، حتى عند تطابق مشاركات متعددة ضمن نفس الموضوع |
in:pinned |
يُرجع المشاركات المثبتة |
in:wiki |
يُرجع مشاركات الويكي |
with:images |
يُرجع المشاركات التي تحتوي على صور |
filetypes:ext1,ext2,ext3 filetype:ext1,ext2,ext3 |
يُرجع المشاركات التي تحتوي على عمليات تحميل بالامتدادات ext1 أو ext2 أو ext3 |
badge:name_or_id |
يُرجع المشاركات المرتبطة بمنح شارة محددة |
فلاتر الرسائل
(للمستخدمين المسجلين)
| الصيغة | الوصف |
|---|---|
in:personal in:messages |
يُرجع المشاركات من الرسائل الشخصية |
in:personal-direct |
يُرجع المشاركات من الرسائل الشخصية بينك وبين مستخدم واحد بالضبط |
group_messages:group_name_or_id |
يُرجع المشاركات من الرسائل الشخصية المرسلة إلى المجموعة group_name (يعمل هذا فقط عندما تكون المجموعة وأعضاؤها مرئيين لك) |
personal_messages:username |
يُرجع المشاركات من الرسائل الشخصية للمستخدم المحدد |
in:all-pms |
يُرجع المشاركات من جميع الرسائل الشخصية، بما في ذلك تلك التي لست جزءًا منها |
فلاتر خاصة بالمستخدم والمجموعة
| الصيغة | الوصف |
|---|---|
@username user:username_or_id |
يُرجع المشاركات بواسطة username |
created:@username in:first @username |
يُرجع المشاركات الأولى في المواضيع التي أنشأها username |
group:group_name_or_id |
يُرجع المشاركات من المستخدمين داخل المجموعة group_name |
in:bot in:bots |
يُرجع المشاركات من حسابات النظام والروبوتات (مثل @system، @discobot) |
in:humanin:humans |
يُرجع المشاركات من المستخدمين العاديين |
فلاتر الفئة والوسم
| الصيغة | الوصف |
|---|---|
category:category1 #category1 |
يُرجع المشاركات من category1 وفئاتها الفرعية |
category:=category1 #=category1 |
يُرجع المشاركات من category1، باستثناء فئاتها الفرعية |
categories:category1,category2category:category1,category2 |
يُرجع المشاركات من الفئات category1 وcategory2 وفئاتها الفرعية |
categories:=category1,=category2category:=category1,=category2 |
يُرجع المشاركات من الفئات category1 وcategory2، باستثناء فئاتها الفرعية. |
tag:tag1 #tag1 |
يُرجع المشاركات من المواضيع الموسومة بـ tag1 |
-tag:tag1 |
يُرجع المشاركات من المواضيع غير الموسومة بـ tag1 |
tags:tag1,tag2 tag:tag1,tag2 |
يُرجع المشاركات من المواضيع الموسومة بـ tag1 أو tag2 |
-tags:tag1,tag2-tag:tag1,tag2 |
يُرجع المشاركات من المواضيع غير الموسومة بـ tag1 أو tag2 |
tags:tag1+tag2 \u003cbr\u003e tag:tag1+tag2 |
يُرجع المشاركات من المواضيع الموسومة بـ tag1 وtag2 |
-tags:tag1+tag2 \u003cbr\u003e -tag:tag1+tag2 |
يُرجع المشاركات من المواضيع غير الموسومة بـ tag1 وtag2 |
in:tagged |
يُرجع المشاركات من المواضيع التي تحتوي على وسم واحد على الأقل |
in:untagged |
يُرجع المشاركات من المواضيع التي ليس لها وسوم |
فلاتر مخصصة (خاصة بالمستخدم)
(للمستخدمين المسجلين)
| الصيغة | الوصف |
|---|---|
in:seen |
يُرجع المشاركات التي رأيتها |
in:unseen |
يُرجع المشاركات التي لم ترها |
in:watching |
يُرجع المشاركات من المواضيع التي تتابعها |
in:tracking |
يُرجع المشاركات من المواضيع التي تتتبعها |
in:bookmarks |
يُرجع المشاركات التي وضعت لها إشارة مرجعية |
@me@your_own_username |
يُرجع المشاركات التي كتبتها |
in:posted |
يُرجع جميع مشاركات المواضيع التي شاركت فيها |
in:created in:mine |
يُرجع المشاركات الأولى للمواضيع التي كتبتها |
فلاتر عدد المشاركات والمشاهدات
| الصيغة | الوصف |
|---|---|
min_posts:X min_post_count:X |
يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة على الأقل |
max_posts:X |
يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة كحد أقصى |
posts_count:X |
يُرجع المشاركات من المواضيع التي تحتوي على X مشاركة بالضبط |
min_views:X |
يُرجع المشاركات من المواضيع التي تحتوي على X مشاهدة على الأقل |
max_views:X |
يُرجع المشاركات من المواضيع التي تحتوي على X مشاهدة كحد أقصى |
فلاتر التاريخ
جميع التواريخ بتوقيت UTC، نستخدم دائمًا بداية اليوم بتوقيت UTC كوقت بدء لأي فترة.
| الصيغة | الوصف |
|---|---|
before:YYYY-MM-DD |
يُرجع المشاركات التي تم إنشاؤها قبل التاريخ المحدد |
after:YYYY-MM-DD |
يُرجع المشاركات التي تم إنشاؤها بعد التاريخ المحدد |
before:day_of_week |
يُرجع المشاركات التي تم إنشاؤها قبل يوم الأسبوع المحدد |
after:day_of_week |
يُرجع المشاركات التي تم إنشاؤها في يوم الأسبوع المحدد وفي الأيام التي تليه |
before:X |
يُرجع المشاركات التي تم إنشاؤها قبل X أيام |
after:X |
يُرجع المشاركات التي تم إنشاؤها خلال X أيام الماضية |
before:month |
يُرجع المشاركات التي تم إنشاؤها قبل الشهر المحدد |
after:month |
يُرجع المشاركات التي تم إنشاؤها خلال الشهر المحدد وفي الأشهر التي تليه |
before:YYYY |
يُرجع المشاركات التي تم إنشاؤها قبل السنة المحددة |
after:YYYY |
يُرجع المشاركات التي تم إنشاؤها خلال السنة المحددة وفي السنوات التي تليها |
فلاتر الحالة
| الصيغة | الوصف |
|---|---|
status:open |
يُرجع المشاركات من المواضيع غير المغلقة أو المؤرشفة |
status:closed |
يُرجع المشاركات من المواضيع المغلقة |
status:archived |
يُرجع المشاركات من المواضيع المؤرشفة |
status:noreplies |
يُرجع المشاركات من المواضيع التي ليس لها ردود |
status:single_user |
يُرجع المشاركات من المواضيع التي تحتوي على مشاركات من مستخدم واحد فقط |
status:public |
يُرجع المشاركات من المواضيع الموجودة في الفئات العامة |
فلاتر اللغة
| الصيغة | الوصف |
|---|---|
locale:language_code |
يُرجع المشاركات المكتوبة بهذه اللغة، على سبيل المثال en، en_US، en-gb |
locale:any locale:present |
يُرجع المشاركات التي تم تعيين رمز لغة لها |
locale:none locale:null |
يُرجع المشاركات التي ليس لها رمز لغة |
الفلاتر المضافة بواسطة الإضافات
| الصيغة | الوصف |
|---|---|
| تعيين (Assign) | |
in:assigned |
يُرجع المشاركات من المواضيع المعينة لشخص ما |
in:unassigned |
يُرجع المشاركات من المواضيع غير المعينة لأي شخص |
assigned:username |
يُرجع المشاركات من المواضيع المعينة لـ username |
| وثائق (Docs) | |
in:docs in:kb |
يُرجع المشاركات من الفئات والوسوم المضمنة في الوثائق |
| فئات الوثائق (Doc Categories) | |
in:docs |
يُرجع المشاركات من الفئات التي تحتوي على موضوع فهرس |
| استطلاعات الرأي (Polls) | |
in:polls |
يُرجع المشاركات التي تحتوي على استطلاعات رأي |
| تم الحل (Solved) | |
status:solved |
يُرجع المشاركات من المواضيع التي تم حلها |
status:unsolved |
يُرجع المشاركات من المواضيع التي لم يتم حلها في الفئات التي تسمح بوضع علامة الحل |
| التصويت على المواضيع (Topic voting) | |
min_vote_count:X |
يُرجع المشاركات من المواضيع التي تحتوي على X أصوات على الأقل |
الترتيب
| الصيغة | الوصف |
|---|---|
order:latestl |
يفرز النتائج من الأحدث إلى الأقدم |
order:oldest |
يفرز النتائج من الأقدم إلى الأحدث |
order:latest_topic |
يفرز النتائج حسب تاريخ الموضوع، من الأحدث إلى الأقدم |
order:oldest_topic |
يفرز النتائج حسب تاريخ الموضوع، من الأقدم إلى الأحدث |
order:views |
يفرز النتائج حسب عدد المشاهدات |
order:likes |
يفرز النتائج حسب عدد الإعجابات |
order:readr |
يفرز النتائج حسب تاريخ آخر زيارة لك للموضوع |
خيارات الترتيب المضافة بواسطة الإضافات
| الصيغة | الوصف |
|---|---|
| التصويت على المواضيع (Topic voting) | |
order:votes |
يفرز النتائج حسب عدد الأصوات على الموضوع الذي يحتوي على المشاركة |
أعتذر للجميع، لقد أجريت للتو جولة كبيرة من التحديثات وحذفت قدرًا كبيرًا من المناقشات هنا التي أصبحت قديمة، وأخبروني إذا لاحظتم أي شيء خاطئ في المستند أعلاه وسأكون سعيدًا بالإضافة.
لقد تمت الإحالة المرجعية إلى الكود المصدري الحالي لذا يجب أن يكون محدثًا الآن.
هل يمكنك تزويدي بمحتوى الويكي الذي كان أسفل هذا المنشور بطريقة ما؟ لا أتذكر كل ما أضفته. أعتقد أنه لا يزال هناك شيء مفقود في المنشور الأول، على سبيل المثال، كيفية البحث ضمن فئة باستثناء الفئات الفرعية الخاصة بها.
يمكنني أن أفعل أفضل يا موين، لقد أعدت حذفه مؤقتاً. لا تتردد في تقديم تعديل مقترح للمنشور الأصلي إذا شعرت أنه بحاجة إلى المزيد من… بمجرد الانتهاء، أخبرني وسأقوم بتصفية هذا الأمر.
يمكن لمستخدمي المستوى 3 (TL3) الآن اقتراح التعديلات… ولكن لدينا تراكم هائل، وقد يستغرق الأمر بعض الوقت حتى نصل إليها.