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.

