Jedna z obtíží, kterou jsem zažil, když zkuste projít z Worpressu do Jekyll fMusím pochopit, k čemu každá komponenta byla a jak spolu interagovali. Našel jsem řešení, když jsem se přestal snažit vytvořit svůj blog od nuly a začal reverzní inženýrství téma vyvinutý někým jiným. Výhody open source.
Chcete-li začít, za předpokladu, že jste nainstalovali předpoklady, které jsme popsali v předchozích článcích, vytvoříme náš web. Příkladem je zahradnický blog.
jekyll new blog_de_jardineria
Pokud přejdete do složky, uvidíte následující:
- Složka s názvem _ příspěvky.
- Dva soubory s příponou markdown
- Webová stránka.
- Konfigurační soubor s příponou .yml, kterému se budeme podrobně věnovat v příštím článku.
- Soubor Gemfile, který uvádí součásti webu a další se stejným názvem, ale s příponou .lock, která zabraňuje neúmyslným úpravám.
Struktura projektu
Jako každý web založený na WordPress, Jekyll také vytváří strukturu složek, kde ukládá všechny soubory, a to ze stejných důvodů. Umožněte uživateli uspořádané seskupování souborů a s růstem projektu zůstaňte spravovatelní.
Pomocí příkazu vytvoříme základní složku jekyll new.
Uvnitř najdeme dva typy složek; ty, které souvisejí s konfigurací blogu a jsou označeny pomlčkou před jménem (v našem případě složka _post a ty, které mají prostředky, které nebudou zahrnuty jako součást procesu vytváření. Například ty, které obsahovat obrázky.
Složky založené na obsahu
V této skupiněe ukládá obsah určený pro návštěvníky stránek
_ pošta
Složka _pošta obsahuje všechny položky blogu. Zde se pro každý ze souborů, které jsou v něm uloženy, používá velmi specifický formát. Název souboru musí být ve formátu date-filename - year-month-date-full_filename.md - a toto datum zveřejnění se zobrazí jako datum vytvoření tohoto blogového příspěvku Jekyll. Musíme si uvědomit, že i když se složka volá _ příspěvky, zde je veškerý obsah, který čtenáři blogů uvidí, například kontaktní formulář nebo životopisy autorů. Později uvidíme, že je možné stránkám přiřadit různé vzory.
_pracovní verze
Je to ekvivalent ukládání konceptu WordPress. Jeho doporučené použití je pro příspěvky, které nejsou připraveny k publikování, i když je lze použít k ukládání seznamů nápadů, návrhů k pozdějšímu použití atd.
_zahrnuje
V tomto prostoru můžeme uložit html kód, který lze opakovaně použít několikrát. Například v našem případě banner, který pozdraví začátek sezóny v závislosti na polokouli, ve které se uživatel nachází.
_rozložení
Jak jsme řekli výše, různé části obsahu mohou vyžadovat různá rozvržení. Například pro zobrazení videa můžeme chtít, aby stránka byla jeden sloupec, zatímco pokud se jedná o hostujícího autora, potřebovali bychom sloupec, který by ukázal jejich biografii a kontaktní informace. V této složce jsou uloženy různé vzory, které bude web používat.
Informační složky
Tyto dvě složky jsou používány stránkou pro její provoz.
_data
V blogu s jednou osobou může konfigurační soubor ukládat všechna potřebná data. Pokud však máme blog s mnoha autory, je zapotřebí jiný způsob správy informací. Složka _data Používá se k ukládání dat ve formátech JSON nebo CSV, které web může načíst podle interakce s uživateli.
_jestli ty
Složka _jestli ty Stránka jej doplňuje o všechny informace dostupné v předchozích složkách. Zde najdeme web, který nahrajeme na server, aby k němu měli uživatelé přístup. Jelikož se jedná o html a css kód, je samozřejmě možné jej upravovat jako na jakémkoli jiném webu.
V dalším článku začneme upravovat konfigurační soubor.