هيكل السمات ومكونات السمات

[Discourse]

يدعم Discourse السمات الأصلية التي يمكن استحضارها من أرشيف .tar.gz أو من مستودع git بعيد، بما في ذلك المستودعات الخاصة.

مثال على السمة موجود في: GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme · GitHub

سيتم فحص مستودع git بحثًا عن التحديثات (مرة واحدة في اليوم)، أو عن طريق استخدام زر التحقق من التحديثات. عند اكتشاف تغييرات، سيتحول زر التحقق من التحديثات إلى التحديث إلى أحدث إصدار.

لإنشاء سمة، يجب عليك اتباع هيكل ملفات محدد. هذه هي الملفات التي يمكنك تضمينها:

about.json (إلزامي)

common/common.scss
common/header.html
common/after_header.html
common/footer.html
common/head_tag.html
common/body_tag.html
common/embedded.scss

desktop/desktop.scss
desktop/header.html
desktop/after_header.html
desktop/footer.html
desktop/head_tag.html
desktop/body_tag.html

mobile/mobile.scss
mobile/header.html
mobile/after_header.html
mobile/footer.html
mobile/head_tag.html
mobile/body_tag.html

locales/en.yml
locales/{locale}.yml

stylesheets/{anything}/{anything}/{anything}.scss

javascripts/{anything}.js
javascripts/{anything}.gjs
javascripts/{anything}.hbs

assets/{asset_filename}

settings.yml

أي من هذه الملفات اختياري، لذا أنت بحاجة فقط إلى إنشاء الملفات التي تحتاجها.

تلك الذين يبحثون عن تقسيم SCSS الخاص بالسمة إلى ملفات متعددة، أصبح ذلك ممكنًا الآن.

تقسيم سمة SCSS إلى ملفات متعددة

أصبحت السمات ومكونات السمات أكثر قوة بشكل مطرد، ويصبح المطورون أكثر طموحًا. لتسهيل الأمور على المطورين، يمكن للسمات الآن تقسيم ملفات SCSS الخاصة بها إلى ملفات متعددة. عند إنشاء سمة جديدة باستخدام أداة سطر الأوامر للسمات (theme CLI)، أو مشاركة سمة على github، ما عليك سوى إنشاء مجلد جديد يسمى scss. املأه بملفات .scss الخاصة بك، باتباع أي هيكل مجلد، وستكون جميع الملفات متاحة لك للاستيراد في أقسام SCSS المشتركة / لسطح المكتب / للجوال في السمة الخاصة بك. على سبيل المثال، إذا كنت تريد أن يكون متغي…

تلك الذين يبحثون عن تقسيم السمة إلى ملفات JS متعددة، ما عليك سوى إضافة ملفات JS التي تريدها إلى مجلد javascripts.

هيكل ملف about.json أدناه، ويمكنك الاطلاع على مزيد من المعلومات حوله في https://meta.discourse.org/t/adding-metadata-to-a-theme/119205:

{
  "name": "My Theme",
  "component": false,
  "license_url": null,
  "about_url": null,
  "authors": null,
  "theme_version": null,
  "minimum_discourse_version": null,
  "maximum_discourse_version": null,
  "assets": {
    "variable-name": "assets/my-asset.jpg"
  },
  "color_schemes": {
    "My Color Scheme": {
      "primary": "222222"
    }
  },
  "screenshots": ["screenshots/light.jpeg", "screenshots/dark.jpeg"]
}

تعليمات حول كيفية إضافة الإعدادات إلى سمتك متاحة هنا: Add settings to your Discourse theme.

لإبلاغ Discourse أنك ستضيف مكوّن سمة وليس سمة كاملة، ما عليك سوى إضافة السطر "component": true إلى ملف about.json

يتطابق هيكل الملفات مع CSS / HTML المخصص للسمة.

قراءة إضافية

اطّلع على المقالات الأخرى الموسومة بوسم #themes::tag.

راجع أيضًا:

• Developing Discourse Themes & Theme Components
• Install the Discourse Theme CLI console app to help you build themes
• Include assets (e.g. images, fonts) in themes and components

---

آخر مراجعة بواسطة @SaraDev في 2022-08-15T21:00:00Z

---

هذا المستند مُدار بإصدارات - اقترح تغييرات على github.