Start a github pages website powered by Jekyll using Foundation/SCSS in under 5 minutes!
Ever wanted a simple but nice looking responsive website as your project page or page for your repo? Are you in a hackathon needing to put up a working website in minutes? I do. Here is what I do, and I am sharing for you to use it, free. Free as in free speech AND free beer.
You can see the working example site here
settings
rename the repo to username.github.io
naming scheme. (For this you need to use master
branch)gh-pages
branch, i.e. git checkout -b gh-pages
git push --set-upstream origin gh-pages
_config.yml
_layouts/default.html
is the base)gulp
(Try editing scss/_stettings.scss
)_include/nav.html
Use at your own risk, and follow license restriction of each products used. Most are MIT (OK to use commercially).
If you don't have it, install node.js. Easiest way it to use Homebrew by
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
then
brew install node
and install npm and gulp globally by running
sudo npm install npm bower gulp -g
Run gulp to compile css from sass by simply run gulp
or npm start
from your terminal within your repo.
It will launch watch by default. control-c
to stop. If you only want the css compiled once, run gulp sass
To run jekyll locally to test your website while developing, run bundle install
then bundle exec jekyll serve --watch
(Requires ruby *) Your website should be viewable by going to localhost:4000
Github's doc on how to use Jekyll on Github Pages is also helpful.
brew install ruby
and sudo gem install bundler
. Mac OS X 10.11 nokogiri troubleYou can update to the latest foundation by running bower update foundation-sites --save
. Ping me and I will update this repo. Any questions, make an issue or ask on twitter @DaigoFuji