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

Clone this repository and run the setup.sh script located in the checked out repository directory.

The script will initialize and update the git submodules, install system dependencies, and run a bundle install.

It is expected that you are on a YUM based system with sudo access.

cd website
./setup.sh

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 dynamically 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 use:

./create-post.rb "TITLE"

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

NOTE: On CentOS / RHEL 7 you will be presented with a warning that ImageMagick is less than the recommended 6.8.0.

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.