Szegedi Tudományegyetem, Szoftverfejlesztés tanszék

Alapok

A Jekyll egy statikus weboldal generáló motor. GitHub Pages egy a GitHub-hoz kapcsolódó szolgáltatás, mely a GitHub projektekhez (Git repozitoriban) tárolt statikus weboldalakat szolgálja ki. A GitHub Pages közvetlenül támogatja a Jekyll-el készült oldalakat.

Témák

A Jekyll oldalak alapvető szerkezetét és bizonyos (főleg grafikus felülethez kapcsolódó) funkciókat a témák határozzák meg. Egy összetett témára példa az ezen oldalon is használt Minimal Mistakes.

Telepítés

Windows 10

Windows alatt a Ruby 2 főverziójú telepítésevel használható, bár a honlap ennél tágabb verzió tartományt ad meg. Ruby-val támogatott parancssor a Start menűből indítható.

start-menu-ruby-console

Futtatás

Saját gépen (Windows 10)

  1. Ruby parancssor indítása.
  2. Szerezzük be a projekt forráskódját (például, Git verziókövetőn keresztül).
  3. Navigáljunk el a Jekyll oldalunk gyökerébe, ahol a _config.yml található.
  4. Szükség estén telepítsük a hiányzó függőségeket bundler segítségével.
  5. Indítsuk el a Jekyll fejlesztői szervert a bundle exec jekyll serve vagy jekyll serve parancssal (némelyik rendszeren csak az utóbbi működik).
  6. Frissítsük az oldalt a böngészőnkben. Javasolt a ctrl + f5 használata, hogy felülbíráljuk a böngésző gyorsítótárát és a legfrissebb változatot kérjük le a szervertől.

A fejlesztői szerver alapértelmezésként nem figyeli a config fájl változásait. Ezért ennek módosítása esetén újra kell indítani.

Github Pages

A GitHub projekt beállításainál aktiválás után egyéb teendőnk nincsen a várakozáson kívül. A GitHub Pages legenerálja és a megfelelő címen elérhetővé teszi az oldalunkat. A folyamat akár percekbe is telhet. Frissítsük az oldalt a böngészőnkben. Javasolt a ctrl + f5 használata, hogy felülbíráljuk a böngésző gyorsítótárát és a legfrissebb változatot kérjük le a szervertől.