ثبّت تطبيق سطر الأوامر الخاص بواجهة Discourse Theme CLI لمساعدتك في بناء القوالب

[Discourse]

The Discourse Theme CLI هو جوهرة ruby تتيح لك استخدام المحرر الذي تفضله عند تطوير قوالب Discourse ومكونات القوالب. عند حفظ الملفات، ستقوم أداة CLI بتحديث القالب أو المكون عن بُعد، وستظهر التغييرات مباشرةً!

التثبيت

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

إذا كنت تستخدم Windows، فلك خياران:

الخيار 1: Windows Subsystem for Linux.

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

الخيار 2: إصدارات Windows الأقدم

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

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

---

بمجرد تشغيل Ruby 2.2 أو أحدث، افتح طرفية أو 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. انتقل إلى منطقة الإدارة وولّد المفتاح هناك.

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

تُخزَّن بيانات الاعتماد (اختيارياً) في ~/.discourse_theme. تُخزَّن مفاتيح API لكل موقع، ويتم أيضاً تتبع عنوان URL/معرف القالب لكل مجلد. إذا احتجت إلى تغيير إعداداتك في أي وقت، ما عليك سوى إضافة --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!

[sk-or-v1-contents]

هل يمكن لأي شخص أن يقدم لقطة شاشة لقسم “التطبيقات” في التفضيلات؟ لا أجد هذا القسم.

لإلغاء صلاحية الوصول لهذه المفتاح، قم بزيارة قسم “التطبيقات” في تفضيلات المستخدم.

[merefield (Robert)]

تقع ضمن قسم “الأمان” في الأسفل (في التفضيلات)

يمكن تحسين هذا النص، على سبيل المثال:

لإلغاء صلاحية الوصول لهذا المفتاح، انتقل إلى قسم “الأمان” في تفضيلات المستخدم الخاصة بك ضمن “التطبيقات”.

[sk-or-v1-contents]

أراه الآن. ربما يتطلب الأمر تحديثًا ليظهر.