Kuongeza Kihariri Kitabu kwenye Tovuti Yangu Safi ya Blogu
Wasomaji wa kawaida watajua kuwa nimekuwa kwenye safari ya CMS kwa miaka mingi. WordPress, Grav, Jekyll, Kirby, kitu changu kidogo cha Hyde, na sasa Blogu Safi. Sitakuchosha na historia kamili tena, lakini toleo fupi ni: Niliendelea kukimbiza kiasi sahihi tu ya nguvu na unyenyekevu, na nadhani Blogu Safi inaweza kuwa hivyo.
Lakini kulikuwa na jambo moja la kukasirisha. Nina ukurasa wa vitabu ambao unaendeshwa na faili ya data ya YAML, ambayo huunda orodha inayoendeshwa ya kila kitu ambacho nimesoma pamoja na ukadiriaji, muhtasari, na maoni ya mara kwa mara. Ilifanya kazi vizuri, lakini kuihariri kulimaanisha kufungua faili ya YAML kwenye kihariri changu na kuwa mwangalifu sana ili usiharibu ujongezaji. Si bora.
Kwa hivyo niliamua kuunda UI ya msimamizi inayofaa kwake. Na kwa kufanya hivyo, nimethibitisha kuwa Blogu Safi ndiyo hasa kile nilitaka iwe – rahisi na inaweza kugunduliwa.
Mhariri wa kitabu
Nimeongeza mpya Vitabu kichupo kwa ukurasa wa maudhui ya msimamizi, na kujitolea edit-book.php ukurasa wa mhariri. Ina sehemu zote ninazohitaji – jina, mwandishi, aina, tarehe, kushuka kwa ukadiriaji wa nyota na URL ya Goodreads. Pia niliongeza wahariri wa CodeMirror kwa sehemu za muhtasari na maoni, kwa hivyo nina wema wote wanaotoa katika chapisho na wahariri wa ukurasa.
Jambo kuu ni kwamba hakuna hata moja ya hii iliyogusa msingi wa Blogu safi. Hakuna mstari mmoja.
Orodha yangu mpya ya vitabu katika Pure Blog
Kitabu kinahaririwa
Jinsi inavyofanya kazi kweli
Blogu Safi ina njia chache ambazo hufanya aina hii ya kitu kuwa safi kwa kushangaza:
content/functions.php inapakiwa kiotomatiki baada ya msingi, kwa hivyo utendakazi wowote maalum ninaofafanua unapatikana kila mahali – pamoja na kurasa za msimamizi. Ninaweka yangu save_books_yaml() kazi hapa, ambayo inachukua data ya vitabu na kuiandika tena kwa faili ya books.yml data, kisha kufuta akiba – kama vile kuhifadhi chapisho la kawaida hufanya. Tena, mabadiliko ya msingi ya sifuri.
config/update-ignore ni sehemu ya kutoroka kwa wakati mimi fanya haja ya kubatilisha faili ya msingi. Niliongeza zote mbili admin/content.php (ambapo niliongeza tabo ya Vitabu) na admin/edit-book.php (mhariri mpya) kwenye orodha ya kupuuza, ili masasisho yajayo ya Blogu Safi yasisumbue. Ni faili rahisi ya maandishi, njia moja kwa kila mstari. Bandika unachohitaji, ukipuuze, na uendelee.
content/includes/ ni pale inapopata SSG-ish kidogo. Ukurasa wa vitabu unaendeshwa na content/includes/books.php – faili ya PHP ambayo hupakia YAML, huipanga kwa tarehe iliyosomwa, na kutoa ukurasa mzima. Kimsingi ni kiolezo, si tofauti na mpangilio wa Kioevu au Nunjucks katika Jekyll au Eleventy. Wazo sawa kwa mlisho wa vitabu vya RSS.
Kutumia faili ya data ya YAML kwa vitabu kulikuwa na maana zaidi kwangu, badala ya kuweka alama kwenye faili kama vile chapisho au ukurasa, kwani zote ni metadata. Hakuna “maudhui” halisi kwa maingizo haya.
Weka vitu hivyo vitatu pamoja na una kitu kizuri sana. Kiolesura cha msimamizi kinachoweza kugeuzwa kukufaa, uwekaji salama wa msingi, na kurasa za data zinazoendeshwa na kiolezo – yote bila mfumo wa programu-jalizi au uchawi wowote wa kiunzi.
Umwagaji damu. Kipaji.
Kwa nini hii ni muhimu kwangu
Nilitumia miaka kutafuta CMS kamili, na sehemu kubwa ya kile nilichokuwa nikitafuta ilikuwa hii. Uwezo wa kujenga kile ninachohitaji bila kulazimika kupigana na jukwaa, au kuifunga, au bolt kwenye mzigo wa programu-jalizi.
Nikiwa na Kirby, ningeweza kufanya jambo la aina hii, lakini mkondo wa kujifunza ulikuwa mwinuko na mfumo wa ramani ulinichukua muda mrefu kuelekeza kichwa changu. Nikiwa na Jekyll/Hyde, nilikuwa na ubadilikaji wa SSG, lakini hakuna CMS ya mtandao ambayo ningeweza kuingia nayo na kuunda maudhui – nilihitaji kompyuta yangu ndogo. Blogu Safi inakaa katika hali nzuri ya kati – ina kiolesura sahihi cha msimamizi nje ya boksi, lakini hutoka njiani unapotaka kuirefusha.
Nimefurahishwa na jinsi mhariri wa kitabu alivyofanya. Ni jambo dogo, lakini ndivyo nilivyotaka, na ukweli kwamba yote yanaishi nje ya msingi inamaanisha ninaweza kusasisha Blogu safi bila kuwa na wasiwasi juu ya kupoteza yoyote yake.
Sasa, ikiwa utaniwia radhi, nina vitabu vya kuandika. 📚
Jibu kwa barua pepe
Jisajili kwa zaidi!
Sio lazima uendelee kurudi hapa ili kusoma waffle yangu ya hivi punde. Kuna njia kadhaa za kujiandikisha ili kupokea masasisho kila ninapochapisha maudhui mapya.
