تثبيت تطبيق وحدة التحكم Discourse Theme CLI لمساعدتك في بناء الثيمات

[Discourse]

إن Discourse Theme CLI هو جوهرة روبي (ruby gem) تسمح لك باستخدام المحرر الذي تختاره عند تطوير سمات أو مكونات سمات Discourse. عند حفظ الملفات، سيقوم الـ CLI بتحديث السمة أو المكون البعيد وستظهر التغييرات التي تطرأ عليها مباشرة!

التثبيت

للتجربة، تأكد من تثبيت Ruby 2.5 أو إصدار أحدث.

إذا كنت تستخدم نظام ويندوز (Windows)، لديك خياران:

الخيار 1: نظام ويندوز الفرعي لنظام لينكس.

يحتوي ويندوز 10 على إمكانية الوصول إلى بيئة لينكس كاملة، يمكنك استخدامها لتثبيت روبي ببساطة عبر sudo apt-get install ruby، وهذا سيعطيك Ruby 2.3.

الخيار 2: ويندوز الأقدم

الإصدارات الأقدم من ويندوز ليس لديها وصول إلى WSL، يمكنك تثبيت روبي بسهولة باستخدام Ruby Installer، اختر الإصدار الموصى به والإعدادات الافتراضية للتثبيت.

يأتي نظام التشغيل ماك أو إس (Mac OS) الإصدار 10.13.3 مع Ruby 2.3 بشكل افتراضي، لا حاجة لشيء مميز. إذا كنت تستخدم إصدارًا أقدم من Mac OS، ففكر في استخدام rvm أو rbenv أو homebrew لتثبيت إصدار حديث من روبي.

---

بمجرد تشغيل Ruby 2.2 أو أحدث، افتح طرفية (terminal) أو موجه أوامر (command shell) وقم بتشغيل:

gem install discourse_theme

بعد التثبيت، لمعرفة المزيد عنه:

discourse_theme

التحديث

gem update discourse_theme

الميزات

يوفر الـ CLI ثلاث وظائف رئيسية:

discourse_theme new

يمكنك استخدامه لإنشاء سمة جديدة بسرعة باستخدام discourse_theme new YOUR_DIR_NAME

discourse_theme watch

يمكنك استخدامه لمراقبة سمة ومزامنتها مع موقع discourse (مع تحديث مباشر) باستخدام discourse_theme watch YOUR_DIR_NAME

هذا يعني أنه يمكنك استخدام المحرر الخاص بك لتعديل السمة الخاصة بك وسيقوم الموقع بتحديث التغييرات بشكل سحري!

discourse_theme download

يمكنك تنزيل سمة موجودة من Discourse باستخدام discourse_theme download YOUR_DIR_NAME. سيُعرض عليك بعد ذلك خيار بدء “المراقبة” على الفور!

بيانات الاعتماد

ستحتاج إلى إنشاء مفتاح API. اذهب إلى منطقة المسؤول (admin area) وقم بإنشاء مفتاح هناك.

• اختر مستوى “مستخدم واحد” (Single User) عند إنشاء المفتاح، وليس “جميع المستخدمين” (All Users).
• تأكد من تحديد “مفتاح عام” (Global Key) وإلا ستتلقى أخطاء 403 Forbidden.

يتم تخزين بيانات الاعتماد (اختياريًا) في ~/.discourse_theme. يتم تخزين مفاتيح API لكل موقع على حدة، ويتم أيضًا تتبع عنوان URL ومعرّف السمة (theme_id) لكل دليل. إذا احتجت في أي وقت إلى تغيير إعداداتك، فما عليك سوى إضافة --reset إلى أي أمر وسيُطلب منك جميع القيم مرة أخرى.

شهادات العملاء

“هذه الأداة هي جوهرة حقيقية!” @awole20
“هذا جيد جدًا جدًا.” @awesomerobot
“إنها تعمل وهي رائعة جدًا. جميل!” @angus
“يا إلهي. إنه أمر لا يصدق.” @pfaffman

---

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

[riladant]

تحميلات عبر المسؤول >> تخصيص >> السمات تختفي بعد حفظ سمة تمت مشاهدتها.

كيف نقوم بتضمين أصول الصور في السمة حتى لا يتم مسحها بعد الانتهاء من الحفظ؟

[Arkshine]

أهلاً بك!

تحتاج إلى تضمين الأصول مباشرة في مكون السمة الخاص بك.
في الجذر، تقوم بإنشاء دليل assets.
ثم، تقوم بتعريفها في about.json

