ابدأ باستخدام 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.