تقليل الصيانة على تخصيصات الثيم

توثيق أدلة المطور
,
1

يتميز Discourse بقابلية تخصيص عالية، مما يتيح لك تعديل أي جانب تقريبًا من مظهره من خلال السمات.

للحفاظ على التوافق مع تحديثات Discourse المستمرة والميزات الجديدة، تتطلب جميع السمات صيانة دورية. يعتمد تكرار الصيانة على مدى تعقيد ونوع التخصيص. يمكنك تقليل جهود الصيانة لسمتك من خلال اتباع هذه الإرشادات:

  • تحقق من السمات الرسمية أو مكونات السمات التي تطابق وظائفك المطلوبة. يتم تحديث هذه جنبًا إلى جنب مع Discourse. يمكن أن تكون هذه أيضًا أمثلة لكيفية التعامل مع تخصيصاتك الخاصة.
  • استبدل نص الواجهة باستخدام ميزة “المسؤول → تخصيص → نص” عن طريق البحث عن النص المحدد وتحديثه هناك.
  • CSS السمة إضافي، مما يسمح لك بتجاوز الأنماط الافتراضية دون تحريرها مباشرة. هذا النهج يحسن قابلية صيانة CSS ويقلل من التعارضات مع التحديثات.
  • استخدم نظام التحكم في الإصدار مثل Git مع GitHub أو GitLab أو Bitbucket لتتبع التغييرات. في حين أن محرر HTML و CSS في “المسؤول → تخصيص → السمات” مناسب للتعديلات الطفيفة، يمكن لأنظمة التحكم في الإصدار تسهيل تتبع واستكشاف الأخطاء وإصلاحها للتغييرات الأكثر تعقيدًا.
  • للتخصيصات المتقدمة، قم بإنشاء وحدات مستقلة لوظائف جديدة وادمجها من خلال منافذ الإضافات. يستخدم Discourse Ember.js، لذا فإن بناء مكونات Ember مثالي. هذه الطريقة تعزل الوظائف المخصصة، وتقلل من الصيانة، وتساعد على تجنب التعارضات مع تحديثات Discourse.

يجب أن يكون تجاوز JavaScript وقوالب HTML الافتراضية لـ Discourse داخل سمة هو الملاذ الأخير، حيث من المرجح أن تكون هذه التغييرات غير متوافقة مع تحديثات Discourse، وقد يكون من الصعب استكشاف الأخطاء وإصلاحها، وهي أكثر عرضة للأخطاء التي تؤدي إلى توقف الخدمة.

لمزيد من المعلومات حول استخدام وبناء سمات Discourse، لا تتردد في طرح الأسئلة على مجتمع Meta الخاص بنا، وإلقاء نظرة على أدلة السمات الخاصة بنا:

هذه الوثيقة يتم التحكم في إصدارها - اقترح تغييرات على github.

13 إعجابًا