unikexperience / rails

Ruby on Rails

This repository contains the source code behind Bilaw.al, a blog built on Jekyll. It has been modified to make it easier to create and manage your content, and so that's why I decided to open source it. You're totally welcome to use my template (but no images) for free, though I would appreciate a linkback to either this repository or Bilaw.al (either one isn't necessary).

Demo: See the live site running this source code.

Getting Setup

• Important: Make sure you've got Ruby and Git installed, or the installation will not work. Mac OS X users should already have Ruby installed.

• Clone this repository by running the following command:

$ git clone https://github.com/bih/bilaw.al.git

• Install Bundler (it's short for "life-saver").

$ gem install bundler

• Using Bundler, download all the dependency gems.

$ bundle install

• Next, complete setup by running this command.

$ rake install

• You're all setup. Go treat yourself.

Developing your website

It's incredibly easy to edit your site using my version of Jekyll. Click here if you want to see how Jekyll works.

Configuration file: _config.yml

Create a new post:

$ rake new:post

Create a new page:

$ rake new:page

Start development server:

$ rake development

Open development server in browser:

$ rake open

Generate production site:

$ rake production

Publishing your site

After you've called the $ rake production command, your publishable site should be located in the _production folder. Upload the folder to any provider of your choosing -- some notable ones are Amazon S3, AppFog or GitHub Pages.

Maintaining Bilaw.al

As I update my blog often (so I've told myself), I should also be updating this quite frequently. The main objective is that it can act as a great mini-framework for bloggers to get started on Jekyll -- in efforts to boost the popularity of static-site generators. Feel free to contribute, and if you've got any questions or issues, please contact me on Twitter. Have fun!