قالب سمة الكانفاس

|||
|-|-|-|
| :information_source: | ملخص | ابدأ تصميم السمة بسرعة باستخدام قالب سمة مُجهز.
| :eyes: |الجمهور| المطورون الجدد الذين يرغبون في البدء في بناء سمات لـ Discourse. المطورون ذوو الخبرة الذين يرغبون في استخدام قالب جاهز. |
| :hammer_and_wrench:|المستودع| Manuel Kostka / Discourse / Canvas / Canvas Theme Template · GitLab |
| :question:|دليل التثبيت|كيفية تثبيت سمة أو مكون سمة|
| :open_book:|جديد في سمات Discourse؟| دليل المبتدئين لاستخدام سمات Discourse

يوفر Canvas قالبًا مرنًا يتيح لك إنشاء سمات مخصصة بأقل قدر من الترميز. اضبط الخصائص وقيم التكوين بسهولة لتخصيص السمة لتلبية احتياجاتك.

أمثلة للعروض


يحتفظ القالب الأساسي بالقيم الافتراضية ويظل محايدًا في التصميم.

تعديلات بسيطة تعدل بعض الخصائص المخصصة وتحدد لونًا مميزًا:

تصميم يدمج مكون بطاقات الموضوع وأنماط مخصصة للشعارات:

سمة مفصلة تتضمن خطًا مخصصًا ومخططات ألوان فريدة:

الاستخدام


  1. استنساخ قالب السمة.

  2. مزامنة السمة مع مثيل Discourse الخاص بك باستخدام gem discourse_theme.

  3. انتقل إلى الواجهة الخلفية للمسؤول واضبط إعدادات مكون السمة هذه يدويًا:
    شعارات الفئة
    منفذ المكون → above-main-container
    شعارات العلامة
    عرض أسفل رأس الموقع → إلغاء تحديد
    عرض فوق الحاوية الرئيسية → تحديد

  4. قم بتحرير scss/properties.scss لتحديد قيم الخصائص المخصصة

  5. قم بتحرير about.json لإضافة الأصول ومخططات الألوان والمزيد من مكونات السمة

نظرة أقرب على الإعداد


يمتد قالب سمة Canvas فقط على هيكل السمة الافتراضي عن طريق تجميع عدد قليل من مكونات السمة وإضافة بعض ملفات الأنماط الجاهزة. يتم التعامل مع الميزات الفعلية بواسطة مكون سمة منفصل إعدادات Canvas. يخدم هذا المكون وظيفتين:

يسمح لك هذا الإعداد المنفصل بإنشاء سمة باستخدام قالب Canvas، مع الاستمرار في الاستفادة من الإصلاحات والتحديثات المستمرة المقدمة من خلال المكون.

أمثلة للسمات


يمكنك مراجعة كود عروض الأمثلة المشتركة أو تثبيتها كسمة بداية لك من هذه المستودعات:


:tada: شكر كبير لـ Discourse لرعاية تطوير هذا المشروع!

24 إعجابًا

لا تظهر إعدادات السمة هذه عندما حاولت تثبيت السمات النموذجية. هل هذا سلوك متوقع؟

إعجاب واحد (1)

الإعدادات موجودة على مكون السمة المثبت باسم إعدادات الكanvas. ربما يكون من المربك قليلاً أن تُسمى الإعدادات دائمًا إعدادات السمة على واجهة المستخدم، وأيضًا على مكونات السمة.

إعجابَين (2)

تم العثور عليها في مكون إعدادات اللوحة القماشية، شكرًا!

3 إعجابات

شكراً جزيلاً على العمل على هذا يا @manuel.

لقد جربت نسخة المحرر محلياً، وهي تعمل بشكل جيد جداً في الغالب، لكنني لاحظت بعض المشكلات الصغيرة.


في تثبيت افتراضي، دون تغيير أي إعدادات، يظهر عنوان العلامة في مكون اللافتات الإضافية في المكان الخاطئ:

تظهر لافتة الفئة أيضاً في نفس المكان، فوق الشريط الجانبي. تظهر أحدث المواضيع والمواضيع الشائعة بشكل صحيح في العمود الرئيسي.


أفترض أنه ليس هدف السمة تغطية واجهة المسؤول بالكامل، ومع ذلك، فإن لوحات الألوان الفاتحة والداكنة للمحرر تجعل الشريط الجانبي للمسؤول يبدو مختلفاً تماماً. أنا فضولي لمعرفة ما إذا كان من الممكن التنسيق مع الشريط الجانبي غير المسؤول.

5 إعجابات

يهدف السمة إلى عرض لافتات بجوار الشريط الجانبي، باستخدام منفذ above-main-container. يستخدم مكون Extra-Banners هذا المنفذ افتراضيًا، ولكن المكونين الخاصين بلافتات الفئات والعلامات يتم عرضه افتراضيًا أسفل الرأس. لا أرغب في نسخ هذه المكونات، فقط لتعيين منفذ افتراضي مختلف. لهذا السبب وضعت هذه التعليمات:

ولكن إذا كان من السهل تفويت ذلك، فربما هناك طريقة أفضل لوضعها؟ :thinking:

نعم، هذا سهل بما فيه الكفاية ويبدو أنه نهج جيد لهذه السمة. لقد أضفت للتو التزامًا!

5 إعجابات

نعم، أرى كيف وصلنا إلى هنا. لا نريد بالضرورة تغيير الإعدادات الافتراضية في مكونات banners الفئات/الوسوم، ولا نرغب أيضًا في عمل فرع منها. من الصعب تصحيح ذلك، فلنترك الأمر كما هو الآن ونرى إذا واجه الآخرون نفس المشكلة.

