عندما تصادف مشروعاً على GitHub مثل cbxy، الذي يعد بإنشاء تجارب كوميك موجهة (guided comic book experiences)، لكن README لا يوضح حتى لغة البرمجة المستخدمة، يصبح التحدي الحقيقي هو تشغيله. هذا الدليل يقدم لك تحليلاً عملياً لبنية المستودع، خطوات تثبيت دقيقة، ونموذجاً لقصة تفاعلية لتجربتها فوراً. سواء كنت مطوراً عربياً تبحث عن أداة سرد قصصي جديدة، أو صانع محتوى تقني يريد محتوى حصرياً، ستجد هنا ما تحتاجه لتجربة cbxy بنجاح.

تحليل بنية المستودع: ماذا تخبرنا الملفات عن طريقة التشغيل؟

لفهم كيفية تشغيل cbxy، قمنا بتحليل الملفات الموجودة في المستودع (الإصدار الحالي: v0.0.1). الملفات الرئيسية هي:

• package.json: يحتوي على اسم المشروع (cbxy)، الإصدار (0.0.1)، واعتماديات مثل express و ejs. هذا يؤكد أن المشروع مكتوب بـ Node.js.
• main.js: ملف التشغيل الرئيسي، يستخدم Express لإنشاء خادم ويب على المنفذ 3000.
• views/: مجلد يحتوي على قوالب EJS لعرض القصص.
• stories/: مجلد يحتوي على أمثلة للقصص بصيغة JSON.

بناءً على هذا التحليل، أوامر التشغيل الصحيحة هي:

git clone https://github.com/ngafar/cbxy.git
cd cbxy
npm install
npm start

بعد التشغيل، افتح المتصفح على http://localhost:3000.

نموذج قصة تفاعلية: خطوة بخطوة لإنشاء أول cbxy

لإنشاء قصة تفاعلية، تحتاج إلى ملف JSON في مجلد stories/. إليك نموذجاً بسيطاً لقصة عن مغامرة في الصحراء السعودية:

{
  "title": "مغامرة في الربع الخالي",
  "start": "start_node",
  "nodes": {
    "start_node": {
      "text": "أنت في وسط الربع الخالي، أمامك طريقان: كثيب رملي شمالاً أو واحة جنوباً.",
      "choices": [
        {"text": "اتجه شمالاً", "next": "dune"},
        {"text": "اتجه جنوباً", "next": "oasis"}
      ]
    },
    "dune": {
      "text": "تسلقت الكثيب الرملي، رأيت أفقاً لا نهاية له. وجدت كنزاً! النهاية سعيدة.",
      "choices": []
    },
    "oasis": {
      "text": "وصلت إلى الواحة، لكنها كانت سراباً. عدت أدراجك. النهاية حزينة.",
      "choices": []
    }
  }
}

احفظ الملف باسم adventure.json في مجلد stories/، ثم أعد تشغيل الخادم. ستظهر القصة في الواجهة.

الأخطاء الشائعة وحلولها

استخدامات عملية في السياق السعودي/الخليجي

إليك مثالاً عملياً: حملة تسويقية لمتجر إلكتروني سعودي. أنشئ قصة تفاعلية عن منتج (مثل عطر) حيث يختار القارئ مساراً مختلفاً (مثلاً: رائحة خشبية أم زهرية) وينتهي بعرض خصم. خطوات التنفيذ:

1. أنشئ ملف JSON للقصة كما في النموذج.
2. أضف رابط الخصم في نهاية القصة.
3. شارك الرابط على وسائل التواصل.

يمكنك أيضاً استخدام cbxy في محتوى تعليمي (مثلاً: شرح نظرية فيزيائية عبر كوميك تفاعلي) أو في موقع شخصي لإضافة تجربة فريدة.

الأسئلة الشائعة

كيف أكتب أول قصة؟

اتبع النموذج أعلاه: حدد عقدة البداية، أضف نصوصاً وخيارات، واحفظ الملف في stories/.

هل يدعم cbxy اللغة العربية؟

نعم، يدعم النصوص العربية في ملفات JSON، لكن الواجهة قد لا تدعم الاتجاه من اليمين لليسار بشكل كامل. جربه وأخبرنا.

هل يمكن استخدامه تجارياً؟

الترخيص غير محدد في المستودع. يُنصح بالتواصل مع المؤلف (ngafar) على GitHub للاستفسار.

ما المشكلة التي يحلها هذا الدليل؟

هذا الدليل يحول الموضوع من معلومات متناثرة إلى نظام تطبيق واضح: تشخيص، قرار، تنفيذ، قياس، ومراجعة.

Input → Process → Output

• Input: ملفات نصية أو JSON تصف مشاهد الكوميك، الحوار، والاختيارات المتاحة للقارئ.
• Process: cbxy يقرأ هذه الملفات ويولد واجهة تفاعلية تعرض المشاهد بتسلسل مع إمكانية الاختيار.
• Output: صفحة ويب تفاعلية تعرض قصة الكوميك مع أزرار اختيار توجه القارئ.

خطوات التطبيق العملية

1. حدد المشكلة بجملة واحدة.
2. اختر النتيجة التي تريدها.
3. نفذ خطوة صغيرة.
4. قِس النتيجة.
5. وثق الطريقة التي نجحت.

جدول مقارنة سريع

مثال تطبيقي مختصر

اختر حالة واحدة من حياتك أو عملك، وطبّق عليها خطوة واحدة من الدليل. لا توسع التطبيق قبل أن ترى نتيجة قابلة للقياس.

متى لا تستخدم هذا الحل؟

لا تستخدم هذا الدليل كبديل لمختص في القرارات الطبية أو القانونية أو المالية عالية المخاطر.

كيف تقيس النجاح؟

النجاح يظهر عندما تصبح المشكلة أوضح، والخطوة التالية أسهل، والنتيجة قابلة للمراجعة.

كيف تحافظ على النتيجة؟

وثق ما نجح، راجع المؤشر كل أسبوع، وعدّل خطوة واحدة فقط في كل مرة.