محمود عبدالنبي
أنظمة المحتوى · أداة سطر أوامر · 2

دليل المستودع: مدقق كثافة شرائح الكاروسيل وإيقاع التمرير

صفحة تعريفية مستقلة بمستودع مدقق كثافة شرائح الكاروسيل وإيقاع التمرير. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Create an automated carousel pacing auditor in Python (carousel_auditor.py): 1) Ingests multi-slide Markdown or JSON files representing social carousels, 2) Evaluates word density per slide (flagging >50 words), 3) Checks for presence of cliffhanger transition hooks between slides, 4) Generates an interactive visual HTML preview simulating mobile swipe flow with pass/fail metrics.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • data/copywriting_angles_ar.json
  • data/dialect_variations.csv
  • docs/angle-selection-guide.md
  • examples/good_and_bad_carousel.json
  • frameworks/10-slide-carousel-architecture.md
  • LICENSE
  • README.md
  • reports/preview_simulation.html
  • SOURCES.md
  • src/carousel_auditor.py
  • tests/test_auditor.py
  • tests/test_carousel.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/carousel_auditor.py --help

النطاق والقيود

  • Cognitive Load Limits: Enforces maximum word counts (30-50 words per slide) to ensure comfortable mobile legibility without pinch-to-zoom.
  • Visual Hook & Drop-Off Pacing: Audits slide 1 visual punch and slide 2 bridge question to minimize initial swipe drop-off.
  • Safe Zone Padding: Keeps text and critical illustrations away from outer margins and platform swipe navigation badges.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة