Yakha Amaslayidi Angcono Ezethulo ze-Marp nge-minorun-marp-skill

Okwenziwa yi-minorun-marp-skill

minorun-marp-skill iqoqo lemihlahlandlela engasetshenziswa kabusha namathuluzi okuhlola okwakha amaslayidi ezethulo nge-Marp. Yenzelwe ukusiza ama-agent e-AI ukuthi abhale amaslayidi angahlanzekile ngokubukeka kuphela, kodwa abe nendaba ecacile, imidwebo ewusizo, kanye nomklamo olinganiselayo.

Le phrojekthi iqoqa ukuthuthukiswa kwezethulo okusetshenziswa kaningi ngumbhali wayo, u-Minoru Onda, ikupakishe njengamakhono angafundwa ama-agent e-AI afana ne-Claude Code. Lezi zinto zingasetshenziswa futhi ngqo abantu abazibhalela i-Mar​​p Markdown.

Isakhiwo Sendawo Yokugcina

Indawo yokugcina ihlukanisa imihlahlandlela yokubhala, umklamo obukwayo, amatimu, amathuluzi okuqinisekisa, nezibonelo:

• skills/slide-story ihlanganisa iziqalisi ezidonsa ukunaka, amaslayidi avula izigaba, ukwethula ulwazi kancane kancane, isitayela sezihloko, iziphetho, kanye nokulinganisa ubude besethulo.
• skills/slide-figures ichaza indlela yokunciphisa ukuminyana kolwazi emidwebeni, ukudweba izibalo ze-SVG, ukusetha osayizi bombhalo abancane, nokubeka imifanekiso.
• skills/slide-design-dark ihlanganisa ukukala isikhala esingenalutho, ibhalansi eqondile, izizinda ezimnyama, amathebula, amabhulokhi ekhodi, kanye nezinkinga eziqondene ne-Marp.
• theme/minorun-dark.css inikeza itimu ye-Marp emnyama enezimpawu zombala we-cyan.
• tools/ iqukethe imibhalo ekala okukhiphayo kwe-PDF ne-SVG okuthunyelwe.
• examples/sample iqukethe isethi yamadekhi eyisibonelo, kanti examples/broken iqukethe ngamabomu izinkinga ukuze uqinisekise ukuthi ukuhlola kuyazibona.

Ukufaka Nokulungiselela

Kopisha Amakhono e-Claude Code

Uma usebenzisa i-Claude Code, kopisha izinkomba zamakhono ezintathu uzifake enkombeni yakho yomuntu siqu yamakhono e-Claude:

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

Ngemva kwalokhu, i-Claude Code ingasebenzisa imihlahlandlela ye-slide-story, slide-figures, ne-slide-design-dark yendawo yokugcina lapho ikusiza ukudala noma ukubuyekeza amaslayidi.

Kopisha Itimu Namathuluzi Endaweni Yakho Yamaslayidi

Kopisha izinkomba ze-theme/ ne-tools/ uzifake endaweni yokugcina equkethe isethi yamadekhi akho. Lokhu kugcina itimu nemibhalo yokuqinisekisa eduze kwe-Markdown namafa asetshenziselwa isethulo.

Faka Amathuluzi Adingekayo

Imibhalo yokuhlola incike ku-Marp CLI, Google Chrome, poppler, mupdf-tools, Python 3, ne-Pillow. Faka i-Marp CLI usebenzisa:

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

Ku-macOS, faka izinsiza ze-PDF usebenzisa:

brew install poppler mupdf-tools

check-svg-box-fit.mjs isebenzisa i-puppeteer-core efakwe ne-Marp CLI. Uma amamojula ayo noma ifayela elisebenzisekayo le-Chrome lingatholakali ngokuzenzakalelayo, nikeza izindawo zawo nge-MARP_NODE_MODULES ne-CHROME_PATH.

Lungisa Amafonti

