Unda Slaidi Bora za Mawasilisho ya Marp kwa kutumia minorun-marp-skill

Kile minorun-marp-skill Inachofanya

minorun-marp-skill ni mkusanyiko wa mwongozo unaoweza kutumika tena na zana za ukaguzi kwa kuunda slaidi za uwasilishaji kwa kutumia Marp. Imeundwa kusaidia mawakala wa AI kuandika slaidi ambazo si nadhifu tu kimuonekano, bali pia zina mtiririko wa hadithi ulio wazi, michoro yenye manufaa, na muundo uliosawazika.

Mradi huu unanasa maboresho ya uwasilishaji yaliyotumiwa mara kwa mara na mwandishi wake, Minoru Onda, na kuyafungasha kama ujuzi ambao mawakala wa AI kama Claude Code wanaweza kusoma. Nyenzo hizi pia zinaweza kutumiwa moja kwa moja na watu wanaoandika Marp Markdown wenyewe.

Muundo wa Hazina

Hazina inatenganisha mwongozo wa uandishi, muundo wa kuona, mandhari, zana za uthibitishaji na mifano:

• skills/slide-story inashughulikia vivutio, slaidi za kuanzisha sehemu, ufichuaji wa hatua kwa hatua, mtindo wa vichwa, hitimisho na kukadiria urefu wa uwasilishaji.
• skills/slide-figures inaeleza jinsi ya kupunguza msongamano wa taarifa kwenye michoro, kuchora michoro ya SVG, kuweka ukubwa wa chini wa maandishi na kupanga vielelezo.
• skills/slide-design-dark inashughulikia upimaji wa nafasi tupu, usawazishaji wa wima, mandharinyuma meusi, majedwali, vizuizi vya msimbo na changamoto mahususi za Marp.
• theme/minorun-dark.css hutoa mandhari meusi ya Marp yenye lafudhi za samawati angavu.
• tools/ ina hati zinazopima matokeo ya PDF na SVG yaliyotolewa.
• examples/sample ina mkusanyiko wa mfano, huku examples/broken ikiwa na matatizo yaliyowekwa kwa makusudi ili uweze kuthibitisha kuwa ukaguzi unayagundua.

Usakinishaji na Usanidi

Nakili Ujuzi kwa Claude Code

Unapotumia Claude Code, nakili saraka tatu za ujuzi kwenye saraka yako binafsi ya ujuzi ya Claude:

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

Baada ya hapo, Claude Code inaweza kutumia mwongozo wa slide-story, slide-figures na slide-design-dark wa hazina inapokusaidia kuunda au kurekebisha slaidi.

Nakili Mandhari na Zana kwenye Hazina ya Slaidi Zako

Nakili saraka za theme/ na tools/ kwenye hazina iliyo na mkusanyiko wako. Hii huweka mandhari na hati za uthibitishaji pamoja na Markdown na vipengee vinavyotumiwa katika uwasilishaji.

Sakinisha Zana Zinazohitajika

Hati za ukaguzi zinategemea Marp CLI, Google Chrome, poppler, mupdf-tools, Python 3 na Pillow. Sakinisha Marp CLI kwa kutumia:

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

Kwenye macOS, sakinisha zana za PDF kwa kutumia:

brew install poppler mupdf-tools

check-svg-box-fit.mjs hutumia puppeteer-core iliyojumuishwa kwenye Marp CLI. Ikiwa moduli zake au faili tendaji la Chrome haliwezi kupatikana kiotomatiki, toa maeneo yake kupitia MARP_NODE_MODULES na CHROME_PATH.

Andaa Fonti

Mandhari hii imekusudiwa fonti za Gothic zenye mviringo. Kusakinisha Zen Maru Gothic hutoa mwonekano unaopendekezwa. Kwenye mifumo ya macOS ambapo fonti hiyo haipatikani, mandhari huonyeshwa kwa kutumia Hiragino Maru Gothic badala yake. Upatikanaji wa fonti unaweza kubadilisha mwonekano wa mkusanyiko wa mwisho, kwa hiyo sakinisha na uthibitishe fonti kabla ya kutoa slaidi.

Unda na Toa Mkusanyiko

Andika slaidi zako katika faili ya Marp Markdown kama deck.md. Itoe kama PDF kwa kutumia mandhari meusi iliyojumuishwa na usaidizi wa faili za ndani:

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

Chaguo la --theme hutumia muundo meusi wa hazina wenye lafudhi za samawati angavu. Chaguo la --allow-local-files huruhusu picha za ndani na vipengee vingine vinavyorejelewa na mkusanyiko kupakiwa wakati wa utoaji.

Thibitisha Slaidi Zilizotolewa

Baada ya kutoa slaidi, endesha ukaguzi dhidi ya PDF iliyozalishwa na michoro yoyote ya SVG. Ukaguzi huu unakusudiwa kugundua matatizo ambayo ni rahisi kukosa katika chanzo cha Markdown lakini yanaonekana wazi katika uwasilishaji uliotolewa.

Angalia Pembezoni

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

Ukaguzi huu hupima nafasi tupu iliyo chini na kwenye kingo za kulia za maudhui ya slaidi.

Angalia Nafasi Kati ya Vipengee

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

Tumia ukaguzi huu kutafuta michoro au visanduku vilivyo karibu sana na maandishi ya jirani.

Angalia Maandishi Ndani ya Michoro

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

Ukaguzi huu hutafuta maandishi madogo ndani ya michoro na maandishi yaliyo karibu sana na kingo za visanduku.

