Një nga vështirësitë që kam përjetuar kur mundohu të kalosh nga Worpress te Jekyll fDuhet të kuptoj se për çfarë shërbente secili përbërës dhe si ndërvepronin ata me njëri-tjetrin. Zgjidhjen e gjeta kur ndalova së provuari të krijoj blogun tim nga e para dhe fillova të bëj inxhinierin e kundërt një temë zhvilluar nga dikush tjetër. Përparësitë e burimit të hapur.
Për të filluar, duke supozuar se keni instaluar parakushtet që përshkruam në artikujt e mëparshëm, ne do të ndërtojmë faqen tonë. Shembulli është një blog kopshtarie.
jekyll new blog_de_jardineria
Nëse shkoni në dosje do të shihni sa vijon:
- Një dosje e quajtur _ postime.
- Dy skedarë me zgjatim të shënjimit
- Një faqe në internet.
- Një skedar konfigurimi me një shtrirje .yml që do ta diskutojmë gjatë në artikullin vijues.
- Një skedar Gemfile që rendit përbërësit e faqes dhe një tjetër me të njëjtin emër por me një shtrirje .lock që parandalon modifikimet e pavullnetshme.
Struktura e projektit
Si çdo faqe e bazuar në WordPress, Jekyll gjithashtu krijon një strukturë të dosjeve ku ruan të gjitha skedarët, dhe e bën këtë për të njëjtat arsye. Lejoni që përdoruesi të grupojë skedarët në një mënyrë të rregullt dhe, ndërsa projekti rritet, mbetet i menaxhueshëm.
Ne krijojmë dosjen bazë me komandën jekyll new. Brenda tij gjejmë dy lloje të dosjeve; ato që kanë të bëjnë me konfigurimin e blog-ut që identifikohen me vizë para emrit (në rastin tonë dosja _post dhe ato që kanë burime që nuk do të përfshihen si pjesë e procesit të krijimit. Për shembull, ato që përmbajnë imazhe.
Dosjet e bazuara në përmbajtje
Në këtë grup sruan përmbajtjen e destinuar për vizitorët e faqes
_ postim
Dosja _post përmban të gjitha shënimet në blog. Këtu përdoret një format shumë specifik për secilin prej skedarëve që janë ruajtur në të. Emri i skedarit duhet të jetë në formatin e datës-emri i skedarit - year-month-date-full_filename.md - dhe kjo datë e postimit do të shfaqet si data kur është bërë ky postim i blogut në Jekyll. Duhet të kemi parasysh që megjithëse dosja thirret _ postime, këtu është e gjithë përmbajtja që lexuesit e blog-ut do të shohin, për shembull forma e kontaktit ose biografitë e autorëve. Më vonë do të shohim se është e mundur të caktohet dizajne të ndryshme në faqe.
_shkrime
Shtë ekuivalente e ruajtjes së draftit WordPress. Përdorimi i rekomanduar i tij është për postimet që nuk janë gati për t'u botuar edhe pse ato mund të përdoren për të ruajtur listat e ideve, modelet për t'u përdorur më vonë, etj.
_përfshin
Në këtë hapësirë mund të ruajmë kodin html që mund të ripërdoret disa herë. Për shembull, në rastin tonë një banderolë që përshëndet fillimin e një sezoni në varësi të hemisferës në të cilën është përdoruesi.
_ndërprerjet
Siç thamë më lart, pjesë të ndryshme të përmbajtjes mund të kenë nevojë për paraqitje të ndryshme. Për shembull, për të treguar një video mund të dëshirojmë që faqja të jetë një kolonë e vetme, ndërsa nëse është një autor i ftuar do të na duhej një kolonë për të treguar biografinë e tyre dhe informacionin e kontaktit. Projektimet e ndryshme që faqja do të përdorë ruhen në këtë dosje.
Dosjet e informacionit
Këto dy dosje janë përdorur nga faqja për funksionimin e saj.
_te dhena
Në një blog me një njeri, skedari i konfigurimit mund të ruajë të gjitha të dhënat e nevojshme. Por, nëse kemi një blog me shumë autorë, nevojitet një mënyrë tjetër e menaxhimit të informacionit. Dosja _te dhena Përdoret për të ruajtur të dhëna në formatet JSON ose CSV që faqja mund t'i marrë në përputhje me bashkëveprimin me përdoruesit.
_nëse ti
Dosja _nëse ti Faqja e plotëson atë me të gjitha informacionet e disponueshme në dosjet e mëparshme. Këtu do të gjejmë faqen që do të ngarkojmë në server në mënyrë që përdoruesit të mund të kenë qasje. Sigurisht, meqenëse është kod html dhe css, është e mundur të bësh modifikime në të si çdo uebfaqe tjetër.
Në artikullin tjetër do të fillojmë të modifikojmë skedarin e konfigurimit.