صايب سلايدات ديال عروض Marp حسن باستعمال minorun-marp-skill

شنو كيدير minorun-marp-skill

minorun-marp-skill هو مجموعة ديال إرشادات وأدوات للفحص قابلة لإعادة الاستعمال، مخصّصة لإنشاء شرائح العروض التقديمية باستعمال Marp. تصمّم باش تعاون الوكلاء ديال الذكاء الاصطناعي يكتبو شرائح ماشي غير مرتّبة بصرياً، ولكن حتى عندها قصة واضحة، ورسومات مفيدة، وتصميم متوازن.

المشروع كيجمع تحسينات فالعروض التقديمية اللي كيستعملها المؤلف ديالو، Minoru Onda، بشكل متكرر، وكيحطّها فشكل مهارات يقدرو يقراوها وكلاء الذكاء الاصطناعي بحال Claude Code. وحتّى الناس اللي كيكتبو Marp Markdown بوحدهم يقدرو يستافدو من هاد المحتوى مباشرة.

بنية المستودع

المستودع كيفصل بين إرشادات الكتابة، والتصميم البصري، والثيمات، وأدوات التحقق، والأمثلة:

• skills/slide-story كيغطي الجُمل الجاذبة، وشرائح افتتاح الأقسام، والكشف التدريجي على المعلومات، وأسلوب العناوين، والنهايات، وتقدير مدة العرض.
• skills/slide-figures كيشرح كيفاش تنقص كثافة المعلومات فالرسومات، وترسم أشكال SVG، وتحدد الحد الأدنى لحجم النص، وتحطّ الإيضاحات.
• skills/slide-design-dark كيغطي قياس المساحات الفارغة، والتوازن العمودي، والخلفيات الداكنة، والجداول، وكتل الكود، والمشاكل الخاصة بـ Marp.
• theme/minorun-dark.css كيوفّر ثيم داكن لـ Marp بلمسات باللون السيان.
• tools/ فيها سكريبتات كتقيس مخرجات PDF وSVG المصدّرة.
• examples/sample فيها عرض نموذجي، بينما examples/broken فيها مشاكل مقصودة باش تقدر تتأكد باللي الفحوصات كتكشفها.

التثبيت والإعداد

نسخ المهارات إلى Claude Code

ملي كتستعمل Claude Code، نسخ مجلدات المهارات الثلاثة لمجلد المهارات الشخصي ديال Claude:

