Isa sa mga paghihirap na naranasan ko noong subukan mong pumasa mula sa Worpress hanggang Jekyll fDapat kong maunawaan kung para saan ang bawat sangkap at kung paano sila nakikipag-ugnayan sa bawat isa. Natagpuan ko ang solusyon nang tumigil ako sa pagsubok na likhain ang aking blog mula sa simula at nagsimulang balikan ang engineer isang tema binuo ng iba. Ang mga pakinabang ng open source.
Upang makapagsimula, ipagpalagay na na-install mo ang mga paunang kinakailangan na nailahad namin sa mga nakaraang artikulo, itatayo namin ang aming site. Ang halimbawa ay isang blog sa paghahalaman.
jekyll new blog_de_jardineria
Kung pupunta ka sa folder makikita mo ang sumusunod:
- Tinawag ang isang folder _post.
- Dalawang mga file na may extension na markdown
- Isang pahina sa Web.
- Isang file ng pagsasaayos na may isang extension na .yml na tatalakayin namin nang malawakan sa susunod na artikulo.
- Isang file na Gemfile na naglilista ng mga bahagi ng site at isa pa ng parehong pangalan ngunit may isang .lock extension na pumipigil sa hindi sinasadyang mga pagbabago.
Ang istraktura ng proyekto
Tulad ng anumang site na nakabatay sa WordPress, Lumilikha din ang Jekyll ng isang istraktura ng folder kung saan iniimbak nito ang lahat ng mga file, at ginagawa ito para sa parehong mga kadahilanan. Pahintulutan ang gumagamit na i-grupo ang mga file sa isang maayos na pamamaraan at, habang lumalaki ang proyekto, mananatiling mapapamahalaan.
Lumilikha kami ng base folder na may utos jekyll new. Sa loob nito nakita natin ang dalawang uri ng mga folder; ang mga nauugnay sa pagsasaayos ng blog na nakilala na may isang dash sa harap ng pangalan (sa aming kaso ang _post folder at ang mga may mga mapagkukunan na hindi isasama bilang bahagi ng proseso ng paglikha. Halimbawa, ang mga naglalaman ng mga imahe.
Mga folder na batay sa nilalaman
Sa pangkat na ito snag-iimbak ng nilalamang inilaan para sa mga bisita sa site
_post
Ang folder _post naglalaman ng lahat ng mga entry sa blog. Narito ang isang napaka-tukoy na format ay ginagamit para sa bawat isa sa mga file na nai-save dito. Ang pangalan ng file ay dapat nasa format ng date-filename - year-month-date-full_filename.md - at ang petsa ng pag-post na ito ay ipapakita bilang petsa kung kailan ginawa ang post sa blog na Jekyll na ito. Dapat nating tandaan na bagaman ang folder ay tinawag _ mga post, narito ang lahat ng nilalaman na makikita ng mga mambabasa ng blog, halimbawa ang form sa pakikipag-ugnay o ang talambuhay ng mga may-akda. Mamaya makikita natin na posible na magtalaga ng iba't ibang mga disenyo sa mga pahina.
_mga draft
Ito ay katumbas ng pag-save ng WordPress draft. Ang inirekumendang paggamit nito ay para sa mga post na hindi handa na mai-publish kahit na maaari silang magamit upang mag-imbak ng mga listahan ng mga ideya, disenyo na gagamitin sa paglaon, atbp.
_sasama
Sa puwang na ito maaari nating iimbak ang html code na maaaring magamit ulit ng maraming beses. Halimbawa, sa aming kaso ang isang banner na bumabati sa pagsisimula ng isang panahon depende sa hemisphere kung saan naroon ang gumagamit.
_playout
Tulad ng sinabi namin sa itaas, ang iba't ibang mga bahagi ng nilalaman ay maaaring mangailangan ng iba't ibang mga layout. Halimbawa, upang maipakita ang isang video baka gusto naming ang pahina ay maging isang solong haligi, habang kung ito ay isang may-akdang panauhin kailangan namin ng isang haligi upang maipakita ang kanilang talambuhay at impormasyon sa pakikipag-ugnay. Ang iba't ibang mga disenyo na gagamitin ng site ay nakaimbak sa folder na ito.
Mga folder ng impormasyon
Ang dalawang folder na ito ay ginagamit ng site para sa pagpapatakbo nito.
_data
Sa isang isang tao na blog, maaaring maiimbak ng file ng pagsasaayos ang lahat ng kinakailangang data. Ngunit, kung mayroon kaming isang blog na may maraming mga may-akda, kailangan ng isa pang paraan ng pamamahala ng impormasyon. Ang folder _data Ginagamit ito upang mag-imbak ng data sa mga format na JSON o CSV na maaaring makuha ng site ayon sa pakikipag-ugnay sa mga gumagamit.
_kung ikaw
Ang folder _kung ikaw Kinumpleto ito ng site sa lahat ng impormasyong magagamit sa mga nakaraang folder. Mahahanap namin dito ang site na ia-upload namin sa server upang ma-access ng mga gumagamit. Siyempre, dahil ito ay html at css code, posible na gumawa ng mga pagbabago dito tulad ng anumang iba pang website.
Sa susunod na artikulo magsisimula kaming baguhin ang config file.