وثائق حول توسيع Discourse باستخدام الإضافات، والسماات، ومكونات السمة، والعمل مع الكود الأساسي، واستخدام واجهة برمجة التطبيقات (API) لـ Discourse.
مقدمة
- المقدمة: مقدمة في تطوير Discourse
بيئات التطوير
- حاوية المطور (Dev Container): تطوير Discourse باستخدام حاوية المطور
- GitHub Codespaces: تطوير Discourse على GitHub Codespaces
- إعداد Docker: تثبيت Discourse للتطوير باستخدام Docker
- إعداد macOS: تثبيت Discourse على macOS للتطوير
- إعداد Ubuntu/Debian: تثبيت Discourse على Ubuntu أو Debian للتطوير
- إعداد Windows: تثبيت Discourse على Windows للتطوير
- إضافات غير معتمدة على Docker: تثبيت الإضافات في بيئة تطوير غير معتمدة على Docker
- إعداد محلي: إعداد بيئة تطوير Discourse محلية؟
- إعداد متعدد المواقع (Multisite): إعداد بيئة تطوير متعددة المواقع
- إعداد Fedora: إعداد Discourse للتطوير على نظام تشغيل Fedora Linux
الكود والتفاصيل الداخلية
- مكونات Ember: إضافة مكونات Ember إلى Discourse
- مجموعة واجهة المستخدم (UI kit): مجموعة واجهة المستخدم لمكونات ومساعدات ومعدلات Discourse المشتركة
- التدقيق والتنسيق التلقائي للكود (Lint and format): التدقيق والتنسيق التلقائي للكود قبل الإيداعات
- اختبارات القبول (Acceptance tests): كتابة اختبارات القبول لكود Ember في Discourse
- تشغيل مجموعات الاختبار: كيفية تشغيل مجموعات اختبار QUnit الأساسية لـ Discourse والإضافات والسماات
- توافق الإصدارات: تثبيت إصدارات الإضافات والسماات لتثبيتات Discourse القديمة (فروع d-compat)
- ملكية كائنات Ember (Ember object ownership): ملكية كائنات Ember (getOwner، حقن الخدمات، إلخ.)
- أداء JavaScript: استخدام أداة ‘tachometer’ من جوجل لقياس تغييرات أداء JS في Discourse
- التكامل المستمر مع GitHub Actions (CI): إعداد التكامل المستمر باستخدام GitHub Actions
- امتدادات Markdown: دليل المطور لامتدادات Markdown
- تحويل النوافذ المنبثقة (Modals): تحويل النوافذ المنبثقة من المتحكمات القديمة إلى واجهة برمجة التطبيقات الجديدة لمكون DModal
- واجهة DModal API: استخدام واجهة DModal API لعرض النوافذ المنبثقة (أو الحوارات) في Discourse
- واجهة JS API: استخدام واجهة JS API
- موصلات مخرجات الإضافة (Plugin outlet connectors): استخدام موصلات مخرجات الإضافة من سمة أو إضافة
- modifyClass: استخدام modifyClass لتغيير سلوك الكود الأساسي
- إنشاء المسارات (Routes): إنشاء مسارات في Discourse وعرض البيانات
- طريقة المصادقة: إضافة طريقة مصادقة “مدارة” جديدة إلى Discourse
- التسلسل العرضي لنماذج ActiveRecord: منع التسلسل العرضي لنماذج ActiveRecord
- تجاوز القوالب: (غير موصى به) تجاوز قوالب Discourse من سمة أو إضافة
- كائنات الخدمة (Service objects): استخدام كائنات الخدمة في Discourse
- مواصفات النظام (System specs): كتابة مواصفات نظام شاملة لواجهة مستخدم Discourse
- FormKit: أداة Discourse لعرض النماذج.
- مشغلات AppEvents: مرجع مشغلات AppEvents
- المحولات (Transformers): استخدام المحولات لتخصيص قيم وسلوكيات جهة العميل
- تخصيص قائمة المواضيع: تخصيص قائمة المواضيع
- إرشادات CSS: إرشادات لاستخدام فئات CSS بطريقة BEM
- تلميح الأنواع والتحقق في JS: تلميح الأنواع والتحقق في JavaScript (typescript)
- التصميم للأجهزة: التصميم لأجهزة مختلفة (اللمس والتحويم)
- التصميم لعرض متجاوب: التصميم لعرض متجاوب (نقاط التوقف، منفذ العرض، والحواويات)
- بدائيات الإيماءات: بدائيات السحب، وإعادة تحجيم، والإيماءات
- تقسيم الحزم (Bundle splitting): تقسيم حزم الإضافات
- الوحدات الخاصة: الوحدات الخاصة واصطلاح
-internals - اختبارات المكونات: كتابة اختبارات المكونات لـ Discourse
الإضافات
- إضافة أساسية: تطوير إضافات Discourse - الجزء 1 - إنشاء إضافة أساسية
- مخرج الإضافة (Plugin outlet): تطوير إضافات Discourse - الجزء 2 - الاتصال بمخرج إضافة
- إعدادات الموقع: تطوير إضافات Discourse - الجزء 3 - إضافة إعدادات موقع مخصصة
- إعداد Git: تطوير إضافات Discourse - الجزء 4 - إعداد git
- واجهة الإدارة: تطوير إضافات Discourse - الجزء 5 - إضافة واجهة إدارة
- اختبارات القبول: تطوير إضافات Discourse - الجزء 6 - إضافة اختبارات قبول
- نشر إضافتك: تطوير إضافات Discourse - الجزء 7 - نشر إضافتك
- لغات جديدة: إضافة لغة جديدة من الإضافة
- تكامل الدردشة: إضافة مقدم خدمة جديد إلى discourse-chat-integration
- امتداد markdown-it: إعادة تغليف امتداد markdown-it كإضافة Discourse
- التحميل التلقائي في Rails: هيكلنة إضافة لتحميل تلقائي في Rails
السماات والمكونات
- تطوير السماات: تطوير سماات Discourse ومكونات السمة
- مرجع سريع: دليل المطور السريع للسماات
- دليل المصممين: دليل المصمم للبدء باستخدام السماات في Discourse
- منشئ السمة (Theme Creator): البدء مع منشئ السمة وواجهة سطر الأوامر للسمة
- واجهة سطر الأوامر للسمة (Theme CLI): تثبيت تطبيق سطر الأوامر للسمة الخاص بـ Discourse لمساعدتك في بناء السماات
- هيكل السمة: هيكل السماات ومكونات السمة
- ملفات JS متعددة: تقسيم جافا سكريبت السمة إلى ملفات متعددة
- ملفات SCSS متعددة: تقسيم SCSS السمة إلى ملفات متعددة
- إعدادات السمة: إضافة إعدادات إلى سمة Discourse الخاصة بك
- كائنات لإعدادات السمة: نوع الكائن لإعداد السمة
- ترحيل الإعدادات: ترحيل إعدادات سمة Discourse
- بيانات السمة الوصفية: إضافة بيانات وصفية ولقطات شاشة إلى سمة
- المتغيرات الأساسية: استخدام متغيرات Discourse الأساسية في سمتك
- سلاسل نصية قابلة للترجمة: إضافة سلاسل نصية قابلة للترجمة إلى السماات ومكونات السمة
- اختبارات E2E: اختبارات النظام الشاملة للسماات ومكونات السمة
- تقليل الصيانة: تقليل صيانة تخصيصات السمة
- أحجام الخطوط: تغيير أحجام الخطوط في سمااتك
- تضمين الأصول: تضمين الأصول (مثل الصور، والخطوط) في السماات والمكونات
- أيقونات مخصصة: استبدال أيقونات SVG الافتراضية في Discourse بأيقونات مخصصة في سمة
- الوضع الداكن: تحديث السماات والإضافات لدعم الوضع الداكن التلقائي
- معدلوا السمة (Theme modifiers): معدلوا السمة: مقدمة موجزة
- العناصر الوهمية (Pseudo-elements): إدراج نص أو صور في أي مكان على موقعك باستخدام عناصر CSS الوهمية
- مكون الخط: إنشاء ومشاركة مكون خط للسمة
- لغة Highlight.JS: تثبيت لغة جديدة لـ Highlight.JS عبر مكون السمة
- محتوى الصفحة الرئيسية: إضافة محتوى مخصص يظهر فقط في صفحتك الرئيسية
- تنسيق الرسائل: دعم تنسيق الرسائل للترجمة
- تغييرات الأيقونات العامة: تغيير الأيقونات بشكل عام
- أيقونات بديلة: أيقونات بديلة
- نمط منشور الويكي: تغيير نمط منشور الويكي
- لوحة الألوان: إنشاء ومشاركة لوحة ألوان
- قائمة التنقل: استخدام معامل استعلام
navigation_menuلمعاينة الشريط الجانبي أو الخيارات الأخرى - أنماط محتوى المنشور: تخصيص محتوى المنشورات بأنماطك الخاصة
- لقطات شاشة السمة: إضافة لقطات شاشة معاينة لسماات Discourse
- إعدادات موقع قابلة للسمة: التحكم في إعدادات الموقع باستخدام السماات
أدلة عامة
- التطبيقات المحمولة تحت علامة تجارية بيضاء: أمور يجب مراعاتها قبل اتخاذ قرار بإعادة تسمية التطبيقات المحمولة لـ Discourse
- أتمتة مخصصة: إنشاء أتمتة مخصصة
- تفريغ البيانات العامة: تفريغ البيانات العامة لـ Discourse
- تقييمات الذكاء الاصطناعي: تشغيل تقييمات الذكاء الاصطناعي لـ Discourse
- بوت الذكاء الاصطناعي عبر واجهة API: استخدام بوت الذكاء الاصطناعي عبر واجهة Discourse API
درس تعليمي لتطوير السمة
- 1 - المقدمة: درس تعليمي لمطور السمة: 1. المقدمة
- 2 - سمة عن بُعد: درس تعليمي لمطور السمة: 2. إنشاء سمة عن بُعد
- 3 - CSS: درس تعليمي لمطور السمة: 3. CSS في السماات
- 4 - المخارج: درس تعليمي لمطور السمة: 4. استخدام المخارج لإدراج واستبدال المحتوى
- 5 - المكونات: درس تعليمي لمطور السمة: 5. بناء واستخدام المكونات
- 6 - واجهة JS API: درس تعليمي لمطور السمة: 6. استخدام واجهة JS API
- 7 - الخاتمة: درس تعليمي لمطور السمة: 7. الخلاصة