Pretty website for ev3dev
This is the source repository for the web page at http://www.ev3dev.org. If you want to learn more about ev3dev in general, visit the site or check out our GitHub repo.
Feel free to fork and make a pull request! If you're looking for ways to contribute to our website, check out issues tagged "help wanted"; there are often tasks there which are well-suited to new contributors.
Previewing Locally
You can view your changes locally by installing Jekyll.
Installing Jekyll in Ubuntu 16.04
Install Ruby via apt-get
sudo apt-get install git ruby ruby-dev zlib1g-dev nodejs
sudo gem install bundler
Install Ruby via RVM (Ruby Version Manager)
If you use ruby for other things and don't want to mess up you system ruby
installation, you can install ruby via rvm
instead. Note that you must do the
'source' line when you open a new xterm or add it to ~/.bashrc
.
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash -s stable --ruby
source ~/.rvm/scripts/rvm
You will still need to run the following too...
sudo apt-get install git zlib1g-dev nodejs
sudo gem install bundler
Check Out Code and Run Jekyll
git clone git@github.com:<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 on Windows
First, 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
After you have previewed your changes locally, you can use a special Ruby script 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.rb <gh-user> --ssh
where <gh-user>
is your actual GitHub user name. If you do not have SSH set up, use ./publish.rb <gh-user>
. 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
.