Jekyll¶

Jekkyl je generátor 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).