ابدأ باستخدام Theme Creator و Theme CLI

[Discourse]

سيرشدك هذا الموضوع خلال كيفية استخدام Theme CLI مع موقع Theme Creator الخاص بنا لتطوير سمة (theme) ومعاينة تغييراتك على موقع 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.