انتقل إلى المحتوى الرئيسي

أوامر القوالب

أوامر لإنشاء وتطوير ونشر قوالب Qumra.

نظرة عامة​

الأمرالوصف
qumra theme initإنشاء قالب جديد
qumra theme devتشغيل خادم التطوير
qumra theme publishالتحقق من صحة القالب للنشر
qumra theme bundleتجميع القالب في ملف zip
qumra theme patchزيادة إصدار patch (x.y.Z)
qumra theme minorزيادة إصدار minor (x.Y.0)
qumra theme majorزيادة إصدار major (X.0.0)

qumra theme init​

إنشاء قالب Qumra جديد مع القالب الأولي.

الاستخدام​

qumra theme init

الخطوات التفاعلية​

  1. اسم القالب: أدخل اسمًا لقالبك (أحرف وأرقام وشرطات فقط)

ماذا يحدث​

  • ينشئ القالب على Qumra Cloud
  • يستنسخ القالب الأولي من GitHub
  • يحفظ التكوين في .qumra/qumra.config.json:
    • themeId
    • themeVersionId
    • version
    • themeName

مثال​

$ qumra theme init

? Enter theme name: my-awesome-theme

✅ Theme created successfully!

📁 Created: my-awesome-theme/
📝 Config: .qumra/qumra.config.json

Next steps:
  cd my-awesome-theme
  qumra theme dev

qumra theme dev​

تشغيل خادم التطوير مع إعادة التحميل المباشر والمعاينة.

الاستخدام​

qumra theme dev

المتطلبات​

يجب تشغيله من داخل مجلد قالب تم تهيئته (مع .qumra/qumra.config.json).

الخطوات التفاعلية​

  1. اختيار المتجر: اختر متجرًا لمعاينة قالبك

الميزات​

  • خادم تطوير محلي: يعمل على منفذ محلي متاح
  • إعادة التحميل الساخن: خادم WebSocket للتحديثات الفورية
  • مراقبة الملفات: يزامن التغييرات تلقائيًا مع Qumra Cloud
  • لوحة تحكم تفاعلية: واجهة طرفية مع الروابط والاختصارات

اختصارات لوحة المفاتيح في لوحة التحكم​

المفتاحالإجراء
qإنهاء خادم التطوير
oفتح المتصفح على رابط التطوير المحلي
sفتح رابط المتجر
eفتح محرر القالب

مثال​

$ qumra theme dev

? Select store: my-test-store

🚀 Server started successfully!

📡 Localhost       → http://localhost:3000
🌍 Theme URL       → https://my-test-store.qumra.store?theme=abc123
📦 Customize Theme → https://app.qumra.cloud/store/my-test-store/themes/abc123

Press 'q' to quit, 'o' to open browser, 's' for store, 'e' for editor

qumra theme publish​

التحقق من صحة بنية قالبك قبل النشر.

الاستخدام​

qumra theme publish

فحوصات التحقق​

  • وجود المجلدات المطلوبة (assets, layouts, pages, widgets, settings, locales, templates, ui)
  • وجود الملفات المطلوبة
  • صحة ملفات JSON
  • صحة بنية widget

مثال​

$ qumra theme publish

✅ Theme validation passed!

All required files and directories are present.
Your theme is ready for publishing.

qumra theme bundle​

تجميع قالبك في ملف zip قابل للتوزيع.

الاستخدام​

qumra theme bundle

ما يتم تجميعه​

  • assets/ - ملفات CSS و JS والوسائط
  • layouts/ - قوالب Nunjucks للتخطيط
  • pages/ - تعريفات صفحات JSON
  • widgets/ - مخططات widget والقوالب
  • settings/ - مخططات الإعدادات والبيانات
  • locales/ - ملفات الترجمة
  • templates/ - تعريفات القوالب
  • ui/ - مكونات واجهة المستخدم
  • .qumra/qumra.config.json - تكوين القالب

مثال​

$ qumra theme bundle

📦 Bundling theme...

✅ Bundle created: my-theme-1.0.0.zip

أوامر الإصدار​

إدارة إصدار قالبك باستخدام semantic versioning (MAJOR.MINOR.PATCH).

qumra theme patch​

زيادة إصدار patch لإصلاحات الأخطاء.

$ qumra theme patch

📦 Version updated: 1.0.0 → 1.0.1

qumra theme minor​

زيادة إصدار minor للميزات الجديدة.

$ qumra theme minor

📦 Version updated: 1.0.1 → 1.1.0

qumra theme major​

زيادة إصدار major للتغييرات الجذرية.

$ qumra theme major

📦 Version updated: 1.1.0 → 2.0.0

التكوين​

.qumra/qumra.config.json​

يتم إنشاؤه تلقائيًا بواسطة qumra theme init:

{
  "themeId": "unique-theme-id",
  "themeVersionId": "version-tracking-id",
  "version": "1.0.0",
  "themeName": "my-awesome-theme"
}

دليل تطوير القوالب​

للحصول على معلومات تفصيلية حول بنية القالب و widgets والقوالب:

الذهاب إلى دليل تطوير القوالب ←