إن 
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.