Jekyll¶

Jekkyl open source nástroj určený pro generování statických webových stránek založený v roce 2008 zakladateli GitHubu. Výsledný vygenerovaný web nemá žádný backend – v pozadí neběží žádné PHP, Java EE apod. Samotný generátor je napsaný v programovacím jazyce Ruby a renderuje markdown (odlehčený značkovací jazyk) a HTML (Hypertext Markup Language) do HTML. Stále patří společnosti GitHub a používají ho pro svou službu Github Pages. Hlavní využití má pro vývojáře k dokumentaci softwaru. Dále je využitelný pro osobní blogy a v jistých případech může být použit místo wiki.

Případy užití¶

GitHub Pages¶

Nejjednodušším způsobem je použití Jekkylu v rámci GitHubu. Zde webové stránky ukazují autorovo portfolio nebo slouží jako dokumentace k softwaru. Není potřeba vlastnit žádnou doménu ani mít zřízený hosting, kde by staticky vygenerovaný web běžel. Stačí založit novou branch vedle naší master branch a začít web používat. Níže podrobnější návod.

Instalace¶

1. Vytvoření repozitáře – po přihlášení se na stránkách GitHubu je potřeba vytvořit nový repozitář, jehož název bude shodný s naším uživatelským nebo jménem organizace. V případě špatného zadání nebude nově založený repozitář fungovat.
2. Klonování repozitáře – po úspěšném založení nového repozitáře ho naklonujeme do námi definovaného lokálního uložiště.
   
3. Vytvoření inicializačního souboru – vstoupíme do složky s projektem a vytvoříme soubor index.html.
   
4. Nahrání souboru index.html – soubor index.html je nutné v rámci adresářové struktury přidat do gitu a provést commit následovaný pushem. Do souboru je dobré vložit nějaký text, abychom si ověřili funkčnost služby Github Pages. Následně již můžeme nahrát soubory nutné pro funkčnost Jekkylu, resp. pro jeho generování na statický obsah.
   

Po instalaci můžeme vkládat nové stránky nebo příspěvky. Měnit můžeme vzhled za pomocí předdefinovaných šablon nebo pomocí CSS (Cascading Style Sheets). Po každé provedené úpravě na webu, resp. commitu je potřebovat vygenerovat nový statický obsah. Dle konfigurace repozitáře GitHub generování provádí automaticky nebo jej můžeme provádět manuálně.

Klasický web (blog)¶

Pro klasické blogování s Jekkylem je nutné vlastnit domému a hosting. Na hostujícím serveru je potřeba jen webový server (Apache, NGINX) – na hostingu je umístěn jen statický obsah, takže není potřeba databáze ani např. PHP (Hypertext Preprocessor) server. Nástroj Jekkyl je nainstalováný na lokálním počítači včetně všech závislostí. Počítač generuje statický obsah, který je následně nahrán na hosting.

Instalace¶

1. Instalace závislostí – je potřeba nainstalovat Ruby, protože je v něm Jekkyl napsaný. Dále je potřeba nainstalovat knihovny gcc, gcc-c++ a zlib-devel, protože některé závislosti z Ruby se nestahují, ale kompilují.
2. Instalace Jekkylu – necháme nainstalovat Jekkyl a po instalaci Jekkylu jej necháme vygenerovat výchozí blog.