bkmgit / nairuby.org Goto Github PK

The Nairobi Ruby Brigade or nairuby or nai.rb, is a User group for Ruby programmers based in Nairobi, Kenya. We would like to welcome all programmers that are interested in the Ruby language, tools, libraries and frameworks.

We have been meeting since August 2011 for presentations, demos and discussions applicable across various skill levels from beginner to advanced.

This repository contains the source code for our website nairuby.org and is powered by Jekyll, a static site generator.

Assuming that you have Ruby installed on your machine, follow the instructions below:

# Install Jekyll
gem install jekyll

# Clone the repository using git (see for git installation)
git clone [email protected]:nairuby/nairuby.github.io.git

# Change the directory to nairuby.github.io
cd nairuby.github.io

# bundle the app
bundle install

# Run a local copy of the website
jekyll serve --watch --safe --trace

# Point your web browser to localhost
http://localhost:4000

To run Jekyll such that you match the GitHub Pages build server (useful for debugging), run Jekyll with Bundler. All this does is run Jekyll with the dependencies specified in the Gemfile.

bundle exec jekyll serve --watch --safe --trace

The first test checks if Jekyll is able to build our site successfully by running jekyll build. The second test involves running HTML::Proofer which is a set of tests to validate our HTML output. These tests check if our image references are legitimate, if they have alt tags, if our internal links are working, and so on. It's intended to be an all-in-one checker for our output.

Running these tests has been simplified for you into one simple command, which is:

bundle exec rake test

See Rakefile in the source root for details or what comprises the test. Also note that automated tests are configured and set up to run on Travis-CI. Any push or pull request will be built.

For more information about Nairuby, visit nairuby.