Vienas iš sunkumų, kurį patyriau, kai pabandyk praeiti nuo Worpresso iki Jekyll fTuriu suprasti, kam kiekvienas komponentas buvo skirtas ir kaip jie sąveikauja. Sprendimą radau, kai nustojau kurti savo tinklaraštį nuo nulio ir pradėjau kurti inžinierių tema sukūrė kažkas kitas. Atvirojo kodo privalumai.
Jei norite pradėti, manydami, kad įdiegėte prielaidas, kurias apibūdinome ankstesniuose straipsniuose, sukursime savo svetainę. Pavyzdys yra sodininkystės tinklaraštis.
jekyll new blog_de_jardineria
Jei eisite į aplanką, pamatysite:
- Aplankas vadinamas _postai.
- Du failai su žymėjimo plėtiniu
- Tinklalapis.
- Konfigūracijos failas su plėtiniu .yml, kurį plačiai aptarsime kitame straipsnyje.
- „Gemfile“ failas, kuriame išvardyti svetainės komponentai ir kitas tas pats pavadinimas, bet su .lock plėtiniu, kuris apsaugo nuo netyčinių pakeitimų.
Projekto struktūra
Kaip ir bet kuri „WordPress“ svetainė, „Jekyll“ taip pat sukuria aplankų struktūrą, kurioje saugomi visi failai, ir tai daro dėl tų pačių priežasčių. Leiskite vartotojui tvarkingai sugrupuoti failus ir, kai projektas auga, jis bus valdomas.
Su komanda sukuriame pagrindinį aplanką jekyll new. Jo viduje randame dviejų tipų aplankus; tuos, kurie yra susiję su tinklaraščio konfigūracija, kurie identifikuojami brūkšneliu prieš pavadinimą (mūsų atveju aplankas _post ir tuos, kurie turi išteklių, kurie nebus įtraukti į kūrimo procesą. Pavyzdžiui, tuos, kurie yra vaizdų.
Turinio aplankai
Šioje grupėje se saugo svetainės lankytojams skirtą turinį
_ pranešimas
Aplankas _post yra visi tinklaraščio įrašai. Čia kiekvienam iš jame išsaugotų failų naudojamas labai specifinis formatas. Failo pavadinimas turi būti tokio formato kaip data-failo vardas - metai- mėnuo- data- pilnas_filename.md - ir ši paskelbimo data bus rodoma kaip šio „Jekyll“ tinklaraščio įrašo data. Turime nepamiršti, kad nors aplankas yra vadinamas _ pranešimai, čia yra visas turinys, kurį matys tinklaraščio skaitytojai, pavyzdžiui, kontaktinė forma arba autorių biografijos. Vėliau pamatysime, kad puslapiams galima priskirti skirtingus dizainus.
_ juodraščiai
Tai yra „WordPress“ juodraščio išsaugojimo atitikmuo. Rekomenduojama naudoti įrašams, kurie nėra pasirengę paskelbti, nors juos galima naudoti idėjų sąrašams, vėliau naudojamiems dizainams ir pan. Saugoti.
_apima
Šioje vietoje galime išsaugoti HTML kodą, kurį galima pakartotinai naudoti kelis kartus. Pavyzdžiui, mūsų atveju reklamjuostė, kuri pasitinka sezono pradžią, atsižvelgiant į pusrutulį, kuriame yra vartotojas.
_dėstymai
Kaip minėjome aukščiau, skirtingoms turinio dalims gali reikėti skirtingų išdėstymų. Pavyzdžiui, norėdami parodyti vaizdo įrašą, norime, kad puslapis būtų vienas stulpelis, o jei tai yra svečias autorius, mums reikia stulpelio, kuriame būtų rodoma jų biografija ir kontaktinė informacija. Įvairūs dizainai, kuriuos naudos svetainė, saugomi šiame aplanke.
Informacijos aplankai
Šie du aplankai yra naudojami svetainėje savo veiklai.
_duomenys
Vieno žmogaus tinklaraštyje konfigūracijos faile gali būti saugomi visi reikalingi duomenys. Bet jei turime tinklaraštį su daugeliu autorių, reikalingas kitas informacijos tvarkymo būdas. Aplankas _duomenys Jis naudojamas duomenims JSON arba CSV formatu saugoti, kuriuos svetainė gali gauti pagal sąveiką su vartotojais.
_jei tu
Aplankas _jei tu Svetainėje pateikiama visa informacija, esanti ankstesniuose aplankuose. Čia rasime svetainę, kurią įkelsime į serverį, kad vartotojai galėtų pasiekti. Žinoma, kadangi tai yra html ir css kodas, jį galima modifikuoti kaip ir bet kurią kitą svetainę.
Kitame straipsnyje mes pradėsime keisti konfigūracijos failą.