"assets": {
  "<your_identifier>": "assets/<your_asset_filename>",
}

يمكنك رؤية مثال هنا GitHub - MeghnaAJ/discourse-christmas-decorations.

[Arkshine]

تنبيه سريع للمطورين الذين يستخدمون هذه الأداة لإنشاء مكونات السمات:
نشجعك على ترقيتها!

لقد قام PR حديثًا بجعل مستودع discourse-theme-skeleton هو القالب الافتراضي. سيوفر لك أحدث ملفات التكوين!

[carbonrich (Richard Hawkins)]

شكرا لك!
سيكون من الرائع إضافة قسم تحديث إلى الموضوع…
هل هو تحديث --reset أم تحديث rubygem؟

[david (David Taylor)]

فكرة جيدة! لقد أضفت قسم “الترقية” إلى المنشور الأصلي

gem update discourse_theme

[Heinenen]

لتثبيت الجيم على WSL، كان عليّ تشغيل كل من
sudo apt-get install ruby و sudo apt-get install ruby-dev.
ربما يمكن إضافة ذلك إلى تعليمات التثبيت.

[tgxworld (Alan Tan)]

@sam

يحتوي نظام التشغيل Windows 10 على بيئة Linux كاملة، يمكنك استخدامها لتثبيت Ruby ببساطة باستخدام sudo apt-get install ruby، وهذا سيعطيك Ruby 2.3.

إذا لم تقم بتثبيت ruby-dev، فهل تحصل على خطأ؟ لا ينبغي أن يكون تثبيت ruby-dev ضروريًا بما أن ruby بحد ذاته كافٍ.

[Heinenen]

أنا متأكد من أنني تلقيت خطأ يخبرني بتثبيت ruby-dev، وإلا لما كنت أعرف بوجود الحزمة.
ولكن لا يمكنني تكراره عن طريق محاولة إعادة التثبيت. ربما فعلت شيئًا غريبًا في المرة الأولى.

[tgxworld (Alan Tan)]

هذا غريب بالفعل. لا تتردد في إخباري إذا كان بإمكانك إعادة إنتاج المشكلة مرة أخرى.

[manuel (Manuel Kostka)]

لقد قمت بتحديث الخادم الخاص بي بالأمس إلى الإصدار 3.5.0.beta9-dev ولا أحصل على إعادة تحميل مباشرة مع جوهرة سمة discourse منذ ذلك الحين. الجوهرة هي الإصدار 2.1.6.

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

[david (David Taylor)]

تم تعطيل إعادة التحميل المباشر لأوراق الأنماط في مثيلات الإنتاج، لأنها كانت تسبب مشاكل عند تحديث السمات و/أو نواة Discourse.\n\nبشكل أساسي: غالبًا ما ترتبط تغييرات أوراق الأنماط بتغييرات في JavaScript/HTML، لذا فإن التحميل المباشر لأوراق الأنماط فقط محفوف بالمخاطر. ينتهي الأمر بالمستخدمين بتشغيل أوراق أنماط “جديدة” مقابل HTML “قديم”، مما قد يؤدي إلى تجارب غريبة جدًا.\n\nلا يزال التحميل المباشر ممكّنًا لمثيلات Discourse في وضع التطوير. من الناحية المثالية، يجب عليك استخدام هذا الوضع للتطوير بدلاً من موقع إنتاج. بصرف النظر عن إعادة تحميل أوراق الأنماط، يوفر وضع التطوير في Ember رسائل خطأ أكثر ودية بكثير من وضع الإنتاج في Ember.

[pfaffman (Jay Pfaffman)]

@david

تم تعطيل إعادة التحميل المباشر لأوراق الأنماط في مثيلات الإنتاج، لأنها كانت تسبب مشاكل عند تحديث السمات و/أو نواة Discourse.

هذا تغيير كبير. أنا متفاجئ لعدم وجود إعلان. كنت أقوم بتطوير السمات بشكل أساسي فقط على مواقع الإنتاج.

قد يكون إعداد الموقع للحصول على السلوك القديم لطيفًا.

[rahim123]

أتفق، هذا فاجأني، ولم أتمكن من العثور على هذا الموضوع الحالي على الرغم من البحث، أو ربما رأيت تاريخ OP الأقدم وتجاهلته.

No more live reload with CSS modifications?

Hi there, I just upgraded to 3.5.0. In previous versions it would immediately apply CSS modifications in theme components without reloading the page. This doesn’t seem to be working anymore. Is it broken, or is it disabled? Thanks a lot!