Jekyll Base Project [Bootstrap]

Just as it sounds. This is a clean base for starting Jekyll static site projects. This setup is designed more for a standard static website (eg. landing site, company website, etc.) and less for a blogging site. This can definitely be modified to be used as a Jekyll blog, if desired (shouldn't take too much time at all, actually). Or you can just use plain jane, out-of-the-box Jekyll.

I'm using...

• Jekyll static site generation
• Bootstrap CSS framework via Bootstrap Sass
• Jekyll Assets asset pipeline
• FontAwesome via FontAwesome Sass
• S3 Website to deploy to S3 Amazon Web Services S3.

I typically use (baked right into Jekyll)...

• Sass (SCSS) CSS pre-processor
• CoffeeScript for our site's Javascript

Getting started

1. Prerequisites

We use Bundler to manage all of the project assets, so you need to make sure you have that installed.

You can install it by running:

gem install bundler

2. Install Requirements

Since we Bundler, this is super easy. All of the project requirements are detailed in the project's Gemfile file.

Just run the following command:

bundle install

Or if you don't want to deploy to S3:

bundle install --without deploy

3. Go at it...

Jekyll comes shipped with a development server and we use Jekyll Assets to manage all of our assets, so... just go at it bro.

Serve:

serve fires up a server at http://127.0.0.1:4000 and starts watching for file changes. Just make your changes and head over to your browser.

jekyll serve

Build:

build simply compiles your assets and generates your website - no server, no watching.

jekyll build

...or watching:

jekyll build --watch

Deploying

Once you're ready to deploy, make sure to run jekyll build first to clean out any old or cached asset files, then follow on of the following instructions:

Amazon S3 (Optional)

Deploying to S3 is easypeezy with S3 Website.

1. Config

Edit the s3_website.yml with your S3 information.

2. Deploy to S3

Run the following command and all will be live:

s3_website push

DOM-based Routing

Something note worthy:

I use DOM-based Javascript routing based on http://goo.gl/EUTi53 by Paul Irish. It's pretty neat stuff. I actually snagged it from Roots.io who snagged the concept from Paul Irish.

TODO

• Update project to use Gulp and Browsersync
• Link project to useful Sass repo