minorun-marp-skill yordamida Marp taqdimot slaydlarini yaxshilang

minorun-marp-skill nima qiladi

minorun-marp-skill Marp yordamida taqdimot slaydlarini yaratish uchun qayta foydalaniladigan yo‘riqnomalar va tekshiruv vositalari to‘plamidir. U AI agentlariga nafaqat vizual jihatdan tartibli, balki aniq hikoya, foydali diagrammalar va muvozanatli dizaynga ega slaydlar yozishda yordam berish uchun yaratilgan.

Loyiha uning muallifi Minoru Onda tomonidan ko‘p marta qo‘llangan taqdimot takomillashtirish usullarini jamlaydi va ularni Claude Code kabi AI agentlari o‘qiy oladigan skilllar shaklida taqdim etadi. Materialdan Marp Markdown bilan mustaqil ishlaydigan insonlar ham bevosita foydalanishlari mumkin.

Repository tuzilmasi

Repository yozish yo‘riqnomalari, vizual dizayn, mavzular, tekshiruv vositalari va misollarni alohida qismlarga ajratadi:

• skills/slide-story qiziqtiruvchi kirishlar, bo‘limni ochuvchi slaydlar, bosqichma-bosqich ochib berish, sarlavha uslubi, yakunlar va taqdimot davomiyligini baholashni qamrab oladi.
• skills/slide-figures diagrammalardagi axborot zichligini kamaytirish, SVG rasmlar chizish, matnning minimal o‘lchamlarini belgilash va illyustratsiyalarni joylashtirishni tushuntiradi.
• skills/slide-design-dark bo‘sh joyni o‘lchash, vertikal muvozanat, to‘q fonlar, jadvallar, kod bloklari va Marp’ga xos muammolarni qamrab oladi.
• theme/minorun-dark.css moviy-yashil aksentlarga ega to‘q Marp mavzusini taqdim etadi.
• tools/ eksport qilingan PDF va SVG natijalarini o‘lchaydigan skriptlarni o‘z ichiga oladi.
• examples/sample namunaviy taqdimotni, examples/broken esa tekshiruvlar muammolarni aniqlashini tekshirish uchun ataylab xatolar kiritilgan taqdimotni o‘z ichiga oladi.

O‘rnatish va sozlash

Claude Code uchun skilllarni nusxalash

Claude Code’dan foydalanayotganda uchta skill katalogini shaxsiy Claude skill katalogingizga nusxalang:

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

Shundan so‘ng Claude Code slaydlarni yaratish yoki qayta ko‘rib chiqishda repository’dagi slide-story, slide-figures va slide-design-dark yo‘riqnomalaridan foydalanishi mumkin.

Mavzu va vositalarni slayd repository’siga nusxalash

theme/ va tools/ kataloglarini taqdimotingiz joylashgan repository’ga nusxalang. Bu mavzu va tekshiruv skriptlarini taqdimotda ishlatiladigan Markdown hamda aktivlar bilan birga saqlash imkonini beradi.

Zarur vositalarni o‘rnatish

Tekshiruv skriptlariga Marp CLI, Google Chrome, poppler, mupdf-tools, Python 3 va Pillow kerak bo‘ladi. Marp CLI’ni quyidagi buyruq bilan o‘rnating:

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

macOS’da PDF utilitalarini quyidagicha o‘rnating:

brew install poppler mupdf-tools

check-svg-box-fit.mjs Marp CLI tarkibidagi puppeteer-core paketidan foydalanadi. Agar uning modullari yoki Chrome bajariluvchi fayli avtomatik topilmasa, joylashuvlarini MARP_NODE_MODULES va CHROME_PATH orqali ko‘rsating.

Shriftlarni tayyorlash

