Yksi vaikeuksista, joita kokin kun yritä ohittaa Worpressistä Jekyll f: iinMinun on ymmärrettävä, mihin kukin komponentti oli tarkoitettu ja miten he olivat vuorovaikutuksessa toistensa kanssa. Löysin ratkaisun, kun lopetin blogini luomisen tyhjästä ja aloin kääntyä insinööriksi teema jonkun muun kehittämä. Avoimen lähdekoodin edut.
Aloitetaan, oletetaan, että olet asentanut edellisissä artikkeleissa esitetyt edellytykset, rakennetaan sivustomme. Esimerkki on puutarhanhoitoblogi.
jekyll new blog_de_jardineria
Jos siirryt kansioon, näet seuraavat:
- Kansio nimeltä _postit.
- Kaksi tiedostoa, joilla on merkintälaajennus
- Web-sivu.
- Kokoonpanotiedosto .yml-laajennuksella, josta keskustelemme pitkälti seuraavassa artikkelissa.
- Gemfile-tiedosto, jossa luetellaan sivuston komponentit ja toinen samanniminen, mutta .lock-laajennuksella, joka estää tahattomat muutokset.
Hankkeen rakenne
Kuten kaikki WordPress-pohjaiset sivustot, Jekyll luo myös kansiorakenteen, johon se tallentaa kaikki tiedostot, ja tekee sen samoista syistä. Anna käyttäjän ryhmitellä tiedostot järjestyksessä ja pysyä hallittavana projektin kasvaessa.
Luomme peruskansion komennolla jekyll new. Sen sisällä on kahden tyyppisiä kansioita; ne, jotka liittyvät blogin kokoonpanoon ja jotka on merkitty yhdysmerkillä nimen edessä (meidän tapauksessamme _post-kansio ja ne, joilla on resursseja, joita ei sisällytetä osana luomisprosessia. Esimerkiksi ne, jotka sisältää kuvia.
Sisältöpohjaiset kansiot
Tässä ryhmässä se tallentaa sivuston vierailijoille tarkoitettua sisältöä
_ viesti
Kansio _lähettää sisältää kaikki blogimerkinnät. Tässä käytetään hyvin erityistä muotoa kullekin siihen tallennetulle tiedostolle. Tiedostonimen on oltava muodossa date-filename - year-month-date-full_filename.md - ja tämä lähetyspäivä näytetään päivämääränä, jona tämä Jekyll-blogiviesti tehtiin. Meidän on pidettävä mielessä, että vaikka kansiota kutsutaan _ viestiä, tässä on kaikki sisältö, jonka blogin lukijat näkevät, esimerkiksi yhteydenottolomake tai kirjoittajien elämäkerrat. Myöhemmin näemme, että sivuille on mahdollista määrittää erilaisia malleja.
_luonnokset
Se vastaa WordPress-luonnoksen tallentamista. Sen suositeltava käyttö on viesteille, jotka eivät ole valmiita julkaisemiseen, vaikka niitä voidaan käyttää ideoluetteloiden, myöhemmin käytettävien mallien jne. Tallentamiseen.
_ sisältää
Tähän tilaan voimme tallentaa html-koodin, jota voidaan käyttää useita kertoja. Esimerkiksi meidän tapauksessamme banneri, joka tervehtii kauden alkua sen pallonpuoliskon mukaan, jossa käyttäjä on.
_asettelut
Kuten sanoimme edellä, erilaiset sisältöosat saattavat tarvita erilaisia asetteluja. Esimerkiksi videon näyttämiseksi saatamme haluta sivun olevan yksi sarake, kun taas vieraskirjailija tarvitsemme sarakkeen näyttämään heidän elämäkerransa ja yhteystietonsa. Eri mallit, joita sivusto käyttää, tallennetaan tähän kansioon.
Tietokansiot
Nämä kaksi kansiota joita sivusto käyttää toimintaansa.
_tiedot
Yhden miehen blogissa määritystiedosto voi tallentaa kaikki tarvittavat tiedot. Mutta jos meillä on blogi, jossa on monia kirjoittajia, tarvitaan toinen tapa hallita tietoja. Kansio _tiedot Sitä käytetään tietojen tallentamiseen JSON- tai CSV-muodoissa, jotka sivusto voi noutaa käyttäjien vuorovaikutuksen mukaan.
_jos sinä
Kansio _jos sinä Sivusto täydentää sitä kaikilla edellisissä kansioissa käytettävissä olevilla tiedoilla. Täältä löydät sivuston, jonka lähetämme palvelimelle, jotta käyttäjät voivat käyttää sitä. Koska se on html- ja css-koodi, on tietysti mahdollista tehdä siihen muutoksia kuten muillakin verkkosivustoilla.
Seuraavassa artikkelissa aloitamme kokoonpanotiedoston muokkaamisen.