JuckStrap - Static site generation bliss with Nunjucks + Bootstrap + Wintersmith.js

This is a project that aims to quickly bootstrap a new web application project "the right way". This includes using Bootstrap within Nunjucks templating system, all statically generated with Wintersmith.js. This project also includes all of the necessary Grunt tools to make your life easier as you build a new web application rapidly and properly.

Prerequisites

There are a few things you will need to get started.

• Node.js - Go to http://nodejs.org/ and follow the installation instructions.
• Grunt CLI

npm install -g grunt-cli

• Bower

npm install -g bower

Installation

To install, first clone this repo, and then type the following in the directory.

npm install

Next you will need to make sure you install Bower components in both the root and test folders.

bower install
cd test
bower install

Configuration

A lot of the site configuration can be found within the config.json file in the root of the project. You can use this to edit configurations that Wintersmith uses to build the web appication.

The Web Application

All of the changes that you need to make are within the app folder. This contains the Wintermith setup for a Nunjucks templated site. Go to http://wintersmith.io/ to learn more about editing a Wintersmith application and also go to http://mozilla.github.io/nunjucks to learn about the Nunjucks templating language.

Running

You can run this web application by typing the following in your terminal.

grunt serve

This also watches all the files within the app directory and when a change is made re-compiles the application and automatically updates the site in your browser.

Compiling

This project compiles and runs using Grunt. You can compile the application using the simple grunt command.

grunt

This creates a dist folder that you can use to copy to your webserver.