It is based on https://github.com/OSAS/middleman-springboard.

Springboard is a starter-pack for Middleman, for quickly whipping together static-based websites.

To get started, you need to have Ruby and Ruby Gems installed, as well as "bundler".

Before you do anything else, remember this:

When you use middleman-springboard, remember that sites are a fork of this repository. Be sure you change your origin before you push. You can do this automatically when forking this repository.

You can push small changes back upream to this repository, as well as pull in changes made too — but try to keep forks separate. Thanks!

git clone https://github.com/OSAS/middleman-springboard.git YOUR_PROJECT
cd YOUR_PROJECT
./setup.sh # This script assumes your user account has sudo rights

Currently, setup.sh is a super-simple script that only has support for Fedora, RHEL, and CentOS.

(Pull requests to add support for other distributions and operating systems are welcome.)

Be sure you have a C++ and Ruby development environment, as well as Ruby Gems and Bundler, then run the following:

git clone https://github.com/OSAS/middleman-springboard.git YOUR_PROJECT
cd YOUR_PROJECT
bundle install

1. Start a local Middleman server:

   ./run-server.sh

   This will update your locally installed gems and start a Middleman development server.

2. Next, browse to http://0.0.0.0:4567

3. Edit!

   When you edit files (pages, layouts, CSS, etc.), the site will dyanmically update in development mode. (There's no need to refresh the page, unless you get a Ruby error.)

The site can be easily customized by editing data/site.yml.

To add a post to the community blog (or any blog managed by middleman) use:

bundle exec middleman article TITLE

After getting it how you want, you can build the static site by running:

bundle exec middleman build

FIXME: Right now, please reference <data/site.yml>

After copying your public key to the remote server and configuring your site in <data/site.yml>, deployment is one simple command:

bundle exec middleman deploy

Simply add a new gem 'some-gem-here' line in the Gemfile and run bundle install

For more information, please check the excellent Middleman documentation.