Mavzu yumaloq Gothic shriftlari uchun mo‘ljallangan. Zen Maru Gothic shriftini o‘rnatish tavsiya etilgan ko‘rinishni ta’minlaydi. U mavjud bo‘lmagan macOS tizimlarida mavzu o‘rniga Hiragino Maru Gothic bilan ko‘rsatiladi. Shriftning mavjudligi yakuniy taqdimot ko‘rinishini o‘zgartirishi mumkin, shuning uchun slaydlarni eksport qilishdan oldin shriftni o‘rnating va tekshiring.

Taqdimot yaratish va eksport qilish

Slaydlaringizni deck.md kabi Marp Markdown faylida yozing. Uni kiritilgan to‘q mavzu va lokal fayllarni qo‘llab-quvvatlash bilan PDF’ga eksport qiling:

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

--theme parametri repository’dagi to‘q, moviy-yashil aksentli dizaynni qo‘llaydi. --allow-local-files parametri eksport vaqtida taqdimotda ko‘rsatilgan lokal rasmlar va boshqa aktivlarni yuklashga imkon beradi.

Eksport qilingan slaydlarni tekshirish

Eksportdan so‘ng yaratilgan PDF va SVG rasmlariga nisbatan tekshiruvlarni ishga tushiring. Bu tekshiruvlar Markdown manbasida sezish qiyin, ammo ko‘rsatilgan taqdimotda yaqqol ko‘rinadigan muammolarni aniqlash uchun mo‘ljallangan.

Chegaralarni tekshirish

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

Bu tekshiruv slayd tarkibining pastki va o‘ng chetlaridagi bo‘sh joyni o‘lchaydi.

Elementlar orasidagi bo‘shliqlarni tekshirish

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

Diagrammalar yoki bloklarning qo‘shni matnga juda yaqin joylashganini aniqlash uchun ushbu tekshiruvdan foydalaning.

Rasmlar ichidagi matnni tekshirish

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

Bu tekshiruv rasmlar ichidagi juda kichik matnni va bloklar chetlariga haddan tashqari yaqin joylashgan matnni qidiradi.

SVG bloklariga moslikni tekshirish

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

Bu tekshiruv SVG bloklari ichidagi matn ular ichiga sig‘ishini tekshiradi. U rasmlar slayd Markdown’idan alohida yaratilganda yoki tahrirlanganda ayniqsa foydalidir.

Qayta ishlatilgan slaydlarni tekshirish

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

Slaydlarni qayta ishlatganda ushbu taqqoslashni ishga tushiring. U yangi va eski Markdown fayllaridagi sarlavhalar hamda rasmlar o‘rtasidagi bog‘liqlikni tekshiradi va qayta ishlatilgan vizual tarkib atrofidagi xabarga endi mos kelmay qolganini aniqlashga yordam beradi.

Illyustratsiyalar qo‘shish

Namunaviy taqdimotda ko‘pincha Irasutoya illyustratsiyalaridan foydalaniladi, ammo bu rasmlar repository’ga kiritilmagan. Namunaviy taqdimotni eksport qilishdan oldin ularni yuklab oling:

sh examples/sample/fetch-illustrations.sh

Yuklab olingan har qanday illyustratsiyadan foydalanishdan oldin tegishli foydalanish shartlarini o‘zingiz tekshiring. Namunaviy taqdimot ko‘rinishida ko‘rsatilgan illyustratsiyalar Irasutoya’ning mualliflik huquqi bilan himoyalangan asarlaridir va ushbu repository’ning Apache License 2.0 litsenziyasi bilan qamrab olinmaydi.

AI yordamidagi amaliy ish jarayoni

