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

Theme Bundle

هل تريد إنشاء حزمة (أرشيف) من قالبك المحلي لتتمكن من رفعها إلى Qumra Cloud أو مشاركتها مع شخص آخر أو بيئة أخرى؟ هذا الأمر يجهز ملف حزمة قالب مضغوط جاهزاً لك.

qumra theme bundle​

هذا الأمر يجمع ملفات قالبك، ويشغل خطوة البناء، ويولد حزمة مضغوطة جاهزة للرفع. إنه لا يرفعها إلى السحابة—فقط يجهزها محلياً على جهازك.

الوصف​

qumra theme bundle يقوم بالتالي:

  1. يتحقق من أن qumra.config.json يحتوي على جميع الحقول المطلوبة، خاصة themeName.
  2. يشغل سكريبت البناء المكون لديك.
  3. يجمع جميع ملفات القالب المطلوبة والبيانات الوصفية.
  4. يضغط كل شيء في ملف .zip ويعرض لك المسار.

مفيد إذا كنت تريد رفع القالب يدوياً من لوحة تحكم Qumra، أو كنت تعمل مع خط بناء أو CI آخر.

مثال الاستخدام​

# إنشاء حزمة قالب محلياً في خطوة واحدة
qumra theme bundle

مثال رسالة خطأ​

PS \theme> qumralocal theme bundle

❌ themeName is missing from your Qumra config file

هذا يعني أنك لم تحدد themeName داخل .qumra/qumra.config.json أو أنه مفقود. أضفه كالتالي:

{
  "themeName": "your-theme-name",
  ...
}

المخرجات المتوقعة في حالة النجاح​

Theme Root: ./theme
Output File: ./theme/themeName-theme.zip
✅ Bundle created successfully: themeName-theme.zip
📏 Size: 4.10 MB

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

  • ارفع ملف الحزمة من لوحة تحكم Qumra حسب بيئتك المستهدفة.
  • إذا كنت تجري تغييرات متكررة، استخدم qumra theme dev للاختبار، ثم اعمل حزمة عندما تكون جاهزاً.
  • يمكنك استخدام ملف الحزمة كـ artifact في أي خط أنابيب للنشر أو الأتمتة الإضافية.

استكشاف الأخطاء وإصلاحها​

المشكلة: "❌ themeName is missing from your Qumra config file"​

إذا رأيت هذه الرسالة:

/theme> qumralocal theme bundle

❌ themeName is missing from your Qumra config file

هذا يعني أنك بحاجة لإضافة themeName إلى ملف .qumra/qumra.config.json. افتح الملف وتأكد من أنه يتضمن سطراً مثل:

{
  "themeName": "your-theme-name",
  ...
}

بدون هذا السطر، لن تتمكن من تجميع قالبك.