En av de svårigheter jag upplevde när försök att klara från Worpress till Jekyll fJag måste förstå vad varje komponent var för och hur de interagerade med varandra. Jag hittade lösningen när jag slutade försöka skapa min blogg från grunden och började omvända ett tema utvecklad av någon annan. Fördelarna med öppen källkod.
För att komma igång, förutsatt att du har installerat de förutsättningar som vi beskrev i tidigare artiklar, kommer vi att bygga vår webbplats. Exemplet är en trädgårdsblogg.
jekyll new blog_de_jardineria
Om du går till mappen ser du följande:
- En mapp som heter _poster.
- Två filer med markdown-tillägg
- En webbsida.
- En konfigurationsfil med ett .yml-tillägg som vi kommer att diskutera utförligt i nästa artikel.
- En Gemfile-fil som listar komponenterna på webbplatsen och en annan med samma namn men med ett .lock-tillägg som förhindrar oavsiktliga ändringar.
Projektets struktur
Som alla WordPress-baserade webbplatser, Jekyll skapar också en mappstruktur där den lagrar alla filer, och det gör det av samma skäl. Låt användaren gruppera filer på ett ordnat sätt och, när projektet växer, förblir hanterbart.
Vi skapar basmappen med kommandot jekyll new. Inuti den hittar vi två typer av mappar; de som är relaterade till konfigurationen av bloggen som identifieras med bindestreck framför namnet (i vårt fall _post-mappen och de som har resurser som inte kommer att ingå som en del av skapandeprocessen. Till exempel de som innehålla bilder.
Innehållsbaserade mappar
I denna grupp se lagrar innehåll som är avsett för webbplatsbesökare
_ inlägg
Mappen _POST innehåller alla blogginlägg. Här används ett mycket specifikt format för var och en av filerna som sparas i den. Filnamnet måste ha formatet datum-filnamn - årsmånad-dat-full_filenam.md - och detta inläggsdatum visas som det datum detta Jekyll-blogginlägg gjordes. Vi måste komma ihåg att även om mappen heter _ inlägg, här är allt innehåll som bloggläsare kommer att se, till exempel kontaktformuläret eller författarnas biografier. Senare kommer vi att se att det är möjligt att tilldela sidorna olika mönster.
_utkast
Det motsvarar att spara WordPress-utkast. Den rekommenderade användningen är för inlägg som inte är redo att publiceras, även om de kan användas för att lagra idélistor, mönster som ska användas senare etc.
_ inkluderar
I detta utrymme kan vi lagra html-kod som kan återanvändas flera gånger. Till exempel i vårt fall en banner som hälsar början på en säsong beroende på den halvklot där användaren befinner sig.
_layouter
Som vi sa ovan, olika delar av innehållet kan behöva olika layouter. För att till exempel visa en video kanske vi vill att sidan ska vara en enda kolumn, medan om det är en gästförfattare skulle vi behöva en kolumn för att visa deras biografi och kontaktinformation. I den här mappen lagras de olika mönster som webbplatsen använder.
Informationsmappar
Dessa två mappar används av webbplatsen för dess drift.
_data
I en enmansblogg kan konfigurationsfilen lagra alla nödvändiga data. Men om vi har en blogg med många författare behövs ett annat sätt att hantera informationen. Mappen _data Den används för att lagra data i JSON- eller CSV-format som webbplatsen kan hämta enligt interaktionen med användarna.
_om du
Mappen _om du Webbplatsen kompletterar den med all information som finns i de tidigare mapparna. Här hittar vi webbplatsen som vi laddar upp till servern så att användarna kan komma åt dem. Naturligtvis, eftersom det är html och css-kod, är det möjligt att göra ändringar på det som alla andra webbplatser.
I nästa artikel kommer vi att börja ändra konfigurationsfilen.