fri3d2018-announce

Announcement page of Fri3d Camp 2018

Howto

De site wordt gemaakt met GitHub Pages / Jekyll. Bundler is nodig om de site te genereren. Zie https://help.github.com/articles/using-jekyll-with-pages voor help ivm het opzetten van je werkomgeving.

MacOS

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

Gebruikte Tools

• 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

Meewerken aan de site...

Fork, edit en bezorg ons een "pull request".

Minimale instructies om te overleven:

$ git clone https://github.com/Fri3dCamp/fri3d2018-announce
$ cd fri3d2018-announce
$ git checkout gh-pages
$ npm install
$ bundle update

Als je de ingebouwde server van jekyll wil gebruiken (en watchen voor changes):

$ bundle exec jekyll serve

Als je enkel de site will builden (en watchen voor changes):

$ bundle exec jekyll build --watch

LESS

De site gebruikt LESS voor het genereren van de CSS. 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.

De site is beschikbaar op poort 5000, omdat dit zo geconfigureerd staat in _config.yml. Dit poortnummer kan aangepast worden, om conflicten met andere locale sites te vermijden (dan moet de Jekyll server wel gestopt en herstart worden)

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