To get started, just fork a copy of this repository, make your changes and create a pull request.
Run your own copy
PLEASE NOTE: There is no requirement to run your own copy, the following is just a reference for those who may wish to do so.
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
It is expected that you are on a YUM based system with
cd website ./setup.sh
Running a local server
Start a local Middleman server:
This will update your locally installed gems and start a Middleman development server.
Next, browse to http://0.0.0.0:4567
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.)
Customizing your site
The site can be easily customized by editing
Adding a Post
To add a post to the community blog use:
Build your static site
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
Setting up deployment
FIXME: Right now, please reference
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
Add new features (parsers, etc.)
Simply add a new
gem 'some-gem-here' line in the
Gemfile and run
For more information, please check the excellent Middleman documentation.