ابدأ باستخدام Theme Creator و Theme CLI

[Discourse]

سيرشدك هذا الموضوع خلال استخدام Theme CLI مع موقع Theme Creator الخاص بنا لتطوير سمة ومعاينة التغييرات التي تجريها على موقع Discourse مباشر.

1. سجّل للحصول على حساب هنا في Meta إذا لم تكن قد فعلت ذلك بعد

2. سجّل الدخول إلى Theme Creator

3. ثبّت Theme CLI عبر التعليمات المتوفرة هنا

4. أنشئ سمة جديدة على Theme Creator عن طريق:

   • زيارة https://discourse.theme-creator.io/my/themes
   • النقر على Install، واختيار خيار “Create New”.
   • إعطاء السمة الخاصة بك اسمًا فريدًا (يمكنك تجاهل مخطط الألوان في الوقت الحالي).

5. انقر على advanced، ثم edit locally، وretrieve API key.

   انسخ مفتاح واجهة برمجة التطبيقات (API key) الذي يتم إنشاؤه.

6. عد إلى سطر الأوامر واكتب discourse_theme download example-folder، حيث سيتم تخزين السمة الخاصة بك محليًا في example-folder. اتبع المطالبات.

   • أدخل https://discourse.theme-creator.io كـ root URL لموقع Discourse الخاص بك.

   • أدخل API key الخاص بك من الخطوة السابقة عند الطلب.

   • استمر في اتباع المطالبات وحدد السمة التي أنشأتها في الخطوة 4.

   • أدخل نعم عندما يُسأل عما إذا كنت ترغب في البدء في مراقبة السمة الخاصة بك.

     

7. الآن تتم مراقبة مجلد السمة المحلي الخاص بك بحثًا عن التغييرات، والتي سيتم تحميلها تلقائيًا إلى Theme Creator. يمكنك فتح معاينة للسمة الخاصة بك عن طريق النقر على preview في إعدادات السمة الخاصة بك على Theme Creator.

   

8. لإيقاف مراقبة التغييرات، اضغط على ctrl + c في نافذة سطر الأوامر. لبدء مراقبة التغييرات مرة أخرى، اكتب discourse_theme watch example-theme.

لديك الآن دليل سمة محلي يمكنك تعديله ورؤية تغييراتك مباشرة!

للحصول على نظرة متعمقة حول كيفية هيكلة السمات وما يمكنك القيام به، اطلع على دليل المطور الخاص بنا Developing Discourse Themes & Theme Components

---

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

[kjs-fgx]

@كريس، مشاركة:1، موضوع:108444، اسم المستخدم:awesomerobot

https://discourse.theme-creator.io

مرحباً. أحاول اتباع هذه التعليمات ولكنني أواجه مشكلة باستمرار. بعد إضافة مفتاح API أرى ما يلي:

/usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/lib/discourse_theme/cli.rb:100:in `run': undefined method `exists?' for Dir:Class (NoMethodError)

        FileUtils.mkdir_p dir unless Dir.exists?(dir)
                                        ^^^^^^^
Did you mean?  exist?
        from /usr/local/lib/ruby/gems/3.2.0/gems/discourse_theme-0.7.3/bin/discourse_theme:6:in `<top (required)>'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `load'
        from /usr/local/lib/ruby/gems/3.2.0/bin/discourse_theme:25:in `<main>'

هل لديك فكرة عن السبب؟
شكراً مقدماً

[leonardo (Leonardo Mosquera)]

مرحباً!
هذه الأداة لا تدعم Ruby 3.2 بعد بسبب التغييرات في اللغة. لدينا إصلاح قيد العمل، ولكن Ruby 3.1.x يعمل في الوقت الحالي.

[kjs-fgx]

آه، هذا هو السبب إذن.
شكراً لك

[leonardo (Leonardo Mosquera)]

تم إصلاح هذا الآن - يجب أن يعمل discourse_theme تحت Ruby 3.2.x من إصدار gem 0.7.4 وما فوق

[kjs-fgx]

واو، كان ذلك سريعًا
شكرًا لك. تمكنت من جعله يعمل بمساعدة مديري المباشر الذي اقترح:

rbenv install 3.1.3
rbenv shell 3.1.3
gem install discourse_theme

والذي لم يعمل فعليًا حتى أغلقت علامة تبويب الطرفية وأعدت فتحها مرة أخرى.

[darkpixlz (Pyx)]

هل توقف discourse_theme watch عن إعادة التحميل المباشر؟ كان يقوم بتحديث الثيم الخاص بي عند حفظه، ولكن الآن يجب عليّ تحديث علامة التبويب يدويًا. لا يوجد شيء في وحدة التحكم يشير إلى السبب.

[Moin]

كان هناك تغيير قبل فترة

Install the Discourse Theme CLI console app to help you build themes

Live reloads of stylesheets have been disabled for production instances, because they were causing problems when updating themes and/or Discourse core. Fundamentally: stylesheet changes are often tied to changes in JS/HTML, so live-loading for only stylesheets is risky. Users end up running ‘new’ stylesheets against ‘old’ HTML, which can lead to some very strange experiences. Live-loading is still enabled for development-mode Discourse instances. Ideally, you’d use that for development rather …

قد تكون مهتمًا بـ Live Reload in Production

[micke]

أحاول فهم كيفية معاينة سُمعتي (theme) بشكل صحيح على https://discourse.theme-creator.io/.

أمر discourse_theme watch يعمل ويزامن التغييرات الخاصة بي إلى عنوان URL للمعاينة. لقد أنشأت سُمعة (theme) أضفت فيها `color_schemes` إلى ملف `about.json`. وهي تظهر في قائمة الاختيار الخاصة بالسُمعة تحت `/me/theme`. ومع ذلك، لا يمكنني اختيار مخطط/لوحة ألوان وعرضها، بل أعلق بمخطط افتراضي يُدعى “Light” لم أقم بتحديدُه بنفسي.

كما أن مخططات الألوان المسماة الخاصة بي من ملف `about.json` لا تظهر تحت `/me/preferences/interface`.

ما الخطأ الذي أرتكبه؟

شكرًا لك!