cp -r skills/* ~/.claude/skills/

من بعد، يقدر Claude Code يستعمل إرشادات slide-story وslide-figures وslide-design-dark ديال المستودع ملي يعاونك تنشئ الشرائح ولا تراجعها.

نسخ الثيم والأدوات إلى مستودع الشرائح

نسخ المجلدين theme/ وtools/ للمستودع اللي فيه العرض ديالك. بهاد الطريقة كيبقاو الثيم وسكريبتات التحقق حدّ ملف Markdown والموارد المستعملة فالعرض.

تثبيت الأدوات المطلوبة

سكريبتات الفحص كتحتاج Marp CLI وGoogle Chrome وpoppler وmupdf-tools وPython 3 وPillow. ثبّت Marp CLI بهاد الأمر:

npm i -g @marp-team/marp-cli

فـ macOS، ثبّت أدوات PDF بهاد الأمر:

brew install poppler mupdf-tools

check-svg-box-fit.mjs كيستعمل puppeteer-core اللي كيجي مضمّن مع Marp CLI. إلا ما قدرش يلقى الموديولات ديالو ولا الملف التنفيذي ديال Chrome أوتوماتيكياً، حدّد المسارات ديالهم باستعمال MARP_NODE_MODULES وCHROME_PATH.

تحضير الخطوط

الثيم مهيّأ للخطوط القوطية المدورة. تثبيت Zen Maru Gothic كيعطي المظهر المفضّل. فأنظمة macOS اللي ما متوفرش فيها، كيعرض الثيم باستعمال Hiragino Maru Gothic عوضاً منو. توفر الخطوط يقدر يبدّل مظهر العرض النهائي، لذلك ثبّت الخط وتأكد منو قبل تصدير الشرائح.

إنشاء عرض وتصديرو

كتب الشرائح ديالك فملف Marp Markdown بحال deck.md. صدّرو إلى PDF باستعمال الثيم الداكن المرفق ودعم الملفات المحلية:

marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files

الخيار --theme كيطبّق التصميم الداكن ديال المستودع بلمسات سيان. والخيار --allow-local-files كيسمح بتحميل الصور المحلية والموارد الأخرى المشار إليها فالعرض وقت التصدير.

التحقق من الشرائح المصدّرة

من بعد التصدير، شغّل الفحوصات على PDF الناتج وعلى أي أشكال SVG. هاد الفحوصات مخصّصة تكشف المشاكل اللي ساهل ما تبانش فمصدر Markdown ولكن كتبان بوضوح فالعرض المرسوم.

فحص الهوامش

python3 tools/check-dark-margins.py deck.pdf

هاد الفحص كيقيس المساحة الفارغة فالحواف السفلية واليمنى ديال محتوى الشريحة.

فحص الفجوات بين العناصر

python3 tools/check-dark-gaps.py deck.pdf

استعمل هاد الفحص باش تلقى الرسومات ولا المربعات اللي قريبة بزاف من النص المجاور.

فحص النص داخل الأشكال

python3 tools/check-figure-text.py deck.pdf

هاد الفحص كيقلب على النص الصغير داخل الأشكال، وعلى النص اللي ملصق بزاف بحواف المربعات.

فحص ملاءمة مربعات SVG

node tools/check-svg-box-fit.mjs images/*.svg

هاد الفحص كيتأكد باللي النص داخل مربعات SVG داخل فيها مزيان. وكيكون مفيد خصوصاً ملي كتتولّد الأشكال ولا كتتعدّل بشكل منفصل على Markdown ديال الشرائح.

فحص الشرائح المعاد استعمالها

python3 tools/check-reuse-diff.py new.md old.md

شغّل هاد المقارنة ملي كتعاود تستعمل الشرائح. كيتحقق من العلاقة بين العناوين والأشكال فملفي Markdown الجديد والقديم، وكيعاونك تلاحظ ملي المحتوى البصري المعاد استعمالو ما بقاش منسجم مع الرسالة المحيطة به.

إضافة الإيضاحات

العرض النموذجي كيستعمل غالباً إيضاحات من Irasutoya، ولكن هاد الصور ماشي مضمّنة فالمستودع. حمّلها قبل ما تصدّر العرض النموذجي:

sh examples/sample/fetch-illustrations.sh

تحقق براسك من شروط الاستعمال المطبّقة قبل ما تستعمل أي إيضاح محمّل. الإيضاحات اللي باينة فملخص العرض النموذجي هي أعمال محمية بحقوق الطبع ديال Irasutoya، وما كيغطيهاش ترخيص Apache 2.0 ديال هاد المستودع.

سير عمل عملي بمساعدة الذكاء الاصطناعي

1. بدا بالقصة. طلب من وكيل الذكاء الاصطناعي يستعمل إرشادات slide-story باش يحدّد الخطّاف، والانتقالات بين الأقسام، والكشف التدريجي على الأفكار، وستايل العناوين، والخاتمة، والمدة التقريبية ديال الكلام.
2. خطّط للأشكال. استعمل slide-figures باش تختاصر كل رسم فالمعلومات الضرورية للجمهور، وتختار أحجام نصوص مقروءة، وتقرّر واش SVG ولا رسم توضيحي هو الأنسب.
3. طبّق النظام البصري. استعمل slide-design-dark وminorun-dark.css باش تحافظ على المساحات الفارغة، والتوازن العمودي، والتباين مع الخلفية الغامقة، وتناسق تنسيق الجداول والكود.
4. صدّر بكري. ولّد PDF باستعمال Marp، وما تعتمدش غير على مصدر Markdown ولا على المعاينة ديال المحرّر.
5. عاين الناتج. شغّل فحوصات PDF وSVG، ومن بعد راجع الشرائح بناءً على المشاكل اللي باينة فالرندر الفعلي، بحال تسميات الأشكال المزدحمة، وضعف التباعد، ولا الاستعمال المفرط للحواف.
6. راجع العرض كامل. تأكّد باللي العرض عندو تسلسل واضح، وأن كل شكل كيدعم العنوان الرئيسي ديال الشريحة ديالو، وماشي غير كيزوّقها.

نصائح متقدمة

استعمل المثال المعطوب كاختبار تراجعي

المجلد examples/broken فيه عن قصد عرض فيه مشاكل. استعملو باش تتأكّد باللي سكريبتات المعاينة مركّبة مزيان، وباللي كتتفاعل مع أنواع مشاكل التخطيط اللي تصمّمات باش تكشف عليها.

فحّص ملفات PDF، وماشي غير Markdown المصدر

رندر Marp يقدر يبيّن مشاكل ما كاتبانش فالكود المصدر، ومن بينها التغييرات الناتجة عن توفّر الخطوط، وحساب أحجام العناصر، والملفات المحلية، وتخطيط الصفحة النهائي. اعتابر PDF المصدّر هو الملف اللي خاصك تعاينو.

خلّي نصوص الأشكال مقروءة

إلى كان الرسم فيه معلومات بزاف، حيّد التفاصيل ولا أخّرها قبل ما تصغّر النص. إرشادات الأشكال وcheck-figure-text.py كيخدمو بجوج باش يبقاو الرسومات مقروئين فالعرض المباشر.

حافظ على محاذاة العناوين والأشكال

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

ردّ بالك لحدود التراخيص

المستودع منشور بموجب ترخيص Apache 2.0، وحقوق التأليف منسوبة لـ Minoru Onda. الخطوط والرسومات التوضيحية الخارجية يقدرو يكون عندهم شروط مختلفة، لذلك تحقّق من تراخيصهم بشكل مستقل قبل ما توزّع العرض.

الخلاصة

minorun-marp-skill كيحوّل نصائح إعداد العروض باستعمال Marp لمهارات قابلة لإعادة الاستعمال لوكلاء الذكاء الاصطناعي، وموضوع غامق، وأمثلة، وفحوصات عملية للناتج. نسخ المهارات لـ Claude Code، وحطّ الموضوع والأدوات حدّ العرض ديالك، وصدّر باستعمال Marp، ومن بعد عاين ملفات PDF وSVG المردودة. هاد المسار كيساعد يخلي السرد، والرسومات، والتصميم البصري خدامين مع بعضياتهم، عوض ما يتعتبر تلميع الشرائح غير خطوة أخيرة.