Itimu yenzelwe amafonti e-Gothic ayindilinga. Ukufaka i-Zen Maru Gothic kunikeza ukubukeka okuncanyelwayo. Ezinhlelweni ze-macOS lapho ingatholakali khona, itimu ibonakala nge-Hiragino Maru Gothic. Ukutholakala kwefonti kungashintsha ukubukeka kwesethi yamadekhi yokugcina, ngakho faka futhi uqinisekise ifonti ngaphambi kokuthumela amaslayidi.

Dala Futhi Uthumele Isethi Yamadekhi

Bhala amaslayidi akho efayeleni le-Mar​​p Markdown elifana ne-deck.md. Lithumele ku-PDF ngetimu emnyama efakiwe nokusekelwa kwamafayela asendaweni:

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

Inketho ye---theme isebenzisa umklamo omnyama wendawo yokugcina onezimpawu zombala we-cyan. Inketho ye---allow-local-files ivumela izithombe zasendaweni namanye amafa abhekiswe kuwo yisethi yamadekhi ukuthi alayishwe ngesikhathi sokuthumela.

Qinisekisa Amaslayidi Athunyelwe

Ngemva kokuthumela, sebenzisa ukuhlola ku-PDF ekhiqiziwe nakunoma yiziphi izibalo ze-SVG. Lokhu kuhlola kuhloselwe ukubamba izinkinga okungelula ukuzibona emthonjeni we-Markdown kodwa ezisobala esethulweni esihunyushiwe.

Hlola Amamajini

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

Lokhu kuhlola kukala isikhala esingenalutho emaphethelweni angezansi nangakwesokudla okuqukethwe kweslayidi.

Hlola Izikhala Phakathi Kwezinto

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

Sebenzisa lokhu kuhlola ukuthola imidwebo noma amabhokisi asondele kakhulu embhalweni oseduze.

Hlola Umbhalo Ongaphakathi Kwezibalo

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

Lokhu kuhlola kubheka umbhalo omncane ongaphakathi kwezibalo kanye nombhalo ominyene eduze kwemiphetho yamabhokisi.

Hlola Ukulingana Kwebhokisi le-SVG

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

Lokhu kuhlola kuqinisekisa ukuthi umbhalo ongaphakathi kwamabhokisi e-SVG ulingana nalawo mabhokisi. Kuwusizo kakhulu lapho izibalo zikhiqizwa noma zihlelwa ngokuhlukile kwi-Markdown yeslayidi.

Hlola Amaslayidi Aphinde Asetshenziswe

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

Qalisa lokhu kuqhathanisa lapho uphinda usebenzisa amaslayidi. Kuhlola ubudlelwano phakathi kwezihloko nezibalo kumafayela e-Markdown amasha namadala, kukusize uqaphele lapho okuqukethwe okubukwayo okuphinde kwasetshenziswa kungasahambisani nomyalezo ozungezile.

Faka Imifanekiso

Isethulo esiyisibonelo sivame ukusebenzisa imifanekiso evela ku-Irasutoya, kodwa lezo zithombe azifakiwe endaweni yokugcina. Zilande ngaphambi kokuthumela isethi yamadekhi eyisibonelo:

sh examples/sample/fetch-illustrations.sh

Zihlolele wena izimo zokusetshenziswa ezifanele ngaphambi kokusebenzisa noma yimuphi umfanekiso olandiwe. Imifanekiso eboniswe ekubukezweni kwesethi yamadekhi eyisibonelo iyimisebenzi enamalungelo obunikazi ka-Irasutoya futhi ayimboziwe yi-Apache License 2.0 yale ndawo yokugcina.

Indlela Esebenzayo Esekelwa Yi-AI

