Üks raskusi, mida ma kogesin proovige mööda minna alates Worpressist kuni Jekyll fPean aru saama, milleks iga komponent oli mõeldud ja kuidas nad üksteisega suhtlesid. Leidsin lahenduse siis, kui lõpetasin oma ajaveebi loomise nullist ja hakkasin vastupidi töötama teema töötanud välja keegi teine. Avatud lähtekoodiga eelised.
Alustamiseks, eeldades, et olete installinud eelmistes artiklites kirjeldatud eeldused, ehitame oma saidi. Näide on aiandusblogi.
jekyll new blog_de_jardineria
Kausta minnes näete järgmist:
- Kaust nimega _postid.
- Kaks markdown laiendiga faili
- Veebileht.
- Konfiguratsioonifail laiendiga .yml, mida arutame pikemalt järgmises artiklis.
- Gemfile-fail, mis loetleb saidi komponendid ja muu samanimelise, kuid laiendiga .lock, mis välistab tahtmatute muudatuste tegemise.
Projekti ülesehitus
Nagu iga WordPressi põhine sait, Jekyll loob kausta struktuuri, kuhu kõik failid salvestatakse, ja teeb seda samadel põhjustel. Laske kasutajal faile korrektselt rühmitada ja projekti kasvades jääda hallatavaks.
Loome käsuga baaskausta jekyll new. Selle seest leiame kahte tüüpi kaustu; need, mis on seotud ajaveebi konfiguratsiooniga ja mis on identifitseeritud sidekriipsuga nime ees (meie puhul kaust _post ja need, millel on ressursse, mida loomisprotsessi osana ei kaasata. Näiteks need, mis sisaldavad pilte.
Sisupõhised kaustad
Selles rühmas se salvestab saidi külastajatele mõeldud sisu
_ postitus
Kaust _postitus sisaldab kõiki ajaveebikirjeid. Siin kasutatakse iga sellesse salvestatud faili jaoks väga konkreetset vormingut. Faili nimi peab olema vormingus date-failinimi - year-month-date-full_filename.md - ja see postitamise kuupäev kuvatakse kuupäevana, millal see Jekylli ajaveebipostitus tehti. Peame meeles pidama, et kuigi kaust kutsutakse _ postitust, siin on kogu sisu, mida blogilugejad näevad, näiteks kontaktivorm või autorite elulood. Hiljem näeme, et lehtedele on võimalik määrata erinevaid kujundusi.
_ mustandid
See on samaväärne WordPressi mustandi salvestamisega. Seda soovitatakse kasutada postituste jaoks, mis pole avaldamiseks valmis, kuigi neid saab kasutada ideede loendite, hiljem kasutatavate kujunduste jne salvestamiseks.
_hõlmab
Selles ruumis saame salvestada HTML-koodi, mida saab mitu korda uuesti kasutada. Näiteks meie puhul bänner, mis tervitab hooaja algust sõltuvalt poolkerast, kus kasutaja asub.
_skeemid
Nagu me eespool ütlesime, erinevad sisud võivad vajada erinevat paigutust. Näiteks video näitamiseks võime soovida, et leht oleks üks veerg, samas kui külalisautorina vajame veergu nende eluloo ja kontaktandmete kuvamiseks. Selles kaustas on erinevad kujundused, mida sait kasutab.
Teabekaustad
Need kaks kausta mida sait oma toimimiseks kasutab.
_andmed
Ühe inimese ajaveebis saab konfiguratsioonifail salvestada kõik vajalikud andmed. Kuid kui meil on paljude autoritega ajaveeb, on vaja teist viisi teabe haldamiseks. Kaust _andmed Seda kasutatakse andmete salvestamiseks JSON- või CSV-vormingutes, mida sait saab vastavalt kasutajate suhtlemisele hankida.
_kui sa
Kaust _kui sa Sait täiendab seda kogu eelmistes kaustades oleva teabega. Siit leiame saidi, mille laadime serverisse üles, et kasutajad saaksid sellele juurde pääseda. Muidugi, kuna see on HTML- ja css-kood, on võimalik selles muudatusi teha nagu igal teisel veebisaidil.
Järgmises artiklis hakkame konfiguratsioonifaili muutma.