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.