1. Qala ngendaba. Cela i-ejenti ye-AI ukuthi isebenzise iziqondiso ze-slide-story ukuchaza isiqalo esihehayo, ukuguquka kwezigaba, ukwethulwa kwemibono kancane kancane, isitayela sezihloko, isiphetho, nesikhathi esilinganisiwe sokwethula.
2. Hlela izibalo nezithombe. Sebenzisa i-slide-figures ukunciphisa umdwebo ngamunye ube olwazini oludingwa izethameli kuphela, ukhethe osayizi bombhalo abafundeka kalula, futhi unqume ukuthi i-SVG noma umfanekiso ofanele yini.
3. Sebenzisa uhlelo olubonakalayo. Sebenzisa i-slide-design-dark ne-minorun-dark.css ukuze kugcinwe isikhala esimhlophe, ibhalansi eqondile, umehluko wombhalo ongemuva omnyama, nesitayela esifanayo samathebula nekhodi.
4. Thumela ngaphandle kusenesikhathi. Dala i-PDF nge-Marp esikhundleni sokuthembela kuphela emthonjeni we-Markdown noma ekubukeni kuqala komhleli.
5. Hlola umphumela. Sebenzisa ukuhlolwa kwe-PDF ne-SVG, bese ubuyekeza amaslayidi ngokusekelwe ezinkingeni zangempela zokuboniswa, njengamalebula emidwebo aminyene, isikhala esinganele, noma ukusetshenziswa ngokweqile kwemiphetho.
6. Buyekeza inkulumo iyonke. Qinisekisa ukuthi idekhi inokuqhubeka okuhambisanayo nokuthi umdwebo ngamunye usekela isihloko seslayidi sawo, kunokuba ube umhlobiso nje.

Amathiphu Athuthukile

Sebenzisa Isibonelo Esinezinkinga Njengokuhlolwa Kokubuyela Emuva

Ifolda ye-examples/broken iqukethe ngamabomu idekhi enezinkinga. Yisebenzise ukuqinisekisa ukuthi imibhalo yokuhlola ifakwe kahle nokuthi isabela ezinhlotsheni zezinkinga zesakhiwo eyadalelwa ukuzithola.

Qinisekisa Ama-PDF, Hhayi Umthombo We-Markdown Kuphela

Ukuboniswa kwe-Marp kungaveza izinkinga ezingabonakali kukhodi yomthombo, okuhlanganisa izinguquko ezibangelwa ukutholakala kwamafonti, usayizi wamabhokisi, amafa asendaweni, nesakhiwo sokugcina sekhasi. Thatha i-PDF ethunyelwe ngaphandle njengento okufanele ihlolwe.

Gcina Umbhalo Wemidwebo Ufunda Kalula

Uma umdwebo uqukethe ulwazi oluningi, qala ngokususa noma ukuhlehlisa imininingwane kunokunciphisa umbhalo. Iziqondiso zemidwebo ne-check-figure-text.py kusebenza ndawonye ukugcina imidwebo ifundeka ngesikhathi sokwethula bukhoma.

Gcina Izihloko Nemidwebo Kuhambisana

Uma uphinde usebenzisa islayidi sangaphambilini, buyekeza kokubili isihloko saso nencazelo ebonakalayo. Ukuhlolwa kwe-reuse-diff kusiza ukuthola izimo lapho umdwebo omdala usasele khona kodwa umyalezo weslayidi usushintshile.

Khumbula Imikhawulo Yamalayisense

Indawo yokugcina ikhishwa ngaphansi kwe-Apache License 2.0, kanti ilungelo lobunikazi linikezwe uMinoru Onda. Amafonti nemifanekiso yangaphandle kungaba nemigomo ehlukile, ngakho qinisekisa amalayisense awo ngokuzimela ngaphambi kokusabalalisa idekhi.

Isiphetho

minorun-marp-skill iguqula izeluleko zokwethula ze-Marp zibe amakhono angasetshenziswa kabusha ama-ejenti e-AI, itimu emnyama, izibonelo, nokuhlolwa okuqondile komphumela. Kopisha amakhono ku-Claude Code, beka itimu namathuluzi eduze kwedekhi yakho, thumela ngaphandle nge-Marp, bese uhlola amafayela e-PDF ne-SVG abonisiwe. Le ndlela isiza ukugcina indaba, imidwebo, nomklamo obonakalayo kusebenza ndawonye esikhundleni sokuphatha ukupholishwa kweslayidi njengomsebenzi wokugcina owengezwa kamuva.