7bao / ev3dev.github.io

pretty web page for ev3dev

Pretty website for ev3dev

This is the web page at http://www.ev3dev.org and also http://ev3dev.github.io.

Feel free to fork and make a pull request.

You can view your changes locally by installing jekyll.

Installing Jekyll in Ubuntu 14.04

Install Ruby via apt-get

sudo apt-get install git ruby2.0 ruby2.0-dev nodejs
sudo gem install bundler

Install Ruby via RVM (Ruby Version Manager)

If you hit any snags with apt another option is to install via RVM. Note that you must do the 'source' line when you open a new xterm.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash -s stable --ruby
source ~/.rvm/scripts/rvm

Checkout Code and Run Jekyll

git clone [email protected]:<user>/ev3dev.github.io
cd ev3dev.github.io
bundle install
bundle exec jekyll serve --safe --incremental &
www-browser http://localhost:4000 &
# work, work, work

Installing Jekyll in Windows

• Follow the instructions in step 1 here (Installing Ruby and the Ruby DevKit).

Then run:

gem install bundler
git clone https://github.com/<user>/ev3dev.github.io
cd ev3dev.github.io
bundle install
bundle exec jekyll serve --safe --incremental

Now you should be able to visit your page at: http://localhost:4000. It should auto-update when you change the source files, so all you have to do is refresh your browser.

Previewing Your Changes Online

We have a special script to use to publish your changes using the gh-pages branch of your fork of ev3dev.github.io. If you have SSH setup for your GitHub account, simply run./publish <gh-user> where <gh-user> is your actual GitHub user name. This will copy the contents of _site, fix it up a bit and push it to your fork on GitHub. You can view the results at http://<gh-user>.github.io/ev3dev.github.io.