1. Hikoyadan boshlang. AI agentidan slide-story yo‘riqnomasidan foydalanib, asosiy qiziqtiruvchi jihat, bo‘limlar o‘rtasidagi o‘tishlar, g‘oyalarning bosqichma-bosqich ochib berilishi, sarlavha uslubi, yakun va taxminiy nutq vaqtini belgilashni so‘rang.
2. Rasmlarni rejalashtiring. Har bir diagrammani auditoriya uchun zarur bo‘lgan ma’lumotgacha qisqartirish, o‘qilishi qulay matn o‘lchamlarini tanlash va SVG yoki illyustratsiya mos kelishini aniqlash uchun slide-figures dan foydalaning.
3. Vizual tizimni qo‘llang. Bo‘sh joy, vertikal muvozanat, to‘q fon kontrasti hamda jadval va kod uslubining izchilligini saqlash uchun slide-design-dark va minorun-dark.css dan foydalaning.
4. Erta eksport qiling. Faqat Markdown manbasi yoki muharrir ko‘rinishiga tayanish o‘rniga, Marp yordamida PDF yarating.
5. Natijani tekshiring. PDF va SVG tekshiruvlarini ishga tushiring, so‘ng slaydlarni siqilgan rasm yorliqlari, zaif oraliqlar yoki chetlardan haddan tashqari foydalanish kabi haqiqiy render muammolari asosida qayta ko‘rib chiqing.
6. Ta’qdimotni to‘liq ko‘rib chiqing. Slaydlar to‘plamida izchil rivojlanish borligini va har bir rasm shunchaki bezak bo‘lib qolmay, o‘z slaydining sarlavhasini qo‘llab-quvvatlashini tasdiqlang.

Ilg‘or maslahatlar

Buzilgan namunadan regressiya testi sifatida foydalaning

examples/broken katalogida ataylab muammoli slaydlar to‘plami mavjud. Undan tekshiruv skriptlari to‘g‘ri o‘rnatilganini va ular aniqlash uchun yaratilgan joylashuv muammolariga javob berishini tasdiqlash uchun foydalaning.

Faqat manba Markdown’ini emas, PDF’larni ham tekshiring

Marp orqali render qilish manba kodida ko‘rinmaydigan muammolarni, jumladan shrift mavjudligi, blok o‘lchamlari, mahalliy resurslar va yakuniy sahifa joylashuvi sababli yuzaga keladigan o‘zgarishlarni ham ko‘rsatishi mumkin. Eksport qilingan PDF’ni tekshiriladigan asosiy artefakt deb hisoblang.

Rasm matnini o‘qilishi qulay saqlang

Diagrammada ma’lumot haddan tashqari ko‘p bo‘lsa, avvalo matnni kichraytirish o‘rniga tafsilotlarni olib tashlang yoki keyinga qoldiring. Rasm yo‘riqnomasi va check-figure-text.py jonli taqdimot vaqtida diagrammalar o‘qilishini ta’minlash uchun birgalikda ishlaydi.

Sarlavhalar va rasmlarni moslang

Agar avvalgi slayddan qayta foydalansangiz, uning sarlavhasi va vizual izohini ham yangilang. Qayta foydalanishdagi farqlarni tekshirish eski rasm qolib ketgan, ammo slayd xabari o‘zgargan holatlarni aniqlashga yordam beradi.

Litsenziya chegaralarini yodda tuting

Repozitoriy Apache License 2.0 asosida chiqarilgan, mualliflik huquqi Minoru Ondaga tegishli. Tashqi shriftlar va illyustratsiyalar alohida shartlarga ega bo‘lishi mumkin, shuning uchun slaydlar to‘plamini tarqatishdan oldin ularning litsenziyalarini mustaqil tekshiring.

Xulosa

minorun-marp-skill Marp uchun taqdimot tavsiyalarini qayta foydalanish mumkin bo‘lgan AI agent ko‘nikmalari, to‘q mavzu, namunalar va aniq natija tekshiruvlariga aylantiradi. Ko‘nikmalarni Claude Code’ga nusxalang, mavzu va vositalarni slaydlar to‘plamingiz yoniga joylashtiring, Marp yordamida eksport qiling hamda render qilingan PDF va SVG fayllarini tekshiring. Bu jarayon slaydlarni sayqallashni oxirgi bosqichga qoldirmasdan, hikoya, diagrammalar va vizual dizaynning birgalikda ishlashiga yordam beradi.