minorun-marp-skill کے ساتھ بہتر Marp پریزنٹیشن سلائیڈز بنائیں

minorun-marp-skill کیا کرتا ہے

minorun-marp-skill قابلِ دوبارہ استعمال رہنمائی اور جانچ کے ٹولز کا مجموعہ ہے، جس کے ذریعے Marp کے ساتھ پریزنٹیشن سلائیڈز تیار کی جاتی ہیں۔ اسے AI ایجنٹس کی مدد کے لیے بنایا گیا ہے تاکہ وہ ایسی سلائیڈز لکھ سکیں جو نہ صرف بصری طور پر صاف ستھری ہوں بلکہ ان میں واضح کہانی، مفید خاکے اور متوازن ڈیزائن بھی ہو۔

یہ پروجیکٹ اس کے مصنف Minoru Onda کی جانب سے بار بار استعمال کی جانے والی پریزنٹیشن بہتریوں کو جمع کرتا ہے اور انہیں ایسی مہارتوں کی شکل دیتا ہے جنہیں Claude Code جیسے AI ایجنٹس پڑھ سکتے ہیں۔ یہ مواد ان لوگوں کے لیے بھی براہِ راست قابلِ استعمال ہے جو خود 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 Marp CLI کے ساتھ شامل puppeteer-core استعمال کرتا ہے۔ اگر اس کے ماڈیولز یا Chrome قابلِ عمل فائل خودکار طور پر نہ ملیں تو ان کے مقامات MARP_NODE_MODULES اور CHROME_PATH کے ذریعے فراہم کریں۔

فونٹس تیار کریں

یہ تھیم گولائی والے Gothic فونٹس کے لیے بنائی گئی ہے۔ 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 License 2.0 کے تحت شامل نہیں ہیں۔

عملی AI معاون ورک فلو

1. کہانی سے آغاز کریں۔ AI ایجنٹ سے کہیں کہ slide-story رہنمائی استعمال کرتے ہوئے مرکزی کشش، حصوں کے درمیان منتقلی، خیالات کے تدریجی اظہار، سرخی کے انداز، اختتام اور متوقع تقریری وقت کی وضاحت کرے۔
2. اشکال کی منصوبہ بندی کریں۔ slide-figures استعمال کرتے ہوئے ہر خاکے کو سامعین کے لیے ضروری معلومات تک محدود کریں، قابلِ مطالعہ متن کے سائز منتخب کریں، اور طے کریں کہ SVG یا تمثیل میں سے کون سا موزوں ہے۔
3. بصری نظام نافذ کریں۔ خالی جگہ، عمودی توازن، گہرے پس منظر پر تضاد، اور جدول و کوڈ کے یکساں انداز کو برقرار رکھنے کے لیے slide-design-dark اور minorun-dark.css استعمال کریں۔
4. جلد برآمد کریں۔ صرف Markdown ماخذ یا ایڈیٹر کے پیش منظر پر انحصار کرنے کے بجائے Marp کے ذریعے PDF بنائیں۔
5. آؤٹ پٹ کا جائزہ لیں۔ PDF اور SVG کی جانچ چلائیں، پھر حقیقی رینڈرنگ کے مسائل کی بنیاد پر سلائیڈز میں ترمیم کریں، مثلاً شکل کے سکڑے ہوئے لیبل، کمزور وقفہ کاری، یا کناروں کا حد سے زیادہ استعمال۔
6. پوری گفتگو کا جائزہ لیں۔ تصدیق کریں کہ ڈیک میں خیالات کی مربوط پیش رفت ہے اور ہر شکل اپنی سلائیڈ کی سرخی کو تقویت دیتی ہے، محض سجاوٹ نہیں کرتی۔

اعلیٰ درجے کی تجاویز

خراب مثال کو رجعتی جانچ کے طور پر استعمال کریں

examples/broken ڈائریکٹری میں جان بوجھ کر مسائل والی ایک ڈیک شامل ہے۔ اسے استعمال کرکے تصدیق کریں کہ جانچ کے اسکرپٹس درست طور پر نصب ہیں اور ان لے آؤٹ مسائل کا جواب دیتے ہیں جن کی نشاندہی کے لیے انہیں بنایا گیا ہے۔

صرف ماخذ Markdown نہیں، PDFs کی توثیق کریں

Marp کی رینڈرنگ ایسے مسائل ظاہر کرسکتی ہے جو ماخذ کوڈ میں نمایاں نہیں ہوتے، جن میں فونٹ کی دستیابی، باکس سائزنگ، مقامی اثاثوں اور آخری صفحے کے لے آؤٹ سے ہونے والی تبدیلیاں شامل ہیں۔ برآمد شدہ PDF کو جانچنے کے لیے اصل آؤٹ پٹ سمجھیں۔

شکل کا متن قابلِ مطالعہ رکھیں

جب کسی خاکے میں بہت زیادہ معلومات ہوں تو متن کا سائز گھٹانے کے بجائے پہلے تفصیل کم کریں یا بعد کے لیے مؤخر کریں۔ شکل کی رہنمائی اور check-figure-text.py مل کر لائیو پریزنٹیشن کے دوران خاکوں کو قابلِ مطالعہ رکھنے میں مدد دیتے ہیں۔

سرخیوں اور اشکال کو ہم آہنگ رکھیں

اگر آپ کسی سابقہ سلائیڈ کو دوبارہ استعمال کریں تو اس کی سرخی اور بصری وضاحت دونوں کو اپ ڈیٹ کریں۔ دوبارہ استعمال کے فرق کی جانچ ان صورتوں کی نشاندہی میں مدد دیتی ہے جہاں پرانی شکل برقرار رہتی ہے لیکن سلائیڈ کا پیغام بدل چکا ہوتا ہے۔

لائسنس کی حدود یاد رکھیں

یہ ریپوزٹری Apache License 2.0 کے تحت جاری کی گئی ہے، اور کاپی رائٹ Minoru Onda کے نام ہے۔ بیرونی فونٹس اور تمثیلات کی شرائط الگ ہوسکتی ہیں، اس لیے ڈیک تقسیم کرنے سے پہلے ان کے لائسنس الگ سے جانچ لیں۔

نتیجہ

minorun-marp-skill Marp کے لیے پریزنٹیشن کی ہدایات کو دوبارہ قابلِ استعمال AI ایجنٹ اسکلز، ایک گہرے تھیم، مثالوں اور ٹھوس آؤٹ پٹ جانچوں میں تبدیل کرتا ہے۔ اسکلز کو Claude Code میں نقل کریں، تھیم اور ٹولز اپنی ڈیک کے ساتھ رکھیں، Marp کے ذریعے برآمد کریں، اور رینڈر شدہ PDF اور SVG فائلوں کا جائزہ لیں۔ یہ ورک فلو بیانیے، خاکوں اور بصری ڈیزائن کو باہم مربوط رکھنے میں مدد دیتا ہے، بجائے اس کے کہ سلائیڈ کی نفاست کو آخر میں کیا جانے والا کام سمجھا جائے۔