Statische templates voor het Fri3d Camp 2018 programma
De templates worden gegenereerd met Jekyll. Bundler is nodig om de site te genereren.
Sinds El Capitan is /usr/bin niet meer schrijfbaar, waardoor je problemen ondervindt met het opzetten van Jekyll. Er zijn een aantal manieren om dat te omzeilen:
Installeer Ruby via homebrew:
$ brew install ruby
Vervolgens zal gem install jekyll bundler
werken zonder foutmelding.
Installeer de Jekyll gem in je user folder:
$ gem install jekyll bundler --user-install
- https://www.w3.org/TR/html5/ -- We verwachten een relatief moderne browser
- http://lesscss.org/ -- CSS pre-processor
- http://gulpjs.com/ -- Task runner
- https://www.npmjs.com/ -- Package manager
- http://jekyllrb.com/ -- Static site generator
Commando's te runnen in de root van de site (de dir waar deze readme staat)
Als je de ingebouwde server van jekyll wil gebruiken (en watchen voor changes):
$ bundle exec jekyll serve
Als je enkel de site wil builden (en watchen voor changes):
$ bundle exec jekyll build --watch
De site gebruikt LESS voor het genereren van de CSS.
De standaard LESS files van Fri3d worden telkens bij het parsen van LESS gekopieerd vanuit de Fri3d website. Deze moet dan wel relatief tov. deze dir staan in '../fri3d2018-announce/'.
Om een nieuwe minified style.css te genereren doe je:
$ gulp
Je zal merken dat dit ook het regenereren van de Jekyll site triggert.
Check http://localhost:5000 om je wijzigingen te valideren.
Wil je een niet-minified css genereren dan doe je
$ gulp dev
Wil je gulp dev
runnen telkens een .less file verandert, dan doe je
$ gulp stream