التغيير في الشريط الجانبي للمسؤولين يبدو جيدًا بالفعل، شكرًا لك!

4 إعجابات

هل يمكن توضيح هذه التعليمات قليلاً؟ هل من الممكن عدم التثبيت من واجهة المستخدم الإدارية؟ شكرًا :folded_hands:t4:

تحرير: لقد قمت بالتثبيت عبر واجهة المستخدم الإدارية ويبدو أنه يعمل باستثناء أنه لا يبدو أن هناك مكانًا لتعديل scss الآن.

تحرير: لا داعي للقلق، أرى أن هذا ربما يكون متوقعًا وأنك تعرض تعديل ملفات السمة مباشرة. أتساءل عما إذا كان يمكن أن يكون هذا على خارطة الطريق ليحدث هذا عبر واجهة المستخدم الإدارية؟ مثل، وجود محرر متغيرات بنفس الطريقة التي لديك بها محرر إعدادات.

3 إعجابات

لا أعرف ما هو موجود في خارطة الطريق الأساسية، ولكن هناك شيء يمكنك القيام به الآن وهو إنشاء مكون سمة جديد مباشرةً في واجهة المستخدم الإدارية:

ثم قم بتعريف خصائص مخصصة في ملف CSS الخاص به. يمكنك إما البحث عن الخصائص في ملف القراءة. أو نسخ محتويات properties.scss من مستودع السمة.

إعجابَين (2)

كيف يمكنني استنساخ هذا إلى جيت هاب؟ لا أزال أخضر بعض الشيء :wink:

يمكنك استيراده عبر واجهة المستخدم:

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

  1. استنساخ من GitLab
git clone "https://gitlab.com/manuelkostka/discourse/canvas/theme.git"
  1. تعيين عنوان URL للدفع إلى مستودع GitHub الخاص بك
git remote set-url --push origin "git@github.com:Username/Reponame.git"
  1. بعد ذلك، يمكنك جلب التغييرات بشكل دوري من GitLab والدفع إلى GitHub
git fetch -p origin
git push origin
إعجابَين (2)

لا أرى علامة زائد على الهاتف المحمول في GitHub. قد أحتاج إلى تجربة سطر الأوامر عند المنزل.

كل ما أراه في GitHub في لوحة التحكم هو خيار إنشاء مستودع جديد ولكن لا يوجد خيار للمطالبة. أنا على حساب مجاني لذلك لست متأكدًا مما إذا كان ذلك قد يكون له علاقة بالأمر.

لقد أضفت مكونًا يتيح لك تحديد بعض متغيرات الأنماط وخيارات التخطيط مباشرةً في واجهة المستخدم للمكون:

إنه محدود مقارنة بتعريف متغيرات مخصصة في ورقة الأنماط. ولكنه يتيح لك تجربة بعض المظاهر المختلفة. فضولي لمعرفة ما إذا كان ذلك يعمل! :eyes:

إعجابَين (2)

أنا ألعب بها الآن وأعتقد أنها لطيفة! هل هناك طريقة لتقليل تباعد الأسطر في القائمة - لجعلها أكثر إحكاما؟

أيضًا، لا يمكنني التمرير في الشريط الجانبي الصلب، هل هذا عن طريق الخطأ؟

إعجابَين (2)

لقد قمت للتو بتعديل أنماط CSS للشريط الجانبي الصلب، يجب أن يعمل التمرير مرة أخرى!

ومع ذلك، فإن الشريط الجانبي الصلب هو مجرد خيار واحد في مكون الأنماط الذي ذكرته في المنشور أعلاه. إذا كنت ترغب في تعديل المزيد من الأنماط (مثل تباعد قائمة الشريط الجانبي)، فستحتاج إلى اتباع النهج الموضح أعلاه في الاستخدام و نظرة أقرب على الإعداد: استخدم ورقة الأنماط الخاصة بك مع خصائص CSS المخصصة - في هذه الحالة ستكون -d-sidebar-row-height.

3 إعجابات

لقد قمت بتجميع سمة مثال جديدة بناءً على هذا القالب. كما يوحي الاسم، هذه السمة هي تكريم للسمة المركزية الأصلية! :hugs: :partying_face:

لقد أحببت التصميم والأسلوب المرئي للسمة المركزية وكنت أقوم بتجميع بعض ميزاتها في مكونات مستقلة، مثل قائمة المستخدم المخصصة والعديد من كتل الشريط الجانبي.

أدركت أنه مع الشريط الجانبي وبعض الأنماط، يمنحك هذا القالب في الواقع طريقة جيدة نحو مظهر وأسلوب السمة الأصلية.


على أي حال، أنا لا أخطط لإعادة بناء السمة المركزية بالكامل.. ولكن قد لا أزال أجرب نمط قائمة مواضيع مخصص في المستقبل. إذا كنت فضوليًا وترغب في إلقاء نظرة، فإن السمة متاحة أيضًا هنا: https://central.kostka.studio

8 إعجابات

جميل جداً. شكراً للمشاركة.

إعجاب واحد (1)

شكرًا لمشاركة هذا النموذج! المرونة في المكونات والتصميم النظيف تجعل من السهل حقًا تخصيصه. أتطلع إلى تجربته على نسختي الخاصة.

إعجابَين (2)

مرحباً بك في ديسكورس :discourse:!

إعجابَين (2)