Angalia Ulinganifu wa Visanduku vya SVG

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

Ukaguzi huu huthibitisha kuwa maandishi ndani ya visanduku vya SVG yanatoshea kwenye visanduku hivyo. Ni muhimu hasa wakati michoro inatengenezwa au kuhaririwa tofauti na Markdown ya slaidi.

Angalia Slaidi Zilizotumiwa Tena

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

Endesha ulinganisho huu unapotumia slaidi tena. Hukagua uhusiano kati ya vichwa na michoro katika faili mpya na za zamani za Markdown, na kukusaidia kutambua wakati maudhui ya kuona yaliyotumiwa tena hayalingani tena na ujumbe unaoyazunguka.

Ongeza Vielelezo

Uwasilishaji wa mfano mara nyingi hutumia vielelezo kutoka Irasutoya, lakini picha hizo hazijajumuishwa kwenye hazina. Zipakue kabla ya kutoa mkusanyiko wa mfano:

sh examples/sample/fetch-illustrations.sh

Jihakikishie mwenyewe masharti yanayotumika ya matumizi kabla ya kutumia kielelezo chochote kilichopakuliwa. Vielelezo vinavyoonyeshwa katika muhtasari wa mkusanyiko wa mfano ni kazi zilizo na hakimiliki za Irasutoya na hazilindwi na Leseni ya Apache 2.0 ya hazina hii.

Mtiririko wa Kazi wa Kivitendo Unaosaidiwa na AI

1. Anza na hadithi. Mwombe wakala wa AI atumie mwongozo wa slide-story kufafanua kichocheo, mabadiliko ya sehemu, ufunuaji wa mawazo hatua kwa hatua, mtindo wa vichwa, hitimisho, na muda unaokadiriwa wa kuzungumza.
2. Panga vielelezo. Tumia slide-figures kupunguza kila mchoro ubaki na taarifa muhimu kwa hadhira, chagua ukubwa wa maandishi unaosomeka, na uamue ikiwa SVG au mchoro unafaa.
3. Tumia mfumo wa kuona. Tumia slide-design-dark na minorun-dark.css kudumisha nafasi wazi, usawa wa wima, utofautishaji kwenye mandharinyuma meusi, na mtindo thabiti wa majedwali na msimbo.
4. Hamisha mapema. Tengeneza PDF kwa Marp badala ya kutegemea tu chanzo cha Markdown au mwonekano wa kihariri.
5. Kagua matokeo. Tekeleza ukaguzi wa PDF na SVG, kisha rekebisha slaidi kulingana na matatizo halisi ya uonyeshaji kama vile lebo za vielelezo zilizosongamana, nafasi hafifu, au matumizi kupita kiasi ya kingo.
6. Pitia hotuba nzima. Thibitisha kuwa wasilisho lina mtiririko unaoeleweka na kwamba kila kielelezo kinaunga mkono kichwa cha slaidi yake badala ya kuwa mapambo tu.

Vidokezo vya Juu

Tumia Mfano Ulioharibika kama Jaribio la Urejeshaji

Saraka ya examples/broken ina kwa makusudi wasilisho lenye matatizo. Itumie kuthibitisha kuwa hati za ukaguzi zimesakinishwa kwa usahihi na zinajibu aina za matatizo ya mpangilio ambazo ziliundwa kugundua.

Thibitisha PDF, Sio Markdown ya Chanzo Pekee

Uonyeshaji wa Marp unaweza kufichua matatizo ambayo hayaonekani kwenye msimbo wa chanzo, yakiwemo mabadiliko yanayosababishwa na upatikanaji wa fonti, ukubwa wa visanduku, vipengee vya ndani, na mpangilio wa mwisho wa ukurasa. Ichukulie PDF iliyohamishwa kama kifaa cha kukagua.

Weka Maandishi ya Vielelezo Yanasomeka

Mchoro unapokuwa na taarifa nyingi sana, kwanza ondoa au ahirisha maelezo badala ya kupunguza maandishi. Mwongozo wa vielelezo na check-figure-text.py hufanya kazi pamoja ili kuweka michoro ikiwa inasomeka wakati wa uwasilishaji wa moja kwa moja.

Weka Vichwa na Vielelezo Vikiwa na Uwiano

Ukitumia tena slaidi ya awali, sasisha kichwa chake na maelezo yake ya kuona. Ukaguzi wa tofauti za matumizi tena husaidia kutambua hali ambapo kielelezo cha zamani kimesalia huku ujumbe wa slaidi ukiwa umebadilika.

Kumbuka Mipaka ya Leseni

Hazina hii imetolewa chini ya Apache License 2.0, huku hakimiliki ikitambuliwa kwa Minoru Onda. Fonti na vielelezo vya nje vinaweza kuwa na masharti tofauti, kwa hiyo thibitisha leseni zake kando kabla ya kusambaza wasilisho.

Hitimisho

minorun-marp-skill hubadilisha ushauri wa uwasilishaji wa Marp kuwa ujuzi unaoweza kutumiwa tena na mawakala wa AI, mandhari meusi, mifano, na ukaguzi madhubuti wa matokeo. Nakili ujuzi huo kwenye Claude Code, weka mandhari na zana kando ya wasilisho lako, hamisha kwa Marp, kisha kagua faili za PDF na SVG zilizotolewa. Mtiririko huu husaidia kuweka simulizi, michoro, na muundo wa kuona zikifanya kazi pamoja badala ya kuichukulia uboreshaji wa slaidi kama hatua ya mwisho ya ziada.