هذا دليل يشرح كيفية عرض خلاصات RSS من منتدى Discourse الخاص بك على خادم Discord.
تحتاج إلى بوت Discord. يمكنك استخدام بوت مستضاف يحتوي على وحدة RSS وإضافته إلى خادمك، أو تثبيت بوت ذاتي الاستضافة وتكوينه.
في هذا الدليل، سنستخدم Red-DiscordBot لأنه ذاتي الاستضافة. يمكنك تثبيته على خادمك. إنه سهل الصيانة للغاية، وقابل للتخصيص بدرجة عالية، ويتم صيانته بنشاط.
إعداد البوت
-
اتبع هذا البرنامج التعليمي لتثبيت وتكوين Red.
-
أنشئ حساب بوت جديد على Discord وأضف البوت إلى خادم Discord الخاص بك.
إضافة خلاصات RSS (وحدة مخصصة)
عندما يكون البوت متصلًا بالإنترنت على خادمك، تحتاج إلى إضافة وحدة مخصصة جديدة (RSS) من المستودعات المعتمدة
اكتب الأوامر التالية في قناة Discord الخاصة بك (استبدل ! بادئة البوت الخاصة بك):
السماح بتثبيت وحدات الطرف الثالث:
!load downloader
إضافة aikaterna-cogs:
!repo add aikaterna https://github.com/aikaterna/aikaterna-cogs
اتبع التعليمات بكتابة I agree.
تثبيت وحدة RSS:
!cog install aikaterna-cogs rss
تحميل وحدة RSS:
!load rss
الآن أصبح لديك وحدة RSS لتكوينها. اختر القناة التي تريد استخدامها لعرض خلاصة RSS الخاصة بك.
سيتم إضافة خلاصة RSS إلى القناة التي تتواجد فيها حاليًا. يمكنك إضافة عدة خلاصات RSS في قناة واحدة.
يجب أن تكون أسماء خلاصات RSS الخاصة بك بأحرف صغيرة.
في القناة المختارة، اكتب:
!rss add discourse https://meta.discourse.org/latest.rss
حيث “discourse” هو الاسم الذي تعين لهذه الخلاصة RSS.
يجب أن يكون لكل خلاصة RSS اسم مختلف.
إذا استخدمت أكثر من كلمة واحدة في اسم الخلاصة، فيجب عليك استخدام علامات اقتباس مزدوجة:
!rss add "discourse announcements" https://meta.discourse.org/c/announcements/67.rss
يمكنك معاينة خلاصة RSS بكتابة:
!rss force discourse
أو، إذا كان اسم الخلاصة يحتوي على مسافات:
!rss force "discourse announcements"
بشكل افتراضي، لا يوجد تنسيق:
يمكننا إضافة قالب لعرض معلومات إضافية (مثل المؤلف) بالترتيب الذي نختاره:
!rss template discourse $author:\n$title\n$link
\n ينشئ فاصل سطر. يمكنك أيضًا استخدام دقة Discord Markdown في قالبك.
(اختياري) يمكننا عرض الخلاصة في كتلة مضمنة (embed block). سنقوم بذلك بكتابة:
!rss embed toggle discourse
لاحظ أن الروابط لن تعرض معاينة إذا كانت خلاصة RSS مضمنة.
كلمسة أخيرة، سنضيف اسم الخلاصة في القالب، حتى نعرف مصدر الخلاصة. هذا مفيد عندما يكون لدينا عدة خلاصات في قناة واحدة، خاصة عندما تأتي من نفس النطاق.
!rss template discourse **Discourse**\n$author:\n$title\n$link
بالنسبة لخلاصة إعلانات Discourse:
!rss template "discourse support" **Discourse Announcements**\n$author:\n$title\n$link
لعرض المساعدة حول أوامر rss، اكتب:
!rss help
